Turning On Agent Teams
You ask Claude Code to spawn several teammates to debate competing hypotheses about a bug. No team forms — Claude just runs ordinary subagents instead.
What's the most likely reason?
The correct answer is "Agent teams are experimental, gated by an environment variable."
Agent teams are experimental and disabled by default. Nothing
described in that feature runs unless CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
is set, in your shell environment or in settings.json. Without that
variable set, no team is ever set up at session start, no team
directories are written, and Claude will not spawn or propose
teammates — full stop, regardless of how the request is phrased.
The distractors invent restrictions that don't exist: agent teams
aren't limited to the Desktop app, they aren't gated behind an
Enterprise plan, and they have nothing to do with
--permission-mode bypassPermissions — the actual gate is the one
environment variable.
Share this question