Hook 概念

给 Claude Code 的工作流装上自动触发器,让特定操作在特定时刻必然执行、零遗漏

应用7 分钟前置:Frontmatter

一、Hook 是什么

Hook 是你预设在 Claude Code 工作流中的自动触发器。当 Claude Code 执行到特定操作——调用工具、完成任务、发出通知——你指定的处理器会自动运行。

它和 CLAUDE.md、Rules 的区别在于确定性。CLAUDE.md 和 Rules 是行为指引,Claude 读了通常会遵守,但本质是建议,偶尔会偏离。Hook 是代码级执行,事件触发了就一定运行,没有"看情况"的空间。

Hook 不做什么

  • 不能触发斜杠命令或工具调用——只能通过 stdout、stderr 和退出码与 Claude Code 通信
  • 不能撤销已完成的操作——PostToolUse 处理器在工具执行之后运行,操作已经发生
  • 有超时限制——command 类型默认 600 秒,prompt 类型默认 30 秒,agent 类型默认 60 秒

二、四种 Hook 类型

Claude Code 支持四种类型的 Hook,覆盖从确定性脚本到 AI 判断的完整光谱。

类型执行方式工具访问默认超时典型用途
command运行 Shell 命令无(纯脚本)600 秒格式化、通知、日志、文件保护
httpPOST 到 HTTP 端点无(无状态请求)事件转发到外部服务、Webhook 集成
prompt单轮 LLM 评估30 秒简单判断:是否完成、是否安全
agent多轮 SubAgent 验证(最多 50 轮,固定上限)有(Read、Grep、Glob 等)60 秒复杂验证:检查文件内容、运行搜索

command 和 http 是确定性执行——脚本逻辑或 HTTP 请求,结果完全由你的代码决定。

付费内容

继续阅读完整课程

购买后即可解锁全部 16 个功能模块、实战场景与深度配置。

¥199¥399
  • 30 分钟完成第一个真实任务
  • 实战场景 + 深度配置
  • 长期访问,持续更新
Hooks 完全指南1/12