沙箱(Sandboxing)
把命令能碰到的文件和圈起来。用图和例子讲清它是什么、怎么运作、怎么用，以及要注意什么。
它是什么
沙箱在 运行的 命令周围围上一道围栏，由本身守着这道围栏。你决定命令能写入哪些文件夹、能访问哪些。默认情况下，命令只能写入工作文件夹、夹和你添加的文件夹，网络流量会经过一个本地代理，它的允许域名列表一开始是空的。因为即使命令做了超出它名字的事，操作系统也守着围栏，所以 可以不每次都问你，直接运行沙箱里的命令。它可以在 、 和 WSL2 上使用，在你打开之前是关着的。
它怎么工作
-
在会话里运行 /sandbox
-
选自动允许或普通
-
命令在围栏里运行
-
被问到时批准新域名
怎么使用
-
/sandbox打开沙箱面板，有 Mode、Overrides 和 Config 三个标签页。
-
在
~/.claude/settings.json里把sandbox.enabled设为true— 为你所有的项目打开沙箱。 -
sandbox.network.allowedDomainsBash 命令可以访问的域名。
sandbox.filesystem.allowWrite添加它们可以写入的文件夹。 -
"allowUnsandboxedCommands": false严格沙箱模式。Claude 不能再在沙箱外面重试失败的命令。
注意
沙箱只管 shell 命令。Claude 的 Read、Edit 和 WebFetch 工具、 和钩子都在沙箱外运行，改由权限规则来管，那是另一层。它也和自动模式不是一回事，而且不是完整的墙 — 允许 github.com 这样宽泛的域名可能给开了路；如果沙箱启动不了，命令会在沙箱外运行，除非你设置了 sandbox.failIfUnavailable。
相关术语
原文和官方文档
本页用简单的话解释这个术语。以原文为准：如果两者不同，请按原文。
- 在原文中查看这个术语Claude Code Docs — Glossary Anthropic · 确认于 2026-10-19
- Anthropic — Claude Code docs: Configure the sandboxed Bash tool — What the sandbox restricts(在新窗口中打开)
- Anthropic — Claude Code docs: Configure the sandboxed Bash tool — Sandbox modes(在新窗口中打开)
- Anthropic — Claude Code docs: Configure the sandboxed Bash tool — How sandboxing relates to permissions and permission modes(在新窗口中打开)
- Anthropic — Sandboxing(在新窗口中打开)
加载中…
加载中…
请选择要取消的待付款预约。每次取消都需要确认。
你所在国家的时间: