Vấn đề: nhắc lại quy ước mỗi phiên
Mỗi lần mở Claude Code trên một dự án, bạn lại phải giải thích: dùng package manager nào, đặt file ở đâu, quy ước đặt tên ra sao, chạy test thế nào. Lặp lại điều này mỗi phiên vừa tốn thời gian vừa dễ quên.
CLAUDE.md giải quyết đúng chuyện đó: một file ở gốc dự án mà Claude Code tự đọc, chứa những gì nó cần biết để làm việc đúng cách.
Nên viết gì trong CLAUDE.md
Giữ ngắn gọn, tập trung vào thứ không đoán được từ code:
- Lệnh thường dùng: cài đặt, chạy dev, chạy test, build.
- Quy ước: cấu trúc thư mục, cách đặt tên, style code.
- Ràng buộc: điều bắt buộc giữ (public API, schema), điều cấm.
- Bối cảnh kiến trúc: các module chính và ranh giới giữa chúng.
Tránh nhồi mọi thứ — file quá dài làm loãng ngữ cảnh. Ưu tiên thông tin giúp Claude ra quyết định đúng.
Ví dụ thực tế
Một team Việt Nam làm app Next.js đặt trong CLAUDE.md: "dùng pnpm; component đặt trong components/ kebab-case; luôn chạy pnpm typecheck trước khi coi là xong; không sửa db/schema.ts trừ khi được yêu cầu rõ". Kết quả: Claude Code bám quy ước ngay từ prompt đầu, ít phải sửa lại.
Bước tiếp theo
Tạo một CLAUDE.md tối giản cho một dự án bạn hay dùng, ghi 5–10 điều quan trọng nhất, rồi bổ sung dần mỗi khi thấy Claude Code đoán sai một quy ước. File này lớn lên cùng dự án.