第 1 期：为什么你的 AI 助手需要「记忆」？

⏱ 预计阅读 7 分钟 更新于 2026/5/7
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)

本期场景：你正在用 Claude Code 开发一个个人技术博客。昨天你和 Claude 讨论了数据库 Schema 设计，选择了 Prisma 作为 ORM。今天打开新会话，Claude 问你：「请问你的项目用的什么技术栈？」—— 它全忘了。

1.1 没有记忆的 AI 助手：一个真实的日常

想象一下这个场景：

第 1 天（会话 A）

你：帮我设计博客的数据库，我要支持文章、标签和评论。
Claude：好的！我建议用 Prisma 作为 ORM，Schema 这样设计...
（你们花了 30 分钟讨论，最终敲定了方案）

第 2 天（会话 B）

你：帮我修一下昨天那个评论功能的 Bug。
Claude：请问你的项目用的什么技术栈？评论功能的代码在哪个文件？
你：……（内心崩溃）

这不是 Claude 不够聪明。这是所有大语言模型（LLM）的先天缺陷 —— 它们是无状态的。每次会话结束，所有的上下文都会被丢弃。就像一个每天早上醒来都失忆的天才程序员。

这带来了三个致命问题

问题 后果
重复解释 每次新会话都要花 5-10 分钟交代项目背景
重复犯错 上次已经踩过的 Bug，这次又掉进同一个坑
Token 浪费 为了让 AI "想起来"，你不得不把大量文件塞进上下文 → 💸

1.2 Claude-Mem 是什么？一句话讲清楚

Claude-Mem = 让 AI 自动记笔记的后台秘书。

它不需要你做任何事情。当你在 Claude Code 中工作时，Claude-Mem 默默在后台：

  1. 观察 —— 记录 Claude 的每一步操作（读了哪些文件、改了哪些代码、做了什么决策）
  2. 压缩 —— 用另一个 AI 把原始操作日志提炼成结构化笔记
  3. 存储 —— 写入本地数据库，永久保存
  4. 注入 —— 下次开新会话时，自动把相关的历史笔记塞回 Claude 的上下文

整个过程全自动，你甚至感觉不到它的存在。

1.3 它不是什么

在进入正题之前，先扫清几个常见误解：

Claude-Mem 不是 为什么
笔记软件 你不需要手动记任何东西，它自动捕获
单纯的 RAG 系统 RAG 检索的是外部知识，Claude-Mem 检索的是 你自己的开发历史
云端服务 所有数据都存在你的 本地硬盘，不会上传到任何服务器
Claude Code 的官方功能 它是一个社区开源插件（GitHub 64K+ Stars）

1.4 系统全景预览

Claude-Mem 由三大组件构成：

graph TB
    subgraph "你的开发环境"
        CC["Claude Code"]
        Hook["5 个生命周期钩子
(自动触发)"]
    end

    subgraph "Claude-Mem 后台"
        Worker["Worker Service
(localhost:37777)"]
        SDK["Claude Agent SDK
(AI 压缩引擎)"]
    end

    subgraph "持久化存储"
        SQLite["SQLite 数据库
(结构化存储 + 全文搜索)"]
        Chroma["ChromaDB
(向量语义搜索)"]
    end

    CC -->|"每次工具调用"| Hook
    Hook -->|"HTTP 请求"| Worker
    Worker -->|"压缩提炼"| SDK
    SDK -->|"结构化笔记"| SQLite
    SDK -->|"向量嵌入"| Chroma
    SQLite -->|"下次会话注入上下文"| CC
    Chroma -->|"语义搜索结果"| CC

    style CC fill:#6366f1,color:#fff
    style Worker fill:#f59e0b,color:#000
    style SQLite fill:#10b981,color:#fff
    style Chroma fill:#10b981,color:#fff

你只需要知道的一件事：安装后，一切自动运行。第 2 期我们会手把手带你安装。

1.5 有了 Claude-Mem 之后

让我们回到开头的场景，看看装了 Claude-Mem 之后会发生什么：

第 1 天（会话 A） — 和之前一样正常工作

你：帮我设计博客的数据库。
Claude：好的！建议用 Prisma...

⬇️ Claude-Mem 在后台默默记录了：

  • 📝 Observation #1: type:decision — "选择 Prisma 作为 ORM"
  • 📝 Observation #2: type:feature — "设计了 Post、Tag、Comment 三张表"
  • 📝 Session Summary: "建立了博客项目的数据库 Schema，包含文章、标签和评论系统"

第 2 天（会话 B） — 魔法发生了 ✨

你：帮我修一下评论功能的 Bug。
Claude：好的！我看到我们昨天设计的 Comment 模型用了 Prisma，
关联到 Post 表。让我先找到 src/api/comments.ts...

它记住了一切。

下期预告

概念讲够了。下一期，我们打开终端，安装 Claude-Mem，并用 5 个步骤验证它已经在你的机器上正常运行。你会看到 http://localhost:37777 的实时记忆流界面。

➡️ 第 2 期：安装 Claude-Mem — 从零到跑通