いきなり作業を始めさせると、あとで「やっぱり表で」「いや箇条書きで」と差し戻しが入る。あれは地味にだるい。Claude Code は、最初に返答の形を固定してから動かすだけで、手戻りがかなり減る。Markdown か表かを先に決める、返答の形を固定する、というやり方だ。
この手は、開発作業だけの話ではない。ファイル整理の説明文、議事録のたたき台、フォルダごとの棚卸し、不要ファイルの洗い出しでも効く。最初に「どんな形で出すか」を決めてしまえば、Claude Code は途中で余計な寄り道をしにくい。
たとえば、こんな頼み方をする。
まず出力形式を決めてから作業してください。
返答は Markdown の見出し + 箇条書きで統一してください。
表は使わないでください。
最初に「出力形式: Markdown」と1行で宣言してから、本題に入ってください。
これだけでも違う。Claude Code は、内容を考える前に「どう見せるか」の足場を作る。すると、あとで人間が読み直したときに、情報の並びが崩れにくい。特に複数ファイルをまとめて説明させるとき、最初の形式指定がないと、段落が長くなったり、途中で表になったり、同じ粒度の項目が混ざったりしやすい。見た目が揺れると、確認する側が疲れる。ここを先に抑えるのがコツだ。
実務では、最初の一言をかなり具体的にしたほうがいい。抽象的に「見やすくして」では弱い。Claude Code に期待するのは、見た目の好みではなく、返答の設計図だ。たとえば文書作成ならこうだ。
最初に返答形式を固定してください。
- 見出しは Markdown
- 各見出しの下は3点まで
- 表は使わない
- 最後に次にやることを1行で書く
その形式を守って、以下の要点を整理してください。
これで十分通る。返答の形を先に縛ると、出力がぶれにくい。しかも、人間がそのままコピペしやすい。Claude Code に「いい感じに」などと投げると、だいたい後で直す羽目になる。そこは遠慮なく詰めていい。
逆に、表にしたいなら最初に表と決める。ここを曖昧にすると、途中で Markdown の箇条書きと表が混在して、読みづらくなる。
出力形式は Markdown の表で統一してください。
列は「項目」「内容」「補足」の3つにしてください。
表以外の形式は使わないでください。
表は便利だが、何でも表にすればいいわけではない。説明が長い内容を無理に表に押し込むと、逆に読みにくい。筆者は以前、ファイル一覧の整理をさせたときに、先に形式を決めずに進めたせいで、途中から表と箇条書きが混ざった出力を何度ももらった。内容は間違っていないのに、整形し直す手間で台無しだ。先に「表で行く」と言っておけば済んだ話だった。
もう一つ大事なのは、形式だけでなく、粒度も一緒に決めることだ。Claude Code は賢いが、放っておくと説明を厚くしすぎることがある。非エンジニア向けの作業なら、むしろ短くしたほうがいい場面が多い。
返答は次の形で固定してください。
1. 結論
2. 作業手順
3. 注意点
4. 次に確認すること
各項目は2〜4文でまとめてください。長い補足説明は不要です。
この指定が効くのは、返答の長さに関する迷いを先に消せるからだ。人間側が「結局どこを見ればいいのか」を探さなくて済む。特に、不要ファイルの削除対象を洗い出すような作業では、項目名が揺れるだけで確認ミスが起きる。返答の形が固定されていれば、チェックもしやすい。
ここで一つ、やりがちな失敗を書いておく。最初に形式を決めるつもりで、あれもこれも条件を盛りすぎると、今度は指示が重くなる。たとえば「Markdownで、表は使わず、箇条書きは3階層まで、各項目は必ず50字以内で、最後に要約もつけて…」みたいに細かく縛りすぎると、Claude Code の出力が窮屈になる。しかも、人間も読みづらい。形式は固定するが、縛りすぎない。このさじ加減がいる。
実際には、次の順で考えると扱いやすい。
1. まず返答形式を決める
2. 次に粒度を決める
3. そのあと内容を渡す
この順番を守るだけで、同じ依頼でも手戻りが減る。Claude Code にいきなり素材を投げてから「整理して」と言うより、先に型を渡したほうが、最初の出力が使える形になりやすい。
応用するなら、作業の種類ごとに「型」を使い分けるといい。たとえば、コードの説明なら Markdown の見出しと箇条書き、ファイル棚卸しなら表、短い報告なら番号付きリスト、という具合だ。毎回その場で迷うより、最初に定番の型を決めておくほうが速い。Claude Code は、型が決まっていると仕事がしやすい。人間にとっても、そのほうが読み返しやすい。
最後にもう一回だけ言う。Claude Code を便利に使いたいなら、内容を考えさせる前に、返答の器を決めることだ。Markdown か表かを先に決める。返答の形を固定する。これを最初に入れるだけで、あとからの修正が目に見えて減る。まず型、次に中身。この順番で頼むのが一番わかりやすい。