用 Claude Code Hooks 拦住反复踩的坑
文章给出五种钩子示例和配置测试方法,涵盖发错账号、未经验证就宣称修好等问题。PreToolUse 可拦截工具调用,Stop 可要求模型重写回复,作者建议主动触发错误以确认钩子生效。
AI 深度解读
Claude Code 在 CLAUDE.md 里读过一条规则,到了长会话末尾,仍可能用错语言、漏掉验证,甚至把内容发到错误的账号。作者维护了 70 个 Hook 脚本,挑出其中五类故障,解释怎样把反复提醒变成执行时的检查。
对日常用 AI 写代码的人,最值得借鉴的是他选检查时机的方法。准备调用工具时拦动作,准备结束回复时查结论,真正发帖前核对账号。写完脚本还要故意犯一次错,确认它会拦,再用正常输入确认它会放行。
同一条规则提醒了百来次,为什么还会出错?
作者在日本经营自己的公司已有 22 年,平时用 Claude Code 处理视频、帖子和文章。为了追踪重复失误,他把每次发生了什么、原因在哪、后来靠什么拦下来记成档案。录视频时有 127 条,写文章时增长到 134 条。

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()。