claude-mem 是一个为 AI 编程智能体打造的持久化记忆压缩系统。它自动捕获 Agent 会话中的全部操作,借助 AI 智能压缩提炼,并在未来会话中注入相关上下文,让 Claude Code、Codex、Gemini 等多个编程助手真正拥有跨会话的长期记忆。
适用人群:1. 重度使用 Claude Code、Codex、Gemini CLI 等 AI 编程工具的日常开发者;2. 需要为 Agent 应用构建长期记忆能力的 AI 应用工程师;3. 关注 RAG、向量检索与记忆系统架构的技术研究者。
适用场景:1. 跨会话连续开发:新会话自动恢复此前的调试上下文与项目决策,免去反复粘贴背景信息;2. 长周期项目维护:沉淀代码演进历史与踩坑经验,形成可语义检索的项目知识库;3. 多工具协同:在 Claude Code、Codex、Gemini、Copilot 等不同 Agent 之间复用同一套记忆体系。
推荐理由:近10万Star的口碑印证其价值。它直击AI编程助手每次对话都失忆的核心痛点,插件化安装开箱即用,本地化存储保障隐私,一套记忆可跨多工具复用,是提升AI编程效率的必备增强。
项目定位与背景
当前 AI 编程助手普遍面临金鱼记忆困境:每次新会话启动时,Agent 对项目历史一无所知,开发者不得不反复交代背景。claude-mem 正是为解决这一痛点而生——它是一个为 Claude Code 等编程智能体打造的持久化上下文记忆系统,通过捕获、压缩、注入三步闭环,让 Agent 拥有跨会话的长期记忆。项目采用 TypeScript 编写,基于 Apache 2.0 协议开源,目前 Star 数已逼近 10 万,获得 Vercel OSS 计划、Greptile、SerpApi 等赞助支持,README 提供包括中文在内的二十多种语言版本,社区活跃度极高。
核心功能与技术架构
claude-mem 的工作流程分为三个环节:首先完整记录 Agent 会话中的一切操作,包括代码修改、命令执行与决策过程;其次利用 AI 对原始记录进行智能压缩,提炼出高价值的结构化记忆,避免上下文无限膨胀;最后在开启新会话时,通过语义检索将相关记忆自动注入提示词。技术栈上,项目结合 SQLite 作为本地存储,借助 ChromaDB 提供向量嵌入与语义检索能力,并基于 Claude Agent SDK 与 Skills 机制实现深度集成,整体方案在本地运行,数据不出本机。
创新点与亮点
最大亮点是压缩式记忆设计:不同于简单堆砌历史日志的做法,claude-mem 先用 AI 压缩提炼再存储,兼顾记忆容量与 token 成本。其次是广泛的兼容性,除 Claude Code 外还支持 Codex、Gemini、Copilot、OpenCode 等主流 Agent 工具,一套记忆体系可跨工具复用。此外,它以 Claude Code 插件形式安装,开箱即用,几乎零学习成本,版本迭代频繁,工程成熟度较高。
与同类项目对比
从主题标签看,该项目常与 Mem0、OpenMemory、Supermemory 等记忆方案被一同讨论。相比通用型记忆框架,claude-mem 更聚焦编程场景,与 Claude Code 生态集成更紧密;相比 mem0 等需要自行接入 API 的方案,它以插件形态提供更完整的开箱体验。需要指出的是,它对 Claude 生态依赖较深,非 Claude Code 用户的部分体验可能打折扣,且长期记忆的压缩质量依赖模型能力,存在一定的 token 消耗成本。
上手指南或快速开始
上手门槛很低:确保 Node.js 版本不低于 20,在 Claude Code 中以插件方式安装 claude-mem 即可。安装后无需复杂配置,Agent 会话会被自动记录与压缩,下次会话启动时相关上下文自动注入。建议初次使用时先观察几天的记忆注入效果,再按需调整压缩粒度与检索范围。
总结与展望
claude-mem 精准切中了 AI 编程工作流中最真实的痛点,以扎实的工程实现赢得了近 10 万 Star 的口碑。随着 Agent 工具的普及,持久化记忆或将成为标配能力,而 claude-mem 已站在这一赛道的领先位置。若你每天都在与 Claude Code 打交道,它值得一试。
项目信息
| 项目名称 | thedotmack/claude-mem |
| 编程语言 | TypeScript |
| Star 数 | 94966 |
| Fork 数 | 8403 |
| 主题标签 | ai, ai-agents, ai-memory, anthropic, artificial-intelligence, chromadb, claude, claude-agent-sdk, claude-agents, claude-code, claude-code-plugin, claude-skills, embeddings, long-term-memory, mem0, memory-engine, openmemory, rag, sqlite, supermemory |