Claude Code Agent Teams
Best for: Parallel research, review and debugging inside the Claude Code session you already use.
Agent Teams is a feature of Claude Code itself. One session acts as the team lead; it spawns teammates, each a separate Claude Code instance with its own context window. The team shares a task list whose tasks can depend on each other, and teammates message each other directly through a mailbox. You can talk to any teammate yourself, in the same terminal or in split panes under tmux or iTerm2.
Anthropic’s documentation is candid about where it fits. Its strongest use cases are research and review, new modules that teammates can own separately, debugging with competing hypotheses, and cross-layer changes. For sequential work, same-file edits, or work with many dependencies, the docs recommend a single session or subagents instead. Quality gates are available through hooks: a TaskCompleted or TeammateIdle hook that exits with code 2 sends feedback and keeps the work going.
Keep in mind
- Experimental and disabled by default. You enable it with the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS setting.
- Documented limitations include no session resumption for in-process teammates, one team per session, no nested teams, and a lead that cannot be changed.
- Teammates spawn only in interactive sessions, not in non-interactive mode with the -p flag.
- Token use scales with the number of teammates, and the docs warn that two teammates editing the same file leads to overwrites.