調べ物を全部ひとつの会話に押し込むと、すぐに文脈が死ぬ。これ、かなりありがちな失敗だ。Claude Code にはサブエージェント、英語で subagent と呼ばれる仕組みがあり、重い調査や周辺確認を分離して、本題の流れをきれいに保てる。うまく使うと、メインの作業は設計や編集に集中できるし、調べ物の途中で話が散らからない。ファイル整理でも、文書作成でも、コード修正でも効く。
筆者は最初、ひとつの会話の中で「このフォルダの重複ファイルも見て、不要キャッシュも見て、ついでに命名ルールも考えて」と全部投げた。結果、会話履歴が調査メモで埋まり、本題の指示がどんどんぼやけた。出てきた差分も読む気が失せる。あれはだるい。サブエージェントに分ければ、そういうムダな汚れをかなり減らせる。
やり方は単純だ。まず本流では「何を決めたいか」だけをはっきり書く。調べ物そのものは、サブエージェントに切り出す。たとえば、Claude Code にこんなふうに頼む。
この案件では、メインの会話は意思決定と最終編集に使いたいです。
調査が必要な作業はサブエージェントに分けてください。
調べたいこと:
- 既存のフォルダ構成の問題点
- 重複しているファイル候補
- 削除してよさそうなキャッシュや一時ファイルの候補
最終的には、次の3点だけ返してください。
1. 何を残すべきか
2. 何を削除候補にするか
3. その理由
この頼み方の肝は、「調査」と「判断」を分けることだ。調べたメモをそのまま本流に流し込ませると、会話が長くなるだけでなく、判断が鈍る。サブエージェント側には、読むべき範囲と出力の粒度を絞る。メイン側には要約だけ返させる。これで本流の文脈がだいぶ軽くなる。
コードや設定を触る場面でも同じだ。たとえばリポジトリの変更前に周辺影響を確認したいなら、メイン会話で延々とファイルを追うより、サブエージェントに「関連しそうな箇所を洗って」と投げるほうがいい。こちらはその結果を見て、採用するか捨てるかを決める。会話の芯がぶれない。
サブエージェントで次を調べてください。
- この変更に影響しそうな設定ファイル
- 同名の処理が別の場所にないか
- 変更後に手作業で確認したほうがいい箇所
出力は長文にしないでください。
メインの判断に必要な要点だけ、箇条書きで返してください。
ここで大事なのは、サブエージェントを「何でもやる部下」にしないことだ。調べる対象が広すぎると、結局また文脈が散る。ひどいと、こちらが欲しくない細部まで拾ってきて、結果的に読む量が増える。筆者も一度、「関連しそうなもの全部」と雑に頼んで、Markdown の断片や古いメモまで掘らせてしまった。見た目は丁寧でも、実務ではただのノイズだ。探す範囲は狭く切るほうが強い。
使いどころは、こういう「本体と調査を分けたい場面」だ。
特に文書作成では効く。いきなり本編を書かせる前に、サブエージェントに「事実確認だけ」をさせる。たとえば契約関連の文章なら、用語の統一や参照先の確認だけを任せて、本文のトーンはメインで握る。こうすると、調べた断片に本流が引っ張られにくい。
ただし、ひとつ落とし穴がある。サブエージェントは便利だが、出力をそのまま丸のみすると、今度は要約の質で痛い目を見る。要約が雑だと、メイン会話は一見すっきりしても、中身は空っぽになる。だから依頼文には、何を答えさせるかを明記しておく。
次を調べてください。
1. 事実
2. 判断に必要な差分
3. 今の作業で無視してよい点
推測は分けてください。事実と混ぜないでください。
この「事実と推測を分ける」はかなり大事だ。調査役にありがちな失敗は、やたら賢そうに見せて、実は推測で埋めることだ。Claude Code 側に任せるときも、そこはちゃんと縛る。断定してよいこと、保留にすること、確認が要ることを分けさせる。そうしておけば、メインの文脈はかなり澄む。
もうひとつ、サブエージェントは「本題を先に進めるための前処理」と割り切ると使いやすい。調査結果を見て、採用する部分だけをメインで拾えばいい。全部を一体化させる必要はない。むしろ一体化させないほうが、あとで差し戻しが起きたときの修正も楽だ。会話の中に調査メモが散らばっていないからだ。
最後に、迷ったらこの形で使うといい。
この会話は本題の編集に集中したいです。
調べ物はサブエージェントに任せてください。
サブエージェントには、次の条件で調査をお願いします。
- 調査範囲はこのフォルダ内に限定
- 出力は要点のみ
- 事実、推測、確認不足を分ける
- 本題に関係ない周辺情報は捨てる
メイン会話には、最終判断に必要な要約だけ返してください。
この使い方を覚えると、Claude Code は「全部入りの会話相手」から「本流を邪魔しない編集チーム」に変わる。調べ物が重いほど、この分離は効く。会話の芯を汚さない。それだけで、作業はかなり進めやすくなる。仕様の細部や最新の挙動は、必要なら公式ドキュメント docs.claude.com で確認しておけばいい。