Mở một phiên Claude Code mới, bạn lại phải dặn từ đầu: đừng đụng vào thư mục kia, kiểm xong hẵng lưu, nói cho dễ hiểu. Hôm qua dặn rồi, hôm nay nó quên sạch. Không phải nó lơ đãng đâu: mỗi phiên Claude Code bắt đầu với cửa sổ ngữ cảnh trống. CLAUDE.md là cách để bạn khỏi dặn lại. Phần kiến thức trong bài tổng hợp từ trang tài liệu chính thức của Claude Code về cách nó nhớ dự án (đọc ngày 21/10/2026). Xen giữa là một chuyện thật từ dự án vận hành website của CuongVibe.
CLAUDE.md là gì?
CLAUDE.md là một file chữ thường mà bạn tự viết để dặn Claude Code những điều lâu dài về dự án hoặc về cách bạn làm việc. Claude đọc file này ở đầu mỗi phiên, nên bạn không phải nhắc lại cùng một lời dặn mỗi lần mở máy.
Vì sao cần nó? Mỗi phiên Claude Code bắt đầu với cửa sổ ngữ cảnh trống. Cửa sổ ngữ cảnh là lượng chữ Claude đọc được trong một lần trò chuyện; đóng phiên là những gì bạn dặn trong đó cũng đi theo. Thứ gì muốn Claude nhớ qua các phiên thì phải nằm trong một file nó tự đọc, và CLAUDE.md là file đó.
Chữ “markdown” nghe kỹ thuật vậy thôi, thật ra là file chữ thường có thêm vài dấu # để làm tiêu đề, mở bằng trình soạn chữ có sẵn trên máy cũng sửa được. Nếu bạn chưa rõ Claude Code là gì, đọc trước bài Claude Code là gì.
CLAUDE.md khác gì bộ nhớ tự động của Claude Code?
Claude Code có hai cách nhớ giữa các phiên. CLAUDE.md là phần bạn tự viết. Bộ nhớ tự động (auto memory) là ghi chú Claude tự viết, dựa trên những lần bạn sửa nó và thói quen của bạn. Một bên là luật bạn đặt ra, một bên là điều Claude tự rút ra.
- CLAUDE.md: bạn viết, bạn sửa, bạn biết chắc trong đó có gì.
- Bộ nhớ tự động: Claude ghi, theo những gì nó thấy bạn hay sửa. Tiện, nhưng ghi gì là do Claude tự rút ra.
Luật nào bạn muốn chắc chắn có mặt ở mọi phiên thì tự ghi vào CLAUDE.md, đừng trông chờ Claude tự nhớ.
Đặt file CLAUDE.md ở đâu?
File của dự án đặt ngay ở thư mục gốc của dự án, tên CLAUDE.md, hoặc trong thư mục con .claude. Còn thói quen riêng của bạn, áp cho mọi dự án, thì đặt ở ~/.claude/CLAUDE.md. Cách nhanh nhất để có file đầu tiên là gõ /init.
Cụ thể hơn:
- File của dự án:
./CLAUDE.mdhoặc./.claude/CLAUDE.md. Dấu./nghĩa là ngay trong thư mục dự án đang mở. - File cá nhân:
~/.claude/CLAUDE.md. Dấu~là thư mục người dùng của bạn trên máy, file này áp cho mọi dự án bạn mở.
Về lệnh /init: gõ trong phiên Claude Code, nó tự tạo một file CLAUDE.md khởi đầu. Nếu dự án đã có file rồi, /init đề xuất chỗ cải thiện chứ không ghi đè. Bản nó tạo ra là bản nháp: đọc lại một lượt, dòng nào không đúng với cách bạn làm thì xoá.
Nên viết gì vào CLAUDE.md?
Viết những gì bạn sẽ phải giải thích lại nếu không ghi ra. Tài liệu chính thức gợi ý hai lúc nên thêm một dòng: khi Claude mắc cùng một lỗi lần thứ hai, và khi bạn phải gõ lại đúng lời dặn đã gõ ở phiên trước.
Về nội dung, tài liệu gợi ý những thứ áp cho bất kỳ ai làm trong dự án. Dịch sang việc đời thường của người không biết code:
- Lệnh build và test (lệnh dựng và kiểm thử): ví dụ xem trước website bằng lệnh nào, kiểm lỗi bằng lệnh nào trước khi lưu.
- Chuẩn viết code: với bạn có thể là chuẩn của sản phẩm, như “bài viết nào cũng phải có ảnh bìa và mô tả ngắn”.
- Quyết định kiến trúc: những chuyện đã chốt, như “ảnh để chung một thư mục”, để Claude khỏi đề xuất lại cách khác.
- Cách đặt tên: tên file, tên thư mục theo một kiểu, ví dụ “tên file viết thường, nối bằng gạch ngang”.
- Quy trình hay dùng: các bước bạn làm đi làm lại, như “viết xong bài thì đưa bạn duyệt rồi mới đăng”.
Một lỗi Claude Code mắc đi mắc lại
Lời khuyên “lỗi lặp lại thì thêm một dòng” nghe đơn giản, nhưng nó đến từ đúng loại chuyện như thế này.
Chuyện này xảy ra ngay trong dự án mình dùng để vận hành mấy website. Mình cần Claude Code lấy khoá Linear API trong file .env của dự án, nhưng nó cứ quên suốt, mặc định dùng kết nối có sẵn của tài khoản. Lỗi đó lặp đi lặp lại nhiều lần, tới khi mình ghi hẳn thành một luật trong CLAUDE.md thì nó mới nhớ.
Ghi đúng một luật cụ thể, kiểm được, là đủ để chặn một lỗi đã lặp nhiều lần. Và lợi ích không dừng ở luật:
Cái mình được nhiều nhất là mở phiên mới không phải ngồi nhớ lại dự án đang tới đâu. Có file này, mình kiểm được trạng thái và tiến độ dự án rất nhanh, không sợ quên hay nhầm khi đang làm cùng lúc nhiều dự án.
Nếu bạn tò mò một người làm sao vận hành nhiều dự án cùng lúc, xem bài doanh nghiệp một người là gì.
Một file CLAUDE.md thật chia những nhóm nào?
Lấy ví dụ file CLAUDE.md của hệ thống vận hành mấy website, trong đó có CuongVibe. File này chia thành các nhóm: dự án là gì, ranh giới không bao giờ vượt, cách làm một việc từ đầu tới cuối, kiểm tra bắt buộc trước khi báo xong, và cách nói chuyện với chủ dự án.
- Dự án là gì: vài câu tả dự án làm gì, ai là chủ, dùng công cụ gì. Claude đọc phần này để hiểu đang làm cho ai.
- Ranh giới không bao giờ vượt: những điều cấm tuyệt đối, kiểu “không sửa thư mục của dự án khác”, “không đăng bài khi chủ dự án chưa duyệt”.
- Cách làm một việc: thứ tự từ lúc nhận việc tới lúc báo xong, kiểu “nêu kế hoạch trước khi làm”, “chỉ commit khi chủ dự án bảo”.
- Kiểm tra bắt buộc: những lệnh kiểm phải chạy trước khi được nói “xong”.
- Cách nói chuyện với chủ dự án: “nói đời thường, thuật ngữ thì kèm chú thích”, “không tự bịa số liệu, thiếu thì để trống và nói rõ”.
Để ý là nhóm nào cũng viết thành câu ngắn, làm được hoặc kiểm được, không có câu kiểu “hãy cẩn thận”. Mục sau nói vì sao.
Viết thế nào để Claude làm theo?
Ba điều tài liệu chính thức nhấn mạnh: viết lời dặn cụ thể tới mức kiểm được, giữ mỗi file CLAUDE.md dưới 200 dòng, và đừng để hai lời dặn mâu thuẫn nhau. Lời dặn mơ hồ, file quá dài hay luật đá nhau đều làm Claude làm theo kém đi.
- Cụ thể tới mức kiểm được. Tài liệu lấy ví dụ: viết “chạy npm test trước khi commit” thay vì “kiểm tra thay đổi” (commit là lưu lại một mốc thay đổi). Đời thường hơn: “mỗi bài có một ảnh bìa” thì kiểm được, “làm bài cho đẹp” thì không.
- Dưới 200 dòng mỗi file. File dài tốn chỗ trong cửa sổ ngữ cảnh hơn, và Claude làm theo kém hơn. Dài quá thì cắt những dòng không còn đúng.
- Không mâu thuẫn. Hai lời dặn đá nhau thì Claude có thể chọn tuỳ ý một cái. Khi đổi ý, sửa dòng cũ chứ đừng thêm một dòng mới chồng lên.
Vì sao Claude vẫn không làm theo CLAUDE.md?
Vì Claude coi CLAUDE.md là ngữ cảnh, không phải cấu hình bắt buộc. Nó đọc và cố làm theo, nhưng không có gì đảm bảo nó tuân thủ tuyệt đối, nhất là với lời dặn mơ hồ hoặc mâu thuẫn nhau. Có hai việc bạn làm được.
Kiểm xem file đã được nạp chưa. Gõ /context trong phiên, rồi xem danh sách dưới mục Memory files. Không thấy CLAUDE.md trong đó thì xem lại chỗ đặt file ở mục trên.
Việc phải chạy đúng lúc thì dùng hook. Hook là một lệnh tự chạy ở một thời điểm cố định, ví dụ trước mỗi lần commit hay sau mỗi lần sửa file. Hook chạy bất kể Claude quyết định thế nào. Nên chia thế này: điều nên làm thì ghi vào CLAUDE.md, điều bắt buộc phải xảy ra thì nhờ Claude dựng thành hook.
Nói thẳng: CLAUDE.md giúp Claude nhớ, nhưng không biến lời dặn thành khoá cứng.
Câu hỏi thường gặp
Không biết code có tự viết CLAUDE.md được không?
Được. CLAUDE.md là file chữ thường, mở bằng trình soạn chữ có sẵn trên máy là sửa được. Hoặc gõ /init để Claude tạo bản đầu tiên, rồi bạn bảo nó sửa bằng lời: “thêm luật này”, “xoá dòng kia”. Nếu dự án đã có file, /init chỉ đề xuất chỗ cải thiện chứ không ghi đè.
Làm sao biết Claude đã đọc file CLAUDE.md?
Gõ /context trong phiên Claude Code rồi xem danh sách dưới mục Memory files. Có tên file trong đó nghĩa là file đã được nạp.
Có bắt buộc phải có CLAUDE.md không?
Không bắt buộc. Nhưng mỗi phiên Claude Code bắt đầu với cửa sổ ngữ cảnh trống, nên không có file thì lời dặn nào bạn cũng phải nói lại từ đầu mỗi lần.
Bắt đầu từ một file ngắn
Đừng cố viết cho đủ ngay từ đầu. Vài dòng là được: những ranh giới bạn không muốn Claude vượt, và một hai thói quen làm việc. Sau đó, mỗi lần phải dặn lại cùng một chuyện thì thêm một dòng. Nếu bạn muốn dùng Claude cho cả việc hằng ngày ngoài làm website, xem thêm bài Claude.ai làm trợ lý mỗi ngày.

