每次开新会话都要重新讲一遍项目？claude-mem 让 agent 记住上次干了什么

用 Claude Code、Codex 这类 agent 写代码的人都有过这个体验：关掉会话再回来，agent 跟失忆了一样，上次定的方案、踩过的坑、改到一半的决定，全要重新讲一遍。claude-mem 就是冲着这个缺口来的：给 agent 装一个跨会话的记忆层，记录它上次干了什么，下次开局先把相关记忆喂回去。

它火得很快，而且是最近几天加速最快的那种火。GitHub 趋势加速榜 11 月 3 日的数据显示，thedotmack/claude-mem 的日增星速度从 10 月 24 日到 29 日的每天约 295 颗，跳到 10 月 29 日到 11 月 3 日的每天约 1338 颗，是当周加速幅度最大的项目。10 月底它的总星数已过 10 万，许可证是 Apache-2.0，作者是 Alex Newman。星数能说明“很多人觉得这个问题真实存在”，不能说明“装上就好用”，这两件事要分开。

它是怎么工作的，值得讲细一点，因为这决定了它适合谁。claude-mem 通过 6 个生命周期钩子挂进 agent 会话：会话开始、提交提示词、工具调用前后、停止、会话结束。每次工具输出——通常是 1000 到 10000 token 的量级——会被模型压缩成约 500 token 的语义观察，按决策、修 bug、新功能、重构、发现、改动等类型分类，存进本地 SQLite 数据库，全文检索配合 Chroma 向量库做召回。下次开新会话，相关的观察会被先注入上下文。项目方称这套分层检索比全量加载省约 10 倍 token，这个数字是项目方自己的说法，没有独立实测，别拿它做成本预算。

安装有一步最容易踩坑：全局装 npm 包 npm install -g claude-mem 只会装 SDK 和库，不会注册钩子、不会启动 worker，装完看起来成功了，实际上什么都没干。正确的路径是二选一：走 Claude Code 插件市场，先加 marketplace 再安装插件；或者跑 npx claude-mem install，让它装钩子、依赖和本地 worker。支持的主机不只 Claude Code，OpenCode、Codex、Gemini 等也在支持列表里，但不同主机的安装路径不一样，照着自己用的那一条走，别混着抄命令。

还有三处提醒，装之前先看。第一，遥测默认开启，可以关，但有公开 issue 指出隐私声明与默认行为之间存在矛盾，争议还没完全平息；进主力项目之前，先确认遥测已关闭，再决定记忆里放不放敏感代码路径。第二，压缩记忆本身也要花模型用量，省 token 的账要减去压缩的账，净收益取决于你的会话有多长、多重复。第三，开源的是引擎、CLI、worker 和 MCP 工具，托管的 Pro 观察、云同步服务是另外的闭源服务，别把两者混成一个“免费开源”的整体。

怎么用才划算：先在一个非敏感的小项目上试两周，看它召回的记忆是不是你真正想记住的决定，而不是流水账；记忆质量取决于压缩质量，一份把错误决定也当成经验存下来的记忆，会把坑带进下一个会话。定期翻一翻它存了什么，比装完就不管要重要。核心判断是：它补的是“agent 做了什么”的记忆，不是“你是谁”的记忆，更不是项目文档的替代品。文档该写的还是要写，记忆层只是让 agent 少问几句重复的问题。