andrej-karpathy-skills: bắt Claude Code bớt làm bừa, code gọn hơn — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về multica-ai/andrej-karpathy-skills — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: andrej-karpathy-skills: giúp Claude Code viết code chắc hơn — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
andrej-karpathy-skills là một file CLAUDE.md (kèm plugin cho Claude Code) gói 4 nguyên tắc để Claude Code bớt đoán mò, bớt viết thừa và không sửa lung tung ngoài yêu cầu. Bạn có thể cài bằng hai lệnh plugin hoặc tải thẳng file CLAUDE.md về dự án. Cài rất dễ, không cần lập trình thêm gì.
andrej-karpathy-skills là một bộ quy tắc ứng xử dành cho Claude Code, gói gọn trong một file CLAUDE.md. Nội dung được rút ra từ những nhận xét của Andrej Karpathy về các lỗi hay gặp khi để AI viết code. Bạn đặt file này vào dự án (hoặc cài thành plugin), và Claude Code sẽ đọc nó như một bản "nội quy" trước khi làm việc.
Vấn đề repo giải quyết rất quen thuộc. Bạn nhờ AI sửa một chỗ nhỏ, nó tự đoán ý bạn mà không hỏi, viết dài gấp mấy lần cần thiết, rồi tiện tay sửa luôn cả những đoạn bạn không nhờ. Kết quả là bạn phải ngồi đọc lại cả đống thay đổi để tìm xem cái gì đúng, cái gì thừa. Repo này nhắm đúng ba thói quen đó.
Ai nên dùng? Lập trình viên mới, người làm văn phòng hay chủ shop tự nhờ Claude Code viết script, sửa website, làm công cụ nhỏ. Điểm đáng giá nhất: bạn không phải cài phần mềm nào cả. Chỉ một file văn bản, nhưng đổi được cách Claude Code làm việc. Hiện repo có khoảng 232 nghìn sao và 23 nghìn fork, nên cộng đồng dùng khá đông.
multica-ai/andrej-karpathy-skills
Một file CLAUDE.md gồm 4 nguyên tắc, rút từ nhận xét của Andrej Karpathy, giúp Claude Code hỏi trước khi làm, code gọn và chỉ sửa đúng chỗ cần sửa.
I.andrej-karpathy-skills làm được gì
Repo đưa ra bốn nguyên tắc. Mỗi nguyên tắc nhắm vào một lỗi cụ thể của AI khi viết code.
A.Nghĩ trước khi viết
AI thường chọn đại một cách hiểu rồi chạy tiếp, không báo cho bạn biết. Nguyên tắc này buộc Claude Code phải nói rõ giả định của nó. Nếu yêu cầu có nhiều cách hiểu, nó phải đưa các cách hiểu ra thay vì tự chọn. Nếu có cách đơn giản hơn, nó được phép phản biện. Nếu thấy rối, nó phải dừng lại và hỏi.
Lợi ích thực tế: câu hỏi làm rõ đến sớm, trước khi code được viết, chứ không phải sau khi bạn đã mất thời gian sửa sai.
B.Đơn giản trước hết
Nguyên tắc này đòi viết lượng code ít nhất đủ giải quyết vấn đề. Không thêm tính năng bạn chưa nhờ. Không tạo lớp trừu tượng cho đoạn code chỉ dùng một lần. Không thêm "tùy chỉnh linh hoạt" không ai yêu cầu. Không xử lý lỗi cho những tình huống không thể xảy ra. README còn đưa ra một phép thử: nếu một kỹ sư senior thấy đoạn code quá phức tạp thì phải đơn giản hóa. Nếu 200 dòng viết được thành 50 dòng thì viết lại.
Lợi ích: code ngắn thì dễ đọc, dễ kiểm tra, ít chỗ để lỗi ẩn nấp.
C.Sửa chính xác, đúng chỗ
Khi sửa code có sẵn, Claude Code không được "tiện tay cải thiện" phần bên cạnh, comment hay định dạng. Không refactor thứ đang chạy tốt. Phải theo đúng phong cách hiện có của dự án, kể cả khi nó thích làm khác. Nếu thấy code chết không liên quan, nó chỉ báo cho bạn chứ không tự xóa. Chỉ những import, biến, hàm mà chính thay đổi của nó làm thừa thì nó mới dọn.
Phép thử ở đây: mỗi dòng thay đổi phải truy ngược được về yêu cầu của bạn. Lợi ích: khi xem diff, bạn chỉ thấy đúng những gì mình nhờ.
D.Làm theo mục tiêu kiểm chứng được
Thay vì ra lệnh kiểu "thêm validation", bạn (hoặc Claude) biến nó thành mục tiêu có thể kiểm tra. README đưa ví dụ:
- "Thêm validation" thành "viết test cho đầu vào sai, rồi làm cho test qua".
- "Sửa lỗi" thành "viết test tái hiện lỗi, rồi làm cho nó qua".
- "Refactor X" thành "đảm bảo test qua cả trước và sau khi sửa".
Với việc nhiều bước, Claude được yêu cầu nêu kế hoạch ngắn, mỗi bước kèm cách kiểm tra. Tiêu chí thành công rõ ràng thì AI tự lặp đến khi đạt. Tiêu chí mơ hồ kiểu "làm cho nó chạy" thì bạn phải hỏi đi hỏi lại.
Ngoài ra repo có kèm file CURSOR.md và một luật dự án cho Cursor, để bạn dùng cùng bộ nguyên tắc nếu làm việc trong Cursor.
II.Cần chuẩn bị gì
Tư liệu của repo nói khá ít về yêu cầu hệ thống, vì đây chỉ là file văn bản. Những gì cần chắc chắn:
- Bạn dùng Claude Code. Cả hai cách cài trong README đều dành cho Claude Code.
- Cách A (plugin) dùng lệnh gõ ngay trong Claude Code.
- Cách B (file
CLAUDE.md) dùng lệnhcurlvàechotrong terminal, nên bạn cần một terminal đang mở ở thư mục dự án. - README không nói về phiên bản Node hay Python, không yêu cầu API key, không yêu cầu GPU hay phần cứng riêng.
- README cũng không nêu hệ điều hành cụ thể. Các lệnh ở cách B là lệnh kiểu Unix, nên trên Windows bạn nên chạy trong Git Bash hoặc WSL. Đây là gợi ý của mình, README không nói.
Giấy phép: phần README ghi MIT, nhưng thông tin hệ thống lấy từ repo lại báo không rõ. Nếu bạn định dùng trong công việc nghiêm túc, hãy mở trang repo xem file giấy phép cho chắc.
III.Cài đặt từng bước
Có hai cách. Cách A cài thành plugin, dùng được ở mọi dự án. Cách B bỏ file vào từng dự án riêng. Bạn chỉ cần chọn một.
- Chọn cách càiPlugin dùng chung mọi dự án (A) hoặc file CLAUDE.md cho từng dự án (B)
- Thêm marketplaceCách A: chạy lệnh thêm marketplace trong Claude Code
- Cài pluginCách A: chạy lệnh cài plugin
- Hoặc tải CLAUDE.mdCách B: dùng curl tải file về dự án mới, hoặc nối vào file có sẵn
- Tùy chỉnhThêm quy tắc riêng của dự án vào cùng file CLAUDE.md
A.Cách A: cài thành plugin Claude Code (README khuyên dùng)
Mở Claude Code, rồi gõ lệnh sau ngay trong khung chat của nó (không phải trong terminal thường). Lệnh này thêm "kho" chứa plugin:
/plugin marketplace add forrestchang/andrej-karpathy-skillsSau đó cài plugin:
/plugin install andrej-karpathy-skills@karpathy-skillsTheo README, cách này cài bộ nguyên tắc thành một plugin và dùng được trong mọi dự án của bạn. Chỗ người mới hay vấp: hai dòng trên bắt đầu bằng dấu /, là lệnh của Claude Code, nên đừng dán vào PowerShell hay Command Prompt.
B.Cách B: dùng file CLAUDE.md cho từng dự án
Mở terminal, đi vào thư mục gốc của dự án (thư mục bạn thường mở Claude Code). Với dự án mới chưa có CLAUDE.md, tải file về:
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.mdLệnh này tải file CLAUDE.md từ repo và lưu vào thư mục hiện tại với đúng tên đó.
Với dự án đã có sẵn CLAUDE.md, đừng dùng lệnh trên vì nó sẽ ghi đè file cũ. Hãy dùng cách nối thêm vào cuối:
echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.mdDòng đầu thêm một dòng trống vào cuối file hiện có cho dễ đọc. Dòng sau tải nội dung về và nối tiếp vào cuối file. Dấu >> là nối thêm, còn dấu > đơn là ghi đè, nên đừng gõ nhầm.
Cách B ghi vào file CLAUDE.md của dự án. Nếu file đó có quy tắc quan trọng của team, hãy sao lưu trước khi chạy lệnh. Dùng đúng lệnh nối thêm (>>) cho dự án đã có file.
C.Thêm quy tắc riêng cho dự án (không bắt buộc)
README cho biết bộ nguyên tắc này được thiết kế để gộp chung với hướng dẫn riêng của dự án. Bạn mở CLAUDE.md và thêm một mục như ví dụ của tác giả:
## Project-Specific Guidelines
- Use TypeScript strict mode
- All API endpoints must have tests
- Follow the existing error handling patterns in `src/utils/errors.ts`Đây chỉ là ví dụ về cách viết. Đường dẫn src/utils/errors.ts là của dự án mẫu, bạn thay bằng quy tắc và đường dẫn của dự án mình.
IV.Kiểm tra đã chạy được chưa
README không có lệnh kiểm tra cài đặt, và nó cũng không nói rõ màn hình sẽ hiện gì sau khi cài plugin. Cách an toàn là kiểm tra theo từng cách:
- Cách B: mở thư mục dự án, kiểm tra file
CLAUDE.mdđã có và có nội dung bốn nguyên tắc (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution). - Cách A: nếu hai lệnh
/pluginchạy xong không báo lỗi thì coi như đã cài. Muốn chắc hơn, bạn xem danh sách plugin trong Claude Code. Cách xem danh sách README không ghi, nên bạn xem tài liệu của Claude Code.
Sau khi cài, cách tốt nhất là xem hành vi thật. README liệt kê bốn dấu hiệu cho thấy bộ nguyên tắc đang có tác dụng:
- Diff có ít thay đổi thừa hơn, chỉ còn những thay đổi bạn yêu cầu.
- Ít phải viết lại vì code quá phức tạp, ngay lần đầu code đã gọn.
- Câu hỏi làm rõ xuất hiện trước khi làm, không phải sau khi sai.
- Pull request gọn, không có "cải thiện tiện tay".
V.Dùng vào việc thật
Bộ nguyên tắc không có lệnh riêng để gõ. Nó tác động ngầm lên mọi yêu cầu bạn đưa cho Claude Code. Dưới đây là vài tình huống để thấy rõ khác biệt. Các prompt là ví dụ của mình, còn hành vi mong đợi bám theo bốn nguyên tắc trong README.
Đừng bảo AI phải làm gì. Hãy cho nó tiêu chí thành công rồi xem nó tự chạy.
Ông T
A.Chủ shop nhờ sửa một lỗi nhỏ trên script xuất đơn hàng
Bối cảnh: bạn có một script xuất đơn hàng ra file, thỉnh thoảng bị lỗi khi tên khách có dấu. Bạn không rành code, chỉ muốn lỗi hết.
Câu lệnh mẫu:
Script xuất đơn bị lỗi khi tên khách có dấu tiếng Việt. Hãy viết một test tái hiện lỗi này, rồi sửa cho test qua. Đừng đụng đến phần khác của script.Đây là nguyên tắc Goal-Driven Execution kết hợp Surgical Changes. Kết quả mong đợi: Claude tái hiện lỗi trước, sửa đúng chỗ gây lỗi, và diff chỉ có vài dòng liên quan. Bạn đọc lướt là hiểu.
B.Nhân viên văn phòng nhờ viết công cụ nhỏ, yêu cầu còn mơ hồ
Bối cảnh: bạn muốn một script gộp nhiều file báo cáo lại, nhưng chưa rõ mình muốn gộp theo tuần hay theo tháng.
Câu lệnh mẫu:
Mình cần script gộp các file báo cáo trong một thư mục thành một file tổng.Với nguyên tắc Think Before Coding, Claude được kỳ vọng nêu giả định hoặc hỏi lại những điểm chưa rõ như định dạng file, gộp theo tiêu chí nào, trước khi viết. Bạn trả lời vài câu ngắn, thay vì nhận về một chương trình làm sai ý rồi phải giải thích lại từ đầu.
C.Lập trình viên mới nhờ thêm tính năng vào dự án có sẵn
Bối cảnh: bạn vừa nhận một dự án nhỏ và nhờ Claude thêm chức năng kiểm tra dữ liệu nhập vào.
Câu lệnh mẫu:
Thêm kiểm tra cho ô nhập email. Viết test cho các email sai trước, rồi làm cho test qua. Giữ nguyên phong cách code hiện có.Kết quả mong đợi theo README: code thêm vào ngắn gọn, không kéo theo lớp trừu tượng hay tùy chọn cấu hình bạn không xin. Nếu Claude thấy đoạn code chết không liên quan, nó chỉ nhắc bạn chứ không tự xóa. Nhờ vậy pull request sạch, người review dễ duyệt.
D.Dùng với yêu cầu nhiều bước
Bối cảnh: bạn giao một việc dài hơn, ví dụ tái cấu trúc một module.
Câu lệnh mẫu:
Tái cấu trúc module tính phí vận chuyển. Hãy nêu kế hoạch ngắn, mỗi bước kèm cách kiểm tra, và đảm bảo test qua cả trước lẫn sau khi sửa.README mô tả định dạng kế hoạch như sau, bạn có thể yêu cầu Claude trình bày theo đúng khuôn này:
1. [Step] → verify: [check]
2. [Step] → verify: [check]
3. [Step] → verify: [check]Bạn duyệt kế hoạch trước, thấy ổn rồi mới cho chạy. Mỗi bước có cách kiểm tra riêng nên bạn biết ngay bước nào hỏng.
VI.Lỗi hay gặp và cách xử lý
README không có mục xử lý lỗi, nên các mục dưới đây là những lỗi dễ xảy ra với loại công cụ này, theo suy luận của mình.
A.Gõ lệnh /plugin trong terminal thường
Hai lệnh /plugin ... chỉ chạy được bên trong Claude Code. Nếu bạn dán vào PowerShell hay Command Prompt, sẽ báo không nhận ra lệnh. Hãy mở Claude Code trước, rồi gõ lệnh trong khung chat của nó.
B.Lệnh curl hoặc echo không chạy trên Windows
Lệnh ở cách B là kiểu Unix. Trên Windows, nếu terminal báo lỗi, hãy thử chạy trong Git Bash hoặc WSL. Cách khác an toàn hơn: mở trang repo, mở file CLAUDE.md, sao chép nội dung và tự dán vào file CLAUDE.md của dự án.
C.Ghi đè mất CLAUDE.md cũ
Lệnh curl -o CLAUDE.md ... ghi đè file cùng tên. Nếu dự án đã có quy tắc riêng, hãy dùng cách nối thêm với >>. Còn nếu lỡ ghi đè, và dự án dùng Git, bạn có thể khôi phục từ lịch sử Git. Thói quen tốt là sao lưu file trước khi chạy.
D.Cài xong nhưng Claude Code vẫn làm như cũ
Có thể file CLAUDE.md nằm sai thư mục. Hãy chắc chắn nó nằm ở thư mục gốc dự án, đúng nơi bạn mở Claude Code. Sau đó thử bắt đầu một phiên mới và đưa một yêu cầu hơi mơ hồ, xem Claude có hỏi lại không. Cũng nên nhớ đây là hướng dẫn cho AI, không phải cơ chế ép buộc tuyệt đối, nên đôi lúc nó vẫn có thể bỏ sót. Khi đó bạn nhắc thẳng: "Theo nguyên tắc trong CLAUDE.md, hãy chỉ sửa đúng phần mình yêu cầu".
E.Claude hỏi quá nhiều với việc nhỏ
README thừa nhận bộ nguyên tắc nghiêng về thận trọng hơn là tốc độ. Với việc vặt như sửa lỗi chính tả hay một dòng hiển nhiên, bạn cứ nói rõ là làm nhanh, không cần quy trình đầy đủ.
VII.Có nên dùng không
Điểm mạnh lớn nhất là chi phí gần bằng không: một file văn bản, cài trong vài giây, gỡ bỏ cũng dễ. Bốn nguyên tắc rõ ràng, dễ hiểu, và đánh trúng những điều phiền toái nhất khi làm việc với AI viết code: đoán mò, viết thừa, sửa lan. Bạn cũng dễ gộp nó với quy tắc riêng của dự án, và có sẵn phiên bản dùng cho Cursor.
Giới hạn cần nói thẳng. Đây là chỉ dẫn bằng chữ, không phải công cụ kiểm tra tự động, nên kết quả phụ thuộc vào cách Claude Code đọc và tuân theo. README không đưa số liệu đo hiệu quả, chỉ nêu dấu hiệu bạn tự quan sát. Bộ nguyên tắc cũng thiên về thận trọng, nên với việc đơn giản nó có thể làm bạn thấy chậm hơn một chút. Ngoài ra, repo hiện khá lâu chưa cập nhật, và thông tin giấy phép giữa README với hệ thống chưa khớp nhau, nên bạn nên tự xem lại trước khi dùng trong công việc chính thức.
Khi nào nên chọn cách khác? Nếu bạn cần quy tắc rất riêng cho ngành hoặc framework của mình, hãy tự viết CLAUDE.md và coi repo này như phần nền. Nếu bạn không dùng Claude Code hay Cursor, repo này gần như không có ích. Còn nếu bạn đang dùng Claude Code và hay thấy nó làm quá tay, thì đây là thứ đáng thử đầu tiên.
Câu hỏi thường gặp
andrej-karpathy-skills có miễn phí không?
README ghi giấy phép MIT, và bản thân repo chỉ là một file CLAUDE.md nên không có phí cài đặt nào được nhắc tới. Tuy nhiên thông tin giấy phép lấy từ repo lại báo không rõ, nên bạn nên mở file giấy phép trên trang repo để chắc chắn. Chi phí dùng Claude Code là chuyện riêng, tư liệu không đề cập.
Cài có cần API key hay GPU không?
README không yêu cầu API key, GPU hay phần cứng riêng nào cho repo này. Cả hai cách cài chỉ gồm lệnh plugin trong Claude Code hoặc tải một file văn bản về dự án.
Chạy trên Windows được không?
README không nói riêng về hệ điều hành. Cách A (plugin) là lệnh gõ trong Claude Code. Cách B dùng lệnh curl và echo kiểu Unix, nên trên Windows bạn nên chạy trong Git Bash hoặc WSL, hoặc tự sao chép nội dung file CLAUDE.md vào dự án.
Nên chọn cài plugin hay dùng file CLAUDE.md?
README khuyên dùng cách plugin (Option A) vì nó áp dụng cho mọi dự án của bạn. Cách file CLAUDE.md (Option B) áp dụng riêng cho từng dự án, phù hợp khi bạn muốn nhóm cùng dùng chung quy tắc trong thư mục dự án.
Bộ nguyên tắc này khác gì việc tự viết CLAUDE.md?
Nó là một file CLAUDE.md viết sẵn, gồm bốn nguyên tắc rút từ nhận xét của Andrej Karpathy về lỗi hay gặp của AI khi viết code. Bạn vẫn có thể thêm quy tắc riêng của dự án vào cùng file, README còn đưa ví dụ cách thêm mục Project-Specific Guidelines.
Có dùng được với Cursor không?
Có. README cho biết repo kèm một luật dự án cho Cursor (.cursor/rules/karpathy-guidelines.mdc) và file CURSOR.md hướng dẫn cách thiết lập, cách dùng luật này trong dự án khác. Chi tiết nằm trong file CURSOR.md của repo.
Làm sao biết bộ nguyên tắc đang có tác dụng?
README nêu bốn dấu hiệu: diff ít thay đổi thừa, ít phải viết lại vì code quá phức tạp, câu hỏi làm rõ đến trước khi làm, và pull request gọn không có chỉnh sửa tiện tay. README không đưa số liệu đo, nên bạn tự quan sát qua công việc thật.


