🪝Claude Code 的 Hooks · 用 agent 生命周期事件自动化你的工作流

{
  "hooks": {
    "PostToolUse": [                    // 1. 生命周期的 EVENTO(事件)
      {
        "matcher": "Edit|Write",         // 2. 应用到 QUÉ(哪些工具)
        "hooks": [
          {
            "type": "command",           // 3. 这是一条 shell 命令
            "command": "...tu comando..." // 4. 发生时 QUÉ(运行什么)
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# .claude/hooks/block-rm-rf.sh
INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command')

if echo "$COMMAND" | grep -q "rm -rf"; then
  echo "Bloqueado: 'rm -rf' no está permitido. Borra rutas concretas, no recursivo-forzado." >&2
  exit 2   # exit 2 = bloquea la accion; stderr le llega a Claude como feedback
fi

exit 0     # exit 0 = sin objecion; sigue el flujo normal de permisos

chmod +x .claude/hooks/block-rm-rf.sh

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-rm-rf.sh"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code necesita tu atención\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

我想搭起我第一个 Claude Code hook,来自动化我工作流里的一条规则。我想要永远保证的那条规则是:[DESCRIBE LA REGLA,例如:"用 prettier 格式化你编辑的每个文件" / "阻止任何以递归方式删除文件的命令" / "禁止编辑 .env 或 .git/ 里的任何东西" / "完成时用通知提醒我"]。

在写任何东西之前,用清晰的语言(我不会编程)回答这些,帮我把它设计好:

1. 这条规则对应生命周期里正确的 EVENTO(事件)。如果规则是要 IMPEDIR(阻止)某事,它必须是 PreToolUse(发生在之前且能阻止)。如果是对已经做完的事做出 REACCIONAR(反应)(格式化、提醒、记录),它必须是 PostToolUse 或 Notification。告诉我你选哪个以及为什么。

2. 精确的 MATCHER(应用到哪些工具:Edit|Write、Bash,或空表示全部)以及为什么是这个而不是别的。让它尽可能地窄:一个过宽的 matcher 会在不该触发的地方触发 hook。

3. settings.json 该住的 LUGAR(位置):
   - 如果这条规则必须由这个仓库里整个团队遵守 → .claude/settings.json(会被提交)。
   - 如果只针对我的机器和我所有的项目 → ~/.claude/settings.json。
   - 如果是本地且私有的 → .claude/settings.local.json。
   告诉我哪个以及为什么。

4. 完整的 JSON 块,拿来即贴,hook 已经装好。如果它需要一个单独的脚本(带 PreToolUse 的阻止里很典型),也给我完整的 .sh 脚本,并提醒我用 chmod +x 让它可执行。

5. 如果它是一个阻止型 hook:用 exit 2 加一条清晰的 stderr 消息,向我解释为什么被阻止,好让你自己(Claude)收到理由并自我纠正。别让它静默。而且要 AVÍSAME(提醒我)这条规则是否还值得配一条权限规则(permissions.deny)当硬锁,因为一个 hook 里的 grep 是尽力而为、可以被绕过的。

6. 安全,必填:用一句话向我解释这个 hook 会跑 QUÉ(什么)shell 命令,并向我确认它不做任何破坏性的事、也不把数据发到任何地方。提醒我一个 hook 是用我的权限跑 shell 的,我只该保存我理解的命令。

7. 我怎么测试它:告诉我怎么验证 hook 已注册(Claude Code 里的 /hooks 命令),以及一种在不破坏任何真实东西的前提下测试它确实会触发的方法。

先只给我看 SOLO(仅)设计(事件、matcher、位置),然后是 JSON,如果需要再给脚本,最后是安全解释和测试。别现在就改我的 settings.json:我想在自己贴之前先审查这个块。