Hooks: tự động hoá vòng đời

CLAUDE.md rất hữu ích, nhưng nó là lời khuyên - Claude cố tuân theo, đôi khi vẫn quên. Khi bạn cần một điều luôn luôn xảy ra (format sau mỗi lần sửa, chặn lệnh xoá nguy hiểm), bạn cần đảm bảo, không phải lời khuyên. Đó là hooks: mã do bạn cấu hình, Claude Code tự chạy tại các mốc vòng đời cố định.

• ▸CLAUDE.md = LỜI KHUYÊN (có thể quên); Hook = ĐẢM BẢO (luôn chạy, do máy thực thi).
• ▸Hook chạy tại các mốc: trước/sau khi dùng công cụ, đầu phiên, khi Claude trả lời xong…
• ▸Dùng để: tự format/test, chặn lệnh nguy hiểm, ghi log, nhắc nhở.

Hook gắn vào một “mốc”. Vài mốc hay dùng nhất:

• ▸PreToolUse là mốc mạnh nhất: chạy TRƯỚC công cụ → CHẶN được hành động.
• ▸PostToolUse chạy SAU → hợp để tự format/test (công cụ đã chạy, không chặn nữa).
• ▸Stop chặn được để buộc Claude làm tiếp (vd “chưa chạy test thì chưa dừng”).

Thử ngay - bật/tắt hook để xem vòng đời thay đổi ra sao:

Hook khai báo trong settings.json theo cấu trúc: Mốc → matcher (lọc công cụ) → danh sách hook. Ví dụ kinh điển: tự chạy linter sau mỗi lần Claude ghi/sửa file:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix"
          }
        ]
      }
    ]
  }
}

• ▸matcher lọc công cụ: "Bash", "Edit|Write" (nhiều cái), "*" (mọi công cụ).
• ▸Mỗi hook có type - phổ biến nhất là "command" (chạy một script shell).
• ▸Nơi đặt: .claude/settings.json (dự án) · ~/.claude/settings.json (cá nhân) · .claude/settings.local.json (cục bộ).

Mốc PreToolUse chạy TRƯỚC công cụ, nên nó chặn được. Hook nhận dữ liệu sự kiện qua stdin (JSON) và quyết định bằng mã thoát hoặc JSON trả về:

#!/bin/bash
COMMAND=$(jq -r '.tool_input.command')

if echo "$COMMAND" | grep -q 'rm -rf'; then
  jq -n '{
    hookSpecificOutput: {
      hookEventName: "PreToolUse",
      permissionDecision: "deny",
      permissionDecisionReason: "Chan lenh rm -rf theo chinh sach"
    }
  }'
else
  exit 0
fi

• ▸Hook nhận JSON qua stdin: session_id, tool_name, tool_input… (dùng jq để đọc).
• ▸Mã thoát 0 = ổn; 2 = CHẶN (stderr đưa cho Claude); mã khác = không chặn, ghi log.
• ▸Cách hiện đại: in JSON với permissionDecision "deny" + lý do - rõ ràng cho người dùng.
• ▸Trỏ tới script bằng ${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh để chắc đường dẫn.

Ngoài command (chạy script), hook còn có thể là: http (gọi một dịch vụ), mcp_tool (gọi công cụ MCP), prompt (hỏi một model đánh giá), hay agent (một subagent kiểm tra). Phần lớn việc thường ngày chỉ cần command.