Claude Codeでサブエージェントを使い分ける方法について、こう考えると迷いません

Claude Codeで調査やテストをいちいち本体の会話にやらせていると、文脈がすぐに埋まり、やり取りも散らかります。この記事は、サブエージェントの基本的な使い分けを知りたい方、1人で複数の作業を回したい副業・ひとり起業の方向けに、判断基準と手順をまとめています。結論は「読み取り専用の調査はExplore、計画段階の下調べはPlan、調査と変更の両方が要る作業はgeneral-purpose、それ以外の決まった役割は自作する」という3段構えです。
サブエージェントとは何か、なぜ使うのか

サブエージェントは、自分専用の文脈(コンテキストウィンドウ)で作業し、要約だけを本体の会話に返す専門のAIです。検索結果やログを丸ごと本体の会話に読み込ませると、すぐに文脈が圧迫されますが、サブエージェントに任せれば結果の要約だけが返るため、本体の会話はきれいなまま保てます。この仕組みはサブエージェントの公式ページで説明されています。
組み込みのサブエージェントには3種類あります。Explore(読み取り専用のコード検索)、Plan(Plan mode中の調査)、general-purpose(調査と変更の両方)です。Claudeは各サブエージェントのdescriptionを見て任せるかどうかを判断します。名前を文章で書けば任せるかはClaudeが決め、@でメンションすればそのサブエージェントが確実に動きます。これもサブエージェントに明記されている仕様です。
判断基準:どの作業をサブエージェントに任せるか

次の3つの問いで判断すると迷いません。
- ファイルを変更する必要があるか、調べるだけでよいか
- 結果が長くなりそうか(ログ、検索結果、複数ファイルの比較など)
- 同時に進めたい作業が複数あるか
調べるだけで済むなら読み取り専用のExploreが向いています。計画を立てる段階の下調べならPlan modeの中でPlanサブエージェントが動きます。調査した上で実際にコードを変更するところまで任せたいならgeneral-purposeです。これらはすべてサブエージェントのページに記載がある組み込みの種類です。
再現可能な手順:サブエージェントを呼び出す

- まず普段どおりClaude Codeを起動します。
- 調べ物だけを任せたい場合は、本体の会話で「このリポジトリの認証周りの実装をExploreで調べて」のように文章で依頼します。Claudeが任せるかどうかを判断します。
- 確実にそのサブエージェントを使わせたい場合は「@Exploreでこのリポジトリの認証周りの実装を調べて」のように@でメンションします。
- 自作のサブエージェントを使いたい場合は、プロジェクト用なら
.claude/agents/、全プロジェクトで使いたいなら~/.claude/agents/にYAMLフロントマター付きのMarkdownファイルを置きます。/agentsの作成ウィザードは無くなったため、Claudeに作ってもらうかファイルを直接書きます。
自作のサブエージェント定義は、たとえば次のような形で書きます。
---
name: competitor-researcher
description: 競合動画のリサーチを行う。再生数や公開日の条件を満たす動画だけを抽出して要約する
---
YouTube Data APIで取得した動画一覧から、次の条件をすべて満たす動画だけを「伸びている動画」として抽出してください。
- 再生数が登録者数の3倍以上
- 投稿から90日以内
- 動画の長さが5分を超える
- 再生数が5,000以上
条件を満たした動画のタイトル・URL・再生数・投稿日を一覧にして返してください。
このように条件を数値で固定しておくと、毎回同じ基準で抽出され、担当者の感覚でブレることがありません。
具体例:3つの作業を同時に進める

本体の会話で「@general-purposeで管理画面のバグを調査して修正案を出して。別で@Exploreで既存のテストコードの書き方を調べて」のように分けて依頼すると、それぞれが独立した文脈で動き、終わった分から要約が返ってきます。本体の会話は要約だけを受け取るため、ログや差分で埋まることがありません。
失敗例と対策
- 失敗例1: サブエージェントを増やしすぎて、どれが何をしているか分からなくなる。対策として、同時に動かす数を決めておき、それ以上は増やさないようにします。
- 失敗例2: 調査だけのつもりがgeneral-purposeに任せてしまい、意図しないファイル変更が発生する。対策として、変更してほしくない作業は必ずExploreを明示して呼び出します。
- 失敗例3: 自作のサブエージェントのdescriptionが曖昧で、Claudeが別の作業と誤認して呼び出してしまう。対策として、descriptionに「いつ使うか」を具体的な条件で書きます。
初心者向け最小構成
最初は組み込みの3種類だけで十分です。調べ物は「Exploreで調べて」、計画段階の下調べはPlan modeに任せ、調査と変更が両方必要なときだけgeneral-purposeを使います。自作のサブエージェントは、同じ依頼を3回以上繰り返したと感じたタイミングで検討すれば十分です。
中上級者向け応用:役割分担と安全性
調査・下書き・検品のように工程を分けられる作業は、それぞれ別のサブエージェントに分担させると、自分がその場にいなくても作業が止まりません。ただし、同時に動かす本数を決めておかないと、どのサブエージェントが何をしているか把握しきれなくなります。また、ファイルを変更するサブエージェントには権限モードの確認が挟まるため、権限モードのManual(既定)かauto(Pro・Max・Teamの既定で分類器が審査)のどちらで動かしているかを事前に把握しておくと、想定外の変更に気づきやすくなります。
この図は、サブエージェントを呼び出してから要約が本体の会話に戻るまでの作業順序を軸にしています。本体での依頼、サブエージェントでの実行、要約の返却という流れを確認し、次に自分の作業で同じ順序を当てはめてみてください。
一般的な手順と運営者の運用の比較
| 項目 | 一般的な手順 | 運営者の運用と理由 |
|---|---|---|
| 任せ方 | 調査と変更を1つのサブエージェントにまとめて依頼する | 調査・下書き・検品を別のサブエージェントに分担。自分が離席していても工程が止まらないようにするため |
| 同時実行数 | 特に上限を決めずに増やす | 同時に動かすのは3〜4本まで。それ以上だと把握しきれず進捗を見失うため |
| 呼び出し方の記録 | その場の思いつきで依頼する | 定型の調査は自作サブエージェントとして保存し、同じ条件で繰り返し呼び出せるようにしている |
この図は、目の前の作業内容を軸に、Explore・Plan・general-purpose・自作のどれを選ぶかの分岐を示しています。自分がこれから頼む作業がどの矢印に当てはまるかをたどり、該当するサブエージェントの呼び方で依頼してみてください。
実践で分かったこと
調査・下書き・検品のように分けられる作業はサブエージェントに分担させ、自分がいない間も作業を止めないようにしています。同時に動かすのは3〜4本までと決めて運用しています。これは、本数を決めずに増やすと、どのサブエージェントが何を調べているか把握できなくなり、要約の内容を確認する手間がかえって増えてしまうためです。本数の上限を先に決めておくことで、進捗の見落としを防いでいます。
もう1点、競合動画のリサーチはサブエージェントに任せる作業として固定し、YouTube Data APIで集めた動画のうち「再生数が登録者数の3倍以上・投稿から90日以内・5分超・5,000再生以上」を満たすものだけを「伸びている動画」として抽出する条件をdescriptionや指示文に数値で書き込んでいます。これは、「伸びている動画を教えて」のような曖昧な依頼では毎回基準がブレてしまい、見るべきでない動画まで混ざってしまうことを防ぐためです。条件を数値で固定したことで、同じ基準の抽出結果だけが返ってくるようになりました。
FAQ
Q. サブエージェントを使うとトークン消費は減りますか。
A. サブエージェントは検索結果やログで本体の会話を埋めずに済む仕組みで、要約だけが本体に返ります。文脈の使い方を整理する方法としては、トークンを減らすの考え方とあわせて検討すると判断しやすくなります。
Q. 自作のサブエージェントはどこに置けばいいですか。
A. プロジェクトだけで使うなら.claude/agents/、全プロジェクトで使うなら~/.claude/agents/にYAMLフロントマター付きのMarkdownファイルを置きます。詳細はサブエージェントで確認できます。
Q. サブエージェントにファイルを変更させるのは安全ですか。
A. 権限モードの設定次第です。Manual(既定)なら編集の前に毎回確認が入ります。隔離環境以外でbypassPermissionsを使うことは公式も勧めていません。詳しくは権限モードをご確認ください。
Q. /agentsコマンドで作成ウィザードは使えますか。
A. 使えません。作成ウィザードは無くなったため、Claudeに作ってもらうかファイルを直接書く方法になります。これもサブエージェントに記載されています。
まとめ
サブエージェントは、調べるだけのExplore、計画段階のPlan、調査と変更の両方が要るgeneral-purposeという3つの組み込みから始めれば十分です。繰り返し依頼する作業が出てきたら、descriptionに条件を数値で書いた自作のサブエージェントとして保存すると、毎回同じ基準で動かせるようになります。同時に動かす本数を決めておくことも、散らからない運用のために欠かせません。
Claude Codeの運用をさらに整えたい方は、公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取れます

コメント