claude-mem 中文文档

Appearance

claude-mem ​

Claude Code的持久内存压缩系统

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

快速开始 ​

使用一个命令安装：

bash
npx claude-mem install

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

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

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

主要特点 ​

  • 🧠 持久记忆 - 上下文在会话之间得以保留
  • 📁 文件夹上下文文件 - 在项目文件夹中自动生成的 CLAUDE.md，包含活动时间表
  • 🌐 多语言模式 - 支持28种语言（西班牙语、中文、法语、日语等）
  • 🎭 模式系统 - 在工作流程之间切换（代码、邮件调查、放松）
  • 🔍 MCP 搜索工具 - 使用自然语言查询您的项目历史
  • 🧠 知识代理 - 从你的观察历史构建可查询的“大脑”
  • 🌐 网页查看器界面 - 在 http://localhost:37777 实时内存流可视化
  • 🔒 隐私控制 - 使用 <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. 4 个生命周期钩子 - 会话开始, 用户提交提示, 工具使用后, 停止
  2. 智能安装 - 缓存依赖检查器（预钩子脚本）
  3. Worker 服务 - 由 Bun 管理的 37777 端口 HTTP API
  4. SQLite 数据库 - 存储会话、观察、摘要，并支持 FTS5 搜索
  5. MCP 搜索工具 - 使用自然语言查询历史背景
  6. 网页查看器界面 - 使用 SSE 和无限滚动实现实时可视化

详情请参见Architecture Overview]。

系统要求 ​

  • Node.js：18.0.0 或更高
  • Claude Code：支持插件的最新版本
  • Bun：JavaScript 运行时和进程管理器（如果缺失会自动安装）
  • SQLite 3：用于持久存储（捆绑）

新功能 ​

v9.0.0 - 实时上下文：

  • 文件夹上下文文件：在项目文件夹中自动生成的 CLAUDE.md，包含活动时间表
  • 工作树支持：来自父仓库和 Git 工作树的统一上下文
  • 可配置的观察限制：控制在上下文中显示多少观察
  • Windows 修复：已解决 IPC 检测和钩子执行问题
  • 设置自动创建：settings.json 现在在第一次运行时自动创建
  • MCP 工具命名：从“mem-search 技能”更新为“MCP 工具”术语

v7.1.0 - Bun 迁移：

  • 用原生 Bun 进程管理替换了 PM2
  • 从 better-sqlite3 转换到 bun:sqlite 以实现更快的数据库访问
  • 简化的跨平台支持

v7.0.0 - 上下文配置：

  • 11 个用于对上下文注入进行细粒度控制的设置
  • 双标签隐私系统 (<private> 标签)

下一步 ​

  • Installation

Quick start & advanced installation

  • Getting Started

Learn how Claude-Mem works automatically

  • Folder Context

Auto-generated folder CLAUDE.md files

  • Search Tools

Query your project history

  • Knowledge Agents

Build queryable corpora from your history