Hooks：
到点就执行，一次都不漏

还记得第 2 课那句话吗："必须每次都执行的事，要交给 Hook。"原因在这里：CLAUDE.md 是给 Claude 看的提醒，做不做由它判断；Hook 是 Claude Code 自己执行的程序，时刻一到就跑。同样是"改完文件跑一次格式化"：

① 写进设置文件

打开 ~/.claude/settings.json（没有就新建），加上下面这段。选你的系统：

• 文件里已经有 "hooks" 的话，把 "Notification" 加进去就行，不要把整个 hooks 替换掉。
• "matcher": "" 表示所有类型的通知都触发。只想在"等你批准"时响，改成 "permission_prompt"。

② 用 /hooks 确认

在 Claude Code 里输入 /hooks，会列出所有事件，配了 hook 的事件旁边有数字。选 Notification，能看到你刚加的命令和它来自哪个文件。这个菜单只能看不能改，要改就直接编辑 JSON，或者让 Claude 帮你改。

③ 试一下

按 Shift+Tab 切到需要批准的模式（状态栏显示 manual mode），让 Claude 做一件要你批准的事，然后切到别的窗口。几秒后应该能收到通知。

放在哪里

和 CLAUDE.md 一样：团队都要遵守的放项目的 .claude/settings.json；桌面通知这种个人习惯放 ~/.claude/settings.json。

练一练：该挂在哪个事件上？

想说得更细，就退出码 0，往标准输出打印一个 JSON，把 "permissionDecision" 放在 hookSpecificOutput 里（格式见下面的模拟器）：deny 拒绝，allow 不用问直接执行，ask 一定弹窗问你。

试一试：同一个操作，不同的回答

选 Claude 想做的事、你的 hook 怎么回答，看结果：

• 空、* 或不写：全部匹配。
• 只有字母、数字、_、-、空格、,、|：按名字精确匹配，| 或逗号分隔多个。Edit|Write 只匹配这两个工具。
• 含有其他字符：当成正则表达式，而且不锚定，名字里任何位置匹配上都算。Edit.* 连 NotebookEdit 也会匹配。
• 区分大小写：bash 匹配不到 Bash。

试一试：这个 matcher 会匹配哪些工具？

if：再按参数筛一道

matcher 只看工具名。想"只在 Claude 跑 git 命令时触发"，在 hook 里加 if，写法和第 4 课的权限规则一样：

{
  "matcher": "Bash",
  "hooks": [
    {
      "type": "command",
      "if": "Bash(git *)",
      "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/check-git-policy.sh"
    }
  ]
}

• if 只能用在工具相关的事件上（PreToolUse、PostToolUse 等），加在别的事件上，hook 就不会运行。
• npm test && git push 这种连起来的命令会拆开检查，git push 匹配上就触发。
• 这层筛选是"尽量"：看不懂的命令，hook 照样运行。要硬性禁止某件事，用权限规则，不要只靠 hook。

写 hook 的好习惯

• 变量加引号：写 "$FILE_PATH"，不要写 $FILE_PATH，路径里有空格就会出事。
• 脚本用绝对路径：写成 "$CLAUDE_PROJECT_DIR"/.claude/hooks/xxx.sh，不管 Claude 当时在哪个目录都找得到。
• 别信输入：检查路径里有没有 ..；绕开 .env、.git/、密钥这类文件。
• 要临时全部关掉：设置里写 "disableAllHooks": true，或启动时加 --settings '{"disableAllHooks": true}'。没办法只关某一个，只能删掉它。它会顺带关掉自定义状态栏（第 9B 课）。

Bash 版本的配方用到 jq 解析 JSON：macOS 用 brew install jq，Ubuntu 用 apt-get install jq。脚本文件记得 chmod +x。Windows 注意：Claude 在 Windows 上默认用 PowerShell 跑命令，matcher 只写 Bash 的 hook 基本不会触发。要管命令，matcher 写 Bash|PowerShell；拦删除还得认 Remove-Item -Recurse 这种写法，官方 Hooks reference 开头有完整的 Windows 版示例。

终端画面为教学示意，与真实 Claude Code 的界面细节可能略有不同，但 hook 的工作方式一致。