🧠 Claude-Mem｜跨会话持久记忆压缩系统 Agent 会话记忆自动捕获·AI压缩·跨上下文注入 开源免费/Apache 2.0·多平台兼容·76K星标

官网/网页工具地址:点击访问

📌 一、基础信息概述

Claude-Mem 是由 Alex Newman（@thedotmack）打造的开源持久化记忆压缩系统，GitHub 76K 星标、6.5K Fork。它无缝地跨会话保存上下文——自动捕获你的 Agent 在会话期间所做的一切，用 AI 压缩成语义摘要，并在未来会话中注入相关上下文。这意味着 Claude 在会话结束后或重新连接时，能够保持关于项目的知识连续性。支持 Claude Code、OpenClaw、Codex、Gemini CLI、Copilot、OpenCode 等多种 AI 编码工具。采用 Apache 2.0 开源协议，通过 5 个生命周期钩子（SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd）自动工作，无需手动干预。同时提供 Web Viewer UI（实时记忆流）、MCP 搜索工具（三层渐进式检索）、Chroma 向量数据库（混合语义+关键词搜索）等丰富功能。

🎯 产品定位

定位为跨会话持久化记忆压缩系统，以"让 Agent 永远不会忘记"为核心理念。核心解决 AI 编码工具每次新会话都从零开始、无法记住项目上下文和用户偏好的行业痛点。通过在会话生命周期中自动捕获工具使用观察、生成语义摘要，并在未来会话中智能注入相关上下文，让 Agent 像有长期记忆的人类一样工作。

💪 核心优势

• 🧠 持久记忆跨会话：上下文跨会话保存，Agent 结束后重新连接时保持知识连续性
• 🤖 完全自动化：5 个生命周期钩子自动工作，无需手动干预
• 📊 渐进式披露：分层记忆检索，每个结果附带 Token 成本可见性
• 🔍 技能搜索：通过 mem-search Skill 用自然语言查询项目历史
• 🖥️ Web Viewer UI：本地端口 37777 实时查看记忆流
• 🔗 引用系统：通过 ID 引用过去的观察，支持 API 和 Web Viewer 访问
• 🛡️ 隐私控制：使用 <private> 标签排除敏感内容
• ⚙️ 上下文配置：细粒度控制注入什么上下文
• 🧪 Beta 功能：Endless Mode 等实验性功能
• 🔌 MCP 搜索工具：4 个 MCP 工具，三层工作流模式，~10x Token 节省
• 🌐 多语言支持：支持 30+ 语言（中文、日文、韩文等）
• 🆓 开源免费 Apache 2.0：Apache 2.0 协议，完全免费

🎬 适配场景

• 💻 跨会话项目开发：多个会话中保持项目上下文一致性
• 🔧 长期项目维护：Agent 记住项目架构、代码风格、偏好设置
• 🐛 Bug 追溯：搜索过去会话中的 Bug 修复记录
• 📝 知识管理：项目决策记录、架构变更历史自动保存
• 🧪 实验追踪：记住哪些实验已经做过、结果如何
• 🤖 多 Agent 协作：不同 Agent 共享记忆知识库
• 🌐 多语言开发：支持 30+ 语言的记忆和搜索

👥 核心受众

Claude Code 用户、AI 编码 Agent 重度用户、长期项目开发者、需要跨会话记忆的专业开发者、追求 Agent 知识连续性的团队、开源项目维护者。

🎪 适配定位

专注 AI Agent 持久化记忆、跨会话上下文延续、RAG 向量搜索赛道。核心强项是 5 个生命周期钩子自动捕获+AI 压缩+智能注入、渐进式披露的 Token 优化、MCP 三层搜索节省 10x Token、多平台兼容 76K 星标；主打 AI 编码 Agent 记忆增强场景。核心解决 AI 编码工具每次新会话从零开始、无法记住项目上下文的行业痛点。

🧩 二、核心功能清单

🧠 持久记忆与跨会话上下文（核心）

无缝跨会话保存上下文。自动捕获 Agent 在会话期间的一切工具使用观察，用 AI 压缩成语义摘要，并在未来会话中智能注入最相关的上下文。让 Claude 在会话结束后保持关于项目的知识连续性。

🔄 5 个生命周期钩子

6 个钩子脚本实现完全自动化：SessionStart（会话开始初始化）、UserPromptSubmit（用户提交提示时记录）、PostToolUse（工具使用后捕获观察）、Stop（停止时处理）、SessionEnd（会话结束时压缩和存储）。每个钩子负责特定的记忆操作阶段。

📊 渐进式披露

分层记忆检索机制，每个结果附带 Token 成本可见性。先返回紧凑索引（~50-100 tokens/结果），再按需获取完整详情（~500-1,000 tokens/结果）。智能平衡记忆质量和 Token 消耗。

🔍 MCP 搜索工具（3 层工作流）

4 个 MCP 工具按三层工作流模式工作：search 获取紧凑索引→timeline 获取时序上下文→get_observations 仅获取过滤后的完整详情。相比直接搜索节省约 10x Token。

🖥️ Web Viewer UI

本地端口 37777 提供实时记忆流 Web 查看器。可通过 http://localhost:37777 查看所有记忆，支持设置管理、版本切换（稳定版/Beta）、实时观察流展示。

🗄️ SQLite + Chroma 双数据库

SQLite 数据库存储会话、观察、摘要；Chroma 向量数据库提供混合语义+关键词搜索。双重存储结构兼顾持久化和智能检索。

🔗 引用系统

通过 ID 引用过去观察。支持 API（http://localhost:37777/api/observation/{id}）和 Web Viewer 访问。可在新会话中精确引用历史记录。

🛡️ 隐私控制

使用 <private> 标签排除敏感内容不被存储。细粒度控制什么上下文被保存和注入。

⚙️ 上下文配置

提供细粒度控制：配置 AI 模型、Worker 端口、数据目录、日志级别、上下文注入设置等。

🌐 多语言支持

支持 30+ 语言模式，包括中文（code--zh）、日文（code--ja）等。通过 CLAUDE_MEM_MODE 设置切换语言和工作流行为。

🧪 Beta 功能

提供实验性功能如 Endless Mode（仿生记忆架构扩展会话）。可通过 Web Viewer UI 在稳定版和 Beta 版之间切换。

补充说明：Claude-Mem 的核心差异化壁垒为「5个生命周期钩子自动捕获+AI压缩+智能注入+渐进式披露 Token 优化+MCP 三层搜索节省 10x Token+双数据库持久化+76K 星标」，区别于普通记忆插件仅保存提示词无法结构化记忆的痛点。

💰 三、免费与收费规则（仅供参考以官网最新为准）

Claude-Mem 为开源项目，基于 Apache 2.0 协议，完全免费使用。

真实规则说明：

1. Claude-Mem 基于 Apache 2.0 协议，完全免费
2. 由 Alex Newman（@thedotmack）创建并维护
3. 安装方式：npx claude-mem install
4. 需 Node.js 18.0.0+、Claude Code 最新版
5. 所有功能开源完整开放

🖥️ 四、支持使用方式与运行说明

🚀 1. 支持使用方式

Claude-Mem 通过 npx claude-mem install 一键安装。支持 Claude Code 官方插件市场安装（/plugin marketplace add thedotmack/claude-mem）。也支持 Gemini CLI、OpenCode 的独立安装。OpenClaw 网关可通过 curl -fsSL https://install.cmem.ai/openclaw.sh | bash 安装。

标准使用流程：npx claude-mem install 安装→重启 Claude Code→Agent 自动开始记录会话→会话结束时自动压缩存储→新会话启动时自动注入最相关的记忆→可通过 http://localhost:37777 查看所有记忆。

⚙️ 2. 运行说明

• 🆓 开源免费，Apache 2.0
• 🔌 支持 Claude Code、OpenClaw、Codex、Gemini CLI、Copilot、OpenCode 等
• ⚡ npx 一键安装
• 🔄 5 个生命周期钩子自动工作
• 📊 渐进式披露，每结果 Token 成本可见
• 🔍 MCP 4 工具 3 层搜索，~10x Token 节省
• 🖥️ Web Viewer UI 端口 37777
• 🗄️ SQLite + Chroma 双数据库
• 🔗 ID 引用系统
• 🛡️ <private> 隐私标签
• 🌐 30+ 语言支持
• 🧪 Beta 功能（Endless Mode）
• 💻 需 Node.js 18.0.0+

📍 五、产品核心优势与适用人群落地场景

⚠️ 六、官方使用须知

1. Claude-Mem 核心聚焦跨会话持久化记忆压缩系统，主打 AI 编码 Agent 记忆增强场景。
2. 基于 Apache 2.0 协议，完全开源免费。
3. 由 Alex Newman（@thedotmack）创建并维护，76K 星标。
4. 安装方式：npx claude-mem install，需 Node.js 18.0.0+。
5. 5 个生命周期钩子自动工作，无需手动干预。
6. 使用 <private> 标签排除敏感内容。
7. Web Viewer UI 位于 http://localhost:37777。
8. 支持 30+ 语言，中文模式为 code--zh。
9. Beta 功能如 Endless Mode 可通过 Web Viewer 切换。
10. 功能以 GitHub 仓库最新状态为准。

❓ 七、常见问题解答

🔍 八、替代方案与对比参考

1. AI Agent 持久化记忆工具竞品对比

2. AI Agent 上下文管理工具竞品对比

3. 主流通用大模型记忆能力横向对比

4. 模型选型适配场景与渠道指南

5. 模型下载渠道推荐