コーディングエージェントを「分業」させる──AnthropicがまとめたClaude Codeサブエージェント活用の勘所
Anthropicが整理したClaude Codeサブエージェントの使いどころ。文脈分離・並列実行・ツール制限という利点と、向く仕事・向かない仕事の線引き、リポジトリでチームの作法を共有する運用までを解説します。
1人のAIに全部やらせない、という発想
AIにコードを書かせる作業が長くなると、会話の履歴がふくらみ、指示の焦点がぼやけてくる──そんな経験はないでしょうか。Anthropicは2026年6月初旬、こうした課題に対する「サブエージェント(sub-agents)」の使いどころを整理したガイダンスを公開しました。Claude Code を日常的に使う開発者にとって、生産性を左右する実践テクニックです。
サブエージェントとは、メインのエージェントが必要に応じて呼び出す、独立したClaudeのインスタンスです。最大の特徴は文脈(コンテキスト)が分離されていること。サブエージェントは真っ新な会話として動き、途中のツール呼び出しや中間結果は内部に留め、最終的な結論だけを親エージェントに返します。親の会話履歴で散らかったメインセッションを汚さずに、重い調査や検証を別枠で進められる、という考え方です。
分けることで得られる4つの利点
Anthropicは利点を4つに整理しています。第一に文脈の分離。たとえば数十ファイルを読み込む調査をサブエージェントに任せれば、その中身はメイン会話に蓄積されず、親には要約だけが戻ります。第二に並列実行。スタイル確認・セキュリティ走査・テストカバレッジといった点検を同時に走らせ、レビュー時間を分単位から秒単位へ縮められます。
第三に専門化した指示。SQLの移行手順やロールバック戦略のような細かな知識を、特定のサブエージェントにだけ持たせられます。メインの指示書に書けばノイズになる内容を、必要な場面に閉じ込められるわけです。第四にツールの制限。たとえば文書レビュー用のエージェントには Read と Grep だけを与え、誤ってファイルを書き換える事故を構造的に防げます。読み取り専用、テスト実行用(Bash+Read+Grep)など、用途ごとに権限を絞る設計が推奨されています。
「向く仕事」と「向かない仕事」を見極める
ガイダンスは、サブエージェントが効く典型を挙げています。複数ファイルにまたがる分析、他の作業に波及しない局所的なエラー処理、先入観を排した比較のために真っ新な文脈が欲しい場面、コミット前の独立した検証、そして計画・レビュー・テストといった工程を段階ごとに切る「パイプライン」型の作業です。
逆に、向かない場面も明確です。前の手順の出力を次が必要とする逐次依存の作業、同じファイルを同時に編集させるケース、わざわざ分けるまでもない単純な修正、そしてエージェント同士がリアルタイムに連携する必要がある作業です。観察しながら一歩ずつ進めたい処理は、分けずにメインのClaudeに任せたほうがよい、という整理になります。なお、サブエージェントはさらに自分のサブエージェントを生成することはできません。数十〜数百規模で多数を協調させたい場合は、会話の外でスクリプト実行する「Workflow」の仕組みが別途用意されています。
チームの「作法」をリポジトリに同梱する
運用面では、サブエージェントの定義方法が要点になります。コードから直接定義する方法のほか、.claude/agents/(プロジェクト単位)や ~/.claude/agents/(ユーザー単位)にMarkdownファイルとして置く方法があります。設計でおさえるべきは、役割の範囲(scope)、いつ使うかを書く説明文(description)、与えるツール、権限モード、そしてシステムプロンプトの5点です。Claudeはこの説明文を手がかりに、どのサブエージェントを呼ぶかを自動で判断します。
ここで効くのが、親から子へ渡る情報は呼び出し時のプロンプト文字列だけという制約です。親の会話履歴やツール結果は引き継がれないため、必要なファイルパスやエラーメッセージは呼び出し文にそのまま書き込んでおく必要があります。プロジェクトの CLAUDE.md は読み込まれますが、それ以外の文脈は明示が前提です。
ビジネスの視点では、レビューやセキュリティ点検、テスト実行といった「作法」を再利用可能なエージェントとして切り出し、.claude/agents/ に置いてリポジトリごと共有できる点が大きいでしょう。チーム全員が同じ基準でコードを点検し、権限を絞ることで誤操作のリスクも下げられます。万能の1体を育てるのではなく、役割を分け、文脈と権限を設計する──コーディングエージェントの使いこなしは、そうした「分業のデザイン」へと比重を移しつつあります。
参照: @IT「Claude Codeの『サブエージェント』活用のベストプラクティス」 / Anthropic 公式ドキュメント「Subagents in the SDK」