Follow Discord
Sweep 06 Nov 2026 · 01:32Z Build v2.1.319 537 read Stable v2.1.311 Latest v2.1.318 Next v2.1.319 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.277 ·

New tool backgrounding field controls detach/self/never execution mode

Tools gain a backgrounding setting controlling whether they can keep running in the background

Under the hood Internal Changes
JSON All of v2.1.277
Under the hoodTier: how much it should matter to you
3Useful: my rating, 1 to 5
3Signal: worth watching, 1 to 5
Background TasksArea: what it touches
Internal ChangesKind: in v2.1.277,
Internal ChangesSection of the release

Unclear The finding does not say which tools are actually marked as detach-capable versus self or never, or when background results become visible to the user.

What

Many built-in tools — including WebFetch, WebSearch, Bash, Task, PowerShell, MCP (Model Context Protocol) tools, and various read-only lookup tools — now carry a backgrounding property set to one of three values: "detach", "self", or "never". Tools without a value default to "never". A new internal check looks at whether a tool's backgrounding is "detach" to decide if that tool call is allowed to keep running in the background, with its result delivered later through a separate message once it finishes.

Why

This lays the groundwork for certain tools to run in the background instead of blocking the conversation while they complete, letting Claude Code (and the user) continue working while a long-running tool call finishes elsewhere.

Read from
Names in the bundlebackgrounding
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 Tools reference touched a line naming backgrounding after this was published. Setting [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/en/env-vars#variables) or running in [bare mode](/docs/en/headless#start-faster-with-bare-mode) disables auto-backgrounding along with the rest of the background task functionality, … tools-reference see the edit
Confirmed since Anthropic's documentation has since written up backgrounding, on Agent SDK reference - TypeScript. For a subagent task, the `summary` field carries a model-generated progress summary and is populated only when [`agentProgressSummaries`](#options) is enabled. For a [backgrounded MCP tool call](/docs/en/mcp#automatic-backgrounding-of-long… agent-sdk/typescript 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 doubtThe finding does not say which tools are actually marked as detach-capable versus self or never, or when background results become visible…
Anthropic's documentation agreesAnthropic's documentation has since written up backgrounding, on Agent SDK reference - TypeScript.

See this entry in the whole of v2.1.277 →

Feedback