AI智能体
更新于2026年07月14日
Claude-Mem：Claude Code 智能记忆插件
Claude-Mem 是由开发者 Alex Newman 打造的一款开源智能记忆插件，专为 Claude Code 设计。它通过五个生命周期钩子自动捕获会话中的工具调用、代码决策与调试过程，并利用 Claude Agent SDK 将原始输出压缩为结构化观察记录，存储在本地数据库中。当开启新会话时，插件会自动注入相关历史上下文，使 Claude 能够记住之前的项目背景、架构决策和 Bug 修复过程，无需用户反复说明。此外，它还支持 Web 可视化界面、隐私标签、多语言模式，并兼容 Gemini CLI 和 OpenClaw 网关。
核心功能与技术架构
- 自动上下文捕获：基于 SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd 五个生命周期钩子，在每次工具调用后自动记录会话全程，无需手动触发保存。
- AI 智能压缩：利用 Claude Agent SDK 将原始工具输出压缩为包含 type、title、facts、narrative、concepts 字段的结构化观察记录，单条约 500 令牌，极大节省上下文空间。
- 混合搜索与存储：采用本地 SQLite 数据库（FTS5 全文搜索）与 Chroma 向量数据库（语义搜索）混合存储方案，默认路径为 ~/.claude-mem/claude-mem.db。支持 10 种搜索端点，包括全文、概念标签、文件引用、类型过滤等。
- 三层渐进检索：Layer 1 search 返回 50-100 令牌索引；Layer 2 timeline 提供 100-200 令牌时间线上下文；Layer 3 get_observations 按需获取 500-1000 令牌的完整记录。该架构将信号率从 6% 提升至 80% 以上，避免一次性加载低效数据。
- 本地嵌入模型：采用 all-MiniLM-L6-v2 via ONNX 运行，所有向量计算均在本地完成，无需调用外部 Embedding API。
- Web 可视化界面：内置 HTTP API 服务（默认端口 37777），通过浏览器访问 http://localhost:37777 即可查看实时记忆流与管理界面。
- Endless Mode（实验性）：突破 Claude Code 约 50 次工具调用后上下文超限的限制，通过实时转录转换实现理论上无限长的会话，实测可完成 600+ 文件的完整重构。
- 自动 CLAUDE.md 生成：在项目文件夹中自动生成并更新包含活动时间线的 CLAUDE.md 文件，同时保留手动编写的内容。
- 隐私控制：数据默认本地保存，使用 <private> 标签即可将敏感内容排除在存储之外。
- 多语言与模式系统：支持 28 种语言，提供 Code、Email Investigation、Chill 等工作流模式切换。
安装与使用指南
- 安装插件：必须在 Claude Code 内通过插件市场安装，依次执行 /plugin marketplace add thedotmack/claude-mem 和 /plugin install claude-mem。严禁使用 npm install -g claude-mem，该命令仅安装 SDK 库，不会注册生命周期钩子，会导致功能完全失效。
- 系统要求：Node.js 18+ 为硬性要求；Bun、uv、SQLite 等依赖在首次运行时会自动检测并安装。
- 重启生效：安装完成后必须重启 Claude Code，使 hooks 配置写入 ~/.claude/hooks.json 并生效。
- 验证安装（三选一）：
- 终端运行 curl http://localhost:37777/api/health，应返回 {"status":"ok"}。
- 检查 ~/.claude/hooks.json 包含 claude-mem 的 PostToolUse 和 SessionStart 条目。
- 浏览器打开 http://localhost:37777 查看 Web 查看器。
- 开始使用：第一次会话开始积累观察记录，第二次会话起自动注入相关上下文。
核心优势
- 真正的跨会话连续性：解决 Claude Code 每次新会话从零开始的问题，历史调试记录与架构决策均可直接引用。
- Token 成本极低：相比传统 MCP 方式可节省约 2,250 个令牌，三层检索架构避免一次性加载 35,000 令牌的低效做法。
- 零配置自动化：安装后全自动运行，无需手动记录日志或触发保存，后台工作者平均 8ms 完成非阻塞压缩。
- 本地优先与隐私安全：数据默认保存在本地，无需额外 API 密钥，敏感内容可通过标签排除。
- 跨生态兼容：不仅支持 Claude Code，还兼容 Gemini CLI、Cursor、Windsurf、OpenClaw 网关，跨 Linux/macOS/Windows 平台。
- 多机器同步：通过 claude-mem-sync 支持开发者通过 SSH 在多台机器间同步观察记录和会话摘要。
同类竞品对比
- Claude-Mem：架构为插件（生命周期钩子），存储采用本地 SQLite + FTS5，搜索为语义+关键词混合，每次工具调用后捕获，免费开源，支持 SSH 同步跨机器，间接共享团队记忆，Token 效率极高（三层渐进检索）。
- Claude 内置 Auto Memory：原生功能，本地 Markdown 存储，无搜索，会话结束时自动保存，免费，通过 Git 同步跨机器，通过共享 CLAUDE.md 共享团队记忆，Token 效率低（加载前 200 行）。
- memsearch：插件（钩子+Skill），本地 Markdown + Milvus 存储，稠密向量 + BM25 搜索，会话结束捕获，免费，不支持跨机器与团队记忆，Token 效率中。
- supermemory：插件（钩子+云端），云端存储，语义 + 时序搜索，会话结束捕获，付费，支持跨机器与团队记忆，Token 效率中。
- mem0 (自托管)：MCP 服务器，本地 Qdrant + Ollama 存储，语义向量搜索，会话结束捕获，免费，不支持跨机器与团队记忆，Token 效率中。
应用场景
- 跨会话接力开发：昨天与 Claude 一起修复的竞态条件，今天直接继续推进，无需重新分析。
- 超大规模重构：用 Endless Mode 完成涉及 600+ 文件的框架迁移或代码重构，不受上下文窗口限制。
- 多代码库管理：在十个不同代码库间切换，各自拥有独立的记忆空间，避免信息串扰。
- 调试知识沉淀：自动捕获调试模式与解决方案，形成可检索的故障排查大脑。
- 新成员上下文同步：通过多机器同步或共享 CLAUDE.md，帮助新加入的开发者快速获取项目历史决策。
