Plugin Claude-Mem 让编码智能体跨会话不忘事的记忆系统

用 Claude Code 这类终端智能体的人，多半遇到过同一个尴尬：昨天跟它聊了一下午的项目背景、踩过的坑、定下的方案，今天新开一个会话，它忘得一干二净。你不得不把关键信息再粘贴一遍，或者手动维护一个 MEMORY 文件让 AI 去读。更实际的问题是 token——为了「让它记得」，你得把大段历史塞回上下文，费用和延迟一起上涨。thedotmack 开源的 Claude-Mem 就是冲着这个痛点来的：它把自己描述为「为 Claude Code 打造的持久化记忆压缩系统」，在会话过程中自动捕获工具调用观察，生成语义摘要，供未来会话检索，让跨会话的知识连续性不再靠人手搬运。

这个项目在社区里的热度相当夸张：上线后登上 Trendshift 热榜，拿到 Vercel OSS 计划支持，GitHub 星数已超过 10.2 万，最近一次更新就在 2026 年 10 月 25 日，版本号一路迭代到 v15.1.0。它采用 Apache-2.0 协议，TypeScript 编写，官方 README 提供三十多种语言翻译，中文用户可以直接读中文文档。对「会话失忆」这个真问题，它给了一套自动化的答案。

项目基本信息

一、项目介绍

Claude-Mem 的工作方式分三层：捕获、压缩、检索。会话进行时，它通过钩子机制自动记录智能体的工具调用与关键观察；随后把这些原始记录压缩成语义摘要存进本地记忆库；下次会话启动时，相关记忆自动出现在上下文里，无需你手动提醒。它提供「渐进式披露」的检索设计——按需分层加载记忆，token 成本对用户可见，避免一次性倒灌整个历史把上下文撑爆。

搜索能力由内置的三步 mem-search 技能提供，可以像查数据库一样查询项目历史。安装面也很宽：Claude Code、OpenCode、T3 Code、Antigravity CLI、Grok Bot、DeepSeek Harness、OpenClaw 网关都有对应安装方式，官方明确支持 OpenClaw 网关一键部署，还能把观察实时推送到 Telegram、Discord、Slack。

二、核心优势

第一，全自动，零手工维护。记忆的捕获和摘要都在后台完成，用户要做的只有安装那一条命令。对比手动写 MEMORY 文件的方案，它把「记笔记」这件事从人转移给了系统。

第二，跨工具通用。一套记忆层同时服务 Claude Code、Codex、OpenCode 等主流 CLI 智能体，换工具不丢记忆。对在不同 AI 客户端之间横跳的开发者，这个连续性很值钱。

第三，token 意识贯穿设计。渐进式披露让记忆按需加载，检索成本可见可调；官方口径是「记忆离线运行，最多让你的套餐多出 100% 可用量」，这对重度用户是真金白银。

第四，部署形态灵活。记忆提供方可以选官方托管 observer、自己的 OpenRouter/Gemini key，或直接走 Anthropic 订阅，不强制绑定某一家的账号体系。

第五，工程完成度高。三十多种语言的 README、完整的文档站、OpenClaw 一键安装脚本、T3 Code 等新平台的快速适配，都说明这不是一个玩具项目。

三、适用场景

长期在一个大型项目上迭代的开发者：架构决策、历史坑位、模块约定这类知识，最值得跨会话保留。在多个 AI 编码客户端之间切换的团队：Claude Code 聊一半，换 OpenCode 接着聊，记忆不断档。需要审计智能体工作过程的场景：所有观察都有记录，可回放、可检索。重度订阅用户：压缩后的记忆复用能显著降低重复上下文的 token 消耗。想给智能体加「项目直觉」的团队：把踩坑经验沉淀成可检索资产，而不是散落在聊天记录里。

四、安装教程

最简方式，一条命令安装到 Claude Code：

npx claude-mem install

安装完成后按提示在浏览器登录（邮箱魔术链接，无需信用卡），登录后 provisioning 一个记忆 key，并解锁 30 天免费试用。不想登录也可以，加 --provider 指定提供方，或设置 CLAUDE_MEM_ONLINE_OPTIN=false 跳过账户交互，CI 等非交互环境会自动免登录完成安装。

给其他智能体安装时加 --ide 参数：

npx claude-mem install --ide opencode
npx claude-mem install --ide t3code

也可以在 Claude Code 内用插件市场安装：

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

常见报错：其一，装完不生效——绝大多数情况是没重启客户端，OpenCode 需 1.3.4 以上版本，装完必须重启。其二，npm install -g claude-mem 后发现没有记忆功能——官方明确警告这样只装到 SDK 库，不会注册插件钩子，必须用 npx claude-mem install 或插件市场。其三，试用结束后记忆会自动回落到你的 Anthropic 套餐，不会突然中断，但想继续用托管 observer 需要订阅。

五、使用示例

安装并登录后重启 Claude Code，进入一个项目目录直接开始对话。第一次会话你正常提需求，比如「给这个 Express 项目加上 JWT 鉴权，refresh token 放 Redis」。Claude-Mem 在后台把这次会话的关键决策（选用的库、密钥存放位置、中间件顺序）压缩成观察记录。第二天新开会话，你只需说「继续完善 JWT 那块，把过期策略改成滑动过期」，相关记忆会自动进入上下文，智能体知道你说的「那块」是什么、Redis 用在了哪里。

检索历史用自然语言即可，例如让它「找出上周关于数据库连接池的结论」。系统通过 mem-search 技能定位到对应记忆条目，按需加载，而不是把整段历史倒进上下文。侧边栏里还能看到每次记忆加载的 token 成本，便于控制预算。

六、常见问题

问：记忆存在哪里，隐私吗？答：默认使用官方托管记忆服务，账号体系隔离；也可以指定自己的 OpenRouter 或 Gemini key，或完全本地提供方。敏感项目建议先读文档确认数据流向再决定提供方。

问：Grok Bot 安装为什么要加 --ide grok-bot？答：Grok Bot 没有宿主钩子，Claude-Mem 改为监听其聊天日志文件，默认接入 CMEM Pro 托管记忆，本地观察者需显式 --provider host 开启。

问：免费试用结束后会怎样？答：记忆自动回落到你的 Anthropic 套餐继续运行，不中断；托管 observer 的进阶功能需要订阅。

问：为什么装了插件但新会话看不到旧上下文？答：先确认客户端版本满足要求并完成重启；其次检查是否误用了 npm install -g 的 SDK-only 安装；最后可用状态命令确认 observer 是否在运行。

七、总结

「会话失忆」是当前终端智能体最影响实用性的短板之一，Claude-Mem 用自动捕获加语义压缩加分层检索给出了成体系的解法，跨客户端通用和 token 成本透明是它区别于同类方案的两大亮点。超过 10 万星和日更级的迭代速度，说明这个痛点真实且被广泛认可。需要注意的两点：默认记忆走托管服务，敏感项目务必先确认提供方配置；npm 全局安装是无效姿势，认准 npx claude-mem install。对重度使用 AI 编码工具的人，它属于装上就回不去的那类基础设施。