Claude Code エージェントチームの使い方｜複数AIをチームで動かす実装ガイド【2026年版】

Claude Codeには複数のインスタンスを協調動作させる並列化機能が複数用意されており、その中でも最も高度な協調モデルがAgent Teams（エージェントチーム）です。一つのセッションがチームリーダーとして全体を統括し、複数のワーカーが独立したコンテキストウィンドウで並列に作業しながら、メンバー同士が直接やり取りできる構造です。

本記事では、Agent Teamsの概要・有効化と使い方・サブエージェントとの違い・注意点・導入判断の指針を順に解説します。インストール環境の準備についてはClaude Codeのインストール手順を、Claude Code全体の概要はClaude Codeの概要記事をあわせてご参照ください。

Agent Teamsとは何か

Agent Teamsは、複数のClaude Codeインスタンスが1つのチームとして協調動作する実験的機能です。公式ドキュメント「Orchestrate teams of Claude Code sessions」（Anthropic）の定義を引用すると、「一つのセッションがチームリードとして機能し、作業を調整・割り当て・結果を統合する。チームメンバーはそれぞれ独立したコンテキストウィンドウで動作し、直接やり取りができる」とされています。

最大の特徴は、リーダーを介さずにユーザーが個々のメンバーへ直接指示できる点です。これによって、作業中に特定のメンバーの方針を即座に修正したり、特定の担当者だけに追加の指示を与えたりすることが可能になります。

Agent Teamsが特に力を発揮するのは、次のような場面です。

• 調査と相互レビュー：複数のメンバーが異なる観点から問題を調査し、それぞれの知見を持ち寄って議論・検証する
• 新機能・新モジュールの並行開発：フロントエンド・バックエンド・テストを各メンバーが独立して担当し、互いに干渉せずに進める
• 競合仮説によるデバッグ：複数のメンバーが異なる仮説を同時に検証し、最速で原因を特定する
• クロスレイヤーの変更対応：UIとAPI層とDBスキーマの変更が連動する場面で、各担当が独立して作業しつつ同期を保つ

一方、逐次処理が前提のタスク・同一ファイルを複数メンバーが編集するケース・依存関係の多い作業には向きません。こうした場合は単一セッションや後述のサブエージェントのほうが効果的です。

Agent Teamsの有効化と使い方

前提条件の確認

Agent Teamsを使用するにはClaude Code 比較的新しいバージョンが必要です。まずバージョンを確認してください。

claude --version

バージョンが古い場合はアップデートしてから次のステップに進んでください。

有効化の方法

Agent TeamsはデフォルトでOFFになっています。有効化には環境変数を設定するか、settings.json に追記する2通りの方法があります。

環境変数で起動する場合：

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

settings.json に恒久的に追記する場合：

{
  "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}

settings.jsonの場所と書式については公式ドキュメント「Settings」をご参照ください。

チームの起動方法

有効化後は、自然言語でチーム構成を依頼するだけです。「どんなメンバーが必要か」「それぞれの役割は何か」をリードに伝えると、Claude Codeが自律的にチームを編成してタスクを分割します。

たとえば次のように依頼します。

「このRESTful APIのリファクタリングをエージェントチームで進めてください。UXレビュー担当・技術アーキテクチャ担当・セキュリティチェック担当の3人でチームを作ってください。」

チーム編成後は、リーダーを通じて全体進捗を確認することも、特定のメンバーに直接追加指示を与えることも可能です。

メンバーへの直接指示

Agent Teamsの重要な特徴として、ユーザーがリーダーを介さずに特定のメンバーへ直接指示を送れます。たとえば「セキュリティチェック担当のメンバーに、認証トークンの検証ロジックを重点的に確認するよう伝えてください」という形で、担当メンバーにピンポイントで指示できます。

サブエージェントとの違い

Agent Teamsとサブエージェント（Subagents）はどちらも複数のインスタンスで作業を分担する仕組みですが、設計思想と動作が根本的に異なります。サブエージェントの詳細な実装方法については Claude Codeのサブエージェント を参照してください。ここでは両者の違いに絞って整理します。

最も重要な違いは通信の方向です。サブエージェントは「リーダーが指示し、メンバーは結果を返すだけ」の一方向の委譲モデルです。メンバー同士が直接やり取りすることはなく、ユーザーが個別メンバーに直接指示することもできません。一方、Agent Teamsではメンバー同士が直接通信でき、ユーザーも特定メンバーへ直接指示を送れます。

比較軸	サブエージェント	Agent Teams
通信方向	一方向（リーダー→メンバー→結果を返すのみ）	双方向（メンバー同士・ユーザーと個別メンバーが直接通信可能）
ユーザーから各メンバーへの直接指示	不可	可
動作セッション	1セッション内で完結。最終メッセージのみ親に返る	複数の独立したセッションが並列稼働。共有タスクリストで同期
安定性	安定提供（一般提供済み）	実験的（Experimental・デフォルト無効）
トークン消費	中程度（中間処理はサブエージェント内に閉じる）	大（各メンバーが独立インスタンスのため大幅に増加）
向く用途	本流の会話を汚染せずに副次タスクを処理したい場合、日常的な並列処理	1つの論点を多角的に深掘りする協調探索、大規模タスクの役割分担

公式ドキュメント「Create custom subagents」（Anthropic）にも「セッション間で通信が必要な場合はAgent Teamsを参照」と明記されており、用途による使い分けが公式に整理されています。日常的な軽い並列処理にはサブエージェントで十分です。複数メンバーが知見を持ち寄って議論・検証するような「協調探索」の場面でのみ、Agent Teamsを検討してください。

セキュリティと注意点

既知の制限事項

公式ドキュメントはAgent Teamsに既知の制限（known limitations）があることを明示しています。具体的にはセッション再開・タスク調整・シャットダウン動作に関する制約です。本番クリティカルなシステムへの全面採用は、公式が安定化ステータスを宣言するまで控えることを強く推奨します。

トークン消費と利用上限

各メンバーが独立したインスタンスとして動作するため、通常よりトークン消費が大幅に増加します。チームの人数を増やすほど利用上限に早く到達します。導入前にAPIのコスト設計を必ず行ってください。料金の詳細についてはClaude Codeの料金解説とAPI料金体系の詳細記事をご参照ください。

権限設計の最小化

複数メンバーが同時に自律的に操作を行う構成では、単一エージェントに比べてファイルシステムや外部サービスへの副作用が乗算的に広がるリスクがあります。各メンバーに付与する権限は最小限に絞り、書き込み範囲・実行可能コマンド・アクセス可能なネットワーク宛先を明示的に制限した設計を採用してください。

プロンプトインジェクションへの警戒

外部リソースを取得・処理するメンバーが悪意あるテキストを取り込む経路になりえます。複数メンバーが並列に外部情報を処理する構成では、入力検証をそれぞれのメンバーに対して独立して設けることが必要です。

デバッグ難易度の上昇

複数インスタンスが同時に動作する環境では、障害発生箇所の特定が単一セッションより難しくなります。ログ設計とトレース基盤をAgent Teams導入と並行して整備してください。

導入の判断基準

Agent Teamsを選ぶべき場面と避けるべき場面を明確にしておきます。

Agent Teamsが有効な場面：

• 問題を複数の観点から同時に調査・検証させ、メンバー間で知見を突き合わせたい
• フロントエンド・バックエンド・テストのように、レイヤーをまたぐ独立した作業を並列に進めたい
• 複数の仮説を同時に検証してデバッグを加速させたい
• 作業中に特定メンバーの方針だけをピンポイントで修正したい

Agent Teamsを避けるべき場面：

• タスクが逐次的で前の結果が次の入力になる依存構造がある
• 複数メンバーが同じファイルを編集する可能性がある
• 本番クリティカルなシステムへの組み込みを即座に検討している（Experimentalのため）
• トークンコストを厳しく管理する必要がある

現時点でのおすすめの導入順序は、安定提供されているサブエージェントから始め、コスト・デバッグ基盤・権限設計を整えた段階でAgent Teamsへ段階的に移行することです。Claude Codeの実践的な使い方全般についてはClaude Code使い方完全ガイドもあわせてご覧ください。

まとめ

Agent Teamsは、複数のClaude Codeインスタンスがチームとして協調動作する実験的機能です。環境変数 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を設定することで有効になります（比較的新しいバージョンが必要）。

サブエージェントとの本質的な違いは通信モデルにあります。サブエージェントが「リーダーからメンバーへの一方向委譲」であるのに対し、Agent Teamsはメンバー同士の直接通信とユーザーから個別メンバーへの直接指示が可能な双方向モデルです。その分トークン消費は大きくなり、安定性も現時点ではExperimentalです。

日常的な並列処理にはサブエージェントで十分です。Agent Teamsは、複数の観点から問題を深掘りする協調探索や、独立性の高い大規模タスクの役割分担など、双方向の協調が本当に必要な場面に絞って活用してください。導入にあたってはトークンコストの増大・権限設計の最小化・プロンプトインジェクション対策の三点を設計段階から必ず組み込んでください。

参考文献

• Anthropic公式ドキュメント「Subagents in the SDK」
  https://code.claude.com/docs/en/agent-sdk/subagents.md
• Anthropic公式ドキュメント「Run agents in parallel」
  https://code.claude.com/docs/en/agents.md
• Anthropic公式ドキュメント「Set up Claude Code for your organization」
  https://code.claude.com/docs/en/admin-setup.md
• Anthropic公式ドキュメント「Security」
  https://code.claude.com/docs/en/security.md
• Anthropic公式ドキュメント「Claude Code セッションのチームを調整する」
  https://code.claude.com/docs/ja/agent-teams
• 独立行政法人情報処理推進機構（IPA）「AIセキュリティ短信 2026年3月号」
  https://www.ipa.go.jp/digital/ai/security/rcu1hd0000007gji-att/2-1_202603.pdf
• 国立研究開発法人物質・材料研究機構（NIMS）「DxMT AIMHack 2026～AIエージェントを活用した材料データベース…」
  https://dxmt.nims.go.jp/news/4090
• J-Stage「ソフトウェア開発PBLへのAIエージェントを活用した仕様理解の取り組み」
  https://www.jstage.jst.go.jp/article/repit/2026/0/2026_90/_pdf