CLAUDE.md (Claude Code): vị trí và cách các tool đọc tệp

CLAUDE.md là tệp ghi nhớ mà Claude Code tải khi khởi chạy từ thư mục home, dự án và mọi thư mục cha. Các quy tắc theo đường dẫn trong .claude/rules/ bổ sung hướng dẫn chỉ được tải khi đọc các tệp khớp với quy tắc.

Vị trí

• Dự án: ./CLAUDE.md hoặc ./.claude/CLAUDE.md, được commit và chia sẻ với nhóm.
• Cục bộ: ./CLAUDE.local.md, dành cho ghi chú cá nhân không đưa vào git.
• Người dùng: ~/.claude/CLAUDE.md, áp dụng cho mọi dự án.
• Quy tắc: ./.claude/rules/**/*.md và ~/.claude/rules/**/*.md, có thể giới hạn phạm vi bằng frontmatter paths.
• Chính sách do quản trị viên quản lý: /Library/Application Support/ClaudeCode/CLAUDE.md trên macOS, C:\Program Files\ClaudeCode\CLAUDE.md trên Windows hoặc khóa claudeMd trong managed-settings.json.

Định dạng

Markdown. Các tệp trong .claude/rules/ có thể bắt đầu bằng YAML frontmatter, trong đó khóa paths liệt kê các glob. Nhúng các tệp khác bằng @path/to/file, tối đa 4 cấp; không có giới hạn kích thước cứng được ghi nhận, nhưng Anthropic khuyến nghị mỗi tệp nên dưới 200 dòng.

Các khóa frontmatter: paths

@AGENTS.md

# Claude Code notes

- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.

## API

- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.

Thứ tự ưu tiên và hợp nhất

Không có tệp nào ghi đè tệp khác: mọi tệp được tìm thấy đều được nối lại với nhau. Chính sách do quản trị viên quản lý được tải trước, sau đó là các tệp từ thư mục gốc của hệ thống tệp xuống thư mục khởi chạy, nên các tệp ở gần được đọc sau cùng; trong cùng một thư mục, CLAUDE.local.md được đọc sau CLAUDE.md. Các tệp trong thư mục con được tải theo yêu cầu khi Claude đọc tệp ở đó; không thể loại trừ chính sách do quản trị viên quản lý bằng claudeMdExcludes.

Các tool đọc tệp này

Mẹo

• Nếu dùng CLAUDE.md, hãy bắt đầu tệp bằng @AGENTS.md; nếu không, Claude Code sẽ bỏ qua AGENTS.md theo thiết lập mặc định.
• Chuyển hướng dẫn dành riêng cho từng khu vực vào .claude/rules/ và thêm frontmatter paths để chỉ tải chúng cho các tệp tương ứng.
• Import giúp sắp xếp tệp nhưng vẫn tiêu tốn context, vì văn bản được import cũng được tải.
• Chạy /doctor để kiểm tra CLAUDE.md, CLAUDE.local.md, AGENTS.md, rules và skills trong một lần.

Các tệp hướng dẫn khác