The CLAUDE.md file

Giới thiệu về CLAUDE.md

Một trong những thành phần hữu ích nhất của Claude chính là tệp CLAUDE.md. Tệp này cung cấp cho Claude khả năng ghi nhớ duy trì về dự án của bạn. Khi bạn bắt đầu một phiên làm việc với Claude mà không có tệp CLAUDE.md, mô hình sẽ phải bắt đầu lại từ đầu mọi lúc. Nó phải tự khám phá lại codebase, tìm hiểu các dependency cần thiết và xác định các tính năng đã được triển khai. Đôi khi, Claude phải đưa ra các giả định, điều này khiến chúng ta khó điều hướng mô hình đi đúng hướng mong muốn.

Đó là lý do CLAUDE.md ra đời. Đây là một tệp Markdown mà bạn thêm vào thư mục gốc của dự án và Claude sẽ tự động đọc nó mỗi khi bạn bắt đầu một phiên làm việc. Nó đóng vai trò như một tài liệu hướng dẫn (onboarding script) cho codebase của bạn. Nói một cách đơn giản, nội dung của tệp CLAUDE.md sẽ được đính kèm vào chính prompt của bạn.

Bắt đầu với lệnh /init

Bạn có thể chạy lệnh /init để Claude tự động tạo tệp CLAUDE.md dựa trên codebase hiện tại. Hãy xem xét ví dụ về một ứng dụng Next.js 15 sử dụng App Router, Tailwind CSS và Drizzle ORM. Tệp này có thể bao gồm:

• Lệnh (Commands): Chạy dev server, chạy test, lint.
• Phong cách lập trình (Code Style): Sử dụng thụt lề 2 khoảng trắng, ưu tiên named exports.
• Kiến trúc (Architecture): Tất cả các API route nằm trong app/api, ưu tiên sử dụng Server Actions thay vì API route nếu có thể.

Mọi thứ rất trực quan. Giờ đây, nếu tôi yêu cầu Claude tạo một React component, nó đã biết cách áp dụng style bằng Tailwind hoặc bất kỳ CSS framework nào tôi đang dùng. Claude sẽ hoàn thành công việc tốt hơn ngay từ đầu thay vì phải mất thời gian tìm hiểu thủ công cấu trúc mọi thứ.

Phân cấp các tệp bộ nhớ

Bạn có thể chia sẻ tệp này lên hệ thống quản lý phiên bản (version control) để cả nhóm cùng sử dụng. Tuy nhiên, thực tế có một cấu trúc phân cấp cho các tệp bộ nhớ tùy thuộc vào đối tượng sử dụng:

1. Cấp độ Dự án (Project Level): Tệp CLAUDE.md nằm ở thư mục gốc của dự án.
2. Cấp độ Người dùng (User Level): Tệp CLAUDE.md nằm trong thư mục cấu hình cá nhân của bạn. Tệp này chỉ dành riêng cho bạn và áp dụng trên tất cả các dự án. Bạn nên đưa các sở thích cá nhân vào đây, ví dụ như cách bạn muốn viết chú thích (comment) trong mã nguồn.

Mẹo quản lý ngữ cảnh hiệu quả

Để tận dụng tối đa bộ nhớ của Claude, hãy áp dụng ba mẹo sau:

• Lưu trữ tường minh (Explicit Saving): Nếu bạn phải điều chỉnh Claude để thực hiện một việc gì đó—chẳng hạn như luôn sử dụng Server Actions thay vì API route—hãy yêu cầu Claude lưu trực tiếp điều này vào bộ nhớ. Điều này đảm bảo rằng khi bạn quay lại dự án, Claude sẽ luôn ghi nhớ quy tắc đó.
• Tham chiếu tài liệu: Nếu bạn có các tài liệu trong dự án muốn Claude tham khảo, chỉ cần sử dụng ký hiệu @ kèm theo đường dẫn tệp.
• Tinh chỉnh dần dần (Iterative Refinement): Chúng tôi khuyên bạn nên bắt đầu dự án mà chưa cần tệp CLAUDE.md. Điều này giúp bạn nhận ra những điểm nào mình thường xuyên phải uốn nắn mô hình. Thói quen này giúp tệp CLAUDE.md luôn gọn nhẹ, chỉ chứa những thông tin thực sự cần thiết để Claude làm việc hiệu quả.

Kết luận

Sự khác biệt giữa một phiên làm việc với AI gây ức chế và một phiên làm việc năng suất nằm ở ngữ cảnh (context). Tệp CLAUDE.md chính là cách bạn cung cấp ngữ cảnh đó. Hãy bắt đầu với tech stack, các tùy chỉnh ưu tiên, các câu lệnh của bạn và tiếp tục bồi đắp từ đó trong quá trình làm việc.