你有没有这种经历昨天用 Claude Code 修了个棘手的 Bug今天打开新会话它又像刚入职的实习生一样问你这个项目是干嘛的文件结构在哪我反正被这种AI 失忆折磨过不少次。每次新会话 Claude 都是一张白纸不记得你上回改了哪段逻辑、踩过什么坑、项目里有哪些约定。你要么反复把背景喂给它要么把长长的一段聊天记录贴进去——结果就是 token 哗哗地掉还经常撞上上下文上限。后来我翻到一个叫Claude-Mem的开源项目试了一阵子感觉正好戳中这个痛点。它不是那种让 AI 变得更聪明的玄学工具而是老老实实给 Claude Code 加了层跨会话记忆。下面把我了解到和用下来的情况用大白话给你捋一遍。一句话说清它是啥Claude-Mem 是个给Claude Code用的插件 [插件plugin可以理解为给编辑器装的一个小外挂装完就多了一些自动能力]。它会在你写代码的过程中自动把你用了哪些工具、看到了什么、改了什么记下来再用 AI 把这些信息压成摘要存好。等下次开新会话它再把跟当前任务相关的记忆挑出来悄悄塞回 Claude 的上下文里。打个比方它像是给 Claude 配了个不会离职的实习助理。你每次干活助理就在旁边记笔记隔天你再来助理把昨天的重点递给你你不用从头讲一遍。我实际用下来啥感觉装完重启 Claude Code 之后最明显的区别是新会话开头它会自动带一点上次相关的摘要进来。不是把整个历史糊上来而是几行相关的提示。你感觉它大概知道你在搞什么而不是完全空白。从社区反馈和一些测评看大家最买账的也是这点——“少说了好多废话”。当然它也不是魔法记忆准不准跟你项目本身的清晰度、你有没有用save_memory主动记关键约定也有关系。核心功能拆开看1. 自动记笔记靠钩子采集它在几个关键时间点自动跑脚本把发生的事情交给后台服务。这几个时间点叫生命周期钩子[钩子hook在某个动作发生时自动触发的一段脚本比如你每次用完工具它就自动跑一下把刚才发生的事记下来]SessionStart会话开始UserPromptSubmit你提交一条指令前后PostToolUse每次工具调用之后这是最主要的记录点Stop / SessionEnd会话停止或正常结束简单说你读写文件、跑命令、改代码它都在悄悄记。2. AI 帮你压缩摘要记下来的原始内容可能很长。Claude-Mem 会用 Claude 自己对观察内容做语义摘要和压缩[语义按意思而不是按字面]把一大段对话浓缩成几句人话既好存也好查。3. 存哪儿了SQLite 向量库SQLite[SQLite一个文件就能跑的轻量数据库不用装服务器]存结构化的会话、观察、摘要还能用全文检索做关键词搜索。Chroma[向量库把文字变成一串数字向量按意思相近来搜而不是只能按关键词精确匹配这种技术常叫 RAG]存嵌入向量做语义检索。两者结合就是混合搜索关键词 语义召回质量比单纯关键词高不少。4. 要用时再掏渐进式披露这是我觉得最聪明的一点。它不会一上来就把所有记忆全塞给 Claude而是分三层先返回轻量索引每条大概 50–100 个 token就相当于一个目录你确认要展开某几条再拉时间线上下文最后才按 ID 拉完整内容每条约 500–1000 token只在确定相关时才取全文整体上能把 token 消耗压到原来的大约十分之一。生命周期钩子SessionStart / PostToolUse / ...Worker 服务本地端口 37777SQLite结构化存储 全文检索Chroma 向量库语义检索混合搜索MCP 工具注入search → timeline → get_observationsClaude 上下文按需召回记忆配图说明Claude-Mem 的工作链路——钩子采集 → Worker 汇总 → 双库存储 → 按需注入。三层搜索怎么用给 Claude 用的搜索工具严格按先索引、后详情的流程走目的就是省 token# 1. 先搜索引返回紧凑列表 search(queryauthentication bug, typebugfix, limit10) # 2. 看时间线可选判断要不要展开 timeline(observation_id123) # 3. 只拉需要 ID 的全文 get_observations(ids[123, 456]) # 手动记一条关键约定供以后检索 save_memory(textAPI requires auth header X-API-Key, titleAPI Auth)注上面是 MCP 调用的逻辑示意不是可直接粘贴运行的命令真实调用由 Claude 在对话里自动完成你一般不用手写。除了这仨还有个save_memory可以主动记一条重要信息比如咱们项目的 API 必须带 X-API-Key以后用自然语言搜就能找到。怎么装在 Claude Code 里开个新会话执行# 添加插件市场源/plugin marketplaceaddthedotmack/claude-mem# 安装插件/plugininstallclaude-mem装完重启 Claude Code之后新会话就会自动带相关记忆了。如果你是在OpenClaw网关上用可以一键装curl-fsSLhttps://install.cmem.ai/openclaw.sh|bash安装器会顺手把依赖、插件配置、AI 提供商、Worker 都弄好还能选配 Telegram / Discord / Slack 的实时观察流。适合谁用人群为什么合适长期用 Claude Code 做项目的开发者少反复介绍项目AI 记得你改过啥、踩过啥坑团队 / 网关管理员在 OpenClaw 上统一给多用户、多会话提供记忆对 AI 记忆、RAG、上下文工程感兴趣的人钩子设计、混合检索、渐进式披露都值得学需要追溯AI 当时看到啥的团队每条观察带 ID可在 Web Viewer 里溯源几个典型场景多会话连续开发今天修 Bug、明天加功能AI 还认得之前的改动沉淀项目约定记数据库用 SQLite、表结构在 xxx换机器也不丢Bug 与变更追溯用自然语言搜认证相关的修复结合时间线看前后操作成本控制渐进式披露在记得住和不爆上下文之间找平衡和它比手动贴历史差在哪对比项Claude-Mem手动贴历史 / 规则文件跨会话记忆自动、按需注入每次手动粘贴Token 消耗渐进式披露约省 10 倍整段粘贴容易超限检索方式语义 关键词混合基本没有与 Claude Code 集成钩子 MCP 深度集成无隐私控制private标签排除敏感内容完全看你本地几个要注意的点隐私用private.../private包起来的内容不会存进去密钥、密码这类敏感信息记得裹上。配置设置文件在~/.claude-mem/settings.json可以调模型、端口、数据目录、日志级别、注入策略等。系统要求Node.js 18.0.0Claude Code 需支持插件的最新版Bun缺了会自动装、uv向量相关自动装、SQLite3一般系统自带。许可证项目用的是AGPL-3.0[AGPL-3.0一种开源协议要求你若修改它并对他人提供服务也得开源你的改动对商用偏严格]其中ragtime/目录单独用 PolyForm Noncommercial 1.0.0非商用。公司里用之前最好先让法务看一眼。小结Claude-Mem 解决的是个很实在的痛点让 Claude Code 别每次都失忆。它靠钩子自动记、AI 压缩存、混合检索查、渐进式披露省 token思路挺清楚文档和架构也公开方便二次开发。如果你也烦透了反复给 AI 讲项目背景可以装来试试。装完记得重启然后开个新会话感受下——它大概记得你的那种体验还挺上头的。项目地址https://github.com/thedotmack/claude-mem官方文档https://docs.claude-mem.ai