claude-mem
Claude Code 的记忆插件:自动捕获编码操作并注入历史上下文,让 AI 永不遗忘项目信息
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
Claude Code 的记忆插件:自动捕获编码操作并注入历史上下文,让 AI 永不遗忘项目信息
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。

Claude-Mem 是 GitHub 近 8 万星的现象级 AI 编码助手插件,它解决了一个让无数开发者头疼的痛点:每次打开 Claude Code,AI 对项目的理解归零,一切都要从头解释。
核心工作原理:Claude-Mem 通过 5 个生命周期钩子(SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd)自动捕获每一次编码操作——你改了什么文件、跑了什么命令、修了什么 bug——然后借助 Claude Agent SDK 生成语义摘要,将这些信息存入本地 SQLite 数据库,同时构建 Chroma 向量索引。下次开新会话时,Claude Code 会自动注入与你当前任务最相关的历史记忆,无需任何手动操作。
类比一下:它就像给 Claude Code 装了一个「永不遗忘的工作笔记本」——Claude 每次工作时自动记录重点,下次翻开笔记本就能无缝衔接。
三大技术亮点:
① 渐进式上下文注入:Claude-Mem 不会一次性塞入所有历史记录,而是按需分层检索,每次注入只消耗 ~50-100 tokens,节省约 90% 的上下文 token消耗。
② MCP 搜索工具链:提供 search(快速索引)、timeline(时间线上下文)、get_observations(按ID批量拉取详情)三件套,Claude 可自主查询记忆。
③ 多 IDE 全覆盖:不仅支持 Claude Code,还支持 Cursor、Windsurf、OpenCode 和 Gemini CLI,一个记忆库打通所有主流 AI 编码工具。
上手门槛极低:一条命令 npx claude-mem install 完成安装,自动检测依赖(Bun、uv、better-sqlite3),首次启动约 30 秒初始化,之后完全静默运行。Web 查看器在 http://localhost:37777 提供实时内存流界面,支持按项目/类型/日期过滤。
企业级部署:docker-compose.yml 提供了完整的服务器端部署方案(Postgres + Valkey + Bun),支持 BullMQ 队列水平扩展生成任务,适合团队共享记忆库。
局限与争议:记忆压缩依赖 AI 生成摘要,需要消耗额外的 Claude API token;隐私敏感内容需手动加 <private> 标签排除,自动化程度有上限;另有第三方 Solana 代币 $CMEM 与项目同名(由社区发起,作者已认可),可能造成品牌混淆。
增长曲线:从 2024 年中发布到 2025 年中突破 4.6 万星,增长速度反映了 AI 编码工具从「新鲜感」进入「工程化」阶段——开发者开始关注长期项目维护、上下文管理和知识积累。这代表了一个趋势:AI 辅助开发正在从单次会话效率工具,向可持续的长期工程伙伴演进。
图1:Claude-Mem 在 Trendshift 上的趋势标签
技术规格一览: