claude-mem:它给 agent 的不是记忆,是一个档案柜

每个 coding agent 都有同一个尴尬毛病。你花一下午解释为什么 auth 中间件不能碰、老配置放在哪儿、哪两个测试是故意不稳定的。然后你合上笔记本。第二天早上,agent 像见了生人一样跟你打招呼,兴冲冲地建议你把那个你叫它别动的文件重构一遍。
这个落差正是 claude-mem 想填的坑,星数说明有这种痛的人不少。仓库现在大约 11 万星,过去一周涨了约 5,850,连着几天挂在 GitHub 周榜第一。Alex Newman 这个项目自称是给 Claude Code 用的“持久记忆压缩系统”,关键词是压缩,不是存储。
到底存下了什么
机制没有宣传语那么玄。claude-mem 挂在 Claude Code 本来就暴露的生命周期 hook 上:SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SessionEnd。每个 hook 就是一条命令,claude-mem hook claude-code <event>,由安装器扔进 PATH 的一个小启动器执行。
你干活的时候,工具调用会被转成“observations”——关于 agent 做了什么、结果如何的简短语义笔记。一个由 Bun 托管的后台 worker 服务把它们写进 SQLite。新会话开始时,最相关的 observations 会在你敲第一个字之前注入上下文。
整套里还有一个 Chroma 向量库做语义检索,旁边配 SQLite 的 FTS5 做关键词检索。实际用起来这个混合是必要的:“周二那个迁移脚本”是关键词查询,“token 刷新会悄悄失败的那个地方”是语义查询,而这两种你都会打。
有两个细节值得单拎出来说,因为它们说明这项目真被人拿去用过。第一,<private> 标签:包在里面的内容永远不会被存下来。第二,截图是可选功能,默认关闭,而且只有单独开了图像推理才会送给 observer 模型。有人认真想过“记忆工具悄悄变成监控工具”这个失败模式。

三层检索这个设计
我觉得真正设计得好的是检索接口。claude-mem 没有把记忆一股脑倒进上下文、指望模型自己整理,而是给了一套三步的 MCP 流程。
search 返回带 ID 的紧凑索引,每条大约 50 到 100 个 token。timeline 给你某个命中点前后的时间线。get_observations 取完整内容,每条 500 到 1,000 token,但只给你真正选中的那些 ID。README 说先过滤再取能省大约 10 倍 token——这个说法的形状是对的:那是一笔账,不是一项能力。
这就是记忆系统和上下文窗口的区别。窗口再大,也是每一轮都要付的固定成本。渐进式展开则是你去找的时候才付。看过长会话把 token 烧在一堆过期工具输出上的人,都认得出哪一种撑得住。
安装只有一行,而这正是重点
顺路的安装是这样的:
npx claude-mem install
它支持 --ide opencode、--ide t3code、--ide pi、--ide antigravity 和另外几个,还有一个 Grok Bot 模式去盯聊天日志,因为那个宿主没有 hook。在 Claude Code 里也可以走插件市场:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
需要 Node 20 或更新。Bun 和 uv 缺了会被自动拉进来。Windows 上安装器会把启动器放到 %LOCALAPPDATA%\claude-mem\bin 并加进用户 PATH;如果 hook 报找不到可执行文件,npx claude-mem doctor 是排障入口。
README 里还有个坑值得重复一遍:npm install -g claude-mem 只装 SDK。它不注册 hook,也不起 worker,于是什么都不会发生,而你会以为这工具坏了。
让我不太舒服的那部分
安装过程中会让你用邮箱魔法链接登录,不用绑卡。登录会开一个 memory key,并解锁一个带 30 天试用的托管 observer;试用结束,记忆就退回你自己 Anthropic 套餐提供的水平,除非你订阅。整段都可以跳过:传 --provider、设 CLAUDE_MEM_ONLINE_OPTIN=false,或者在 CI 里跑。到这为止都还好。
然后在 README 靠下的位置,有一节叫“What About CMEM?”,解释说 CMEM 是第三方发的代币,被项目作者“正式拥抱”,还附了合约地址。
我不觉得这让软件本身变差。代码是 Apache-2.0,架构有文档,选这个许可证的理由也写得很明白:赌的是把持久记忆嵌进开发工具这件事。但一个记忆系统自带 memecoin,还要你先登录它才开始记事,它索取的是一种特定的信任——在你把它指向私有仓库之前,最好先想清楚给不给。纯本地那条路是存在的。有意识地用它,别是不小心用上的。
记忆真能让 agent 变好吗
老实说:它让 agent 少重复。这不等于变好。被记住的 observation 是关于过去的一个断言,而代码库大概率已经动过了。如果注入的上下文说“迁移在 db/legacy.ts”,而三周前有人把这个文件拆了,你给 agent 的不是知识,是对一个过期事实的信心。
claude-mem 自己的框架在这里帮了忙:observations 按 ID 引用,你可以在本地查看器里翻,地址是 worker 那个 URL。把它们当笔记,不要当真理。能从这个东西里拿到价值的项目,是那种会定期清理的,不是只进不出的。
还有一层二阶效应,也是我会盯着的。记忆会改变 agent 愿不愿意先问一句。有历史的 agent 会很自然地沿着上周继承下来的假设往前走。这是效率提升,直到它变成一次非常昂贵的误会。
谁该折腾这个
如果你的 agent 会话短、自包含,跳过。开销不值,全新的上下文是优点。
如果你在同一个仓库上跑好几天的工作,如果你总在重复解释同样的架构决策,或者你有并行的 agent 需要知道彼此得出了什么结论,那这是这个想法目前最完整的开源实现,而一行安装意味着试一次只花你十分钟。
只要带着正确的预期进去。claude-mem 不是给你的 agent 一个记忆。它给的是档案柜、检索工具,还有随手记下来的习惯。那些笔记现在是不是还对——一如既往,是你自己的事。
相关文章
一份社区维护的点击表,关掉了国产 Android 系统里的广告
它不动系统,不解锁,不刷机,只把厂商本来就留出来的开关一个个拨过去。代价是这份名单得一直有人续写。
GPT Image 2.6 守住 token 价格,账单却涨了
GPT Image 2.6 沿用了 2.5 的全部 token 费率,单张图却更贵,因为更多的活现在花在输出 token 上。上线十一天,定价结构说的比排行榜更多。
有人从外部重建了 IDM,并写下了自己没有碰过的部分
Mister Download Manager 用 Rust 重写了 Internet Download Manager 的下载流程,声称速度快 5 倍、支持 86 种语言。更值得细读的,是它解释如何在不复制任何代码的前提下完成重写的那一段。
Rune 是一个 Rust UI 框架,设计初衷是让 agent 能检查自己的工作
Rune 能无头渲染、导出元素树并接受脚本化输入,这让编码 agent 拿到截图永远给不了的东西,一个可 diff 的信号。这个框架仍是预发布版本,不接受 pull request。