Skip to content
BENIBIX Learn

sandbox.excludedCommands

AI⌨️ Claude CodeConfiguration

Also known as excludedCommands

A list of commands that run outside the sandbox.

Think of it like

It is like a pass that lets one big kid out of the pen. The pen is too small for them.

Example

Jack's docker builds fail inside the sandbox. He adds docker * here, and docker runs outside while the rest stays fenced.

Why it matters

Some tools cannot work in a sandbox. This lets you keep it on for all the rest.

Definition

sandbox.excludedCommands is a settings key that names commands to run with no fence, such as tools that break in the sandbox. Each entry is written like a Bash rule: an exact command, or a start such as docker *. An entry must match each command in a call. Commands that start with sudo, eval or xargs stay fenced.

Example code

json
{
  "sandbox": {
    "enabled": true,
    "excludedCommands": ["docker *"]
  }
}
Run docker commands outside the sandbox.

Common mistake

Expecting docker * to free npm ci && docker build. Every command in the call has to match.

Key takeaways

  1. 1
    Runs outside. Named commands.
  2. 2
    Like Bash rules. Prefix with *.
  3. 3
    Whole call must match. Every part.

Compare