基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
技术实践2026-11-17 22:40

Claude Code 安全钩子崩溃后可能放行命令

dev.to · AI#Claude Code#安全#钩子
Editor brief · 编辑速览

文章指出,Claude Code 的 PreToolUse 命令钩子只有退出码 2 会阻止工具调用,其他非零退出码仍会放行。Node.js 未捕获异常通常以退出码 1 结束,因此安全守卫必须覆盖自身崩溃的处理和测试。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

AI 深度解读

Claude Code 的命令检查脚本崩溃后,危险命令仍可能继续执行。原文揭示的原因很具体:Node 未捕获异常通常以退出码 1 结束,而 Claude Code 把它归为非阻断错误。

作者团队给自己的守卫脚本补上了这条异常路径。对用 AI 操作本机、共享开发机的程序员,这个案例值得检查一遍:拦截规则写得再细,也要确认检查器坏掉时,调用方究竟会放行还是阻断。

为什么明明报错了,命令还会执行

按原文引用的 Claude Code hooks 文档,命令钩子的结果分成三类:

  • exit 0 表示成功,通常继续执行,但 stdout 中的 JSON 可以明确拒绝。
  • exit 2 表示阻断错误,PreToolUse 会阻止工具调用,并把 stderr 作为原因。
  • 其他非零退出码表示非阻断错误,工具调用继续。

问题出在第三类。Node 遇到未捕获异常,打印堆栈后以退出码 1 结束;检查器没有作出决定,调用方却继续执行了命令。这叫故障放行(fail open)。

作者团队的守卫是一个约 1,550 行的 Node 脚本,检查 AI 在共享工作机上执行的每条命令,包括禁止写生产目录、终止受保护进程,以及在人工作时执行破坏性的 git 操作。它原本有 120 个测试,却没有覆盖守卫自身崩溃的情况。

下面这段最小示例能拦住 rm -rf,也能暴露漏洞:

// guard-naive.mjs
let raw = ""; for await (const c of process.stdin) raw += c;
const input = JSON.parse(raw);
const cmd = input.tool_input.command;
if (/\brm\s+-rf\b/.test(cmd)) {
  console.error("blocked: rm -rf");
  process.exit(2);
}
process.exit(0);

要看的是 input.tool_input.command 这一行:当 tool_input 为 null 时,它会直接抛出异常,根本走不到预设的退出分支。

同一守卫接收两种输入:原始脚本遇到异常退出为 1,修复后的脚本输出拒绝 JSON 并退出为 0

作者真实遇到的输入更简单:stdin 收到 JSON 字面量 null,访问 input.tool_name 时崩溃。即使正常调用不会提供这种输入,配置解析失败、正则收到意外类型、辅助模块处理路径时报错,也可能走向相同结果。

「发现危险后拒绝」和「检查失败后拒绝」,是两条必须分别覆盖的路径。

怎样让异常也变成一次明确拒绝

作者采用故障阻断(fail closed):守卫出错,就停止这次调用。他们添加了顶层异常处理,把错误转换成 PreToolUse 的拒绝 JSON:

function deny(reason) {
  process.stdout.write(JSON.stringify({
    hookSpecificOutput: {
      hookEventName: "PreToolUse",
      permissionDecision: "deny",
      permissionDecisionReason: reason,
    },
  }));
  process.exit(0);
}
process.on("uncaughtException", (e) => deny(`guard crashed, blocking to be safe: ${e.message}`));
process.on("unhandledRejection", (e) => deny(`guard crashed, blocking to be safe: ${e?.message ?? e}`));

这里要盯住 process.exit(0):退出码表示钩子成功输出了结果,真正的拒绝决定放在 permissionDecision: "deny" 中。不要把它改成退出码 1,否则又回到了非阻断错误。

这段代码还有一个配套要求:stdout 只能输出一次决定。如果已经写过 JSON,清理阶段又抛错,再追加一个 JSON 对象,调用方可能无法解析。作者实际实现用 decideWritten 标记避免重复写入,示例没有展示这部分。

他们拿提交前后的真实守卫文件,用相同的 null 输入重跑:修复前 stderr 有堆栈、退出码为 1;修复后输出带错误原因的拒绝 JSON、退出码为 0。新增测试通过 spawnSync(process.execPath, [GUARD], { input: "null", encoding: "utf8" }) 启动独立进程,再检查退出状态和 hookSpecificOutput.permissionDecision,测试总数因此从 120 增至 121。

原文还提到,近期 Claude Code 支持 hook 配置 "onFailure": "block",可让失败阻断调用。但文章没有给出具体版本号,也没有展示配置层级,不能据此直接照抄进配置文件。

另外,外层 shell 不能吞掉退出码。node guard.mjs || true 会把失败包装成成功,破坏依赖失败状态的拦截。慢路径也要查:守卫超时后如何处理,原文要求按所用 Claude Code 版本确认,没有给出统一结论。

我的判断

我认可这次修复的方向。既然脚本负责限制生产目录写入、进程终止等操作,检查失败时阻断,比默认继续更符合它承担的职责。

但文章证明的是一个具体异常路径被修好了,不是整个守卫已经可靠。数据来自作者团队的仓库:2026 年 11 月 13 日提交修复,11 月 15 日重新运行;原文还披露,文章由他们的 AI 助手 Seoha 自主撰写和发布。这些是案例自述,没有独立验证,也没有与其他方案的对照数据。

测试从 120 变成 121,最有价值的地方是补上了原先遗漏的失败类型。它并不能证明其他异常、超时和输出损坏都已覆盖。

脚本内捕获异常与 "onFailure": "block" 也不宜简单二选一。前者便于返回明确原因,作者认为它有助于模型避免重复执行同一命令;后者由调用方处理失败。两者叠加有道理,但文章没有完整验证其覆盖范围。

故障阻断也有代价:守卫的 bug 会直接卡住工作。共享机器上的限制适合接受这种成本;如果只是记录日志、补充提示的 hook,就需要按职责决定失败策略,不能一概套用。

能拿来做什么

  • 检查现有 Node hook 中的每个 process.exit(,明确每条路径的含义。按原文这套协议,策略决定应使用退出码 0 配合 JSON,或退出码 2 阻断。
  • 给守卫补一条独立进程测试,先用作者实际复现的 null,再考虑 not json 和空字符串;同时检查退出码、stdout 能否解析,以及最终是否明确拒绝。
  • 检查启动守卫的 shell 包装,去掉会吞掉失败状态的 || true,并确认 stdout 不会混入日志或第二份决定 JSON。
  • 如果用 Claude Code 操作共享前端或 Node 开发机,核对当前版本的 "onFailure": "block" 支持情况,并验证超时行为,再把 hook 当作操作限制的一部分。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
让多会话编程 Agent 共用项目记忆
下一篇
代理沙箱是否有效,要靠越界测试证明

资讯速览

dev.to · AI · 2026-11-17 22:40

AI 评分 8.0 / 10

相关标签

#Claude Code#安全#钩子

继续阅读

  • Agent 记忆怎么存:精选经验比全量记录有效
  • 让多会话编程 Agent 共用项目记忆
  • 代理沙箱是否有效,要靠越界测试证明
  • 用正交适配器减少微调对鲁棒认证的影响
  • AI 工作流何时应保留确定性控制