Claude Code Subagents Can Now Spawn Their Own Subagents

#claudecode #subagents #agentorchestration #anthropic

Claude Code Subagents Can Now Spawn Their Own Subagents

Starting with Claude Code 2.1.172, subagents can spawn their own subagents underneath them. According to the changelog, nesting goes up to 5 levels deep. The release shipped on June 10, and since it changes agent delegation from a single layer to a multi-level structure, it's worth a closer look.

01. Until now, delegation stopped at one level

Previously in Claude Code, the main session could split work off to subagents, but those subagents couldn't spawn agents of their own. If you wanted work broken into smaller pieces, the main session had to carry the entire distribution job itself.

The release notes for this version state that "subagents can create their own subagents, with nesting up to 5 levels deep." A delegated agent can now use its own judgment to split work further.

02. Big tasks can now be split into tree structures

For example, you could imagine a code-review coordinator agent spawning child inspection agents per batch of files. This looks useful for work that doesn't fit in a single context window — large-scale migrations, or auditing an entire codebase.

That said, beyond the release notes there's no official documentation yet on recommended patterns. Questions like how deep the nesting should actually go are operational judgment calls you'll have to develop by using it.

03. Token usage is something to think through up front

Agents calling agents means calls fan out into a tree — and token usage grows right along with it. If you're on a subscription plan, that's a faster path to burning through your usage limits.

5 levels is just the ceiling — going deep isn't always a win. Each extra level adds another intermediate agent summarizing results upward, and that summarization comes with information loss.

04. The same release ships a few smaller changes

2.1.172 includes other changes too. /plugin gets a search bar for browsing marketplace plugins, and a bug where sessions using 1M context without usage credits got permanently stuck is now fixed — they auto-compact down to standard limits instead. If you're on Amazon Bedrock, note that when the AWS_REGION environment variable isn't set, Claude Code now reads the region from your ~/.aws config files.

Updates arrive automatically, but you can check your version like this: