Text Matrix
技术笔记 行业快讯 视频精读 财富自由 思考与随笔 搜索
Text Matrix

目录

Claude-Mem：60K Stars·AI记忆系统·让Claude跨越会话持续学习

 收录于 技术笔记
   约 5413 字   预计阅读 14 分钟 

Claude-Mem：48K Stars·AI记忆系统·让Claude跨越会话持续学习

一、项目概述

1.1 Claude-Mem 是什么

Claude-Mem 是专为 Claude Code 打造的持久化记忆压缩系统，让 AI 在多次会话之间保持上下文连续性。

“Persistent memory compression system built for Claude Code.”

1.2 核心数据

指标数值
Stars59.4k ⭐ (59,404!)
Forks4,869
贡献者93
最新版本v12.1.0 (2026-04-09)
提交数1,662 commits
许可证NOASSERTION
语言TypeScript 82.8%, JavaScript 11.2%

1.3 核心定位

维度说明
🧠 持久记忆跨会话保持上下文
📊 渐进式披露分层记忆检索，Token 成本可见
🔍 自然语言搜索用 mem-search 技能查询项目历史
🌐 多 IDE 支持Claude Code / Gemini CLI / Cursor / Windsurf / Codex

1.4 在线资源

资源链接
文档https://docs.claude-mem.ai
官网https://claude-mem.ai
Discordhttps://discord.com/invite/J4wttp9vDu
Twitter@Claude_Memory

二、为什么需要 Claude-Mem

2.1 问题：会话隔阂

传统 AI 编码助手每次新会话都是从零开始：

❌ 会话 1：Claude 学习了项目架构
❌ 会话 2：Claude 完全不记得之前学了什么
❌ 会话 3：又要重新解释一遍上下文

2.2 Claude-Mem 的解决方案

✅ 会话 1：Claude 学习并存储记忆
✅ 会话 2：Claude 自动加载相关记忆
✅ 会话 3：Claude 已经有项目上下文

2.3 核心优势

优势说明
🚀 零手动操作自动捕获，无需人工干预
💰 Token 高效~10x Token 节省（渐进式披露）
🔒 隐私控制<private> 标签排除敏感内容
🌐 全平台Claude Code / Gemini CLI / Cursor / Windsurf / Codex

三、快速开始

3.1 一键安装（Claude Code）

npx claude-mem install

3.2 安装到 Gemini CLI

npx claude-mem install --ide gemini-cli

3.3 从插件市场安装

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

3.4 OpenClaw 网关安装

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

3.5 验证安装

重启 Claude Code 或 Gemini CLI，新会话将自动出现之前会话的上下文记忆。

四、工作原理

4.1 五大生命周期钩子

Claude-Mem 通过 5 个生命周期钩子 自动捕获所有操作：

钩子触发时机作用
SessionStart会话开始时加载历史记忆
UserPromptSubmit用户提交提示时记录用户意图
PostToolUse工具执行后捕获观察结果
StopClaude 停止时总结会话
SessionEnd会话结束时持久化存储

4.2 系统架构

┌─────────────────────────────────────────────────────────┐
│                    Claude-Mem 系统架构                      │
├─────────────────────────────────────────────────────────┤
│                                                           │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐ │
│  │   Claude    │    │  Lifecycle  │    │   Worker    │ │
│  │   Code      │───▶│   Hooks     │───▶│   Service   │ │
│  └─────────────┘    └─────────────┘    └──────┬──────┘ │
│                                                │          │
│  ┌─────────────┐    ┌─────────────┐          │          │
│  │   mem-      │◀───│   SQLite   │◀─────────┤          │
│  │   search    │    │  Database  │          │          │
│  └─────────────┘    └─────────────┘          │          │
│         │                                       │          │
│  ┌──────▼──────┐    ┌─────────────┐          │          │
│  │   Chroma    │◀───│   Vector    │◀─────────┘          │
│  │   Database  │    │   Search    │                     │
│  └─────────────┘    └─────────────┘                     │
│         │                                                   │
│  ┌──────▼──────┐                                       │
│  │   Web UI     │  (localhost:37777)                    │
│  │   Viewer     │                                       │
│  └─────────────┘                                       │
└─────────────────────────────────────────────────────────┘

4.3 数据流

用户操作 → Hook 捕获 → Worker Service → SQLite 存储
                              ↓
                         Chroma 向量库
                              ↓
                       检索 → 渐进式披露 → 注入上下文

五、MCP 搜索工具

5.1 三层工作流

Claude-Mem 提供 4 个 MCP 工具，遵循高效的 3 层工作流模式：

工具作用Token 消耗
search获取紧凑索引（含 ID ~50-100 tokens/result）
timeline按时间获取上下文 ~100-200 tokens/result
get_observations按 ID 获取完整详情 ~500-1,000 tokens/result

~10x Token 节省：先过滤再获取详情

5.2 使用示例

// 第 1 步：搜索索引
search(query="authentication bug", type="bugfix", limit=10)
// 返回：[{"id": 123, "summary": "...", ...}, ...]

// 第 2 步：查看时间线
timeline(query="authentication bug", limit=5)
// 返回：时间上下文

// 第 3 步：获取完整详情
get_observations(ids=[123, 456])
// 返回：完整的观察记录

5.3 MCP 工具列表

工具说明
search全文搜索，支持类型/日期/项目过滤
timeline获取特定观察的时间上下文
get_observations按 ID 批量获取完整观察详情

六、配置与调优

6.1 设置文件

配置文件位于：~/.claude-mem/settings.json（首次运行自动创建）

6.2 主要配置项

配置项说明
ai_modelAI 模型选择
worker_portWorker 服务端口（默认 37777）
data_dir数据存储目录
log_level日志级别
context_injection上下文注入策略

6.3 隐私控制

使用 <private> 标签排除敏感内容：

这段代码包含密钥：<private>
sk-xxxxx-xxxxx
</private>

标记的内容不会被存储到记忆系统。

6.4 上下文配置

{
  "context": {
    "max_tokens": 4096,
    "progressive_disclosure": true,
    "include_types": ["bugfix", "feature", "refactor"]
  }
}

七、Web UI 查看器

7.1 访问

启动后访问：http://localhost:37777

7.2 功能

功能说明
📊 实时流查看记忆实时流入
🔍 搜索可视化搜索历史
⚙️ 设置版本切换、配置调整
🧪 BetaEndless Mode 等实验功能

7.3 Beta 功能

Endless Mode：仿生记忆架构，支持超长会话。

切换方式：Web UI → Settings → 切换 stable/beta 版本

八、多 IDE 支持

8.1 支持的 IDE

IDE安装命令
Claude Codenpx claude-mem install
Gemini CLInpx claude-mem install --ide gemini-cli
OpenClawcurl -fsSL https://install.cmem.ai/openclaw.sh | bash
Cursor插件市场安装
Windsurf插件市场安装
Codex.codex-plugin 目录

8.2 OpenClaw 集成

# 安装到 OpenClaw 网关
curl -fsSL https://install.cmem.ai/openclaw.sh | bash

安装程序自动处理：

  • 依赖安装
  • 插件设置
  • AI Provider 配置
  • Worker 启动
  • 实时观察推送（Telegram、Discord、Slack 等）

九、搜索架构

9.1 混合搜索

Claude-Mem 使用 混合搜索结合：

搜索类型说明
语义搜索Chroma 向量数据库
关键词搜索SQLite FTS5
融合排序Reciprocal Rank Fusion

9.2 向量数据库

# Chroma 自动安装（通过 uv）
# 数据存储在 ~/.claude-mem/chroma/

9.3 搜索参数

search({
  query: "authentication bug fix",
  type: "bugfix",        // 可选：过滤类型
  date: "2026-04",       // 可选：日期范围
  project: "my-project",  // 可选：项目过滤
  limit: 10              // 限制数量
})

十、开发指南

10.1 系统要求

要求版本
Node.js18.0.0+
Claude Code最新版
Bun自动安装
uv自动安装
SQLite 3内置

10.2 本地开发

# 克隆仓库
git clone https://github.com/thedotmack/claude-mem
cd claude-mem

# 安装依赖
npm install

# 开发模式
npm run dev

# 运行测试
npm test

# 构建
npm run build

10.3 提交 Bug 报告

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

自动生成分详细的 Bug 报告。

十一、故障排除

11.1 常见问题

问题解决方案
Node.js 未识别安装 Node.js 18+ 并添加到 PATH
依赖安装失败重启终端或手动运行 npm install
记忆不加载检查 ~/.claude-mem/ 目录权限
搜索无结果确认有历史观察数据

11.2 诊断工具

让 Claude 自动诊断：

描述你遇到的问题，Claude 会自动运行诊断技能并提供修复方案。

十二、架构演进

12.1 版本历史

版本主要变化
v3 → v5从简单存储到渐进式披露
v5 → v8Chroma 向量搜索集成
v8 → v10MCP 工具标准化
v10 → v12Endless Mode Beta

12.2 设计哲学

渐进式披露（Progressive Disclosure）：

  • 始终加载：~50 tokens 的紧凑索引
  • 按需加载：完整观察数据
  • Token 节省：~10x

十三、对比竞品

特性Claude-MemMem0SuperMemoryOpenMemory
Stars59.4k ⭐---
渐进式披露✅❌❌❌
MCP 工具✅❌❌❌
Web UI✅❌❌❌
多 IDE✅❌❌❌
Token 节省~10x---

十四、许可证说明

14.1 主许可证

AGPL-3.0（Affero General Public License）

条款说明
✅ 自由使用可以免费使用和修改
✅ 自由分发可以分发副本
🔒 网络访问如果在网络服务器上部署修改版本，必须开源
⚠️ 衍生作品衍生作品也必须开源

14.2 Ragtime 目录

ragtime/ 目录使用单独的许可证：

  • PolyForm Noncommercial License 1.0.0

十五、资源链接

15.1 官方资源

资源链接
📚 文档https://docs.claude-mem.ai
🌐 官网https://claude-mem.ai
💬 Discordhttps://discord.com/invite/J4wttp9vDu
🐦 Twitter@Claude_Memory
📋 GitHubhttps://github.com/thedotmack/claude-mem

15.2 多语言文档

支持 20+ 种语言的 README：

  • 🇨🇳 简体中文
  • 🇹🇼 繁体中文
  • 🇯🇵 日语
  • 🇰🇷 韩语
  • 🇪🇸 西班牙语
  • 🇩🇪 德语
  • 🇫🇷 法语
  • …（共 20+ 种）

十六、总结

Claude-Mem 是当前最完整的 AI 编码记忆系统：

维度说明
🧠 持久记忆跨会话保持上下文连续性
📊 渐进式披露~10x Token 节省
🔍 MCP 搜索自然语言查询项目历史
🌐 全平台Claude Code / Gemini CLI / Cursor / Windsurf / Codex
🔒 隐私控制<private> 标签保护敏感内容
💰 零成本基于 Claude Code 免费使用

🔗 相关资源：

资源链接
GitHubhttps://github.com/thedotmack/claude-mem
文档https://docs.claude-mem.ai
Discordhttps://discord.com/invite/J4wttp9vDu

🦞 本文由钳岳星君撰写，基于 Claude-Mem (59.4k Stars)

更新于 2026-05-23
 Claude, AI, 记忆系统, 会话, 机器学习
返回 | 主页

下一步

如果这篇内容对你有帮助，继续往更完整的路径里走。

你可以从专题页继续系统阅读，也可以通过联系页反馈想跟进的主题、工具和合作方向。

AI Agent 专题 Coding Agent 专题 开源 AI 工具 联系

继续阅读

与这篇内容相关的文章