Claude.md là gì? Hướng dẫn dễ hiểu cho người mới dùng

Claude.md là gì?

Claude.md là file cấu hình dạng markdown mà Claude Code tự động đọc ở đầu mỗi phiên làm việc, dùng để cố định quy tắc, quy ước và cách làm việc cho cả dự án.

Hiểu đơn giản, đây là "sổ nội quy" bạn đặt sẵn cho AI. Thay vì mỗi lần mở việc lại phải nhắc lại từ đầu kiểu "viết ngắn thôi nhé", "đừng tự sửa lung tung", you ghi hết các luật đó vào một file. Claude Code đọc file này trước khi bắt tay vào bất cứ việc gì, nên mọi hướng dẫn trong đó luôn ở trạng thái "luôn bật".

File đặt ở thư mục gốc của dự án, thường là ./CLAUDE.md. Nó có thể chứa cấu trúc thư mục, phong cách viết, quy trình kiểm tra, cách đặt tên và bất cứ quy ước nào bạn muốn AI tuân theo. Điểm mạnh nằm ở chỗ: viết một lần, áp dụng cho mọi cuộc trò chuyện sau đó trong dự án.

Claude.md dùng để làm gì?

Claude.md giúp cố định ngữ cảnh và quy tắc hành vi cho AI, để bạn không phải lặp lại hướng dẫn trong từng prompt và giảm tình trạng AI làm sai ý.

Có ba việc chính file này lo cho bạn. Thứ nhất là chứa quy ước dự án: cấu trúc folder, coding style, quy trình review hay test. Thứ hai là định nghĩa cách AI phản hồi: trả lời ngắn hay dài, được tự quyết hay phải hỏi lại. Thứ ba, với các hệ thống kiểu "LLM wiki", file này đóng vai trò như một bản schema mô tả wiki được tổ chức thế nào, tạo loại trang nào và cập nhật ra sao.

Nói cho dễ hình dung: viết content cho AI mà không có file quy tắc rõ ràng thì giống như gọi điện nhờ đồng nghiệp làm việc lúc 11 giờ đêm, kể một câu chuyện dài 20 phút mà không nói rõ cuối cùng bạn muốn gì. Họ sẽ làm, nhưng khả năng cao là làm sai.

"Claude.md của Andrej Karpathy" là gì mà viral khắp nơi?

Đây là một file CLAUDE.md do cộng đồng viết, chắt lọc các quan sát công khai của Andrej Karpathy về những lỗi thường gặp khi LLM viết code, không phải do chính Karpathy maintain.

Andrej Karpathy là cựu Head of AI của Tesla và đồng sáng lập OpenAI, nên mỗi nhận xét của ông về AI đều có sức nặng. Ngày 27/01/2026, ông đăng một bài chỉ ra các lỗi kinh điển khi ra lệnh cho AI Agent. Bài này đạt khoảng 7,7 triệu lượt xem [CẦN KIỂM CHỨNG con số chính xác].

Một lập trình viên tên Forest (repo thường được dẫn là multica-ai/andrej-karpathy-skills) đã hệ thống hóa các quan sát đó thành một file quy tắc duy nhất. Theo tài liệu tổng hợp, dự án đạt khoảng 179.000 sao và lọt top 35 toàn cầu trên GitHub trong chưa đầy 4 tháng.

Điều thú vị là cả file chỉ khoảng 60-70 dòng markdown thuần, không có code, không framework. Sức mạnh của nó đến từ việc biến triết lý làm việc với AI của Karpathy thành luật cứng mà Claude Code luôn đọc đầu mỗi phiên. Vâng, nghe có vẻ đơn giản đến mức khó tin. Nhưng đôi khi thứ đơn giản lại là thứ hiệu quả nhất.

Bốn nguyên tắc cốt lõi trong Claude.md của Karpathy

Bốn nguyên tắc xoay quanh việc ép AI suy nghĩ trước khi làm, giữ giải pháp đơn giản, chỉ sửa đúng chỗ và luôn có bước kiểm chứng kết quả.

Bốn nguyên tắc này không chỉ dành cho dân code. Nếu bạn dùng AI để sản xuất nội dung hay tự động hóa quy trình, chúng vẫn áp dụng được nguyên xi.

Think Before Coding - Nghĩ trước khi làm

AI hay có thói quen cầm đèn chạy trước ô tô. Nhận lệnh xong là tự đoán ý bạn rồi lao vào làm, dẫn đến kết quả lệch hướng. Nguyên tắc này ép AI dừng lại. Nếu thiếu dữ liệu đầu vào, ví dụ thiếu insight khách hàng hay chưa research đối thủ, AI bắt buộc phải hỏi ngược lại bạn thay vì tự biên tự diễn.

Simplicity First - Ưu tiên sự tối giản

Thay vì giải quyết vấn đề bằng 100 từ, AI thường vẽ rắn thêm chân thành 1000 từ. Vừa tốn token, vừa lan man, vừa dễ sinh "ảo giác". Nguyên tắc này yêu cầu nội dung phải súc tích, đi thẳng vào vấn đề và cắt bỏ phần lý thuyết dư thừa.

Surgical Changes - Chỉnh sửa trúng đích

Bạn nhờ sửa một câu, AI lại đập đi xây lại cả bài. Cách làm này dễ làm hỏng những phần vốn đang tốt và sinh lỗi mới. Nguyên tắc "phẫu thuật" buộc AI chỉ chạm vào đúng đoạn cần sửa, giữ nguyên 100% phần còn lại.

Goal-Driven Execution- Thực thi theo mục tiêu

AI thường làm xong là báo cáo hoàn thành mà không kiểm tra kết quả có dùng được chưa. Nguyên tắc này yêu cầu định nghĩa rõ "thế nào là xong". Ví dụ bạn đưa một checklist 20 tiêu chí, AI viết xong phải tự rà lại. Nếu mới đạt 17/20, nó phải tự quay lại xử lý 3 tiêu chí còn thiếu cho đến khi đủ.

Bảng dưới tóm tắt nhanh để bạn dễ ghi nhớ:

Claude.md khác gì với prompt thông thường?

Claude.md là quy tắc luôn bật cho cả dự án, trong khi prompt chỉ có tác dụng trong một lần ra lệnh và phải gõ lại mỗi lần.

Đây là khác biệt quan trọng nhất mà nhiều người mới hay nhầm. Prompt giống như bạn nhắc việc qua tin nhắn từng lần một, nhắc xong là trôi đi. Claude.md giống như bản nội quy dán trên tường văn phòng, ai vào làm cũng phải theo, không cần nhắc lại.

Vì là file markdown thuần và nằm trong dự án, bạn còn có thể commit nó vào version control. Cả team hay nhiều con AI cùng tuân thủ một bộ luật, tránh tình trạng mỗi người một kiểu. Bạn cũng có thể gộp thêm quy tắc riêng của team vào cùng file mà không phá vỡ cấu trúc gốc.

Ai nên dùng Claude.md?

Claude.md phù hợp với lập trình viên, người làm tự động hóa và cả người sản xuất nội dung muốn AI làm việc nhất quán theo quy chuẩn riêng.

Ban đầu file này sinh ra cho dân code dùng Claude Code. Nhưng tinh thần của nó vượt khỏi phạm vi lập trình. Nếu bạn là người làm marketing thường xuyên dùng AI viết bài, bạn hoàn toàn có thể tạo một file quy tắc ghi rõ giọng văn thương hiệu, độ dài mong muốn, những từ cấm dùng và checklist kiểm tra trước khi xuất bản.

Cụ thể, ba nhóm hưởng lợi rõ nhất gồm: lập trình viên muốn AI sửa code mà không phá production; người xây hệ thống tự động hóa cho doanh nghiệp cần AI tuân thủ quy trình ổn định; và đội ngũ content muốn mọi bài viết ra lò đều đúng một chuẩn, không bị "trôi phong cách" giữa các thành viên.

Cách bắt đầu dùng Claude.md trong 3 bước

Bạn chỉ cần tạo file, nạp nguyên tắc gốc rồi tự cá nhân hóa theo công việc, không cần cài phần mềm trả phí.

Bước một, tạo một file văn bản đặt tên chính xác là CLAUDE.md và để ở thư mục gốc của dự án.

Bước hai, dùng một prompt yêu cầu AI đọc file gốc của Forest trên GitHub, rồi từ 4 nguyên tắc lõi xây bộ quy tắc mới khớp với nghiệp vụ của bạn. Yêu cầu AI loại bỏ những gì không phù hợp và mỗi nguyên tắc phải kèm checklist hành động cụ thể.

Bước ba, đọc lướt bản kế hoạch AI đề xuất xem đã đúng bản chất công việc chưa. Ưng ý thì xác nhận để file chính thức đi vào hoạt động.

Một lưu ý nhỏ: đừng copy nguyên file của người khác rồi dùng luôn. File quy tắc hay nhất là file phản ánh đúng cách bạn làm việc. Nghe có vẻ hiển nhiên, nhưng phần lớn người mới đều bỏ qua bước cá nhân hóa này, rồi thắc mắc sao AI vẫn làm chưa đúng ý.

Câu hỏi thường gặp về Claude.md

Claude.md có bắt buộc phải có khi dùng Claude Code không?

Không bắt buộc. Claude Code vẫn chạy bình thường khi không có file này. Tuy nhiên, nếu bạn muốn AI làm việc nhất quán theo quy chuẩn riêng và đỡ phải nhắc lại hướng dẫn mỗi lần, Claude.md giúp ích rất nhiều.

Claude.md có phải do chính Andrej Karpathy viết không?

Không. File đang viral là sản phẩm cộng đồng, lấy cảm hứng từ các quan sát công khai của Karpathy về lỗi thường gặp của AI khi viết code. Tên gọi "Claude.md của Karpathy" chủ yếu là cách đặt tên cho dễ nhận diện.

File Claude.md nên đặt ở đâu trong dự án?

File project-level thường đặt ở thư mục gốc, dưới dạng ./CLAUDE.md hoặc ./.claude/CLAUDE.md. Ngoài ra Claude Code còn hỗ trợ file cấp người dùng ở ~/.claude/CLAUDE.md áp dụng cho mọi dự án của bạn.

Tôi không biết lập trình thì có dùng Claude.md được không?

Được. File chỉ là markdown thuần, viết bằng ngôn ngữ bình thường. Người làm content hay tự động hóa quy trình hoàn toàn có thể ghi quy tắc của mình vào đó mà không cần biết code.

Claude.md giúp tiết kiệm token như thế nào?

Vì AI không phải đọc lại hướng dẫn dài trong từng prompt và không sa đà viết dài dòng nhờ nguyên tắc tối giản. Theo các tài liệu tổng hợp, file giúp AI trả lời nhanh và gọn hơn, từ đó giảm lượng token tiêu thụ.

Claude.md có dùng được với công cụ AI khác ngoài Claude Code không?

Bản thân tên file gắn với Claude Code. Tuy nhiên tinh thần và 4 nguyên tắc bên trong có thể áp dụng cho nhiều công cụ AI khác như Cursor hay các trợ lý nội bộ, miễn là công cụ đó cho phép nạp file quy tắc đầu phiên.

Claude.md không phải phép màu. Nó chỉ là một file markdown ghi rõ luật chơi cho AI. Nhưng đúng như bản của Karpathy chứng minh, một bộ quy tắc rõ ràng và luôn bật có thể là khác biệt giữa một AI làm đúng ngay từ đầu và một AI khiến bạn phải sửa đi sửa lại.

Nếu bạn muốn đi xa hơn việc tạo file quy tắc, học cách cá nhân hóa Claude bằng Project và Skill, xây trợ lý AI tự động hóa công việc, khóa Claude AI Mastery của Vinalink Academy là nơi bạn nên xem qua. Toàn bộ bài tập thực hành trực tiếp trên công việc thật, phù hợp cả với người không biết lập trình.