# sandbox.failIfUnavailable

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** failIfUnavailable

## Think of it like

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

## 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

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

## Example code

```json
{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}
```

Refuse to start without a working sandbox.

## Why it matters

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

## Common mistake

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

## Three principles

- **Stops at startup.** If no sandbox.
- **Off by default.** Runs unsandboxed.
- **For required sandbox.** Companies.

## Related terms

- [sandbox.enabled](https://learn.benibix.com/term/ai/sandbox-enabled-setting)
- [Managed Settings File](https://learn.benibix.com/term/ai/managed-settings-file)

---

Source: https://learn.benibix.com/term/ai/fail-if-unavailable-setting
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
