claude.mdcung cấp bộ nhớ bền vững choClaude Code, ngăn chặn việc AI phải khám phá lại dự án từ đầu mỗi khi bắt đầu một phiên làm việc mới.- Tệp Markdown này hoạt động như một script khởi tạo, bổ sung ngữ cảnh quan trọng về stack công nghệ, quy ước code và các tùy chọn kiến trúc vào lời nhắc của Claude.
- Nhờ đó, Claude có thể đưa ra các phản hồi chính xác và hiệu quả hơn ngay lập tức, giảm thiểu nhu cầu điều chỉnh liên tục từ phía người dùng.
The CLAUDE.md file
claude.mdlà một tệp Markdown đặt trong thư mục gốc của dự án, đượcClaude Codetự động đọc để cung cấp ngữ cảnh bền vững cho AI.- Nội dung của
claude.mdđược thêm vào lời nhắc của Claude, giúp AI hiểu codebase, các phụ thuộc và tính năng đã triển khai ngay từ đầu. - Bạn có thể tạo tệp
claude.mdban đầu dựa trên codebase của mình bằng cách chạy lệnh/init. - Tệp
claude.mdcấp dự án nên được chia sẻ trong hệ thống kiểm soát phiên bản để đảm bảo nhất quán cho cả nhóm phát triển. - Có hai cấp độ tệp bộ nhớ: cấp dự án (trong thư mục gốc) cho thông tin dự án cụ thể và cấp người dùng (trong thư mục cấu hình) cho các tùy chọn cá nhân áp dụng cho mọi dự án.
- Khi cần Claude thực hiện một hành vi cụ thể (ví dụ: luôn sử dụng
server actions), hãy yêu cầu Claude lưu điều này vào bộ nhớ của nó để sử dụng lại trong tương lai. - Sử dụng ký hiệu
@cùng với đường dẫn tệp để Claude tham chiếu đến tài liệu hoặc các tệp cụ thể trong dự án của bạn. - Nên bắt đầu một dự án mà không có
claude.mdđể xác định những điểm mà AI liên tục cần điều chỉnh, từ đó giữ cho tệp này gọn nhẹ và chỉ chứa thông tin thiết yếu.
persistent memory— bộ nhớ bền vữngcodebase— codebasedependencies— phụ thuộcprompt— lời nhắcversion control— kiểm soát phiên bảnconfiguration folder— thư mục cấu hìnhpersonal preferences— tùy chọn cá nhânfile path— đường dẫn tệpcourse correct— điều chỉnhcontext— ngữ cảnh
Giới thiệu về claude.md
Một trong những phần hữu ích nhất của Claude Code là tệp claude.md. Tệp này cung cấp cho Claude Code bộ nhớ bền vững về dự án của bạn. Khi bạn mở Claude Code mà không có tệp claude.md, nó giống như việc nó phải bắt đầu lại từ đầu mỗi lần. Nó phải khám phá lại codebase của bạn, hiểu các dependencies (phụ thuộc) cần thiết và các feature (tính năng) đã được triển khai. Đôi khi, nó phải đưa ra các giả định (assumptions), điều này khiến chúng ta khó định hướng Claude đi đúng hướng hơn.
claude.md hoạt động như thế nào
Nhưng đó là lúc claude.md phát huy tác dụng. Đâ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 Code sẽ tự động đọc nó mỗi khi bạn bắt đầu một phiên làm việc. Nó giống như một script khởi tạo (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 thêm vào lời nhắc của bạn. Bạn có thể chạy lệnh /init, lệnh này sẽ khiến Claude tạo một tệp claude.md dựa trên codebase của bạn.
Ví dụ về claude.md và Lợi ích
Hãy cùng xem một ví dụ. Đây là một ứng dụng Next.js 15 sử dụng app router, Tailwind và Drizzle ORM. Các lệnh bao gồm: dev server, run test, lint code style, use two-space indentation (sử dụng thụt lề hai dấu cách), prefer named exports (ưu tiên export có tên), all API routes go in app/API (tất cả các API routes đều nằm trong thư mục app/API), use server actions instead of API routes where possible (sử dụng server actions thay vì API routes khi có thể). Và nó khá đơn giản. Giờ đây, nếu tôi yêu cầu Claude Code tạo một React component, nó sẽ biết cách tạo style cho component đó bằng Tailwind hoặc bất kỳ CSS framework nào khác mà tôi đang sử dụng. Chúng ta có thể thấy rằng Claude thực hiện công việc tốt hơn ngay lập tức, thay vì phải mất thời gian tìm hiểu mọi thứ từ đầu.
Phân cấp tệp bộ nhớ
Và trước khi bạn hỏi, câu trả lời là có. Bạn nên chia sẻ tệp này trong hệ thống kiểm soát phiên bản (version control) để Nhóm của bạn cùng sử dụng. Thực tế, có một hệ thống phân cấp các tệp bộ nhớ tùy thuộc vào đối tượng sử dụng. Thứ nhất, bạn có tệp claude.md cấp dự án nằm trong thư mục gốc của dự án. Thứ hai, bạn có tệp claude.md cấp người dùng nằm trong thư mục cấu hình (configuration folder) của bạn. Tệp này chỉ dành cho riêng bạn và áp dụng cho tất cả các dự án của bạn. Vì vậy, hãy đặt các tùy chọn cá nhân (preferences) của bạn vào đây, chẳng hạn như cách bạn viết code comments.
Các phương pháp hay nhất với claude.md
Thứ nhất, nếu bạn phải chỉnh sửa Claude để nó thực hiện một điều gì đó, ví dụ như luôn sử dụng server actions thay vì API routes, thì hãy yêu cầu Claude lưu điều này vào bộ nhớ (memory) để khi bạn quay lại dự án này, nó sẽ biết điều đó mỗi lần. Thứ hai, nếu bạn có tài liệu (docs) trong dự án mà bạn muốn Claude tham chiếu, chỉ cần sử dụng ký hiệu at symbol (@) cùng với đường dẫn tệp (file path). Và thứ ba, chúng tôi khuyên bạn nên bắt đầu một dự án mà không có tệp claude.md để bạn có thể thấy nơi mình phải liên tục điều chỉnh (course correct) mô hình AI. Điều này giúp tệp claude.md của bạn gọn nhẹ (compact) và chỉ chứa thông tin cần thiết mà Claude có thể làm việc. Sự khác biệt giữa một phiên làm việc Claude Code gây khó chịu và một phiên làm việc hiệu quả nằm ở ngữ cảnh, và tệp claude.md là cách bạn cung cấp ngữ cảnh đó. Hãy bắt đầu với stack của bạn, các tùy chọn cá nhân của bạn, sau đó là các lệnh (commands), và cứ thế phát triển dần.
TL;DR
claude.mdcung cấp bộ nhớ bền vững choClaude Code, ngăn chặn việc AI phải khám phá lại dự án từ đầu mỗi khi bắt đầu một phiên làm việc mới.- Tệp Markdown này hoạt động như một script khởi tạo, bổ sung ngữ cảnh quan trọng về stack công nghệ, quy ước code và các tùy chọn kiến trúc vào lời nhắc của Claude.
- Nhờ đó, Claude có thể đưa ra các phản hồi chính xác và hiệu quả hơn ngay lập tức, giảm thiểu nhu cầu điều chỉnh liên tục từ phía người dùng.
Điểm chính
claude.mdlà một tệp Markdown đặt trong thư mục gốc của dự án, đượcClaude Codetự động đọc để cung cấp ngữ cảnh bền vững cho AI.- Nội dung của
claude.mdđược thêm vào lời nhắc của Claude, giúp AI hiểu codebase, các phụ thuộc và tính năng đã triển khai ngay từ đầu. - Bạn có thể tạo tệp
claude.mdban đầu dựa trên codebase của mình bằng cách chạy lệnh/init. - Tệp
claude.mdcấp dự án nên được chia sẻ trong hệ thống kiểm soát phiên bản để đảm bảo nhất quán cho cả nhóm phát triển. - Có hai cấp độ tệp bộ nhớ: cấp dự án (trong thư mục gốc) cho thông tin dự án cụ thể và cấp người dùng (trong thư mục cấu hình) cho các tùy chọn cá nhân áp dụng cho mọi dự án.
- Khi cần Claude thực hiện một hành vi cụ thể (ví dụ: luôn sử dụng
server actions), hãy yêu cầu Claude lưu điều này vào bộ nhớ của nó để sử dụng lại trong tương lai. - Sử dụng ký hiệu
@cùng với đường dẫn tệp để Claude tham chiếu đến tài liệu hoặc các tệp cụ thể trong dự án của bạn. - Nên bắt đầu một dự án mà không có
claude.mdđể xác định những điểm mà AI liên tục cần điều chỉnh, từ đó giữ cho tệp này gọn nhẹ và chỉ chứa thông tin thiết yếu.
Từ vựng
persistent memory— bộ nhớ bền vữngcodebase— codebasedependencies— phụ thuộcprompt— lời nhắcversion control— kiểm soát phiên bảnconfiguration folder— thư mục cấu hìnhpersonal preferences— tùy chọn cá nhânfile path— đường dẫn tệpcourse correct— điều chỉnhcontext— ngữ cảnh
Nội dung chi tiết
Giới thiệu về claude.md
Một trong những phần hữu ích nhất của Claude Code là tệp claude.md. Tệp này cung cấp cho Claude Code bộ nhớ bền vững về dự án của bạn. Khi bạn mở Claude Code mà không có tệp claude.md, nó giống như việc nó phải bắt đầu lại từ đầu mỗi lần. Nó phải khám phá lại codebase của bạn, hiểu các dependencies (phụ thuộc) cần thiết và các feature (tính năng) đã được triển khai. Đôi khi, nó phải đưa ra các giả định (assumptions), điều này khiến chúng ta khó định hướng Claude đi đúng hướng hơn.
claude.md hoạt động như thế nào
Nhưng đó là lúc claude.md phát huy tác dụng. Đâ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 Code sẽ tự động đọc nó mỗi khi bạn bắt đầu một phiên làm việc. Nó giống như một script khởi tạo (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 thêm vào lời nhắc của bạn. Bạn có thể chạy lệnh /init, lệnh này sẽ khiến Claude tạo một tệp claude.md dựa trên codebase của bạn.
Ví dụ về claude.md và Lợi ích
Hãy cùng xem một ví dụ. Đây là một ứng dụng Next.js 15 sử dụng app router, Tailwind và Drizzle ORM. Các lệnh bao gồm: dev server, run test, lint code style, use two-space indentation (sử dụng thụt lề hai dấu cách), prefer named exports (ưu tiên export có tên), all API routes go in app/API (tất cả các API routes đều nằm trong thư mục app/API), use server actions instead of API routes where possible (sử dụng server actions thay vì API routes khi có thể). Và nó khá đơn giản. Giờ đây, nếu tôi yêu cầu Claude Code tạo một React component, nó sẽ biết cách tạo style cho component đó bằng Tailwind hoặc bất kỳ CSS framework nào khác mà tôi đang sử dụng. Chúng ta có thể thấy rằng Claude thực hiện công việc tốt hơn ngay lập tức, thay vì phải mất thời gian tìm hiểu mọi thứ từ đầu.
Phân cấp tệp bộ nhớ
Và trước khi bạn hỏi, câu trả lời là có. Bạn nên chia sẻ tệp này trong hệ thống kiểm soát phiên bản (version control) để Nhóm của bạn cùng sử dụng. Thực tế, có một hệ thống phân cấp các tệp bộ nhớ tùy thuộc vào đối tượng sử dụng. Thứ nhất, bạn có tệp claude.md cấp dự án nằm trong thư mục gốc của dự án. Thứ hai, bạn có tệp claude.md cấp người dùng nằm trong thư mục cấu hình (configuration folder) của bạn. Tệp này chỉ dành cho riêng bạn và áp dụng cho tất cả các dự án của bạn. Vì vậy, hãy đặt các tùy chọn cá nhân (preferences) của bạn vào đây, chẳng hạn như cách bạn viết code comments.
Các phương pháp hay nhất với claude.md
Thứ nhất, nếu bạn phải chỉnh sửa Claude để nó thực hiện một điều gì đó, ví dụ như luôn sử dụng server actions thay vì API routes, thì hãy yêu cầu Claude lưu điều này vào bộ nhớ (memory) để khi bạn quay lại dự án này, nó sẽ biết điều đó mỗi lần. Thứ hai, nếu bạn có tài liệu (docs) trong dự án mà bạn muốn Claude tham chiếu, chỉ cần sử dụng ký hiệu at symbol (@) cùng với đường dẫn tệp (file path). Và thứ ba, chúng tôi khuyên bạn nên bắt đầu một dự án mà không có tệp claude.md để bạn có thể thấy nơi mình phải liên tục điều chỉnh (course correct) mô hình AI. Điều này giúp tệp claude.md của bạn gọn nhẹ (compact) và chỉ chứa thông tin cần thiết mà Claude có thể làm việc. Sự khác biệt giữa một phiên làm việc Claude Code gây khó chịu và một phiên làm việc hiệu quả nằm ở ngữ cảnh, và tệp claude.md là cách bạn cung cấp ngữ cảnh đó. Hãy bắt đầu với stack của bạn, các tùy chọn cá nhân của bạn, sau đó là các lệnh (commands), và cứ thế phát triển dần.