Claude Code v2.1.305: New Sandbox and Retry Watchdog Settings, Plus a Tool Search Fix
Hi, it's Shii-chan!
Claude Code ReleaseA new Claude Code release, v2.1.305, is out. There are lots of fixes, so let's go through the highlights!
What was announced?
This is the Claude Code release note for v2.1.305 on GitHub. It covers the core CLI plus the Self-hosted Runner, VS Code, Cloud Sessions, Claude Tag, and Code Review.
Why it matters
The most important item is a fix for a regression introduced in 2.1.304. On Vertex, Bedrock, and other providers, every request failed when the endpoint or a gateway rejected tool search, including behind gateways with ToolSearch disallowed or left out of --tools. Claude Code now retries without it.
What changes
Two settings were added:
sandbox.allowNestedUserNamespaces: lets sandboxed commands on Linux create user namespaces (Chromium, rootless podman). Note that this lets them get around the sandbox's file protectionsCLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS: lets unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG) notice a usage limit that was lifted before its reset
Dive Deep
Some notable fixes:
/effortand/autocompactnot applying when the model name differed from amodelOverridesvalue by letter case or a[1m]tag- New worktrees in a bare repository sometimes starting from local HEAD instead of the default branch
- Bash commands on a full disk failing with a raw
ENOSPCfile path; the error now says the disk is full and that nothing ran - Claude naming the wrong model for a subagent's work after it switched to a fallback model
- Workflow resume re-running completed
pipeline()andparallel()agents
Some behavior changes to watch for:
allowedMcpServersno longer filtersmanaged-mcp.jsonstdio servers that use${VAR}only inenv. A server your allowlist previously excluded now loads on upgrade; usedeniedMcpServersto keep it off- The
/artifactsdelete confirmation uses 1 or Enter to keep, 2 to delete, and Esc to cancel;yandnno longer work
Also, /usage warnings are now one-line fixes you can apply with f, VS Code shows a spinner while SessionStart or Setup hooks run, and Code Review now reviews the newest commit even when several pushes land during a review.
Wrap-up
sandbox.allowNestedUserNamespacesallows user namespaces in the Linux sandboxCLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MScontrols usage limit rechecks in unattended retry mode- The 2.1.304 regression where every request failed when tool search was rejected is fixed
allowedMcpServersbehavior and the/artifactsdelete keys changed
This release is for anyone using Vertex or Bedrock, and anyone running Chromium or podman in the sandbox!