CLAUDE.md: File Hướng Dẫn Nhân Viên Giúp Claude Nhớ Mọi Thứ Từ Đầu Session

Bạn đã giải thích cùng một quy tắc dự án cho Claude bao nhiêu lần rồi? CLAUDE.md giải quyết đúng chỗ đau đó.

CLAUDE.md Là Gì

CLAUDE.md là file văn bản Claude đọc tự động khi khởi động mỗi session. Không cần bạn nhắc lại context, không cần paste lại quy tắc, không cần giải thích lại cấu trúc project. Claude đọc file này trước, rồi mới làm việc với bạn.

Hãy nghĩ nó như tờ onboarding cho nhân viên mới, chỉ mà nhân viên đó là AI và đọc xong trong 0.1 giây.

Tạo Ngay Bằng /init

Mở Claude Code trong thư mục project, gõ /init. Claude tự phân tích codebase và tạo CLAUDE.md draft cho bạn. Bạn chỉ cần chỉnh lại những chỗ chưa đúng.

Đây là điểm khởi đầu, không phải bản hoàn chỉnh. /init không biết quy tắc nội bộ team bạn hay lý do tại sao bạn tránh một thư viện cụ thể.

Ghi Những Gì Claude Không Tự Đoán Được

Claude giỏi suy luận từ code, nhưng không đọc được ý bạn. Ghi vào CLAUDE.md những thứ này:

• Lệnh build/test đặc trưng: npm run dev:local thay vì npm start
• Quy tắc đặt tên: component dùng PascalCase, util function dùng camelCase
• Thư viện nên dùng: dayjs thay vì moment, zod để validate schema
• Thư viện tránh: đừng thêm lodash, đừng dùng any trong TypeScript

Đặt IMPORTANT: trước quy tắc bắt buộc. Claude xử lý nhãn này như priority cao hơn.

📍 Ba Chỗ Đặt File

~/.claude/CLAUDE.md là file global. Ghi những thứ áp dụng cho mọi project: coding style cá nhân, ngôn ngữ ưa thích.

./CLAUDE.md trong thư mục project là file team. Commit file này vào git để cả team dùng chung: lệnh setup, kiến trúc tổng quan, quy ước đặt tên.

./CLAUDE.local.md là file cá nhân trong project. Thêm vào .gitignore. Ghi path local của bạn, API key dev, hay workflow riêng.

Claude đọc cả ba, theo thứ tự đó.

Giữ File Ngắn Gọn

File dài 2000 dòng khiến Claude phân tán attention. Mục tiêu: dưới 200 dòng cho ./CLAUDE.md. Mỗi dòng là thông tin Claude không tự suy được từ code.

File Tích Lũy Giá Trị Theo Thời Gian

Lần đầu tạo, CLAUDE.md chỉ có vài dòng cơ bản. Sau mỗi lần Claude làm sai điều gì đó và bạn phải sửa, thêm quy tắc đó vào file. Sau 2-3 tháng, bạn có một file phản ánh chính xác cách team bạn làm việc.

Bạn đang dùng CLAUDE.md chưa, hay vẫn đang giải thích lại từ đầu mỗi session?

#ClaudeCode #CLAUDEmd #VibeCoding #VibeAICoder