Hooks（钩子）

Hooks 允许你在 Claude Code 生命周期的特定时间点运行命令。Hooks 与本课程涵盖的其他内容的关键区别在于 hooks 是 确定性的——它们总是会运行。

为什么使用 Hooks

你可以在 CLAUDE.md 中告诉 Claude 在每次文件编辑后运行 Prettier。大多数时候它会这样做。但有时不会。Hook 确保每次都这样做，没有例外。

常见用例包括：

• 文件编辑后自动格式化
• 记录所有执行的命令以满足合规要求
• 阻止修改生产文件等危险操作
• Claude 完成任务时给自己发送通知

工作原理

Hooks 在你的 settings.json 中配置。你选择一个事件，可选地设置匹配器来指定适用的工具，然后提供要运行的命令。一些最常见的事件：

• PreToolUse — 在工具调用前运行
• PostToolUse — 在工具调用完成后运行
• UserPromptSubmit — 在你提交提示时、Claude 处理前运行
• Stop — 在 Claude 完成响应时运行
• Notification — 在 Claude 发送通知时运行

这些只是你可以挂钩的事件中的一部分——Claude Code 支持更多。完整列表请参阅 hooks 参考。

你可以通过 Claude Code 内的 /hooks 命令或直接编辑 settings.json 来配置它们。

实际示例

最常见的 hook：编辑后自动格式化。设置一个 PostToolUse hook，匹配器为 "Edit|MultiEdit|Write"，这样它会在 Claude 修改文件时触发。命令检查文件扩展名并运行相应的格式化程序——TypeScript 用 Prettier，Go 用 gofmt，或你项目使用的任何工具。

使用 PreToolUse 阻止操作

PreToolUse hooks 可以在工具调用执行前 阻止它们。你的 hook 通过 stdin 接收工具名称和输入（JSON 格式）。退出码决定行为：

• 退出码 0 — 正常继续。
• 退出码 2 — 阻止操作。stderr 消息会作为反馈提供给 Claude，这样它就知道为什么被阻止并可以调整。
• 任何其他退出码 — 非阻塞错误，会显示给你但不会停止任何操作。

这就是你执行硬性规则的方式。阻止写入生产配置目录。阻止包含 rm -rf 的 bash 命令。阻止提交到 main 分支。无论你的团队需要 保证 什么，而不是建议。

与团队共享 Hooks

在 .claude/settings.json 中配置的 hooks 是项目级的，可以提交到仓库中。这意味着你的整个团队会自动获得相同的 hooks。在命令中使用 环境变量来引用存储在项目中的脚本，这样无论 Claude 的当前工作目录是什么，它们都能正常工作。