Skip to content

Browse catalog

Search catalog

[READY] Type a title, tag, or description.

NOTES // concept

Sandbox ladder

LAST_MODIFIED
2026.07.29
CATEGORY
concept

The sandbox ladder is the set of isolation tiers around Claude Code. /sandbox (Seatbelt on macOS, bubblewrap on Linux/WSL2) wraps Bash and its children at the OS level and cut permission prompts ~84% in Anthropic’s measurements - but Read, Edit, MCP, and hooks stay on the host until you climb higher.

ApproachWhat is isolatedWhen
Sandboxed Bash (/sandbox)Bash + children onlyEveryday local work
@anthropic-ai/sandbox-runtimeWhole Claude processUnattended runs; untrusted MCP
Dev / custom containerFull environmentTeam standard; skip-permissions with firewall
VMFull OS separationUntrusted repos; compliance
Claude Code on the webAnthropic-managed VMNo local setup

Scope gap

MechanismBash childrenRead / EditMCP / hooks
Permission rulesPattern-matchedYesYes (per tool)
/sandboxYes (OS)NoNo
Runtime / container / VMYesYes (inside boundary)Yes

Defaults under /sandbox: write to working directory + session $TMPDIR; read nearly the whole machine (including ~/.aws and ~/.ssh unless denied); no network domains pre-allowed. Close the credential hole with sandbox.credentials and matching permissions.deny for Read(~/.ssh/**) and Read(./.env*). --dangerously-skip-permissions needs a container, VM, or sandbox-runtime - Bash sandbox alone is not that boundary.

Full playbook: Claude Code security in 2026. Pair with permission rules and the read/mutate split.

claude-codesecuritysandboxingpermissions

Related_Notes