Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md là file cấu hình markdown đặt trong thư mục gốc dự án, cung cấp cho Claude Code các hướng dẫn lâu dài theo dự án. Nó cho agent biết về quy ước lập trình, kiến trúc, lệnh thông dụng và quy tắc - đóng vai trò như một dạng bộ nhớ dài hạn áp dụng cho mọi phiên làm việc trong dự án đó.

CLAUDE.md hoạt động như thế nào

Khi Claude Code bắt đầu một phiên làm việc, nó tự động đọc file CLAUDE.md trong thư mục gốc dự án (và bất kỳ file CLAUDE.md nào trong thư mục cha hoặc thư mục con). Nội dung trở thành một phần ngữ cảnh hệ thống của agent, vì vậy nó tuân theo hướng dẫn mà không cần nhắc nhở lại mỗi phiên. Điều này giúp agent hoạt động nhất quán với quy ước của nhóm.

Nên đưa gì vào CLAUDE.md

  • +Tổng quan kiến trúc dự án và vị trí file quan trọng
  • +Quy ước lập trình (đặt tên, định dạng, các mẫu nên dùng hoặc tránh)
  • +Lệnh thông dụng cho test, build và deploy
  • +Quy tắc như "luôn viết test cho hàm mới" hoặc "không bao giờ sửa trực tiếp module auth"
  • +Chi tiết về công nghệ sử dụng mà agent cần biết
markdown
# CLAUDE.md

## Project
Next.js 14 app with App Router, TypeScript, Tailwind CSS.

## Commands
- `npm run dev` — start dev server
- `npm test` — run Jest tests
- `npm run lint` — ESLint check

## Conventions
- Use server components by default
- Client components go in `components/client/`
- All API routes must validate input with Zod
- Write tests for every new utility function

## Do NOT
- Modify files in `lib/core/` without explicit approval
- Use `any` type in TypeScript
- Add new dependencies without justification

Hãy giữ CLAUDE.md ngắn gọn. Agent đọc nó mỗi phiên, vì vậy chỉ đưa vào thông tin liên quan đến nhiều tác vụ. Thay vào đó, hãy đưa chi tiết theo tác vụ cụ thể vào prompt của bạn.

Tôi nên đặt file CLAUDE.md ở đâu?+
Đặt nó trong thư mục gốc dự án. Claude Code cũng hỗ trợ file CLAUDE.md trong các thư mục con cho hướng dẫn theo module, và trong thư mục cha cho quy tắc toàn tổ chức. Tất cả file phù hợp được gộp lại với nhau.
CLAUDE.md có hoạt động với các công cụ AI khác không?+
CLAUDE.md đặc thù cho Claude Code. Tuy nhiên, một số công cụ khác đã áp dụng các khái niệm tương tự. Cursor dùng .cursorrules, và các agent khác có thể đọc file cấu hình tùy chỉnh. Khái niệm hướng dẫn AI ở cấp độ dự án đang trở thành một mẫu phổ biến.
CLAUDE.md nên dài bao nhiêu?+
Giữ dưới 500 dòng. Tập trung vào các quy ước và quy tắc quan trọng nhất. Agent luôn có thể đọc các file riêng lẻ để biết chi tiết - CLAUDE.md nên cung cấp ngữ cảnh cấp cao áp dụng cho nhiều tác vụ.

Related terms

Lập Trình AgenticClaude CodeKỹ Thuật Prompt Cho Code

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS