一文详解Claude Code中Hooks的使用

{
  "hooks": {
    "PreToolUse": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 /path/to/my_hook.py"
          }
        ]
      }
    ],
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 /path/to/notify.py"
          }
        ]
      }
    ]
  }
}

{
  "session_id": "abc-123",
"hook_event_name": "PreToolUse",
"tool_name": "Bash",
"tool_input": {
    "command": "rm -rf /tmp/test"
  },
"cwd": "/Users/you/myproject",
"tty": "/dev/ttys001"
}

{
  "session_id": "abc-123",
  "hook_event_name": "Notification",
  "message": "任务完成，等待你的下一步指令",
  "cwd": "/Users/you/myproject"
}

{
  "session_id": "abc-123",
  "hook_event_name": "Stop",
  "cwd": "/Users/you/myproject"
}

import json, sys

data = json.load(sys.stdin)

if data.get("tool_name") == "Bash":
    command = data.get("tool_input", {}).get("command", "")
    if"rm -rf"in command:
        # 通过 stdout JSON 阻断
        print(json.dumps({
            "decision": "block",
            "reason": "禁止执行 rm -rf"
        }))
        sys.exit(0)  # stdout 已表达意图，退出码可以是 0

sys.exit(0)

print(json.dumps({
    "additionalContext": "当前磁盘剩余空间 2GB，请谨慎执行大文件操作"
}))
sys.exit(0)

#!/usr/bin/env python3
import json
import sys
from datetime import datetime

data = json.load(sys.stdin)

if data.get("tool_name") == "Bash":
    command = data.get("tool_input", {}).get("command", "")
    with open("/tmp/claude_commands.log", "a") as f:
        f.write(f"{datetime.now()} | {command}\n")

sys.exit(0)  # 退出码 0，Claude 继续执行

#!/usr/bin/env python3
import json
import sys

data = json.load(sys.stdin)

if data.get("tool_name") == "Bash":
    command = data.get("tool_input", {}).get("command", "")
    if "rm -rf" in command:
        print("拦截：禁止执行 rm -rf", file=sys.stderr)
        sys.exit(2)  # 退出码 2，Claude 放弃这次工具调用

sys.exit(0)

#!/usr/bin/env python3
import json
import sys
import subprocess

data = json.load(sys.stdin)

subprocess.run([
    "osascript", "-e",
    f'display notification "Claude 完成了，去看看吧" with title "Claude Code"'
])

sys.exit(0)

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 /path/to/bash_guard.py"
          }
        ]
      }
    ]
  }
}

#!/usr/bin/env python3
import json, socket, sys
data = sys.stdin.read()
sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
sock.connect("/tmp/my_app.sock")
sock.sendall((data + "\n").encode())
response = sock.recv(1024).decode().strip()
sock.close()
# 常驻进程返回 "block" 时阻断工具调用（必须用退出码 2）
sys.exit(2if response == "block"else0)