📝 CLAUDE.MD: File Duy Nhất Biến Claude Code Thành Trợ Lý Hiểu Dự Án Của Bạn
Bạn dùng Claude Code mỗi ngày nhưng mỗi phiên nó lại quên sạch mọi thứ? Có một file duy nhất giải quyết vấn đề này, và hầu hết dev chưa tận dụng hết sức mạnh của nó.
📄 CLAUDE.MD Là Gì?
CLAUDE.md là file markdown mà Claude Code đọc ngay đầu mỗi phiên làm việc. Bạn viết hướng dẫn vào đây, Claude sẽ nhớ và tuân theo xuyên suốt cả session. Không cần nhắc lại, không cần paste lại context. Đây chính là "bộ nhớ dài hạn" mà bạn kiểm soát hoàn toàn.
🏗️ 4 Cấp Độ Cấu Hình
Claude Code hỗ trợ 4 vị trí đặt CLAUDE.md, mỗi vị trí có phạm vi khác nhau:
Managed Policy nằm ở thư mục hệ thống, do IT/DevOps quản lý cho toàn tổ chức. Mọi developer trong công ty đều phải tuân theo, không ai có thể tắt được.
Project đặt tại thư mục gốc dự án (./CLAUDE.md). Đây là file chia sẻ với team qua git, chứa coding standards, architecture decisions, build commands. Chạy lệnh /init để Claude tự phân tích codebase và tạo file này cho bạn.
User nằm ở ~/.claude/CLAUDE.md, chứa preferences cá nhân áp dụng cho mọi dự án trên máy bạn.
Local là file ./CLAUDE.local.md, dành cho config cá nhân theo từng project. Nhớ thêm vào .gitignore để không commit lên repo.
📁 Rules: Chia Nhỏ Để Quản Lý Tốt Hơn
Với dự án lớn, một file CLAUDE.md duy nhất sẽ quá dài. Giải pháp là dùng thư mục .claude/rules/. Mỗi file .md trong đó xử lý một chủ đề riêng, ví dụ testing.md, api-design.md, security.md.
Điểm hay nhất là path-specific rules. Bạn thêm frontmatter paths vào đầu file, và rule đó chỉ được load khi Claude làm việc với file matching pattern. Ví dụ rule cho "src/api/**/*.ts" chỉ kích hoạt khi Claude đang sửa code API. Tiết kiệm context, tăng độ chính xác.
🔗 Import Với Cú Pháp @path
CLAUDE.md hỗ trợ cú pháp @path/to/file để import nội dung từ file khác. Bạn có thể viết @README.md hay @docs/git-workflow.md ngay trong CLAUDE.md, Claude sẽ tự động load chúng vào context. Import lồng nhau tối đa 5 cấp. Nếu repo đã có AGENTS.md cho tool khác, chỉ cần tạo CLAUDE.md với dòng @AGENTS.md là xong.
✍️ Viết Hiệu Quả: 3 Nguyên Tắc Vàng
Ngắn gọn. Target dưới 200 dòng mỗi file. File quá dài sẽ tốn context token và giảm độ tuân thủ.
Cụ thể. Viết "Dùng 2-space indentation" thay vì "Format code cho đẹp". Viết "Chạy npm test trước khi commit" thay vì "Nhớ test nhé".
Có cấu trúc. Dùng headers và bullets để nhóm các hướng dẫn liên quan. Claude đọc cấu trúc giống con người, section rõ ràng dễ follow hơn paragraph dày đặc.
🧠 Auto Memory: Claude Tự Ghi Chú
Bên cạnh CLAUDE.md do bạn viết, Claude Code còn có Auto Memory, nơi Claude tự ghi chú cho chính nó. Build commands, debugging insights, code style preferences đều được lưu tự động tại ~/.claude/projects/<project>/memory/. Mọi thứ đều là file markdown, bạn đọc, sửa, xóa thoải mái bằng lệnh /memory.
Bạn đã setup CLAUDE.md cho dự án của mình chưa? Share config hay nhất của bạn xuống comment nhé!
