Bài này dạy bạn viết “sổ tay dự án” để Claude không phải hỏi lại những điều cơ bản mỗi lần mở phiên mới, và cách đặt quyền để nó làm nhanh mà vẫn an toàn.
Vấn đề: mỗi phiên mới, Claude quên sạch
Claude không tự nhớ cuộc trò chuyện hôm qua. Sáng nào bạn cũng phải giải thích lại: dự án dùng công nghệ gì, chạy kiểm thử bằng lệnh nào, tên biến đặt theo kiểu nào. Giải pháp là một file văn bản tên CLAUDE.md đặt ở thư mục gốc dự án. Mỗi lần khởi động, Claude Code đọc file này trước tiên, như một bạn nhân viên mới đọc sổ tay công ty ngày đầu đi làm.
Tạo nhanh bằng /init
Gõ /init trong phiên Claude Code, nó sẽ quét dự án và soạn giúp một bản CLAUDE.md đầu tiên. Đó mới là bản nháp. Bạn phải đọc lại, xoá chỗ thừa, bổ sung điều chỉ bạn biết, ví dụ “quán chỉ nhận chuyển khoản qua VietQR, không tích hợp thẻ”.
Nên viết gì vào CLAUDE.md
- Dự án là gì, ai dùng, trong 2–3 câu.
- Công nghệ chính và cách chạy: lệnh chạy thử, lệnh kiểm thử, lệnh build.
- Quy ước: đặt tên, cấu trúc thư mục, ngôn ngữ giao diện.
- Điều cấm: không sửa thư mục nào, không thêm thư viện khi chưa hỏi.
Giữ file ngắn, khoảng một trang là đủ. File quá dài khiến những ý quan trọng chìm đi và chiếm chỗ trong ngữ cảnh mỗi lần.
# Sổ tay: Web đặt bàn quán Cà Phê Hẻm
Trang web cho khách đặt bàn qua điện thoại. Giao diện tiếng Việt.
## Cách chạy
- Chạy thử: npm run dev
- Kiểm thử: npm test
## Quy ước
- Tên biến tiếng Anh, chú thích tiếng Việt.
- Không thêm thư viện mới khi chưa hỏi tôi.
## Đừng đụng
- Thư mục /du-lieu-khach (chứa số điện thoại thật)Mẹo
Mỗi khi bạn phải nhắc Claude cùng một điều lần thứ hai, hãy ghi điều đó vào CLAUDE.md. Sổ tay tốt lớn dần từ những lần nhắc lại.
Cấu hình và quyền hạn
Ngoài CLAUDE.md, Claude Code có các file cấu hình (settings.json) cho phép khai báo hành động nào được tự động làm, hành động nào luôn phải hỏi, hành động nào bị cấm. Có cấu hình dùng chung cả nhóm đặt trong thư mục .claude của dự án, có cấu hình riêng cá nhân. Quy tắc chọn:
| Loại việc | Nên để mức | Lý do |
|---|---|---|
| Đọc file, xem trạng thái Git | Tự động cho phép | Không làm thay đổi gì |
| Chạy kiểm thử, build | Cho phép sau khi bạn đã quen | Thường vô hại nhưng tốn thời gian chờ hỏi |
| Sửa file, cài thư viện | Hỏi mỗi lần lúc đầu | Có thể gây hỏng dự án |
| Xoá file, đẩy code lên mạng, đụng dữ liệu khách | Luôn hỏi hoặc cấm | Khó hoặc không thể hoàn tác |
Danh sách tên quyền và cú pháp chính xác thay đổi theo phiên bản, nên khi cấu hình hãy làm theo https://code.claude.com/docs thay vì chép từ trí nhớ hay từ bài viết cũ.
Lưu ý
Có chế độ cho Claude tự chấp nhận mọi thao tác để chạy nhanh. Chỉ dùng khi dự án đã nằm trong Git, không chứa bí mật, và tốt nhất là trên bản sao thử nghiệm. Không bao giờ dùng trên máy chủ đang chạy khách thật.
Thử ngay
Trong dự án thử nghiệm, gõ /init. Đọc file CLAUDE.md nó tạo ra và làm ba việc: xoá một dòng thừa, thêm một quy ước của riêng bạn, thêm một điều cấm. Sau đó /clear và hỏi: “dự án này chạy kiểm thử bằng lệnh nào?” để xem nó có đọc sổ tay không.
Ghi nhớ
- CLAUDE.md là sổ tay được đọc đầu mỗi phiên; /init soạn bản nháp, bạn phải sửa lại.
- Giữ ngắn, ghi lệnh chạy, quy ước và điều cấm.
- Đặt quyền theo mức rủi ro: đọc thì thoải mái, xoá và đẩy lên mạng thì phải hỏi.
- Cú pháp cấu hình đổi theo phiên bản; tra tài liệu chính thức.