Auto memory trong Claude Code: Claude tự ghi nhớ thói quen của bạn

Bạn nhắc Claude Code lần thứ năm "dùng pnpm chứ không phải npm", hay "đừng chạy test e2e, chậm lắm". Mỗi phiên mới bắt đầu với context trống, nên nó quên. CLAUDE.md giải quyết một phần, nhưng bạn phải tự viết. Auto memory là nửa còn lại: Claude tự ghi chú những điều học được từ cách bạn sửa và xác nhận, rồi đọc lại ở phiên sau. Hiểu cách nó hoạt động giúp bạn tận dụng mà không để nó phình to tốn token.

CLAUDE.md và auto memory

Claude ghi nhớ những gì?

Bốn loại, ghi trong trường type ở frontmatter của mỗi file:

• user: vai trò, chuyên môn, sở thích làm việc của bạn.
• feedback: lời sửa bạn đưa ra và cách làm bạn xác nhận là đúng.
• project: việc đang làm, hạn chót, quyết định không suy ra được từ code hay git.
• reference: nơi tìm thông tin ngoài dự án (tracker, dashboard).

Claude bỏ qua những gì suy ra được từ codebase (kiến trúc, đường dẫn, cách sửa bug) và những gì CLAUDE.md đã nói. Không phải phiên nào cũng ghi.

Lưu ở đâu, nạp thế nào?

~/.claude/projects/<project>/memory/
├── MEMORY.md            # mục lục, mỗi dòng một memory, nạp mọi phiên
├── user_role.md
├── feedback_testing.md
└── ...

• Chỉ 200 dòng hoặc 25KB đầu của MEMORY.md được nạp đầu phiên; phần vượt bị bỏ. Claude Code nhắc Claude rút gọn khi gần chạm giới hạn.
• File chủ đề không nạp sẵn; Claude đọc khi cần bằng tool đọc file. Đây là thiết kế tiết kiệm token: chỉ mục lục tốn context thường trực.
• Memory nằm trên máy, không đồng bộ giữa các máy; không bị dọn theo chu kỳ xoá transcript.

Bật, tắt và quản lý

• Mặc định bật ở phiên local. Mở /memory để xem, sửa và bật/tắt (lưu autoMemoryEnabled).
• Tắt cho một dự án: {"autoMemoryEnabled": false} trong settings của dự án; tắt bằng biến môi trường: CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.
• Đổi nơi lưu: autoMemoryDirectory (đường dẫn tuyệt đối hoặc bắt đầu bằng ~/).
• Bạn có thể nói thẳng: "nhớ là dự án này deploy bằng script X" để Claude lưu.

Rủi ro và lưu ý

• Memory là ngữ cảnh, không phải luật: Claude coi như gợi ý; việc bắt buộc dùng hook.
• Memory sai còn tệ hơn không có: một ghi chú lỗi thời được nạp mọi phiên. Thỉnh thoảng mở /memory dọn dẹp.
• Thông tin nhạy cảm: memory là file văn bản thường trên máy; đừng để Claude lưu token, mật khẩu.
• Không chia sẻ cho team: quy ước chung của team đặt trong CLAUDE.md commit vào repo, không phải auto memory.

Áp dụng thế nào?

• Dev: Khi sửa Claude một điều lặp lại, nói thêm "hãy nhớ điều này"; mỗi tháng xem /memory một lần.
• Tech Lead: Ghi chú nào trong memory của bạn có ích cho cả team thì chuyển vào CLAUDE.md của repo.
• PM/Admin: Với môi trường dùng chung hoặc dữ liệu nhạy cảm, cân nhắc tắt auto memory bằng managed settings.