Claude-Mem¶

Claude Code 的持久记忆压缩系统

Claude-Mem 通过自动捕获工具使用观察、生成语义摘要并将其提供给未来的会话，从而在会话之间无缝保留上下文。这使得 Claude 即使在会话结束或重新连接后，也能保持对项目的知识连续性。

快速开始¶

使用单条命令安装：

npx claude-mem install

或从 Claude Code 内的插件市场安装：

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

重启 Claude Code。来自先前会话的上下文将自动出现在新会话中。

主要特性¶

• 🧠 持久记忆 - 上下文跨会话保留
• 📁 文件夹上下文文件 - 在项目文件夹中自动生成包含活动时间线的 CLAUDE.md
• 🌐 多语言模式 - 支持 28 种语言（西班牙语、中文、法语、日语等）
• 🎭 模式系统 - 在工作流之间切换（Code、Email Investigation、Chill）
• 🔍 MCP 搜索工具 - 使用自然语言查询你的项目历史
• 🧠 知识智能体 - 从你的观察历史构建可查询的“大脑”
• 🌐 Web Viewer UI - 由本地 Worker 提供的实时记忆流可视化
• 🔒 隐私控制 - 使用 <private> 标签 进行手动屏蔽，或启用自动脱敏进行基于正则表达式的机密检测。
• ⚙️ 上下文配置 - 精细控制注入哪些上下文
• 🤖 自动操作 - 无需手动干预
• 📊 FTS5 搜索 - 跨观察的快速全文搜索
• 🔗 引用 - 使用 ID 引用过去的观察

工作原理¶

┌─────────────────────────────────────────────────────────────┐
│ Session Start → Inject context from last 10 sessions       │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ User Prompts → Create session, save user prompts           │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ Tool Executions → Capture observations (Read, Write, etc.)  │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ Worker Processes → Extract learnings via Claude Agent SDK   │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ Session Ends → Generate summary, ready for next session     │
└─────────────────────────────────────────────────────────────┘

核心组件： 1. 5 个生命周期钩子 - SessionStart、UserPromptSubmit、PostToolUse、Summary（Stop）、SessionEnd 2. Worker Service - 由 Bun 管理的 Express HTTP API，运行在每用户端口上（默认 37700 + (uid % 100)） 3. SQLite 数据库 - 存储会话、观察、摘要，并支持 FTS5 搜索 4. Chroma 向量索引 - 可选的基于嵌入的语义搜索 5. MCP / 技能搜索工具 - 使用自然语言查询历史上下文 6. Web Viewer UI - 支持 SSE 和无限滚动的实时可视化

详见架构概览。

系统要求¶

• Node.js：20.0.0 或更高版本
• Bun ≥ 1.0（如缺失，npx claude-mem install 会自动安装）
• uv（如缺失会自动安装 —— 为 Chroma 提供 Python）
• Claude Code（或其他受支持的 IDE：Cursor、Windsurf、OpenCode、Codex CLI、Antigravity CLI、OpenClaw）
• SQLite 3 — 通过 bun:sqlite 捆绑提供

后续步骤¶

安装

快速开始与高级安装

入门指南

了解 Claude-Mem 如何自动工作

文件夹上下文

自动生成的文件夹 CLAUDE.md 文件

搜索工具

查询你的项目历史

知识智能体

从你的历史构建可查询的语料库