Hooks 快速开始

本节目的: 创建第一个 Hook ⏱️ 预计时间: 15 分钟

步骤1: 创建 Hook 文件

在项目目录创建 .claude/hooks/ 目录: Windows:

mkdir .claude\hooks
echo '{}' > .claude\hooks\my-hook.json

macOS/Linux:

mkdir -p .claude/hooks
echo '{}' > .claude/hooks/my-hook.json

步骤2: 编写 Hook 配置

编辑 .claude/hooks/my-hook.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx eslint --fix"
          }
        ]
      }
    ]
  }
}

这个 Hook 会在每次编辑文件后自动运行 ESLint 修复。

Hook 类型说明

类型	触发时机	用途
PreToolUse	工具执行前	预处理、验证
PostToolUse	工具执行后	后处理、通知
Notification	消息显示前	过滤、修改通知
Stop	任务停止时	清理资源

---

下一节: [实战应用](./03-practice)