Claude Code 权限规则的隐性失效
文章梳理五类看似有效、实际可能不触发的 Claude Code 权限规则,并提供替代写法与验证方法。内容还涉及多层设置文件以及 deny、ask、allow 的匹配顺序。
AI 深度解读
给 Claude Code 写了禁止读取敏感文件的规则,JSON 合法,启动也没报错,就能放心让它通宵跑任务?作者提醒:有些权限规则虽然能被解析,却根本不会参与实际匹配。配置看着像一道门,执行时可能压根没经过它。
这篇文章的价值,是把几类容易写错的规则和验证办法放到了一起。对准备让 Agent 自动改代码、运行命令的前端和全栈团队,关键结论很直接:先确认规则真的触发,再讨论权限放得是否合适。不过,文中的版本行为与安全边界,也需要分开看。
为什么写了 deny,文件还是没有保护好
按原文描述,Claude Code 会读取用户设置、项目的 .claude/settings.json、项目本地的 .claude/settings.local.json,以及组织托管设置。权限按 deny、ask、allow 的顺序评估,首先匹配的结果决定处理方式;即使处于 bypassPermissions,deny 仍然优先,其他位置的 allow 也不能覆盖它。
问题出在「匹配」之前:你写的规则,可能不属于实际会检查的形式。
作者称,截至 Claude Code 2.1.210,文件路径权限只匹配 Edit(path) 和 Read(path)。带路径的 Write(path)、NotebookEdit(path)、Glob(path) 虽然能被接受,却不会参与对应检查。因此,Write(docs/**) 不能阻止写入 docs,Glob(secrets/**) 也不能阻止 Grep 或 Glob 搜索 secrets。
替代方式是:用 Edit(...) 覆盖内置文件编辑工具,用 Read(...) 表达读取限制。没有路径的裸 Write 禁止规则不受这个问题影响,它会在所有位置禁用该工具。
禁止读取敏感目录,还需要配套禁止编辑,才能同时覆盖内置文件工具的读写操作。
这里有个容易忽略的区别:原文说某些无效规则在较新版本会产生启动警告。所以「静默失效」不一定指完全没有提示,也可能是提示出现在启动输出里,使用者没有看见。
Bash 和 MCP 规则,错在看起来太像正确答案
第二类陷阱是把工具参数名直接塞进规则。Bash(command:rm *) 看起来能拦住 rm -rf .,作者却指出,command 已经由 Bash 自己的匹配逻辑处理,这种写法会被忽略并产生警告。应写成 Bash(rm *)。
类似情况还包括 Read/Edit/Write 的 file_path、Grep/Glob 的 path、NotebookEdit 的 notebook_path,以及 WebFetch 的 url。这些字段已经经过工具自己的规范化处理,不能再机械套用 Tool(param:value)。
但参数匹配本身并非不可用。原文给出的有效例子是 Agent(model:opus) 和 Bash(run_in_background:true)。区别在于:它们匹配的是没有被上述专用逻辑接管的顶层输入。
工具名通配符也有边界。放进 allow 列表的 "*"、"B*"、mcp__* 会被跳过,并产生警告。MCP 的工具名通配符必须跟在明确的服务器前缀之后,而且服务器部分不能带通配符。例如 mcp__github__get_* 可以,mcp__* 不可以。不过,后者用于 deny 时可以生效。
Bash 的另一个坑是中间通配符。Bash(git * main) 中的 * 也能覆盖子命令前的选项,包括 git -c。作者称,从 2.1.246 起,这种形状会触发启动警告,不应拿来做自动放行。建议收窄成具体命令,并把通配符放到末尾,例如 Bash(git push *)。
此外,watch、setsid、ionice、flock,以及带 -exec 或 -delete 的 find,按原文描述始终会要求确认,给它们写 allow 也无法自动批准。
版本差异同样影响拦截结果:带引号单词的命令曾漏过 Bash 的 deny 和 ask,修复于 2.1.319;带 declare 或 export 前缀的命令名也曾漏过,修复于 2.1.290。测试时必须使用 Agent 实际生成的完整命令。
怎样确认规则真的参与了执行
作者给了一份 TypeScript 仓库的保守起点:放行部分构建、测试和检查命令,推送要求确认,同时限制敏感目录和两种下载工具。
{
"permissions": {
"defaultMode": "default",
"allow": [
"Bash(npm run build)",
"Bash(npm run test:*)",
"Bash(npm run lint:*)",
"Bash(npx tsc:*)",
"Bash(git commit *)",
"Bash(git status)",
"Bash(git diff:*)"
],
"ask": [
"Bash(git push *)"
],
"deny": [
"Read(secrets/**)",
"Edit(secrets/**)",
"Bash(curl *)",
"Bash(wget *)"
]
}
}
重点看 deny 中配对的 Read(secrets/**)、Edit(secrets/**),以及额外限制的 curl、wget。作者想补上的缺口是:文件工具的读取规则,并不能自动约束脚本通过其他执行路径访问、传出数据。
团队规则放在 .claude/settings.json,个人配置放在 .claude/settings.local.json;按原文描述,两边列表会合并,deny 仍然优先。
验证不能停在 JSON 校验。作者建议先读启动警告,再运行 /permissions,检查生效规则及其来源文件;需要排查参数匹配时,用 --verbose 查看工具实际收到的参数名和值。最后,用真实命令确认拒绝或询问确实发生。
能解析、出现在配置里、实际触发,是三件不同的事。
我的判断
我赞同作者把「规则是否触发」单独拿出来审计。它比继续堆叠配置更有用,也比单看启动成功更接近真实执行结果。
但原文没有给出逐版本复现记录、工具调用日志或对照数据。这是一份带版本线索的经验性审计指南,不能当作已在所有环境验证过的规格。参考说明涉及 2.1.210 至 2.1.322,但没有解释 2.1.322 的具体变化;也不能把 2.1.210 的描述直接推广到所有后续版本。
那份示例配置也不等于完整的安全策略。拦住 curl、wget 只覆盖了两种命令,不能据此认定网络外传已经被封死。对于前端仓库,放行 npm run build 是否合适,还取决于脚本实际执行什么。规则匹配成功,不代表被放行的行为就符合团队预期。
与操作系统沙箱相比,权限规则更适合表达工具使用意图;沙箱负责更底层的限制。作者建议再配合受限凭据和人工合并权限,这个分层思路合理,但文章没有给出这些措施的具体配置或效果对照。
能拿来做什么
- 下次让 Claude Code 无人值守处理仓库前,检查带路径的
Write、NotebookEdit、Glob,按原文建议改用Edit或Read,并验证实际效果。 - 为前端或 TypeScript 项目整理自动放行命令时,先核对对应 npm scripts 的内容,再决定构建、测试、提交和推送分别应该放行还是询问。
- 检查 MCP allow 规则时,把服务器名称写明确;需要批量批准读取工具,可以从
mcp__github__get_*这类限定范围的形式开始核验。 - 把 Claude Code 版本、
/permissions中的规则来源和真实命令验证结果一起记录下来,升级后针对相关修复重新检查,避免只保留一份看似正确的配置。