一、工具链简介

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

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

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

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

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

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

二、安装方式

第 1 步：在 Claude 命令行执行

1
2
3
/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

第 2 步：重启 Claude Code

1
2
3
# 完全退出 Claude Code，然后重新打开
# 如果是终端版本：
claude

第 3 步：打开 Web UI

在浏览器中访问：

1
http://localhost:37777

你应该看到一个实时记忆流界面。如果页面打不开，说明 Worker 没有启动。

如果Claude 会开始执行各种操作（创建文件、安装依赖、修改配置）。在这个过程中，你会看到：

  • 🟢 实时的 Observation 条目不断出现
  • 每条 Observation 都有标题、类型标签和时间戳
  • 操作细节被自动压缩成简洁的笔记

这就是 Claude-Mem 在工作的样子。你什么都不需要做，它完全自动。

第 4 步：Health Check

1
curl http://localhost:37777/api/health

期望返回：

1
{"status":"ok"}

第 5 步：检查数据库文件

1
ls -la ~/.claude-mem/claude-mem.db

应该能看到一个 SQLite 数据库文件。

第 6 步：检查配置文件

1
cat ~/.claude-mem/settings.json

应该能看到类似这样的默认配置：

1
2
3
4
5
{
  "CLAUDE_MEM_MODE": "code",
  "WORKER_PORT": 37777,
  "LOG_LEVEL": "info"
}

5 步全部通过？恭喜你，Claude-Mem 已经在正常运行了！ 🎉

三、核心功能和用法

Claude-Mem 数据存储

Claude-Mem 的所有数据都存在你本地硬盘的一个目录里：

1
2
3
4
5
6
7
~/.claude-mem/
├── claude-mem.db          # SQLite 数据库（核心）
├── settings.json          # 配置文件
├── chroma/                # ChromaDB 向量数据库
│   └── ...
└── logs/                  # 运行日志
    └── worker.log

没有任何数据会上传到云端。 你的开发记忆完全属于你自己。

Claude-Mem 主要功能介绍

  • 自动记忆捕获：Claude-Mem 会在每次与 Claude Code 的对话中自动记录关键信息，包括工具调用、对话记录和项目结构，确保在新会话中无需重新解释背景
  • 跨会话记忆注入：当你开启新会话时，Claude-Mem 会自动将相关记忆注入到会话中，使得 Claude Code 能够记住之前的开发决策、bug 修复和功能实现。
  • 智能搜索：通过 mem-search 技能，用户可以快速查询过去的工作记录，节省时间并提高效率。
  • 隐私控制：用户可以使用 <private>标签排除敏感内容，确保数据安全。

Claude-Mem 工作原理

Claude-Mem通过5个生命周期钩子实现无缝记忆：

  1. 会话启动 - 注入最近10个会话的上下文
  2. 用户提示提交 - 创建会话并保存用户提示
  3. 工具使用后 - 捕获观察结果（读取、写入等）
  4. 停止 - 处理会话中断
  5. 会话结束 - 生成摘要，为下次会话做准备

Claude-Mem 用法

你可以直接向 Claude 提问关于之前工作的问题

1
2
3
"我们昨天是怎么解决那个数据库连接问题的？"
"上周重构认证模块时做了什么决定？"
"帮我找到关于 API 速率限制的所有相关代码"

Claude 会自动调用 mem-search 技能，从记忆中检索相关信息。

四、使用心得与技巧

  Claude-Mem 适用于需要长期跟踪项目进展的开发者，特别是在大型项目中，可以显著减少重复工作，提高开发效率。无论是新手还是经验丰富的开发者，Claude-Mem 都能帮助你更好地管理和利用历史信息，提升编程体验。

  通过以上步骤和功能介绍，你可以轻松上手使用 Claude-Mem，充分利用其强大的记忆管理能力。