{"name":"sandbox.filesystem","slug":"sandbox-filesystem","family":"setting","title":"Settings keys","noun":"settings key","description":"Control which paths [sandboxed](\/docs\/en\/sandboxing#filesystem-isolation) commands can read and write","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.308","builds":0,"mined_builds":149,"first_cited":{"version":"2.1.246","released_at":"2026-08-25 19:17:34","spans":1}},"aliases":[],"entries":[{"version":"2.1.301","anchor":"settings-validation-sandboxcredentials-warnings-now-handle","heading":"Sandbox credential settings errors are now checked separately","line":"Problems in sandbox and sandbox.credentials settings, including warnings, are now judged by their own check for whether they stop settings from loading","released_at":"2026-10-15 14:34:23","reason":"found in this entry's text"},{"version":"2.1.283","anchor":"sandbox-network-and-filesystem-grants-are-withheld-when-a-re","heading":"One invalid sandbox deny entry now withholds the matching allow rules","line":"If one entry in deniedDomains, denyWrite or denyRead is invalid, Claude Code now withholds the matching allow list instead of applying it","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.246","anchor":"disabled-settings-files-no-longer-feed-rules-into-the-sandbo","heading":"Disabled settings files no longer feed rules into the sandbox","line":"Rules from settings files you disabled no longer sneak into the sandbox policy.","released_at":"2026-08-25 19:17:34","reason":"named in this entry, found in this entry's text"},{"version":"1.0.124","anchor":"sandboxed-bash-mode-sb-sandboxed-bash","heading":"Sandboxed Bash Mode ( -sb\/--sandboxed-bash )","line":null,"released_at":"2025-09-25 01:37:53","reason":"found in this entry's text"}],"entries_total":4,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"managed-settings","title":"Deploy managed settings","documented":false},{"source":"claude-code","path":"sandboxing","title":"Configure the sandboxed Bash tool","documented":false},{"source":"claude-code","path":"self-hosted-environments-deploy","title":"Deploy self-hosted environments to production","documented":false},{"source":"claude-code","path":"server-managed-settings","title":"Configure server-managed settings","documented":false},{"source":"claude-code","path":"whats-new\/2026-w30","title":"Week 30 \u00b7 July 20\u201324, 2026","documented":false},{"source":"claude-docs","path":"third-party\/claude-desktop\/code","title":"Code in Claude Desktop on 3P","documented":false},{"source":"claude-docs","path":"third-party\/claude-desktop\/configuration","title":"Configuration reference","documented":false}],"docs_total":9,"gates":[],"related":[{"name":"sandbox","slug":"sandbox","description":"[Isolate Bash commands](\/docs\/en\/sandboxing) from your filesystem and network on macOS, Linux, and WSL2"},{"name":"sandbox.allowNestedUserNamespaces","slug":"sandbox-allownestedusernamespaces","description":"Let [sandboxed](\/docs\/en\/sandboxing#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux) commands create user namespaces on Linux and WSL2"},{"name":"sandbox.bwrapPath","slug":"sandbox-bwrappath","description":"Point the [sandbox](\/docs\/en\/sandboxing) at a bubblewrap binary outside `PATH`"},{"name":"sandbox.credentials","slug":"sandbox-credentials","description":"Hide or mask credential files and variables inside the [sandbox](\/docs\/en\/sandboxing#protect-credentials)"},{"name":"sandbox.credentials.awsPairs","slug":"sandbox-credentials-awspairs","description":"Link custom-named AWS key variables into one credential for [re-signing](\/docs\/en\/sandboxing#re-sign-aws-requests)"},{"name":"sandbox.credentials.files","slug":"sandbox-credentials-files","description":"Block or mask reads of a credential file inside the [sandbox](\/docs\/en\/sandboxing#mask-credential-files)"},{"name":"sandbox.enabled","slug":"sandbox-enabled","description":"Turn on [Bash sandboxing](\/docs\/en\/sandboxing#get-started) on macOS, Linux, and WSL2"},{"name":"sandbox.excludedCommands","slug":"sandbox-excludedcommands","description":"Name commands Claude Code can run outside the [sandbox](\/docs\/en\/sandboxing)"},{"name":"sandbox.failIfUnavailable","slug":"sandbox-failifunavailable","description":"Refuse to start when the [sandbox](\/docs\/en\/sandboxing) can't, instead of running unsandboxed"},{"name":"sandbox.filesystem.allowRead","slug":"sandbox-filesystem-allowread","description":"Re-open reading inside a region [`denyRead`](#sandbox-filesystem-denyread) blocks"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/sandbox-filesystem","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}