Hệ thống memory Claude Code là một cơ chế nạp ngữ cảnh đa tầng — gồm các tệp CLAUDE.md do bạn viết và auto memory do Claude tự ghi — giúp Claude giữ lại kiến thức dự án qua từng phiên làm việc vốn không nhớ gì (stateless).
Về bản chất kỹ thuật, các mô hình ngôn ngữ lớn (LLM) là hệ thống stateless: không lưu trạng thái giữa các lần gọi. Mỗi khi bạn mở một phiên mới, Claude Code bắt đầu từ một "bảng trắng" — không có ký ức về cấu trúc thư mục, lỗi đã xử lý tối qua hay quy ước đặt tên riêng của dự án. Hệ thống memory sinh ra để vá đúng khoảng trống đó.
Thiết lập bộ nhớ tử tế giúp bạn xóa bỏ "Repetition Tax" — khoản thời gian và token lãng phí mỗi phiên chỉ để nhắc lại vai trò, quy tắc và môi trường làm việc. Thay vì nhồi một tệp hướng dẫn khổng lồ dễ gây nhiễu, Claude Code chia việc ghi nhớ thành hai lớp: chỉ dẫn cố định (CLAUDE.md) và kinh nghiệm tích lũy (auto memory).
Với một kỹ sư, hiểu rõ thứ tự ưu tiên và giới hạn vật lý của từng lớp bộ nhớ là điều kiện tiên quyết để điều hướng AI agent chính xác trong một dự án chạy dài hạn.
Vì sao mỗi phiên Claude Code lại mất trí nhớ?
Mọi phiên làm việc với Claude Code đều bị bó trong một cửa sổ ngữ cảnh (context window). Lúc khởi
động, bối cảnh là con số 0. Việc dựng lại ngữ cảnh bằng tay mỗi lần chính là "Repetition Tax": bạn
tốn token và sự tập trung để gõ lại những thứ lặp đi lặp lại như "dự án dùng TypeScript" hay "API
nằm trong thư mục src/api".
Đây không phải giới hạn có thể lách bằng cách dán thật nhiều thông tin vào đầu phiên. Cửa sổ ngữ cảnh càng đầy, không gian suy luận còn lại cho các tác vụ xử lý code phức tạp phía sau càng hẹp — nhồi ngữ cảnh thủ công thực chất là tự bào mòn chất lượng đầu ra.
Vì thế Claude Code cần một cơ chế "briefing" tự động: nạp sẵn các dữ liệu nền (build command, cấu trúc thư mục, quy ước) ngay khi khởi động, và tách bạch giữa ghi nhớ hội thoại tạm thời với bộ nhớ ổn định lâu dài. Nhờ đó Claude phản hồi nhất quán, bất kể bạn đang ở phiên thứ mấy của dự án.
Hai hệ thống bộ nhớ: CLAUDE.md và auto memory
Claude Code vận hành trên hai hệ thống bộ nhớ bổ trợ nhau, cả hai đều được nạp vào ngữ cảnh ngay đầu mỗi phiên. Lưu ý một điều: Claude coi chúng là ngữ cảnh để tham khảo, không phải cấu hình bắt buộc tuân thủ — muốn chặn cứng một hành vi, bạn phải dùng hook thay vì viết vào CLAUDE.md.
| Tiêu chí | CLAUDE.md | Auto memory |
|---|---|---|
| Bản chất | Chỉ dẫn hành vi (bạn viết) | Kinh nghiệm tích lũy (Claude tự ghi) |
| Nội dung | Quy tắc, tiêu chuẩn, cấu trúc dự án | Lệnh build đúng, lỗi đã fix, sở thích phát hiện |
| Phạm vi | Dự án, cá nhân hoặc tổ chức | Theo từng repo, dùng chung giữa các worktree |
| Cách nạp | Nạp toàn bộ tệp | 200 dòng đầu hoặc 25KB của tệp index |
CLAUDE.md đóng vai "hiến pháp" của dự án: những gì Claude phải làm. Auto memory giống một cuốn nhật ký hành trình, giúp Claude nhận ra các mẫu đã gặp để không lặp lại sai lầm cũ. Dùng CLAUDE.md khi bạn muốn chủ động định hướng hành vi; để auto memory tự đúc kết những gì nó học được từ các lần bạn sửa lưng nó. Muốn xem bức tranh rộng hơn về cách CLAUDE.md, rules, skills và hooks phối hợp điều hướng Claude, xem Hướng dẫn về Claude memory files và cơ chế điều hướng.
