Claude-Mem

大型语言模型（LLM）本质上是“无状态”的：每次对话结束后，上下文即被丢弃。这在开发或研究场景中尤为不便——你可能刚教会 Claude 理解项目结构，下一回合它就“失忆”了。

Claude-Mem 是一个专为 Claude Code 设计的插件系统，通过自动捕获、摘要和存储会话中的关键信息，实现跨会话的上下文延续。它不依赖云端服务，所有数据本地存储，兼顾效率与隐私。

核心能力

• 持久记忆：会话结束后，关键上下文被压缩保存，新会话自动注入；
• 语义搜索：通过 mem-search 技能，用自然语言查询历史内容（无需记忆具体路径或文件名）；
• 本地可视化：内置网页查看器（http://localhost:37777），实时浏览所有观察记录与摘要；
• 隐私控制：用 <private> 标签标记敏感内容，系统将自动排除其存储；
• 细粒度配置：支持 11 项设置，控制记忆注入范围、数量、时间窗口等；
• 自动运行：安装后无需手动操作，系统在后台自动处理记忆生命周期。

工作原理

Claude-Mem 通过 5 个生命周期钩子监听 Claude Code 的运行流程：

1. SessionStart：从最近 10 个会话中提取摘要，注入当前上下文；
2. UserPromptSubmit：保存用户输入；
3. PostToolUse：捕获工具调用产生的“观察记录”（如文件读写、命令执行结果）；
4. SessionEnd：调用 Claude Agent SDK 生成本次会话的语义摘要；
5. Stop：清理资源，准备下一次启动。

所有数据（会话、观察、摘要）存储于本地 SQLite 数据库，并启用 FTS5 全文搜索，确保查询高效。

架构组件

快速安装

确保已安装：

• Node.js ≥ 18
• 最新支持插件的 Claude Code
• Bun（如未安装，插件会自动处理）

在 Claude Code 终端执行：

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

重启 Claude Code，记忆功能即生效。

版本演进亮点

• v7.1.0：全面迁移到 Bun，替换 PM2 与 better-sqlite3，提升性能与跨平台兼容性；
• v7.0.0：新增 11 项上下文配置 + 双标签隐私系统（<private>）；
• v5.5.0：mem-search 技能达到 100% 有效召回率；
• v5.1.0：上线本地网页查看器，实现记忆可视化。

适用场景

• 长期项目开发：让 Claude 记住代码库结构、约定、历史决策；
• 研究复现：自动保存实验步骤与结果，便于后续追问；
• 知识管理：将 Claude 变成个人项目知识库，支持自然语言检索；
• 减少 token 消耗：避免重复解释背景，提升交互效率。

隐私与安全

• 所有数据仅存储于本地（~/.claude-mem/ 目录）；
• 不上传、不联网、不收集任何信息；
• 敏感内容可通过 <private> 标签主动排除；
• 数据库文件可随时删除或备份，完全由用户掌控。