AI Agent / 系统课时
使用 Hooks 自动响应事件
使用 Hooks 自动响应事件
Hooks 可以在 Claude Code 生命周期的关键事件上运行命令、HTTP 请求或其他处理逻辑。它适合做确定性的校验、格式化和通知:模型负责提出动作,Hook 负责按固定规则检查或响应。
学习目标
- 理解 PreToolUse、PostToolUse 和 Notification 的执行位置
- 能配置并验证一个工具调用后的自动格式化 Hook
- 知道何时用 Hook 阻止动作,何时只记录或提醒
Hooks 在执行链中的位置
PreToolUse 在工具调用执行前触发,可拒绝、询问或允许;PostToolUse 在成功调用后触发,适合格式化和审计;Notification 在 Claude Code 需要用户输入或权限时触发。Hook 是确定性自动化,不应承担需要复杂语义判断的全部工作。:contentReference[oaicite:24]{index=24}

配置编辑后的自动格式化
下面的项目设置在 Edit 或 Write 成功后读取被修改文件路径,并调用 Prettier。该示例要求项目已经安装 prettier,并且 Hook 运行环境可使用 jq 与 xargs。
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
}
]
}
]
}
}Hook 从标准输入接收事件 JSON。命令只处理本次工具调用中的文件路径,避免每次编辑后格式化整个仓库。配置写入 .claude/settings.json 后,团队成员会共享该行为;机器相关命令则更适合放用户或本地设置。
验证 Hook 是否被加载
启动 Claude Code 后输入 /hooks,查看 PostToolUse 下是否出现配置。该面板用于浏览,不负责直接编辑配置。:contentReference[oaicite:25]{index=25}
claude预期结果
Claude Code 会话启动;输入 /hooks 后可看到 PostToolUse Hook 及其 matcher 和命令来源。随后让 Claude 修改一个由 Prettier 支持的测试文件,检查文件是否被自动格式化。不要直接在生产分支验证 Hook,应先用临时文件或独立工作树。
用 PreToolUse 建立执行前门禁
对于部署、删除和访问受控路径,可使用 PreToolUse 检查工具名与输入。结构化输出能返回 allow、deny、ask 或非交互模式下的 defer。但 Hook 返回允许并不能覆盖显式拒绝或询问规则;权限规则仍按拒绝优先执行。:contentReference[oaicite:26]{index=26}
门禁脚本必须快速、稳定并产生可诊断错误。若脚本依赖远程服务,应明确超时和故障策略。安全校验通常采用“校验失败即阻止”,通知类 Hook 则可以在失败时记录警告但不打断主任务。
避免 Hook 变成新的风险源
Hook 命令本身拥有当前用户权限,可能读取环境变量、访问网络或修改文件。不要把未审查的仓库 Hook 视为普通配置,也不要在命令字符串中写令牌。对 HTTP Hook 限制允许 URL 和可插入的环境变量,对命令 Hook 固定脚本路径并进行版本控制。