> ## Content Index
> Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# Claude‑Mem长期记忆插件
- URL: https://www.hubwiz.com/blog/claude-mem-plugin-for-long-term-memory/
- Published: 2026-02-03T04:18:52.000Z
- Updated: 2026-02-03T04:18:52.000Z
- Description: Claude‑Mem 为 Claude Code 自动添加了持久的、可搜索的、隐私保护的记忆。
- Author: admin
- Tags: TOOL, CLAUDE CODE, CLAUDE-MEM, #Import 2026-10-14 14:41

如果您曾经重新打开一个 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：

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

```

重启 Claude Code。

就是这样。

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

无需配置。

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

```bash
# 克隆仓库
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 技能）

自然地提问：

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

```

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

> *每个项目 \~100–500 令牌*

#### 第 3 层 — 完美回忆

必要时，Claude 可以：

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

### 3.3 基于技能的内存搜索

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

您无需手动调用它。

您可以问：

```bash
我们如何实现身份验证？

```

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

```

如需要覆盖：

```bash
export CLAUDE_MEM_DATA_DIR=/custom/path

```

## 6、高级：直接查询内存

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

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

```

示例查询：

```sql
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](https://medium.com/@sonuyadav1/claude-mem-giving-claude-code-a-long-term-memory-7f90b46d6cf5?ref=hubwiz.com)

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