Claude Code に雑に「一覧で」「見やすく」で投げると、返答の形が毎回ぶれる。ここを甘く見ると、あとでコピペしづらい、差分が読みにくい、保存したときに壊れやすい、の三重苦になる。先に Markdown で出すのか、表で出すのかを決めておく。要するに出力形式の固定だ。成果物の形を先に決めるだけで、返答はかなり安定する。
この手の話は、エンジニアのコードレビューだけの話ではない。ファイル整理でも、議事録作成でも、請求書の確認でも同じだ。たとえば「重複ファイルの候補を拾ってほしい」と頼むときに、表で返してほしいのか、Markdown の見出し付きで返してほしいのかが曖昧だと、途中で形式が変わる。そうなると人間の目でも扱いにくいし、次の工程に渡しづらい。
筆者も最初はここで何度も手戻りした。Markdown のつもりで頼んだのに、途中から表が混ざる。逆に、表で見たかったのに箇条書きが増える。Claude Code は内容をちゃんと理解していても、出力の器が決まっていないと、返し方が揺れることがある。コンテキストを食うわけではないが、余計な往復が増える。地味にだるい。
まず、最初に器を決める。これだけでいい。依頼文の冒頭か、毎回の定型文に入れてしまう。
出力はMarkdownで固定してください。見出しと箇条書きで整理し、表は使わないでください。
表でほしいなら、逆にそう言い切る。
出力は表で固定してください。項目ごとの比較を1つの表にまとめ、表の外には説明文を増やさないでください。
ここで大事なのは、「きれいに」ではなく「固定して」と言うことだ。「見やすくしてください」だけだと、Claude Code は親切にやりすぎる。説明を足す、段落を増やす、表と箇条書きを混ぜる、という方向に逃げやすい。人間が欲しいのは親切さではなく、再利用できる形だ。
実務では、用途ごとに型を分けると強い。文書の下書きなら Markdown、比較や棚卸しなら表が向く。たとえば契約書の修正点を整理するなら、こんな頼み方が使いやすい。
以下の修正候補を、Markdownの見出し付きで整理してください。
- 重要度が高いものを先に書く
- 1項目は3行以内
- 余計な前置きは不要
逆に、ディスク削減やファイル整理なら表に寄せたほうがいい。
以下のファイル候補を表で整理してください。
列は「ファイル名」「場所」「理由」「削除前に確認すること」に固定してください。
行を増やしすぎず、判断材料だけを短く書いてください。
この「列を固定する」感じが効く。表は列が決まっているぶん、Claude Code が話を広げにくい。Markdown は文章を少しは許すぶん、説明を自然に入れやすい。つまり、どちらが優れているかではなく、何を残したいかで選ぶわけだ。
やってはいけないのは、形式の希望を後から足すことだ。最初に内容だけ投げて、返ってきたものを見てから「やっぱり表で」と言うと、二度手間になる。しかも途中で形式変更をすると、前半と後半で粒度が揃わない。筆者はこれで、要点だけ抜き出したつもりが、あとから表の列と見出しの整合が崩れて、結局ぜんぶ整形し直したことがある。最初に決めておけば防げた失敗だ。
もうひとつ、よくあるのが「Markdown」と言いながら、実際には何を期待しているかが曖昧なケースだ。Markdown でも、見出し中心なのか、チェックリスト中心なのか、コードブロック中心なのかで仕上がりは変わる。なら、そこまで一緒に言う。
出力はMarkdownで固定してください。
見出しはH2まで、本文は短い段落中心、必要な箇所だけ箇条書きにしてください。
表は使わないでください。
このくらいまで書けば、返答はかなり暴れにくい。逆に、表で出したいのに Markdown を許すと、列に入れるべき情報を説明文に逃がしがちだ。表にしたいなら、表以外をできるだけ狭めるのがコツである。
非エンジニアの用途でも同じだ。たとえば、請求書の控えや領収書の整理なら、表のほうが向く。日付、相手先、金額、保管場所を固定列にしておけば、あとで探しやすい。案件ごとのメモをまとめるなら Markdown のほうが扱いやすい。見出しを「依頼内容」「気をつける点」「次にやること」に固定しておけば、読み返すときに迷わない。形式を先に決めるだけで、あとで人が読む負担が減る。
少し進めるなら、最初の依頼文に「この形式を最後まで守る」と書くといい。Claude Code は長い応答の途中で、親切に別形式を混ぜることがあるからだ。
以下の出力形式を最後まで守ってください。
途中で表と箇条書きを混ぜないでください。
必要なら情報を削ってでも、指定形式を優先してください。
これを入れると、内容の盛り込みすぎで形が崩れる事故が減る。実務では、盛り込みすぎより、形が安定しているほうが強い。人間はあとで足せるが、崩れた出力を整えるのは面倒だ。
要するに、先に決めるべきなのは「何を書くか」だけではない。「どう見せるか」も同じくらい大事だ。Markdown か表かを最初に固定すると、Claude Code は余計な寄り道をしにくい。出力形式を固定する、成果物の形を先に決める。たったこれだけで、返答はかなり落ち着く。次に使うときは、内容の依頼より先に、器を指定してみるといい。