Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.309 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.309 ·

Settings that switch the sandbox on are now tracked, and can pause sandbox auto-allow

Claude Code now notes when seeded or held settings turn the sandbox on, and pauses automatic approval of sandboxed commands in that case

Group of 2 You'll notice Improvements
JSON All of v2.1.309
You'll noticeTier: how much it should matter to you
1Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
SandboxArea: what it touches
ImprovementsKind: in v2.1.309,
ImprovementsSection of the release

Unclear It is not stated what a held file is or how it turns the sandbox on.

What

The sandbox is a restricted environment in which Claude Code can run shell commands, and settings files can switch it on. This release changes what happens when settings turn the sandbox on:

  • When project settings are set up (seeded), Claude Code now notices if the settings in the local settings slot turn the sandbox on. It records this as sandboxTurnedOn and keeps those settings from being skipped as they otherwise would be. The setup step now takes a callback and a flag, and one settings path is skipped when the flag is not set.
  • Sandbox auto-allow is the automatic approval of commands because they run inside the sandbox. It is now also suspended (sandboxAutoAllowSuspended) when a held settings file is what turned the sandbox on (sandboxTurnedOnByHeldFile).

Why

If a project's settings switch the sandbox on, Claude Code no longer treats that as a reason to approve commands on its own. In that situation you may be asked to approve Bash commands that would otherwise have run without a prompt.

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 doubtIt is not stated what a held file is or how it turns the sandbox on.

See this entry in the whole of v2.1.309 →

Feedback