Claude-Mem
自动记录会话并用 AI 压缩,下次开会话时找回相关上下文。
它是什么
安装并重启 Agent 后,Claude-Mem 会在每次会话中监听生命周期节点和工具调用,把改过的代码、排查过程和项目背景压成语义摘要,连同原始记录存进本地 SQLite;下次新会话启动时,它把相关记录按需放回上下文,不用重新解释代码库现状和既有决策,就能接着上次的工作继续。它跑在本地,是给编码 Agent 补跨会话记忆的一层,最初围绕 Claude Code 构建,现在也接入 OpenCode、Codex、Gemini、OpenClaw、Hermes、Copilot 等。
和手工维护文档或整段粘贴聊天记录相比,采集与检索都随会话自动进行,读取是分层的:先给紧凑索引,需要时再展开时间线和完整记录,而非把整段历史一次性塞进上下文。
怎么运行
需要 Node.js 20 或更高版本。Claude Code 与 OpenCode 通过安装器接入:
bash
npx claude-mem install
npx claude-mem install --ide opencode安装器会注册插件钩子并启动 Worker;全局执行 npm install -g claude-mem 只装 SDK,不完成这些接入步骤。装完要重启对应 Agent,新会话才会自动读取已有记忆。
核心机制
- 生命周期采集:在会话开始、提交提示、工具调用后、停止和结束等节点记录活动。
- 本地持久化:Worker 作为本地 HTTP 服务运行,SQLite 保存会话、观察记录和摘要。
- 混合检索:全文检索加 Chroma 向量搜索,从历史记录里找相关内容。
- 分层读取:先返回紧凑索引,再按需查看时间线,最后通过 ID 读取完整记录,控制注入上下文的信息量。
适合谁
适合长期维护同一代码库、频繁切换会话的个人开发者,也适合让多个兼容 Agent 延续项目决策、故障排查过程和实现细节的团队。搜索结果附带观察记录 ID,可以追查某项改动所依据的历史。
使用边界
运行依赖 Node.js;Bun 和向量搜索所需的 uv 由安装流程处理。数据默认存在本机,但敏感内容不会自动排除,需要主动用 <private> 标签阻止存储。项目采用 Apache-2.0 许可,本地记忆不依赖托管服务;云同步属于可选入口。