Claude Code Hooks

Claude Code Hooks 是把外部命令、检查或自动化动作挂到 Claude Code 生命周期中的机制。它们适合处理确定性规则：记录、格式化、校验、拦截、通知和审计。

事件位置

Hooks 通常围绕几个关键事件工作：

工具执行前：检查命令、路径、权限、预算和高风险操作。
工具执行后：运行格式化、测试、链接检查、产物校验或日志记录。
用户输入后：补充上下文、同步状态、检查提示词格式。
停止前：确认验收标准是否满足，或者提醒还有未完成验证。

它们让系统能在执行过程中插入反馈，而不是等到最后人工排查。

观察与阻断

Hooks 可以分成两类：

观察型：记录操作、统计成本、保存日志、生成报告，不改变主流程。
阻断型：当检查失败、预算超限、路径危险或输出不合格时中止流程。

阻断型 hook 需要谨慎设计错误信息。好的错误信息应该告诉智能体失败原因、允许的修复路径和下一步验证方式。

在反馈循环中的角色

Hooks 是智能体反馈循环的低层实现之一。它们把“执行后看一眼”变成稳定的系统节点，适合和测试、CI、智能体成本控制以及智能体无头执行配合使用。

常见失败模式

Hook 过于宽泛，导致正常操作频繁被误拦截。
错误提示不清楚，智能体无法自动修复。
Hook 里做了太多复杂逻辑，变成隐藏工作流。
只记录不阻断，关键风险仍然依赖人工发现。