Skip to content

钩子从哪来一眼可见:2.1.329 信任对话框、托管钩子告警与 /mcp、/status 新诊断行 ​

钩子(hooks)很强大:它能在工具调用前后自动执行命令,替你拦截、改写或记录操作。但也正因为它会"自动执行",打开一个陌生仓库时,你最该知道的问题之一就是:这里有没有钩子?它们写在哪个文件里?

2.1.329 在这件事上做了几处透明度改进。

1. 信任对话框会说明钩子声明在哪里 ​

第一次在某个文件夹里启动 Claude Code 时,会弹出信任对话框。2.1.329 起,这个对话框会附带一条警告,指出该文件夹的钩子是在哪里声明的。

这意味着你在点"信任"之前,就能知道钩子来自哪个配置文件,可以先打开看看它到底会跑什么命令。对于从网上克隆的仓库、同事临时发来的项目,这一步尤其值得花几秒钟。

2. 托管钩子加载失败,不再悄无声息 ​

企业管理员可以通过托管设置(managed settings)统一下发钩子,比如审计日志或合规检查。问题是,在 Claude Desktop 这类非交互宿主里,如果这些钩子没能加载,用户往往察觉不到,还以为保护措施在生效。

2.1.329 起,托管设置中的钩子加载失败时,会在对话里显示警告,适用于 Claude Desktop 及其他非交互宿主。看到这条警告,就该联系管理员检查配置了。

3. /mcp:远程服务器拒绝连接时能看到原因 ​

远程 HTTP MCP 服务器拒绝连接时,过去你通常只知道"连不上"。现在在 /mcp 里打开该服务器的页面,会多出一行 「Server message」,显示服务器返回的 JSON-RPC 错误信息。认证失败、权限不足还是服务端报错,看这一行就能先判断个大概。

4. /status:哪些托管插件市场不会自动更新 ​

/status 新增 「Marketplace auto-update」 一行,会列出不会自动更新的托管插件市场,并说明原因。如果你发现某个团队插件迟迟没有新版本,先来这里看看是不是市场本身被排除在自动更新之外。

实用建议 ​

  • 打开新仓库时,认真看一眼信任对话框里关于钩子的那条提示,不确定就先去对应文件里检查;
  • 团队如果依赖托管钩子做合规,提醒成员留意对话里的加载失败警告;
  • 排查 MCP 或插件问题时,先看 /mcp 的 Server message 和 /status 的 Marketplace auto-update,再决定下一步。

小结 ​

这几处改动的共同点是:把原来"静默发生"的事情摆到台面上。钩子从哪来、托管配置有没有生效、服务器为什么拒绝、插件为什么不更新,现在都有地方可查。

Claude-cn.org,专注于 Claude Code 中文教程