Claude Agents: 3 Layers Max, but Less Recommended
Claude Code now nests sub-agents 3 layers deep. Official advice warns most programming tasks don't need multi-agent systems.
“AI Disruption” Publication 10,300 Subscriptions 20% Discount Offer Link.
The agents you dispatch can now dispatch their own agents, nested up to three layers deep. But before you get excited, take a look at what Anthropic itself says about the cost of this.
Claude Code v2.1.219 has a one-line changelog entry:
Enabled nested subagents up to depth 3 by default (previously 1)
There’s more information packed into that single line than it first appears. This isn’t “adding nested capability”—it’s a rollback.
The real version history: cut from 5 layers down to 1, then raised back to 3
Looking at the official documentation’s version notes, this default value has been changed three times:
Default nested depth for sub-agents has been changed three times: from v2.1.172 to 216 it was 5 layers and non-adjustable; 217 to 218 it was dropped to 1 layer (effectively disabled); from 219 onward it is set to 3 layers.
