Claude-Mem:Claude Code 智能记忆插件
Claude-Mem 是面向 Claude Code 的开源记忆插件,可自动记录编码会话中的工具调用、代码决策和调试过程,并将其整理为可检索的结构化记忆。新会话开始时,插件会注入相关历史上下文,帮助AI持续理解项目背景和开发进度。
主要功能
- 自动捕获上下文:通过SessionStart、PostToolUse等生命周期钩子记录会话过程。
- AI内容压缩:将原始工具输出整理为包含事实、标题、概念和过程说明的结构化记录。
- 混合搜索:结合SQLite全文搜索和Chroma向量搜索,支持关键词与语义检索。
- 渐进式检索:先返回简短索引,再按需展开时间线和完整观察记录,减少上下文占用。
- Web可视化管理:通过本地服务查看实时记忆流和历史记录。
- 自动维护CLAUDE.md:在项目中生成和更新活动时间线,同时保留手动内容。
- 隐私控制:可使用
<private>标签排除敏感内容。 - 多语言与工作模式:支持多种语言,并提供代码、邮件调查等模式。
如何使用Claude-Mem
在Claude Code中执行以下命令安装:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
安装后重启Claude Code,使生命周期钩子生效。可通过curl http://localhost:37777/api/health检查服务状态,或打开http://localhost:37777查看记忆界面。首次会话会开始积累记录,后续会话将自动调用相关上下文。
核心优势
- 跨会话连续性:保留架构决策、调试过程和项目背景,减少重复说明。
- 自动化运行:无需手动整理日志或保存记忆。
- 上下文利用高效:通过分层检索避免一次性加载大量历史记录。
- 本地优先存储:记忆数据库和向量索引默认保存在本地。
- 适合长期开发:支持多代码库、持续重构和复杂调试任务。
应用场景
- 跨会话接力开发:在新会话中继续之前未完成的功能和修复工作。
- 大型代码重构:持续记录迁移计划、修改结果和遗留问题。
- 调试知识沉淀:将故障原因和解决方案整理为可搜索的项目记忆。
- 多项目管理:为不同代码库保留独立的上下文,减少信息混淆。
- 团队交接:通过记忆记录和项目文档帮助新成员了解历史决策。
本地保存记忆不代表所有处理过程都完全离线;使用Claude Agent SDK或云端模型压缩内容时,请确认数据传输范围,并使用隐私标签排除密钥、客户资料等敏感信息。