CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION
A Claude Code environment variable, read out of the shipped bundle. It was in the build from v2.1.212 and was gone by v2.1.224.
Removed in v2.1.224 and now a no-op. Previously capped the total number of subagents Claude could spawn with the Agent tool in one session (default: 200); spawning past the cap failed with Subagent spawn limit reached. The concurrent subagent limit and the depth limit still apply
Anthropic's own wording. Read off Environment variables, captured 2026-09-28.
In the changelogs
1Releases whose published page names CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION.
-
v2.1.224
The per-session subagent spawn limit is gone
You can spawn as many subagents as you want in one session; the per-session cap is gone.
found in this entry's text
First cited
0No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.
Presence across releases
2Build by build
85One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the environment variable does. All environment variables.