Claude Code 沙箱：文件、网络与回退边界怎样核对

什么时候用

• 需要确认构建命令能写哪些目录、访问哪些域名。[1]

什么时候不用

• 希望沙箱撤回远程服务动作或把规则文件当确定性权限控制。[1]

先检查平台依赖

官方说明 macOS 使用系统 Seatbelt；Linux 与 WSL2 依赖 bubblewrap 和 socat。运行 /sandbox 查看面板与缺少的依赖，先满足依赖再继续。不要把普通 Bash 命令能运行当作沙箱已启用的证据；版本与平台差异以当前面板和官方文档为准。[1]

批准模式与隔离范围分开

Mode 中选择 auto-allow 或 regular permissions；前者减少沙箱内命令的提示，后者保留常规权限提示。Config 查看最终配置，Overrides 查看是否允许失败命令回退到无沙箱执行。首次检查时明确记录回退设置；命令失败不要为了继续任务直接放开全部回退。[1]

用可丢弃任务核对目录与域名

默认可写范围包括工作目录、用户临时目录和显式添加的目录，受保护路径仍禁止写入；默认读取范围覆盖本机大部分位置，包括凭据文件，需另查 denyRead 与 credentials 保护。网络域名另有批准与配置规则。原创检查表分别列出命令、读写目录、访问域名和是否需要回退。在自己的可丢弃目录做本地检查，再查看实际拒绝或批准原因；一次写入成功不能证明读取范围也受相同限制。[1]

停止条件与本文范围

依赖缺失、解析后配置与预期不一致或需要新增目录与域名时，先停止该命令并核对原因。本文只核验官方说明，没有安装依赖、修改设置、执行 /sandbox、批准网络或运行产品命令。费用取决于实际使用的模型与服务，本页不认证免费额度；沙箱也不负责撤销已完成的远程操作。[1]