[控场AI]
概念

blockWritesOutsideWorkingDirectories

Claude Code 的安全设置项,在工具执行层拦截指向工作目录之外的文件写操作,在所有权限模式下均生效

时间轴 (近 90 天)

11月3日

blockWritesOutsideWorkingDirectories 的触发条件是目标路径落在工作目录之外,此时工具调用会被拒绝,而不是先写入再报错。

待验证50%
11月3日

Claude Code 在 2.1.314 版本中引入了 blockWritesOutsideWorkingDirectories 设置。

待验证50%
11月3日

blockWritesOutsideWorkingDirectories 是在工具层直接拒绝越界路径,而不是依靠提示词约束模型。

待验证50%
11月3日

在 monorepo 场景下,如果只在子包目录启动会话,同仓库其他子包的路径也会被视为工作目录之外。

待验证50%
11月3日

权限模式决定“要不要问用户”,而不决定“这个路径能不能碰”;blockWritesOutsideWorkingDirectories 引入的是路径维度的约束,与权限模式形成正交关系。

待验证50%
11月3日

NotebookEdit 有时会触发内核执行或输出写入,这些副作用不在 blockWritesOutsideWorkingDirectories 的拦截范围内。

待验证50%
10月30日

v2.1.314 新增配置 permissions.blockWritesOutsideWorkingDirectories,启用后 Write、Edit、NotebookEdit 三种文件写入工具在任何权限模式下都会拒绝工作目录之外的路径。

待验证50%

全部知识事实 (7)

来源文章