Claude Code 持久存储:claude-mem 永不触及上下文限制
来源: 今日头条 - 尧字节 (2026-04-14)
原文链接: https://m.toutiao.com/article/7628620894348263972/
GitHub: claude-mem (54.8k stars)
每次打开 Claude Code 都要重新教一遍它你的项目?
你昨天跟它聊了三小时,把项目架构、代码规范、踩过的坑全讲清楚了。今天一开新会话,它又来一句“你好,请问你需要什么帮助?”,你心里只有三个字:又来了。
用 AI 编程助手的人都有这个体会。Claude Code 写代码确实爽,但它有个硬伤——每次会话结束,它就失忆了。你上次修过的 bug,这次它不记得了。你定好的代码规范,它又忘了。你上次跟它说“别用那种写法,有坑”,它又踩进去了。
不是它笨,是它天生就这样。每个会话都是全新的。
后来有人做了个东西,叫 claude-mem,专门治这个毛病,在github上已经达到54.8k 个star。

claude-mem 是干什么的

image.png
简单说,它是给 Claude Code 装的“记忆芯片”。装完之后,Claude 就像从一条金鱼变成了一头大象——它开始记得你跟它说过的那些重要事情。
不用你手动记笔记,也不用每次重新介绍项目背景。它自己在后台默默工作。每次你跟 Claude 对话,它都在旁边记笔记,但不是傻乎乎地全存下来——那样太费 token 了——而是用 AI 把关键信息提炼出来,存到本地数据库里。下次你开新会话,它自动把相关的历史记忆拿出来,塞给 Claude。
整个过程你感觉不到。你问问题,Claude 回答,看起来跟以前一样。但它脑子里已经装着上次你们聊过的东西了。
它怎么做到的
原理其实不复杂。claude-mem 在 Claude Code 的各个关键节点上安了几个“监听器”——会话开始的时候、你发消息的时候、Claude 用工具的时候、会话结束的时候。每个节点它都会把该记的东西存下来。

image.png
存下来之后,有个后台服务专门负责整理这些原始记录,用 Claude 自己的 Agent SDK 把它们压缩成精炼的“观察记录”。比如你跟 Claude 讨论了一小时怎么修某个 bug,最后它记下来的是“auth.ts 第 47 行,把超时时间从 5 秒改成了 10 秒,解决了登录超时问题”。
下次你再问“上次那个登录超时问题怎么修的”,Claude 会自动调用搜索功能,找到这条记录,然后告诉你答案。
最妙的设计:渐进式披露
claude-mem 有个设计挺聪明的。它不是每次会话都把全部历史一股脑塞给 Claude——那样太浪费 token 了,而且也没必要。
它用的是“渐进式披露”。会话刚开始的时候,只给 Claude 看一个极简的目录:过去有哪些会话、大概讲了什么、每条记录大概消耗多少 token。等 Claude 发现需要深入了解某个细节的时候,它再去调用搜索,把完整的内容调出来。
这就好比你翻一本书,先看目录,再翻到感兴趣的那一页。而不是把整本书从头读到尾。
实际上手感觉:Claude 只有在需要的时候才会去翻历史,平时几乎不消耗额外 token。
怎么装
安装挺简单,在 Claude Code 终端里敲两行命令:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
重启 Claude Code 之后它就自动开始工作了。
装完之后你可以在浏览器打开 http://localhost:37777,有个网页界面可以实时查看记忆流、搜索历史记录、或者调整设置。
平时基本不用管它。你就正常用 Claude Code,它在后台自己记东西。
日常怎么用
装完之后,你跟 Claude 的对话会自然多出一个能力:你可以直接问它关于过去的事情。
比如你可以在新会话里直接问:“上周我们修的那个性能问题,具体改了哪些文件?”它会自己调用搜索,找到相关记录然后回答。
或者问:“这个数据库迁移方案,我们之前讨论过吗?”它也能翻出来。
长期用下来,它会慢慢积累出一个项目的“知识图谱”——架构决策、常用代码模式、踩过的坑和解决方案。这些东西不用你手动整理,它自己就沉淀下来了。
一个小提醒
claude-mem 用的是 AGPL 协议,如果你自己用完全没问题。如果你打算基于它做二次开发然后商用部署,这个协议对代码开源有要求,需要留意一下。
另外 ragtime 目录是单独的 PolyForm Noncommercial 协议,非商业用途才免费。
说句实在的
我用 Claude Code 有一阵了,最烦的就是每次都要重新教它。claude-mem 把这个痛点解决得不错——它不打扰你正常使用,就在后台默默记东西,需要的时候自己能翻出来。
不是什么花里胡哨的功能,就是解决了 AI 编程助手最基础的一个问题:记住你。
项目地址:github上搜索claude-mem
点击展开剩余 66%
举报