claude-mem：为编程 Agent 保存可检索的跨会话记忆
一分钟看懂
claude-mem 是一个面向 Claude Code、Codex、Gemini、OpenCode 等 Agent 的持久上下文工具。它记录会话中的操作和结论，用 AI 压缩为更短的观察与摘要，再在以后相关任务中检索并注入，从而减少每次新会话都要重新解释项目背景的问题。
你可以用它做什么
- 记住代码库架构、约定和已经做过的决定。
- 在新会话中恢复上次任务背景与未完成事项。
- 根据当前问题检索过去相关操作，而非加载全部日志。
- 在不同兼容 Agent 之间传递项目记忆。
- 通过界面查看、搜索和管理已保存内容。
主要能力
工具通过会话 Hooks 或相应集成捕获事件，把原始内容转为结构化记录，再生成摘要以控制上下文开销。未来会话启动或执行任务时，它会按相关性选取记忆，而不是把完整历史全部塞回提示。具体存储、模型配置和各客户端安装方式以仓库文档为准。
适合哪些人
- 长期在同一大型仓库中使用编程 Agent 的开发者。
- 经常切换 Agent 工具但希望保留项目上下文的人。
- 需要追踪技术决策、排错过程和约定的团队。
一次性任务或高度敏感、禁止持久保存上下文的环境未必适合。
怎么开始使用
先在测试项目按照对应客户端说明安装，完成一段小任务后检查它实际保存了什么，以及下次会话注入的内容是否准确。确定存储位置、模型调用和清理命令后，再用于正式代码库。建议定期删除无价值或过期记忆。
使用前需要知道
捕获“Agent 做过的一切”可能包含源代码、终端输出、文件路径、凭据片段和业务信息。必须理解数据保存在本地还是发往外部模型，限制文件权限，并避免记录 Secrets。团队还要明确谁能读取共享记忆。
压缩摘要可能遗漏条件或固化错误结论；被注入的旧记忆也可能与当前代码冲突。它应作为线索，而不是权威事实，关键决策仍要回到代码和文档验证。记忆越多还会增加检索噪声和 Token 成本。