Follow Discord
Sweep 10 Nov 2026 · 02:18Z Build v2.1.322 539 read Stable v2.1.311 Latest v2.1.322 Next v2.1.322 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.269 ·

Changes to how subagents are spawned with $.agent.spawn

$.agent.spawn gained fire-and-forget background launches with per-session budgets, a returned agentId, and hook-gated dispatch

Group of 4 Use it now Internal Changes
JSON All of v2.1.269
Use it nowTier: how much it should matter to you
4Useful: my rating, 1 to 5
3Signal: worth watching, 1 to 5
SubagentsArea: what it touches
Internal ChangesKind: in v2.1.269,
What probably matters to youSection of the release

Unclear What determines whether the internal check passes is not established by the evidence.

What

  • $.agent.spawn can now be launched as fire-and-forget: a spawn wrapper enforces a budget of 50 spawns per session and at most 4 concurrently running agents per plugin, then returns a 'started' result immediately without waiting for the agent to finish, letting it keep running in the background; failures surface later only through a log line.
  • On success, $.agent.spawn results now include an agentId field alongside the existing model/text/isError fields.
  • The agent.spawn hook pipeline now only runs (with its 'started'/dispose telemetry) when enabled by a check; otherwise it returns a no-op object that does nothing on start or dispose.
  • The debug log line for a hook that rewrites a subagent's model on spawn no longer includes what the model ultimately resolves to, only the raw before/after model strings.

Why These changes make spawning subagents more flexible for background/plugin use cases (not every spawn needs to block and wait), while adding guardrails (budgets, concurrency limits) to prevent runaway spawning, and giving callers an id to track the agent they started.

Read from
Names in the bundleagent.spawn
Since it was published

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.

Added since A small documentation edit on Orchestrate teams of Claude Code sessions touched a line naming agent.spawn after this was published. If an installed [mod](/docs/en/plugins/mods/overview) sets a model in its [`agent.spawn`](/docs/en/plugins/mods/reference#subagents) hook, Claude Code uses that model in place of the first source. agent-teams see the edit
Confirmed since Anthropic's documentation has since written up agent.spawn, on Claude Code changelog. * Added `agent.spawn` for teammates, one agent id across plugin hook events, and idle and waiting states in `$.agent.list()` changelog see the edit
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhat determines whether the internal check passes is not established by the evidence.
Anthropic's documentation agreesAnthropic's documentation has since written up agent.spawn, on Claude Code changelog.

See this entry in the whole of v2.1.269 →

Feedback