Claude-Mem 全面解读：给 Claude Code 装上“记忆硬盘”的终极方案

核心摘要（Key Takeaways）

Claude-Mem 是什么：Claude-Mem 是一个开源的持久化记忆插件，专为解决 Claude Code 等 AI 编程代理的“会话失忆”问题而生。它能自动捕获、压缩并跨会话注入你的项目上下文。
核心机制：它在后台像“行车记录仪”一样监听你的每一次工具调用，通过 AI 自动生成压缩摘要，存入向量数据库，并在下次对话时精准检索相关记忆。
数据与现状：该项目在 GitHub 已获得 74.8K Star 和 6.4K Fork，是开发者社区最受认可的 AI 记忆方案之一。它的最新版本为 v13.1.0，已支持团队级部署。
与官方工具互补：不同于 Claude 官方记忆工具（单次会话的“RAM”），Claude-Mem 扮演了跨会话“硬盘”（Hard Drive）的角色，两者是协同而非竞争关系。
适用对象：适用于所有被重复解释项目结构所困扰的开发者，尤其适合处理长期、复杂工程任务的个人或团队。

Claude-Mem 是什么？

Claude-Mem 是一款为 Claude Code 设计的开源持久化记忆插件，其核心功能是自动记录并长久保留你在每次编程会话中与 AI 互动的关键上下文。

如果把 Claude 官方的记忆工具比作只能暂存当前对话的“运行内存（RAM）”，那么 Claude-Mem 就是一块可以永久存储、随时读取的“物理硬盘”。它解决了大语言模型最致命的“空白状态”问题：以往每次开启新会话，AI 都会丢失关于你项目的所有决策、架构和调试历史，迫使你反复重复背景信息。安装 Claude-Mem 后，每次新会话开始时，AI 会自动调取之前的“记忆”，立即理解你的项目进度和习惯。

Claude-Mem 官网截图

主要功能和特点

Claude-Mem 并非简单的本地文本记录，它搭建了一套复杂的“记忆压缩与检索流水线”。

1. 全自动的上下文捕获

你无需手动输入任何总结。Claude-Mem 通过 5 大生命周期钩子（SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd） 全面介入 Claude Code 的运行。它会在后台监听你的每一次工具操作，将原始数据实时抓取下来。

2. 基于 AI 的智能压缩

捕获到的原始数据如果全量注入新会话，会导致 Token 成本激增。Claude-Mem 的 Worker 服务 在后台利用 Claude Agent SDK 对原始观察记录进行语义总结，生成包含“类型、标题、事实、叙述”的结构化观测摘要，从而剔除冗余日志，仅保留决策精华。

3. 高效的三层检索架构

为了避免无脑加载全量记忆浪费 Token，Claude-Mem 设计了严格的分层检索体系：

第一层（廉价检索）：仅查看标题和摘要。
第二层（中度检索）：调取关键事实。
第三层（深度检索）：仅在必要时展开完整观察记录。这套基于 SQLite + FTS5 全文搜索 以及 Chroma 向量数据库（混合语义+关键词检索） 的机制，能实现约 10 倍的 Token 节省。

4. 强大的 MCP 搜索工具集

Claude-Mem 注册了 4 个专门的 MCP 工具（如 search, timeline, get_observations 等）供你主动检索记忆。你可以在编程中随时要求 Claude 搜索过去某天修复的 Bug、某个架构决策的来龙去脉。

5. 隐私控制与多代理兼容

隐私标签：你可以在不想被记录的代码或指令前后标记 <private>，被标记的内容将不会被发送到压缩后台。
泛用性：虽然名为 Claude-Mem，但它是一个“供应商无关”的中间件，现已支持 Gemini CLI, OpenCode, Windsurf, Cursor, Codex, Copilot 等多种主流 AI 编程工具。

如何使用 / 安装 Claude-Mem？

Claude-Mem 的安装极度简化，利用 Claude Code 的插件市场即可一键部署，无需手动处理复杂的 Python 环境或 Node 依赖。

前置条件

Node.js：20.0.0 或更高版本。
Claude Code：拥有最新版且支持插件功能的 Claude Code。
系统自动处理：Bun 运行时、uv（Python 包管理器）和 SQLite 均支持离线自动安装。

分步安装指南

第一步：添加插件市场

在任意 Claude Code 的终端会话中输入以下命令，告知系统去哪里寻找插件：

/plugin marketplace add thedotmack/claude-mem

第二步：执行安装

继续在同一窗口输入安装指令，系统会自动下载、解析依赖并配置环境：

/plugin install claude-mem@thedotmack

第三步：重启并感受记忆

安装完毕后，关闭并重启 Claude Code 或 Gemini CLI。当你开启一个新会话时，你无需任何额外指令，Claude 将自动引入过去积累的项目背景。

注意：千万不要直接使用 npm install -g claude-mem，那是 SDK 安装方式，不会自动注册插件钩子或启动后台 worker 服务。

额外通道

OpenClaw 网关：支持通过网关命令将记忆系统一键挂载到团队局域网的 AI 网关上。
Web 管理面板：启动后，你可以访问 http://localhost:37777 在浏览器里直观地浏览、审查和管理 AI 生成的结构化记忆。

为什么它比 CLAUDE.md 更强？

很多开发者误以为在项目里写一个 CLAUDE.md 就足够让 AI 了解项目，但事实却残酷得多。

特性维度	CLAUDE.md	Claude-Mem
更新方式	纯静态，必须由人工手动编写	动态更新，在编码时自动产生并压缩上下文
信息容量限制	极其受限，写超过 200 行后 AI 的遵循度会剧烈下降	智能分层，Token 消耗可控，不惧怕积累长尾信息
检索能力	无，AI 只能通读全文	强大的混合搜索（语义+关键词），按需精准抓取
反映现实度	反映“人类以为的架构”	反映“AI 在实践中踩过的坑和实际调试出的结果”
维护成本	高，随项目迭代极易过时	极低，相当于全自动化的项目工作日志

典型应用场景

复杂遗留系统重构：当你必须分多次向 AI 解释上千行不可言说的历史逻辑时，Claude-Mem 让后续每次会话都直接继承前一天的“情报”。
跨天晨间启动：正如其比喻，你不需要每天早上看到开发者走进来说“我们的项目是做什么的来着？”，AI 直接带上昨天的“工作日报”上岗。
多分支协作排查：在排查某个诡异 Bug 时，你可以让 AI 直接搜索几周前的某个观察记录，找到引入问题的原始点。
团队知识沉淀（Beta 特性）：新版本 v13.1.0 依托 Postgres + BullMQ 的 服务端运行时（Server-Beta） ，支持将记忆部署为远端团队服务，新加入开发的同事能让 AI 立刻获取集体的历史上下文。

价格与适用平台

价格：完全免费。该项目采用 Apache 2.0 开源协议，允许在开发者工具、本地代理、MCP 服务器乃至企业系统中自由嵌入。
开销关注点：虽然插件本身免费，但后台在生成记忆总结、检索上下文时会调用 LLM API 并消耗少量 Token。由于采用了逐步式分层检索，这种开销远低于直接翻看聊天记录，对 Pro 或 Team 套餐用户几乎无感。如果在免费额度紧张的情况下，建议选择性调用检索工具。

竞品对比：Claude 记忆工具生态

对比维度	Claude 官方记忆工具	Claude-Mem	GitHub Copilot
类比概念	单次会话的“RAM”	跨会话项目的“Hard Drive”	无外部长时记忆机制
记忆范围	仅当前会话内的上下文	自动载入并延续历史所有会话的压缩上下文	仅限于当前编辑器里打开的文件
存续周期	关闭会话即清空	持久化存储在 SQLite/Postgres 中	不存储历史会话信息
核心价值	完成当天的单一复杂任务	维护横跨数周的项目长逻辑线	基于当前代码提示完成补全

最近 3-6 个月动态（截至 2026 年）

爆发性增长：在 2026 年 2 月初的短短三天内，Claude-Mem 暴增 5,000 多颗 Star，随后总 Star 数跃升至 74.8K 以上。
架构重大升级（v13.1.0）：于 2026 年 5 月推出了基于 Postgres 和 BullMQ 的服务端运行时（Server-Beta），标志着该工具从纯粹的本地单人工具，正式进化到支持可横向扩展的团队级部署。
许可证明确化：官方在文档中明确界定了 Apache 2.0 协议的适用范围，强调了将持久代理记忆嵌入商业化产品系统的法律边界。
多模态生态扩展：持续兼容 Cursor + Gemini/OpenRouter 等多种组合方案的专用指南，甚至支持实时推送到 Telegram、Discord 等聊天软件。

常见问题（FAQ）

1. Claude-Mem 的官网地址和源码在哪？

官方源代码及详细文档托管在 GitHub： https://github.com/thedotmack/claude-mem 。其官方文档主站为 https://docs.claude-mem.ai/。

2. 它和 Anthropic 推出的 Claude 记忆功能冲突吗？

完全不冲突，甚至互补。 官方的记忆功能像是内存，处理当下的连贯性；Claude-Mem 是硬盘，处理跨越时空的连贯性。你可以两者同时开启，完全不相互干扰。

3. 我可以用在 Cursor 或者 Gemini 上吗？

完全可以。 Claude-Mem 是一个“供应商无关”层。GitHub 仓库上提供了专门针对 Gemini CLI、Cursor + OpenRouter 等不同环境的详细安装命令。

4. 我的数据安全吗？会不会泄露我的代码？

Claude-Mem 默认在本地运行并存储在本地数据库，同时提供了 <private> 标签供你对敏感信息进行屏蔽。此外，其 Apache 2.0 开源协议保证了你可以直接审查代码中的数据处理和存储方式，具有极高的透明度。

5. 为什么刚装上的时候它好像没什么反应？

这是一个正常现象。插件需要时间积累“观察记录”。在最初的 1-2 天，记忆库是空的。通常在经历 4-5 次完全不同的编码会话后，你会在某个不经意的瞬间突然发现 AI 主动提到了过去的某个复杂决定，并因此免去了你大段复述的痛苦。