长项目里最烦人的事，不是 Claude Code 不会写代码，而是它今天记得、明天忘了；这个会话里知道，换个窗口又得从头讲。上下文窗口再大，也不是长期记忆系统。
Claude-Mem 的定位很明确：自动捕获 Claude Code 会话，把关键上下文压缩、索引，再在未来会话里按需注入。它不是把所有聊天记录硬塞回 prompt，而是做一层可搜索、可分层展开的记忆系统。
热度：约 68k stars，主打 Claude Code/Gemini/OpenCode 长期记忆。
什么时候该装 Claude-Mem
如果你只是让 Agent 改一个小脚本，没必要上记忆系统。但如果你在一个仓库里持续迭代一两周，反复解释项目结构、约定、踩坑、部署方式，那就值得装。
它适合这几类场景：
- 老项目维护：模型需要记住历史决策和“为什么不能这么改”。
- 多会话开发：今天排查的问题，明天继续接上。
- 团队 Agent：不同人调用同一个工程助手，需要共享项目脉络。
- 复杂调试：错误、尝试路径和结论需要沉淀，避免重复绕圈。
安装：不要只 npm 全局安装
官方 README 特意提醒：`npm install -g claude-mem` 装的是 SDK/library，不会自动注册插件 hooks 和 worker。常规安装请用：
npx claude-mem installGemini CLI：
npx claude-mem install --ide gemini-cliOpenCode：
npx claude-mem install --ide opencodeClaude Code 插件市场方式：
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem装完以后重启 Claude Code 或 Gemini CLI。下一次会话里，它应该能自动读取过去沉淀下来的上下文。
先做一个小验证
不要一上来就相信“记忆已经工作”。建议做一个很小的测试：
请记住：这个仓库发布前必须先运行 pnpm typecheck 和 pnpm test:unit。然后结束会话，重新打开，再问：
这个项目发布前的检查步骤是什么？如果你能从记忆里找到，请说明来源。如果它能找回这条约定，说明基础链路通了。再继续测试更复杂的信息，例如某个模块的设计取舍、某次线上故障的排查结论。
配置重点：别让记忆污染上下文
长期记忆不是越多越好。一个粗暴的记忆系统，会把旧结论、临时猜测和过期配置一起塞回来，反而误导模型。
Claude-Mem 值得关注的点，是它强调 Progressive Disclosure：先给模型轻量摘要，需要时再用 MCP 工具逐层搜索。这样能减少 token 浪费，也能降低旧信息直接压过当前任务的风险。
你可以重点检查这些位置：
ls ~/.claude-mem
cat ~/.claude-mem/settings.json如果你需要中文工作流，可以在设置里关注 `CLAUDE_MEM_MODE`，README 里提到 `code--zh` 模式已经内置。
实战建议：记结论，不记噪声
真正好用的长期记忆，应该偏向这三类信息：
- 稳定事实：项目怎么启动、怎么部署、目录约定是什么。
- 关键决策：为什么放弃某方案，为什么保留某兼容逻辑。
- 反复踩坑：某依赖版本、某平台限制、某测试环境特殊点。
不要把每次聊天的流水账都当资产。记忆系统的价值不是“存得多”，而是下一次能少走弯路。Claude-Mem 给 Claude Code 补的，正是这块工程短板。