让 Claude Code 彻底告别"失忆"——每次新建会话，之前做过的所有决策、修过的 Bug、写过的功能，全都自动注入上下文，AI 永远记得你项目的来龙去脉。

什么是 Claude-Mem？

用过 Claude Code 的开发者都有这个痛点：昨天和 AI 讨论了半天的架构决策、Debug 思路，今天新建会话什么都没了，又要重新解释一遍项目背景。这种"失忆症"严重影响效率。

Claude-Mem 就是专门解决这个问题的 Claude Code 插件。它通过 Hook 机制无感地监听每次工具调用，用 AI 把原始数据压缩成结构化的"记忆"，存入本地双数据库，下次会话启动时自动注入相关历史上下文。

核心效果：跨会话记忆永久保留，Token 消耗减少 94%，一行代码不用改，装完即生效！

目前 GitHub 已有 66,472 Stars，5,637 Forks，是近期 AI 工具生态中最火的开源项目之一。

✨ 核心功能一览

完整工作流程

整个过程完全自动化，不需要开发者做任何额外操作：

1. 1. 会话开始：SessionStart Hook 触发，检索历史相关上下文，自动注入当前会话
2. 2. 工具调用中：PostToolUse Hook 捕获每次文件读写、Shell 命令的执行结果
3. 3. AI 智能压缩：Claude Agent SDK 将原始数据压缩为结构化观察（压缩比高达 100:1）
4. 4. 双库持久化：SQLite（全文搜索）+ ChromaDB（向量语义搜索）双引擎存储
5. 5. 下次自动注入：新会话自动加载相关记忆，Token 消耗减少 94%

️ 快速上手：2分钟装完即用

方式一：插件市场安装（推荐）

# 在 Claude Code 中执行
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
# 重启 Claude Code 后自动生效

方式二：源码安装

git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem
npm install && npm run build
npm run worker:start

关键配置（~/.claude-mem/settings.json）

{
  "provider": "claude",
  "model": "claude-sonnet-4-5-20250929",
  "workerPort": 37777,
  "dataDir": "~/.claude-mem",
  "contextObservations": 10
}

注意：数据完全存储在本地 ~/.claude-mem/ 目录，Worker 只监听 127.0.0.1，不会上传任何数据到云端！

三大使用场景

场景一：长期项目开发记忆

痛点：项目开发了 3 个月，Claude Code 对之前的架构决策、踩过的坑一无所知。

# 有了 Claude-Mem，你可以直接问：
"我们上次解决 API 认证并发问题是怎么处理的？"
"之前给 users 表加索引是在哪个会话做的？"
"我们选择用 Redis 做缓存的原因是什么？"

# Claude 会自动从记忆库中检索并回答

功能说明：所有决策历史、Bug 修复记录、架构讨论都被压缩保存。语义搜索能理解"认证问题"和"Token过期"是同一个上下文。

适用场景：长期维护的项目、多人协作的代码库、需要记录技术债的团队。

场景二：Endless Mode 超长会话

痛点：Claude Code 在约 50 次工具调用后触及上下文窗口限制，被迫开新会话。

普通模式：工具调用 50 次后 → 上下文爆炸 → 强制新建会话 → 失去上下文
Endless Mode：工作记忆 ↔ 归档记忆自动切换 → Token O(N²) → O(N) → 无限会话

Endless Mode 可以将有效工具调用次数提升约 20 倍，超大型重构任务一次搞定！

（注：Endless Mode 目前为 Beta 版，每次工具调用增加约 60-90 秒延迟）

场景三：隐私敏感项目

# 有 API 密钥等敏感信息时，用  标签保护：

数据库密码：DB_PASS=xxx
API Key：sk-xxx
这些不会被记录到记忆库

功能说明：被 包裹的内容会在 Hook 层直接过滤，不进入任何存储系统。Worker 只监听 127.0.0.1，数据 100% 本地。

适用场景：金融、医疗等隐私敏感行业，处理客户数据的开发者。

与同类工具对比

对比传统方案：

• • CLAUDE.md：手动维护，只能记录静态知识，无法自动跟踪工作过程
• • Mem0：云端存储，数据离开本地，有隐私风险
• • Claude-Mem：全自动、本地化、AI 压缩，三者兼顾

Web 可视化管理界面

安装后访问 http://localhost:37777，可以：

• • 实时查看当前会话的记忆捕获流
• • 浏览历史会话列表和 AI 生成的摘要
• • 按关键词或语义搜索记忆库
• • 调节上下文注入参数（1-200条观察）
• • 在 Stable/Beta 版本间切换
• • 过滤特定类型的记忆（决策/Bug修复/功能实现）

开源协议与费用

开源协议： AGPL-3.0（个人使用完全免费）

唯一成本：AI 压缩时调用 LLM API（Claude/Gemini/OpenRouter 均支持），每次会话消耗 Token 极少（已高度优化）。

相比 Rewind AI（每月 $25）和其他商业记忆工具，Claude-Mem 完全免费 + 完全本地化！

总结

Claude-Mem 解决了 AI 编程助手最核心的痛点之一——跨会话失忆。66K Stars 的热度证明了开发者对这个问题的强烈需求。如果你每天用 Claude Code 开发，这是一个装了必用、用了必爱的神级插件。

推荐指数： ⭐⭐⭐⭐⭐（满分5星）

适合人群： 重度 Claude Code 用户、长期项目维护者、对 AI 辅助编程效率有要求的开发者

GitHub 仓库： thedotmack/claude-mem

官网文档： docs.claude-mem.ai

数据截至 2026年4月24日，最新信息请以官方仓库为准。