
claude-mem 是给 Claude Code 等 AI 编程助手加跨会话持久记忆的开源插件:它自动捕获每个会话里的工具调用与观察,用 AI 压缩成语义摘要存下来,下次开新会话时把相关的上下文自动注回去——上个会话里定下的方案、踩过的坑、修过的 Bug,不用再复述一遍。项目在 GitHub 上已有 11 万多颗星,Apache-2.0 协议开源,今天冲上了 GitHub Trending 日榜第 1 名。
它解决什么问题
AI 编程助手最大的痛点之一是“健忘”:会话一关,上下文就丢了,第二天接着干同一个项目,得先花一轮对话把背景重新讲清楚。claude-mem 把这个过程自动化了——装好重启 Claude Code 之后就自动生效,不用每次手动写记忆文件,也不用在提示词里反复交代。
怎么工作
按 README 的说法,核心是四件套:
- 生命周期钩子:在会话开始、工具调用前后、会话结束等节点自动捕获观察;
- AI 压缩:把捕获到的内容压缩成带主题的语义摘要,而不是原样堆文本;
- 本地存储:摘要存在本地 SQLite,配合 Chroma 向量库做混合检索(语义 + 关键词);
- 自动注入:新会话开始时,把与当前任务相关的记忆自动注回上下文。
配套的 MCP 搜索工具按三层递进:先用 search 查索引(每条结果约 50–100 token),再用 timeline 看某条记录前后的时间线,最后只对筛出来的 ID 用 get_observations 取全文。官方称这套“先筛后取”的做法能省约 10 倍 token——这是项目方的说法,实际省多少取决于你的使用方式。
隐私方面,记忆内容可以用 <private> 标签排除,不进存储;截图默认不保存(可选开启);还有一个可选的 TeamBrain 团队共享空间,各人自己决定分享什么。
怎么装
一行命令:
npx claude-mem install
也可以在 Claude Code 里用插件市场安装:/plugin marketplace add thedotmack/claude-mem,再 /plugin install claude-mem,重启 Claude Code 即可。系统要求 Node.js 20 以上,Bun 会在安装时自动装上。除了 Claude Code,还支持 OpenClaw、Codex、Gemini、Copilot、OpenCode、Grok Bot、T3 Code 等——不同工具的安装命令见 README,各有一行对应的 --ide 参数。
安装前要说清楚的一点
默认安装流程装完会请你在浏览器里用邮箱登录(magic link,不用绑卡),开通 CMEM Pro 云端记忆的 30 天免费试用;试用结束后自动回落到你的 Anthropic 套餐。想完全跳过登录也可以:安装时传一个明确的 --provider 参数,或者设置 CLAUDE_MEM_ONLINE_OPTIN=false,安装程序就不会要求任何账号操作。所以它不是“全程免费本地运行”——默认走云端试用,纯本地方案需要主动选。
同样是给 Claude Code 提效,之前介绍过的微软 × 伯克利的 TokenEconomizer 插件是从“少花 token”的角度省成本,claude-mem 则是从“少重复交代”的角度省时间,两件事可以一起用;想把 Claude Code 当工作室使,还可以看看49 个 Agent + 74 个 Skill 的 Claude Code Game Studios。
项目地址:github.com/thedotmack/claude-mem,Apache-2.0 协议,2025 年 8 月创建,当前版本 15.8.3,截至 2026 年 11 月 2 日已有 110,005 颗星、9,602 个 fork。
转自 GitHub 作者 thedotmack 的项目《claude-mem》,原文链接:https://github.com/thedotmack/claude-mem











暂无评论内容