⌨️CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS
Also known as CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS environment variable
It sets how many subagents can run at the same time.
Think of it like
It is like a small kitchen. Only so many cooks fit at once.
Example
Jack's laptop slows down when Claude starts many helpers. He sets the cap to 5, and the work runs steady.
Why it matters
Each helper uses memory, tokens and API calls. A cap keeps a burst from swamping you.
Definition
Example code
bash
export CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=5
claudeCommon mistake
Key takeaways
- 1Default 20. At once.
- 2Whole number. Cannot remove it.
- 32.1.217 or later. Older ignore it.