超 3 万人收藏的零成本、省 Token 的 Claude Code 持久化记忆插件！

在AI编程圈有一个流传已久的“玄学”：每次打开 Claude Code 写代码，都要经历一场漫长的「背景介绍仪式」。

比如：“你好，我有一个React项目，用的是TypeScript，搭配Vite构建，之前我们实现了用户认证模块，现在要接入支付功能...”

如果你跳过这步，直接让 Claude 干活，它大概率会一脸茫然地问：“请问这个项目的结构是怎样的？”“支付模块的具体需求是什么？”

别问为什么，问就是——AI记性差。

这种“失忆症”几乎困扰着每一个用 Claude Code 的开发者。每次新建会话，之前辛辛苦苦积累的代码理解、项目架构、踩坑经验，全部清零从头来过。

Token烧了一套又一套，效率却原地踏步。

直到最近，GitHub 上出现了一个爆款项目——Claude-Mem。这个项目的出现，直接戳中了目前所有AI编程助手的致命痛点：跨会话失忆。

而且，它还免费，还能帮你省 Token 钱！

直接冲上了 GitHub Trending 热榜。目前，这个项目已经拿下了 30K Star，更是挤进了 GitHub Trending 月榜Top10。

01 项目简介

Claude-Mem 是专门为 Claude Code 打造的一款持久化记忆插件。简单说，它就是给AI装了个"硬盘"，让它能记住跨会话的上下文。

装上之后，它会自动捕捉你在会话里的所有操作——文件读写、代码编辑、命令执行——然后压缩成精炼摘要存起来。

下次开新会话，这些信息自动注入上下文。你甚至感觉不到它的存在，但它一直在后台默默干活。

它的工作原理是这样的：通过5个生命周期钩子（Hooks）渗透进Claude的每一个操作环节：

• • SessionStart：会话启动时，自动注入历史记忆
• • UserPromptSubmit：用户提交指令时，记录问题和上下文
• • PostToolUse：工具执行后，捕获Read/Write/Edit等操作
• • Stop：任务暂停时，保存中间状态
• • SessionEnd：会话结束时，生成摘要并压缩

02 核心特性

• • 🧠 持久化内存：上下文跨会话保留
• • 📊 渐进式披露：分层内存检索,具有令牌成本可见性
• • 🔍 基于技能的搜索：使用 mem-search 技能查询项目历史
• • 🖥️ Web 查看器界面：在 http://localhost:37777 实时查看内存流
• • 💻 Claude Desktop 技能：从 Claude Desktop 对话中搜索内存
• • 🔒 隐私控制：使用 <private> 标签排除敏感内容的存储
• • ⚙️ 上下文配置：精细控制注入的上下文内容
• • 🤖 自动操作：无需手动干预
• • 🔗 引用：使用 ID 引用过去的观察(通过 http://localhost:37777/api/observation/{id} 访问，或在 http://localhost:37777 的 Web 查看器中查看全部)
• • 🧪 测试版渠道:通过版本切换尝试实验性功能，如无尽模式

03 六大“杀招”

1️⃣ 自动记忆捕获

从安装那一刻起，Claude-Mem就开始默默记录你与Claude的每一次交互。

文件操作、代码修改、命令执行...全部自动存档。不需要任何手动配置，真正的“零感知”运行。

2️⃣ AI观察AI，自动压缩记忆

每次会话结束时，系统会调用Claude Agent SDK，把整个会话期间那些冗长的原始工具使用记录，压缩成结构化的精炼摘要。

包含调查内容、学习成果、已完成工作、后续步骤这几个关键模块。

相当于让Claude自己给自己写“会议纪要”，把1万Token的工具调用记录凝练成500Token的“知识晶体”。

3️⃣ 三层渐进式披露

这是 Claude-Mem 最牛逼的设计：三层渐进式披露（Progressive Disclosure）。它采用分层记忆检索策略，模拟人类的记忆模式：

第一层：Search（索引查询）

• • 获取紧凑的记忆索引
• • 只包含标题、类型、时间戳
• • Token 消耗：50–100 / 结果
• • 快速浏览，找到感兴趣的内容

第二层：Timeline（时间线）

• • 获取特定观察记录周围的上下文
• • 看看当时发生了什么
• • Token 消耗：中等
• • 了解背景信息

第三层：Get Observations（获取完整详情）

• • 只获取筛选后的完整观察记录
• • 只在真正需要时才获取
• • Token 消耗：500–1,000 / 结果
• • 深入细节

这种方式既节省 Token，又不会在需要时显得"浅薄"。常规使用下能节省 90% Token，测试阶段的"无尽模式"更是能把 Token 消耗砍掉 95%，工具调用次数上限直接拉高 20 倍。

4️⃣ Skill级搜索能力

内置mem-search skill，支持自然语言查询你的项目历史。想找“上次那个支付接口怎么写的”，直接问就行。

5️⃣ Web Viewer实时监控

Claude-Mem 提供了一个 Web 查看器，你可以通过 http://localhost:37777 访问：

• • 实时查看所有记忆记录
• • 按时间、类型、项目筛选
• • 查看完整的观察记录详情
• • 管理和配置设置
• • 切换稳定版和测试版

就是给 Claude 的记忆加了一个可视化界面，你可以随时查看它"记住"了什么。所有观察记录、历史会话，一目了然。

6️⃣ 隐私保护

如果你有一些敏感内容不想被存储，可以使用 <private> 标签来排除：

<private>
这个部分包含敏感信息，不会被存储
</private>

所有数据都存储在你的本地目录 ~/.claude-mem/，不会上传到任何服务器，隐私风险完全可控。

04 快速上手

Claude-Mem的安装超级简单，在 Claude Code 终端里直接执行以下命令即可：

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

重启 Claude Code。之前会话的上下文将自动显示在新会话中。

注意： Claude-Mem 也已发布在 npm 上，但它仅npm install -g claude-mem安装SDK/库，不会注册插件钩子或设置 worker 服务。要将 Claude-Mem 作为插件使用，请始终使用/plugin上述命令进行安装。

🦞 OpenClaw 网关

使用一条命令即可在 OpenClaw 网关上将 claude-mem 安装为持久内存插件：

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

安装程序会处理依赖项、插件设置、AI 提供商配置、工作进程启动，以及可选的实时观测数据流（推送至 Telegram、Discord、Slack 等平台）。

如果你想搜索历史记录，可以使用 mem-search skill：

/mem-search 你上次是怎么解决那个React组件重复渲染问题的

如果想查看完整的记忆流界面，可以打开Web Viewer：

http://localhost:37777

在这里你可以看到所有的观察记录、会话摘要，还能通过API引用过去的观察记录。

05 写在最后

Claude-Mem之所以能火出圈，根本原因在于它解决了一个所有AI编程工具都在回避但又切实存在的问题：AI到底能不能记住上下文？

传统答案是：不能。每个会话都是独立的，Token限制摆在那里，你不可能把所有历史都塞进去。

Claude-Mem 它却可以，但要用对方法。三层渐进式披露、AI自动压缩、本地向量检索...一系列技术组合拳打下来，既保住了上下文连续性，又守住了Token钱包。

更重要的是，Claude-Mem本身100%免费，还能帮你省Token钱。

对于那些每天和Claude Code打交道超过几小时的开发者来说，这玩意儿基本上属于“用了就回不去”系列。

GitHub：

https://github.com/thedotmack/claude-mem