複数のAIツールを行き来して作業を分担させたいけれど、どこまで自動化していいか分からず手が止まる、という悩みを持つ方に向けた記事です。結論から言うと、Claude Code単体でもサブエージェントを使えば、調査・下書き・検品のような役割分担が可能で、権限モードと並行数の目安さえ押さえれば安全に進められます。この記事では判断基準、再現可能な手順、具体例、失敗例と対策、初心者向け最小構成、中上級者向け応用までを1本で完結できるように解説します。
サブエージェントで役割分担するかどうかの判断基準
まず考えたいのは、今の作業が「本体の会話を埋めずに済ませたい調査・検証」かどうかです。サブエージェントは自分専用の文脈で作業し、要約だけを本体の会話に返す仕組みなので、ログ解析や複数ファイルの調査のように結果が長くなる作業と相性が良いです。
逆に、1往復で終わる単純な修正や、結果をすぐ目で確認したい作業は、サブエージェントに分けずに本体の会話で進めたほうが早いです。判断に迷ったら、次の3点を目安にしてください。
- 調査結果やログが長くなりそうか(長くなるならサブエージェント向き)
- 複数の作業を同時に進めたいか(はいならサブエージェント向き)
- すぐに画面で確認しながら進めたいか(はいなら本体の会話向き)
サブエージェントを作って呼び出す再現可能な手順
サブエージェントの定義はYAMLフロントマター付きのMarkdownファイルで、プロジェクト用は.claude/agents/、全プロジェクト共通は~/.claude/agents/に置きます。公式ドキュメントによれば、作成ウィザードの/agentsは廃止されているため、Claudeに作ってもらうかファイルを直接書く必要があります。
手順は次の通りです。
- Claude Codeを起動し、「調査専用のサブエージェントを作ってください。名前はresearcher、読み取り専用でコードベースを調べて要約だけ返す役割にしてください」と指示します
- 生成されたMarkdownファイルの内容を確認し、descriptionの文言が役割を正しく表しているかチェックします
- 本体の会話で「@researcher でこのリポジトリの認証周りの実装を調べて」のように
@でメンションすると、そのサブエージェントが確実に動きます - 名前を文章で書くだけ(例:「調査担当に任せて」)の場合は、どのサブエージェントに任せるかをClaudeが判断します
組み込みのサブエージェントには、読み取り専用のコード検索を行うExplore、Plan mode中の調査を担当するPlan、調査と変更の両方を行うgeneral-purposeがあります。まずはこの組み込みを使ってみて、物足りない場合に自作へ進むのが無理のない流れです。
具体例:調査・下書き・検品を3本に分ける指示文
実際に貼って使える指示文の例です。
この作業を3つに分担してください。
1. @researcher で既存コードの該当箇所と依存関係を調べる
2. general-purposeで修正案を実装する
3. 実装後にExploreで変更差分をレビューし、見落としがないか確認する
各ステップの要約だけ本体の会話に返してください。
この指示文を使うと、ログや調査結果で本体の会話の文脈が埋まるのを防ぎながら、役割ごとに作業を進められます。大きな変更を伴う場合は、いきなり実行させず、先にPlan modeで計画を書かせて承認してから実行する流れにすると安全です。Plan modeは会話中ならShift+Tabでモードを切り替えて入り、1回だけなら指示の先頭に/planを付けます。
失敗例と対策
サブエージェントを使い始めると起きやすい失敗と、その対策をまとめます。
| 失敗例 | 原因 | 対策 |
|---|---|---|
| 同時に動かすサブエージェントが多すぎて収拾がつかない | 並行数の上限を決めていない | 同時に動かすのは3〜4本までを目安にする |
| descriptionが曖昧でClaudeが別のサブエージェントに任せてしまう | 役割の説明が抽象的 | descriptionに「読み取り専用」「調査のみ」など具体的な制約を書く |
| bypassPermissionsのまま並行作業をさせて意図しない変更が入った | 権限モードの理解不足 | 公式が隔離環境専用としているbypassは普段使いを避け、Manualかautoで進める |
初心者向けの最小構成
最初から複雑な役割分担を組む必要はありません。最小構成は次の2ステップです。
- 組み込みのExploreサブエージェントを使って「このプロジェクトの構造を調べて」と頼むだけから始める
- 慣れてきたら、調査専用の自作サブエージェントを1つだけ作り、
@メンションで呼び出す練習をする
この2ステップだけでも、本体の会話が長い調査結果で埋まるのを防げます。
中上級者向けの応用
複数のサブエージェントを役割ごとに常設し、呼び出し基準をCLAUDE.mdに書いておくと、毎回同じ説明をしなくて済みます。CLAUDE.mdは毎回の会話の開始時に読み込まれる仕組みなので、「調査はresearcher、実装はgeneral-purpose、レビューはExplore」といった役割分担のルールを書いておくと、指示が簡潔になります。
また、繰り返し使う手順はスキルとしてSKILL.mdにまとめておくと、サブエージェントと組み合わせて再利用できます。SKILL.mdの記述例は次のようになります。
---
name: code-review-flow
description: 調査・実装・レビューの3段階でコード変更を進める手順
---
1. @researcher で変更対象の依存関係を調査する
2. general-purposeで実装する
3. Exploreで差分をレビューし、問題があれば報告する
実践で分かったこと
サブエージェントを使った役割分担は、実運用でも効果を確認しています。2026年9月の棚卸しでは、調査・下書き・検品のように分けられる作業をサブエージェントに分担させ、自分がいない間も作業を止めないようにしています。同時に動かすのは3〜4本までに決めていて、これより増やすと進捗の把握が難しくなるため、この上限を超えないようにしています。
もう1点、YouTubeの伸びている動画を調べる定点観測の作業では、「再生数が登録者数の3倍以上・投稿から90日以内・5分超・5,000再生以上」という具体的な基準を決めてから、調査系のサブエージェントに渡しています。基準を数値で決めずに「伸びている動画を探して」とだけ頼むと判断がぶれるため、先に基準を言語化しておくことで、サブエージェントが拾ってくる候補の質を安定させています。
一般的なやり方と運営者の運用の比較
| 項目 | 一般的な手順 | 運営者の運用と理由 |
|---|---|---|
| 並行数 | 上限を決めずに必要な分だけ動かす | 3〜4本までに制限。進捗が追えなくなるのを防ぐため |
| 調査基準 | 「良い動画を探して」のように抽象的に依頼 | 再生数・投稿日・再生時間・再生数の下限を数値で先に決めてから依頼。判断のぶれを防ぐため |
| 役割の固定 | その場でサブエージェントを都度作る | よく使う役割はCLAUDE.mdに呼び出し基準として書いておく。毎回の説明を省くため |
この図は、1つの作業依頼が調査・実装・レビューの順でどのサブエージェントに渡っていくかという処理の流れを軸に示します。矢印の順番通りに各サブエージェントへ指示を出し、前の工程の要約を受け取ってから次の工程に進んでいるかを確認してください。
この図は、作業の性質に応じて本体の会話で進めるか、どの組み込みサブエージェントに任せるかを選ぶ分岐を軸に示します。自分の作業が「長い調査」「複数同時進行」「即確認したい単純作業」のどれに近いかを当てはめて、対応する選択肢に進んでください。
よくある質問
Q. サブエージェントとスキルはどう使い分けますか。
A. スキルは手順書を呼び出す仕組みで、サブエージェントは自分専用の文脈で作業して要約だけ返す仕組みです。繰り返す手順はスキルにまとめ、文脈を分離したい調査や検証はサブエージェントに任せると役割が整理できます。
Q. サブエージェントを使うとコストは増えますか。
A. 公式ドキュメントでは、サブエージェントが検索結果やログで本体の会話を埋めずに済む点がトークン節約につながると説明されています。詳細はトークンを減らす方法のページを参照してください。
Q. 並行数に公式の上限はありますか。
A. 公式ドキュメントに具体的な上限数値の記載は確認できていないため、本記事では運営者が実運用で決めている3〜4本という目安を紹介するにとどめます。
まとめ
サブエージェントによる役割分担は、調査・実装・レビューのように性質の異なる作業を分けたいときに有効です。判断基準は「結果が長くなるか」「同時進行したいか」で、組み込みのExplore・Plan・general-purposeから試し、慣れたら自作のサブエージェントとCLAUDE.mdでの呼び出し基準の整備に進むと無理なく運用を育てられます。並行数の目安や調査基準を数値で決めておくと、作業の質が安定しやすくなります。
公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取る
一次情報
サブエージェントでの役割分担や権限モードの設定をもう少し体系的に押さえたい方は、公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取れます。

コメント