CLAUDE_CODE_COORDINATOR_MODE
Updated by Alex Sorokoletov
CLAUDE_CODE_COORDINATOR_MODE is a Claude Code environment variable: Runs a session as a coordinator over child agents, with companions for its toolset and whether memory flows down the tree. The agent-teams plumbing that was hinted at earlier is now a named mode. Added between v2.1.143 and v2.1.212 and still present in v2.1.294. It is not in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Added between v2.1.143 and v2.1.212 |
| Category | Agents and subagents |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_COORDINATOR_MODE=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_COORDINATOR_MODE": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_CODE_COORDINATOR_EXTRA_TOOLSCLAUDE_CODE_COORDINATOR_FORCE_WORKER_INHERIT_MODELCLAUDE_CODE_COORDINATOR_PROPAGATE_NESTED_MEMORYCLAUDE_CODE_COORDINATOR_SKILL_GUIDANCECLAUDE_CODE_COORDINATOR_WORKER_CHECKIN_SECONDSCLAUDE_AGENT: Short-form identifier for the current agent, used in inter-agent messaging and log attribution.CLAUDE_AGENT_SDK_CLIENT_APP: Client application name.CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS: Disable built-in agent types.
Frequently asked questions
What does CLAUDE_CODE_COORDINATOR_MODE do?
Runs a session as a coordinator over child agents, with companions for its toolset and whether memory flows down the tree. The agent-teams plumbing that was hinted at earlier is now a named mode.
Which Claude Code version has CLAUDE_CODE_COORDINATOR_MODE?
Added between v2.1.143 and v2.1.212 and still present in v2.1.294.
How do I set CLAUDE_CODE_COORDINATOR_MODE?
Export it before starting Claude Code (export CLAUDE_CODE_COORDINATOR_MODE=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.