a.4方法⏱ 约 5 分钟

hooks — 自动化你的流程

在特定时机,自动触发你想要的动作

🔎 最后验证 2026-05📚 来源:Claude Code 官方文档🧰 Claude Code✅ 64 人学过👁 126 次阅读

为什么学这个

有些事你希望"每次都自动做",不用每回提醒:改完代码自动跑一下格式化、提交前自动检查有没有密钥、AI 做完某操作自动跑测试。Claude Code 的 hooks(钩子) 让你把这些"在某时机自动触发"的规则定下来——把好习惯变成自动执行。

💡 打个比方

hooks 就像家里的自动化开关:"一开门就亮灯""一到晚上就拉窗帘"——你设定好"什么时机做什么",之后它自动发生,不用每次手动。把"每次都该做但容易忘的事"交给自动化。

hook(钩子) = 在 Claude 的某个生命周期事件发生时自动执行的动作
- 常见时机:工具调用前 / 工具调用后 / 对话结束时等(注:这些是 Claude 自身的事件,和 Git 自带的 pre-commit 钩子是两回事——"提交前查密钥"在这里是靠拦截执行 git commit 的那次工具调用来实现的)
- 常见动作:跑格式化、跑测试、做安全检查、记录日志
为什么有用:把 P4 学的好习惯自动化、固化,不再依赖"记得做"
- 改完文件后自动跑格式化/测试,第一时间发现回归(P4 #19)
- 在执行某些命令前自动检查(如要 commit 前先扫密钥,P4 #5)
具体配置方式以官方文档为准(hooks 是较进阶、会演进的功能)

❓ 测验

hooks(钩子)的核心作用是?

⚠️ 避坑hook 用错会'默默捣乱',要让它的行为透明

一个配置不当的 hook 可能在你没注意时自动改了东西、或拦下了你的操作,让你莫名其妙。设 hook 要清楚它会做什么、在什么时机、出问题怎么关掉;别设一堆你自己都记不清的自动动作。自动化是为了省心,不是制造黑箱。

🤖 设计一个有用的 hook(去真实环境)

我想用 hook 自动化一个好习惯:【例如:提交前自动检查代码里有没有硬编码的密钥;或 AI 改完文件后自动跑一遍测试】。请基于 Claude Code 官方文档当前版本告诉我:1) 这个 hook 该挂在什么时机;2) 怎么配置;3) 如果它出问题,怎么排查和关闭。

🔎 来源与核验· 1 条,点开核对

本节每个关键论断都对应一个可追溯的来源 —— 这是本课程"靠谱、不过时"的底线。

「hooks 可在特定事件自动执行动作(如检查/测试),用于固化工作流(配置以官方文档为准)」

先别配会改文件的 hook,从最安全的"只打印"起步。

让 Claude 基于官方文档当前版本,帮你配一个最简单的 hook:在每次工具调用后,只往一个日志文件追加一行"刚发生了什么"(纯记录,不改任何东西)。
随便让它做两步操作,然后打开日志文件,看这些事件是不是真被记下来了。
现在设想把它换成"提交前自动扫密钥并拦截"——问它:万一这个 hook 误拦了正常提交,我该怎么快速定位、怎么临时关掉?

你会看到:一个"只记录"的 hook 让你亲眼看清它到底在什么时机触发;有了这份把握,你才敢升级到"会拦截、会改文件"的 hook。

为什么:hook 是自动、静默执行的,配错了会"默默捣乱"。永远从"透明、可观测、能一键关掉"起步——先让它说话,确认时机没错,再让它动手。这和 P4"先看清再放手"是同一条纪律。

✅ 小结

你能让事情在 Claude Code 里自动发生了。下一步把 Claude 本身接进脚本和自动化流程——下一节学 headless 模式。

下一节 → headless 模式 — 接进脚本

都看到这了，打个赏呗！