夜雨聆风学习资料网

ARTICLE · 1137851

Claude-Mem:让 AI 编程助手记住上次为什么这样改

Claude-Mem:让 AI 编程助手记住上次为什么这样改

今天给大家推荐的项目是 Claude-Mem。它为 AI 编程助手保存跨会话的项目记忆:自动记录工具操作,整理关键发现,下次开工时再把相关背景交还给助手。你不用每次重新解释“这个模块为什么不能动”。它适合经常让 AI 协助维护同一个项目的人,而不是普通聊天记录备份工具。

❝

项目名称:Claude-Mem主要语言:TypeScript、JavaScriptStars:97.5kForks:8.6k项目链接:https://github.com/thedotmack/claude-mem

Claude-Mem 官方标志

Claude-Mem 的官方标志

下次打开项目,还得从头交代吗

你让 AI 修过一个结算问题,讨论过重试次数、异常处理和测试边界。隔几天开新会话,它不记得当时的取舍,你只好翻旧对话,把关键决定再说一遍。直接塞入整段聊天记录也不理想:篇幅太长,真正有用的信息反而难找。

Claude-Mem 的做法是保留“做了什么、为什么做”,而非每次重放全部对话。它从支持的编程助手会话中捕获操作,整理成可检索的观察记录与总结。下次进入项目,你可以接着做,而不是先补课。

把工作过程变成可查的项目记忆

  • 自动记录并压缩。以 Claude Code 为例,插件通过会话与工具使用的生命周期钩子捕获提示和操作,由后台服务提炼决策、修复和发现。比手工写交接文档省事;适合持续迭代、经常中断的项目。它不是逐字复刻聊天,重要细节仍应回看原始记录。
  • 先搜线索,再读细节。你可以询问“上次为什么保留 SQLite”,先看到简短索引,再按需展开时间线和具体观察。与整份历史一次性塞给模型相比,这种分层检索更容易聚焦,也避免无关内容占满上下文;节省多少取决于实际任务。
  • 看得见、查得到。本地 Web 查看器以时间流展示记忆,检索结果可关联观察编号。你可以核对 AI 回忆依据,而非把一段“我记得”直接当成事实。适合复盘一次修改的来龙去脉。
  • 存储与同步可分开选。开源引擎把记录保存在本机 SQLite;如果需要跨设备同步,可另行选择 CMEM Pro。与默认把所有记忆放在云端的方案不同,你可以先只用本地版。注意:AI 整理阶段若选择外部模型,相关内容仍可能发送给对应服务,并非“本地存储”等于全程离线。
Claude-Mem 官方演示中的记忆查看器

怎么开始使用

  1. 准备 Node.js 20 及以上版本,以及 Claude Code 等官方支持的编程助手。Bun 和用于可选向量检索的 uv,安装器可在缺失时处理。
  2. 按官方快速入门运行 npx claude-mem install;也可在 Claude Code 中用官方插件市场命令安装。重启助手后开始新会话。
  3. 按安装提示选择记忆处理服务;若不想登录托管服务,可以显式指定 --provider,再确认对应服务的配置。工作一段时间后,在新会话中检索旧决策,并在本地查看器核对来源。

别把 npm install -g claude-mem 当成同一种安装方式:官方 README 明确说它只装 SDK,不会注册插件钩子或启动后台服务。

技术是怎样串起来的

交互层是助手插件和 React 编写的本地查看器;核心层是 TypeScript 的钩子、Bun 管理的 Express 后台服务,以及负责整理观察内容的 AI SDK 或你选择的模型服务。钩子把操作写入 SQLite,后台再生成摘要;检索时利用 FTS5(SQLite 的全文搜索),可选接入 Chroma 做语义检索。MCP(让助手调用外部工具的协议)或检索技能把结果带回对话。

这套组合的好处是:记忆落在本机,查找与展示分层进行;代价是需要常驻后台服务、模型处理与一定的安装配置。<private> 标签和自动脱敏可减少敏感内容进入记录的机会,但你仍应检查工作区和所选模型服务的隐私设置。官网也明确区分:连接某个客户端用于“读取记忆”,不代表该客户端的对话会自动被采集。

值得谁试

如果你长期维护同一个代码库,常让 AI 接手旧问题,Claude-Mem 值得先在非敏感项目试用。它最有用的不是让助手“记住一切”,而是让你能找到一次决定的上下文。若只偶尔写几个脚本,额外的后台服务可能并不划算。项目地址:https://github.com/thedotmack/claude-mem

资料来源

  • GitHub Trending(Daily):https://github.com/trending
  • 项目仓库与 README:https://github.com/thedotmack/claude-mem
  • Releases:https://github.com/thedotmack/claude-mem/releases
  • 官方文档:https://docs.claude-mem.ai/introduction
  • 架构文档:https://docs.claude-mem.ai/architecture/overview
  • 项目官网:https://claude-mem.ai

相关学习资料