blockWritesOutsideWorkingDirectories
Claude Code 的安全设置项,在工具执行层拦截指向工作目录之外的文件写操作,在所有权限模式下均生效
时间轴 (近 90 天)
blockWritesOutsideWorkingDirectories 的触发条件是目标路径落在工作目录之外,此时工具调用会被拒绝,而不是先写入再报错。
Claude Code 在 2.1.314 版本中引入了 blockWritesOutsideWorkingDirectories 设置。
blockWritesOutsideWorkingDirectories 是在工具层直接拒绝越界路径,而不是依靠提示词约束模型。
在 monorepo 场景下,如果只在子包目录启动会话,同仓库其他子包的路径也会被视为工作目录之外。
权限模式决定“要不要问用户”,而不决定“这个路径能不能碰”;blockWritesOutsideWorkingDirectories 引入的是路径维度的约束,与权限模式形成正交关系。
NotebookEdit 有时会触发内核执行或输出写入,这些副作用不在 blockWritesOutsideWorkingDirectories 的拦截范围内。
v2.1.314 新增配置 permissions.blockWritesOutsideWorkingDirectories,启用后 Write、Edit、NotebookEdit 三种文件写入工具在任何权限模式下都会拒绝工作目录之外的路径。
全部知识事实 (7)
blockWritesOutsideWorkingDirectories 的触发条件是目标路径落在工作目录之外,此时工具调用会被拒绝,而不是先写入再报错。
50%待验证NotebookEdit 有时会触发内核执行或输出写入,这些副作用不在 blockWritesOutsideWorkingDirectories 的拦截范围内。
50%待验证在 monorepo 场景下,如果只在子包目录启动会话,同仓库其他子包的路径也会被视为工作目录之外。
50%待验证blockWritesOutsideWorkingDirectories 是在工具层直接拒绝越界路径,而不是依靠提示词约束模型。
50%待验证权限模式决定“要不要问用户”,而不决定“这个路径能不能碰”;blockWritesOutsideWorkingDirectories 引入的是路径维度的约束,与权限模式形成正交关系。
50%待验证v2.1.314 新增配置 permissions.blockWritesOutsideWorkingDirectories,启用后 Write、Edit、NotebookEdit 三种文件写入工具在任何权限模式下都会拒绝工作目录之外的路径。
50%待验证Claude Code 在 2.1.314 版本中引入了 blockWritesOutsideWorkingDirectories 设置。
50%