Agent Teams

Claude Code の実験的機能（Experimental）。Lead と複数 Teammate のピアツーピア構成で、tmux split-pane に各エージェントを並列展開し、タスクを分担して実行する。

概要

従来の Sub-agents（fire-and-forget） は親セッション内で結果を返すだけだったのに対し、Agent Teams は各 Teammate が 独立した 1M トークンのコンテキスト を持ち、tmux pane で互いに通信しながら作業を進める。途中で人間が個別 pane に介入できるのも特徴。

比較項目	Sub-agents	Agent Teams
通信	親子のみ	ピアツーピア
途中介入	不可	可能（tmux）
独立コンテキスト	なし（親の中）	あり（各 1M トークン）
ステータス	GA	Experimental
Remote Control 連携	恩恵薄い	リード経由で操作可能

有効化

~/.claude/settings.json または DevContainer の containerEnv / customizations.vscode.settings.claudeCode.env に以下を設定：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "teammateMode": "auto"
}

teammateMode の選択肢：

設定	動作
`"in-process"`	全 Teammate が 1 つのターミナル内（デフォルト）
`"tmux"`	各 Teammate が独自の tmux pane
`"auto"`	tmux 内なら split-pane、外なら in-process（公式推奨）

動作環境

環境	Split-pane
macOS + tmux / iTerm2	✅
Linux + tmux	✅
WSL + tmux（WSL 内で実行）	✅
Windows Terminal	❌ 非対応
VS Code 統合ターミナル	❌ 公式に非対応

VS Code 統合ターミナルは tmux 制御コードと競合するため、Konsole / GNOME Terminal などホスト端末から docker exec → tmux → claude で起動するのが安定運用。

キーボード操作

In-process モード

操作	機能
`Shift+Down` / `Shift+Up`	Teammate 間移動
`Enter`	選択した Teammate のセッション全体を表示
`Escape`	Teammate を中断
`Ctrl+T`	タスクリスト表示
`Shift+Tab`	Delegate Mode 切替

Split-pane モード（tmux）

操作	機能
`Ctrl+B` → 矢印キー	pane 間移動
`Ctrl+B` → `z`	pane 拡大 / 縮小
pane クリック	直接操作

Delegate Mode

Shift+Tab で有効化すると Lead が 調整専用になり、実装作業を行わなくなる。Lead のコンテキスト消費を抑え、Teammates に作業を完全委譲できるため、4+ 人の大規模チームで特に有効。

既知の制限

セッション再開（/resume, /rewind）で in-process の Teammate は復元されない
同じファイルの同時編集はファイルロックなし
1 セッション 1 チーム限定（ネスト不可）
4+ 人のチームでは tmux コマンドが不安定になる場合あり

Agent Teams 編：12 体のサブエージェント構成とマルチエージェント並列協調 — CTS-EC の 12 体構成と並列パターン
Claude Code リモート操作 — Remote Control 経由でリードに方針判断を投げる運用
Ubuntu 開発環境構築 — DevContainer + tmux で安全に動かす Linux 側の前提

概要

有効化