その長いファイル、わざわざ貼らなくていい。むしろ貼るな、である。
Claude Code に仕事をさせるときは、内容を全部コピーして投げるより、「どのファイルの、どこを、どう見ればいいか」を指示したほうが速いし、手戻りも少ない。コンテキストを無駄食いしないので、あとから本題の会話が崩れにくい。ファイル整理でも、仕様確認でも、議事録からの文書作成でも、この差は地味に効く。
筆者は最初、雑に本文を貼り付けていた。で、すぐ詰まった。長文のせいで肝心の指示が薄まり、返ってくる答えも広く浅い。しかも、途中で「この表だけ見れば足りたのに」と気づく。あれは本当にだるい。Claude Code は「探させる」ほうが強い。
やり方は単純だ。最初から全文を渡さず、ファイル名、場所、探してほしい観点をセットで渡す。たとえば、こんな感じだ。
プロジェクト内の仕様書を見て、
「ログイン失敗時のエラーメッセージ」がどこで定義されているか探して。
関連するファイル名と該当箇所を挙げて、要点だけ説明して。
全文の要約は不要。
もう少し実務っぽくすると、こうなる。
/Users/me/project 配下を見て、
請求書テンプレートに関係するファイルを探してください。
探してほしいもの:
- テンプレート本体
- 金額計算のルール
- 会社名や住所が差し込まれる箇所
見つかったファイル名と、確認すべき行や見出しを先に出してください。
必要ならそのあとで指定したファイルだけ読ませます。
この頼み方の肝は、「読め」と言うより「探せ」と言うことだ。
Claude Code は、ファイルを読む前に当たりをつけられる。リポジトリ内を横断して、関係する箇所を見つけ、そこだけ深掘りする流れに持ち込める。大きな設計書、複数の Markdown、設定ファイルが散らばった案件で特に効く。
非エンジニアの用途でも同じだ。たとえば、案件フォルダの中に契約書、見積書、メモがバラバラにあるなら、全文を貼る必要はない。
このフォルダの中から、
「契約期間」「更新条件」「解除条件」が書かれている文書を探してください。
どのファイルにあるかだけ先に教えてください。
必要な部分だけあとで読ませます。
これで十分だ。全文を投げるより、探させたほうが早いし、余計な情報を混ぜずに済む。
ただし、頼み方が曖昧だと普通に外す。ここでよくある失敗が、「関連するところを見ておいて」とだけ言うやつだ。これでは広すぎる。Claude Code は親切に広範囲を拾うが、そのぶん本筋がぼやける。筆者も一度、仕様変更の影響範囲をざっくり見てもらおうとして、全部で何十ファイルも触れた話に膨らませてしまった。欲しかったのは「実際に直すべき3ファイル」だったのに、だ。結果として、自分で取捨選択し直す羽目になった。あれは時間の浪費だ。
だから、探させるときは条件を絞る。
次の3点だけを探してください。
1. エラー文言の定義場所
2. その文言を表示する条件
3. テストで確認している箇所
見つけたら、ファイル名と見出しだけ先に返してください。
この手の依頼では、最初から「全文を要約して」は言わないほうがいい。要約は便利だが、まず探すべき場所を確定させるのが先だ。順番を逆にすると、だいたい無駄が出る。
もう一つ、ありがちな落とし穴がある。ファイルを探させたいのに、内容の目的まで曖昧なまま投げることだ。たとえば「この資料、直して」とだけ言うと、どこを基準に直すのかが決まらない。Claude Code は変更案を出せても、判断の軸がぼやける。こういうときは、探す対象と判断基準を分けて書く。
この資料の中で、
- 事実として書かれている部分
- 推測や提案として書かれている部分
を分けてください。
まずは該当箇所を探して、ファイル名と見出しを列挙してほしいです。
地味だが、これだけでかなり整理される。探させる対象がはっきりすると、返答も使いやすい。
ファイルを丸ごと貼らない運用を安定させたいなら、依頼文に入れるべき要素はだいたい決まっている。場所、探す観点、返してほしい粒度、この3つだ。
場所:
- docs/ 配下
- 仕様書と議事録だけ
探す観点:
- 退会フロー
- 再ログイン条件
- 例外処理
返してほしい粒度:
- ファイル名
- 見出し
- 必要なら該当段落の短い抜粋
これを先に渡しておけば、Claude Code は「どこを探すか」に集中できる。逆に、本文を全部貼ると、探す以前に読むだけで終わる。そうなると、せっかくの CLI エージェントを、でかいメモ帳みたいに使っているのと変わらない。
少し進めるなら、「まず探して、見つかったら次に読む」という二段階にするのがいい。
まず関連ファイルだけ探して。
まだ中身は要約しなくていい。
見つかった候補を3つまで出してから、
こちらが指定したものだけ読んで説明して。
この流れにすると、無駄な読みにくい。特に、フォルダが大きいときに効く。全部を一気に読ませるより、候補を絞ってから中身を見せるほうが、会話も作業も締まる。
最後に、覚えておくと楽なことがある。Claude Code に「探させる」のは、面倒を先送りするためではない。必要なファイルだけを、必要な順番で扱うためだ。全文を貼るのは、早いようで雑になりやすい。探させる頼み方に変えると、ディスク整理でも、書類確認でも、コード修正でも、話がぐっと進む。迷ったらまず、「読む」ではなく「探す」を命令すればいい。これでだいたい片付く。