钩子
钩子（Hooks）让您可以在 Claude Code 生命周期的特定节点运行命令。 钩子与本课程中涉及的其他内容之间的关键区别在于，钩子是确定性的——它们总是会运行。
为什么使用钩子
您可以在 CLAUDE.md 中告诉 Claude 在每次文件编辑后运行 Prettier。大多数情况下它会这样做。但有时它不会。钩子可以确保每次都会执行，没有例外。
常见用例包括：
- 文件编辑后自动格式化
- 记录所有已执行的命令以满足合规要求
- 阻止危险操作，例如修改生产文件
- 当 Claude 完成任务时向自己发送通知
工作原理
钩子在您的 settings.json 中配置。您选择一个事件，可以选择性地设置一个匹配器来指定它适用于哪些工具，并提供要运行的命令。一些最常见的事件包括：
- PreToolUse — 在工具调用之前运行
- PostToolUse — 在工具调用完成后运行
- UserPromptSubmit — 在您提交提示后、Claude 处理之前运行
- Stop — 在 Claude 完成响应时运行
- Notification — 在 Claude 发送通知时运行
这些只是您可以挂接的事件中的一小部分——Claude Code 支持更多事件。请参阅钩子参考文档（在新标签页中打开）以获取完整列表。
您可以通过直接编辑 settings.json 来配置它们。Claude Code 内的 /hooks 命令会打开一个只读列表，显示您已配置的钩子，这样您就可以检查新配置的钩子是否已生效。
一个实际示例
最常见的钩子：编辑后自动格式化。设置一个匹配器为 "Edit|Write" 的 PostToolUse 钩子，这样它就会在 Claude 使用 Edit 或 Write 工具后触发。该命令会检查文件扩展名并运行相应的格式化工具：TypeScript 使用 Prettier，Go 使用 gofmt，具体取决于您项目所使用的工具。
使用 PreToolUse 进行阻止
PreToolUse 钩子可以在工具调用执行之前阻止它们。您的钩子会通过 stdin 以 JSON 格式接收工具名称和输入。退出代码决定了具体行为：
- 退出代码 0 — 正常继续。
- 退出代码 2 — 阻止该操作。stderr 消息会作为反馈返回给 Claude，让它知道为什么被阻止，并据此进行调整。
- 其他任何退出代码 — 非阻塞性错误，会显示给您，但不会阻止任何操作。
这就是您强制执行硬性规则的方式。阻止对生产配置目录的写入。阻止包含 rm -rf 的 bash 命令。阻止对 main 分支的提交。任何您团队需要 确保 而非仅仅建议的事情，都可以这样处理。
与团队共享钩子
在 .claude/settings.json 中配置的钩子属于项目级别，可以提交到您的代码仓库中。这意味着您的整个团队会自动获得相同的钩子。在命令中使用 CLAUDE_PROJECT_DIR 环境变量来引用存储在项目中的脚本，这样无论 Claude 当前的工作目录是什么，它们都能正常工作。
回顾
钩子让您能够对 Claude Code 的行为进行确定性控制。使用 PostToolUse 进行自动格式化和日志记录。使用 PreToolUse 阻止危险操作。在 settings.json 中配置它们，并使用 /hooks 查看它们。并将它们提交到您的代码仓库中，这样您的团队也能获得它们。
如果某件事必须每次都毫无例外地发生，不要把它放进提示中。把它放进钩子里。