你是否厌倦了每次重启 Claude Code 都要重新“喂”一遍项目背景?Claude-Mem 是一款专为 Claude Code 打造的持久化记忆系统,通过自动捕获、语义压缩和智能检索,让 AI 拥有跨会话的长期记忆,同时大幅节省 Token 成本。

AI 虽强,却是“七秒记忆”?
作为开发者,我们越来越依赖 Claude Code 这样的 CLI 工具来辅助编程。它能写代码、跑测试、修 Bug,堪称神级队友。
但你一定遇到过这种崩溃时刻:
-
• 当你辛苦调试了一整天的 Bug,第二天早上打开电脑重启终端时,Claude 却把昨天的上下文忘得一干二净。 -
• 你不得不花费大量时间(和 Token)重新向它解释项目结构、之前的修改记录以及你的意图。 -
• 随着对话越来越长,Context Window(上下文窗口)爆满,AI 开始“胡言乱语”或遗忘早期的关键指令。
如果 Claude 能像人类同事一样,拥有**“长期记忆”**,记得你上周做的改动,甚至记得你偏好的代码风格,该多好?
今天介绍的开源神器 Claude-Mem,就是为了解决这个问题而诞生的。
🚀 什么是 Claude-Mem?
Claude-Mem 是一个专为 Claude Code 设计的 。
你可以把它想象成给 Claude 装了一个外挂的“大脑海马体”。它利用 SQLite 和 Chroma 向量数据库,自动记录你在终端里的每一次操作、每一个工具调用和每一次对话。当你会话结束时,这些信息不会消失,而是被压缩并存储起来。
当你下次启动 Claude Code 时,它能通过智能搜索(基于 MCP 协议),瞬间找回之前的上下文,实现无缝衔接。
⚡ 核心功能与“降维打击”优势
1. 跨会话的“永久记忆”
这是最直观的改变。
-
• 以前:关闭终端 = 记忆清零。 -
• 现在:无论你重启多少次,Claude-Mem 都会自动加载之前的关键上下文。它记得你上一次修了哪个文件,也记得你提到过的 API Key 存放位置。
2. “渐进式”信息披露,省钱又快
很多类似工具会一股脑把历史记录塞给 AI,导致 Token 消耗爆炸。Claude-Mem 采用了一种极具工程智慧的 3层检索机制:
-
1. Search(索引层):先只看摘要和 ID(仅消耗 ~50-100 Token)。 -
2. Timeline(时间线):如果 AI 觉得相关,再查看该记录前后的时间线。 -
3. Get Details(详情层):确认需要后,才拉取完整的详细内容。
收益:这种机制比暴力通过 Context 传输历史记录,节省了约 10倍 的 Token 成本。
3. 可视化记忆流
Claude-Mem 不仅仅是一个后台进程,它还贴心地提供了一个 Web 界面。
-
• 访问 http://localhost:37777,你可以像看“朋友圈”一样,实时查看 Claude 的记忆流。 -
• 你可以清晰地看到 AI 记录了哪些观测(Observations)、生成了哪些摘要,方便你进行调试或回顾。
4. 隐私与安全控制
担心 AI 记住了你的密码或敏感数据?
-
• Claude-Mem 支持 <private>标签。你可以在对话中标记某些内容不被存储。 -
• 所有数据默认存储在本地 SQLite 数据库中,完全由你掌控。
🛠️ 实战场景:它能做什么?
场景一:连续多日的复杂 Debug
📅 周五下午:你和 Claude 一起定位了一个复杂的内存泄漏问题,排查了 5 个文件,排除了 3 种可能性。下班关机。
📅 周一早上:启动 Claude Code。
🤖 Claude (有 Mem 加持):“早上好!根据上周五的记录,我们正在排查UserAuth.ts的内存泄漏,已排除了数据库连接池的问题。今天要继续测试缓存模块吗?”
💡 无需你多说一句,工作直接继续。
场景二:新项目快速上手
你接手了一个半年前的老项目,完全不记得架构了。
🗣️ 你输入:@Claude 查询一下这个项目上次关于 'API限流' 的修改记录。
🤖 Claude:调用mem-search技能,精准调出半年前的修改记录和当时的提交备注,告诉你代码在哪个位置。
💻 快速上手指南
使用 Claude-Mem 非常简单,只需要在 Claude Code 的终端中运行两个命令即可。
前提条件:你需要安装了 Node.js (18+) 和最新版的 Claude Code。
Step 1: 添加插件市场源
在 Claude Code 终端中输入:
/plugin marketplace add thedotmack/claude-mem
Step 2: 安装插件
输入以下命令,Claude 会自动处理依赖(如 Bun、SQLite 等):
/plugin install claude-mem
Step 3: 重启并体验
重启 Claude Code。此时,你应该能在浏览器访问 http://localhost:37777 看到 Web UI 已经启动。
现在,试着对 Claude 说一句:“记住,我把 API Key 放在了 .env.local 文件里。” 然后重启终端,问它:“我的 Key 在哪?”,见证魔法的时刻。


