「このファイル全部読んで」。その頼み方、だいたい雑だ。Claude Code に丸ごと貼る前に、まず探させればいい。これだけでコンテキストの無駄食いが減るし、長い設定ファイルや複数の文書を相手にするときの手戻りもかなり減る。
Claude Code は、ただ貼られた文章を読むだけの道具ではない。リポジトリや作業ディレクトリの中を見て、該当箇所を探して、必要な部分だけを扱うほうがずっと向いている。特に、設定ファイル、議事録、契約書の下書き、案件フォルダのように「どこに何があるか分かっていないが、探せば見つかる」場面で効く。
最初にやるべきは、いきなり本文を貼ることではなく、「探す条件」を先に渡すことだ。たとえばこう書く。
このリポジトリの中から、APIキーの設定に関係する箇所を探して。
ファイル名、該当行、周辺の文脈を短く抜き出して、何を直せばよいか説明して。
全文の貼り付けは不要。見つかった部分だけで十分。
これで十分なことが多い。要するに、Claude Code に「答えそのもの」ではなく「答えを見つける作業」をやらせるわけだ。人間でも、まず検索して、見つかった箇所だけ読むほうが早い。AI にも同じやり方をさせればいい。
もう少し実務っぽくするなら、最初から目的を切る。たとえばコードなら、こんな頼み方が扱いやすい。
`src` 配下から、エラーハンドリングが雑になっている場所を探して。
特に try/catch の中で握りつぶしている箇所、ログが足りない箇所、同じ処理を何度も書いている箇所を優先して見たい。
見つかったファイルだけ教えて。必要ならそのあとで修正案を出して。
こうしておくと、Claude Code は広く当たってから絞る動きになりやすい。最初から巨大ファイルを1本貼って「読んで」より、ずっと筋がいい。筆者は以前、設定ファイルを丸ごと貼って「どこが悪いか見て」と投げたことがあるが、変数名の確認だけでコンテキストが膨らみ、肝心の修正指示まで行く前に会話がだるくなった。探させれば済む話だった。
非エンジニアでも同じだ。たとえば案件フォルダの中で、古い版と新しい版が混ざっているとき、全文を開かせる必要はない。こう頼めばいい。
このフォルダの中から、「最終版」「修正版」「確定」などの語が入ったファイルを探して。
似た名前のファイルが複数あれば、更新日時や中身の違いも見て、どれを残すべきか整理して。
全文は貼らなくていい。候補だけ出して。
ここで大事なのは、「何を探すか」を人間が言語化することだ。Claude Code は便利だが、意図のない探索はただの迷子になる。
「関連しそうなものを探して」だけだと広すぎるし、「全部読んで」はなお悪い。対象、目的、優先順位の3つを渡すと、かなり実用になる。
実際、頼み方はこう組むと強い。
1. まず関連ファイルを探す
2. 該当箇所だけ抜き出す
3. その部分だけを前提に説明する
4. 全体の貼り付けは不要
これをそのまま指示文にしていい。Claude Code に必要なのは、巨大な貼り付けではなく、探索の方針だ。検索語、場所、観点があればだいたい動ける。
ただし、ここでひとつやりがちな失敗がある。見つけた箇所だけ見れば十分だと決めつけて、文脈を切り落としすぎることだ。コードなら関数の前後、設定なら参照先、文書なら見出しの親子関係を見落とすと、別の場所を壊す。筆者も以前、該当行だけで判断してしまい、実は上位設定で上書きされていた、というしょうもない手戻りを食らった。探させるのはいいが、切り出す粒度は雑にしないほうがいい。
だから、依頼の中に「周辺も少し見る」を入れておくといい。
該当箇所だけでなく、前後20行くらいの文脈も見て。
その設定や記述がどこから参照されるか、関連しそうな箇所も一緒に探して。
この一言があるだけで、Claude Code の回答がだいぶ使いやすくなる。逆に、「1行だけ見て判断して」と言うと、当たり前だが浅くなる。
もうひとつ、探させるときに効くのが「見つからなかったらそれも言え」と先に書くことだ。これがないと、曖昧な検索の結果をそれっぽくまとめられて、見つかった気になって終わる。
もし該当箇所がなければ、なかったとはっきり言って。
その場合は、次に探すべきキーワード候補も出して。
この指示は地味だが重要だ。探し物でいちばん無駄なのは、見つかっていないのに見つかったような顔をすることだからだ。
少し進めるなら、最初の一手を固定化しておくと楽になる。毎回同じような作業をするなら、依頼の型を決めてしまえばいい。たとえば、修正前の調査ならこんな感じだ。
目的:
- 〜を直したい
やってほしいこと:
- 関連するファイルを探す
- 該当箇所を抜き出す
- 影響範囲を簡潔に説明する
- いきなり全文は貼らない
注意:
- 推測で断定しない
- 見つからなければ、そう言う
このくらいの型があると、Claude Code はかなり扱いやすい。検索、確認、要約の順で回せるからだ。ファイルを丸ごと投げるより、ずっと静かに仕事が進む。
要するに、Claude Code に「読ませる」のではなく「探させる」。そして、探す条件を人間がちゃんと書く。これだけで、貼り付け疲れも、無駄な往復も、かなり減る。全文を持ち込むのは最後でいい。まずは当たりを付けさせる。それが一番早い。