Bỏ qua tới nội dung
Ông T.vn

claude-mem: trí nhớ giữa các phiên cho AI coding agent — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật
claude-mem: trí nhớ giữa các phiên cho AI coding agent — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

claude-mem là plugin và công cụ dòng lệnh giúp AI coding agent (Claude Code, Codex, Cursor, OpenCode và nhiều agent khác) nhớ công việc giữa các phiên. Nó tự ghi lại những gì agent làm, nén thành ghi chú ngắn rồi đưa lại vào phiên sau. Cài bằng một lệnh `npx claude-mem install`, cần Node.js 20.19 trở lên.

claude-mem là một plugin (kèm lệnh claude-mem trong terminal) giúp AI coding agent nhớ được việc đã làm ở các phiên trước. Bình thường, mỗi lần mở phiên mới, agent như người mất trí nhớ: đọc lại cùng những file, hỏi lại cùng những câu, và đôi khi lặp lại lỗi bạn đã sửa cùng nó hôm qua.

Cách claude-mem giải quyết khá gọn. Nó chạy thêm một agent thứ hai ngồi cạnh agent chính, vừa quan sát vừa ghi chú. Sang phiên sau, agent chính nhận một bản mục lục ngắn về những gì quan trọng của dự án, và chỉ mở chi tiết khi thật sự cần. Repo hiện có khoảng 116.672 sao và 10.119 fork, viết bằng TypeScript, giấy phép Apache-2.0.

Nếu bạn dùng Claude Code, Codex, Cursor hay OpenCode mỗi ngày và thấy phiền vì phải giải thích lại bối cảnh dự án, bài này dành cho bạn. Bạn không cần biết lập trình sâu để cài: chỉ cần mở được terminal và gõ lệnh.

Plugin

thedotmack/claude-mem

Plugin giúp Claude Code, Codex, Cursor, OpenCode… nhớ lại những gì đã làm ở phiên trước: tự ghi chú, nén lại và nạp vào phiên mới.

★ 117kTypeScriptApache-2.0
Xem repo trên GitHub

I.claude-mem làm được gì

Dưới đây là những tính năng đáng chú ý nhất, theo cách nhìn của người dùng chứ không phải danh sách kỹ thuật.

  • Phiên mới bắt đầu từ chỗ phiên cũ dừng. Mỗi phiên mở ra với một chỉ mục gọn các «quan sát» (observation) từ trước. Agent chỉ mở bản đầy đủ khi cần, nên đỡ tốn token. Phần đầu còn có thể hiện mỗi lớp thông tin tốn bao nhiêu token.
  • Tìm lại việc đã làm. Skill mem-search tìm trong lịch sử dự án theo ba bước: chỉ mục, dòng thời gian, rồi chi tiết. Bạn có thể hỏi agent kiểu «hôm trước mình sửa lỗi đăng nhập thế nào?» và nó tra lại được.
  • Xem agent làm việc. Màn hình My Work cho thấy các yêu cầu đang chạy, tiến độ, những việc cần người xử lý và hàng đợi để xem lại. Địa chỉ được in ra khi worker khởi động. Phần xem ký ức, phiên làm việc và cài đặt nằm ở /viewer.
  • Chia sẻ với nhóm (tuỳ chọn). TeamBrain là không gian chung cho cả nhóm. Mỗi người tự chọn chia sẻ gì, yêu cầu cá nhân và ghi chú riêng vẫn tách biệt.
  • Tìm ký ức từ Claude Desktop. Bạn có thể tra ký ức ngay trong các cuộc trò chuyện ở Claude Desktop.
  • Giữ bí mật ngoài ký ức. README cho biết bạn có thể bọc nội dung nhạy cảm trong một cặp thẻ riêng thì nó sẽ không bị lưu. Tên thẻ chính xác bạn xem trong README gốc hoặc tài liệu, mình không chép lại ở đây để tránh sai.
  • Ảnh chụp màn hình. Mặc định, bản chuyển đổi của ảnh chụp từ công cụ được giữ trong ~/.claude-mem/media-v1/ và hiện ở My Work. Bạn tắt được bằng công tắc «Keep images» trong Settings.
  • Chỉnh nội dung được nạp vào. Có các thiết lập chi tiết cho việc phiên mới bắt đầu với những ngữ cảnh nào.
  • Tự chạy. Cài xong là nó chạy, không cần nhớ bật.
  • Trích dẫn lại được. Mỗi quan sát có một ID, bạn mở được trong trình xem web hoặc gọi qua API của worker.

Về agent hỗ trợ: README nói chạy được với Claude Code, Codex, Cursor, OpenCode và 11 agent khác. Riêng Copilot CLI, Goose, Roo Code và Warp chỉ tìm kiếm được ký ức, còn phiên làm việc của chúng không được ghi lại.

II.Cần chuẩn bị gì

Theo README và package.json, bạn cần:

  • Node.js: bản 20.19 trở lên trong nhánh 20.x, hoặc 22.12 trở lên.
  • Một agent được hỗ trợ: Claude Code (bản mới nhất, có hỗ trợ plugin) hoặc một agent trong danh sách «Other agents» của README.
  • Bun: runtime và trình quản lý tiến trình, tự cài nếu máy chưa có.
  • uv: trình quản lý gói Python dùng cho tìm kiếm vector, cũng tự cài nếu thiếu.
  • SQLite 3: đã đi kèm, bạn không phải cài.

Về tài khoản: lúc cài, trình cài đặt mời bạn đăng nhập claude-mem trên trình duyệt (bằng email, không cần thẻ để đăng nhập). Sau đó bạn chọn nguồn model cho phần «observer»: observer của claude-mem, key OpenRouter hoặc Gemini của chính bạn, hoặc gói Anthropic của bạn. Bạn có thể bỏ qua bước đăng nhập, xem phần cài đặt bên dưới.

Observer của claude-mem có 30 ngày dùng thử, và trang thanh toán yêu cầu phương thức thanh toán. Hết thời gian dùng thử, README nói ký ức tự chuyển về gói Anthropic của bạn nếu bạn không đăng ký. Nếu muốn tránh phát sinh chi phí, hãy đọc kỹ từng màn hình khi cài và chọn nguồn model bạn muốn.

README không nêu yêu cầu GPU hay RAM tối thiểu, nên mình không khẳng định gì về phần cứng.

III.Cài đặt từng bước

  1. Kiểm tra Node.jsChắc chắn máy có Node.js 20.19+ hoặc 22.12+
  2. Chạy trình cài đặtGõ npx claude-mem install trong terminal
  3. Chọn agent và nguồn modelTrả lời các câu hỏi, đăng nhập hoặc bỏ qua đăng nhập
  4. Khởi động lại agentĐóng và mở lại Claude Code (hoặc agent bạn dùng)
  5. Làm việc như bình thườngTừ phiên thứ hai trong một dự án, ký ức sẽ xuất hiện

A.Kiểm tra Node.js

Mở terminal (PowerShell trên Windows, Terminal trên macOS hay Linux) và gõ lệnh dưới đây. Nếu báo không nhận ra lệnh, bạn cần cài Node.js từ trang nodejs.org rồi mở lại terminal.

Terminal
node --version

Số hiện ra phải từ 20.19 trở lên (nhánh 20) hoặc từ 22.12 trở lên.

B.Chạy trình cài đặt

Đây là cách README khuyến nghị. Bạn có thể gõ ở thư mục nào cũng được.

Terminal
npx claude-mem install

Trình cài đặt tự tìm các agent có trên máy và hỏi bạn muốn cài cho agent nào. Nó cài xong mọi thứ rồi mới mời bạn đăng nhập trên trình duyệt.

Nếu bạn không muốn đăng nhập tài khoản, README nêu ba cách: truyền cờ --provider cụ thể, đặt biến môi trường CLAUDE_MEM_ONLINE_OPTIN=false, hoặc chạy trong CI / shell không tương tác. Khi đó trình cài đặt hoàn tất mà không cần thao tác tài khoản nào. README không liệt kê đầy đủ giá trị của --provider ở phần mình có, bạn xem thêm bằng lệnh sau:

Terminal
npx claude-mem --help

Nếu bạn nhờ một AI agent cài hộ, README dặn dùng lệnh dưới đây để bạn tự chọn mọi thứ trên trang web, không phải trả lời câu hỏi trong terminal:

Terminal
npx claude-mem install --setup browser

Nếu bạn đang vắng mặt, có thể dùng --setup defer: nó chuẩn bị sẵn môi trường và chờ bạn vào chọn ở lần dùng đầu tiên.

Terminal
npx claude-mem install --setup defer

C.Cài từ marketplace của Claude Code

Cách thứ hai, dành riêng cho Claude Code. Gõ hai lệnh này bên trong Claude Code (không phải trong terminal thường):

Terminal
/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Sau đó khởi động lại Claude Code. README nói ngữ cảnh từ các phiên trước sẽ tự xuất hiện ở phiên mới.

Đừng dùng npm install -g claude-mem. README ghi rõ lệnh này chỉ cài phần SDK/thư viện, không đăng ký hook của plugin và không dựng dịch vụ worker. Hãy luôn cài bằng npx claude-mem install hoặc các lệnh /plugin ở trên.

D.Cài cho agent khác

Lệnh npx claude-mem install đã bao quát mọi agent được hỗ trợ. Nếu muốn cài thẳng cho một agent, thêm cờ --ide. Ví dụ với OpenCode (bản 1.3.4 trở lên), nhớ khởi động lại OpenCode sau khi cài:

Terminal
npx claude-mem install --ide opencode

Một số giá trị --ide khác có trong README:

Terminal
npx claude-mem install --ide t3code
npx claude-mem install --ide antigravity
npx claude-mem install --ide omp
npx claude-mem install --ide pi
npx claude-mem install --ide grok-bot

Danh sách đầy đủ các giá trị --ide nằm trong kết quả của npx claude-mem --help. Với OpenClaw, README có một lệnh cài riêng:

Terminal
curl -fsSL https://install.cmem.ai/openclaw.sh | bash

Lệnh này tải một script từ internet rồi chạy ngay. Nếu bạn không quen, hãy đọc hướng dẫn OpenClaw trong tài liệu của dự án trước khi chạy.

IV.Kiểm tra đã chạy được chưa

README không có một lệnh «kiểm tra thành công» riêng, nhưng có vài dấu hiệu rõ ràng:

  • Phiên đầu tiên trong dự án: các quan sát bắt đầu được ghi từ prompt đầu tiên. Bạn sẽ chưa thấy ký ức được nạp vào, vì README nói việc nạp bắt đầu từ phiên thứ hai.
  • Phiên thứ hai trong cùng dự án: agent mở đầu với một chỉ mục ký ức từ phiên đầu.
  • Màn hình web: khi worker khởi động, nó in ra một địa chỉ để mở My Work. Thêm /viewer để xem ký ức, phiên và cài đặt.
  • Thư mục dữ liệu: ký ức nằm ở ~/.claude-mem trên máy bạn, cơ sở dữ liệu là ~/.claude-mem/claude-mem.db.

Nếu nghi có trục trặc, README nhắc đến lệnh chẩn đoán:

Terminal
npx claude-mem doctor

Với người muốn nạp sẵn ngữ cảnh cả repo thay vì chờ tích luỹ dần, README có lệnh /learn-codebase (chạy trong agent, mất khoảng 5 phút với repo cỡ vừa, tuỳ chọn).

V.Dùng vào việc thật

claude-mem phần lớn chạy ngầm, nên «cách dùng» chủ yếu là làm việc như bình thường và biết lúc nào nên tra lại. Dưới đây là mấy tình huống mình thấy hợp với khả năng README mô tả.

A.Lập trình viên quay lại dự án sau một tuần

Bạn đang làm một app nhỏ, tuần trước nhờ Claude Code sửa lỗi đăng nhập. Hôm nay mở lại, thay vì giải thích từ đầu, bạn chỉ cần mở phiên mới. Agent nhận chỉ mục ghi chú cũ và biết đại khái chuyện gì đã xảy ra. Bạn có thể hỏi thẳng:

text
Tuần trước mình sửa lỗi đăng nhập thế nào? Tìm trong ký ức giúp mình.

Agent sẽ dùng skill mem-search để tra theo ba bước. Kết quả là bạn đỡ phải đọc lại log hay lịch sử commit chỉ để nhớ lại.

B.Người mới học lập trình, hay quên mình đã thử gì

Bạn đang học và nhờ agent thử nhiều hướng để sửa một lỗi. Mỗi lần mở phiên mới bạn lại quên hướng nào đã thất bại. Có claude-mem, những lần thử trước được ghi thành quan sát, và bạn có thể yêu cầu agent liệt kê lại:

text
Tìm trong ký ức các lần mình gặp lỗi kiểu này và những cách đã thử.

Agent của bạn không còn bắt đầu mỗi phiên từ con số không.

Ông T

Kết quả: bạn tránh được việc đi lại đúng con đường đã đóng.

C.Dev dùng thử trên một repo lớn

Bạn vừa nhận một codebase lạ và muốn agent nắm trước cấu trúc. Trong agent, chạy lệnh README mô tả:

text
/learn-codebase

README nói mất khoảng 5 phút với repo cỡ thường. Sau đó, các phiên sau có sẵn ngữ cảnh về repo mà không cần bạn kể lại.

D.Làm việc nhóm

Một nhóm nhỏ dùng chung một dự án có thể bật TeamBrain, không gian chung tuỳ chọn. Mỗi người tự chọn chia sẻ gì; ghi chú cá nhân vẫn tách riêng. Hữu ích khi nhiều người cùng giao việc cho agent và muốn biết ai đã làm gì. Hướng dẫn thiết lập có trong tài liệu của dự án.

VI.Lỗi hay gặp và cách xử lý

A.Windows báo không nhận ra npm

Lỗi có dạng «The term 'npm' is not recognized…». Nghĩa là Node.js chưa cài, hoặc chưa nằm trong PATH. Cài Node.js từ nodejs.org rồi đóng và mở lại terminal.

B.Hook báo không tìm thấy claude-mem

Thông báo như Executable not found in $PATH: "claude-mem". README giải thích trình cài đặt đặt launcher ở %LOCALAPPDATA%\claude-mem\bin\claude-mem.exe và thêm thư mục đó vào Path của người dùng. Hãy khởi động lại terminal hoặc IDE để Claude Code nhận Path mới, rồi chạy:

PowerShell
npx claude-mem doctor

Nếu vẫn lỗi, xem mục Troubleshooting trong tài liệu chính thức.

C.Cài xong mà không thấy ký ức

Phần lớn là do chưa sang phiên thứ hai. README nói ký ức chỉ được nạp từ phiên thứ hai trong một dự án. Ngoài ra hãy chắc bạn đã khởi động lại agent sau khi cài, và agent đó không nằm trong nhóm chỉ-tìm-kiếm (Copilot CLI, Goose, Roo Code, Warp).

D.Cài bằng npm install -g nhưng không có tác dụng

Đúng như README cảnh báo: lệnh này chỉ cài SDK/thư viện. Hãy cài lại bằng npx claude-mem install hoặc lệnh /plugin.

E.Lo ngại về dữ liệu và thống kê ẩn danh

Ký ức nằm trên máy bạn, đồng bộ đám mây là tuỳ chọn. Thống kê sử dụng ẩn danh được bật mặc định; nếu không muốn, tắt bằng lệnh:

Terminal
npx claude-mem telemetry disable

VII.Có nên dùng không

Điểm mạnh: giải đúng một nỗi đau thật của người dùng agent hằng ngày. Cài đơn giản bằng một lệnh, tự chạy ngầm, dữ liệu lưu cục bộ, hỗ trợ nhiều agent, và có cách tìm lại tiết kiệm token. Dự án còn được cập nhật trong vài tháng gần đây và có tài liệu riêng khá đầy đủ.

Giới hạn: chính README thừa nhận mức tiết kiệm token của quy trình ba bước chưa phải là con số đo lường được từ đầu đến cuối. Một số agent chỉ tìm kiếm được chứ không ghi lại phiên. Phần observer có thể phát sinh chi phí tuỳ nguồn model bạn chọn, và luồng cài mặc định có bước đăng nhập (bỏ qua được). Thêm vào đó, nó cài thêm Bun và uv, nên nếu bạn muốn máy gọn nhẹ thì cần cân nhắc.

Khi nên chọn cách khác: nếu bạn chỉ thỉnh thoảng dùng agent, hoặc dự án nhỏ đến mức file hướng dẫn thủ công (như CLAUDE.md) là đủ, thì claude-mem có thể là hơi thừa. Còn nếu bạn làm việc đều đặn với agent trên cùng một dự án qua nhiều ngày, đây là công cụ rất đáng thử.

4.7/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

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

Repo là mã nguồn mở giấy phép Apache-2.0. Tuy nhiên README cho biết observer của claude-mem có 30 ngày dùng thử và trang thanh toán yêu cầu phương thức thanh toán. Bạn cũng có thể chọn dùng key OpenRouter/Gemini của mình hoặc gói Anthropic, chi phí khi đó phụ thuộc nhà cung cấp bạn chọn.

Cài trên Windows được không?

Được, README có riêng phần ghi chú cho Windows. Hook của Claude Code không cần Git Bash, vì mỗi hook chạy thẳng `claude-mem`. Sau khi cài, hãy khởi động lại terminal hoặc IDE để nhận Path mới.

Có cần GPU không?

README không nêu yêu cầu GPU hay cấu hình phần cứng tối thiểu. Phần yêu cầu hệ thống chỉ nói về Node.js, một agent được hỗ trợ, Bun, uv và SQLite.

Dữ liệu của tôi có an toàn không?

Theo README, ký ức nằm ở thư mục `~/.claude-mem` trên máy bạn, còn đồng bộ đám mây là tuỳ chọn. Bạn có thể bọc nội dung nhạy cảm trong một cặp thẻ riêng để nó không được lưu. Thống kê sử dụng ẩn danh bật mặc định và tắt được bằng `npx claude-mem telemetry disable`.

Hỗ trợ những agent nào?

README nói chạy được với Claude Code, Codex, Cursor, OpenCode và 11 agent khác. Copilot CLI, Goose, Roo Code và Warp chỉ tìm kiếm được ký ức, còn phiên của chúng không được ghi lại. Danh sách đầy đủ giá trị `--ide` xem bằng `npx claude-mem --help`.

Vì sao npm install -g claude-mem không hoạt động như plugin?

README ghi rõ lệnh đó chỉ cài SDK/thư viện, không đăng ký hook của plugin và không dựng dịch vụ worker. Bạn cần cài bằng `npx claude-mem install` hoặc bằng lệnh `/plugin` trong Claude Code.

Khi nào ký ức bắt đầu xuất hiện trong phiên mới?

README nói việc nạp ký ức bắt đầu từ phiên thứ hai trong một dự án. Nếu muốn nạp sẵn cả repo ngay, bạn chạy `/learn-codebase` (khoảng 5 phút với repo cỡ thường, tuỳ chọn).

Chuyển nhanh tới mục

  1. I.claude-mem làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Node.js
    2. B.Chạy trình cài đặt
    3. C.Cài từ marketplace của Claude Code
    4. D.Cài cho agent khác
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Lập trình viên quay lại dự án sau một tuần
    2. B.Người mới học lập trình, hay quên mình đã thử gì
    3. C.Dev dùng thử trên một repo lớn
    4. D.Làm việc nhóm
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Windows báo không nhận ra npm
    2. B.Hook báo không tìm thấy claude-mem
    3. C.Cài xong mà không thấy ký ức
    4. D.Cài bằng npm install -g nhưng không có tác dụng
    5. E.Lo ngại về dữ liệu và thống kê ẩn danh
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.