エージェントチームとコミュニケーション

学ぶこと

Agent Teams は、複数の独立した session を継続的に協働させる Claude Code の実験機能です。このセッションでは公開された運用モデルだけを扱います。

• 1つの lead がチームを調整する
• teammates は別々のコンテキストウィンドウで作業する
• 共有タスクリストが担当と依存関係を追跡する
• **メールボックス（mailbox）**がエージェント間の直接メッセージを運ぶ

Agent Teams は実験機能で、デフォルトでは無効です。以下の手順は 2026 年 7 月 20 日に公式ドキュメントで検証しています。

公開されたチームモデル

要素	責務
Team lead	teammates を起動し、作業を調整・割り当て、結果を統合する
Teammates	境界の明確な調査や実装を担当する、独立した Claude Code sessions
共有タスクリスト	pending、in progress、completed の状態と依存関係を保持する
Mailbox	lead と teammates の間、または teammates 同士でメッセージを届ける

Teammate は起動時に通常のプロジェクトコンテキスト（CLAUDE.md、skills、MCP servers など）と spawn prompt を読み込みます。ただし、lead の会話履歴は継承しません。成功に必要なタスク固有の情報は、spawn prompt または後続メッセージに含めてください。

Agent Teams と Subagents の違い

集中した作業の結果だけを呼び出し元へ返せばよい場合は subagent を使います。作業者同士が発見を共有し、仮説を反証し、タスクを取得し、個別に操作され続ける必要がある場合は Agent Team を使います。

	Subagent	Agent Team teammate
コンテキスト	分離されたコンテキスト	独立した session
通信	呼び出し元へ報告	lead や他の teammates へ直接送信可能
調整	メインエージェントが委任	共有タスクリストで自己調整
コスト	低い	高い。各 teammate が個別のコンテキストを消費する

Agent Teams を有効にする

環境または設定で実験フラグを有効にします。

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

次に、チームと境界を自然言語で指定します。

3人の teammates からなる agent team を作成する：
- researcher：現在の認証フローを整理する
- reviewer：セキュリティと権限のリスクを調べる
- tester：不足しているテストを特定する

各 teammate に別々のタスクを割り当て、互いに証拠を共有させ、
すべてのタスクが終わるまで待ってから結果を統合する。

最初の teammate が起動するとチームが形成され、現在の session が lead になります。現行バージョンには、スクリプトから依存できる公開 TeamCreate / TeamDelete ツールはありません。

タスクとメッセージで調整する

Lead は明示的にタスクを割り当てられ、idle の teammate は未割り当てでブロックされていないタスクを取得できます。依存先が完了するまで、後続タスクは pending のままです。

他のエージェントの作業を変える情報は、メッセージで伝えます。

researcher が src/auth/token.ts に token 解析を見つけたと reviewer に伝える。
tester に同じ境界を検証させ、失敗したコマンドを報告させる。

メッセージは自動配信されます。タスクリストは作業状態を記録しますが、受け入れ条件、ファイル所有権、証拠の説明を代替するものではありません。

信頼できる運用パターン

1. 作業を独立して納品でき、ファイル所有権が重ならない単位に分ける。
2. 各 teammate に関連パス、制約、完了条件を渡す。
3. 時間順に頼らず、依存関係を共有タスクリストへ記録する。
4. 結論だけでなく証拠を送るよう teammates に求める。
5. すべての実行中タスクを待ち、lead が衝突を解消して統合結果を検証する。

並列化が調整コストと token コストに見合う場合だけ、まず三〜五人で始めます。逐次作業、強く結合したタスク、同一ファイルの編集には通常、単一 session の方が適しています。

ライフサイクルと制限

• in-process の agent panel または split pane から teammate を直接誘導できます。
• 権限要求にはユーザーの権限が必要で、あるエージェントが別のエージェントの拒否を回避することはできません。
• 作業完了後は、lead から teammate に正常終了を依頼します。
• チームの実行状態は Claude Code が管理し、session 終了時にクリーンアップします。非公開ファイルや未公開 schema にワークフローを依存させないでください。
• Session の再開、タスク調整、終了動作には、公式に記載された実験上の制限があります。

依存できる契約は lead、teammates、共有タスク、メッセージングです。公式リファレンスが明示的に保証しない限り、内部ファイル名や保存構造は実装詳細です。

公式情報源

• Claude Code の Agent Teams を調整する
• カスタム Subagents を作成する

次のセッション

次は、所有権、証拠、引き継ぎ、完了条件を明示した協働プロトコルへ進みます。