claude-mem

项目简介

claude-mem 是面向 Claude Code 及其他编码代理的开源持久记忆压缩系统。它在会话期间捕获工具使用观察，生成语义摘要，并把相关上下文注入后续会话，使工作能跨会话边界和机器继续。本地引擎把记忆存储在用户机器上，可选的 CMEM Pro 提供托管观察、云同步和私有 MCP 召回。

核心功能

• 持久记忆使上下文在会话之间可用；渐进式召回让代理先定位相关笔记再读取细节；MCP 搜索流程通过 search、timeline 和 get_observations 实现节省令牌的检索；云同步让已捕获的项目记忆在连接的计算机之间可用；隐私控制支持用私有标签把敏感内容排除在存储之外；TeamBrain 提供可选的共享工作区，包含团队工作列表、成员归属和关联发现。

适用场景

• 在后续会话中继续工作，并可获得此前的决策、发现和修复；搜索项目历史以查找过往缺陷修复和架构决策；在账户支持自定义连接器时，从包括 ChatGPT 在内的 MCP 客户端召回已同步记忆；在 Claude Code、Cursor、Codex 和 ChatGPT 等受支持工具之间共享项目历史。

快速开始

• 运行 npx claude-mem install 进行默认安装；通过 IDE 标志指定环境，例如 npx claude-mem install --ide opencode 或 npx claude-mem install --ide grok-bot；安装后重启宿主工具，以便新会话中出现上一会话的上下文。

部署与要求

• Node.js 20.0.0 或更高版本；用于 Claude Code 集成的 Claude Code 最新版（需支持插件）；Bun JavaScript 运行时和进程管理器，缺失时自动安装；用于向量搜索的 uv Python 包管理器，缺失时自动安装；用于持久存储的 SQLite 3，已随系统捆绑。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。