Claude Code 会失忆？9.5 万星记忆系统补齐短板

用过 Claude Code 的人多半见过同一幕：昨天刚调试通的部署方案，今天新开一个会话，agent 一脸茫然，只能把上下文重新喂一遍。上下文窗口再宽，也挡不住会话边界的硬切断，更挡不住几十个项目来回切换时的记忆串线。GitHub 上的开源项目 claude-mem 正是冲着这个痛点来的：95.6k stars，Apache-2.0 协议，TypeScript 写成，给 coding agent 补上跨会话的持久记忆。

项目简介

claude-mem 出自开发者 Alex Newman（GitHub ID thedotmack）之手，官方定位是「面向 AI coding agent 的持久记忆系统」。它的思路并不玄乎：会话进行中，自动捕获工具调用的观察结果；离线生成语义摘要并落库；下一个会话开始时按需检索，把「上次发生了什么」注回上下文。

存储层完全本地化：SQLite 存结构化数据，Chroma 承担向量混合检索，代码上下文不出本机。工具适配方面，它把 Claude Code 当一等公民，同时覆盖 Codex、Gemini CLI、Copilot、OpenCode、Cursor、Antigravity、Windsurf、OMP 等十余个主流 coding 工具，同一份记忆可以跨工具共享。

核心功能

• 渐进式检索：分三步走，mem-search 先按关键词捞出相关记忆线索；timeline 沿时间线收窄事件范围，看清先后因果；get_observations 再按需取回原始观察细节。官方口径称，相比把历史会话整段塞回上下文，这套分层取用约省 10 倍 token。
• 自动沉淀：5 个生命周期钩子在会话关键节点触发写入，不需要人肉整理「会议纪要」。
• 隐私控制：用 private 标签包裹的内容不会写入记忆库，密钥、内部路径这类敏感信息可以明确排除。
• Web 查看器：实时记忆流可视化，agent 到底记了什么一目了然。
• 引用溯源：每条记忆带引用，能回溯到当时的观察现场，减少「记忆幻觉」。

快速上手

标准安装一条命令：

npx claude-mem install

前提是 Node.js 不低于 20，Bun 与 uv 缺失时会自动装上。也可以走 Claude Code 插件市场：

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

OpenCode、Antigravity、OMP 用户分别加 --ide opencode、--ide antigravity、--ide omp 参数即可。有一个细节要留意：npm install -g claude-mem 只会装 SDK，不会注册钩子，别用错入口。安装器会提示登录一个 14 天试用的托管观测端，不想用可以设 CLAUDE_MEM_ONLINE_OPTIN=false 跳过，纯本地使用不受影响。

适合谁用

长期维护同一批仓库的重度 Claude Code 用户收益最直接：调试结论、架构约定、踩坑记录都会留档，换会话不再从零开始。多工具并行的团队可以把它当共享记忆层，Cursor 里看过的排查思路，Codex 接着用。对隐私敏感的开发者则看中本地闭环这一点。需要提醒的是，记忆不是万能药，摘要必有损耗，关键决策仍建议落在文档里，把 claude-mem 当索引层而不是唯一事实源。