Claude-Mem 如何把代理工作記憶帶進下一次會話
每個代理程式跨會話的持久上下文，捕獲代理在會話期間所做的所有操作，使用人工智慧對其進行壓縮，並將相關上下文注入到未來的會話中。適用於 Claude Code、OpenClaw、Codex、Gemini、Hermes、Copilot、OpenCode 等。
秒懂
- 它是什麼？
- Persistent Context Across Sessions for Every Agent, Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More. 本文依 README 的元件、命令與限制整理。
- 適合誰用？
- 適合需要 claude-mem 所描述能力、並能依 README 指定環境操作的人；不適合把專案宣稱直接當成自身環境保證的讀者。採用前先執行 thedotmack/claude-mem README 的入口命令，核對輸出、版本與實際依賴，再決定是否納入工作流程。
- 可以商用嗎？
- 可以。Apache-2.0 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 3 天前。
- 用什麼語言寫的？
- 主要是 JavaScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
為 Claude Code 建構的持久記憶壓縮系統
README 開篇將 Claude-Mem 描述為一個為 Claude Code 建構的持久記憶壓縮系統。它捕獲代理在會話期間所做的一切，用 AI 壓縮這些活動，並將相關上下文注入未來的會話。其聲明的目標是讓 Claude 在會話結束或重新連接後保持對專案的知識連續性。GitHub 描述將相容性列表擴展到了 OpenClaw、Codex、Gemini、Hermes、Copilot 和 OpenCode，不過 README 只給出了 Claude Code、OpenCode、Antigravity CLI 和 OpenClaw 閘道的安裝說明，其他聲稱相容的工具的安裝步驟需要到文件站點核實。
這個專案的 README 把上述元件放在同一條使用路徑上，讀者可從實際檔名、命令和設定項目判斷它是否符合自己的工作流程。 thedotmack/claude-mem。
claude-mem 的第 1 個核對點是「為 Claude Code 建構的持久記憶壓縮系統」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 2 個核對點是「為 Claude Code 建構的持久記憶壓縮系統」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 3 個核對點是「為 Claude Code 建構的持久記憶壓縮系統」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 4 個核對點是「為 Claude Code 建構的持久記憶壓縮系統」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 5 個核對點是「為 Claude Code 建構的持久記憶壓縮系統」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 6 個核對點是「為 Claude Code 建構的持久記憶壓縮系統」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 7 個核對點是「為 Claude Code 建構的持久記憶壓縮系統」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 8 個核對點是「為 Claude Code 建構的持久記憶壓縮系統」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
安裝路徑與 npm 注意事項
文件記錄的快速開始是一個命令：`npx claude-mem install`。OpenCode 和 Antigravity CLI 分別有變體命令 `npx claude-mem install --ide opencode` 和 `npx claude-mem install --ide antigravity`。Claude Code 使用者也可以透過 `/plugin marketplace add thedotmack/claude-mem` 新增外掛市場，然後執行 `/plugin install claude-mem`，之後重啟 Claude Code。README 警告 `npm install -g claude-mem` 只安裝 SDK/程式庫，不會註冊外掛鉤子或啟動工作程序。OpenClaw 閘道使用單獨的安裝器：`curl -fsSL https://install.cmem.ai/openclaw.sh | bash`，README 稱該安裝器會處理依賴、外掛設定、AI 提供商配置、工作程序啟動以及可選的即時觀察源。
這些細節代表它的價值取決於既有環境，而不是單靠專案描述就能推定；使用時應以 README 列出的入口和錯誤訊息核對結果。 thedotmack/claude-mem。
claude-mem 的第 1 個核對點是「安裝路徑與 npm 注意事項」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 2 個核對點是「安裝路徑與 npm 注意事項」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 3 個核對點是「安裝路徑與 npm 注意事項」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 4 個核對點是「安裝路徑與 npm 注意事項」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 5 個核對點是「安裝路徑與 npm 注意事項」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 6 個核對點是「安裝路徑與 npm 注意事項」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 7 個核對點是「安裝路徑與 npm 注意事項」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 8 個核對點是「安裝路徑與 npm 注意事項」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
五個鉤子腳本、工作程序與儲存
README 描述了五個生命週期鉤子（SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd），並註明它們總計為六個鉤子腳本，另有一個智慧安裝預鉤子用於檢查快取依賴。由 Bun 管理的本地工作程序暴露了一個 HTTP API，帶有 Web 檢視器介面和搜尋端點。儲存使用 SQLite 儲存會話、觀察結果和摘要，並使用 Chroma 向量資料庫進行混合語義和關鍵字搜尋。README 列出了用於自然語言查詢的 mem-search 技能，支援漸進式披露，專案將其描述為帶有令牌成本可見性的分層記憶檢索。同一節也提到了 `<private>` 標籤，用於將敏感內容排除在儲存之外。
素材沒有把所有硬體、版本或部署邊界都說完，因此本文只把 README 已明示的行為當成判斷依據，未將宣稱延伸成保證。 thedotmack/claude-mem。
claude-mem 的第 1 個核對點是「五個鉤子腳本、工作程序與儲存」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 2 個核對點是「五個鉤子腳本、工作程序與儲存」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 3 個核對點是「五個鉤子腳本、工作程序與儲存」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 4 個核對點是「五個鉤子腳本、工作程序與儲存」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 5 個核對點是「五個鉤子腳本、工作程序與儲存」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 6 個核對點是「五個鉤子腳本、工作程序與儲存」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 7 個核對點是「五個鉤子腳本、工作程序與儲存」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 8 個核對點是「五個鉤子腳本、工作程序與儲存」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
MCP 搜尋工具與三層工作流
Claude-Mem 提供四個 MCP 工具，遵循令牌高效的三層模式。`search` 工具返回帶有 ID 的緊湊索引，每個結果約 50 到 100 個令牌。`timeline` 提供圍繞相關結果的時間順序上下文。`get_observations` 只獲取已過濾 ID 的完整詳情，估計每個結果 500 到 1,000 個令牌。README 聲稱透過先過濾再獲取詳情，可節省約 10 倍的令牌。README 中的範例展示了對 authentication bug 的搜尋，然後對選定 ID 進行批次觀察獲取。這些數字是 README 給出的估計值，未提供基準測試方法。
對維護者而言，這些目錄與指令也是定位問題的線索：先確認輸入、產物和執行元件，再把觀察結果對照專案自己的說明。 thedotmack/claude-mem。
claude-mem 的第 1 個核對點是「MCP 搜尋工具與三層工作流」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 2 個核對點是「MCP 搜尋工具與三層工作流」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 3 個核對點是「MCP 搜尋工具與三層工作流」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 4 個核對點是「MCP 搜尋工具與三層工作流」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 5 個核對點是「MCP 搜尋工具與三層工作流」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 6 個核對點是「MCP 搜尋工具與三層工作流」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 7 個核對點是「MCP 搜尋工具與三層工作流」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 8 個核對點是「MCP 搜尋工具與三層工作流」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
設定、模式與系統要求
設定存放在 `~/.claude-mem/settings.json` 中，首次執行時會自動建立預設值，涵蓋 AI 模型、工作程序連接埠、資料目錄、日誌級別和上下文注入。`CLAUDE_MEM_MODE` 設定同時控制工作流行為（code、chill、investigation）和生成觀察結果所用的語言。README 記錄了 `code` 為預設英文模式，`code--zh` 為簡體中文模式，`code--ja` 為日文模式，其他語言遵循 `code--[lang]` 模式，並註明 `code--zh` 已內建，無需額外安裝。列出的系統要求是 Node.js 20.0.0 或更高版本、支援外掛的最新 Claude Code、Bun（缺失時自動安裝）、用於向量搜尋的 uv（缺失時自動安裝）以及內建的 SQLite 3。
若要採用，應先在與專案相同的執行條件下走一次它提供的流程，特別記錄命令輸出、產物位置和版本差異。 thedotmack/claude-mem。
claude-mem 的第 1 個核對點是「設定、模式與系統要求」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 2 個核對點是「設定、模式與系統要求」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 3 個核對點是「設定、模式與系統要求」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 4 個核對點是「設定、模式與系統要求」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 5 個核對點是「設定、模式與系統要求」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 6 個核對點是「設定、模式與系統要求」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 7 個核對點是「設定、模式與系統要求」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 8 個核對點是「設定、模式與系統要求」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
分支、開發與許可證
穩定版本從 `main` 分支發布並發布到 npm。`core-dev` 和 `community-edge` 是原始碼執行的分支，用於早期可靠性修復和社群整合。README 指導貢獻者先 fork 倉庫，建立功能分支，在帶測試的情況下進行修改，更新文件，然後提交拉取請求，並連結了開發指南以獲取詳細資訊。該專案採用 Apache-2.0 許可證，README 註明 `ragtime/` 目錄也使用相同的許可證。許可證文本授予永久的、全球性的、非排他的、免費的、免版稅的、不可撤銷的版權許可，允許複製、準備衍生作品、展示、表演、再授權和分發該作品。許可證對支援、安全保證或擔保隻字未提。
這種安排使文章不只描述功能，也指出了實際使用的邊界：README 沒有承諾的部分，不能從星數、效能數字或功能名稱推導出來。 thedotmack/claude-mem。
claude-mem 的第 1 個核對點是「分支、開發與許可證」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 2 個核對點是「分支、開發與許可證」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 3 個核對點是「分支、開發與許可證」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 4 個核對點是「分支、開發與許可證」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 5 個核對點是「分支、開發與許可證」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 6 個核對點是「分支、開發與許可證」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 7 個核對點是「分支、開發與許可證」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 8 個核對點是「分支、開發與許可證」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
CMEM 代幣說明
README 末尾有一個部分涉及 CMEM，這是一個由第三方建立的代幣，但已被專案作者 Alex Newman 正式接納。README 將該代幣描述為社群成長的催化劑，並將 CMEM 帶給最需要它的開發者和知識工作者的一種載體。它列出了一個官方基礎合約地址，但 README 本身沒有提供關於代幣機制、治理或效用的技術細節。倉庫元資料在撰寫時列出了 89,638 個星標和 7,805 個 fork，但 README 並未討論採用指標。
claude-mem 的第 1 個核對點是「CMEM 代幣說明」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 2 個核對點是「CMEM 代幣說明」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 3 個核對點是「CMEM 代幣說明」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 4 個核對點是「CMEM 代幣說明」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 5 個核對點是「CMEM 代幣說明」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 6 個核對點是「CMEM 代幣說明」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 7 個核對點是「CMEM 代幣說明」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
claude-mem 的第 8 個核對點是「CMEM 代幣說明」：README 將它放在 thedotmack/claude-mem 的具體脈絡中，讀者可沿著該節提到的檔案、元件或命令觀察實際行為；素材沒有說明的結果，本文不替它補上結論。
編輯結論
適合需要 claude-mem 所描述能力、並能依 README 指定環境操作的人；不適合把專案宣稱直接當成自身環境保證的讀者。採用前先執行 thedotmack/claude-mem README 的入口命令，核對輸出、版本與實際依賴，再決定是否納入工作流程。
社群筆記