CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS

Updated October 13, 2026 by Alex Sorokoletov

CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS is a Claude Code environment variable. Added between v2.1.266 and v2.1.269 and still present in v2.1.294. It is listed in the official reference.

How to set it

For one session, export it in the shell that starts Claude Code:

export CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS=<value>
claude

To apply it to every session, add it to the env object of a settings file:

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS": "<value>"
  }
}

Release notes that mention it

• Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models
• claude-code-env-vars-v2-1-269

Related variables

• CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS: Ceiling on subagents running at once, default 20; when full Claude Code tells the model to stop and the user to raise this variable.
• CLAUDE_CODE_WORKFLOW_SIZE_WARNING_AGENTS
• CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS: Disable built-in agent types.
• CLAUDE_AGENTS_AUTO_RELAUNCHED_AT: Timestamp set when the agent fleet was automatically relaunched after a crash.
• CLAUDE_AGENTS_SELECT: Selects which agents from a fleet configuration are active for this session or job.
• CLAUDE_CODE_DISABLE_AGENTS_FLEET: Kill switch for the entire agent fleet subsystem — no selection, no auto-relaunch, no fleet coordination.
• CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS
• CLAUDE_CODE_EXPERIMENTAL_OBSERVER_AGENTS: Agents that watch a session rather than act in it.

Frequently asked questions

All variables, searchable: Claude Code environment variables.