Follow Discord
Sweep 27 Oct 2026 · 19:04Z Build v2.1.312 531 read Stable v2.1.308 Latest v2.1.312 Next v2.1.312 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.311 ·

Background shell commands: subagent time cap and clearer messages

Subagents' long commands can be moved to the background sooner, and the messages Claude gets about backgrounded or stopped commands are clearer

Group of 4 Use it now Improvements
JSON All of v2.1.311
Use it nowTier: how much it should matter to you
2Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
Background AgentsArea: what it touches
ImprovementsKind: in v2.1.311,
What probably matters to youSection of the release

Unclear Where the subagent cap's value comes from, and whether it always applies, is not known.

What

When a shell command runs too long, Claude Code moves it to the background so the conversation can continue. A subagent is a helper agent Claude starts to work on part of a task.

  • Subagent cap: the auto-background timeout now takes a subagentCapMs value and applies to subagents as well. Before, only the main agent honoured CLAUDE_CODE_AUTO_BACKGROUND_TIMEOUT_MS. Bash and PowerShell results carry a new subagentCapApplied field, true when this cap shortened a command's timeout.
  • Backgrounding message: the message now says "It is running now: do not start a second copy while it runs", explains how to stop it, and warns that buffered output can leave the output file empty. When the subagent cap applied, it says the command was moved to the background after running for a number of seconds, instead of citing a timeout.
  • Output seen: the message also reports whether any output was seen before the timeout (noOutputSeenAtTimeout).
  • Stop reasons: a stopped background command's message can now use an optional stopExplanation instead of the fixed stop text. A stop at a deadline gets one.
  • PowerShell: it passes the subagent cap and forwards progress only under a condition.

Why

Long commands run by subagents can move to the background earlier. Claude is told not to launch duplicate copies, such as a second server, and not to read an empty output file as a failure.

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 doubtWhere the subagent cap's value comes from, and whether it always applies, is not known.

See this entry in the whole of v2.1.311 →

Feedback