claude-md-file-cau-hinh-bo-naoCLAUDE.md là Đây là tính năng ít người biết nhưng tạo ra sự khác biệt lớn nhất khi dùng Claude Code hàng ngày.

CLAUDE.md là gì?

Khi bạn chạy claude trong một folder, Claude Code sẽ tự động đọc file CLAUDE.md ở root của project. File này chứa những thông tin bạn muốn Claude biết trước khi bắt đầu làm việc.

Nghĩ đơn giản: đây là "README cho AI" — thay vì giải thích cho người mới join team, bạn giải thích cho Claude.

Cấu trúc CLAUDE.md chuẩn

Một CLAUDE.md tốt thường có 5 phần: Tech Stack, Quy tắc code, Cấu trúc folder, Lệnh quan trọng, và Context đặc biệt của project.

Ví dụ cho một Next.js project:

Tech Stack nên ghi rõ: Next.js 14 App Router, PostgreSQL + Prisma, Tailwind CSS, NextAuth.js.

Quy tắc code: TypeScript strict mode, kebab-case cho tên file, PascalCase cho component, không dùng any type.

Context quan trọng: Database dùng soft delete (có trường deletedAt), authentication handle ở middleware.ts, tất cả API routes validate bằng Zod.

Tại sao file này quan trọng?

Không có CLAUDE.md: Mỗi session mới, Claude Code không biết gì về project. Bạn phải giải thích lại tech stack, quy tắc, cấu trúc...

Có CLAUDE.md: Claude Code biết ngay context, đề xuất code theo đúng convention của bạn, không dùng sai pattern hay library.

Mẹo nâng cao

Nên commit CLAUDE.md vào repo — toàn team đều được lợi khi dùng Claude Code. Cập nhật mỗi khi thêm dependency mới hoặc đổi convention quan trọng.

Bạn cũng có thể đặt CLAUDE.md trong subfolder để override context cho module đó. Ví dụ /api/CLAUDE.md chỉ áp dụng cho phần backend.

Tạo tự động

Thay vì tự viết, hãy để Claude Code tự tạo:

claude "Đọc cấu trúc project này và tạo file CLAUDE.md phù hợp"

Claude Code sẽ tự khám phá project và viết CLAUDE.md cho bạn!file bí mật giúp Claude Code hiểu project của bạn ngay từ đầu — không cần giải thích lại mỗi lần. Học cách viết file này đúng cách để tiết kiệm hàng trăm token mỗi ngày.