cc-hooks (Cấu hình hook cho Claude Code)
Kỹ năng giúp cài đặt, sửa và kiểm thử hook của Claude Code để chặn các lệnh nguy hiểm một cách cơ học.
Lập trìnhNâng cao★ 444⑂ 41Điểm AI 9/10Cập nhật lần cuối: 22 thg 9, 2026
Làm được gì
- Thêm/sửa khối hooks (matcher + command) đúng định dạng mảng trong
~/.claude/settings.jsonhoặc.claude/settings.jsoncủa dự án. - Tuân thủ chính xác hợp đồng của từng sự kiện (
PreToolUse,PostToolUse,Stop,SessionStart...): sự kiện nào chặn được, mã thoát 0 = cho phép, 2 = chặn kèm stderr. - Cung cấp công thức hook mẫu để chặn
git push --force,rm -rf, sửa bản skill đã cài, hay đọc file vượt ngân sách dòng, kèm script cài đặt opt-in. - Áp dụng nguyên tắc rút ra từ lỗi thực tế: im lặng khi thành công (không in stdout ở exit 0), kiểm tra
stop_hook_activeđể tránh vòng lặp, matcher phải hẹp và có thể hoàn tác.
Dành cho ai
- Lập trình viên / platform engineer dùng Claude Code trong nhóm và muốn chặn lệnh rủi ro bằng chính sách
- Người đã thêm hook nhưng bị lỗi tool call hoặc vòng lặp vô hạn và cần chẩn đoán
- Người muốn biến các quy tắc trong CLAUDE.md (thường bị bỏ qua) thành rào chắn bắt buộc
Ví dụ sử dụng
- "Thêm hook PreToolUse vào
.claude/settings.jsonđể chặngit push --forcetrên nhánh main, im lặng khi hợp lệ và exit 2 khi chặn." - "Dùng PostToolUse để tự chạy formatter sau mỗi Edit/Write, nhưng không in bất cứ gì khi thành công."
- "Cài hook Stop buộc tiếp tục nếu test đang fail, nhớ kiểm tra
stop_hook_active."
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/boshu2/agentops/HEAD/images/gemini/skills/cc-hooks/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục images/gemini/skills/cc-hooks từ repo GitHub boshu2/agentops vào ~/.claude/skills/cc-hooks/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/boshu2/agentops.git /tmp/agentops && mkdir -p ~/.claude/skills && cp -r /tmp/agentops/images/gemini/skills/cc-hooks ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và tạo thư mục skill:
mkdir -p ~/.claude/skills - Tải repo:
git clone https://github.com/boshu2/agentops.git /tmp/agentops - Sao chép skill:
cp -r /tmp/agentops/images/gemini/skills/cc-hooks ~/.claude/skills/ - Kiểm tra thư mục
references/đã được copy:ls ~/.claude/skills/cc-hooks - Cài
jqnếu chưa có (macOS:brew install jq; Ubuntu:sudo apt install jq). - Khởi động lại Claude Code và yêu cầu: "dùng skill cc-hooks thêm một hook PreToolUse...".
- Sau khi cài hook, kiểm tra bằng
claude --debughoặc/hooks; muốn hoàn tác thì xóa matcher tương ứng trong settings.json.
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0