Software 2.0

Claude‑Mem长期记忆插件

admin -

如果您曾经重新打开一个 Claude Code 会话 已经忘记了，却意识到 Claude您昨天所做的所有工作，您就已经理解了 Claude‑Mem 正在解决的问题。

现代 AI 编码助手功能强大——但它们遭受会话失忆症的困扰。一旦会话结束，上下文就会消失。架构决策、错误调查、文件编辑、工具使用——全都消失了。

Claude‑Mem 修复了这个问题。

它为 Claude Code 自动添加了持久的、可搜索的、隐私保护的记忆。

无需提示。无需手动笔记。无需复制粘贴。

只有记忆。

1、什么是 Claude‑Mem？

Claude‑Mem 是一个 Claude Code 插件，它自动捕获 Claude 在编码会话期间所做的一切，使用 AI（通过 Claude 的 Agent SDK）对其进行压缩，并使这些知识在未来的会话中可用。

简单来说：

Claude‑Mem 让 Claude 在重启后记住您的项目。

它记录：

  • 您的提示
  • 工具使用（读取、写入、编辑、命令）
  • 观察结果和结果
  • 会话摘要

然后它将所有内容本地存储，并在新会话开始时智能地重新注入正确的上下文。

为什么这很重要？

没有记忆，AI 编码助手：

  • 重复重新分析相同的文件
  • 忘记已修复的错误
  • 丢失架构决策
  • 浪费令牌来重新建立上下文

使用 Claude‑Mem：

  • 上下文在会话之间保留
  • Claude 理解之前发生了什么
  • 令牌使用量大幅减少
  • 您获得了像真正的团队成员一样的连续性

2、快速开始

直接从 Claude Code 插件市场安装 Claude‑Mem：

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

重启 Claude Code。

就是这样。

从现在开始，之前的会话上下文会自动出现在新会话中。

无需配置。

另一种方法是克隆和构建：

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

# 安装依赖
npm install

# 构建钩子和工作服务
npm run build

# 工作服务将在第一次 Claude Code 会话时自动启动
# 或手动启动：
npm run worker:start

# 验证工作服务是否正在运行
npm run worker:status

以下是简化的生命周期：

会话开始
    ↓
注入最近的观察作为上下文
    ↓
用户提示
    ↓
工具执行（读取/写入等）
    ↓
观察被捕获
    ↓
工作服务通过 Claude Agent SDK 提取学习内容
    ↓
生成会话摘要
    ↓
为下一个会话准备

一切都在后台自动发生。

3、核心功能

3.1 持久记忆

Claude 记住：

  • 编辑了哪些文件
  • 做出更改的原因
  • 修复的错误
  • 设计决策

即使在重启 Claude Code 之后也是如此。

3.2 渐进式披露（令牌高效）

Claude‑Mem 不会将所有内容都倒入上下文。

相反，它使用层：

第 1 层 — 索引视图（会话开始）

  • 观察的标题
  • 令牌成本估计
  • 时间线视图
~50–200 令牌

第 2 层 — 按需召回（mem-search 技能）

自然地提问：

上次会话我们修复了什么错误？

Claude 自动调用 mem-search 并仅检索所需的内容。

每个项目 ~100–500 令牌

第 3 层 — 完美回忆

必要时，Claude 可以：

  • 读取原始文件
  • 访问原始转录本
  • 重建完整上下文

3.3 基于技能的内存搜索

Claude‑Mem 添加了一个 mem-search 技能。

您无需手动调用它。

您可以问：

我们如何实现身份验证？

Claude 理解意图并使用以下方式搜索您的项目历史：

  • 关键词搜索（SQLite FTS5）
  • 语义向量（Chroma）
  • 时间线上下文

3.4 Web 查看器 UI

Claude‑Mem 运行一个带有实时 UI 的本地工作服务：

http://localhost:37777

您可以：

  • 浏览会话
  • 查看观察结果
  • 检查摘要
  • 点击引用

每个观察都有一个永久 ID：

http://localhost:37777/api/observation/{id}

3.5 隐私控制

敏感内容？

像这样包装它：

<private>
API_KEY=super-secret
</private>

Claude‑Mem 将将其从存储中排除。

您的数据保留在本地——存储在 SQLite 中。

4、示例：记住什么

假设您在会话中执行此操作：

修复 auth.ts 中的登录 bug

Claude：

  • 读取 auth.ts
  • 修改验证逻辑
  • 编写测试

Claude‑Mem 存储：

  • 文件：auth.ts
  • Bug 描述
  • 修复原因
  • 工具操作

第二天您问：

我们在 auth.ts 中做了什么更改？

Claude 立即回忆起来——无需重新读取文件。

5、安装详情

系统要求：

  • Node.js 18+
  • Claude Code（最新版本）
  • Bun（自动安装）
  • SQLite 3（捆绑）

数据位置

~/.claude-mem/
  ├─ claude-mem.db
  ├─ logs/
  └─ settings.json

如需要覆盖：

export CLAUDE_MEM_DATA_DIR=/custom/path

6、高级：直接查询内存

Claude‑Med 使用 SQLite。您可以自己检查：

sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;"

示例查询：

SELECT session_id, created_at
FROM sdk_sessions
ORDER BY created_at DESC
LIMIT 5;
SELECT tool_name, created_at
FROM observations
WHERE session_id = 'SESSION_ID';

7、关于 /clear 的重要说明

当您运行：

/clear

Claude‑Mem：

  • 重新注入新的上下文
  • 继续跟踪同一个会话
  • 仍然生成摘要

所以您得到了一个干净的 slate而不丢失记忆。

8、为什么 Claude‑Mem 感觉不同

大多数"记忆"解决方案：

  • 存储原始转录本
  • 将所有内容倒回上下文
  • 燃烧令牌

Claude‑Mem：

  • 智能压缩
  • 只注入有用的内容
  • 让 Claude*在需要时询问更多

这就是真正工程师的工作方式。

9、结束语

Claude‑Mem 悄无声息地解决了 AI 编码助手最大的局限性之一：遗忘。

一旦安装，您就不再考虑它——这就是重点。

Claude 简单：

  • 记住您的项目
  • 理解历史
  • 从您停下的地方继续

如果您认真地使用 Claude Code，Claude‑Mem 不再是可选的。

这是您 AI 队友的肌肉记忆。

原文链接: Claude‑Mem: Giving Claude Code a Long‑Term Memory

汇智网翻译整理，转载请标明出处