Claude Code に雑な指示を投げて、あとから「なんでそこまでやった」と頭を抱える。これ、かなりありがちな失敗だ。
原因はだいたい同じで、依頼の中に「何を渡すか」と「どう判断してほしいか」がごちゃ混ぜになっている。材料と基準を一緒くたにすると、Claude Code は手元の情報を全部“同じ重さ”で扱ってしまう。すると、読むべきファイルを読みすぎたり、逆に大事な制約を拾い損ねたりする。
この分け方を覚えると、指示はかなり締まる。ファイル整理でも、文書作成でも、コード修正でも効く。
呼び名としては「材料と基準」を分ける、あるいは「入力の分離」と考えるとわかりやすい。材料は事実、基準は判断ルールだ。
たとえば、Claude Code に「このフォルダの重複ファイルを整理して」とだけ投げると、余計なものまで触りやすい。
一方で、材料と基準を分けるとこうなる。
材料:
- /Users/me/Documents/案件A/ の中身
- 同名ファイルが複数ある
- 似たPDFとDOCXが混在している
判断基準:
- 2024年以降の最終更新を優先する
- 同一内容ならPDFを残し、編集用の元ファイルは別フォルダへ移す
- 名前だけで判断せず、本文と更新日時も見る
- 迷ったファイルは削除せず「要確認」に退避する
この形にすると、Claude Code は「何を見ればいいか」と「どう振り分けるか」を別々に考えられる。
人間が読んでも迷いにくい。ここが大きい。
コード修正でも同じだ。実際、筆者は最初、修正したい目的と制約をひとまとめにして頼み、差分が妙に広がったことがある。
「この画面の表示を直して、できれば関連ファイルも整えて、あと将来の拡張も見越して」みたいな頼み方だ。これだと Claude Code は親切心で周辺まで触る。結果、diff が太る。見た目はよくなっても、変更の意図がぼやける。レビューしづらいし、戻すときもだるい。
分け方の実例をもう少し出す。たとえば文書作成なら、こう書く。
材料:
- 会議メモ
- 箇条書きの下書き
- 参考にした既存の案内文
判断基準:
- 社内向けなので、硬すぎない文体にする
- 事実と推測を分ける
- 重要度の低い説明は削る
- 300〜500字に収める
非エンジニアの作業でも効く。たとえば、契約書の下書き整理や、案件フォルダの命名統一、請求書まわりのファイル整頓でも同じだ。
材料を渡すだけだと、Claude Code は「全部大事」に見える。判断基準がないと、何を優先するか決められない。だから、必ず「何を見て」「どう扱うか」を分ける。
コツは、材料のほうに「事実だけ」を入れることだ。
材料に「たぶん不要」「このへんは雑でいい」みたいな感想を混ぜると、基準がにじむ。逆に基準に「このファイルは古いかも」みたいな推測を書くと、判断がぶれる。
ここを混ぜると、Claude Code は平気で変な方向に寄る。
実際に使うなら、依頼文は次の順が扱いやすい。
1. 目的
2. 材料
3. 判断基準
4. 迷ったときの扱い
例を出す。
目的:
フォルダ内の重複ファイルを整理したい。
材料:
- Downloads フォルダの中身
- 画像、PDF、Officeファイルが混在している
- 同じ内容のファイルが複数ある可能性がある
判断基準:
- 中身が同じなら新しいほうを残す
- 画像は解像度が高いほうを残す
- 仕事用と私用が混ざる場合は削除せず分ける
迷ったとき:
- 勝手に消さず、候補を一覧にして確認を求める
この書き方のいいところは、Claude Code が勝手に“善意で最適化”しすぎるのを抑えられる点だ。
特にファイル操作では、削除や移動の判断が勝手に進むと痛い目を見る。だから「迷ったら止まれ」を基準に入れておくと安全になる。
逆にやりがちな悪い書き方もある。
このフォルダを見て、古くて不要そうなものを整理して。
なるべくきれいにして、使いやすいようにして。
重要そうなものは残して。
これ、ほぼ事故の温床だ。
「古い」「不要そう」「きれい」「重要そう」が全部あいまいで、Claude Code には判定の軸がない。結果として、何を守りたいのかが伝わらない。入力の分離ができていない状態だ。
もうひとつ大事なのは、判断基準を増やしすぎないことだ。
基準を盛るほど賢くなる、と思いがちだが、実際は逆で、優先順位が見えなくなる。
「更新日時も見る、サイズも見る、名前も見る、本文も見る、拡張子も見る」と全部盛りにすると、判断が重くなる。筆者もここで何度か失敗した。条件を詰め込みすぎて、結局どれを最優先にするか曖昧になった。そうなると、出力はそれっぽいのに使いにくい。
だから、基準は少数精鋭でいい。
たとえば「最終更新が新しい」「迷ったら確認」「削除はしない」の3つで十分な場面は多い。必要ならあとで足す。最初から全部入れないほうが、むしろ精度が上がる。
少し進めるなら、材料と基準を文章の中で見出し分けするだけでもかなり違う。
Claude Code に長い指示を渡すときは、段落の頭に「材料:」「判断基準:」と置いておく。これだけで、モデルが読む順番を取り違えにくくなる。ファイルを見せる場面では、ファイル本文そのものと、期待する扱いを別の塊に分けるのがコツだ。
材料:
- report_2023.md
- report_2024.md
- 先週のメモ.txt
判断基準:
- 共通している説明は1回にまとめる
- 数字は古い資料より新しい資料を優先する
- 断定できない箇所は「要確認」と残す
これで十分実務的だ。
Claude Code は魔法の相棒ではない。材料を雑に渡されると雑に広く動き、基準が曖昧だと勝手に埋める。そこを人間側で分けて渡すだけで、手戻りはかなり減る。
最後に、迷ったらこの問いを自分に投げるといい。
「今ここに書いているのは、事実か、それとも判断ルールか。」
この切り分けができると、依頼文は急に読みやすくなる。Claude Code だけでなく、あとで自分が見返したときにも楽だ。