File CLAUDE.md

Một trong những tính năng hữu ích nhất của Claude Code là file CLAUDE.md. Nó mang lại cho Claude Code bộ nhớ bền vững về project của bạn.

Vấn đề nó giải quyết

Khi mở Claude Code mà không có file CLAUDE.md, nó bắt đầu lại từ đầu mỗi lần. Nó phải khám phá lại codebase, tìm hiểu cần dependency nào, và hiểu những tính năng nào đã có sẵn. Đôi khi nó đưa ra giả định, khiến việc định hướng Claude khó khăn hơn.

CLAUDE.md giải quyết vấn đề này. Đây là một file Markdown bạn thêm vào thư mục gốc của project, và Claude Code tự động đọc nó mỗi khi bắt đầu một phiên làm việc. Hãy nghĩ về nó như một kịch bản onboarding cho codebase của bạn. Nội dung file CLAUDE.md được nối thêm vào prompt của bạn.

Ví dụ

Đây là một file CLAUDE.md điển hình:

# Project

This is a Next.js 15 app using the App Router, Tailwind, and Drizzle ORM.

# Commands
- Dev server: `pnpm dev`
- Run tests: `pnpm test`
- Lint: `pnpm lint`

# Code Style
- Use 2-space indentation
- Prefer named exports
- All API routes go in app/api/
- Use server actions instead of API routes where possible

Rất đơn giản. Giờ nếu bạn yêu cầu Claude Code tạo một React component, nó đã biết dùng Tailwind để styling và tuân theo quy ước code của bạn.

Một file CLAUDE.md mở trong VS Code.

CLAUDE.md dành cho cả team

Bạn có thể (và nên) commit file CLAUDE.md vào version control để cả team hưởng lợi. Thực tế có một hệ thống phân cấp các file bộ nhớ, tùy vào đối tượng sử dụng:

• CLAUDE.md cấp project nằm ở thư mục gốc của project. Dùng chung cho cả team.
• CLAUDE.md cấp user nằm trong thư mục cấu hình cá nhân của bạn. File này chỉ dành cho bạn và áp dụng cho mọi project. Đặt các sở thích cá nhân ở đây.

Mẹo dùng

Lưu lại các lần sửa sai vào bộ nhớ. Nếu bạn thấy mình liên tục phải sửa Claude - chẳng hạn luôn phải nhắc nó dùng server action thay vì API route - hãy yêu cầu Claude lưu tường minh quy tắc đó vào bộ nhớ. Lần sau mở project, nó sẽ biết ngay.

Yêu cầu Claude lưu quy tắc vào CLAUDE.md - ở đây là “luôn dùng server action thay vì API route”.

Tham chiếu tài liệu project. Nếu project của bạn có tài liệu mà bạn muốn Claude tham khảo, dùng ký hiệu @ kèm đường dẫn file:

## README.md

Please read if you need more info: @README.md

Bắt đầu không có CLAUDE.md. Chúng tôi khuyên bạn nên bắt đầu project mà chưa có CLAUDE.md, để thấy được những chỗ bạn liên tục phải sửa hướng cho model. Điều này giúp CLAUDE.md của bạn gọn gàng, chỉ tập trung vào những thông tin thực sự cần thiết. Khi sẵn sàng, chạy /init để Claude tự sinh ra một file cho bạn.

Tóm tắt

Sự khác biệt giữa một phiên Claude Code khó chịu và một phiên hiệu quả thường nằm ở ngữ cảnh - và file CLAUDE.md chính là cách bạn cung cấp ngữ cảnh đó. Bắt đầu với stack công nghệ, sở thích, và các lệnh của bạn, rồi xây dựng dần từ đó.

Xem thêm: Bộ nhớ với CLAUDE.md

Nguồn

Dịch từ bài giảng “The CLAUDE.md file”, khóa Claude Code 101 trên Claude Academy.