Cách Tác Giả Claude Code Đảm Bảo AI Tuân Thủ Quy Tắc Qua Hệ Thống Hooks Tự Động

Claude Code là một công cụ AI hỗ trợ lập trình với khả năng đọc và thực thi các quy tắc, ngữ cảnh dự án, và hướng dẫn công việc được viết trong tệp CLAUDE.md khi bắt đầu phiên làm việc. Tuy nhiên, trong thực tế, Claude Code không luôn tuân thủ các quy tắc này một cách đáng tin cậy, thường ưu tiên trả lời câu hỏi của người dùng thay vì thực hiện giao thức đã được thiết lập.

Sau nhiều tháng và hơn 500 dòng quy tắc được ghi chép chi tiết trong CLAUDE.md, SESSION_PROTOCOLS.md và MEMORY.md, tác giả đã nhận ra rằng giải pháp không chỉ đơn giản là viết thêm nhiều quy tắc. Vấn đề nằm ở việc thực thi các quy tắc đó. Đó là lý do cho sự ra đời của hệ thống hooks – các đoạn mã chạy tự động tại các thời điểm nhất định trong phiên làm việc.

Vấn đề với quy tắc không được thực thi

Một số lỗi thường gặp khi chỉ dựa vào tài liệu văn bản quy tắc:

• Claude bỏ qua giao thức khởi đầu phiên làm việc: Có một checklist 7 bước rất chi tiết, như tìm kiếm trong cơ sở dữ liệu bộ nhớ, đọc tracker dự án, kiểm tra các mục chưa hoàn thành, hiển thị ghi chú phiên trước... Tuy nhiên, Claude thường bỏ qua toàn bộ bước này, nhảy ngay vào trả lời câu hỏi.

• Claude tự ý viết mã không có phép: Có quy tắc rõ ràng rằng Claude không được phép viết hay chỉnh sửa code nếu chưa được "GO" từ người dùng. Nhưng AI đã vi phạm trong nhiều phiên, bắt đầu code ngay cả khi chưa được bật đèn xanh.

• Claude quên quy tắc sau khi nén (compaction) ngữ cảnh: Khi khung nhớ đầy, hệ thống tự động nén lại ngữ cảnh, làm mất đi các chi tiết tinh vi trong quy tắc, khiến AI chỉ thực thi những quy tắc chung chung mà bỏ sót hướng dẫn chi tiết.

• Claude ưu tiên giúp đỡ hơn là tuân thủ: Khi người dùng hỏi, Claude muốn trả lời ngay lập tức chứ không dừng lại để thực hiện checklist hoặc bước kiểm tra.

Tất cả những điều này không phải lỗi phần mềm mà là hạn chế nền tảng trong cách AI hiểu và ưu tiên thực hiện các quy tắc dạng văn bản. Các quy tắc, dù được viết rõ ràng, chỉ như đề xuất mà AI có thể bỏ qua để "giúp người dùng nhanh hơn".

Vì sao viết nhiều quy tắc hơn không phải giải pháp

Tác giả đã thử nhiều cách để làm rõ quy tắc hơn:

• Viết thêm chi tiết, mở rộng CLAUDE.md từ 50 lên hơn 500 dòng.
• Đánh dấu in đậm, cảnh báo vi phạm quá khứ.
• Sử dụng chữ in hoa, nhấn mạnh các phần quan trọng.

Kết quả là AI tuân thủ một chút tốt hơn nhưng vẫn chỉ đạt mức "thường xuyên", không phải "luôn luôn". Như quy tắc không viết code khi chưa được phép, tỉ lệ vi phạm 10% vẫn gây hao phí rất lớn thời gian cho chỉnh sửa lại.

Lý do: AI hiểu nhưng không có cách nào buộc phải ưu tiên các quy tắc đó so với việc trả lời tức thì yêu cầu của người dùng.

Giải pháp: Hệ thống hooks tự động bắt buộc tuân thủ

Từ đây, tác giả triển khai hệ thống hooks — các đoạn mã Python chạy tự động tại các bước quan trọng của phiên làm việc — để:

• Chạy bất cứ lúc nào mà AI không thể bỏ qua.
• Tiêm dữ liệu bổ sung vào context làm việc của Claude.
• Biến các quy tắc quan trọng thành các thao tác tự động, không thể bị lờ đi hay quên.

Một số ví dụ về hook và cách nó khắc phục hạn chế:

1. Giao thức bắt buộc khi bắt đầu phiên

• Hook session-start.py tự động chạy trước khi Claude nhận tin nhắn đầu tiên, đọc ghi chú phiên trước, các mục chưa hoàn thành, checklist... rồi tiêm vào context.
• Claude không thể bỏ qua checklist vì đã có dữ liệu sẵn trong ngữ cảnh làm việc, đồng thời CLAUDE.md còn hướng dẫn cách hiển thị bảng checklist với trạng thái DONE/MISSING.

2. Tìm kiếm bộ nhớ trước khi trả lời

• Hook user-prompt-submit.py lấy từ khóa trong câu hỏi, tìm kiếm hơn 69.000 tin nhắn trong cơ sở dữ liệu bộ nhớ, rồi tiêm 5 kết quả liên quan nhất vào context.
• Đảm bảo Claude "nhìn thấy" lịch sử thảo luận và quyết định trước khi phản hồi, thay vì tự ý trả lời theo biết của nó.

3. Không được code khi chưa có phép

• Hook user-prompt-submit.py cũng kiểm tra nội dung hội thoại có xuất hiện từ khóa "GO" hay chưa.
• Nếu chưa, nó tự động chèn nhắc nhở nhắc dừng lại, trình bày kế hoạch chờ phép mới tiếp tục.

4. Giữ nguyên ngữ cảnh sau compaction

• Hook pre-compact.py tự động lưu lại toàn bộ cuộc hội thoại vào SQLite trước khi nén ngữ cảnh.
• Hook post-compact.py phục hồi các dữ liệu quan trọng vào context sau khi nén, giúp Claude không bị mất chi tiết.

5. Phát hiện và xử lý trạng thái người dùng căng thẳng (frustrated)

• Hook user-prompt-submit.py dò các dấu hiệu căng thẳng (chữ in hoa, dấu chấm hỏi nhiều, từ khóa giận dữ).
• Khi phát hiện, tự động chèn lệnh dừng lại và xem lại lịch sử để reassess thay vì tiếp tục lặp lỗi.

Bài học rút ra: Quy tắc quan trọng cần có hook

Sau hơn 1300 phiên thử nghiệm với 9 dự án, tác giả kết luận:

• Quy tắc dạng hướng dẫn chung, phong cách hoặc quy chuẩn đặt ở CLAUDE.md thì AI có thể tuân thủ tương đối tốt.
• Nhưng các quy tắc có ảnh hưởng lớn, gây hao phí thời gian nếu bị vi phạm (như giao thức phiên, quyền sửa code, bảo vệ ngữ cảnh, phát hiện trạng thái người dùng) cần được ép tuân thủ tự động bằng hook.

Quy trình điển hình:

1. Viết quy tắc trong CLAUDE.md.
2. Claude vi phạm.
3. Thêm cảnh báo, in đậm, lịch sử vi phạm.
4. Claude sửa dần nhưng vẫn vi phạm đôi khi.
5. Xây dựng hook tự động.
6. Quy tắc không còn bị vi phạm nữa.

Nếu bạn đang ở bước 3 hoặc 4, đừng ngần ngại chuyển ngay sang bước 5 — xây dựng hook cho quy tắc đó.

Triển khai và số liệu thực tế

Hệ thống hook bao gồm 6 tập Python chạy xuyên suốt vòng đời phiên làm việc:

• session-start.py: Tiêm ghi chú phiên trước, mục chưa hoàn thành, bảng checklist.
• user-prompt-submit.py: Tìm kiếm bộ nhớ, kiểm tra quyền code, phát hiện căng thẳng.
• stop.py: Lưu mọi phản hồi, sao lưu định kỳ.
• session-end.py: Đồng bộ, sao lưu lúc kết phiên.
• pre-compact.py và post-compact.py: Lưu và phục hồi dữ liệu khi nén ngữ cảnh.

Kết quả sau 1.300 phiên:

• Giao thức khởi đầu bị bỏ qua: 3 lần trước khi có hook, sau hook 0 lần.
• Vi phạm viết code không phép: 4 lần trước, 0 lần sau.
• Mất ngữ cảnh khi nén: Hàng chục lần trước, 0 lần sau.
• Vòng lặp gây căng thẳng lặp lại lỗi: Nhiều trước, hiếm sau.

Điều khác biệt không phải do quy tắc hay chữ viết tốt hơn, mà nhờ tự động bắt buộc thực thi quy tắc.

Cách áp dụng

Nếu chưa sẵn sàng thiết lập hệ thống hook phức tạp, bạn vẫn có thể cải thiện độ tuân thủ bằng:

• Đặt quy tắc quan trọng lên đầu file CLAUDE.md.
• Yêu cầu Claude xuất bảng checklist xác nhận từng mục (DONE hoặc MISSING) để kiểm tra trực quan.
• Ghi rõ lịch sử vi phạm để tăng tính nghiêm trọng.
• Sử dụng NEXT_SESSION.md để lưu trữ và đọc ghi chú tiếp nối giữa các phiên làm việc.

Tuy nhiên, các biện pháp này vẫn không thể đảm bảo 100% giống như hook tự động.

---

Bạn có thể thử hệ thống hook miễn phí, mã nguồn mở, chạy trên macOS, Linux và Windows qua lệnh sau:

curl -fsSL https://raw.githubusercontent.com/mikeadolan/claude-brain/main/install.sh | bash

Tham khảo thêm trên GitHub: github.com/mikeadolan/claude-brain

Video hướng dẫn: claude-brain in 85 seconds

Bài viết liên quan:

• How I Built Persistent Memory for Claude Code
• Why I Use Claude Code for Everything
• The Session Protocol That Fixed Claude Code's Amnesia Problem
• Claude Code Compaction Kept Destroying My Work. I Built Hooks That Fixed It.

---

Hệ thống hook tự động giúp Claude Code trở nên đáng tin cậy hơn khi xử lý các quy trình phức tạp, tránh lãng phí thời gian do các vi phạm quy tắc không đáng có, mở ra hướng đi mới cho việc kiểm soát các AI hướng dẫn và lập trình tự động.