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

Claude Code v2.1.248 ·

Claude Code can refuse to start when the sandbox is unavailable

Set sandbox.failIfUnavailable to make Claude Code exit instead of running without a sandbox.

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

Sandbox startup moved into its own step that can decline to launch. If the setting sandbox.failIfUnavailable is on and no working sandbox is found, Claude Code writes an error to stderr and exits with code 1. The setting defaults to false, in which case it logs a warning and records one setup issue instead. Remote sessions skip the check entirely.

Details
  • The setting is marked restrictive in the settings schema, so it can be enforced from a managed settings file.
  • When startup is refused, the remaining session startup steps are skipped.
Evidence

sandbox.failIfUnavailable is set — refusing to start without a working sandbox.

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

Read from
Names in the bundlesandbox.failIfUnavailable

See this entry in the whole of v2.1.248 →

Feedback