Claude Codeがチーム戦モードを開始！必ず使いこなすべきAgent teams！

Claude Codeが再び大技を放った：Agent Teamsは、Sub Agentsの超強化版と理解できます～ 下図はAgent TeamsとSubagentsの比較：

私は「まず使ってみる」ことにしました！（すごく楽しい！すごく楽しい！すごく楽しい！）

Agent Teamsを有効にする条件： 
1. Claude Codeを最新版に更新（claude update） 

2. settings.jsonに以下を追加：

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Claude Codeを再起動～  

4. その後、自然言語でClaude CodeにAgent Teamsを作成させます（もちろん、Agent Teamsに何をさせるか明確に説明）  

また、他のモデルはAgent Teamsの動作に影響しません（私はKIMi for codingを使用）

Agent Teamsの詳細については以下をご覧ください（Anthropic公式記事）！

Agent Teamsを使用すると、複数のClaude Codeインスタンスを連携させて作業できます。一つのセッションがリーダーとなり、作業を調整し、タスクを割り当て、結果を統合します。メンバーは独立して作業し、各自のコンテキストウィンドウで、直接互いに話し合うこともできます。

子エージェント（Subagents）とは異なり（子エージェントは単一セッションで実行し、主エージェントにのみ報告）、個々のメンバーと直接対話でき、リーダーを経由する必要はありません。

このドキュメントでは以下をカバーします：

• • Agent Teamsを使用するタイミング、最適なユースケースおよび子エージェントとの比較

• • チームの起動

• • メンバーの制御、表示モード、タスク割り当ておよび委任を含む

• • 並行作業のベストプラクティス

Agent Teamsをいつ使うか

Agent Teamsは、並行探索が真の価値を追加するタスクで最も効果的です。最強のユースケースは以下を含みます：

• • 研究とレビュー —— 複数のメンバーが問題の異なる側面を同時に調査し、発見を共有して互いに挑戦できます

• • 新しいモジュールや機能 —— メンバーはそれぞれ独立した部分を持ち、互いに干渉しません

• • 競合する仮説でのデバッグ —— メンバーが異なる理論を並行してテストし、より速く答えを見つけます

• • 複数層の調整 —— フロントエンド、バックエンド、テストにまたがる変更を、異なるメンバーが担当します

Agent Teamsは調整オーバーヘッドを増加させ（Opus4.6でAgent Teamsを開く勇気はありますか🤣）、単一セッションよりもトークン消費が大幅に増加します。メンバーが独立して動作できる場合に最適です。順次タスク、同一ファイルの編集、または多くの依存関係がある作業には、単一セッションまたは子エージェントがより効果的です。

子エージェントとの比較

Agent Teamsと子エージェントはどちらも並行作業を可能にしますが、動作方法が異なります。作業者が互いに通信する必要があるかどうかに基づいて選択してください：

子エージェント

Agent Teams

コンテキスト

独自のコンテキストウィンドウ；結果は呼び出し元に返される

独自のコンテキストウィンドウ；完全に独立

通信

主エージェントにのみ結果を報告

メンバー同士が直接メッセージを送信

調整

主エージェントがすべての作業を管理

共有タスクリスト、自己調整

最適

結果のみを気にする集中タスク

議論と協力が必要な複雑な作業

トークンコスト

低い：結果が主コンテキストに集約される

高い：各メンバーは独立したClaudeインスタンス

迅速で集中した作業者が結果を報告する必要がある場合は子エージェントを使用。チームが発見を共有し、互いに挑戦し、自己調整する必要がある場合はAgent Teamsを使用。

Agent Teamsを有効にする

Agent Teamsはデフォルトで無効です。 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 環境変数を 1 に設定して有効にします。シェル環境またはsettings.jsonで：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

最初のAgent Teamを起動

Agent Teamsを有効にした後、ClaudeにAgent Teamを作成するよう指示し、自然言語でタスクと必要なチーム構造を記述します。Claudeはプロンプトに基づいてチームを作成し、メンバーを生成し、作業を調整します。

この例は効果的です。3つの役割が独立しており、互いを待たずに問題を探索できるため：

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Agent Teamを作成し、異なる角度から探索：一つはUX、一つは技術アーキテクチャ、一つは悪魔の代弁者を担当。)

そこから、Claudeは共有タスクリストを持つチームを作成し、各視点にメンバーを生成し、問題を探索させ、発見を統合し、完了後にチームをクリーンアップしようとします。

リーダーのターミナルにはすべてのメンバーとその作業内容がリストされます。Shift+Up/Downを使用してメンバーを選択し、直接メッセージを送信します。

Agent Teamを制御

自然言語でリーダーに指示を出します。リーダーは指示に基づいてチーム調整、タスク割り当て、委任を処理します。

表示モードを選択

Agent Teamsは2つの表示モードをサポート：

• • プロセス内モード —— すべてのメンバーがメインターミナル内で実行。Shift+Up/Downを使用してメンバーを選択し、直接入力してメッセージを送信。追加設定なしで任意のターミナルに適しています。

• • 分割画面モード —— 各メンバーが独自のペインを持つ。すべての出力を同時に確認でき、ペインをクリックして直接対話。tmuxまたはiTerm2が必要。

デフォルトは"auto"で、tmuxセッションで実行されている場合は分割画面を使用し、それ以外はプロセス内モードを使用します。

単一セッションでプロセス内モードを強制するには、フラグを渡します：

claude --teammate-mode in-process

メンバーとモデルを指定

Claudeはタスクに基づいて生成するメンバー数を決定しますが、正確に指定することもできます：

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(4人のチームを作成し、これらのモジュールを並行してリファクタリング。各メンバーにSonnetを使用。)

メンバーに計画承認を要求

複雑またはリスクのあるタスクでは、メンバーに実施前に計画を要求できます。メンバーはリードが方法を承認するまで、読み取り専用計画モードで作業：

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(認証モジュールをリファクタリングするアーキテクトメンバーを生成。変更を行う前に計画承認を要求。)

メンバーが計画を完了すると、計画承認リクエストをリードに送信します。リードは計画をレビューし、フィードバックを提供して承認または拒否します。

委任モードを使用

委任モードがない場合、リードはメンバーが完了するのを待たずに自分でタスクを開始することがあります。委任モードは、リードを調整ツールのみに制限することでこれを防止します。 Shift+Tab を押して委任モードに切り替えます。

メンバーと直接対話

各メンバーは完全で独立したClaude Codeセッションです。任意のメンバーに直接メッセージを送信できます：

• • プロセス内モード： Shift+Up/Downを使用してメンバーを選択し、入力してメッセージを送信。Enterを押してメンバーのセッションを表示し、Escapeを押して現在のターンを中断。Ctrl+Tを押してタスクリストを切り替え。

• • 分割画面モード： メンバーのペインをクリックして直接セッションと対話。

タスクの割り当てと請求

共有タスクリストがチームの作業を調整します。リードがタスクを作成し、メンバーが完了します。タスクには3つの状態があります：保留中、進行中、完了。タスクは他のタスクに依存することもできます。

リードは明示的にタスクを割り当てるか、メンバーがタスクを完了した後に自分で請求できます。

メンバーを閉じる

メンバーのセッションを適切に終了するには：

Ask the researcher teammate to shut down
(リサーチャーメンバーに閉じるよう依頼)

リードが閉鎖リクエストを送信。メンバーは承認して適切に終了するか、拒否して理由を説明できます。

チームをクリーンアップ

完了後、リードにクリーンアップを依頼：

Clean up the team
(チームをクリーンアップ)

これにより共有チームリソースが削除されます。リードがクリーンアップを実行する際、アクティブなメンバーをチェックし、まだ実行中の場合は失敗するため、まずメンバーを閉じる必要があります。

Agent Teamsの動作原理

アーキテクチャ

Agent Teamは以下を含みます：

• • リード： チームを作成し、メンバーを生成し、作業を調整する主Claude Codeセッション

• • メンバー： 割り当てられたタスクを処理する独立したClaude Codeインスタンス

• • タスクリスト： メンバーが請求して完了する作業項目の共有リスト

• • メールボックス： エージェント間で通信するメッセージシステム

システムはタスク依存関係を自動管理。チームとタスクはローカルに保存：

• • チーム設定：~/.claude/teams/{team-name}/config.json

• • タスクリスト：~/.claude/tasks/{team-name}/

コンテキストと通信

各メンバーは独自のコンテキストウィンドウを持ちます。生成時、メンバーは通常のセッションと同じプロジェクトコンテキストを読み込みます：CLAUDE.md、MCPサーバー、スキル。リードの会話履歴は引き継がれません。

メンバーが情報を共有する方法：

• • 自動メッセージング： メンバーがメッセージを送信する際、自動的に受信者に渡されます

• • アイドル通知： メンバーが完了して停止する際、自動的にリードに通知

• • 共有タスクリスト： すべてのエージェントがタスクステータスを確認し、利用可能な作業を請求できます

トークン使用量

Agent Teamsは単一セッションよりもトークン消費が大幅に増加。各メンバーは独自のコンテキストウィンドウを持ち、アクティブなメンバー数に応じてトークン使用量が増加。研究、レビュー、新機能作業では、追加のトークンは通常価値があります。通常のタスクでは、単一セッションがコスト効率的です。

ユースケース例

並行コードレビューを実行

単一のレビューアーは一度に一種類の問題に集中する傾向があります。レビュー基準を独立した領域に分割すると、セキュリティ、パフォーマンス、テストカバレッジが同時に徹底的に注目されます。

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings.
(Agent Teamを作成してPR #142をレビュー。3つのレビューアーを生成：一つはセキュリティ影響に集中、一つはパフォーマンス影響をチェック、一つはテストカバレッジを検証。それぞれレビューして発見を報告させます。)

競合する仮説で調査

根本原因が不明な場合、単一エージェントは一見合理的な説明を見つけると探求を停止する傾向があります。

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

ベストプラクティス

メンバーに十分なコンテキストを提供

メンバーは自動的にプロジェクトコンテキストを読み込みますが、リードの会話履歴を継承しません。生成プロンプトにタスク固有の詳細を含めます。

タスクサイズを適切に調整

• • 小さすぎる： 調整オーバーヘッドが利益を上回る

• • 大きすぎる： メンバーがチェックせずに長時間作業し、無駄な努力のリスクが増加

• • 適切： 自己完結した単位で、明確な成果物を生成

メンバーの完了を待機

リードがメンバーが完了するのを待たずに自分でタスクを開始することがあります。これに気付いたら：

Wait for your teammates to complete their tasks before proceeding
(進む前にメンバーがタスクを完了するのを待機)

ファイルの衝突を回避

2人のメンバーが同一ファイルを編集すると上書きが発生します。各メンバーが異なるファイルセットを担当するように作業を分割します。

監視と導き

メンバーの進捗をチェックし、うまくいかない方法をリダイレクトし、進展に応じて発見を統合します。

制限事項

Agent Teamsは実験的です。現在の制限：

• • プロセス内メンバーはセッション回復をサポートしない： /resumeおよび/rewindはプロセス内メンバーを回復しません

• • タスクステータスが遅延することがある： メンバーがタスク完了をマークできないことがあります

• • 閉鎖が遅いことがある： メンバーは閉鎖前に現在のリクエストを完了します

• • セッションごとに一つのチーム： 一つのリードが一度に一つのチームしか管理できません

• • ネストされたチームはサポートされない： メンバーは独自のチームを生成できません

• • リードは固定： チームを作成したセッションはそのライフサイクル中リードです

• • 分割画面にはtmuxまたはiTerm2が必要： VS Code統合ターミナル、Windows Terminal、Ghosttyはサポートされません