Bài 2.11: Hooks — Kiểm soát tất định hành vi Claude Code

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/format-on-edit.sh"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/block-dangerous-commands.sh"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/notify-done.sh"
          }
        ]
      }
    ]
  }
}

{
  "tool_name": "Edit",
  "tool_input": {
    "file_path": "/path/to/file.ts",
    "old_string": "const x = 1",
    "new_string": "const x = 2"
  }
}

#!/usr/bin/env bash
# Hook: Auto-format file after Claude edits it
# Receives JSON on stdin with tool_input.file_path

set -euo pipefail

# Đọc JSON từ stdin, extract file_path
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('tool_input',{}).get('file_path',''))" 2>/dev/null || echo "")

# Nếu không có file path, thoát bình thường
if [ -z "$FILE_PATH" ]; then
  exit 0
fi

# Nếu file không tồn tại, thoát bình thường
if [ ! -f "$FILE_PATH" ]; then
  exit 0
fi

# Xác định formatter theo extension
EXT="${FILE_PATH##*.}"

case "$EXT" in
  ts|tsx|js|jsx|json|css|html|md)
    # Prettier cho web stack
    if command -v prettier &>/dev/null; then
      prettier --write "$FILE_PATH" --log-level warn
      echo "Formatted (prettier): $FILE_PATH" >&2
    fi
    ;;
  go)
    # gofmt cho Go
    if command -v gofmt &>/dev/null; then
      gofmt -w "$FILE_PATH"
      echo "Formatted (gofmt): $FILE_PATH" >&2
    fi
    ;;
  py)
    # ruff cho Python (nhanh hơn black)
    if command -v ruff &>/dev/null; then
      ruff format "$FILE_PATH" --quiet
      echo "Formatted (ruff): $FILE_PATH" >&2
    elif command -v black &>/dev/null; then
      black "$FILE_PATH" --quiet
      echo "Formatted (black): $FILE_PATH" >&2
    fi
    ;;
  *)
    # Extension không hỗ trợ — thoát bình thường
    exit 0
    ;;
esac

exit 0

chmod +x .claude/hooks/format-on-edit.sh

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/format-on-edit.sh"
          }
        ]
      }
    ]
  }
}

git add .claude/hooks/format-on-edit.sh .claude/settings.json
git commit -m "chore: add auto-format hook for Claude Code"

> Sửa file src/components/Button.tsx — đổi className "btn" thành "button"

{
  "tool_name": "Bash",
  "tool_input": {
    "command": "rm -rf /tmp/old-build"
  }
}

#!/usr/bin/env bash
# Hook: Block dangerous bash commands in PreToolUse
# exit 0 = allow, exit 2 = block (stderr → Claude feedback)

set -euo pipefail

INPUT=$(cat)
TOOL=$(echo "$INPUT" | python3 -c "import sys,json; print(json.load(sys.stdin).get('tool_name',''))" 2>/dev/null || echo "")
COMMAND=$(echo "$INPUT" | python3 -c "import sys,json; print(json.load(sys.stdin).get('tool_input',{}).get('command',''))" 2>/dev/null || echo "")

# Chỉ check tool Bash
if [ "$TOOL" != "Bash" ]; then
  exit 0
fi

# RULE 1: Block rm -rf (quá nguy hiểm, không ngoại lệ)
if echo "$COMMAND" | grep -qE 'rm\s+-[a-zA-Z]*r[a-zA-Z]*f|rm\s+-[a-zA-Z]*f[a-zA-Z]*r'; then
  echo "BLOCKED: 'rm -rf' không được phép. Dùng 'rm -r' kèm đường dẫn cụ thể, hoặc xác nhận với user trước." >&2
  exit 2
fi

# RULE 2: Block write/modify vào infra/prod/
if echo "$COMMAND" | grep -qE '(infra/prod|production\.env|\.env\.prod)'; then
  echo "BLOCKED: Không được thao tác file production trực tiếp. Chỉ dùng infra/staging/." >&2
  exit 2
fi

# RULE 3: Block git push --force
if echo "$COMMAND" | grep -qE 'git push.*--force|git push.*-f\b'; then
  echo "BLOCKED: force push không được phép. Tạo PR thay thế." >&2
  exit 2
fi

# Cho phép mọi lệnh khác
exit 0

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/block-dangerous-commands.sh"
          }
        ]
      },
      {
        "matcher": "Write|Edit|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/block-prod-writes.sh"
          }
        ]
      }
    ]
  }
}

[Hook blocked: BLOCKED: 'rm -rf' không được phép. Dùng 'rm -r' kèm đường dẫn cụ thể...]
Claude: "Tôi hiểu rồi. Tôi sẽ dùng 'rm -r /tmp/cache' thay thế để xoá thư mục một cách an toàn hơn."

# .claude/hooks/lint-on-edit.sh
FILE_PATH=$(cat | python3 -c "import sys,json; print(json.load(sys.stdin).get('tool_input',{}).get('file_path',''))")
[[ "$FILE_PATH" == *.ts ]] && npx eslint --fix "$FILE_PATH" --quiet
exit 0

# .claude/hooks/notify-slack.sh
curl -s -X POST "$SLACK_WEBHOOK_URL" \
  -H 'Content-type: application/json' \
  --data '{"text":"Claude finished the task. Ready for review."}' > /dev/null
exit 0

# .claude/hooks/audit-log.sh
COMMAND=$(cat | python3 -c "import sys,json; print(json.load(sys.stdin).get('tool_input',{}).get('command',''))")
echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) | USER=$USER | CMD=$COMMAND" >> /var/log/claude-audit.log
exit 0

# .claude/hooks/say-done.sh
say "Claude xong rồi, về review đi bạn ơi" &
exit 0

// SAI — vỡ khi teammate clone về
"command": "/Users/john/projects/myapp/.claude/hooks/format.sh"

// ĐÚNG — work ở bất kỳ machine nào
"command": "$CLAUDE_PROJECT_DIR/.claude/hooks/format.sh"

// BAD — hook chạy trên MỌI tool call (Read, Glob, Grep, v.v.)
{ "matcher": "" }

// GOOD — chỉ chạy khi Claude edit file
{ "matcher": "Edit|MultiEdit|Write" }

# Trong script
LOG_FILE="$CLAUDE_PROJECT_DIR/logs/claude-audit.log"
CONFIG="$CLAUDE_PROJECT_DIR/.env.local"

# Tạo mock input
echo '{"tool_name":"Edit","tool_input":{"file_path":"/tmp/test.ts"}}' \
  | .claude/hooks/format-on-edit.sh

# Chỉ format nếu file trong src/ (không format test fixtures)
if [[ "$FILE_PATH" == */src/* ]]; then
  prettier --write "$FILE_PATH"
fi

{
  "matcher": "Edit|MultiEdit|Write",
  "hooks": [...]
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/format-on-edit.sh"
          }
        ]
      }
    ]
  }
}