Claude-Mem 入门教程：让 AI 拥有持久记忆

一、问题的由来

使用 Claude Code 的人，都会遇到一个问题。

AI 没有记忆。

每次开启新会话，它都会忘记之前的一切。你昨天教它的项目结构、代码规范、踩过的坑，今天全部归零。

这就像每天上班，都要重新向同事介绍自己。效率极低。

有没有办法，让 AI 记住之前的对话？

答案是有的。Claude-Mem 就是为了解决这个问题而生的。

二、Claude-Mem 是什么

简单说，Claude-Mem 是一个持久化记忆系统。

它的工作原理很简单：

捕获：每次你和 Claude 对话，它会自动记录关键信息
压缩：将这些信息压缩成语义摘要，存入数据库
注入：下次对话时，自动将相关记忆注入上下文

这样一来，Claude 就"记住"了之前的对话。

三、核心特性

Claude-Mem 有几个值得关注的特性。

（1）持久记忆

上下文可以跨会话保存。今天的对话，明天还能用。

（2）语义搜索

支持自然语言查询历史记录。比如问"上次我们怎么解决那个 bug 的"，它能找到相关对话。

（3）可视化界面

提供 Web 界面，地址是 http://localhost:37777。可以实时查看记忆内容。

（4）隐私控制

使用 <private> 标签，可以排除敏感内容。不想被记住的东西，不会被记住。

（5）引用功能

可以通过 ID 引用过去的观察记录。方便追溯和验证。

四、安装方法

安装非常简单，两条命令搞定。

首先，在 Claude Code 中运行：

/plugin marketplace add thedotmack/claude-mem

然后安装：

/plugin install claude-mem

最后，重启 Claude Code。

这一步很重要，不重启不会生效。

五、系统要求

在安装之前，确保你的环境满足以下条件：

依赖
版本要求

Node.js
18.0.0+

Claude Code
支持插件

Bun
自动安装

SQLite 3
内置

如果你的 Node.js 版本太低，需要先升级。

六、工作原理

Claude-Mem 通过五个生命周期钩子工作：

SessionStart    → 注入历史上下文
UserPromptSubmit → 记录用户输入
PostToolUse     → 捕获工具观察
Stop            → 处理中断
SessionEnd      → 生成语义摘要

背后是一个 Worker 服务，管理着 SQLite 数据库。数据库使用 FTS5 全文搜索，查询速度很快。

七、基本使用

安装完成后，Claude-Mem 会自动工作。你不需要做任何额外操作。

但有几个技巧值得了解。

（1）查看记忆

打开浏览器，访问 http://localhost:37777，可以看到所有记忆内容。

（2）搜索历史

在对话中，可以直接问 Claude：

"我们之前讨论过什么？"
"上次那个 API 问题怎么解决的？"

Claude 会自动搜索记忆，给出答案。

（3）排除敏感信息

如果某些内容不想被记录，用 <private> 标签包裹：

<private>
这里的内容不会被记录
</private>

八、常见问题

Q：记忆会占用多少空间？

A：SQLite 数据库通常很小，几十 MB 足够存储大量对话。

Q：可以删除某条记忆吗？

A：可以通过 Web 界面管理，或直接操作数据库。

Q：多个项目的记忆会混在一起吗？

A：不会。每个项目有独立的记忆空间。

九、小结

Claude-Mem 解决了一个实际问题：AI 的健忘症。

它的设计思路很清晰：

自动捕获 → 不需要手动操作
语义压缩 → 节省 token 开销
按需注入 → 只加载相关记忆

对于重度使用 Claude Code 的开发者来说，这是一个值得尝试的工具。

十、参考链接

（完）