90,956 颗星背后：claude-mem 如何让 AI 编程 Agent 真正”记住”你的代码库

器匠·开发者工具 技术创作者 2026-08-17 566 阅读

90,956 颗星背后：claude-mem 如何让 AI 编程 Agent 真正”记住”你的代码库

如果你每天用 Claude Code、Codex 或 OpenClaw 写代码，大概率遇到过这个尴尬时刻：昨天花了半小时跟 AI 讨论清楚的项目架构，今天重新打开会话，它一脸茫然——上下文没了，从头解释。这种”失忆”在长时间项目开发中是高频痛点，而 claude-mem 正是目前社区解决这个问题的最成熟方案。

它到底是什么

claude-mem 是一个专为 AI 编程 Agent 设计的跨会话持久记忆系统。它的核心逻辑很直接：在每个编程会话结束时，把这次会话里 AI 看到的、做的、决定的事情压缩存储；下次开新会话时，把相关记忆自动注入进去，让 AI 从”认识”这个项目开始。

这个项目来自独立开发者 thedotmack，开源协议 Apache 2.0，当前版本 v13.15.2（2026-08-16 刚更新），已经支持 Claude Code、OpenClaw、Codex、Gemini、Hermes、Copilot、OpenCode 等主流 Agent——不是只有一个 Claude Code 专属插件，是一个通用记忆层。

从技术标签看，它的关键词是：ai-memory、chromadb、sqlite、embeddings、long-term-memory、rag。超过 9 万颗星，7,948 个 Fork，197 个 open issues，社区活跃度相当高。

技术实现：钩子 + 混合存储

claude-mem 选择了对 Agent 非侵入式的设计路径。它不修改 Agent 源码，而是通过 Agent 的外部命令钩子（settings.json 配置）来”监听”关键生命周期事件。

具体来说，它在 7 个钩子上工作：

钩子 触发时机 作用
context-hook 会话启动 注入最近相关记忆作为上下文
new-hook 用户提问时 创建新会话记录并保存提示词
save-hook 工具执行后 捕获文件读写等操作观察记录
summary-hook 会话结束 生成 AI 摘要并持久化存储
cleanup-hook 停止指令 清理临时数据

这种设计保证了几个原则：不修改 Agent 二进制、不影响运行速度、无需为每个项目单独配置。

存储层采用 SQLite FTS5 + Chroma 向量库双轨并行：

  • SQLite FTS5 负责关键词精准匹配（变量名、文件名等精确检索）
  • Chroma 负责语义相似度计算（模糊查询，如”上次讨论的那个架构问题”）
  • 两者通过 RRF（倒数排名融合）算法合并结果

根据社区测试数据，10GB 代码库可压缩至约 200MB，每次启动节省约 2,250 个 Tokens，向量检索响应时间小于 50ms。

最新动态：云端同步来了

最近的几个版本值得注意：

  • v13.11.0（2026-07）：正式上线 CloudSync 功能，独立的 cloud-sync.mjs 守护进程退役，记忆同步现在由 worker 直接处理，每次本地写入后触发 1.5s 防抖合并，批量同步至 cmem.ai 云端，支持 GET /api/sync/status 查看同步状态。这意味着 claude-mem 从纯本地工具正式走向云端同步，多设备协同成为可能。

  • v13.15.0（2026-08-10）：安装器内置 7 天 CMEM Pro 免费试用，从 npx 安装到 Stripe 结算完整打通。

  • v13.15.2（2026-08-16）：当 memory observer 停止工作时（最常见原因是 CMEM Pro 配额用尽），现在直接提示用户原因和解决方案，而不是静默失败。

适合谁 / 不适合谁

适合：

  • 长时间维护大型代码库的开发者（几千行以上、多模块协作）
  • 同时跑多个 Agent 会话、需要上下文连贯性的团队
  • 需要在断点处精确恢复工作现场的工程师
  • 对 token 成本敏感、希望减少每次会话重复说明的深度用户

不太适合：

  • 项目规模小、单次会话能完成的简单任务（反而增加了配置成本）
  • 完全依赖 Agent 短期记忆就能跑通的探索性实验
  • 对本地数据存储有严格合规要求、无法安装额外服务的环境
  • 追求极致轻量化的极简用户（claude-mem 依赖 Node.js ≥ 20 + PM2 守护进程）

可执行的下一步

如果你决定试试，最快路径：

# 1. 一行命令安装（会自动引导配置）
npx claude-mem install

# 2. 验证安装
claude-mem status

# 3. 启动 Pro 试用（可选，体验完整功能）
claude-mem pro trial

# 4. 文档
# https://docs.claude-mem.ai

对于 OpenClaw 用户，项目已明确将 OpenClaw 列入支持列表，安装后直接在 OpenClaw 会话中生效，不需要额外适配。

链接：

评论区

0 条评论

登录后可评论。

器匠·开发者工具 566 阅读