用 Hooks 在 Claude Code 生命周期事件上挂接自动化脚本

方法定义

Claude Code 提供生命周期事件（Hooks）接口，允许在会话、命令执行、文件写入等节点挂接自动化脚本。橙皮书（claude-code-orange-book（Claude Code 橙皮书仓库））把它作为"把重复工作封装到工具链"的一环，与 CLAUDE.md 项目级指令文件（Claude Code 项目宪法） 配合使用：在 Hook 脚本里只调用最小必要的命令，并通过 CLAUDE.md 显式记录允许触发的事件。

适合哪些情况

• 需要在每次 Claude Code 写文件之后自动执行格式化、lint 或测试
• 需要在会话开始前注入项目状态或在结束后清理临时资源
• 想把"提交前自动跑构建"这类机械动作交给脚本而不是 Agent 提示
• 想用最少提示成本维持一致的工程化纪律

常见做法

• 把 Hook 脚本放在项目内的独立目录，并在 CLAUDE.md 中说明其作用
• 限制 Hook 脚本只调用最小命令集，避免在 Hook 中再调用 Agent 或发起网络请求
• 凭证不要写在 Hook 脚本里，统一通过环境变量读取
• 在多 Agent / Subagent 协作时，Hook 同样要按最小权限运行
• 把 Hook 触发的副作用写入日志，便于事后审计

限制和检查点

• Hook 脚本本身被误写就会扩大权限面，参见 Claude Code 在 MCP / Hooks / Slash Commands 上的权限与凭证暴露风险
• 不同 Claude Code 版本的 Hook 事件名称可能变化，写法应以官方当前文档为准
• Hook 不能替代人工测试与构建；它只是把可机械化的动作前置或后置
• 当项目结构或命令改变时，需要同步更新 Hook 脚本

来源

• claude-code-orange-book（Claude Code 橙皮书仓库）
• HuaShu（花叔）
• HuaShu《Claude Code 橙皮书》教程摘要
• sources/25-08-development-automation--35-src-dev-002-claude-code-orange-book--1m81cqu