claude-mem
claude-mem 是一个专为 Claude Code 设计的插件,旨在为 AI 助手提供持久化记忆能力。
1. claude-mem 是什么?
Section titled “1. claude-mem 是什么?”claude-mem 是一个持久化内存压缩系统。它通过以下方式工作:
- 自动捕获:在编码会话期间,它会自动记录 Claude 的所有操作和工具使用情况。
- AI 压缩:利用 Claude 的 agent-sdk,将这些记录通过 AI 进行语义摘要和压缩。
- 内容注入:在未来的会话中,它会将相关的历史背景重新注入,让 Claude “记起”之前的工作。
2. 它解决了什么问题?
Section titled “2. 它解决了什么问题?”具体来说,它通过以下方式解决了开发者在使用 AI Agent 时常遇到的痛点:
1. 解决“上下文丢失”问题
Section titled “1. 解决“上下文丢失”问题”- 痛点:通常情况下,当你关闭一个 Claude Code 会话或重新连接时,AI 会失去之前所有的操作上下文。
- 解决方案:claude-mem 会自动捕获 Claude 在编码过程中的所有操作和工具使用记录,并在未来的会话中自动注入相关的上下文。 这使得 Claude 能够保持对项目知识的连续性。
2. 提高长周期项目的协作效率
Section titled “2. 提高长周期项目的协作效率”- 痛点:对于跨度数天或数周的大型项目,用户需要不断重复向 AI 解释背景信息,导致浪费大量的 Token 和时间。
- 解决方案:该项目利用 AI(通过 Claude 的 agent-sdk)对过去的会话进行语义总结和压缩, 确保 Claude 即使在新的会话中也“记得”之前的设计决策或已修复的 Bug。
3. 精准的知识检索
Section titled “3. 精准的知识检索”- 痛点:在海量的历史操作记录中,很难手动找到特定的代码片段或决策逻辑。
- 解决方案:它构建了一个持久化内存系统,支持基于技能的搜索(Skill-Based Search)。 开发者可以使用自然语言查询项目历史, 其底层的 Chroma 向量数据库支持混合语义检索,能智能地找回最相关的上下文。
4. 优化 Token 使用成本
Section titled “4. 优化 Token 使用成本”- 痛点:如果一次性把所有历史记录塞给 AI,会导致 Token 消耗极快且容易混淆。
- 解决方案:它采用了渐进式披露 (Progressive Disclosure) 的策略, 通过 3 层工作流(搜索、时间线、获取详情)分阶段检索,帮助用户在保持上下文的同时,节省约 10 倍的 Token 消耗。
3. 如何安装与使用?
Section titled “3. 如何安装与使用?”快速安装步骤:
Section titled “快速安装步骤:”- 在终端中启动一个新的 Claude Code 会话。
- 输入以下命令添加插件:
/plugin marketplace add thedotmack/claude-mem- 执行安装命令:
/plugin install claude-mem- 重启 Claude Code 即可生效。
- 自动化运行:安装后无需手动干预,它会自动捕获观察结果并生成摘要。
- 智能搜索:你可以使用
mem-search技能,通过自然语言查询项目历史。 - Web 查看器:在浏览器访问
http://localhost:37777,可以实时查看内存流和历史记录。 - 隐私控制:可以使用
<private>标签来标记不希望被存入内存的敏感内容。