05-Hooks系统完整指南

用户6572

昨天修改

Hooks系统完整指南：自动化工作流的终极武器

课程信息

•
作者：老金​

•

GitHub：https://github.com/KimYx0207

•
公众号：老金带你玩AI​

•
X（Twitter）：老金带你玩AI​

•

个人博客：https://aiking.dev

•
预计学时：4-6小时​

•
难度等级：⭐⭐ 入门级（有Claude Code基础即可）​

•
更新日期：2026年4月​

•
适用版本：Claude Code v2.1.92（验证于2026-04-05）​

•
前置要求：已完成Claude Code安装和基础使用​

本课学习目标

完成本课学习后，你将能够：

1.
理解Hooks的核心价值：掌握Hooks与传统提示词的本质区别​

2.
配置第一个Hook：5分钟内完成最简单的Hook配置并看到效果​

3.
按事件族理解Hooks：理解工具、会话、任务、失败、文件系统、压缩和 Elicitation 等事件面​

4.
实现自动化工作流：Git提交检查、代码格式化、文件保护等实战场景​

5.
排查Hook故障：独立解决90%的常见配置和执行问题​

6.
安全使用Hooks：理解安全风险并正确配置权限​

2026-04 差量更新（先读）

这章旧版最大的问题，是把 Hooks 讲成“固定 20 种类型”。现在这个说法已经不稳了。​

•
官方 Hook 事件面仍在扩展，不要再死记一个固定数字。​

•
当前主流处理器有 4 类：command、http、prompt、agent。​

•
除了常见的 PreToolUse / PostToolUse / UserPromptSubmit，还应注意较新的事件，例如 PostToolUseFailure、PermissionDenied、TaskCreated、TaskCompleted、StopFailure、CwdChanged、FileChanged。​

因此，下面正文请用“事件族 + 处理器类型 + 典型场景”来理解，而不是背一个固定数量。​

与 Hooks 相关的 v2.1.90 / v2.1.92 变更（GitHub Release 摘录）

下列句子均来自官方 What's changed，英文原文便于逐字核对；教程不展开实现细节。​

v2.1.90（release）：

•
Fixed Edit/Write failing with "File content has changed" when a PostToolUse format-on-save hook rewrites the file between consecutive edits​

•
Fixed PreToolUse hooks that emit JSON to stdout and exit with code 2 not correctly blocking the tool call​

v2.1.92（release）：

•
Fixed prompt-type Stop hooks incorrectly failing when the small fast model returns ok:false, and restored preventContinuation:true semantics for non-Stop prompt-type hooks​

阅读提示：若 Hook 行为与上述条目相关但仍异常，以当前安装的 claude --version 及之后新 release 为准。​

学习路径导航（先看这里！）

根据你的情况选择学习路径：这是一篇3000+行的长教程，不用全看！根据你的目标选择路径。​

路径A：快速上手（30分钟）

适合人群：急着体验Hooks，想快速配一个看效果

只看这些章节（其他跳过）：

代码块

✅ 术语表（5分钟） - 快速了解Hook核心概念​
✅ 第一部分1.1-1.2：Hooks简介（5分钟） - 理解Hook是什么​
✅ 第二部分：5分钟快速开始（15分钟） - 配置第一个Hook​
✅ 第三部分3.1：PreToolUse基础（5分钟） - 最常用的Hook类型​

30分钟后你能达到：成功配置第一个Hook，Claude Code能自动执行你的脚本​

路径B：完整学习（4-6小时）

适合人群：想深入理解Hooks，掌握所有类型和高级用法

05-Hooks系统完整指南​

05-Hooks系统完整指南