AiDuo123 Logo
简体|繁體
充值登录注册
★ 85,096· 7,346 forks· JavaScript· Apache-2.0开发工具

Claude-Mem:AI 代理跨會話持久化記憶引擎

thedotmack/claude-mem

為 Claude Code 等 AI 程式設計助手提供跨會話記憶壓縮系統,自動捕獲工具呼叫、生成語義摘要並注入未來會話,實現上下文持久化

成熟度：維護活躍,最近提交 0 天前,open issues 224 個,v13.9.1 版本釋出於 1 天前

GitHub 仓库 → HN 讨论 · 2 点 · 1 评论

项目体检

部署 · Docker Compose 多服务部署(Postgres + Valkey + server + worker),需配置 POSTGRES_USER/PASSWORD 等必需环境变量,默认端口未明示,严禁未修改凭据直接暴露公网

成本 · 需 Anthropic API Key(中国大陆需梯子)、Postgres 数据库、Valkey/Redis 队列,支持 ChromaDB 向量存储,非开箱即用需配置多项环境变量

技术 · JavaScript(Node.js ≥20.0.0) + Claude Agent SDK + BullMQ 队列 + Postgres/SQLite + ChromaDB 向量数据库

许可 · Apache-2.0 协议,允许商用、修改和分发,需保留版权声明

活跃 · 最新版本 v13.9.1 发布于 1 天前,122 位贡献者,最近提交 0 天前,维护极活跃

解決什麼

AI 程式設計助手(如 Claude Code、Cursor、Copilot)在每次會話結束後會丟失上下文,開發者需要反覆解釋專案背景、程式碼架構和歷史決策。Claude-Mem 通過自動捕獲 AI 代理的工具呼叫(檔案讀寫、命令執行、搜尋操作)、壓縮為語義摘要並持久化到向量資料庫,在新會話啟動時自動注入相關歷史上下文,讓 AI 助手"記住"專案的長期演進過程。

為何火

該專案在 GitHub 獲得 8.5 萬 stars,主要原因包括:1)精準擊中 AI 程式設計助手的痛點——上下文視窗有限且無法跨會話保留;2)技術實現巧妙,利用 Claude Agent SDK 的鉤子機制自動捕獲工具呼叫,無需修改現有工作流;3)支援多種 AI 工具(Claude Code、Gemini CLI、OpenCode、OpenClaw 閘道器),生態相容性強;4)採用 RAG(檢索增強生成)+ 向量嵌入技術,檢索精度高;5)Apache 2.0 協議允許商用,吸引企業級使用者。

核心功能

  • 自動記憶捕獲:監聽 AI 代理的工具呼叫(檔案編輯、終端命令、搜尋查詢),生成結構化觀察記錄
  • 語義壓縮:使用 Claude API 將原始操作日誌壓縮為高層次摘要,減少儲存成本並提升檢索相關性
  • 向量檢索:支援 ChromaDB、SQLite-VSS 等向量資料庫,通過嵌入相似度檢索歷史上下文
  • MCP 搜尋工具:提供 search_memories、search_observations 等 Model Context Protocol 工具,讓 AI 主動查詢歷史
  • 多 IDE 支援:通過外掛或閘道器模式整合 Claude Code、Gemini CLI、OpenCode、OpenClaw
  • 分散式架構:Server-Beta 模式採用 Postgres + BullMQ 佇列,支援多 worker 橫向擴充套件生成任務

安裝

快速安裝(推薦):

npx claude-mem install

自動檢測 Claude Code 配置目錄並註冊外掛鉤子。

Gemini CLI:

npx claude-mem install --ide gemini-cli

OpenCode:

npx claude-mem install --ide opencode

OpenClaw 閘道器:

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

Docker 部署(需先配置 .env 檔案):

docker compose up -d

必需環境變數包括 POSTGRES_USER、POSTGRES_PASSWORD、CLAUDE_MEM_REDIS_URL、Anthropic API Key。

⚠️ 注意:npm install -g claude-mem 僅安裝 SDK 庫,不會註冊外掛,必須用 npx 或 /plugin 命令安裝。

適合誰

  • 長期專案開發者:需要 AI 助手"記住"數月前的架構決策和程式碼演進
  • 團隊協作場景:通過 OpenClaw 閘道器共享記憶,讓團隊成員的 AI 助手訪問統一上下文
  • AI 工具重度使用者:每天使用 Claude Code/Cursor 編寫大量程式碼,需要減少重複解釋
  • 隱私敏感使用者:支援本地 SQLite 儲存,無需將程式碼上下文上傳到第三方服務
  • 企業級部署:Server-Beta 模式支援 Postgres + Redis 叢集,滿足高併發和資料持久化需求

中國大陸使用者注意:Anthropic API 需科學上網,可考慮使用支援國內 API 的分支或自建代理。

社群評價

HN 討論熱度較低(2 點、1 評論),社群公開討論不足。基於專案本身的中立評估:該專案技術實現紮實,利用 Claude Agent SDK 的鉤子機制實現無侵入式記憶捕獲,架構設計合理(分離 server 和 worker 服務),支援多種向量資料庫和佇列引擎。8.5 萬 stars 表明需求真實,但 224 個 open issues 顯示維護壓力較大。文件完善(支援 30+ 語言),但 Docker 配置檔案中明確警告"禁止未修改憑據直接暴露公網",說明安全配置門檻較高。

選型對比

vs Mem0/SuperMemory:

  • Mem0 是通用 AI 記憶層,支援多種 LLM 和應用場景;Claude-Mem 專為程式設計助手最佳化,深度整合 Claude Agent SDK
  • SuperMemory 側重個人知識管理;Claude-Mem 聚焦程式碼工具呼叫的自動捕獲

vs 商業方案(Cursor 內建記憶):

  • Cursor 的記憶功能閉源且繫結平臺;Claude-Mem 開源且支援多 IDE
  • Claude-Mem 支援自託管,資料完全可控

vs 手動維護專案文件:

  • 傳統方式需人工更新 README/Wiki;Claude-Mem 自動生成語義摘要,減少維護成本
  • 但自動化可能引入噪聲(無關操作被記錄),需定期清理

已知坑

  1. API 成本:每次壓縮呼叫 Claude API,高頻使用可能產生顯著費用(據 README,可配置壓縮策略)
  2. 國內網路:Anthropic API 需梯子,部署時需配置代理或使用國內相容 API
  3. Docker 安全:配置檔案明確警告"必須修改 Postgres 憑據",預設配置禁止生產使用
  4. 依賴複雜:Server-Beta 模式需 Postgres + Valkey/Redis + 向量資料庫,運維成本較高
  5. Issue 積壓:224 個 open issues 表明功能請求和 bug 修復可能延遲
  6. 向量資料庫選型:ChromaDB 需單獨部署,SQLite-VSS 效能有限,需根據規模權衡
  7. 記憶汙染:無關操作(如臨時測試檔案)可能被記錄,需手動清理或配置過濾規則

來源: GitHub thedotmack/claude-mem + HN 討論

安装方式：npx

← 浏览全部项目