claude-mem là gì: cài bộ nhớ dài hạn cho Claude Code

claude-mem là gì? Đây là plugin mã nguồn mở giúp Claude Code nhớ những gì đã làm ở phiên trước, để phiên sau không phải giải thích lại từ đầu. Ai dùng Claude Code hằng ngày đều quen cảnh mở phiên mới và agent quên sạch hôm qua đã sửa file nào, quyết định gì. Tuần này repo thedotmack/claude-mem đứng đầu GitHub Trending với 7.995 sao mới, tổng 112.594 sao (số tra trên trang Trending ngày 04/11/2026).

Bài này dành cho anh chị đã dùng Claude Code hoặc một agent lập trình khác và muốn agent có "trí nhớ" theo dự án.

claude-mem là gì, dùng vào việc gì

Nói ngắn gọn, claude-mem làm ba việc: ghi lại thao tác của agent trong lúc làm, nhờ AI nén những thao tác đó thành ghi chép ngắn, rồi đưa phần liên quan trở lại khi anh chị mở phiên mới.

Hình dung một nhân viên giỏi nhưng mỗi sáng đi làm lại mất trí nhớ. claude-mem giống cuốn sổ giao ca: cuối ngày ai đó ghi lại việc đã làm, sáng hôm sau nhân viên đọc lướt trước khi bắt tay vào việc.

Theo README, repo dùng giấy phép Apache 2.0, phiên bản hiện tại là 15.9.0. Ngoài Claude Code, trình cài đặt còn hỗ trợ OpenCode, T3 Code, Antigravity CLI, Pi, DeepSeek Harness, Grok Bot và OpenClaw.

Việc nó hợp nhất:

• Dự án kéo dài nhiều ngày, nhiều phiên: website, công cụ nội bộ, script báo cáo.
• Tra lại "tuần trước mình sửa lỗi đăng nhập thế nào" bằng câu hỏi thường.
• Nhóm nhỏ cần biết agent đã làm gì trong từng phiên.

Sơ đồ: luồng hoạt động của claude-mem, từ lúc agent làm việc tới lúc phiên mới nhận lại ngữ cảnh.

claude-mem hoạt động thế nào

README mô tả sáu thành phần chính:

1. Hook vòng đời: sáu điểm móc SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SessionEnd. Mỗi lần agent mở phiên, nhận câu lệnh hay dùng công cụ, hook gọi lệnh claude-mem hook claude-code <event> để ghi lại.
2. Smart Install: bộ kiểm tra thư viện cần thiết, chạy khi cài hoặc sửa.
3. Worker Service: một dịch vụ chạy nền trên máy, có trang web xem bộ nhớ và các điểm tìm kiếm. Địa chỉ được in ra lúc khởi động, trang xem bộ nhớ nằm ở đường dẫn /viewer.
4. SQLite: cơ sở dữ liệu lưu phiên, ghi chép và bản tóm tắt.
5. Skill mem-search: cho phép hỏi bộ nhớ bằng ngôn ngữ thường.
6. Chroma: cơ sở dữ liệu vector để tìm theo ý nghĩa, kết hợp tìm theo từ khóa.

Điểm tôi thấy hay là cách tìm lại theo ba lớp, để không đổ cả kho ghi chép vào ngữ cảnh của agent:

Tác giả cho biết cách lọc trước rồi mới lấy chi tiết giúp tiết kiệm khoảng 10 lần token. Đây là số tự công bố, tôi chưa đo lại.

Cài claude-mem cho Claude Code

Yêu cầu theo README: Node.js 20.0.0 trở lên, Claude Code bản mới có hỗ trợ plugin. Bun và uv sẽ được tự cài nếu máy chưa có, SQLite đi kèm sẵn.

1. Mở terminal, chạy lệnh cài:

npx claude-mem install

2. Hoặc cài từ marketplace ngay trong Claude Code:

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

3. Trình cài sẽ mời đăng nhập claude-mem qua email để nhận khóa bộ nhớ và dùng thử 30 ngày bộ "observer" của họ. Nếu không muốn đăng nhập, README hướng dẫn truyền cờ --provider hoặc đặt CLAUDE_MEM_ONLINE_OPTIN=false.
4. Chọn nơi chạy AI tóm tắt: observer của claude-mem, khóa OpenRouter hoặc Gemini của anh chị, hoặc gói Anthropic đang dùng.
5. Khởi động lại Claude Code, làm việc như thường. Bộ nhớ tự ghi, không cần gõ lệnh gì thêm.

Lưu ý quan trọng: lệnh npm install -g claude-mem chỉ cài thư viện, không đăng ký hook và không dựng worker. Muốn dùng làm bộ nhớ thì phải cài bằng npx claude-mem install hoặc qua /plugin.

Với máy Windows, README cho biết trình cài đặt đặt file chạy tại %LOCALAPPDATA%\claude-mem\bin\claude-mem.exe và thêm vào Path. Nếu hook báo không tìm thấy lệnh claude-mem, chạy npx claude-mem doctor.

Các agent khác dùng cờ --ide, ví dụ:

npx claude-mem install --ide opencode
npx claude-mem install --ide antigravity

Ví dụ dùng thực tế

Tình huống 1: ghi chép bằng tiếng Việt. Mặc định claude-mem viết ghi chép bằng tiếng Anh. Danh sách ngôn ngữ dựng sẵn có mã vi, nên anh chị mở file ~/.claude-mem/settings.json và đặt:

{
  "CLAUDE_MEM_MODE": "code--vi"
}

Khởi động lại Claude Code để áp dụng. Nếu thấy bộ nhớ ghi quá nhiều, README có chế độ code--chill, chỉ giữ những gì khó tìm lại.

Tình huống 2: hỏi lại việc cũ. Giả sử tuần trước agent đã sửa lỗi gửi email trong công cụ nội bộ. Hôm nay lỗi tương tự xuất hiện ở chỗ khác, anh chị gõ:

Tìm trong bộ nhớ: tuần trước mình sửa lỗi gửi email xác nhận thế nào, sửa ở file nào?

Agent sẽ dùng search để lấy danh sách ghi chép, chọn vài mã liên quan rồi gọi get_observations để đọc chi tiết, thay vì đọc lại toàn bộ lịch sử.

Nếu anh chị đang dựng thư viện skill cho công ty, có thể đọc thêm bài Agent Skills thành chuẩn mở của Linux Foundation: claude-mem cũng chạy dựa trên một skill tên mem-search.

Giới hạn và lưu ý

• Dữ liệu đi đâu: phần lưu trữ nằm trên máy, nhưng bước tóm tắt cần một mô hình AI. Nếu chọn observer của claude-mem hay OpenRouter, nội dung phiên làm việc sẽ được gửi tới bên đó để xử lý. Với code hoặc tài liệu nhạy cảm của công ty, nên cân nhắc dùng gói Anthropic của chính mình.
• Thẻ riêng tư: nội dung bọc trong thẻ <private> sẽ không được lưu. Ảnh chụp màn hình mặc định tắt.
• Chi phí: sau 30 ngày dùng thử, bộ nhớ quay về dùng hạn mức gói Anthropic của anh chị, tức là tốn thêm lượt dùng. README không ghi giá gói trả phí.
• Đồng tiền mã hóa CMEM: cuối README có nói về token CMEM do bên thứ ba tạo và được tác giả ủng hộ. Chuyện này không liên quan tới việc dùng plugin, anh chị không cần mua gì để cài.
• Giấy phép: Apache 2.0, dùng được trong doanh nghiệp. README dẫn tới tài liệu riêng về ranh giới giữa phần mở và phần thương mại, nên đọc kỹ nếu định đóng gói vào sản phẩm.
• Cài plugin nghĩa là cho nó chạy lệnh trên máy: hook chạy ở mọi phiên. Máy chứa dữ liệu công ty thì nên để người có chuyên môn xem qua trước.

Câu hỏi thường gặp

claude-mem có miễn phí không?

Mã nguồn miễn phí theo giấy phép Apache 2.0. Phần tốn tiền là AI tóm tắt: dùng thử 30 ngày observer của claude-mem, sau đó dùng khóa OpenRouter, Gemini hoặc gói Anthropic của anh chị.

claude-mem khác gì file CLAUDE.md?

CLAUDE.md là luật anh chị tự viết tay, agent đọc mỗi phiên. claude-mem tự ghi lại việc agent đã làm và chỉ đưa phần liên quan vào khi cần. Hai cái dùng song song được.

Có dùng được với Codex hay Gemini không?

README liệt kê Codex qua T3 Code. Với Gemini CLI, README không nói cách cài riêng, chỉ cho phép dùng khóa Gemini để chạy bước tóm tắt.

Nguồn: thedotmack/claude-mem trên GitHub, 04/11/2026. Ngày tra nguồn: 04/11/2026.