Claude Code に雑に「これを整理して」と投げると、返ってくるものが妙に長い説明文になって、あとで自分が切り貼りする羽目になる。ここで先にやるべきなのは、出力形式を先に決めることだ。Markdown でほしいのか、表でほしいのか、成果物の形を固定してから頼む。これだけで手戻りがかなり減る。
たとえば、ファイル整理でも文書作成でも、欲しいのは「考え方」より「そのまま使える形」だろう。Markdown なら見出しや箇条書きをそのまま草案にできるし、表なら項目ごとの比較や一覧にそのまま流し込める。Claude Code は指示が曖昧だと、親切に見えて実は中途半端な出力を返しがちだ。そこを最初に縛るのが、このTIPSの肝である。
実務では、依頼文の冒頭に形式を明記するだけでいい。たとえばこうだ。
次の内容を、Markdown の見出し付きで整理してください。本文はそのまま貼れる形にしてください。
Markdown にしたいなら、どこまで機械的に整えてよいかも添えると強い。
次のメモを Markdown で整形してください。
- 見出しは h2 相当
- 箇条書きは短く
- 事実と推測は分ける
- 余計な前置きは不要
表がほしいなら、最初から列を指定する。ここを曖昧にすると、列名が勝手に増えたり減ったりして、後で直すのがだるい。
次の内容を表で整理してください。列は「項目」「内容」「備考」の3列に固定してください。
ファイル整理の文脈でも同じだ。たとえば重複ファイルの洗い出しを頼むとき、表にしておけば確認が速い。
次のフォルダ内の整理対象を、Markdown の表で一覧化してください。
列は「ファイル名」「種類」「残す理由」「削除候補」にしてください。
文書作成でも効く。弁護士の案件メモでも、営業資料の下書きでも、まず形を決める。あとで人間が読み直す手間が減る。
以下のメモを、社内共有用のMarkdownに整えてください。
- 冒頭に要約
- 次に論点
- 最後に確認事項
- 表現は簡潔に
この「先に形を決める」やり方は、地味だが効く。Claude Code は、依頼が広いと説明を足しすぎる。逆に形式が決まっていると、余計な回り道が減って、最初から使える出力に寄る。筆者は最初、自由記述っぽく頼んで、出てきた文章を自分で表に直していた。あれは時間の無駄だ。先に形式を言えば済む話だった。
ただし、形式だけ決めてもまだ足りないことがある。表なら「何の判断材料を並べるのか」、Markdown なら「読者が何を読めば終わりか」まで言うべきだ。ここが抜けると、きれいな見た目だけの中身薄め出力になる。見栄えが整っていても、使えなければ意味がない。
避けたいのは、形式指定をあとから足すやり方だ。たとえば最初に「整理して」とだけ頼み、返ってきた文を見てから「やっぱり表で」と言う流れである。これをやると、Claude Code が一度出した内容を別の形に再構成するので、指示の往復が増える。コンテキストも無駄に食うし、人間側もどこを直したいのか毎回説明し直す羽目になる。
実際の頼み方は、短くてもいいから最初に固定するのがコツだ。こんな感じで十分である。
以下を、Markdown 形式で出してください。
- 見出しあり
- 箇条書き中心
- そのまま社内Wikiに貼れる書き方
以下を、表形式で出してください。
- 列は固定
- 1行1項目
- 長文の説明は不要
もし迷うなら、先に自分で「最終的にどこへ貼るか」を決めるといい。Notion に貼るなら Markdown 寄り、Excel に流すなら表寄り、メール本文なら短い段落寄りだ。成果物の形を固定する、という感覚で考えるとブレにくい。
一歩進めるなら、形式だけでなく「禁止事項」も一緒に渡すと安定する。たとえば「箇条書きの入れ子を深くしない」「表の列は増やさない」「前置きを入れない」といった具合だ。ここまでやると、出力のばらつきがかなり減る。Claude Code に何度も整形をやり直させるより、最初の一回で型を渡したほうがずっと速い。
結局のところ、曖昧な依頼は人間にとっても AI にとっても面倒だ。先に Markdown か表かを決めておけば、返答を読んだあとに「違う、そうじゃない」と言う回数が減る。出力形式を先に決める。たったそれだけで、Claude Code はかなり扱いやすくなる。