agent-teamslisted

# Agent Teams (Multi-Agent Orchestration) > Coordinate multiple Claude Code instances working together as a team, with shared tasks, inter-agent messaging, and centralized management. ## Prerequisites - **Claude Code >= 2.1.19** - **Feature flag enabled**: `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` - **tmux** (optional): for split-panes mode ### Activation Add to `.claude/settings.local.json` or `.claude/settings.json`: ```json { "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } } ``` Or via environment variable: ```bash export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 ``` ## When to use Agent Teams vs Sub-Agents ``` ┌────────────────────────────────────────────────────────────────────┐ │ AGENT TEAMS vs SUB-AGENTS: DECISION GUIDE │ ├────────────────────────────────────────────────────────────────────┤ │ │ │ AGENT TEAMS if: │ │ - Agents need to COMMUNICATE with each other │ │ - COMPLEX work requiring discussion and collaboration │ │ - Tasks with coordination (cross-review, debate, consensus) │ │ - 3+ agents working in parallel over a long duration │ │ │ │ SUB-AGENTS (Task tool) if: │ │ - FOCUSED task where only the result matters │ │ - No need