Claude viết mã luôn mắc lỗi? 12 quy tắc này đã giảm tỷ lệ sai sót xuống 3%
**Tóm tắt: 12 Quy tắc trong CLAUDE.md Giảm Tỷ lệ Lỗi Code của Claude Xuống 3%**
Bài viết mở rộng bộ quy tắc CLAUDE.md nổi tiếng của Andrej Karpathy và Forrest Chang, vốn có 4 quy tắc nhằm giảm lỗi phổ biến khi Claude viết code (như đưa ra giả định thầm lặng, kỹ sư quá mức). Sau 6 tuần thử nghiệm trên 30 kho code, tác giả nhận thấy 4 quy tắc gốc vẫn hiệu quả nhưng chưa đủ cho các tác vụ AI phức tạp hơn xuất hiện từ đầu năm 2026, như Agent đa bước, hook chain hay cộng tác đa kho code.
Do đó, tác giả đề xuất thêm 8 quy tắc mới, nâng tổng số lên 12, để giải quyết các lỗi kiểu mới:
5. **Không để model làm công việc phi ngôn ngữ:** (VD: quyết định logic retry API).
6. **Đặt ngân sách token cứng:** Ngăn các vòng lặp debug tốn kém kéo dài vô hạn.
7. **Phơi bày xung đột, không dung hòa trung bình:** Tránh việc Claude trộn lẫn các phong cách/pattern mâu thuẫn trong code.
8. **Đọc trước, viết sau:** Hiểu code hiện có trước khi sửa/viết mới để tránh trùng lặp hoặc phá vỡ logic.
9. **Kiểm thử không phải tùy chọn, nhưng bản thân việc kiểm thử không phải mục tiêu:** Đảm bảo test xác thực logic thực sự, không chỉ đơn giản pass.
10. **Các thao tác chạy dài cần điểm kiểm tra (checkpoint):** Bảo vệ tiến trình trong các tác vụ đa bước, tránh mất toàn bộ nếu một bước lỗi.
11. **Quy ước có trước, sự mới mẻ có sau:** Tuân theo pattern hiện có của codebase thay vì giới thiệu quy ước mới gây rối.
12. **Thất bại phải rõ ràng, không thất bại thầm lặng:** Ưu tiên báo lỗi rõ ràng thay vì để code chạy "thành công" nhưng cho kết quả sai.
Kết quả thử nghiệm cho thấy bộ 12 quy tắc giảm tỷ lệ lỗi từ ~41% xuống còn ~3% trên 50 tác vụ, mà không làm giảm đáng kể tỷ lệ tuân thủ. Bài viết cũng cảnh báo không nên biến CLAUDE.md thành danh sách mong ước dài, mà nên giữ nó ngắn gọn (<200 dòng) và tập trung vào các lỗi cụ thể đã gặp phải. Bộ quy tắc đầy đủ được cung cấp để người dùng sao chép và tùy chỉnh cho phù hợp với dự án của mình.
marsbit05/14 10:10
