Claude Code 权限更新或阻塞无人值守任务
文章梳理 Claude Code 2.1.325 的四项权限默认行为变化,涉及沙箱命令、定时技能、持久授权和跨仓库只读 Git 操作。依赖旧授权方式的定时任务、循环任务和 CI 作业可能等待人工确认。
AI 深度解读
Claude Code 升到 2.1.325 后,无人值守任务可能停下来等确认:沙箱里的 Bash 不再默认自动放行,定时任务调用部分 skill 前也要先询问。交互使用时点一下就能继续,CI、定时报表和后台巡检却可能一直等不到人。
作者梳理了 11 月 9 日至 13 日、从 2.1.321 到 2.1.325 的四次发布,认为比 Code Mode 和 Fable 5.2 定价更该关注的,是权限默认值的变化。这篇值得读的地方,是把几行更新日志翻成了自动化任务的排查清单。
进了沙箱,为什么还要确认命令
11 月 13 日发布的 2.1.325,把沙箱 Bash 命令改为默认走常规权限流程。过去依赖「命令在沙箱内,所以自动放行」的任务,升级后可能出现确认提示。
这里有两层判断:沙箱限制命令能接触什么,权限规则决定命令能不能执行。限制了活动范围,并不自动代表批准范围内的每一个动作。
原文给出的恢复配置如下,用来明确允许沙箱内的 Bash 自动执行:
{
"sandbox": {
"autoAllowBashIfSandboxed": true
}
}
要看清的是 autoAllowBashIfSandboxed 这一行:它恢复的是自动授权,需要先检查沙箱实际限制了哪些访问。
配置放在哪里也会影响结果。按原文转述,如果沙箱由托管设置启用,这个开关必须放进优先级最高的托管配置源,仅修改用户设置可能仍然出现提示。
无人值守运行开始需要明确的授权配置,不能继续依赖旧默认值。
对维护 CI 的团队来说,升级前只检查模型能否正常回答已经不够,还要检查任务执行途中是否新增了等待输入的节点。
定时任务会在哪些地方停住
第二处变化针对 scheduled tasks 和 /loop:当它们准备调用声明了 allowed-tools 或 hooks 的 skill 时,会先请求确认。
可以把它理解为增加了一道入口检查。进入 skill 后可能涉及工具调用或钩子行为,因此系统先确认是否允许启动这套流程。
原文用下面的配置,为已经审查过的单个 skill 保留无人值守执行能力:
{
"permissions": {
"allow": [
"Skill(deploy-checks)"
]
}
}
要注意 Skill(deploy-checks):授权指向一个具名 skill。任务调用多个 skill,就需要逐个配置,也需要逐个检查内容。不能为了消除提示,直接把审查过程省掉。
第三处变化发生在 Desktop、IDE 和 SDK 宿主中:「Always allow」只有在保存规则确实能让同一命令再次获准时,才会提供相应规则选项。
这里不能推导成「以前保存的规则全部失效」。原文表达的是,依赖这类交互授权的定时任务,现在可能等待确认,却没有展开每种宿主和规则的具体失效条件。
这类问题麻烦在于,进程未必报错。任务可能还活着,报告却没更新。作者建议盘点交互会话里保存的授权,把自动化真正依赖的规则迁入版本管理下的设置文件,让规则可以检查和追溯。
跨仓库读取也要信任,配置目录还多了一层保护
第四处变化涉及只读 git 命令:目标仓库既不是项目自身仓库,也没有被信任时,现在会先询问。
这对在多个 checkout 之间切换的 agent 工作流影响更直接。比如任务先读取主项目,再进入另一个仓库查看提交记录,即使没有写文件,也可能遇到新的确认。
原文特别区分了两个入口:应使用 --add-dir 声明相关目录,而不是依赖 additionalDirectories 设置。按作者解释,前者记录本次会话的信任决定,后者不能替代这次授权。已有目录访问配置,不代表这次只读 git 检查就会放行。
同一版本还加强了配置保护:沙箱进程不能向新增目录里的 .claude 设置、skills、agents、commands 和 hooks 写入,保护范围从启动目录延伸到了添加的目录。对会接触其他仓库、MCP servers 或 plugins 的任务,这能减少执行过程中配置被改写的风险。
2.1.325 同时修复了 zstd 压缩响应解码相关的安全问题。作者把这些调整放进「减少静默授权」的方向里理解,并提到他们曾记录到 1,379 个秘密信息经随手保存的免确认规则进入公开 GitHub 文件,还关联了 MCP git server 的 v2.4.0 修复。不过,原文没有给出这项统计的采样方法,也没有证明这些问题与本次四项调整存在直接因果关系。
我的判断
我赞同把无人值守权限写成可审查配置。交互窗口里临时点下的「Always allow」,过几个月很难判断还该不该保留;具名 skill 授权和受管理的设置文件,更容易看出团队究竟批准了什么。
但这篇的证据边界要划清:作者做的是更新日志梳理和发布追踪信息交叉核对,没有展示升级前后的复现实验、任务停滞比例或宿主兼容性矩阵。因此,「哪些工作流容易受影响」有依据,「一般团队会受多大影响」仍是经验判断。
另一个可选做法,是检查 2.1.319 引入的 permissions.denyInsteadOfPrompting。原文描述的行为是:本来会弹出确认的调用直接被拒绝,然后继续当前轮次。它可以避免无限等待,却可能让任务带着缺失步骤继续输出结果。
不再等待确认,不等于任务已经完整执行。
CI 若采用这种方式,必须同时检查产物和关键步骤;否则一个顺利结束的进程,也可能只完成了半件事。
能拿来做什么
- 升级前搜索实际生效的设置文件,核对
sandbox和permissions配置,尤其检查托管设置的优先级;把恢复自动放行的理由写进变更说明。 - 给定时任务和
/loop列出 skill 清单,检查各自 frontmatter 中的allowed-tools、hooks,只为读过并确认用途的 skill 添加Skill(name)授权。 - 对使用
claude -p的 CI 和跨 checkout 任务,检查是否需要--add-dir,并为等待输入设置超时;若启用拒绝代替提示,还要验证关键操作是否完成。 - 把首次升级运行安排在有人能观察的时段,同时检查任务结果是否更新。原文末尾提到的 2.1.323 插件版本范围安装限制属于另一项检查,本篇没有提供展开说明。