claude-mem：用 MCP 给 Claude Code 装上长期记忆，告别失忆-北京尧图网络

1. 先说背景Claude Code 为什么会“失忆”1.1 每次会话都是“新同学”Claude Code 用久了最让人崩溃的其实不是模型能力不够而是它“记性太差”。昨天刚跟它对齐过项目背景、技术选型、代码风格今天新开一个会话它就跟第一天上班一样满脸写着“你谁啊”。我前期每天都要花掉大量 token 在重复交代背景上越用越窝火后来找到 claude-mem 这个工具才算是把这个问题真正解决掉。大语言模型本身是“无状态”的。我的理解是模型每次推理时只能看到当前上下文里的内容上下文窗口之外的任何东西对它来说都不存在。Claude Code 虽然包装得很完整有文件读取、命令执行、对话管理但它依然逃不掉这个架构限制。每次会话就是一次独立推理系统提示、对话历史、工具输出拼成一个临时世界会话结束这个世界就销毁了。这不是 bug是架构决定的。所以“让 AI 记住之前聊过什么”本质上是一个工程问题而不是模型能力问题。谁能在模型之外搭一层持久化机制谁就能让 AI 从“聪明但健忘”变成“把背景装在脑子里再干活”。举个最典型的例子周一我告诉它这个仓库用 pnpm不要用 npmNode 版本必须 20代码风格是 4 空格缩进、不加分号。周二我新开一个会话让它加个依赖它照样给我塞一个 package-lock.json 进来。这种重复劳动一次两次还能忍时间长了真的会让人怀疑自己是不是在使用一个“每次都失忆”的实习生。1.2 大家通常怎么应对这种失忆社区里最常见的解决方案有三个我全部试过各有各的难受。第一种是把背景写进CLAUDE.md。这个文件放在项目根目录Claude Code 每次会话会自动读取。它适合静态的项目约定比如技术栈、目录结构、常用命令。缺点也很明显所有内容必须手动维护。你得自己起草、整理、更新而且要控制长度否则每次请求都白白吃 token。我见过有人把CLAUDE.md写到几千行结果模型读文件本身就开始变笨因为上下文里光背景就占了一多半。第二种是把背景写进一段“开场白 prompt”靠肌肉记忆在每次会话开头粘贴。我早期就是这么干的。为了省事我把项目介绍、代码规范、常用脚本全部塞进一个模板每次开新终端就复制进去。这个办法能救急但很不优雅。一旦信息变了你得把所有终端里保存的模板全部更新一遍。而且你还要记得这件事哪天忘了粘AI 就又开始胡说八道。第三种是交给 MCP 服务器做动态检索。Claude Code 支持 MCP 工具调用也就是让模型在需要的时候主动去“查资料”。claude-mem 就属于这一类但它比普通记忆工具多做了两件事一是自动识别“什么值得记”二是把记忆按规则分类归档。它不依赖你把所有背景塞进上下文而是像搜索引擎一样平时归档用时检索。从这三种方案的对比能看出来真正可持续的方案不是“每次都喂”而是“让它自己记得需要的时候自己取”。claude-mem 走的就是这条路。2. claude-mem 到底是个什么东西2.1 它本质上是给模型外接了一套长期记忆如果CLAUDE.md是大字报claude-mem 就是一层真正参与工作的记忆系统。它不是一个提示词技巧也不是一个钩子脚本而是一个独立的 MCP 服务器进程通过 npx 启动数据落在本地 SQLite 文件里。稍微解释一下 MCP。它的全称是 Model Context Protocol模型上下文协议是一个标准化接口让大模型应用可以外接各种工具和数据源。Claude Code 里配好 MCP 服务后Claude 就能通过工具调用的方式读写 claude-mem 暴露的能力。你不需要关心底层细节只需要知道这个协议让模型可以“伸手”去访问外部世界而不是只停留在对话本身。了解完协议再看 claude-mem 的工作方式就顺理成章了。每次会话开始时它会从本地记忆库里筛选出与当前项目相关、且时效性较高的记忆组装成一个结构化的记忆块注入到系统提示中。Claude 看到这个块就相当于拥有了一页自己的笔记。随后在对话过程中Claude 遇到值得保存的新信息又会调用记忆工具把信息标记为“候选记忆”等待用户确认后写入 SQLite。这个过程最妙的地方在于它不是一个大而全的数据库而是按需注入。你跟它聊前端项目它不会突然冒出另一个 Python 项目的记忆。这种“隔离感”非常重要也是我后来用得舒服的核心原因。2.2 记忆不是一句命令是一个审批流claude-mem 最值得聊的设计就是它把“记忆”当成一个需要把关的流程而不是一个日志追加。初次接触时模型会把信息标记为“候选记忆”这是一个待确认状态。之后你有两种方式处理要么在终端里启动审查界面对每条记忆决定允许还是拒绝要么直接在对话里跟 Claude 说“记住这个”或“不用记”。被允许的记忆才会成为正式记忆进入本地库。官方把这套机制叫记忆审查。为什么必须加这一步因为 AI 识别“值得记忆的信息”这件事准确率远没有想象的那么高。我遇到过好几次它把调试中的临时值当成项目约定还有一次它把我随口说的服务器端口直接记成了“个人事实”。如果没有审批流第二天这些错误记忆就会注入到所有相关会话既浪费 token又可能误导模型。另外记忆是有分类的。我实际使用中接触到的类型大致有四种类型内容示例注入场景个人信息personal你常用的系统环境、工作习惯所有项目项目信息project某仓库的技术栈、目录约定对应项目偏好preferences你喜欢的代码风格、工具选择所有项目事实facts某个服务的端口号、API 返回格式相关场景分类的意义在于注入上下文时可以精准筛选。项目记忆在对应项目里注入全局个人信息在所有项目里注入临时性事实则根据相关度判断。有了这套分类Claude 才不会把 A 项目的经验套到 B 项目上。3. 安装与配置细节3.1 前置环境要求开始配置之前先说清楚环境依赖能省不少弯路。claude-mem 本体是 Node.js 包所以机器上必须有 Node.js 环境。官方推荐 18 以上版本我实际用的 Node 20跑了很久没有出过问题。另外还要确保 Claude Code 已经能正常登录使用因为 claude-mem 本质上是 Claude Code 的外挂脱离 Claude Code 单独跑它没有任何意义。还有一点容易被忽略claude-mem 是通过 npx 从 npm registry 拉取的首次运行需要联网下载。如果你的网络环境不太稳定第一次启动 MCP 很容易超时。这个我后面在问题排查章节会专门讲这里先提醒一句。3.2 把 claude-mem 接进 Claude Code配置过程本身不复杂核心思路就一句话让 Claude Code 知道你有一个可用的 MCP 服务器。最直接的方式是用 Claude Code 自带的命令注册claude mcp add -- claude-mem npx -y claude-mem这个命令的意思是新增一个名为 claude-mem 的 MCP 服务器启动方式是npx -y claude-mem。其中的-y参数让 npx 在缺包时自动下载不需要每次确认。执行完可以用claude mcp list检查是否注册成功。如果你更倾向于用配置文件管理可以编辑项目根目录下的.mcp.json{ mcpServers: { claude-mem: { command: npx, args: [-y, claude-mem] } } }这里有个细节要留意两种方式的作用域不同。claude mcp add默认把配置写到全局用户目录所有项目都能用.mcp.json放在项目里跟着仓库走团队成员也能共享这套配置。如果你只想自己本地用全局添加就行如果想让同一个项目的协作者都享受到记忆能力.mcp.json更合适。配置完成后重开一个 Claude Code 会话让它重新感知 MCP 服务器。可以在会话里直接问 Clode“你有哪些工具可以用”如果它能列出记忆相关工具说明已经接通了。3.3 首次运行的“记忆审查”体验第一次实际使用会有一点不适感因为 Claude 会开始频繁地冒出“我帮你记住了一条信息是否确认”这类话。这就是记忆审批流在前台的表现。在终端里运行claude-mem会打开一个交互式审查界面列出所有待批准的记忆。每条记录会展示记忆内容、来源会话、分类推测、时间戳。你需要逐条决定允许还是拒绝也可以手动调整分类。第一次用的时候我盯着这个界面看了很久因为 Alfred 把我说过的很多东西都当成了候选记忆但其中九成都是废话。用过两天后我有一个体会审查界面不用天天开养成在对话中随手确认的习惯更高效。Claude 问“要不要记住这个”你直接回“记住”或者“不用记”它会立刻处理。真正值得保存的记忆是那些项目里反复出现的背景信息比如“这个仓库的构建命令是 make build不是 npm build”。这种信息你不批准它它下个会话还真就忘了。3.4 全局记忆和项目记忆怎么选claude-mem 的记忆作用域分成全局和项目两类。全局记忆存在用户目录下所有项目都能读项目记忆绑定到当前项目路径只在该项目的会话中注入。全局记忆适合放跟项目无关的个人事实和偏好比如“你常用 macOS 和 zsh”“你写代码喜欢显式类型标注”“你不喜欢依赖大型 monorepo 工具”。项目记忆则适合放技术栈、目录约定、踩坑记录。我第一次用的时候没注意区分全局记忆里混了一堆项目细节结果在 A 仓库工作时Claude 突然想起 B 仓库的目录结构回答得莫名其妙。后来我专门花了一个晚上把已有记忆重新整理把跨项目无关的信息全部划到全局项目特有的全部锁进项目作用域整个体验就干净多了。配置文件里也体现了优先级项目记忆优先于全局记忆注入时如果出现冲突以项目内的记录为准。4. 上手实操命令、注入与场景4.1 常用命令速查表我先把自己平时用得最多的命令整理出来。严格讲不同版本的命令名可能有细微差异建议以你自己电脑上那个版本的--help输出为准。我这里列出的是我环境里稳定可用的命令用途我的常用参数claude mcp list查看 MCP 服务器连接状态无claude-mem打开记忆审查界面无claude-mem search 关键词全文检索记忆库--limit 20控制条数claude-mem export导出全部记忆为 JSON 备份--prettyclaude-mem health检查数据库状态和进程健康度无claude-mem config查看当前配置项无真正上手以后你会意识到在终端里敲命令的时间其实不多大量交互发生在对话里。命令更像是一个管理后台用来处理那些对话里搞不定的事比如批量审查历史候选记忆、导出备份、检查健康状态。4.2 记忆是怎么注入上下文的这是 claude-mem 最核心的机制之一决定了它能不能让你的对话自动带上背景。整个过程可以拆成三步筛选、排序、注入。会话初始化时claude-mem 先从本地库中选出与当前项目关联度高的记忆集合同时混入一部分全局记忆再按相关度和时间新鲜度排序组装成一个结构化的记忆块放在系统提示的末尾。Claude 看到这个块之后就相当于拥有了一页自己的笔记后续回答和推理都会带有这些上下文。这样做有一个明显好处不是所有记忆都无脑塞进上下文。它更像一个“上下文预算”的管理员把值得带的记忆放进来把无关的先留在库里。项目记忆、用户偏好、近期高频出现的实体是优先级最高的三类内容。但要注意的是注入的记忆块本身会占用 token。如果库里积累了几百条记忆每次启动都全部注入上下文会被瞬间顶满。好在工具内部做了长度控制不过依然建议定期清理具体方法我在下一章详说。4.3 真实工作流示例我这里分享三个实际在用的场景都是 claude-mem 帮我省时间的地方。第一个场景是多项目切换。我同时维护三个项目一个前端库、一个 Python 服务、一个文档站。以前切项目开新会话必须手动复制一段项目背景提示词现在完全不需要。每个项目的技术栈、启动命令、目录约定都在项目记忆里Claude 自己会去取。效果非常明显。第二个场景是跨会话排障。有一次某依赖问题花了我一整天最终结论是某 npm 包的版本和 Node 版本不匹配。我把结论告诉 Claude并用“记住这个”固化下来。过了几天相同问题再次出现我还没开口Claude 就直接说“这跟你上次遇到的那个依赖版本坑一样建议先查 node_modules”然后帮我直接修改了版本号。它等于把我上次排障的记忆变成了自己的经验。第三个场景是给旧项目续命。有些仓库半年没动重新捡起来的时候连我自己的记忆都模糊了。打开会话claude-mem 会自动注入上次会话留下的项目架构笔记省掉了我翻文档、翻 git log 的时间。特别是里面存了“那个模块当初为什么这么写”这类原因型记忆比纯代码注释有用得多。5. 常见问题与排查实录5.1 记忆完全不生效怎么办这是新用户遇到最多的问题。症状是配置也配了MCP 也列出来了Claude 就是不主动用记忆或者聊了半天一条候选记忆都没产生。我的排查顺序是这样先跑claude mcp list确认 claude-mem 这个 server 的状态是 connected。如果是 failed多半是 npx 下载或 Node 版本问题。在会话里直接问 Claude 有没有记忆相关工具可用。如果它说没有很可能是新开的会话没重新加载 MCP重开会话即可。检查本地数据库文件是否生成。如果没有任何包含 claude-mem 数据的文件出现说明 MCP 进程虽然启动了但还没写过任何内容。检查工具权限。为了安全有些用户会把工具调用设置成“每次都需要询问”导致 Claude 每次调用工具都要先问人而实际交互中没人去答复它就干脆不用工具。遇到这种情况可以考虑把 claude-mem 的工具权限设为 allow。还有一个非常隐蔽的坑CLAUDE.md里写了“不要保存任何记忆”之类的规则这会直接让 Claude 拒绝执行记忆类操作。如果你之前用过某些记忆管理型提示词它们可能会相互打架。我自己就踩过这个坑排查了半小时才发现是规则冲突。5.2 MCP 启动慢或超时npx 第一次运行某个包的时候需要先把整个包和依赖下载到本地。这个过程在网速不理想时可能长达十几秒而 Claude Code 对 MCP 初始化是有超时预期的一旦超过时限就不会加载该服务器。症状就是claude mcp list显示 failed。解决办法其实很直接先手动在终端跑一次npx -y claude-mem之类的命令把包预下载到本地之后再重开 Claude Code 会话就快了。如果还不行干脆把 npx 换成全局安装npm install -g claude-mem然后 MCP 配置里直接把命令指到全局安装路径。这种方式最稳妥尤其适合每天都要用的人。我当时安装的时候就在这一步卡了十几分钟后来发现是网络问题手动预热了一下就好了。5.3 误记和隐私问题这是所有记忆工具绕不开的话题。claude-mem 的设计里有个值得肯定的点候选记忆默认不写入必须经用户确认。但问题在于很多人在对话很流畅的时候根本不看审查界面随手就点了允许结果把不该长期存的东西也存了进去。我的建议是三条。第一涉密信息绝不进记忆。如果你在对话里提到了 token、密码、内网 IP 之类的东西第一时间要让 Claude 不要保存并且用管理功能把已经保存的相关条目删掉。别指望 AI 自动判断哪些是机密它没有你的判断标准。第二定期导出备份加清理。我给自己定了一个每周任务跑一次claude-mem export导出 JSON 备份然后打开审查界面批量清理掉已经过期的记忆。特别是临时性事实比如“明天要发版”这种过期之后留着只会添乱。第三保持记忆库精简。少而准永远比多而乱好用。如果一条记忆的语义和项目里某段文字重复就保留其中一个不要两个都留。记忆库臃肿的直接后果就是注入上下文变长、模型变笨。5.4 记忆越攒越多上下文快被撑爆记忆注入上下文是有 token 成本的。如果库里塞了上千条记忆注入模块可能会尝试全塞进去导致每次对话的可用上下文大打折扣甚至出现“Claude 明显变笨”的现象。这其实是你在付出重复的 token 成本但得到的收益却越来越低。怎么处理首先是定期清理过时记忆这个前面说过了。其次是善用搜索而不是依赖注入很多记忆并不需要在会话开始就全局注入可以在需要时让 Claude 调用搜索工具去查。最后如果发现某些项目记忆根本用不上可以直接删除整个项目级别对应的记忆组批量处理往往比一条条删快得多。顺便提一句claude-mem health这个命令能看不少信息比如数据文件大小、记忆总数、最近写入时间。我一般每两周跑一次数据文件开始膨胀的时候就主动清理。6. 我的几点使用心得和补充建议写到这里把这段时间用下来的真实感受整理一下希望能帮到想上手的人。最重要的一点claude-mem 发挥价值的前提是你真的在一段时间内反复和 Claude Code 处理同一批项目。如果只是偶尔玩一下AI 的记忆其实可有可无但只要你是高频使用哪怕每天省下十分钟的背景交代一个月下来也是很大的收益。它解决的不是“让 AI 更聪明”的问题而是“让 AI 更像一个熟悉你项目的同事”。从工程角度讲记忆和上下文之间的平衡是长期要操心的。好的记忆系统不是把什么都存下来而是知道什么值得存、什么该忘。claude-mem 的审批流已经帮我们拦了一部分剩下的要靠自己的使用习惯。我现在的做法是项目级记忆尽量少而明确全局记忆只放稳定偏好凡是可能变化的临时信息一律不进长期记忆。最后分享一个我自己常干的事每次完成一个比较重要的排障或架构调整之后我会主动让 Claude 总结一条“这次的坑结论”存进记忆。这样用下来的效果很像一个越用越顺手的个人知识库而且这些知识都是跟着你的实际项目长出来的比任何通用模板都值钱。如果你也在被 Claude Code 的失忆问题折磨建议花一个下午装上试试大概率会回不去。

claude-mem：用 MCP 给 Claude Code 装上长期记忆，告别失忆

相关推荐

数据科学中的本体论与数据边界问题解析

无损音乐转MP3实战：渠道验真、伪无损识别与FFmpeg批量转码

YSUP 5.17 SMT离线编程部署与M-TOOL运维全流程

更多资讯

基于Java技术栈的河南美食分享系统开发实践

caveman：轻量级React原子状态管理工具

secs4net实战：基于SECS/GEM的半导体设备通信实现与避坑指南

旋转位置编码(RoPE)原理与Transformer实战指南

大数据清洗：方法论、工具与行业实践

YOLOv8集成Albumentations实现高级数据增强实战

今日更新

微信个人号API开发案例：图片/语音/视频消息怎么下载解析存到本地？

Python股票自动交易系统源码解析：从行情获取到风控的完整链路

视酷酷信IM源码部署指南：Java 17+MySQL 8.0.33实战配置

本周精选

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？