todo-api giờ đã có CLAUDE.md với lệnh test và cạm bẫy xóa mềm. Rồi vài chuyện nhỏ xuất hiện. Bạn muốn Claude luôn trả lời bằng tiếng Việt, ở mọi dự án chứ không riêng repo này. Bạn có một URL sandbox riêng mà đồng nghiệp không cần thấy. Công ty thì vừa có quy định chung về xử lý dữ liệu khách hàng. Nhét hết vào một file CLAUDE.md của dự án là sai chỗ. Bài này nói về các tầng bộ nhớ của Claude Code và cách chọn đúng tầng cho từng thứ.
Bốn tầng CLAUDE.md
Claude Code đọc CLAUDE.md ở bốn tầng, từ rộng nhất tới hẹp nhất:
- Managed policy: cho cả tổ chức, do IT hoặc DevOps đặt lên máy. Trên macOS nằm ở
/Library/Application Support/ClaudeCode/CLAUDE.md; trên Linux và WSL ở/etc/claude-code/CLAUDE.md; trên Windows ởC:\Program Files\ClaudeCode\CLAUDE.md. Hợp với chuẩn code của công ty, chính sách bảo mật, yêu cầu tuân thủ. - User:
~/.claude/CLAUDE.md, sở thích của riêng bạn, áp dụng cho mọi dự án. Ví dụ ngôn ngữ trả lời, công cụ quen tay. - Project:
./CLAUDE.mdhoặc./.claude/CLAUDE.md, hướng dẫn của dự án, chia sẻ với team qua git. Đây là file bạn viết ở bài 2.1. - Local:
./CLAUDE.local.md, sở thích riêng của bạn trong dự án này. Thêm file này vào.gitignoređể nó không bị commit. Hợp với URL sandbox riêng hay dữ liệu thử bạn hay dùng.
Với ba chuyện ở đầu bài: trả lời bằng tiếng Việt thuộc tầng user, URL sandbox thuộc tầng local, quy định dữ liệu của công ty thuộc tầng managed.
Thứ tự Claude nạp
Lúc khởi động, Claude Code nạp CLAUDE.md và CLAUDE.local.md ở thư mục làm việc và mọi thư mục phía trên. Mở Claude trong foo/bar/ thì nó đọc cả foo/bar/CLAUDE.md lẫn foo/CLAUDE.md.
Điểm quan trọng: các file được nối lại với nhau, không ghi đè nhau. Thứ tự đi từ gốc hệ thống xuống thư mục làm việc, nên file gần chỗ bạn mở Claude được đọc sau cùng. Trong cùng một thư mục, CLAUDE.local.md nằm sau CLAUDE.md. Vì không có cơ chế ghi đè, nếu hai tầng nói ngược nhau, Claude có thể làm theo bên nào cũng được. Cách chữa là giữ các tầng nhất quán, không phải trông vào thứ tự.
CLAUDE.md trong thư mục con thì khác: nó không được nạp lúc khởi động mà chỉ nạp khi Claude đọc, ghi hoặc sửa một file trong thư mục con đó. Nhờ vậy một monorepo có thể đặt hướng dẫn riêng cho từng phần mà không làm nặng mọi phiên.
Import bằng @
Một file CLAUDE.md có thể kéo file khác vào bằng cú pháp @đường/dẫn:
See @README for an overview and @package.json for the npm scripts.
# Git
- Workflow: @docs/git-instructions.mdVài quy tắc cần nhớ:
- Đường dẫn tương đối được tính từ file chứa dòng import, không phải từ thư mục làm việc.
- File được import có thể import tiếp, tối đa bốn bước.
- Đặt trong dấu backtick, như
`@README`, thì chỉ là chữ, không import. - Import giúp chia file cho gọn, nhưng không giảm dung lượng bối cảnh: file được import vẫn được nạp cùng lúc.
Một điểm về an toàn: nếu CLAUDE.md của dự án import một file nằm ngoài thư mục làm việc, lần đầu Claude Code sẽ hiện hộp thoại liệt kê các file đó để bạn duyệt. Từ chối thì các import đó bị tắt. Hộp thoại này bảo vệ bạn khỏi những file do người khác commit vào dự án chung.
Auto memory: phần Claude tự ghi
Bên cạnh CLAUDE.md do bạn viết, Claude Code còn có auto memory: ghi chú Claude tự viết trong lúc làm việc. Nó lưu bốn loại: thông tin về bạn (user), những lần bạn sửa hoặc xác nhận cách làm (feedback), việc và quyết định đang diễn ra mà code không cho thấy (project), và chỗ tìm thông tin bên ngoài như issue tracker (reference). Claude bỏ qua điều suy ra được từ code và điều CLAUDE.md đã có.
Auto memory bật sẵn ở các phiên trên máy bạn. Dữ liệu nằm ở ~/.claude/projects/<project>/memory/, dùng chung cho mọi worktree của cùng một repo, và chỉ ở trên máy này, không đồng bộ sang máy khác. Thư mục có một file MEMORY.md làm mục lục, mỗi ghi chú một dòng. Mỗi phiên, Claude nạp 200 dòng đầu hoặc 25KB đầu của mục lục, tùy cái nào tới trước; các file chi tiết chỉ được đọc khi cần.
Phân biệt hai cách nói:
- "remember that the API tests need a local Redis": Claude lưu vào auto memory trên máy bạn.
- "add this to CLAUDE.md": Claude ghi vào CLAUDE.md, cả team sẽ thấy sau khi bạn commit.
Muốn tắt auto memory, dùng công tắc trong /memory, đặt autoMemoryEnabled: false trong settings của dự án, hoặc đặt biến môi trường CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.
/init và /memory
/init đọc codebase rồi tạo bản CLAUDE.md khởi đầu, gồm lệnh build, cách chạy test và các quy ước nó thấy. Nếu dự án đã có CLAUDE.md, /init đề xuất cải thiện thay vì ghi đè. Bản /init tạo ra là điểm xuất phát, không phải thành phẩm: việc của bạn sau đó chủ yếu là xóa những dòng Claude tự đọc được, rồi thêm điều nó không thể tự biết, như ở bài 2.1.
Nếu muốn /init hỏi đáp nhiều bước, đặt biến môi trường CLAUDE_CODE_NEW_INIT=1 trước khi chạy. Khi đó /init hỏi bạn muốn tạo những gì: CLAUDE.md, skill hay hook.
/memory là bảng điều khiển của cả hệ thống bộ nhớ. Nó liệt kê các file CLAUDE.md và CLAUDE.local.md ở tầng user và project, kể cả những file chưa tồn tại để bạn tạo; có công tắc bật tắt auto memory; và có lối mở thư mục auto memory để bạn đọc, sửa hoặc xóa ghi chú. Mọi thứ đều là Markdown thường.
Sau /compact
Phiên dài sẽ được nén lại bằng /compact, hoặc tự động khi bối cảnh gần đầy. CLAUDE.md ở gốc dự án không bị mất trong quá trình này: sau khi nén, Claude đọc lại nó từ đĩa. CLAUDE.md ở thư mục con và rule theo đường dẫn sẽ nạp lại khi Claude chạm tới file khớp.
Thứ dễ mất là chỉ dẫn bạn chỉ nói trong hội thoại. Nếu một lời dặn quan trọng tới mức bạn không muốn nó biến mất sau khi nén, đó là dấu hiệu nó nên nằm trong CLAUDE.md.
Bài cuối của cấp 2 đưa phần này lên mức team: chia quy tắc theo chủ đề, quy tắc chỉ áp dụng cho một phần code, và chọn giữa CLAUDE.md, skill hay hook.