Claude Code でいちばん無駄が出るのは、ちゃんと動いているのに「なんか違う」とだけ感じて、そこを言語化できないときだ。
期待との差分、つまり出力のズレを読めないと、同じ依頼を少しずつ言い換えては手戻りする。これが地味にだるい。しかも、ズレている場所は毎回同じではない。要件の理解が浅いのか、対象ファイルの見方が違うのか、やり方は合っているのに粒度だけ外したのか。そこを切り分けるだけで、Claude Code はかなり扱いやすくなる。
まず押さえるべきなのは、Claude Code の出力は「答え」ではなく「解釈の結果」だという点だ。だから、期待と違ったときに見るべきなのは、出力の文章そのものだけではない。どのファイルを見たのか、どこを変更対象だと思ったのか、何を省いたのか。その読み取りが要る。
たとえば、フォルダ整理を頼んで、古い画像だけ消してほしかったのに、関連しそうなファイルまで候補に上げてきたとする。ここで「違う」で終わると、次もまた似たズレを踏む。見るべきは、Claude Code が「古い画像」という言葉をどう解釈したかだ。更新日時で見たのか、ファイル名で見たのか、拡張子だけで雑に拾ったのか。ズレの場所が分かると、次の指示は一気に締まる。
実務では、まず Claude Code に“何を見て、どう判断したか”を明示させるのが早い。曖昧な結果をそのまま直すより、判断の筋道を出させたほうが修正点が見える。
Claude Code に次を頼む。
変更案の前に、次の3点を短く整理して。
1. どのファイルや情報を見たか
2. 何を前提に判断したか
3. どこが不確実か
そのうえで、期待とのズレが起きそうな点を先に指摘してほしい。
この頼み方をすると、出力の表面ではなく、見ている範囲のズレが見えやすい。
コード修正でも文書作成でも効く。要するに「勝手にそう読んだ」の部分を炙り出すわけだ。
もう一つ効くのは、いきなり本番の依頼を投げず、比較しやすい基準を作ることだ。人は完成物だけを見ると、何がズレたのかをぼんやりしか掴めない。なので、期待を「完成形」ではなく「判断基準」に分ける。
たとえば文書作成なら、こう頼む。
次の文書について、まず完成文は書かずに、
- 目的
- 読者
- 入れるべき要点
- 入れないほうがいい話
を整理してから進めて。
これでズレが出たら、完成文の良し悪しではなく、目的理解の段階で外れていると分かる。
逆にここが合っているのに仕上がりだけ違うなら、問題は要件ではなく表現の粒度だ。そこを一気に詰めればいい。
筆者は以前、ディレクトリ内の資料を整理させたとき、出力がやけに広くなって困ったことがある。不要ファイルの洗い出しを頼んだつもりが、関連しそうなファイル群まで候補に入ってきた。原因は単純で、こちらが「不要」の基準を出していなかったからだ。
そのまま何度も言い直すと、Claude Code はより広く、より安全側に倒れていく。人間の期待は「狭く絞ってほしい」なのに、指示の雑さが「とりあえず多めに出す」方向へ押す。ここ、かなりやりがちだ。
ズレを読むときのコツは、出力を次の三つに分けて見ることだ。
一つ目は、対象のズレだ。見てほしいファイル、範囲、期間、版が違う。
二つ目は、解釈のズレだ。言葉の意味を広く取りすぎている。
三つ目は、粒度のズレだ。方向は合っているが、細かすぎるか粗すぎる。
この見分けがつくと、直し方も変わる。対象のズレなら、参照範囲を絞る。解釈のズレなら、用語を定義する。粒度のズレなら、「要約だけ」「差分中心」「手順を3段階で」みたいに出力の深さを指定する。毎回ただ「もっと正確に」と言うのは、ほぼ効かない。
Claude Code にそのまま聞くのも手だ。曖昧なときほど、先に疑問点を出させるといい。
この依頼で曖昧な点を先に挙げて。
不足している条件があれば、回答の前に質問して。
これは地味だが強い。
期待との差分の多くは、実は「未指定の前提」が原因だ。人間は頭の中で勝手に補っている。Claude Code はそこを補完する。だからずれる。補完される前提を、こちらが文章に落とす必要がある。
注意したいのは、ズレを読まずに“出力を丸ごと捨てる”癖だ。これは損だ。たいていの失敗出力には、使える断片が混じっている。見出しの構成だけ使える、対象ファイルの選び方だけ合っている、文のトーンだけは良い、ということがある。全部ダメだと決めつけると、調整の起点まで失う。
さらに、Claude Code には「途中経過を見せる」頼み方が合う。完成品だけでなく、判断の途中を出させると、ズレた場所が見える。たとえばファイル整理なら、削除候補のリストだけ先に出させる。文書作成なら、章立てだけ先に出させる。そこが合っていれば次へ進み、外れていればその場で止める。これで無駄な全面修正が減る。
まずは提案だけ出して、実行しないでください。
提案には次を含めてください。
- どのファイルを対象にしたか
- その対象を選んだ理由
- 迷う点
ここで大事なのは、提案を“仮説”として読むことだ。Claude Code の出力は宣言ではない。あなたの期待と合っているかを確認する材料だ。
この読み方ができると、返ってきた文をそのまま受けるのではなく、「どの前提が一致していて、どこが外れているか」を見られるようになる。
最後に、ズレを減らすための地味な習慣を一つだけ挙げる。依頼のたびに、対象、目的、許容範囲の三つを分けて書くことだ。
対象は何を見るか。目的は何をしたいか。許容範囲はどこまでやってよいか。これを分けると、Claude Code の出力がどこで期待から外れたかを読みやすくなる。
たとえばこうだ。
対象:
- このフォルダ内の重複したPDF
目的:
- 片付けて容量を空ける
許容範囲:
- 名前が同じでも、内容が違うものは消さない
- 判断が微妙なものは削除せず一覧に残す
こう書いておけば、もし出力がずれたときも、どの軸が崩れたのか分かる。
Claude Code をうまく使う人は、良い答えを求めるだけでなく、ずれた場所を読むのがうまい。そこが分かれば、直し方は意外と単純だ。次の依頼で、前提を一つずつ固定していけばいい。