Claude Code に雑に頼んで、返ってきた答えが毎回バラつく。これはかなりありがちな失敗だ。長文で返ってきたり、逆に一言で終わったり、箇条書きが崩れたりする。先に返答の形を決めておかないと、後で整える手間が地味に重い。
ここで効くのが、Markdown か表かを決める、つまり出力形式の固定だ。要するに「返答を整える」ための下ごしらえを先にやる。Claude Code は指示が曖昧だと、内容は合っていても見た目や粒度が暴れやすい。逆に、最初に形を縛ると、比較・一覧・手順書・要約がかなり扱いやすくなる。
たとえば、ファイル整理や文書作成で Claude Code を使うとき、返答の形を先に決めないと困る場面は多い。重複ファイルの候補を洗い出したいのに、説明文ばかり返ってくる。案件メモを整えたいのに、段落が長すぎてコピペしづらい。そんなときは、最初から「この形式で返して」と言い切るのがいちばん手っ取り早い。
実際の頼み方はこうだ。
以下の内容は Markdown の見出しと箇条書きで返してください。
余計な前置きは不要です。
各項目は 1 行で短くまとめ、最後に次にやることを 3 点で出してください。
表にしたいなら、最初から表を指定する。
以下を表で整理してください。
列は「対象」「状態」「対応」「優先度」の 4 列に固定してください。
表以外の説明は不要です。
Claude Code に作業手順を渡すなら、返答の形も一緒に縛るとブレが減る。
このフォルダ内の不要ファイル候補を確認して、結果を次の Markdown 形式で返してください。
## 似た名前のファイル
- ファイル名
- 重複している理由
- どちらを残すべきか
## 削除候補
- ファイル名
- 理由
- 先に確認すべき点
## 次にやること
- 3項目だけ
この手の指定は、見た目をきれいにするためだけではない。人間が後で読むときに、どこが結論でどこが補足かがすぐ分かる。さらに、再利用もしやすい。Markdown ならそのまま議事録や作業メモに貼れるし、表なら一覧比較に強い。出力形式を固定するだけで、後工程の手間がかなり減る。
筆者は最初、ここを甘く見ていた。たとえば「この内容を整理して」とだけ頼んでいた時期がある。すると、似た内容を妙に長く言い換えたり、箇条書きと段落が混ざったりして、結局こちらで整形し直すはめになった。Claude Code のせいというより、こちらの指示が雑だったわけだ。出力の暴れは、だいたい入力の雑さが呼んでいる。
特に注意したいのは、形式を決める言葉があいまいすぎることだ。「見やすく」「簡潔に」「分かりやすく」だけでは足りない。人によって解釈が割れる語を並べても、出力は安定しない。Markdown なのか、表なのか、箇条書きなのか。まずそこを固定する。必要なら、さらに文字数や項目数まで決める。
Markdown で返してください。
見出しは 3 つまで。
各見出しの下は箇条書き 3 行以内。
前置き、感想、補足の脱線は不要です。
文書作成でもこの考え方は効く。たとえば弁護士が案件ごとのメモを整えたいなら、最初に「事実関係」「争点」「次の確認事項」を固定して返させる。そうすれば、案件が増えてもメモの型が崩れない。非エンジニアでも、家計、引っ越し、自治体の手続き、書類整理みたいな用途でそのまま使える。形が決まっているだけで、あとから探しやすさがまるで違う。
以下のメモを、次の 3 セクションの Markdown で整えてください。
1. 事実
2. 未確認点
3. 次の作業
各セクションは 5 行以内にしてください。
表に寄せたいなら、列名まで先に決める。ここを曖昧にすると、列が増えたり減ったりして使いにくい。比較表は特にそうだ。
次の 5 つの候補を比較表にしてください。
列は「候補名」「用途」「メリット」「気になる点」で固定してください。
列の追加はしないでください。
やってはいけないのは、最初から自由度を与えすぎることだ。「必要に応じて表でも箇条書きでもいいです」は、だいたい失敗する。Claude Code は親切なので、親切にいろいろ混ぜてくる。だが、こちらが欲しいのは混ぜ物ではなく、決まった器に入った結果だ。器を先に決めるほうが早い。
もうひとつ、返答形式の固定は「作業の途中」にも効く。最初の1回だけでなく、やり取りの途中でも同じ型を維持させると、コンテキストの節約になる。毎回ぜんぶ読み直して整形するより、同じテンプレートで積み上がるほうが圧倒的に楽だ。長い案件や、複数ファイルをまたぐ整理では特に効いてくる。
最後に、形式指定は細かくしすぎると逆に息苦しくなる。完璧なテンプレートを作る必要はない。まずは「Markdown で返すか」「表で返すか」を決めるだけで十分だ。そこに見出し、列名、項目数を足していけばいい。出力の暴れを抑えたいなら、内容より先に箱を決める。Claude Code には、そのほうがずっと通りがいい。