大家好，我是何三，独立开发者
5.5 万 Star。225 个 Release。文档翻译支持 35 种语言。被 TrendShift 收收录。
就一个给 Claude Code 加"跨会话记忆"的插件。
我一开始看到这数据还以为是统计错了，点进去一看，好家伙，v12.1.0，一个人迭代了 225 个版本。这在开源圈里属于什么水平呢？Vue 3 从发布到现在也就 40 多个 minor release。这位老哥平均两天一个版本，手速令人发指。
用完就忘，AI 编程助手的通病
用过 Claude Code 的应该都有这个体会。
你花了一下午跟它重构认证模块，JWT 换 session，中间改了十几个文件，踩了一堆坑，磨合得刚刚好。关掉终端。第二天重新开一个会话。
它问：你需要什么帮助？
你：……你是不是失忆了。
就像你跟一个同事聊了一整天项目细节，第二天他坐到你旁边问："哥们你谁啊？"这种感觉，经历过的都懂。
Claude 官方一直没给内置的持久化方案。社区里有人等不及了，自己搞了一个。
claude-mem 是怎么干的
原理其实不难理解。但有些细节确实挺巧妙的。
claude-mem 在 Claude Code 的生命周期里挂了 5 个 Hook：
- SessionStart — 会话开始，从数据库捞相关记忆注入上下文
- UserPromptSubmit — 你每次提问，看有没有历史相关的记录
- PostToolUse — Claude 每次用完工具（读文件、改代码、跑命令），顺手记下来
- Stop — 会话暂停，压缩当前上下文
- SessionEnd — 会话结束，生成语义摘要存进数据库
大白话就是：它在 Claude 干活的每个关键节点都蹲着，一边看一边记。
不是傻存啊。它用的是 Claude 自己的 Agent SDK 做语义压缩，把原始上下文压成精炼摘要。底层 SQLite 存结构化数据，Chroma 做向量检索。搜的时候关键词匹配和向量相似度一起上，混合检索。
说实话这个技术栈选得挺"懒"的（褒义）。SQLite 不用装服务，Chroma 本地跑就行，整个依赖链干净得不像话。
不像有些开源项目，装个依赖要配数据库、装 Docker、搞环境变量，一套下来半小时没了。
还提供了一个 Web 查看器（localhost:37777），实时看 Claude 在记什么。觉得哪条涉及隐私了，用 <private> 标签一包，自动跳过。这点安全意识得给个好评。
装起来试试
官方说一行命令：
npx claude-mem install
但我实际装的时候碰了个小坑——Windows 环境下 npm 没加到 PATH 里，直接报错"The term 'npm' is not recognized"。这个跟 claude-mem 没关系，纯粹是我 Node.js 装的时候没勾那个选项。
重新装完 Node，再跑一遍，就通了。
它会自动检测你缺不缺 Bun 和 uv（Python 包管理器），缺什么帮你补。这个细节挺贴心的，省得你自己去排查依赖问题。
装完重启 Claude Code，看到这行提示就说明成功了：
🧠 claude-mem: Injected 23 memories from 5 previous sessions
然后你直接问："上次我们是怎么处理认证模块的？"
Claude 会自动从历史记忆里搜索，把具体的 observation ID 和内容展示出来。带引用的，不是瞎编。这种感觉怎么说呢——
就跟终于换了个会记事的同事。之前那个每天上班第一件事就是问"我们昨天干嘛来着"的，可以请走了。
几个值得一提的点
渐进式披露（Progressive Disclosure）
不是一股脑把所有记忆塞给 Claude，而是分层的。先给一个精简索引，大概 50-100 tokens 一条，你看哪条有用再拉详情，500-1000 tokens 一条。官方说能省大概 10 倍 Token。
这种"先看目录再翻页"的思路其实很朴素，但放在 AI 上下文管理这个场景里效果特别明显。毕竟 Claude 的上下文窗口是按 token 收费的（或者说有限的），能省则省。
不止 Claude Code
虽然叫 claude-mem，但也支持 Gemini CLI 了：
npx claude-mem install --ide gemini-cli
甚至能部署到 OpenClaw 网关 上，给整个团队共享记忆。团队协作场景下这个挺实用的。
版本迭代速度
这个我得单独说一句。225 个 Release，现在 v12.1.0。一个人维护。我翻了翻 CHANGELOG，每次更新 changelog 写得也很认真，不是那种"bug fixes and improvements"一笔带过的敷衍。
能这样持续迭代的个人开源项目，作者大概率是个狠人。（我刚去看了下作者 Alex Newman 的 GitHub，确实 prolific。）
同类工具
如果你对 AI 编程助手的记忆增强这块感兴趣，这几个也可以看看：
- mem0（github.com/mem0ai/mem0）— 通用的 AI 记忆层，不限于某个编程助手，适合需要给自定义 AI Agent 加记忆的场景。不过它更偏通用方案，没有 claude-mem 这样深度集成 Claude Code 的 Hook
- Cursor 的 @codebase — Cursor 内置的代码库索引功能，但它是基于文件内容检索的，跟 claude-mem 的"会话历史语义记忆"不是一回事
如果你对 AI 编程工具这块感兴趣，我此前还整理过几篇 Claude Code 相关的深度文章，关注后回复「工具」获取。
claude-mem 解决的问题很聚焦：让 AI 编程助手从"金鱼记忆"变成"项目老兵"。装完不用管，Claude 自动就有了上下文延续性。如果你是 Claude Code 重度用户，这东西基本必装。
项目地址：https://github.com/thedotmack/claude-mem
本文使用 MGO 编辑并发布
关注"何三笔记"，回复"mgo" 免费下载使用
