Workflow tool's concurrent-agent limit can now be overridden with an environment variable
The Workflow orchestration engine dispatches multiple agents at once, and the maximum number running concurrently was previously fixed at a computed value based on your machine's CPU count (between 2 and 16). That cap can now be overridden by setting the CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS environment variable, and a debug log line now reports whichever value is actually in effect.
This gives more control over how many agents a workflow runs at once, useful for tuning resource usage on a given machine or lifting the default cap for larger workflows.
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | How many agents a single [workflow](/docs/en/workflows) run executes at once, from `1` to `256`. By default, a run executes up to 16 agents at once, fewer when Claude Code has fewer CPUs ava…env-vars see the edit
Anthropic's documentation has since written up CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS, on Environment variables.
Added CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS (1–256) to raise the Workflow tool's per-run concurrent agent limit for inference-bound…
New in this build: CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS