Coordinate multiple Claude Code instances working together as a team, with shared tasks, inter-agent messaging, and centralized management.
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS to your Agent teams are experimental and disabled by default. Enable them by addingto your settings.json or environment. Agent teams have known limitations around session resumption, task coordination, and shutdown behavior.
Agent teams let you coordinate multiple Claude Code instances working together. One session acts as the team lead, coordinating work, assigning tasks, and synthesizing results. Teammates work independently, each in its own context window, and communicate directly with each other.
Unlike subagents , which run within a single session and can only report back to the main agent, you can also interact with individual teammates directly without going through the lead.
This page covers:
When to use agent teams
Agent teams are most effective for tasks where parallel exploration adds real value. See use case examples for full scenarios. The strongest use cases are:
Research and review : multiple teammates can investigate different aspects of a problem simultaneously, then share and challenge each other’s findings
: multiple teammates can investigate different aspects of a problem simultaneously, then share and challenge each other’s findings New modules or features : teammates can each own a separate piece without stepping on each other
: teammates can each own a separate piece without stepping on each other Debugging with competing hypotheses : teammates test different theories in parallel and converge on the answer faster
... continue reading