claude-mem：给 Claude Code 装上跨会话记忆

每次新开一个 Claude Code 会话，它都不记得上一轮查到的原因、选定的方案和不能动的文件，这些只能再说一遍。claude-mem 是为 Claude Code 打造的持久记忆压缩系统：它用生命周期 hook 记录每次工具调用的观察结果，交给模型压缩成摘要，并在之后的新会话开头带回。README 里的最新版本是 v15.0.1，2026-10-20（UTC）发布。

这段 21 秒的动图取自 README：左边是 Claude Code 在干活，右边的本地查看器列出观察记录，卡片带着类型标签和项目名。

核心功能

claude-mem 的功能分三块：记录、检索和隐私控制。

• 自动记录：SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SessionEnd 六个生命周期 hook 负责捕获，不需要人工介入。观察结果再由模型压缩成语义摘要。
• 新会话开头带回上下文：重启 Claude Code 后，之前会话的上下文会出现在新会话开头，默认只带当前宿主的观察。在 ~/.claude-mem/settings.json 里把 CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES 设为 "true"，Codex 的观察也会带进来（默认是 "false"）。
• 先看索引，再取全文：search 返回带 ID 的索引，timeline 看某个结果前后的时间线，get_observations 按 ID 取全文。README 把这套流程称为「~10x token savings」，但没有说明这个数字怎么测出来的。
• 中文观察记录：把 CLAUDE_MEM_MODE 设为 code--zh，观察记录会用简体中文书写。README 说这个模式已内置。
• 隐私标签与脱敏：<private> 标签里的内容不进入存储。自动脱敏由 CLAUDE_MEM_REDACT_ENABLED 控制，默认是 false。
• 本地组件：Worker 服务由 Bun 管理，提供本地 HTTP API 和网页查看器。数据存进 SQLite，向量检索用 Chroma，做语义和关键词的混合搜索。

下表是 v15.0.1 的 README 给出的三步检索和 token 估算，我们没有独立测量。

步骤	返回什么	README 给出的估算
search	带 ID 的紧凑索引	每条约 50–100 token
timeline	某个结果前后的时间线	未给出
get_observations	指定 ID 的完整内容	每条约 500–1,000 token

典型使用场景

claude-mem 最有用的时候，是同一批代码被反复打开的时候。

• 每周回到同一个仓库的个人开发者：上周没修完的构建问题，这周开新会话不必从头解释。开头会带回前情，细节用 search 去翻。
• 同时用 Claude Code 和 Codex 的人：打开 include-all-sources 设置后，两边的观察都会进入会话开头，不用在两个工具之间反复复述。
• 想弄清某个决定为什么这样定的人：search 可以按类型、日期和项目筛选（README 的示例用的是 type="bugfix"），再用 timeline 看前后经过。

快速上手

claude-mem 安装只需要一条命令，在终端里运行：

npx claude-mem install

安装器会先完成配置，再让你在浏览器里用邮箱链接登录。不想登录，可以加 --provider 参数，或设置 CLAUDE_MEM_ONLINE_OPTIN=false。在 Claude Code 里也能依次执行 /plugin marketplace add thedotmack/claude-mem 和 /plugin install claude-mem。README 提醒，单独执行 npm install -g claude-mem 只会安装 SDK，不会注册 hook 或启动 worker。

用插件方式安装时，README 要求重启 Claude Code，之后新会话的开头会出现之前会话的上下文。

小结

claude-mem 适合每天在 Claude Code 里长期维护同一批项目、并且能接受模型服务压缩记录的个人开发者。不适合要求代码和提示词完全留在本机的团队。仓库用 TypeScript 编写，需要 Node.js 20 或更高版本；Windows 用户要看 README 单列的 PATH 说明。许可证是 Apache-2.0，但它只覆盖开源核心，docs/ip-boundary.md 把 Magic Recall 托管云和团队记忆同步列在仓库之外。

数据默认存在 ~/.claude-mem/，CLAUDE_MEM_DATA_DIR 可以改位置。但压缩观察要调用模型，可以选 claude-mem 的观察服务、自己的 OpenRouter 或 Gemini key，或者 Anthropic 套餐，文档没有列出每次请求发送了哪些字段。云同步开启后，观察叙述和完整的 prompt 文本会上传到你的 cmem.ai 账户，文档没有说明加密方式。每次工具调用都会被观察和压缩，成本是持续的。README 说试用期 30 天，之后记忆调用会回落到 Anthropic 套餐，除非订阅；它没有给出每个会话的平均消耗。README 末尾还有一节介绍 CMEM 代币，README 说它由第三方发行、获作者认可。这和软件本身无关，本文没有评价。

想对比相邻的项目，可以看 context-mode，它处理的是工具输出怎样不挤占上下文；也可以看 Graphiti，它做的是带时间信息的知识图谱。claude-mem 的 README 列出的存储组件是 SQLite 和 Chroma，没有提到图结构。

本文只核对了 README、官方文档、LICENSE 和 GitHub API，没有在本机安装运行。README 写的是「4 个 MCP 工具」，但只列出了 3 个，本文按列出的 3 个描述。