两个钩子同时盯着同一条 Bash 命令,一个说要拦,一个说要问。结果命令跑了,屏幕上什么提示都没有。这不是段子,是 Claude Code 2.1.319 上能复现的一次合并事故。
![]()
把时间线摆出来:在交互式会话里,两个 PreToolUse 钩子回答同一次 Bash 调用,返回 defer 的那个先跑完,返回 ask 的那个后到。2.1.319 上,命令直接执行,权限提示没出现。换到 2.1.322,同样的组合弹出了提示,命令一步没动。
关键在于这两个答案要被合并。钩子是并发跑的,谁先结束并不固定,合并规则写在文档里,但合并过程里谁的回答能活下来,规则本身说不清楚。
合并规则长什么样
钩子参考文档给了一行优先级:多个 PreToolUse 钩子返回不同决定时,顺序是 deny > defer > ask > allow。以退出码 2 结束的钩子按 deny 处理,它的 stderr 就是理由。返回 ask 时,权限提示会带上钩子来源的标签,来自任何设置文件或 agent frontmatter 的钩子都标 [settings]。
defer 是这里面最特殊的一个。它是给那些把 claude -p 当子进程跑的程序准备的:在工具调用处暂停 Claude,通过自己的界面收一个答案,再恢复。文档说 Claude Code 只在非交互模式下认它,而且“仅当 Claude 在回合中只发起一次工具调用”。交互式会话里,它记一条警告然后忽略这个钩子结果。一次出现多个工具调用时,defer 同样被忽略并记警告,工具走正常权限流程。
2.1.321 的更新日志修了两个 bug,都落在这条路径上:一个是另一个钩子的 defer“先完成且无法被采纳”时,PreToolUse 的 ask 丢了;另一个是嵌入 Claude Code 的应用,在两个钩子都 ask 时拿到了自己钩子的理由,而不是另一个钩子的。两个 bug 都跟时序有关,也都跟合并后谁的回答存活有关。
实验怎么搭的
研究者建了一个一次性项目,用 --settings 传入设置文件,再加 --setting-sources project,把自己用户级的钩子和插件挡在门外。同一个 Bash 匹配组里放两个命令钩子,跑的是同一个脚本,参数是一个决定加一个延迟:第一个立刻回答,第二个睡 1.5 秒再回答,这样每次都知道谁先结束。每个钩子把开始和结束时间写进日志。
一条权限规则 Bash(echo:*) 放行了探针命令。所有钩子都不插手时,echo hooklab-probe 无提示直接跑。这样每种答案都有可见后果:allow 让 echo 跑,deny 拒绝,defer 停住,ask 弹出权限请求。
打印模式需要另一端接住请求。他们写了个 Python 小宿主,用 --input-format stream-json、--output-format stream-json 和 --permission-prompt-tool stdio 启动 claude -p,应答 initialize 请求,发一条用户消息,对每个 can_use_tool 请求都回拒绝,并记录收到的每个权限请求,包括 decision_reason 字段。有两组配对里,宿主还在 initialize 请求中注册了自己的 PreToolUse 回调,用 ask 加自己的理由回答。
交互模式跑在 expect 下,另有两个只做探针的钩子:一个 PermissionRequest 钩子记录权限对话框即将出现,一个 PostToolUse 钩子记录命令真的执行了。对话框出现时,脚本按 Esc。每次运行都让一个 Haiku 模型在默认权限模式下跑一次探针。同一套方案在 2.1.319 和 2.1.322 上各跑 18 次打印模式会话、3 次交互式会话。
打印模式守规矩,交互模式出了岔子
打印模式里,两个设置钩子的全部 12 种单调用配对,在两个版本上都按文档顺序合并,不管谁先结束。有两个细节值得记住:两个钩子都 ask 时,宿主只收到一个权限请求,理由是那个先结束的钩子的,另一个钩子的理由在宿主能读到的输出里哪儿都没出现;调用被拒时,模型看到的工具错误以 PreToolUse:Bash hook error: 开头,后面跟着拒绝钩子的理由,模型知道自己为什么被拦,而不只是被拦了。
差异出在交互模式。defer 在这里无法被采纳,Claude Code 记警告后丢弃它。2.1.319 上,defer 钩子先结束的那次会话没有对话框,PostToolUse 探针触发,echo 跑了;后到的 ask 跟着 defer 一起消失,调用落进正常权限流程,被那条 allow 规则放行。2.1.322 上,同样的配对弹出了权限对话框。
顺序在旧版本上很要命:ask 钩子先结束时,两个版本都弹对话框;defer 挨着一个沉默的钩子时,两个版本都让 echo 跑了,跟文档描述一致。2.1.322 的对话框写明了钩子事件,显示了回答 ask 的那个钩子的理由,带着 [settings] 标签,一个字没提 defer。
宿主那几行对应更新日志的第二条。2.1.319 的打印模式里,宿主自己的钩子先 ask 时,权限请求把宿主自己的理由还给了它。2.1.322 上,不管谁先结束,宿主收到的都是设置钩子的理由。对一个注册自己钩子的程序来说,这是“被告知一件它已经知道的事”和“被告知项目里另一个钩子为什么想要确认”的区别。
跟文档对不上的地方
他们还让模型在一条消息里发两次 Bash 调用,也就是文档说 defer 会被忽略的场景。两个版本各 4 次运行,模型确实把两次调用放进了同一条消息,每一次都以 stop_reason: "tool_deferred" 收尾。结果的 deferred_tool_use 字段只点名了第二次调用,两个 echo 都没打印任何东西。钩子日志显示,第二次调用的钩子在第一次调用那个慢钩子还没结束时就开始了,两次调用是同时被检查的。这些会话没有被恢复,所以第一次调用之后会怎样,说不了。报告的是用一个工具、一个模型看到的现象,不是断言文档错了。
文档也没说两个钩子都 ask 时哪个理由胜出。实测是先结束的那个。钩子在不同调用间耗时不一样时,同一条命令两次运行,人在对话框里读到的理由可能不一样。
能带走什么
ask 是仅次于 allow 的最弱答案。任何 deny、任何退出码 2、任何能被采纳的 defer 都压过它。钩子要真拦住调用,就该 deny 或退出码 2;一个必须活过合并的 ask 是请求,不是保证。
钩子栈里只要有一个返回 defer,比如一个在 claude -p 程序和交互式用户之间共用的钩子,就上 2.1.321 或更新版本。在那之前,一个跑得快的 defer 能抹掉一个慢一点的 ask,屏幕上不会说曾有钩子想要确认。
每条 ask 的理由都要能单独读懂,并写明它来自哪个钩子。站在提示前的人只看到一个理由,看到哪个取决于时序。测试要测组合,不只测单个钩子:一个钩子单独表现正常,说明不了合并后的答案,而 2.1.321 修的两个 bug 都住在合并里。
他们那五个钩子继续用退出码 2。每一个都是硬停,跑过的所有配对里,硬停都赢过了它的对手。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.