AIコーディング支援「Claude Code」に新機能、コンテキスト肥大化を防ぐ「サブエージェント」の活用ガイドを公開

要点

• 米Anthropicは、AIコーディング支援ツール「Claude Code」における「サブエージェント」機能の活用ガイドを公開した。

• サブエージェントは、個別の処理領域を持つ独立したClaudeインスタンスであり、メインの会話履歴に影響を与えず並列でタスクを実行できる。

• 調査、並列処理、客観的レビュー、コミット前検証、段階的プロセスの5つの場面でサブエージェントの活用が推奨されている。

• 自然言語による明確な指示で呼び出すことができ、時間がかかる処理はバックグラウンドで実行することも可能である。

• 米Anthropicは2026年4月7日（現地時間）、AIコーディング支援ツール「Claude Code」において、独立した処理領域を持つ「サブエージェント（subagents）」の効果的な活用方法に関する実用ガイドを公開した。開発セッションの長期化に伴う動作の低速化やコスト増といった課題に対し、作業の一部を切り離して並行処理する手法を提案している。

サブエージェントの概要とメリット

同社の説明によると、Claude Codeは複雑で複数ステップに及ぶプロジェクトの処理に優れている一方で、開発セッションが長くなると「コンテキストウィンドウ」（AIが一度に処理できる情報の許容量）に読み込んだファイルや思考の断片が蓄積し、応答速度の低下やトークン（AIがテキストを処理する際の最小単位）のコスト上昇を招くという。

これに対し「サブエージェント」は、メインの会話から隔離され、独自のコンテキストウィンドウを持つ独立したClaudeのインスタンスとして機能する。サブエージェントに特定のタスクを割り当てて実行させると、作業完了後に結果のみがメインの会話に戻される仕組みだ。これにより、開発者はメインスレッドの流れを維持したまま、別個の調査や確認作業を並行して行うことができるとされている。

各サブエージェントは過去の会話履歴や実行されたスキル（特定の機能を実行するアドオン）を引き継がずに起動する。また、複数のサブエージェントを同時に並列実行させることも可能で、権限も「調査用には読み取り専用」「実装用には編集権限」といったように個別に設定できるという。

Claude Codeには、あらかじめ以下のような組み込みのサブエージェントタイプが用意されている。

• 汎用エージェント（General-purpose agents）: 複雑で複数ステップが必要なタスク向け
• 計画エージェント（Plan agents）: コードベースを調査した上で実装の戦略を提案する
• 探索エージェント（Explore agents）: 高速な読み取り専用のコード検索に特化している

サブエージェントを適用すべき5つの場面

実用ガイドでは、サブエージェントの利用が特に効果的となる5つの場面と、その判断基準となる「シグナル」が紹介されている。

1. 調査が主体となるタスク
   コードを変更する前提として設計や仕様の理解が必要な場合、サブエージェントにコードベースを探索させ、その結果の要約だけを受け取ることができる。数十個のファイルを読み込んでコンテキストを肥大化させる懸念がある場合に、メインの会話をクリーンに保てるメリットがある。

2. 依存関係のない複数のタスク
   複数のファイルにまたがるエラーの修正や、複数コンポーネントの更新など、互いに影響し合わない独立したサブタスクが存在する場合が該当する。3つのサブエージェントを同時に動作させることで、全体の処理時間を短縮できるという。

3. バイアスのないレビューが必要なとき
   メインの会話履歴にある仮定や盲点の影響を受けずに、クリーンな状態で実装をレビューしたい場合である。履歴を完全に消去する/clearコマンドと異なり、メインの会話履歴を保持したまま、バイアスのない客観的なフィードバックを得ることができる。

4. コミット前の最終検証
   変更をリポジトリ（コードを保存する場所）に確定させる前に、テストデータに適合しすぎる過学習（特定の条件にのみ過剰に最適化される現象）がないか、見落とされたエッジケース（極端な入力値や例外的な状況）がないかを独立したエージェントで検証する。

5. 段階的な開発プロセス
   設計、実装、テストといった明確な引き継ぎが発生する一連の流れにおいて、それぞれの段階で別個のサブエージェントを割り当てる。前の段階の余計なコンテキストがノイズにならず、各段階の作業に集中できる効果がある。

なお、探索するファイルが10個以上になる場合や、3つ以上の独立した作業が発生する場合は、サブエージェントの利用を指示すべき強いシグナルになると同社は説明している。

会話による呼び出しと操作方法

サブエージェントは、ターミナルやVS Code、JetBrainsといった各種開発環境、ウェブ版、デスクトップアプリなど、すべてのClaude Codeインターフェースにおいて自然言語で指示を出すことで呼び出すことができる。

指示を出す際のポイントとして、作業範囲の明確化、並列実行の明示、そして出力形式（要約や推奨事項など）の指定が挙げられる。具体的なプロンプトの例として、以下のような構造が効果的とされている。

「サブエージェントを使用して、このコードベースを並列で探索してください：

1. すべてのAPIエンドポイントを見つけて用途を要約する
2. データベースのスキーマとリレーションを特定する
3. 認証フローをマッピングする
   ファイルの内容をそのまま出力するのではなく、それぞれの要約を返してください」

このように、並列で実行させたいタスクをリストアップし、返却してほしい形式を指定することで、Claude Codeは適切にサブエージェントを生成して処理を実行する。

また、サブエージェントの処理に時間がかかる場合は、ショートカットキー「Ctrl+B」を押すことで、その処理をバックグラウンドに送ることができる。処理がバックグラウンドで動いている間もメインの会話を継続することができ、処理が完了すると結果が自動的に画面に表示されるという。現在バックグラウンドで実行中のタスクは、/tasksコマンドで一覧を確認できる。

カスタムサブエージェントの定義

同じパターンの作業を繰り返す場合などに向けて、再利用可能な専門エージェントを定義するカスタムサブエージェントの機能についても言及されている。

補足：
Claude Codeは、Anthropicが開発するエンジニア向けのコマンドラインAIツールである。今回の発表により、大規模なコードベースにおけるトークン消費量の抑制と開発効率の向上がさらに進むことが期待される。