Skip to content
BENIBIX Learn

sandbox.failIfUnavailable

AI⌨️ Claude CodeConfiguration

Also known as failIfUnavailable

The key that stops Claude Code if the sandbox cannot start.

Think of it like

It is like a pool that stays shut when the lifeguard is not there. No guard, no swim.

Example

Lucy's new laptop was missing bubblewrap, and Claude ran with no sandbox. Her IT turns this key on, so that cannot happen again.

Why it matters

Without it, a broken sandbox lets each command run free, and no one knows.

Definition

sandbox.failIfUnavailable is a settings key that makes Claude Code stop at start when the sandbox is on but cannot run. That can happen on a system it does not work on, or when bubblewrap is missing. Without this key, commands just run with no fence. The default is false. Teams that must have the sandbox turn it on.

Example code

json
{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}
Refuse to start without a working sandbox.

Common mistake

Thinking the first key is enough. Only this key turns a missing sandbox into an error.

Key takeaways

  1. 1
    Stops at startup. If no sandbox.
  2. 2
    Off by default. Runs unsandboxed.
  3. 3
    For required sandbox. Companies.