Claude-Mem

Claude-Mem详细介绍

用 Claude Code 写代码的人大多遇到过这种尴尬：上个会话里刚定下的技术选型、刚定位到的 bug 原因，新开会话智能体就全忘了，只能重新描述一遍背景。Claude-Mem 解决的就是这个失忆问题，这款插件在智能体的生命周期里挂上钩子，自动捕获每次工具调用的结果，交给大模型压缩成结构化的观察记录，存进本地 SQLite 数据库，等下次会话开始时把相关的历史自动注入上下文。

整个项目在 GitHub 上已积累近十万星标，作者是独立开发者 Alex Newman，从发布到爆火只用了很短时间，可见编程智能体缺记忆这件事戳中了多少人的痛点。安装方式与主流智能体生态贴合，在 Claude Code 里执行 npx claude-mem install 或者添加插件市场即可，也支持 OpenClaw、Codex CLI、Gemini CLI、Cursor、Windsurf 等多个框架，仓库里还带着针对不同 IDE 的适配目录，兼容性做得比较广。

存储与检索是 Claude-Mem 比较讲究的部分。观察记录落入本地 SQLite 支持全文检索，同时可选接 Chroma 向量库做语义搜索，两条路互补。检索时遵循三层渐进式流程，先用 search 拿紧凑的带编号索引，再用 timeline 看某条记录附近发生了什么，最后只对真正相关的编号调 get_observations 取全文，官方称这套设计相比一次性全量拉取能省约十倍 token。压缩与检索使用的模型可以在配置文件里切换，本地没有 Anthropic 账号的话也能换 OpenRouter 或 Gemini 的密钥。

隐私方面做得比较克制，数据默认全部留在本机，用户可以用 private 标签把不想入库的敏感内容排除，设置文件里还能调工作模式与生成语言，内置中文等多套语言模式。要提醒的是，别用 npm install -g 直接全局装，那只会装到 SDK 库而不会注册插件钩子与后台服务，正确入口是 npx claude-mem install；压缩观察需要调用大模型，会话操作密集时 API 消耗会随之上涨，把模型从默认档换成更便宜的档位能压一压成本。若需要跨设备同步记忆，官方提供托管的 CMEM Pro 服务，本地自托管则始终免费。

综合来看，Claude-Mem 适合那些长期泡在智能体编程里、被反复重述项目背景折磨的开发者，装上之后智能体才算真正记得住昨天干到哪、为什么这么干。如果只是偶尔用一次智能体写小脚本，这个记忆插件带来的收益有限，可以先不考虑。

Claude-Mem的核心功能

• 生命周期钩子自动采集：在会话启动、用户提交、工具调用、会话结束等节点挂接脚本，自动记录文件改动、命令执行、决策过程，全程无需手动保存。
• AI 压缩结构化观察：原始工具日志交给大模型提炼成带类型的观察记录，区分 bug 修复、功能新增、重构、发现、决策等类型，去重后存入数据库。
• 本地双存储检索：SQLite 提供精确的全文检索，Chroma 向量库承担语义检索，关键词与语义两种方式互补，数据默认不离开本机。
• 跨会话上下文自动注入：新会话启动时自动查找并注入最近相关会话的摘要与观察，智能体开局就带着上次的进度与结论，不用再人工复述。
• 三层渐进式记忆检索：通过 MCP 工具按索引、时间线、全文三个层级取数，先筛后取，把记忆查询的 token 开销控制到较低水平。
• Web 查看器与引用：本地服务提供网页界面实时查看记忆流，观察记录带编号 ID，可被智能体引用与回溯。
• 隐私控制与多语言模式：private 标签可排除敏感内容不入库，设置文件支持调整工作模式与生成语言，内置中文等多语言模式。
• 跨 IDE 与多智能体接入：除 Claude Code 外支持 OpenCode、Cursor、Gemini CLI、Codex CLI 等，OpenClaw 网关场景还能把记忆能力接到 Telegram、Discord 等渠道。

Claude-Mem的价格详情

免费权益：

Claude-Mem 本地引擎以 Apache 2.0 许可完全开源，安装与日常使用无需注册账号、不强制绑定支付方式，会话记忆的采集、压缩与检索全部在本机完成；托管记忆服务 CMEM Pro 提供 30 天免费试用，试用结束后未订阅会自动回落到自带模型方案。价格可能随官方调整。

收费模式：

开源的本地记忆引擎对个人开发者永久免费，可自行部署；可选的托管服务 CMEM Pro 提供跨设备记忆云同步、托管观察等能力，试用期内离线优先，具体订阅价格未在仓库内直接标注，以官网 cmem.ai 公布为准，价格可能随官方调整。

Claude-Mem的应用场景

• 大型项目跨会话续接：连续几天用智能体推进同一个代码库，每天新开会话都能自动带上昨天的进度、决定与待办，不必重复交代背景。
• Bug 修复过程回溯：某个问题改过又复发时，用语义检索翻出当初定位与修复的完整观察，看当时的判断依据与改动文件。
• 技术选型决策复盘：把几次架构讨论、选型对比的记录存进记忆，后续评审或新成员接手时直接调取当时的权衡过程。
• 多智能体并行协作：OpenClaw 网关等场景下多个智能体共享同一份记忆库，各自产生的观察与结论沉淀为团队可检索的知识。
• 代码库探索结果复用：智能体分析过一遍项目结构后，调研结论留在记忆里，下次相关任务直接命中，不用重新遍历整个代码库。
• 多机工作环境衔接：配合托管同步能力，在办公机器与个人机器之间保持记忆一致，换台设备接着聊上次的思路。

Claude-Mem的适用人群

• 长期维护大型项目的开发者：项目周期横跨大量会话，让智能体记住模块改动与决策历史，减少重复解释和误判。
• Claude Code 重度用户：天天靠智能体写代码、改代码，最直接受益于会话间上下文不丢失这一核心能力。
• 同时使用多个编程智能体的尝鲜者：一份记忆库通用于 Codex、Gemini CLI、Cursor 等多个工具，切换工具不丢上下文。
• 注重隐私与数据自持的开发者：所有记录默认留在本地 SQLite，敏感内容可标记排除，适合处理不便外传的代码库。
• 研究智能体记忆机制的开发者：Apache 2.0 开源实现配合架构文档，是理解 Agent 记忆、上下文压缩与混合检索的现成参考。
• 依赖智能体做技术调研的团队技术骨干：把多轮调研、踩坑与结论沉淀成可检索记录，团队协作时按需调取共享经验。

同类工具对比