沙箱默认不再写敏感家目录:要用再开 sandbox.filesystem.allowWrite
昨天刚说到 2.1.325 把「沙箱内 Bash 默认免确认」改回去了。2.1.326 继续往回收:在 macOS、Linux 和 WSL 上,沙箱里的命令默认不能再写入部分敏感的家目录。升级之后,如果以前能在沙箱里改到家目录里的某些文件、现在突然失败或被拦住,多半就是这条。
改了什么
- 默认更紧:沙箱命令可写的范围缩小了,一些敏感家目录不再默认开放写入。官方没有把目录名单写死在 changelog 里,以实际拦截为准。
- 要放行就显式说:在用户设置或托管设置里配置
sandbox.filesystem.allowWrite,把确实需要写入的路径加进去。不要为了图省事把整个家目录放开。 - 沙箱状态会在会话里保持一段时间:某些情况下,Bash 沙箱的状态会一直沿用,直到你执行
/sandbox或/cd;期间 Bash 可能会先问你一声。如果你刚改了写入规则,却感觉没生效,先跑这两个命令之一,或开一个新会话。 - 会话 mods 目录的编辑会更频繁地询问:如果发现每次编辑都被问,检查这个目录里是否链到了不可读路径或网络路径,把这类链接去掉。
同一版本里还有几条和沙箱、敏感文件相关的收紧,可以放在一起看:
- 文件工具会拒绝写入 Claude Code 的登录相关文件,比如
.credentials.json;Bash 权限检查在命令可能碰到这些文件时,也会先问你。 - 部分针对设备文件、进程文件的写入会被拒绝。
- 权限 hook 或 SDK 宿主在批准时改写了命令,只要原命令是按沙箱检查的,改写后的命令仍留在沙箱里;批准方可以加上
dangerouslyDisableSandbox: true才允许出箱。 - 开着沙箱时,
/rewind在 macOS、Linux 和 WSL 上可能会跳过部分文件,并告诉你哪些被跳过了。
该怎么应对
- 先观察再放行。升级后让沙箱按新默认跑几天,看哪些写入真正失败。只把需要的路径写进
sandbox.filesystem.allowWrite,写在用户设置或组织托管设置里都可以。 - 改完规则要让沙箱重新加载。如果当前会话还沿用旧的沙箱状态,执行
/sandbox或/cd,必要时直接新开一个会话。 - 团队管理员先检查托管设置。如果内部工具、脚手架或钩子依赖往家目录写配置、缓存或凭证,升级后会大面积失败,需要提前在托管设置里放行必要路径,并告知大家这个默认值变了。
- 不要用这条去替代权限规则。沙箱限制的是「命令最多能碰到哪里」,权限规则决定「该不该跑」。敏感文件该用 deny 的,还是得写 deny。
一句话:沙箱变得更保守了,家目录里那些不该随便被改的位置,现在要你明确点头才会放开。