close

claude-mem

Mã nguồn mở bởi thedotmack

AI mã nguồn mở

claude-mem là plugin bộ nhớ dài hạn cho Claude Code và nhiều trợ lý lập trình AI khác. Plugin tự ghi lại những gì trợ lý đã làm trong mỗi phiên, tóm tắt lại và nạp vào phiên sau, để trợ lý nhớ bối cảnh dự án mà bạn không phải giải thích lại.

claude-mem dùng để làm gì?

  • Giữ bối cảnh dự án giữa các phiên làm việc với Claude Code, Codex, OpenCode và các trợ lý khác
  • Tự ghi lại thao tác của trợ lý (sửa file, chạy lệnh) và tóm tắt thành ghi chú tìm lại được
  • Tra lại quyết định đã chọn, lỗi đã sửa trong dự án bằng câu hỏi tự nhiên
  • Xem bộ nhớ, các phiên làm việc và chỉnh cài đặt trên giao diện web chạy trên máy
  • Loại nội dung nhạy cảm khỏi bộ nhớ bằng thẻ

Giao diện

Claude-Mem Preview

Ảnh và video lấy từ README của dự án trên GitHub, bản quyền thuộc nhóm phát triển.

Cần biết trước khi dùng

  • Nghiêm trọng4 lỗ hổng đã biết trong dependency khai báo, trong đó mức Cao/Nghiêm trọng: GHSA-965c-763c-88jm (better-auth@1.6.16, CRITICAL); GHSA-q84f-53jg-9ppm (better-auth@1.6.16, HIGH); GHSA-qq9h-g4jm-xgf3 (better-auth@1.6.16, HIGH); GHSA-r4xp-prcw-77qf (better-auth@1.6.16, HIGH). Phiên bản lấy từ file khai báo nên có thể khác bản thật khi cài.
  • Cần chú ýHướng dẫn cài có dạng "curl … | sh": chạy script từ Internet trực tiếp, nên đọc script trước khi chạy.
  • Lưu ýTino chưa kiểm thử dự án này.

Kiểm tra tự động ngày 04/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.

claude-mem là gì?

Mỗi phiên Claude Code bắt đầu với bộ nhớ trống: trợ lý không biết hôm qua bạn đã sửa lỗi gì hay chọn cách làm nào. claude-mem gắn vào các mốc trong vòng đời phiên (bắt đầu phiên, gửi yêu cầu, trước và sau khi dùng công cụ, kết thúc phiên), ghi lại quan sát rồi nén thành bản tóm tắt.

Dữ liệu lưu trong cơ sở dữ liệu SQLite, kèm Chroma để tìm kiếm kết hợp theo nghĩa và theo từ khoá. Một dịch vụ worker chạy trên máy (quản lý bằng Bun) cung cấp API HTTP và giao diện web để xem bộ nhớ. Khi phiên mới bắt đầu, claude-mem tự đưa phần bối cảnh liên quan vào.

Trợ lý tra bộ nhớ qua các công cụ MCP theo kiểu lấy dần: search trả danh sách ngắn kèm ID, timeline cho xem bối cảnh quanh một kết quả, get_observations chỉ lấy chi tiết những ID cần đọc. Theo README, cách lọc trước rồi mới lấy chi tiết này tiết kiệm khoảng 10 lần token.

Lưu ý về tài khoản: theo README, trình cài đặt mặc định mời đăng nhập claude-mem qua email để dùng bộ quan sát do họ host, có 30 ngày dùng thử; hết hạn thì bộ nhớ quay về dùng gói Anthropic của bạn nếu không đăng ký. Muốn cài không cần tài khoản, thêm cờ --provider khi cài hoặc đặt CLAUDE_MEM_ONLINE_OPTIN=false.

Nên dùng khi

  • Bạn làm một dự án dài ngày với Claude Code và mất thời gian giải thích lại bối cảnh mỗi phiên
  • Bạn cần tra lại vì sao từng chọn một cách làm, hoặc lỗi nào đã sửa trước đây
  • Bạn dùng nhiều trợ lý (Claude Code, Codex, OpenCode…) và muốn chúng dùng chung bộ nhớ

Không nên dùng khi

  • Mã nguồn có yêu cầu bảo mật chặt mà bạn chưa rà dữ liệu nào được ghi lại hoặc gửi lên dịch vụ host
  • Bạn chỉ hỏi đáp ngắn, không cần nhớ gì giữa các phiên
  • Máy không cài được Node.js 20 trở lên

Tính năng chính

  • Bộ nhớ lâu dài: bối cảnh còn lại sau khi phiên kết thúc
  • Tìm kiếm bằng skill mem-search, kết hợp tìm theo nghĩa và theo từ khoá
  • Giao diện web trên máy (/viewer) để xem bộ nhớ, các phiên và cài đặt
  • Thẻ để không lưu nội dung nhạy cảm
  • Trích dẫn quan sát cũ bằng ID qua API của worker
  • Chỉnh được phần bối cảnh nạp vào phiên mới
  • Chế độ ngôn ngữ cho ghi chú: code (tiếng Anh), code--zh, code--ja…
  • Đồng bộ đám mây (Cloud Sync) và không gian nhóm (TeamBrain) là tuỳ chọn

Cách cài đặt claude-mem

  1. Kiểm tra Node.js claude-mem cần Node.js 20.0.0 trở lên. Bun và uv được trình cài đặt tự cài nếu thiếu, SQLite đi kèm sẵn. 
    node --version
  2. Cài cho Claude Code bằng một lệnh Trình cài đặt đăng ký các hook và dịch vụ worker, sau đó mời đăng nhập claude-mem trên trình duyệt. Muốn bỏ qua bước đăng nhập, thêm cờ --provider hoặc đặt CLAUDE_MEM_ONLINE_OPTIN=false. 
    npx claude-mem install
  3. Hoặc cài từ marketplace ngay trong Claude Code Gõ hai lệnh này trong ô chat của Claude Code, sau đó khởi động lại Claude Code. 
    /plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem
  4. Cài cho trợ lý khác Chọn lệnh ứng với trợ lý bạn dùng. OpenCode cần bản 1.3.4 trở lên. Khởi động lại trợ lý sau khi cài. 
    npx claude-mem install --ide opencode
npx claude-mem install --ide t3code
npx claude-mem install --ide antigravity

Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.

Cấu hình quan trọng

MụcÝ nghĩa
~/.claude-mem/settings.jsonFile cài đặt, tự tạo khi chạy lần đầu: model AI, cổng worker, thư mục dữ liệu, mức log, cách nạp bối cảnh
CLAUDE_MEM_MODEChế độ làm việc và ngôn ngữ của ghi chú, ví dụ code, code--zh, code--ja
CLAUDE_MEM_ONLINE_OPTINĐặt false để cài mà không đăng nhập tài khoản claude-mem
CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCESĐặt true để phiên mới lấy ghi chú từ mọi trợ lý; mặc định false (chỉ trợ lý hiện tại)

Cách tích hợp và sử dụng

  1. Khởi động lại Claude CodeTừ phiên sau, bối cảnh của các phiên trước tự xuất hiện, không cần thao tác thêm.
  2. Hỏi lại lịch sử dự ánHỏi trợ lý bằng câu tự nhiên, ví dụ "lỗi đăng nhập tuần trước đã sửa thế nào?". Trợ lý dùng search để lấy danh sách ngắn, rồi get_observations để đọc chi tiết các mục liên quan.
  3. Xem bộ nhớ trên trình duyệtMở địa chỉ worker in ra khi khởi động, vào /viewer để xem bộ nhớ, các phiên và chỉnh cài đặt.
  4. Giữ kín nội dung nhạy cảmBọc phần không muốn lưu trong thẻ ….
  5. Khi gặp lỗiTrên Windows, nếu hook báo không tìm thấy claude-mem, chạy npx claude-mem doctor rồi khởi động lại terminal hoặc IDE. Lệnh npx claude-mem repair dùng để sửa bản cài.

Cập nhật và sao lưu

Cài đặt nằm trong ~/.claude-mem/settings.json, thư mục dữ liệu chỉnh được trong file này. Sao lưu thư mục dữ liệu nếu muốn giữ bộ nhớ khi đổi máy.

README không nêu lệnh nâng cấp riêng; lệnh npx claude-mem install và npx claude-mem repair dùng để cài lại và sửa bản cài.

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

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

Mã nguồn theo giấy phép Apache 2.0. Theo README, bộ quan sát do claude-mem host có 30 ngày dùng thử; hết hạn thì bộ nhớ quay về dùng gói Anthropic của bạn, hoặc bạn chọn khoá OpenRouter, Gemini của riêng mình.

Có cài bằng npm install -g claude-mem được không?

Không nên. README ghi rõ lệnh này chỉ cài thư viện SDK, không đăng ký hook và dịch vụ worker. Hãy cài bằng npx claude-mem install hoặc lệnh /plugin trong Claude Code.

Dữ liệu bộ nhớ lưu ở đâu?

Bộ nhớ lưu trong SQLite trên máy bạn. Chỉ được sao lưu lên cmem.ai khi bạn bật Cloud Sync. Nếu chọn bộ quan sát do claude-mem host, việc tóm tắt chạy trên dịch vụ của họ; muốn tự xử lý thì chọn khoá API riêng hoặc gói Anthropic của bạn.

Có cần cài claude-mem lên VPS không?

Không. claude-mem chạy ở nơi bạn dùng trợ lý AI, thường là máy cá nhân. Chỉ cài lên VPS khi bạn chạy Claude Code hoặc OpenClaw ngay trên VPS đó.

Nội dung được AI hỗ trợ soạn từ README và dữ liệu GitHub của dự án.

Ứng dụng liên quan

Miễn trừ trách nhiệm

Tino không phát triển, không sở hữu và không liên kết với claude-mem hay nhóm phát triển thedotmack. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.

claude-mem được phân phối theo giấy phép Apache-2.0 của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.

Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.