Tại sao Claude của bạn thường xuyên “ngáo” khi vào dự án mới?
Nếu bạn thường xuyên dùng Claude Code hoặc Claude Projects để refactor, chắc hẳn bạn đã quen với cảnh này. Mỗi session mới, AI lại hỏi những câu hiển nhiên: “Dự án dùng framework gì?”, “Lệnh chạy test ở đâu?”. Tệ hơn, nó tự ý viết code theo style cá nhân, phá nát quy chuẩn chung của team.
Thay vì bực bội, hãy dùng CLAUDE.md. Đây không phải tài liệu cho con người mà là một file cấu hình định hướng tư duy cho AI. Thực tế cho thấy, khi có file này, Claude hiểu ý nhanh hơn và giảm thiểu tới 90% các lỗi ngớ ngẩn về coding style.
Sự khác biệt giữa README.md và CLAUDE.md
Nhiều bạn thắc mắc tại sao không để AI tự đọc README.md. Vấn đề nằm ở mục đích sử dụng:
- README.md: Dành cho con người. Nó đầy rẫy badge, giới thiệu hoa mỹ và hướng dẫn cài đặt môi trường. AI phải lọc bỏ khoảng 60-70% nội dung thừa để tìm được lệnh build, gây lãng phí token.
- CLAUDE.md: Chỉ chứa “xương sống” kỹ thuật. Nó tập trung vào lệnh thực thi, cấu trúc thư mục và các quy tắc đặc thù mà AI cần tuân thủ ngay lập tức.
So sánh hiệu quả thực tế
| Tiêu chí | Cách truyền thống (README) | Cách hiện đại (CLAUDE.md) |
|---|---|---|
| Dung lượng token | Thường > 2000 tokens | Thường < 500 tokens |
| Tốc độ “vào việc” | Mất 2-3 lượt chat để hiểu | Ngay từ câu lệnh đầu tiên |
| Độ chính xác style | 50/50 (Dễ bị xao nhãng) | Gần như tuyệt đối |
Lợi ích sát sườn khi triển khai CLAUDE.md
Sau khi áp dụng cho các dự án từ nhỏ đến lớn, mình rút ra 2 điểm then chốt:
Đầu tiên là khả năng tiết kiệm chi phí. Việc gom thông tin cốt lõi vào một file giúp Claude không phải quét toàn bộ codebase, giảm đáng kể lượng token input. Thứ hai là kiểm soát hành vi. Bạn có thể ép AI không bao giờ được dùng một thư viện lỗi thời, hoặc luôn phải viết Unit Test sau khi sửa logic.
Cấu trúc file CLAUDE.md chuẩn chỉnh
Hãy tạo file CLAUDE.md tại thư mục gốc của dự án. Một file hiệu quả thường gồm 3 phần chính sau đây.
1. Lệnh thực thi (Build & Development)
Phần này giúp Claude biết chính xác cần chạy lệnh gì khi bạn yêu cầu nó debug hoặc build dự án.
## Build and Development
- Install: `npm install`
- Dev server: `npm run dev`
- Build: `npm run build`
- Test: `npm test`
- Lint: `npm run lint`2. Quy tắc viết code (Code Style & Patterns)
Đừng để AI tự do sáng tạo. Hãy gò nó vào khuôn khổ của team. Ví dụ, nếu bạn dùng Tailwind, hãy cấm nó viết CSS thuần.
## Code Style Patterns
- Use TypeScript for all logic; no `any` allowed.
- Prefer functional components and hooks.
- Styling: Use Tailwind CSS only; avoid inline styles.
- Error handling: Wrap async calls in try-catch using `logger.error()`.3. Cấu trúc và Tech Stack
Giúp Claude định vị nhanh file cần sửa mà không cần lục tung ổ cứng.
## Tech Stack
- Next.js 14 (App Router), Prisma, Zustand
## Key Directories
- `/src/components/ui`: Shadcn components
- `/src/hooks`: Custom React hooks
- `/src/lib`: API clients and utilsMẹo nâng cấp CLAUDE.md thành “trợ lý cao cấp”
Để file này thực sự phát huy sức mạnh, bạn nên áp dụng các kỹ thuật sau:
Thiết lập danh sách Anti-patterns: Ghi rõ những thứ bạn cực ghét. Ví dụ: “Strictly forbid the use of ‘any’ type. Use ‘unknown’ if necessary”. Claude sẽ tuân thủ nghiêm túc hơn bất kỳ junior dev nào.
Cập nhật sau mỗi task lớn: Khi bạn thay đổi kiến trúc, ví dụ chuyển từ Redux sang React Query, hãy bảo Claude: “Update CLAUDE.md to reflect our new state management”. Việc này giúp các session sau AI không bị nhầm lẫn kiến thức cũ.
Tận dụng Claude Code (CLI): Công cụ CLI mới của Anthropic sẽ tự động đọc file này ngay khi khởi động. Bạn sẽ thấy tốc độ phản hồi nhanh hơn hẳn vì AI đã có sẵn ngữ cảnh trong đầu.
Dưới đây là ví dụ thực tế cho một dự án Python/FastAPI:
# CLAUDE.md for FastAPI
## Commands
- Dev: `uvicorn main:app --reload`
- Test: `pytest`
## Standards
- Use Pydantic v2 for models.
- Async/Await for all DB operations.
- Follow PEP 8 strictly.Lời kết
Bỏ ra 5 phút viết CLAUDE.md sẽ giúp bạn tiết kiệm hàng giờ giải thích và sửa lỗi về sau. Nó giống như việc bạn đưa bản đồ cho một người tài xế giỏi; thay vì phải chỉ đường từng ngã rẽ, bạn chỉ việc ngồi xuống và hưởng thụ kết quả. Hãy thử tạo ngay file này cho dự án hiện tại và bạn sẽ thấy Claude “thông minh” lên trông thấy!
