Claude-Mem 持久记忆系统

Claude-Mem 持久记忆系统

Claude-Mem 是一个为 AI 编程代理设计的持久记忆压缩系统，旨在解决代理在会话结束后「失忆」的问题。它自动捕获代理在会话中的所有操作，使用 AI 压缩成语义摘要，并在未来会话中注入相关上下文，让代理能够持续记住项目知识。

核心功能

• 自动捕获：监听代理的工具使用和操作，记录关键决策、代码变更和问题修复。
• AI 压缩：利用大模型将冗长的操作日志压缩为简洁的语义摘要，减少上下文占用。
• 上下文注入：在后续会话中自动检索并注入相关记忆，帮助代理快速恢复项目状态。
• 多代理支持：兼容 Claude Code、OpenClaw、Codex、Gemini、Hermes、Copilot、OpenCode 等主流代理。

工作原理

1. 代理执行任务时，Claude-Mem 通过钩子或日志监控捕获操作。
2. 操作记录被发送到 AI 模型进行压缩，生成结构化记忆（如决策、bugfix、安全警报等）。
3. 记忆存储在本地（SQLite/ChromaDB）或云端，并建立向量索引。
4. 新会话开始时，系统根据当前任务检索相关记忆并注入到代理上下文中。

快速开始

安装需要 Node.js 20 及以上版本。使用 npx 一键安装：

npx claude-mem install

安装程序会引导你完成配置，并可选登录云端服务（提供 30 天免费试用）。也可以指定代理类型：

npx claude-mem install --ide opencode
npx claude-mem install --ide t3code

安装后重启对应代理即可生效。

存储与配置

Claude-Mem 支持多种记忆提供方：

• 本地模式：使用 SQLite 和 ChromaDB 存储，完全离线。
• 云端托管：使用 claude-mem 观察者服务，提供跨设备同步。
• 自带密钥：支持 OpenRouter、Gemini 等第三方 API。

通过环境变量或配置文件可以调整记忆压缩策略、注入频率等参数。

适用场景

• 长期维护的复杂项目，代理需要记住历史决策和代码结构。
• 多会话协作开发，避免重复解释项目背景。
• 团队共享项目知识，沉淀代理操作经验。

注意事项

• 云端服务免费试用结束后可能产生费用，请根据需求选择本地或自带密钥模式。
• 记忆压缩依赖 AI 模型，重要信息建议手动确认。
• 部分代理集成需要额外配置钩子或日志监控，请参考官方文档。

项目采用 Apache-2.0 开源协议，提供中文文档，欢迎社区贡献。