Tháng 4/13, abmedia từng đưa tin Forrest Chang đã tổng hợp những lời phàn nàn của Karpathy từ tháng 1 về việc Claude “viết code” thành “4 quy tắc CLAUDE.md”, khi đó repo trên GitHub tích lũy 15.000 sao; đến 5/12, số sao của repo này đã vượt 126.000, trong chưa đầy 1 tháng tăng gấp 8 lần. Ngay sau đó, cộng đồng xuất hiện nhiều bản “mở rộng” thử nghiệm, trong đó bài đăng của kỹ sư Mnilax ( @Mnimiy ) vào 5/9—“Thêm 8 quy tắc trên nền 4 quy tắc để thành bản đầy đủ 12 quy tắc”—đã nhận 5.968 lượt thích, là một trong những nội dung đơn lẻ được thảo luận nhiều nhất trong cộng đồng Claude Code thời gian gần đây.
Tóm lược 4 quy tắc: Forrest Chang biến lời phàn nàn của Karpathy thành template có thể thực thi
4 quy tắc gốc của Forrest Chang (mỗi quy tắc tương ứng một kiểu thất bại mà Karpathy đã nêu tên trên X vào tháng 1):
Think Before Coding (tư duy trước khi code): Đừng đưa ra các giả định ngầm, hãy nói rõ bạn đang giả định điều gì; khi có trade-off thì trải ra để thảo luận; không chắc thì hỏi thẳng, đừng đoán; nếu có cách làm đơn giản hơn thì phải phản đối phương án phức tạp
Simplicity First (ưu tiên sự đơn giản): Viết đoạn mã nhỏ nhất có thể giải quyết vấn đề; không viết tính năng mang tính suy đoán, không trừu tượng hóa cho một đoạn code dùng một lần; kỹ sư kỳ cựu sẽ nói thiết kế quá phức tạp thì phải giản lược
Surgical Changes (thay đổi kiểu ngoại khoa): Chỉ động vào phần cần động, đừng “nhân tiện cải thiện” mã lân cận, comment, định dạng; không refactor thứ chưa hỏng; phải tương thích với phong cách hiện có
Goal-Driven Execution (thực thi theo mục tiêu): Định nghĩa tiêu chuẩn thành công, lặp đến khi được xác minh; đừng nói Claude các bước phải làm, hãy nói cho nó “thành công trông như thế nào” để nó tự loop
Tài liệu chính thức của Anthropic thực ra viết rất rõ: CLAUDE.md là file “advisory” (mang tính khuyến nghị), Claude khoảng 80% sẽ tuân thủ; sau khi vượt 200 dòng, tỷ lệ tuân thủ giảm mạnh vì các quy tắc quan trọng bị “ngập” trong nhiễu. Phương án của Forrest Chang là nén quy tắc xuống 65 dòng, 4 quy tắc, đạt “floor” (ngưỡng thấp nhất).
Mnilax thêm 8 quy tắc: bổ sung các kiểu thất bại mới của thời đại agent tháng 5/2026
Lập luận của Mnilax: những lời phàn nàn của Karpathy ở tháng 1 tập trung vào bối cảnh “Claude viết code”, nhưng hệ sinh thái Claude Code đến tháng 5 đã phát triển sang mô hình phối hợp nhiều agent, hook nối tiếp, xung đột khi tải skill, workflow nhiều bước chạy xuyên session… tức là cần bổ sung quy tắc. Dưới đây là 8 quy tắc ông thêm vào (sắp xếp theo đúng thứ tự trong nguyên văn):
Rule 5: Chỉ dùng Claude cho các tác vụ cần phán đoán (phân loại, soạn thảo, tóm tắt, trích xuất) và các quyết định mang tính quyết định chắc chắn (thử lại 503, routing, xử lý status code, chuyển đổi mang tính xác định) thì dùng code thông thường
Rule 6: Token budget không phải lời khuyên—mỗi tác vụ tối đa 4.000 tokens, mỗi session tối đa 30.000 tokens; khi tiến sát budget thì chủ động tóm tắt và khởi động lại, đừng vượt trần một cách âm thầm
Rule 7: Hai pattern code xung đột phải “nêu rõ chọn một cái” (lấy cái mới hơn, cái có nhiều test hơn), giải thích vì sao chọn, và đánh dấu cái còn lại để dọn dẹp; trộn hai pattern là lựa chọn tệ nhất
Rule 8: Trước khi viết code phải đọc hiểu—đọc các file exports, caller trực tiếp, và utility dùng chung; “trông có vẻ không liên quan (looks orthogonal)” là cách diễn đạt nguy hiểm nhất, không chắc thì phải hỏi
Rule 9: Test phải xác minh “ý định”, không chỉ xác minh “hành vi”—có thể viết một test mà khi logic nghiệp vụ thay đổi thì sẽ fail thì mới coi là đạt; nếu không, chỉ là khiến Claude tự tin, mà khả năng bảo vệ thực tế bằng 0
Rule 10: Tác vụ nhiều bước cần checkpoint—mỗi khi hoàn thành một bước phải tóm kết “đã làm gì, đã xác minh gì, còn gì”; nếu không mô tả rõ trạng thái thì đừng tiếp tục
Rule 11: Tuân theo các quy ước của codebase hiện có, dù bạn không đồng ý—snake_case thì vẫn là snake_case, class component thì vẫn là class component; nếu không tán thành thì đưa nó sang một cuộc thảo luận khác, đừng tự ý rẽ nhánh
Rule 12: Thất bại phải nói thật lớn—“migration hoàn thành” không đúng nếu bỏ qua 30 dòng dữ liệu, “test thông qua” không đúng nếu bỏ qua bất kỳ một case nào; mặc định là “chủ động phơi bày sự không chắc chắn”, đừng “che giấu sự không chắc chắn”
Mnilax cho biết ông đã tự thử trong 30 codebase, trong 6 tuần và kiểm nghiệm 12 quy tắc này; ông tuyên bố tỷ lệ lỗi giảm từ 41% xuống 3%, còn tỷ lệ tuân thủ chỉ giảm nhẹ (78% → 76%). Quan sát của bên này: các con số là kết quả do tác giả tự khai báo, chưa có xác minh độc lập; tuy nhiên nội dung của bản thân 8 quy tắc rất vững, và khớp với các điểm đau tương ứng với bối cảnh sử dụng Claude Code đa agent hiện tại (ví dụ: quản lý nhiều session trong Agent View, Multi-Agent Layer trong kiến trúc 6 lớp).
Tình huống phù hợp và khuyến nghị mang tính thực dụng
Mnilax cũng nói thẳng những việc không nên thử:
Nhiều hơn 14 quy tắc: tỷ lệ tuân thủ rơi xuống 52% (từ 76% rớt mạnh), giới hạn thực chất 200 dòng
Thay quy tắc bằng ví dụ: token của 3 ví dụ tương đương 10 quy tắc, Claude dễ overfit vào đúng một ví dụ đơn lẻ
Các chỉ dẫn trừu tượng như “Be careful / think hard / really focus”: khả năng kiểm chứng thấp, tỷ lệ tuân thủ chỉ 30%
Gọi Claude là “kỹ sư cấp cao”: identity prompt không hiệu quả khi hành vi thay đổi, chỉ mệnh lệnh dạng quy tắc mới hiệu quả
Phụ thuộc vào công cụ cụ thể: “Luôn dùng eslint” sẽ thất bại lặng lẽ khi eslint chưa cài, hãy chuyển sang cách diễn đạt trung tính về năng lực như “phù hợp với phong cách codebase có sẵn”
Khuyến nghị thực dụng của bên này: CLAUDE.md là “hợp đồng hành vi”, không phải danh sách mong muốn—mỗi quy tắc phải trả lời “quy tắc này tránh được lỗi cụ thể nào”. Nếu công việc của bạn không liên quan pipeline nhiều bước, Rule 10 (checkpoint) hầu như không liên quan; nếu codebase đã có lint ép một phong cách duy nhất, Rule 11 (phù hợp theo quán lệ) là dư thừa. Sau khi đọc 12 quy tắc, hãy giữ lại bản “gắn với những cái bẫy bạn từng gặp thực tế”, còn lại có thể xóa.
Các sự kiện có thể theo dõi tiếp theo gồm: liệu Anthropic có “chuẩn hóa” quy tắc trong CLAUDE.md (hiện tại chỉ là advisory), repo của Forrest Chang có được đưa vào khuôn mẫu khuyến nghị chính thức hay không, cộng đồng có xuất hiện các phiên bản tùy biến theo lĩnh vực cụ thể (frontend / backend / data engineering) không, và sau khi cập nhật phiên bản model Claude thì tỷ lệ tuân thủ có thay đổi không.
Bài viết này Karpathy CLAUDE.md lao lên 126K sao: bản 12 quy tắc nâng cao cho cộng đồng tổng hợp lần đầu xuất hiện tại 鏈新聞 ABMedia.
