claude-mem：给 Claude Code 装上持久记忆
claude-mem 为 Claude Code 增加工作上下文捕获、压缩和跨会话检索。本文介绍插件安装、记忆误差及本地存储与云模型的数据边界。
直接回答：claude-mem 是面向 Claude Code 的开源持久记忆插件，可捕获、压缩并检索工作上下文。它是原生会话和记忆能力之外的补充；捕获范围、召回准确性与外部模型使用需按配置验证。
无状态之痛
Claude Code 的会话、项目指令和记忆功能不等同于模型权重记忆；不能说会话一结束所有信息必定清零。claude-mem 是额外的捕获与检索层，应与产品原生能力分别评估。
claude-mem 怎么工作
后台进程 + 自动捕获 + 智能压缩：
- 捕获：监听 Claude Code 会话，自动记录工作上下文（改了什么文件、解决了什么问题、决策理由）
- 压缩：原始上下文浓缩成语义摘要，控制存储与召回体积
- 召回：新会话开始时，相关记忆自动注入上下文——Agent 一开场就"记得"项目历史
安装
按官方插件路径操作，并先检查项目权限和依赖：
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
安装后按当前 README 重启或验证插件加载。不要假设存在 npm install -g claude-mem 后的同名安装命令；钩子有读取项目上下文的权限。
验收样例：bug 修复的跨会话召回
可用缓存失效故障做验收样例：一次会话记录现象、证据与修复；下一会话检索并核对来源。这是一项待执行的验收设计。错误摘要也会被持久化，不能当作独立证据。
持久记忆的核心收益
- 减少重复开场：让可检索的项目背景辅助新会话
- 决策可追溯："当时为什么这么设计"有案可查
- 积累历史：保留可核对的工作记录，同时衡量摘要调用、检索与维护成本
常见问题（FAQ）
Q：和 Supermemory 这类通用记忆 API 什么关系？
A：claude-mem 是"开箱即用的成品"，专为 Claude Code 工作流优化（自动捕获编码上下文）；Supermemory 是"记忆基础设施"，适合自建 AI 应用时集成。用 Claude Code 选前者，做自己的 AI 产品看后者。
Q：记忆存在哪里，会泄露吗？
A：存储可在本地，但压缩与回答所用模型可能是云服务，上下文仍可能外传。记忆内容含项目细节，团队共享环境或敏感项目要评估存储位置与访问权限；定期清理过期记忆也是好习惯。
Q：记忆会不会越攒越多最终污染上下文？
A：claude-mem 靠压缩与相关性召回控制注入量。但长期项目建议定期归档旧记忆——和人的笔记一样，记忆也需要整理。
参考资料
资料核对日期：2026 年 9 月 29 日。本文基于公开文档整理，代码片段和评估方案未作独立运行或性能验证；厂商测试结果已注明来源。
