夜雨聆风学习资料网

ARTICLE · 1290884

10.7万星开源插件claude-mem,让Claude Code记住上次聊过的项目,不用每次重新交代

10.7万星开源插件claude-mem,让Claude Code记住上次聊过的项目,不用每次重新交代

🦌 导读 · READ ME

开源插件 claude-mem 约 10.7 万星、Apache-2.0,专治 AI 编程助手「开新会话就失忆」:自动记录干过的活,压成摘要,下次自动带回上下文。小鹿拆原理、安装配置、方案对比、花费额度,附隐私自查清单。

用 AI 写代码、做项目的朋友,大概都烦过这件事:

昨天跟 AI 聊了一下午,项目结构、踩过的坑、定好的规矩,全讲清楚了。今天开个新会话,它一脸茫然:「请问这个项目是做什么的?」

你只好再贴一遍背景。贴得越多,token 烧得越快,会员额度也越早见底。

GitHub 上有个插件已经涨到 10.7 万星,叫 claude-mem。它干的事一句话:让 AI 记住上次聊过什么。

◆

大家好,我是小鹿。今天这篇分四块:

1claude-mem 到底是什么、怎么工作

2怎么装、怎么配

3和其他记忆方案对比

4成本和额度:要花多少钱

5普通人怎么用它省钱、搞钱

6隐私自查清单与踩坑提醒

01claude-mem 是什么?

一句话:给 AI 编程助手加的「长期记忆」插件。 它在后台自动记录每次会话里 AI 做了什么,压缩成摘要存起来;下次你开新会话,它自动把和当前项目相关的内容带回来。全程不用你手动操作。

仓库地址:github.com/thedotmack/claude-mem

据 GitHub 公开信息和官方文档(2026-11-01 复核):

项目
内容
当前星标
约 10.7 万(107472,10 月 31 日约 106141)
当前版本
15.7.0,需要 Node 20 或更新
开源协议
Apache-2.0(可商用)
主要支持
Claude Code;另有 OpenCode、T3 Code、OpenClaw、Antigravity、pi 等安装方式
数据存储
本地 SQLite(带全文检索)+ Chroma 向量库,数据和配置都在 ~/.claude-mem/
中文支持
有官方简体中文 README,内置 code--zh 简体中文模式
安装
npx claude-mem install
 一条命令

它是怎么工作的? 拆开看就四个零件:

零件
干什么
钩子
挂在会话开始、你发消息、工具调用前后、回答结束、会话结束这六个时间点,把发生的事交给后台
后台服务
一个本地小服务,负责调用模型把原始记录压成「观察摘要」,默认只监听本机 127.0.0.1
存储
SQLite 负责关键词检索,Chroma 负责语义检索
检索工具
通过 MCP 给 AI 三层工具:先搜索(每条结果约 50–100 token),再看时间线,最后按需取完整内容(每条约 500–1000 token)

省额度的关键就在第三层设计:先给 AI 一份很短的目录,它觉得有用才去取全文。官方称这样能省约 10 倍 token(官方说法,实际看你的项目)。

装与不装,差别在这几处:

没装 claude-mem
装了 claude-mem
开新会话
重新贴项目背景
自动带回相关摘要
历史查找
翻聊天记录
用记忆搜索技能直接问
token 消耗
每次重复交代
分层取用,只带需要的部分,还能看到花了多少
隐私控制
无
用 <private> 标签排除敏感内容

按 README,它还有个网页查看器,能看到存了哪些记忆、哪些会话,以及相关设置。

02怎么装?

Claude Code 用户(最常见):

先装好 Node.js,然后一条命令:

● ● ●命令 · 复制使用

npx claude-mem install

安装器会先把依赖装好(缺 Bun、uv 会自动补),然后让你在浏览器里登录 claude-mem 账号(邮箱链接,不用绑卡),可免费试用 30 天官方的记忆处理服务。

不想登录? README 写了:加一个明确的 --provider 参数,或者设置环境变量 CLAUDE_MEM_ONLINE_OPTIN=false,就能跳过账号环节。之后可以选用自己的 OpenRouter 或 Gemini Key,或者直接用你的 Anthropic 会员额度来做记忆压缩。

其他工具:

● ● ●命令 · 复制使用

npx claude-mem install --ide opencode # OpenCode 1.3.4 及以上

npx claude-mem install --ide t3code # T3 Code(Codex 和 Claude Code)

也可以在 Claude Code 里用插件市场安装:先 /plugin marketplace add thedotmack/claude-mem,再 /plugin install claude-mem。Antigravity、pi 等工具把 --ide 后面换成对应名字即可。

一个大坑: 别用 npm install -g claude-mem。README 专门提醒,那样只装了库,不会注册钩子,也不会启动后台服务,等于没装。

切成中文记忆: 编辑 ~/.claude-mem/settings.json,加一行:

● ● ●命令 · 复制使用

"CLAUDE_MEM_MODE": "code--zh"

这样存下来的摘要就是简体中文,自己翻看也方便。改完要重启后台服务才生效。Windows 上装完遇到问题,先跑 npx claude-mem doctor 自检。

上手三步:

1装好后,正常用 Claude Code 干一次活,比如让它看懂你的项目

2关掉,第二天开新会话,直接问「我们上次做到哪了」

3打开网页查看器,看看它到底记了什么,不该记的删掉

进阶配置(都在 ~/.claude-mem/settings.json 里改):

配置项
默认
什么时候改
CLAUDE_MEM_PROVIDER
claude
想换成 gemini、openrouter、codex 或兼容 OpenAI 的接口时
CLAUDE_MEM_EXCLUDED_PROJECTS
空
客户项目、公司项目不想被记,用通配符排除整个目录
CLAUDE_MEM_DATA_DIR~/.claude-mem
想把记忆放到加密盘或别的磁盘
CLAUDE_MEM_WORKER_PORT
按用户自动分配
端口冲突时固定一个
CLAUDE_MEM_LOG_RETENTION_DAYS
30
日志想留短一点

一个省额度的设置: 官方文档提醒,子代理的每次工具调用都会触发记录,一次大任务可能产生成百上千条低价值观察,甚至把免费额度打满。文档里有两个默认关闭的开关,可以过滤掉子代理的记录,用子代理多的人建议打开。

03和其他记忆方案对比

Claude Code 自己其实也有两套记忆,官方文档写得很清楚:

方案
谁来写
存什么
加载方式
适合
CLAUDE.md
你自己写
规矩、流程、项目架构
每次会话全部加载
团队共识、编码规范
自带的自动记忆
AI 自己写
你的偏好、你纠正过它的地方
每次加载前 200 行或 25KB
个人习惯
claude-mem
后台自动生成
每次会话干了什么、踩了什么坑
按需检索,先看目录再取全文
长期项目、多项目切换
手写交接文档
你或 AI 在会话末尾写
当前进度、下一步
下次手动贴进去
偶尔用、不想装插件

小鹿的建议: 不是三选一。规矩写进 CLAUDE.md,个人偏好交给自带记忆,「干到哪了、为什么这么改」交给 claude-mem。只做一两个小项目的人,先用自带的两套就够了。

04成本和额度:要花多少钱?
用法
费用
说明
本地引擎
免费
开源,装在自己电脑上
CMEM Pro
30 天试用,之后 $30/月
官方托管的记忆生成 + 多台电脑云同步 + 私有 MCP 链接;包含的用量在结账页显示
用你的 Anthropic 会员
占用会员额度
试用到期、没订阅时默认回落到这里
用自己的 OpenRouter / Gemini Key
按量付费
OpenRouter 默认选的是一个免费模型;Gemini 默认用 flash 系列
团队共享
试点阶段
官方写明团队公开价格未公布

省钱思路: 个人用户先选「自己的 Key + 便宜模型」做摘要,把会员额度留给真正写代码;试用期记得在日历上标好到期日,不想续就提前取消。

装完常见三问:

问:装了以后 Claude Code 变慢了? 记忆压缩在后台跑,正常不影响对话。明显变慢时先跑 npx claude-mem doctor,看后台服务是否反复重启。

问:新会话没带回记忆? 确认是用 npx claude-mem install 装的,而不是全局 npm 安装;再看查看器里这个项目有没有记录,项目名不对时可能是目录被排除了。

问:能不能多台电脑共用记忆? 本地引擎各存各的;想同步需要开 CMEM Pro 云同步,敏感项目慎重。

05普通人怎么用它省钱、搞钱?

路线 1:直接省会员额度

每次开会话少贴几千字背景,一天下来就是实打实的 token。用 Claude Code 会员的,额度能撑得更久;按 API 付费的,账单直接变薄。

路线 2:接外包的人,多项目来回切

同时接三四个小单,最怕切项目时脑子和 AI 一起断片。装上它,每个项目的决定、踩坑、客户要求都有记录,切回来直接接着干,交付速度上去了,能接的单也就多了。

路线 3:做长期内容/工具项目

做公众号工具、小程序、自动化脚本这类要慢慢迭代的东西,最怕隔一周回来全忘了。记忆插件相当于给项目配了个「工作日志」,自己回顾也省事。

路线 4:帮团队/工作室配置

README 里有可选的团队共享功能,每个人自己决定分享什么。小工作室可以让大家共享踩坑记录,新人上手更快。你会配,就能帮别人配,收个部署费。

06隐私自查清单与踩坑提醒

隐私自查清单(装完花五分钟过一遍):

●[ ] 打开网页查看器,翻一遍已存的记忆,有没有密钥、客户名、内部地址

●[ ] 客户和公司项目目录加进 CLAUDE_MEM_EXCLUDED_PROJECTS

●[ ] 确认后台服务只监听 127.0.0.1,别为了远程查看改成对外开放

●[ ] 匿名统计默认是开的,不想发就运行 npx claude-mem telemetry disable,或设置 DO_NOT_TRACK 环境变量

●[ ] 没想清楚之前,不开云同步和团队共享

●[ ] 截图功能保持关闭

●[ ] 每月清一次过时记忆

1. 记忆存在哪要心里有数。 默认存在本地 SQLite 数据库,设置文件在 ~/.claude-mem/settings.json。但如果你开了云同步(Cloud Sync),记忆会备份到官方服务器,敏感项目谨慎开。

2. 它会记下你聊过的东西。 它是自动记录的,你贴过的接口地址、客户名字、配置信息都可能进摘要。密码、密钥、客户隐私,用 <private> 标签包起来排除;更稳的做法是压根别贴进对话。定期打开查看器检查。

3. 截图默认不存。 README 写明截图功能默认关闭,开了才会存到本地 ~/.claude-mem/media-v1/,开了云同步才会上传。

4. 记忆压缩也要花钱。 摘要是靠大模型生成的:用官方服务试用期过后,会自动回落到你的 Anthropic 会员额度,除非你订阅;用自己的 Key 就是按量付费。装之前想好用哪种。

5. 记忆可能过时。 项目改了方向,旧记忆可能误导 AI。大改之后,让它重新看一遍代码,别完全依赖记忆。

6. 小心「代币」。 项目 README 里有推广一个第三方加密代币的内容。这跟插件好不好用无关,小鹿不建议任何人因此去买币,涉及投资的一律自己判断风险。

写在最后

AI 越用越顺手的关键,不是换更贵的模型,而是别让它每次从零开始。claude-mem 把「记住上次干到哪」这件事做成了一条命令。

今天的行动建议:在一个不敏感的小项目上装起来,用两天,打开查看器看看它记了什么。 觉得靠谱,再推到正经项目上。

留言区聊聊:你被 AI「失忆」坑过最惨的一次是什么?呼声高的,小鹿出一篇「AI 编程省额度清单」。

如果你想系统地把 AI 工具变成副业,可以看看公众号菜单里的付费合集「AI 副业实操 7 讲」和提示词模板包。

我是小鹿搞AI,专注 AI 赚钱实操和 AI 工具教程。点个关注,有新工具、新玩法,我会尽快帮你拆明白。

(本文星标、版本与功能信息来自 GitHub 公开页面及官方 README,配置项、遥测说明来自 docs.claude-mem.ai,价格来自 cmem.ai 定价页,均于 2026-11-01 复核;CLAUDE.md 与自动记忆的说明来自 Claude Code 官方文档。安装与命令以官方文档为准。)

🦌

我是小鹿,关注「小鹿搞AI」每天一个AI赚钱实操

觉得有用就点个「赞」和「在看」,留言区等你来聊 👇

★ 设为星标 不错过更新

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料