33 · Hooks 教程：事件、配置与自动化

Hook 的生命周期事件、匹配器、命令配置、输入输出和错误处理，帮你在固定节点自动执行格式化、检查与安全卡点。

Hooks 解决的是「自动化」：让 Claude Code 在关键节点自动执行你指定的脚本。这一篇讲怎么配。

「生命周期事件」是 Hook 的触发点：比如「任务开始前」「任务结束后」「某类操作发生前」等。你在这些节点挂上脚本，它就自动跑。

「匹配器」让你能精确控制「什么情况才触发」：不是所有事件都跑，而是满足条件才跑。

「命令配置」是核心：你指定「在哪个事件、跑什么命令」。命令可以是格式化、检查、发通知等任何脚本。

「输入输出」：Hook 脚本可以拿到当前的一些上下文信息（输入），也能把结果反馈回去（输出），比如「检查没通过，拦一下」。

「错误处理」要想好：Hook 脚本失败了怎么办——是放行、还是阻断任务。这决定了你的自动化「兜底」是否可靠。

「典型用法」：每次任务开始前自动跑环境检查；每次提交代码前自动跑格式化；每次改完自动跑测试。这些「确定性的、重复的」动作，交给 Hook 最合适。

Hooks 的定位是「确定性自动化」，它不管「做什么决策」，只管「在固定时机机械地执行」。和 Skills（沉淀流程）、Rules（管命令）是不同维度。

常见误区：很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」，理解了动机，规则就自然内化了，不用死记硬背。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

复盘清单：每做完一个任务，可以花一分钟复盘——目标说清楚了吗？范围限定了吗？结果验证了吗？审查过 diff 了吗？下次哪里能更好？这 5 步能让你的 Codex 使用从「能用」进化到「好用」。