claude-mem：为 Claude Code 搭建跨会话长期记忆的 MCP 方案-北京尧图网络

很多用 Claude Code 的老哥都有同一个体验上午跟它把项目架构聊得明明白白连测试怎么写、接口怎么命名都对齐了下午新开一个终端会话它又变回一个“失忆的陌生人”。你只能把上午说过的话原封不动再说一遍。claude-mem这个开源项目就是专门来解决这个问题的。它通过 MCPModel Context Protocol给 Claude Code 搭了一层跨会话长期记忆把你在终端里的交互、偏好、项目约定、决定过的技术方案都沉淀下来下一次会话开始前主动塞回给 Claude 用。我第一次听到这个名字以为只是个简单的“保存上下文”脚本结果实际用下来发现它做的事比我想象中系统得多会话摘要、用户偏好、项目维度记忆、行为画像全部拆开管理。如果你已经把 Claude Code 当成日常主力开发工具或者你同时维护好几个项目、每个项目的工程习惯还不一样那这套记忆层能帮你省掉大量的重复沟通成本。这篇就把我的安装过程、使用记录、踩过的坑一次性讲清楚。1. 先搞明白claude-mem 到底解决了什么1.1 被“失忆”反复折磨的 Claude Code 用户Claude Code 本身是个非常强的终端编程助手但它默认的工作方式是一次性的。它只看到当前会话里的上下文关掉终端就等于清空大脑。你说“这个服务层不要用 any 类型”它记住了但只记到当前窗口关闭为止你下次打开项目让它写个新接口它又把类型约束忘得一干二净。我自己被这个问题搞崩过好几次。最典型的一次是接别人留下的老项目代码里全是历史包袱。我花了一个小时在会话里跟 Claude 解释“这个模块别动、那个目录是自动生成的、测试必须要走某个 helper”。当天写得很顺第二天继续做新功能它又准备去重构那个不该碰的模块我只能再把规则解释一遍。这种重复不是效率低下的问题是完全无意义的消耗。claude-mem做的就是在这种“一次性大脑”外面加一个持久化存储层。它记录下来的是高质量的结构化记忆而不是把原始聊天记录堆在那里。你进一步跟它讨论时它能在需要的时候把记忆捞出来作为新会话的上下文背景。换句话说它让 Claude Code 从“每次都重新认识你”变成了“越用越懂你”。1.2 为什么是 MCP 而不是简单改配置第一眼看到 MCP 这个词很多人可能会觉得是一个新框架又要学一遍。其实理解起来并不复杂MCP 是 Anthropic 为 Claude 系列工具设计的标准化外部能力接入协议可以理解为给 AI 开了一堆“可调用的外部插件接口”。记忆这件事本质就是一个外部数据源用 MCP 来做是最顺的这样 Claude 在会话里可以主动去记忆库做检索、写入而不是依赖我们把一大段历史文本硬塞进 Prompt 里。把记忆做成 MCP server 而不是改 Claude Code 本体有个很实际的好处它不需要动 Claude Code 的源码也不需要你写一堆复杂的 Prompt 模板。安装好之后Claude 会把 claude-mem 当成一个普通的工具列表来调用。对我来说这比任何“记忆增强插件”都更干净升级 Clude Code 不会影响它出问题也容易单独排查。再说设计思路。claude-mem把记忆拆成几类处理会话摘要把一整段对话的关键决定压缩成摘要。用户偏好记录你的工作习惯比如“优先写 TypeScript”“不要用 class 组件”。项目约定某个仓库的架构规则、命名规范、测试方式。行为画像从你过往的交互里推断出的稳定特征。我觉得这种分层非常关键。如果你不做区分把什么都混在一起存那下次检索的时候就会召回大量无关信息反而污染上下文。分了层以后全局偏好管通用规则项目级记忆管单仓库的事互相不干扰。2. 安装与接入把记忆模块挂到 Claude Code 上2.1 安装前要准备什么先说结论安装过程不算难但环境的细节容易埋雷。你机器上要提前准备好Node.js 版本 18 或更高npm 能正常跑全局包。Claude Code 本身已经能用登录状态正常。有 npx因为很多 MCP 服务默认通过 npx 拉起。如果你在 macOS 上用的 Node 是系统自带或者通过 pkg 安装器装的装完后可能遇到权限问题npm 全局路径不在 PATH 里。Windows 也有类似的坑安装完 node 别忘了把%APPDATA%\npm加进 PATH。我见过很多朋友卡在“装完了但命令找不到”这步其实就是 PATH 的问题不是工具本身的问题。2.2 三条命令完成接入正常情况下接入过程可以压缩成三条命令npm install -g claude-mem claude-mem init claude-mem第一条是把claude-mem装到全局方便后续在任意项目里直接用 TUI 界面管理记忆。第二条最关键init会帮你在 Claude Code 的配置里注册 MCP server。它一般会自己定位到 Claude Code 的配置文件把claude-mem加进去。第三条命令是打开交互界面查看记忆数据、配置项和索引状态。如果你更倾向于手动控制配置把 MCP 注册信息直接写进 Claude Code 的配置文件也可以常见的形式是这样的{ mcpServers: { claude-mem: { command: npx, args: [-y, claude-mem] } } }手动配置的好处是你一眼能看清 Claude Code 到底挂载了哪些 MCP 服务出了问题也方便排查。不过我自己的使用习惯是先用claude-mem init自动注册等确认稳定之后再去翻配置文件看看路径有没有偏。2.3 验证接没接上配置写完以后必须重启 Claude Code 会话让 MCP 配置重新加载。这一步特别容易忽略。我最初就是改完配置没重启然后在会话里问“你现在有没有记忆相关的工具”它回答没有我还在那怀疑安装出了问题。重启之后再说Claude 就能列出 claude-mem 提供的工具了。还有一个常用的验证手段是直接在会话里敲/mcp这是 Claude Code 自带的 MCP 管理命令能看到当前挂载的所有 MCP server 状态。如果 claude-mem 出现在列表里并且显示正常运行说明接入已经完成。你再去观察它的数据目录如果看到已经有文件生成那就更稳了。有一点要注意claude-mem第一次被拉起时npx 可能要现场下载依赖所以第一次调用启动速度会明显慢一些。这不是卡住了给它一点时间。3. 记忆是怎么写入、保存、又被唤起的3.1 一次完整的“记住”流程我在实际使用前一直以为记忆是“边聊边逐字记录”。后来跑了几个完整会话才明白它做的是更高层次的摘要和归纳。你可以理解成这样的流程你跟 Claude 在会话里交互claude-mem 并不会把每一行指令都存下来而是按一定节奏或是在合适时机对当前这一段上下文做一次提炼。比如你告诉它“这个项目的 API 层统一走 Repository 模式”它会在下一轮摘要里把这句话变成一条结构化记忆标注这是项目级约定。当某次会话结束了它还会生成一个 digest把这次会话最重要的决策、产出、待办事项压缩成一条精炼摘要。这些摘要不是随便拼几句。claude-mem 会尽量保留那些“以后有必要再拿出来说”的信息技术选型、禁止事项、命名约定、你补充过的背景知识、你纠正过它的地方。那种“今天天气不错”之类的闲聊内容就不会被保留存了也没有检索价值。3.2 数据到底存在哪里数据存储这块我很喜欢它的本地优先设计。默认情况下记忆数据落在用户目录下的~/.claude-mem文件夹里里面有 SQLite 数据库也有一些可读的文本或 JSON 文件。SQLite 存的是结构化数据方便做相似度匹配和索引可读文件则方便你自己翻看、手工编辑。用 SQLite 而不是直接堆文本文件是很实际的选择。一方面数据库读写能力强检索速度比全文翻目录快得多另一方面MCP 工具在召回记忆时经常要做过滤、排序、去重这类操作SQLite 能直接支持这种逻辑。你要把它同步到另一台机器直接拷贝数据库文件就行不需要额外部署服务端。这也带来一个好处所有记忆数据都在你手里没有第三方云端参与。对写商业项目或者涉及敏感代码的朋友来说这比把聊天记录上传到外部服务安心很多。代价是你得自己负责备份这个我放到后面的排查部分再说。3.3 记忆召回的触发条件很多人的疑问是Claude 怎么知道在什么时候该用哪条记忆它总不能每次会话都把所有记忆一股脑塞进上下文吧。claude-mem 的做法是根据项目和场景做筛选。新开一个会话时MCP 上下文会带上当前工作区的信息claude-mem 从这个信息里找出“这个项目以前记录过哪些关键约定”把最相关的一批记忆检索出来作为背景给到 Claude。如果你在某个仓库里干活它优先带的是这个仓库的约定而不是你在别的项目里存的东西。它也提供主动检索工具。你可以直接让 Claude“查一下我们之前说过关于部署流程的内容”它就会通过 MCP 工具去记忆库里搜。这种主动调用模式对长时间跨度的项目特别有用因为你不可能每一条旧记忆都在新会话开始时自动浮现但它们确实还在库里需要时能捞出来就行。其实我更愿意把召回想成搜索引擎而不是记事本平时不显山不露水但你输入关键词或遇到相关问题相关记忆就被翻出来。这样不会因为记忆太多而把上下文撑爆又能在关键场景派上用场。4. 实操记录从零开始跑通一个带记忆的项目4.1 第一次会话先让 AI 记住环境我第一次认真测试 claude-mem是在一个用 pnpm 管理依赖、用 vitest 写单测的中型 Node 项目上。开一个新会话在终端里跟 Claude 说“以后在这个项目里包管理器统一用 pnpm测试命令是 npm run test。”然后把会话关掉跑了一下claude-mem打开界面果然能看到刚才那句话已经变成了一条项目记忆静静躺在对应目录里。接下来验证关键一步我再开一个新会话不主动提任何背景只跟它说“帮我写一个新模块的测试框架”它给出的方案直接是 vitest 风格并且自动按照项目里已有的测试目录结构来组织。放在以前它大概率会给我一个 jest 或者 node:test 的示例因为这两者在通用训练里更常见。这种“不用你提它就知道”的感觉跟默认状态之间的差距非常明显。不过我也要提醒一点让 AI 记忆环境信息不等于把整个项目代码都塞进来。claude-mem 记录的是“关于项目的规则和偏好”不是把代码文件本身存下来。代码内容该由 Claude Code 按需读取记忆层只负责“怎么干活”这一类元信息。4.2 不同记忆层全局、项目、人物画像如果所有项目共用一套记忆那多项目开发会乱套。你的 A 项目用 pnpmB 项目用 yarn把“用 pnpm”设成全局规则的话B 项目也跟着遭殃。所以记忆分层不是锦上添花而是刚需。我自己习惯按下面这个表格来理解和使用记忆层作用范围适合存的内容全局记忆所有项目、所有会话通用习惯、常用工具、个人偏好项目记忆单个仓库或工作区架构约定、测试规范、文档目录结构人物画像针对用户角色的稳定特征“我是负责前端的”“回复要直接不要啰嗦”全局记忆适合那些你在任何项目里都不变的东西比如“我通常用双引号而不是单引号”“我习惯看简洁的 commit message”。项目记忆则绑定到具体仓库进到哪个项目就加载哪套规则。人物画像这一层更像是长期维度上的 user profile每次会话都会或多或少影响 Claude 的输出风格。我刚上手的时候犯过一个错把项目专用规则写在没有项目限定的全局层结果所有项目都受影响。后来在 TUI 清理掉重写才理顺。所以我的建议是凡是跟具体仓库强相关的约定一定要放进项目层不要图省事直接走全局。4.3 参数微调摘要频率、记录范围claude-mem 默认行为的设定不一定适合所有人。我自己的做法是打开配置文件调整几个关键参数。常见的调整点包括是否开启会话摘要、摘要生成频率、是否记录用户偏好、是否记录人的画像。一个典型的配置段长这样{ session_digest_enabled: true, session_digest_frequency: 30, store_user_preferences: true, store_personas: true, record_code_context: true }session_digest_frequency的默认单位是分钟我一般设成 30也就是每隔半小时对会话做一次摘要整理而不是等到会话结束才一次性处理。这样中途断线也不怕至少最近半小时的上下文已经有了一份快照。但我不建议把摘要频率调得太低。如果每过五分钟就来一次 digest有效信息没多少反而生成一堆重复片段既占存储又污染召回。等到你对这个项目足够熟悉、规则都稳定下来了把频率调高一点也没关系因为会有大量新增信息需要记录。另外一个重要开关就是record_code_context。开着它Claude 会把代码文件路径、模块关联这类信息也纳入记忆体系方便跨会话延续某个文件里的讨论。如果你的项目是部分代码涉及敏感内容可以关掉这个只保留规则和约定减少记忆库里的具体实现片段。5. 常见问题与排查经验5.1 最容易被忽略的“MCP 未生效”我见过最多的问题不是安装失败而是装完之后 Claude 完全“没有记忆”的感觉。第一反应是配置坏了实际上 80% 的情况是 MCP 没有真正加载。排查路径我整理成了固定的顺序确认你是否重启了 Claude Code。修改 MCP 配置后旧会话不会自动加载新工具必须新开会话。在会话里执行/mcp看看 claude-mem 的状态是不是 running。如果是 error多半是 npx 路径或者 node 版本问题。检查~/.claude-mem目录下有没有数据文件。如果没有说明 server 根本没正常跑起来。如果使用 npx 启动第一次运行时需要下载依赖网络不好容易超时多试一次。我把这条路径写出来是因为排查逻辑很明确先是“工具挂没挂”再是“工具跑没跑”最后才是“数据有没有写”。很多人一上来直接检查数据文件很容易得出错误结论。5.2 不想让某一类内容被记住怎么办虽然记忆功能很香但不是所有东西都希望被长期记住。有些会话我可能只是临时问一个语法问题有些内容涉及不想入库的细节这时候最需要的是“手动控制开关”。我在实际使用中会给 Claude 明确的指令比如“这条对话不要写进记忆”“刚才说的那件事只是临时讨论别存”。它通常会通过 MCP 工具的调用逻辑跳过存储。你还可以在配置里调整开关把默认存储行为改成“只存我明确要求记的东西”。这相当于把记忆功能从自动挡改成手动挡。如果你想要更强的隔离可以按项目维度关闭记忆记录。每个项目单独配置是否启用 claude-mem这部分在 TUI 里也有入口。我的建议是刚开始接触时可以全开先用默认方式记录等跑了一周你大概就知道哪些内容经常产生无意义记忆再针对性调开关。5.3 数据备份、清理和迁移本地存储的优势是数据都在自己手里但副作用是没人替你保障数据安全。换电脑、重装系统、清理磁盘都可能把记忆库弄丢。我自己的做法是把~/.claude-mem目录纳入备份范围直接走 rsync 同步到另一台开发机。因为核心是 SQLite 文件拷贝的时候最好先关掉正在运行的 claude-mem防止数据库文件处于写入中间态。rsync -av ~/.claude-mem backup-host:/path/to/claude-mem-backup/如果只是日常清理不需要迁移整库可以在 TUI 里按项目删掉过期或没用的记忆片段。手动编辑 SQLite 数据库这种事我不是很建议做除非你清楚认识结构否则容易把索引搞坏。实在想清理就按项目维度整体删除重建不要试图逐行改 SQL。磁盘占用方面如果摘要频率设置很低数据增长速度会非常快。我跑了一个高强度项目之后检查目录发现文件数量远超我的预期有些是大量的会话信息和 code context。所以定期进去看一眼目录大小还是必要的。5.4 小团队/多机场景怎么共用记忆个人使用和团队使用完全是两种玩法。如果你在团队里几个人都维护同一个仓库每个人都用自己的 claude-mem 记忆库那项目约定就还是各记各的很容易出现“你记得这个规范但同事那边没记”的情况。小团队可以考虑共用一个记忆库。最简单的方式是把~/.claude-mem里的数据放在一个团队成员可访问的共享存储上或者同步到 Git 私有仓库。但这里有坑如果每个人的全局配置和个人画像也写进同一个库里会产生互相干扰。我建议共享层只放项目记忆把全局和个人画像留在本地。更稳妥的方案是把 claude-mem 的数据文件同步做成一个单独仓库每次修改后提交团队成员 pull 下来即可。这样至少项目层面的规范是全体可见的。敏感信息一定要排查配置里如果带有 token 之类的密钥不要同时入库宁可让每个人手动填环境变量。6. 最后分享几条我踩坑后总结的经验6.1 用 claude-mem 的“正确姿势”有几点是常规 README 里不会明说的但实际用下来特别影响体验。第一重要的事要主动说“请记住”。虽然 claude-mem 会自动做摘要但自动摘要抓到的不一定是你最在意的点。我在项目启动阶段会明确告诉 Claude“请记住这个项目用 pnpm测试走 vitest目录结构用 feature-based。”这样它下一步就把这些写成结构化记忆不带歧义。第二定期整理比永远堆积更重要。很多人的问题不是记不住而是记住的东西太多了导致召回来的记忆鱼龙混杂反而拖累输出质量。我会每隔一段时间去 TUI 里翻一下记忆列表把已经失效的、过时的规则删掉。比如项目从 pnpm 换成 npm 之后旧规则不删Claude 就会时不时犯神经。第三不要指望记忆层能替代 Prompt。记忆只是提词背景不是对话替身。遇到一个复杂问题该在会话里把需求讲清楚的还是要讲清楚。记忆能省的是“重复解释背景”的成本而不是“表达具体需求”的成本。6.2 它还能怎么扩展用顺了 claude-mem 之后我最大的感受是Claude Code 终于从“一个偶尔帮你写代码的终端”变成了“一个真正参与项目的协作者”。这个记忆层可以让 CI 场景也变得更有意思。比如你可以在项目初始化脚本里预置一些规则新接手的人一进项目Claude 就已经知道这个项目的约定不需要看半天文档。它还可以和其他 MCP 工具组合。比如一边用 claude-mem 记住项目决策一边通过文件系统 MCP 读取实际代码结构两边一配合Claude Code 的上下文完整性会高很多。我甚至考虑过给每个团队仓库维护一份“团队记忆”模板跟着新仓库自动生成这样团队协作的起点就不是一张白纸。还有一个小技巧是写一个包装脚本在每次启动 Claude Code 前把当前仓库的 claude-mem 状态打出来这样你自己也能快速扫一眼“现在这个项目记住了哪些规则”。很多时候你自己都已经忘了之前的约定看一眼反而能唤起记忆。最后我再特别提醒一个实操中容易被坑的细节如果更新了 claude-mem 的版本记得重新检查 MCP 配置是否还指向旧路径。有一次我升级完系统里的全局 Node 包发现 Claude Code 里挂的还是旧版本路径导致 session 摘要一直不触发。把所有工具版本、配置、数据路径都理顺这个记忆系统才能真正稳定地陪你跑完一个又一个项目。

claude-mem：为 Claude Code 搭建跨会话长期记忆的 MCP 方案

相关推荐

claude-mem：为Claude装上一个长期记忆，告别对话失忆

FreeCut特效与调色完整指南：50+个WebGPU特效与LUT调色一站式上手

奥维互动地图10.6.3.34516 卫星实景三维地图可看到你家屋顶

更多资讯

4800张真实废弃物图像分类：从数据清洗到迁移学习全流程实战

串口为何在IIoT中不可替代？从物理层到组网的实战经验解析

MNIST手写数字识别实战：PyTorch搭建CNN神经网络与训练避坑指南

飞腾D3000+银河麒麟：116英寸国产红外触控物资看板部署实战

JSP物资管理系统实战：架构、数据库与部署避坑指南

工业级电源路径主动防护设计：电子保险丝与MCU协同方案

今日更新

Agent Skills 完全指南：原理、写法、安装与实战避坑

Agent Skills 实战：从 Genkit 定义到 GKE 部署与排查

Agent Skills 实战：从设计到调试的完整指南

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

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

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

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

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