モジュール 2：マルチエージェント 4 / 6
中級 S10 Claude Code CLI Agent Teams 協調

Claude Code Agent Team の協調プロトコル

明確な担当範囲、メッセージ規律、検証証拠、安全な終了手順で Claude Code agent teams を運用します。

2026年3月20日 13分
実験機能 カリキュラム確認日: 2026年7月31日
Claude Code ≥ 2.1.226 公式情報 1 公式情報 2 公式情報 3

学ぶこと

Claude Code agent teams は抽象的なメッセージキューではなく、実際の CLI 機能です。Lead session が teammates を作成し、共有タスクリストを調整し、メッセージを受け取ります。信頼できる運用には次のルールが必要です。

  • 実験的な team 機能を明示的に有効化する
  • 各 teammate に重ならない所有範囲を与える
  • 共有タスクリストを進捗の正本にする
  • 完了時に検証証拠を要求する
  • 担当作業の終了後に teammate を停止する

Agent Teams を明示的に有効化する

このリリースでは agent teams は experimental です。必要なプロセスだけで有効化します。

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

境界が不明確な作業は Plan mode から始めます。

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 \
  claude --permission-mode plan

ファイル所有権と受け入れ条件を確定してから、lead に teammates を作成させます。

Team Contract

Lead prompt に具体的な契約を書きます。

Frontend 検証と API 検証に一人ずつ teammate を作成する。

Frontend owner:
- src/components/ と browser tests のみを担当
- API ファイルは編集しない

API owner:
- src/api/ と API tests のみを担当
- frontend ファイルは編集しない

各 teammate は：
1. 自分の task だけを取得する
2. 変更ファイルを報告する
3. 影響するテストを実行する
4. 失敗と証拠を lead に送る
5. 他の teammate の変更を戻さない

Claude Code 自体が task と messaging tools を提供するため、独自の request_id プロトコルを追加する必要はありません。

所有権を並列実行の境界にする

実行可能な task には最低限、次を含めます。

Owner: api-verifier
Scope: src/api/** と tests/api/**
Outcome: endpoint が文書化された schema を返す
Evidence: pnpm test tests/api と response 例

同じ書き込み対象を二人に割り当てないでください。共有モジュールを変更する必要がある場合は lead が所有するか、作業を直列化します。

良い分割：

Task A — API implementation を修正
Task B — 独立した browser coverage を更新
Task C — 結合 diff を読み取り専用でレビュー

メッセージには判断と証拠を含める

次のイベントでメッセージを送ります。

  • blocker が計画を変える
  • 共有インターフェースを変更する
  • 担当外のテストが失敗する
  • 検証証拠付きで task が完了する
API validation completed.
Changed: src/api/session.ts, tests/api/session.test.ts
Verification: 14/14 tests passed
Open issue: none

Lead は結果の統合、最終 diff の確認、製品レベルの gate 実行に責任を持ちます。

回復と終了

Teammate が停止した場合は共有 task の状態を調べ、未完了部分だけを再割り当てます。

統合後は：

  1. 各 teammate を停止する
  2. 実行中 task がないことを確認する
  3. 統合 diff をレビューする
  4. 影響範囲全体の test と build を実行する
  5. 証拠を集めてから lead session を終了する

Teammate の完了は製品の完了ではありません。Lead の最終検証が completion gate です。

実行例

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 \
  claude --permission-mode plan \
  "CLI reference UI と MCP tests を別 owner で監査する計画を作成。ファイル所有権を重ねず、検証結果を正確に報告すること。"

次のセッション

Session 11 では claude -p、構造化出力、予算制限、外部スケジューラを使った境界付き自動化を扱います。