Claude-Mem

Claude-Mem是什麼

Claude-Mem 是開發者 Alex Newman 打造的一款 Claude Code 智能記憶插件。通過 SessionStart、PostToolUse 等五個生命週期鉤子自動捕獲會話中的工具調用、代碼決策與調試過程，利用 Claude Agent SDK 將原始輸出壓縮爲結構化觀察記錄（約 500 令牌），存儲在本地 SQLite + Chroma 向量數據庫中。當用戶開啓新會話時，插件自動注入相關的歷史上下文，使 Claude 能夠”記住”之前的項目背景、架構決策和 Bug 修復過程，無需用戶反覆重新說明。插件支持 Web 可視化界面、隱私標籤、多語言模式，兼容 Gemini CLI 和 OpenClaw 網關。

查看原圖來源（外部連結）

Claude-Mem的主要功能

• 自動上下文捕獲：通過 5 個生命週期鉤子（SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd）自動記錄會話全程，無需手動干預。
• AI 智能壓縮：將工具輸出壓縮爲結構化觀察記錄（含 type、title、facts、narrative、concepts 字段），單條約 500 令牌，節省上下文空間。
• 混合搜索能力：集成 SQLite FTS5 全文搜索 + Chroma 向量數據庫語義搜索，支持 10 種搜索端點（全文、概念標籤、文件引用、類型過濾等）。
• 三層漸進檢索：Layer 1 搜索返回 50-100 令牌的索引；Layer 2 時間線提供 100-200 令牌的上下文；Layer 3 按需獲取完整記錄（500-1000 令牌），信號率從 6% 提升至 80% 以上。
• Web 可視化界面：內置 HTTP API 服務（默認端口 37777），提供瀏覽器端的實時記憶流查看與管理界面。
• Endless Mode（實驗性）：突破 Claude Code 約 50 次工具調用後上下文超限的限制，通過實時轉錄轉換實現理論上無限長的會話，實測完成 600+ 文件的完整重構。
• 自動 CLAUDE.md 生成：在項目文件夾中自動生成並更新包含活動時間線的 CLAUDE.md 文件，保留手動編寫內容。
• 隱私控制：使用 <private> 標籤即可將敏感內容排除在存儲之外，所有數據默認本地保存。
• 多語言與模式系統：支持 28 種語言，提供 Code、Email Investigation、Chill 等工作流模式切換。

如何使用Claude-Mem

• 在 Claude Code 中執行：

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

• 重啓 Claude Code：使生命週期鉤子生效。
• 驗證安裝（三選一）：
  • 終端運行 curl http://localhost:37777/api/health，應返回 {"status":"ok"}
  • 檢查 ~/.claude/hooks.json 包含 claude-mem 的 PostToolUse 和 SessionStart 條目
  • 瀏覽器打開 http://localhost:37777 查看 Web 查看器
• 開始使用：第一次會話開始積累觀察記錄，第二次會話起自動注入相關上下文。

Claude-Mem的關鍵信息和使用要求

• 產品定位：專爲 Claude Code 設計的開源智能記憶插件，通過生命週期鉤子自動捕獲並持久化編碼會話上下文，解決 AI 助手跨會話”失憶”問題
• 核心架構：基於 5 個生命週期鉤子（SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd）實現全自動記錄，無需手動觸發保存
• 智能壓縮機制：利用 Claude Agent SDK 將原始工具輸出壓縮爲結構化觀察記錄（含 type、title、facts、narrative、concepts 字段），單條約 500 令牌，極大節省上下文空間
• 三層漸進檢索：Layer 1 search 返回 50-100 令牌索引 → Layer 2 timeline 提供 100-200 令牌時間線上下文 → Layer 3 get_observations 按需獲取完整 500-1000 令牌記錄，信號率從 6% 提升至 80% 以上
• 混合存儲方案：本地 SQLite 數據庫（FTS5 全文搜索）+ Chroma 向量數據庫（語義搜索），默認存儲路徑爲 ~/.claude-mem/claude-mem.db
• 本地嵌入模型：採用 all-MiniLM-L6-v2 via ONNX 運行，所有向量計算均在本地完成，無需調用外部 Embedding API
• Web 可視化界面：內置 HTTP 服務（默認端口 37777），瀏覽器打開 http://localhost:37777 即可查看實時記憶流與管理界面
• 安裝方式：必須在 Claude Code 內通過插件市場安裝，執行 /plugin marketplace add thedotmack/claude-mem 後 /plugin install claude-mem，嚴禁使用 npm install -g claude-mem（該命令僅安裝 SDK 庫，不會註冊生命週期鉤子，導致功能完全失效）
• 系統前提：Node.js 18+ 爲硬性要求；Bun、uv、SQLite 等依賴在首次運行時會自動檢測並安裝
• 重啓生效：安裝完成後必須重啓 Claude Code，使 hooks 配置寫入 ~/.claude/hooks.json 並生效

Claude-Mem的核心優勢

• 真正的跨會話連續性：解決 Claude Code 每次新會話”從零開始”的問題，昨天的調試記錄、上週的架構決策均可直接引用。
• Token 成本極低：相比傳統 MCP 方式可節省約 2,250 個令牌，三層檢索架構避免一次性加載 35,000 令牌的低效做法。
• 零配置自動化：安裝後全自動運行，無需手動記錄日誌或觸發保存，後台工作者平均 8ms 完成非阻塞壓縮。
• 本地優先，隱私安全：數據默認保存在 ~/.claude-mem/claude-mem.db，無需額外 API 密鑰，敏感內容可通過標籤排除。
• 跨生態兼容：不僅支持 Claude Code，還兼容 Gemini CLI、Cursor、Windsurf、OpenClaw 網關，跨 Linux/macOS/Windows 平台。
• 多機器同步：通過 claude-mem-sync 支持開發者通過 SSH 在多台機器間同步觀察記錄和會話摘要。

Claude-Mem的同類競品對比

Claude-Mem的應用場景

• 跨會話接力開發：昨天與 Claude 一起修復的競態條件，今天直接繼續推進，無需重新分析。
• 超大規模重構：用 Endless Mode 完成涉及 600+ 文件的框架遷移或代碼重構，不受上下文窗口限制。
• 多代碼庫管理：在十個不同代碼庫間切換，各自擁有獨立的記憶空間，避免信息串擾。
• 調試知識沉澱：自動捕獲調試模式與解決方案，形成可檢索的”故障排查大腦”。
• 新成員上下文同步：通過多機器同步或共享 CLAUDE.md，幫助新加入的開發者快速獲取項目歷史決策。