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

用 Claude Code Hooks 拦住反复踩的坑

dev.to · AI#Claude Code#钩子#自动化校验
Editor brief · 编辑速览

文章给出五种钩子示例和配置测试方法,涵盖发错账号、未经验证就宣称修好等问题。PreToolUse 可拦截工具调用,Stop 可要求模型重写回复,作者建议主动触发错误以确认钩子生效。

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

AI 深度解读

Claude Code 在 CLAUDE.md 里读过一条规则,到了长会话末尾,仍可能用错语言、漏掉验证,甚至把内容发到错误的账号。作者维护了 70 个 Hook 脚本,挑出其中五类故障,解释怎样把反复提醒变成执行时的检查。

对日常用 AI 写代码的人,最值得借鉴的是他选检查时机的方法。准备调用工具时拦动作,准备结束回复时查结论,真正发帖前核对账号。写完脚本还要故意犯一次错,确认它会拦,再用正常输入确认它会放行。

同一条规则提醒了百来次,为什么还会出错?

作者在日本经营自己的公司已有 22 年,平时用 Claude Code 处理视频、帖子和文章。为了追踪重复失误,他把每次发生了什么、原因在哪、后来靠什么拦下来记成档案。录视频时有 127 条,写文章时增长到 134 条。

作者维护的 70 个 Hook 脚本与录制视频时的 127 条故障记录

7 月,Claude Code 总在邮件草稿里用作者不想要的长横线。据他估计,他指出过约 100 次。后来查明,已有的检查只覆盖文件编辑,另一条规则写在某个博客平台的说明里,邮件走的路径两边都碰不到。另一个问题出在长会话收尾。CLAUDE.md 明明要求用日语,Claude Code 却发来英文汇报。作者的解释是,会话里的代码、日志、工具结果和英文文档持续累积,那条规则对模型的影响会减弱。

Hook 是 Claude Code 在指定时机运行的脚本。平台把 JSON 传给脚本的标准输入,其中 transcript_path 指向会话的 JSONL 记录,工具事件还会带上 tool_name 和 tool_input。脚本通过退出码或标准输出里的 JSON 表达结果。PreToolUse 可以在工具执行前拒绝调用,Stop 可以在结束回合时要求模型继续处理。PostToolUse 等到工具已经运行才触发,来不及阻止已经发生的操作。

作者把 70 个脚本放在 ~/.claude/hooks,在 ~/.claude/settings.json 里配了 77 个条目。有些脚本绑定多个事件,也有条目直接写一行命令。多数条目用的是 PreToolUse,因为它能在产生副作用前作出决定。

文案和回复都能检查,检查的时机却不同

草稿检查用 jq -r '.tool_input | tostring' 把整个工具入参转为字符串,再用 grep -Fq 搜四种字符。它们是 em dash、en dash、horizontal bar 和 box line。扫整个入参,可以覆盖 content、new_string、邮件正文或子代理提示等不同字段。原文给出的配置示例使用 Write|Edit|MultiEdit|Task 按工具名匹配,并执行 bash "$HOME/.claude/hooks/no-dash.sh"。邮件如果经由其他工具发出,就要把那条路径也接上。

下面两条命令直接给脚本喂 JSON,分别验证拦截和放行。

printf '{"tool_name":"Write","tool_input":{"content":"Thanks \xe2\x80\x94 see you on Monday."}}' | bash no-dash.sh
printf '{"tool_name":"Write","tool_input":{"content":"Thanks. See you on Monday."}}' | bash no-dash.sh

第一条应输出带有 hookSpecificOutput 的 JSON,其中 hookEventName 是 PreToolUse,permissionDecision 是 deny,permissionDecisionReason 说明如何改写。第二条应无输出。

语言检查则读取本轮会话记录。脚本先剔除代码、URL、邮箱、路径和标识符,再找至少 6 个英文词。日文字符数还要低于英文字母数的 30%,才判为主要使用英文。定位本轮起点也有个细节,工具结果在 JSONL 里同样可能标成 user。代码用 is_real_user 筛出正文为字符串且开头不是 < 的用户消息,避免从最后一条工具结果开始查,漏掉前面的回复。

作者先加提醒,再加输出 {"decision":"block","reason":"…"} 的 Stop Hook。有一天,这个 Hook 至少拦了 7 次英文,但英文过程消息此前已经在屏幕上显示了几分钟,于是他又加了一层。原文没交代第三层的具体实现。它还提醒,长会话的记录可能长到数百 MB,高频 Hook 每次只应读取需要的文件尾部。

发帖和修复汇报,要核对哪一处真实状态?

作者曾把公司短视频发到了个人账号。同一台手机、同一个应用,登录态留在了上一次使用的账号。帖子 4 分钟后撤下,但发布已经发生。现在,发帖脚本先打开个人资料页读取实际账号,并按设备和应用写入 $HOME/.post-gate。脚本要求指定目标 ACCOUNT,核对读到的名字,并拒绝超过 1200 秒的确认记录。这个检查放在每次发帖都要经过的脚本入口。代码用 macOS 的 stat -f %m 读修改时间,Linux 对应 stat -c %Y。

读取当前账号后再决定是否发帖

另一次,Claude Code 在处于锁定状态的配置副本上做了测试,就汇报故障已修复。作者实际遇到问题时,应用处于解锁状态。于是他加了一个 Stop Hook。回复声称修好了,就要写 Confirmed:,说明在哪个环境、以什么条件核验。只能用副本或条件不一致,就写 Unconfirmed:,并收回「已修复」或「应该能用」的断言。

这段测试用两行 JSONL 模拟一轮修复汇报,检查缺少验证说明时会发生什么。

cat > /tmp/t.jsonl <<'EOF'
{"type":"user","message":{"content":"Please fix the login bug."}}
{"type":"assistant","message":{"content":[{"type":"text","text":"I fixed the login bug. It should work now."}]}}
EOF
echo '{"transcript_path":"/tmp/t.jsonl"}' | python3 fix-claim.py; echo "exit=$?"

末行预期打印 exit=2,脚本会把重写理由发到标准错误。按原文把回复改成带有效 Confirmed: 行的版本,再跑应得到 exit=0。作者的 Stop 脚本都会先检查 stop_hook_active,如果当前回合已经因一次拦截而继续,就直接返回,避免反复要求重写。

第五个故障出在浏览器自动化。焦点留在 Chrome 的密码框里,作者的 Mac 即使把窗口切到后台,仍处于安全键盘输入状态,切换应用的快捷键和日语输入都受了影响。macOS 当时指向另一个应用,重启它也没有解决问题。作者后来把检查放进浏览器工具,遇到登录页先停下来等人工处理,每条命令结束还会清理密码框焦点。脚本最多沿焦点进入 5 层 iframe,遇到无法读取内部文档的跨站 iframe,就对该元素调用 blur()。

我的判断

作者自己复查了脚本,也运行了文中的测试。长横线约 100 次和一天至少 7 次英文拦截,都是他的使用记录。原文没有给出对照数据,也没有统计误拦率或维护成本。70 个脚本适合当成个人工作流的规模参考,团队是否需要加一条,还是得看故障能否稳定复现、条件能否准确判断。

我更看重检查拿到的证据。草稿里有没有指定字符,脚本能直接判断,但全量扫描可能连路径或标识符也一起拦。Confirmed: 的正则只能检查有无这一行,真实复现条件要靠测试记录或工具结果支撑。账号检查读到了页面状态,但 20 分钟的缓存仍给中途切换账号留了空间。已有 lint 或发布脚本能统一覆盖入口时,可以把判断写在那里,再用 Hook 接住 Claude Code 的调用时机。选题、内容质量这类需要判断的事,继续留给人。

能拿来做什么

  • 同一句规则已经提醒过至少两次时,先沿着真实操作追一次。比如 Markdown 草稿可能经由文件编辑,也可能直接传给发布工具,检查要接到各自实际经过的入口。
  • 让 AI 汇报前端或 Node 故障的修复结果时,要求它写出验证用的浏览器状态、登录态或运行条件。只在副本上跑过,就把验证范围写清楚。
  • 给每条 Hook 准备一份故意触发的输入和一份应当放行的输入。先用标准输入跑脚本,再在真实 Claude Code 会话里触发一次,核对工具匹配和拦截理由是否符合预期。
  • 如果用 Playwright 或 Chrome DevTools Protocol 驱动浏览器,可以在自动化命令结束时检查焦点。碰到登录页暂停等待人工操作,命令收尾时对遗留的密码框焦点调用 blur()。
Original source

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

阅读原文
上一篇
四款 Gemini 4 的编程定位与 API 价格
下一篇
用 CI 检查编码智能体有没有漏掉需求

资讯速览

dev.to · AI · 2026-11-21 21:00

AI 评分 9.0 / 10

相关标签

#Claude Code#钩子#自动化校验

继续阅读

  • 用 Laravel 和 Vue 实现流式客服聊天
  • 四款 Gemini 4 的编程定位与 API 价格
  • 用 CI 检查编码智能体有没有漏掉需求
  • 让编码智能体复用设计系统排版组件
  • GPT-6.2 Sol 编程跑分接近 Astra