Claude Code の Agent Teams: 表示は tmux／iTerm2 の分割、モデルはプロンプトで名指し、使い分けは「議論が要るか」
Agent Teams（実験機能）は、teammateMode で各メンバーを tmux か iTerm2 の別ペインに出すと操作しやすい。メンバーのモデルはプロンプトで名指しするのが一番強い。結果だけ欲しいならサブエージェント、メンバー同士の議論が要るなら Agent Teams を使う。
どんな時に使う？
- 並列レビューや、競合する仮説を別々のメンバーに検証させたい
- in-process 表示だと、誰が何をしているか追いにくい
手順
- 有効化: settings.json の
envに"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" - 表示モード:
~/.claude/settings.jsonに"teammateMode": "auto"（tmux の中か、it2CLI のある iTerm2 なら分割ペイン、それ以外は in-process）。1回だけならclaude --teammate-mode tmux - モデル: 「レビュー役は Haiku で」のようにプロンプトで名指しする。どのメンバーも同じモデルに固定したいなら
CLAUDE_CODE_SUBAGENT_MODELとCLAUDE_CODE_SUBAGENT_MODEL_FORCE=1（v2.1.257 以降）。決まる順番は Claude Code: サブエージェントのモデルはどれが勝つか（決定順） - 話しかける: in-process なら ↑↓ でメンバーを選んで Enter。分割ペインならそのペインをクリックする
サブエージェントとの使い分け（公式ドキュメント）
- 結果だけ欲しい（調査、検証、レビュー）→ サブエージェント
- 議論や協力が必要（競合仮説の検証、並列レビュー）→ Agent Teams
- サブエージェントでコンテキストが足りない、サブエージェント同士で通信させたい → Agent Teams へ移る
注意点
- 2026-02 に @laiso が試した頃は「
CLAUDE_CODE_SUBAGENT_MODELが効かず、プロンプトで誘導するしかない」状態だった。その後の修正で環境変数も効くようになり、今は上の順番で決まる --agent-id・--team-name・--agent-nameで名前を付ける小技も当時あったが、その後 TeamCreate／TeamDelete が無くなり、team_nameは無視されるようになった。今はメンバーの名前を Agent ツールのnameで付ける--teammate-modeは実験的なフラグでclaude --helpに出ない- トークンを多く使う。コストの話は Claude Code の Agent Teams で、各工程を Opus と Codex に二重レビューさせる も参照
出典
- @laiso · 2026-02-07 ・ @laiso · 2026-02-07 ・ @laiso · 2026-02-07 ・ @laiso · 2026-02-07
- @suna_gaku 2026-02-06（使い分け）: @suna_gaku · 2026-02-06
- 公式ドキュメント Agent teams: code.claude.com
- Claude Code CHANGELOG（TeamCreate 廃止、SUBAGENT_MODEL の修正）: github.com