Claude-Mem

Claude-Mem官网

Claude-Mem 是开发者 Alex Newman 开源的一款 Claude Code 记忆插件，项目托管在 GitHub，https://github.com/thedotmack/claude-mem 是其官方代码仓库。它要解决的问题非常具体：AI 编程助手每次新开会话都会“失忆”，昨天的调试结论、上周的架构决策都得重新交代一遍。插件通过生命周期钩子自动记录会话中的工具调用与关键决策，压缩为结构化观察记录存入本地数据库，下次会话开始时自动注入相关历史，让助手具备跨会话的连续记忆。

主要功能

• 自动上下文捕获：通过会话开始、工具调用后、会话结束等多个生命周期钩子全程记录，无需手动触发保存。
• 智能压缩存储：借助 Claude Agent SDK 把原始工具输出压缩为约 500 token 的结构化观察记录，包含类型、标题、要点与概念标签等字段。
• 混合检索：本地 SQLite 全文搜索叠加向量数据库语义搜索，支持全文、概念标签、文件引用、类型过滤等多种查询方式。
• 三层渐进召回：从轻量索引到时间线上下文再到完整记录逐级加载，把上下文占用和 token 开销控制在很低水平。
• Web 管理界面：内置本地 HTTP 服务，在浏览器中即可实时查看与管理记忆流。
• 隐私与本地化：数据默认保存在本机，敏感内容用 private 标签排除，嵌入向量计算也全部在本地完成，不调用外部接口。

如何使用Claude-Mem

安装入口在 Claude Code 内置的插件市场：先执行添加插件市场的命令，再执行安装插件的命令，然后重启 Claude Code 让钩子配置生效。注意不要用 npm 全局安装的方式，那条路径只会装 SDK 库而不会注册生命周期钩子，功能等于没有安装。

环境要求 Node.js 18 以上，其余依赖会在首次运行时自动检测并补齐。验证安装有三个办法：请求本地健康检查接口、查看钩子配置文件中是否出现对应条目，或直接在浏览器打开本地管理端口查看 Web 界面。

从第一次会话开始积累观察记录，第二次会话起历史上下文就会自动注入。想搭配其他技能项目使用，可以看看同为开源项目的DeepSkill；经常需要切换 Claude 供应商配置的话，CC Switch是常用搭档；专注前端界面的开发者还可以结合UI/UX Pro Max这类技能包提升产出质量。

使用场景

• 跨会话接力开发：前一天没修完的问题，今天新开会话直接继续，不用重新铺垫背景。
• 超大规模重构：借助实验性的无限会话模式，推进涉及数百个文件的重构而不受上下文窗口限制。
• 多代码库并行：在多个项目间切换时各自维持记忆空间，避免信息串扰。
• 调试经验沉淀：把每次排障过程变成可检索的知识库，遇到同类问题直接召回当时的解决方案。
• 团队知识同步：通过多机器同步或共享 CLAUDE.md，帮助新成员快速继承项目的历史决策。

常见问题

Claude-Mem 收费吗？

项目完全免费开源，数据存储与向量计算都在本地完成，不依赖任何付费的云端 API 服务。

我的数据存在哪里？

默认保存在用户目录下的本地数据库文件中，嵌入向量也在本机生成；不希望被记录的内容用 private 标签包裹即可排除在存储之外。

支持哪些工具和系统？

主要面向 Claude Code，同时兼容 Gemini CLI、Cursor、Windsurf 等工具，覆盖 Linux、macOS 与 Windows 三大平台。

官网网址：

Claude-Mem官网：https://github.com/thedotmack/claude-mem

OpenI AI时代点评

把“记忆”做成基础设施而非功能，是 Claude-Mem 最有意思的地方：钩子自动捕获、压缩入库、三层按需召回的设计把 token 开销压得很低，本地存储则让隐私顾虑小了很多，对每天与 Claude Code 深度协作、项目周期长的开发者来说几乎是刚需级插件。需要提醒的是，它仍是社区开源项目，版本迭代快，遇到问题要习惯翻 issue 和更新日志；实验性的无限会话模式也别直接用于关键生产流程，重要重构前做好备份更稳妥。