跳转到内容
AI Agent 教程 AI Agent 教程

Claude-Mem 项目介绍

Claude-Mem 项目介绍

为 Claude Code 构建的持久记忆压缩系统，通过自动捕获、AI 压缩摘要和语义检索，让 AI 在跨会话中保持项目上下文连续性。

项目定位

Claude-Mem 是一个 Claude Code 插件，将 Agent 的工具使用观察自动捕获为结构化记忆，经 AI 压缩后存入本地数据库，新会话启动时自动注入相关上下文。

核心能力

  • 持久记忆 — 上下文跨会话存活，关闭终端不丢失
  • AI 驱动的压缩 — 使用 Claude Agent SDK 将工具使用记录压缩为结构化观察（observation）和会话摘要（summary）
  • 渐进式披露 — 三层搜索工作流（搜索索引 → 时间线 → 完整详情），节省约 10 倍 token
  • 混合检索 — SQLite FTS5 全文搜索 + Chroma 向量数据库语义搜索
  • 多 IDE 支持 — 支持 Claude Code、Gemini CLI、Cursor、Windsurf、OpenCode、OpenClaw
  • Web Viewer UI — 实时记忆流查看器，默认 http://localhost:37777
  • 隐私控制 — <private> 标签在 hook 层剥离敏感内容，阻止其进入数据库
  • 多模型路由 — 记忆生成支持 Claude、Gemini、OpenRouter 三种模型提供商
  • 知识语料库 — build_corpus / prime_corpus / query_corpus 构建可查询的知识 Agent

技术栈

组件技术
运行时Bun（主运行时）+ Node.js
语言TypeScript
构建esbuild
数据库SQLite3（本地存储，含 FTS5 全文搜索）
向量检索Chroma（通过 MCP 工具调用）
Web 框架Express 5（Worker HTTP API）
前端 UIReact 19（Viewer）
消息队列BullMQ + Redis（可选）
认证BetterAuth
MCP SDK@modelcontextprotocol/sdk

架构概览

快速体验

Terminal window
# 一行安装
npx claude-mem install


# 重启 Claude Code，记忆系统自动生效

安装后，Claude Code 的每次工具使用都会被自动记录、压缩和存储。下次打开 Claude Code 时，之前会话的上下文会自动注入。

教程导读

本教程分为 AI 应用通用知识和编程核心两部分：

AI 应用通用知识（6 章）

章节知识点引用 Common
01记忆压缩模式首次覆盖：common/memory-system/
02渐进式披露首次覆盖：common/context-management/
03混合检索策略引用：common/memory-system/07-hybrid-retrieval-memory
04边缘隐私过滤首次覆盖：common/agent-security/
05知识语料库构建引用：common/multi-agent/
06记忆生成多模型路由引用：common/model-provider/

编程核心（6 章）

章节知识点
01Claude Code 插件与 Hooks 架构
02Worker Service 后台服务模式
03SQLite 存储与迁移系统
04多 IDE 集成适配器
05LLM 结构化输出 XML 解析器
06SSE 实时推送与 Viewer UI

每章 frontmatter 中的 projectVersion / projectCommit 与 tutorials/projects.yml 中的基线一致，确保教材与源码版本可对应。