エージェントチーム入門

1エージェントチームとは

ひとことで言うと、「リーダー＋メンバー」で働く複数AIのチーム。各メンバーはそれぞれ独立した Claude（＝別々の記憶・別々のコンテキスト）で、共有のタスク板で仕事を取り合い、必要ならメンバー同士が直接メッセージを送り合います。

flowchart TD
  L["リーダー（あなたのセッション）
計画・まとめ役"] --> T["共有タスク板
やること一覧"]
  T --> A["メンバーA
独立したClaude"]
  T --> B["メンバーB
独立したClaude"]
  T --> C["メンバーC
独立したClaude"]
  A <-->|"直接相談"| B
  B <-->|"直接相談"| C
  A --> T
  B --> T
  C --> T
  T --> L

2サブエージェント／チーム／ワークフローの違い

「複数で動かす」しくみは3つあり、性格がまるで違います。混同しやすいのでここで整理します。

3有効化と始め方

実験的機能なので、まずスイッチを入れる必要があります。

1. 環境変数で有効化CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を設定（または settings.json の env に記載）して、Claude Code を再起動します。
2. バージョンとプランを確認claude --version が v2.1.178 以降であること、有料プランであることを確認。
3. 言葉でチームを立てるあとはふつうの日本語で「3人のチームメイトを立てて〜」と頼むだけ。メンバーの新規作成・タスク板・後片づけは自動です。

# 環境変数で有効化して起動（要再起動）
$ export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
$ claude

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

🖥️表示モード（メンバーの見え方）

切り替えは /config または起動時に claude --teammate-mode tmux のように指定します。（VS Code 内蔵ターミナル等では分割表示に非対応。その場合は in-process で。実験的機能のため操作は変わりうる）

4仕組み：タスク板で協調する

チームの心臓は共有タスク板。リーダーがやることを並べ、メンバーが空いている仕事を自分で取り、終わったら次を取る——という流れで自律的に回ります。

sequenceDiagram
  participant U as あなた(=リーダー)
  participant T as 共有タスク板
  participant A as メンバーA
  participant B as メンバーB
  U->>T: 計画を分解してタスクを並べる
  A->>T: 空きタスクを確保して着手
  B->>T: 別の空きタスクを確保して着手
  A-->>B: 「ここ依存してるよ」と直接相談
  B-->>A: 「対応した、確認して」
  A->>T: 完了に更新
  B->>T: 完了に更新
  T-->>U: 全タスク完了
  U->>U: 結果を統合して報告

5向いてる仕事／向かない仕事

チームは「独立して並列に進められて、かつ議論が活きる」仕事でこそ輝きます。逆は単独のほうが速くて安いです。

6コストとサイズ感

チームは人数ぶんトークンを食います。便利さと費用のバランスを意識しましょう。

7使ってみる：実例

認証まわりをチームで点検する例です。役割をはっきり分け、相互チェックまで頼むのがコツ。

認証モジュール（@src/auth/）をチームで点検したい。3人のメンバーを立てて、
役割を分けて：
- 1人はトークン更新ロジック担当
- 1人はセッション管理担当
- 1人はセキュリティ観点でレビュー
各自が読んで所見を出したら、お互いの結果を相互チェックして、
意見が割れたら議論して合意してから、まとめて報告して。

こう頼むと、リーダーがメンバー3人を立て、タスク板に「トークン更新の確認」「セッション管理の確認」「セキュリティ監査」「結果の統合」を並べ、各メンバーが並列で読み始めます。途中で「セキュリティ担当→トークン担当：更新トークンの失効チェックが抜けてる」のようにメンバー同士が直接指摘し合い、最後にリーダーが統合して報告します。

8注意・制限（実験的機能）

現状の制限を知っておくと、ハマりません。