Auto memory là machine-local: 4 ranh giới của Claude Code

Bạn mở terminal thứ hai cho cùng một repo, hỏi Claude Code một câu, và nó không biết gì về quyết định kiến trúc bạn vừa chốt ở cửa sổ bên cạnh. Bạn dán lại context, mất năm phút, rồi lặp lại chuyện đó vài lần mỗi ngày.

Vấn đề không phải Claude Code "quên". Vấn đề là có bốn cơ chế giữ context khác nhau với bốn biên giới khác nhau, và bạn đang kỳ vọng vào nhầm cơ chế. Dưới đây là ranh giới của từng cái, theo đúng tài liệu Anthropic, để bạn chọn đúng ngay từ đầu.

Bốn cơ chế, bốn biên giới

Theo bài phân tích của Mnemoverse, Claude Code tự nó mang context qua các session bằng hai cơ chế: "CLAUDE.md files that you write and auto memory notes that Claude writes". Cả hai "load at the start of every conversation and act as context rather than enforced configuration" — nghĩa là chúng là context, không phải config được enforce. Đừng viết CLAUDE.md như một file policy và mong Claude tuân thủ tuyệt đối.

Cơ chế	Giữ cái gì	Ai viết	Biên giới
CLAUDE.md	Instructions, project context	Bạn	File trong project; đi theo version control
Auto memory	Notes từ corrections & preferences	Claude	"Auto memory is machine-local"
Saved conversation	Messages, tool calls, results	Claude Code	Gắn với project directory
Memory MCP server	Thông tin ghi/đọc qua server tools	Agent	User scope, phụ thuộc service

CLAUDE.md: phần bạn kiểm soát

Đây là nơi đặt convention của repo, lệnh build, constraint — những thứ ổn định. Điểm mạnh thực dụng: "project instructions can be shared with a team through version control", nên cả team dùng chung một context thay vì mỗi người tự dán. Khởi tạo bằng /init, tinh chỉnh bằng /memory. Instruction cá nhân áp dụng cho mọi project thì để ở ~/.claude/CLAUDE.md hoặc ~/.claude/rules/.

Auto memory: bật mặc định, nhưng chỉ nằm trên máy bạn

Auto memory là "notes Claude writes itself based on your corrections and preferences", bật sẵn trong local session, với MEMORY.md đóng vai trò index cho memory directory. Ràng buộc quan trọng nhất là câu Anthropic nói thẳng: "Auto memory is machine-local". Đổi máy, chạy trong CI, hay đồng nghiệp clone repo — không ai thấy nó. Nếu một thông tin cần sống lâu hơn cái laptop của bạn, nó phải nằm trong CLAUDE.md.

--continue và --resume không phải là memory

claude --continue "loads the most recent conversation in the current directory"; --resume cho bạn chọn một conversation từ local history. Đây là lịch sử hội thoại, không phải tri thức được chắt lọc — và nó gắn với thư mục hiện tại, nên mở terminal ở path khác là mất. Dùng nó để nối tiếp công việc dở, không phải để lưu trữ quyết định.

Ở tầng API, "giữ context" còn ngắn hơn nhiều

Nếu bạn tự build agent trên Messages API thay vì dùng CLI, Anthropic mở Message Threads ở public beta ngày 2/11/2026: API giữ hội thoại ở phía server, lượt sau chỉ gửi phần mới. Nhưng đọc kỹ giới hạn trước khi coi đó là storage: "A thread expires 5 minutes after its last request", state nằm in-memory và "deleted no more than one hour after last use", và "There is no API to list, read or delete threads". Đây là tính năng latency cho session đang hoạt động, không phải chỗ lưu context.

Việc nên làm tuần này

Mở repo chính, chạy /init nếu chưa có CLAUDE.md, rồi chuyển mọi thứ bạn đang phải dán lại thủ công vào đó. Những gì chỉ đúng với máy bạn thì để auto memory tự lo. Chỉ cân nhắc thêm memory MCP server ở user scope khi bạn thật sự cần một bộ nhớ dùng chung giữa nhiều project hoặc nhiều tool — lưu ý tác giả bài gốc cũng là bên làm một memory server, nên hãy đánh giá nhu cầu trước khi cài thêm một lớp phụ thuộc.