Follow Discord
Sweep 23 Oct 2026 · 21:48Z Build v2.1.310 529 read Stable v2.1.308 Latest v2.1.309 Next v2.1.310 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeReleasesv2.1.310entry #17

Claude Code v2.1.310 ·

New CLAUDE_CODE_RETRY_WATCHDOG_SCOPE limits the retry watchdog to capacity waits

Set CLAUDE_CODE_RETRY_WATCHDOG_SCOPE=capacity to keep the retry watchdog waiting through capacity errors without its other retry changes

Use it now Notable New Features
JSON All of v2.1.310
Use it nowTier: how much it should matter to you
5Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
RetriesArea: what it touches
New FeaturesKind: in v2.1.310,
What probably matters to youSection of the release
What

CLAUDE_CODE_RETRY_WATCHDOG is the environment variable for unattended runs that makes Claude Code keep retrying through temporary capacity errors (the service being too busy). A new environment variable, CLAUDE_CODE_RETRY_WATCHDOG_SCOPE, narrows what it does.

When CLAUDE_CODE_RETRY_WATCHDOG is set and CLAUDE_CODE_RETRY_WATCHDOG_SCOPE is capacity, Claude Code still keeps waiting through capacity errors, but these behave as if the watchdog were off:

  • the cap on how many times a request is retried
  • switching to a fallback model
  • how retry attempts are counted
  • the minimum delay between retries

With any other value, or with it unset, the watchdog works in full as before. Self-hosted sessions started by the remote runner set CLAUDE_CODE_RETRY_WATCHDOG to 1, and nothing in Claude Code sets the scope for you.

Why

If you run the watchdog unattended and only want it to ride out capacity outages, you can now keep your normal retry limit and avoid it switching you to a fallback model.

Read from
Names in the bundleCLAUDE_CODE_RETRY_WATCHDOG_SCOPECLAUDE_CODE_RETRY_WATCHDOG
What the documentation says
CLAUDE_CODE_RETRY_WATCHDOG Error reference modified, high confidence * A streaming request the API never answers with response headers, on a connection where the [first-byte deadline runs](/docs/en/network-config.md#streaming-idle-watchdogs). At the deadline, Claude Code aborts the request and re-sends it w… see the edit
CLAUDE_CODE_RETRY_WATCHDOG Agent SDK reference - TypeScript modified, high confidence For unattended runs that need to wait through longer outages, set [`CLAUDE_CODE_RETRY_WATCHDOG=1`](https://code.claude.com/docs/en/errors#tune-retry-behavior): it retries transient capacity errors indefinitely and, on Claude Code v2.1.199 … see the edit
CLAUDE_CODE_RETRY_WATCHDOG Monitoring modified, high confidence The `attempt` attribute on the event records the number of attempts. `CLAUDE_CODE_MAX_RETRIES` defaults to 10 and is capped at 15; with [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/en/env-vars) set, the default is higher and… see the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agreesCLAUDE_CODE_RETRY_WATCHDOG on Error reference
The name it cites is new in this buildNew in this build: CLAUDE_CODE_RETRY_WATCHDOG_SCOPE

See this entry in the whole of v2.1.310 →

Feedback