Claude Code release notes: 2.1.325 changes sandbox approvals

Claude Code release notes: 2.1.325 changes sandbox approvals

Claude Code 2.1.325 now sends sandboxed Bash commands through the regular permission flow by default. If you relied on automatic approval inside the sandbox, you may see more prompts after updating. The sandbox.autoAllowBashIfSandboxed setting controls whether those commands are approved automatically.

Claude Code release notes: a new sandbox default

A sandbox is an operating-system boundary that limits which files and network addresses a command can reach. Both modes enforce the same file system and network restrictions. The change concerns command approval; the regular permission flow decides whether a prompt is needed.

Version 2.1.325 was published on November 13 and was the latest version on GitHub and npm when checked on November 16.

Source: Anthropic's release notes for Claude Code 2.1.325.

Choose a mode in /sandbox

Human step: Type /sandbox in an existing Claude Code session. Under Mode, choose regular permissions for normal permission checks or auto-allow for automatic approval of sandboxed commands. Under Config, you can inspect the resolved settings.

To retain automatic approval through a settings file, merge the following into your existing configuration, for example in ~/.claude/settings.json:

\{
  "sandbox": \{
    "autoAllowBashIfSandboxed": true
  \}
\}

This choice requires the sandbox to be enabled. If your organization's managed settings enable the sandbox, an administrator needs to set the value to true in the highest-ranking managed source to retain automatic approval.

Sources: Anthropic's guide to sandbox modes, settings files, and the 2.1.325 change.

Limits that still apply

Automatic approval does not replace every check. Matching deny rules still apply, and content-specific ask rules, such as Bash(git push *), can require approval. The sandbox covers shell commands; Claude's file tools, external MCP servers, and hooks run outside it. MCP connects the agent to external tools, while hooks run actions at defined events.

The sandbox is available on macOS, Linux, and WSL2. On Windows, this feature requires WSL2.

Source: Anthropic's documentation on sandbox scope and permissions.

The Forge newsletter

Get new articles in your inbox

Pick the topics you care about. No noise, at most one email a week.

Get new articles in your inbox

We follow GDPR. Unsubscribe anytime.