跳转到内容
全部开发指南

claude-mem 安装与使用教程：给 Claude Code 加上跨会话记忆

AIGoCode发布于 更新于

claude-mem 安装与使用教程：给 Claude Code 加上跨会话记忆 封面

同一个项目连开三个 Claude Code 会话，每次它都要重新问一遍：技术栈是什么、数据库用哪个、API 怎么命名。答案一模一样，你却要回答三遍。就像来了个能力很强的实习生，每天早上失忆一次。

claude-mem 是一个开源的 Claude Code 记忆插件，作用是让 Claude Code 记住之前的会话：上一次的操作记录、项目约定、踩过的坑，下一次开会话时自动带回来。

本文适合每天用 Claude Code 维护同一个项目、受够了反复交代背景的开发者。下面讲 claude-mem 的工作原理、安装步骤、三层记忆搜索、Web 界面、技术架构和隐私控制。

claude-mem 原文配图 1

claude-mem 怎么工作

逻辑分三步：

  1. 记录：你使用 Claude Code 时，它在后台自动记录操作，包括编辑了哪些文件、跑了什么命令、修了什么 bug、做了什么决策；
  2. 压缩：记录不会原样堆着，而是用 AI 压缩成语义摘要，保留关键信息、去掉噪音；
  3. 注入：开新会话时，自动把和当前项目相关的历史上下文注入进去，Claude Code 一开始就知道之前发生过什么。

装好之后整个过程自动运行，不需要手动操作。

claude-mem 原文配图 2

第 1 步：安装 claude-mem

官方 README 目前推荐的安装方式是：

npx claude-mem install

安装程序会先完成配置，然后提示你在浏览器登录 claude-mem 账号，并选择记忆由谁来处理：官方的 claude-mem observer（目前有 30 天免费试用）、你自己的 OpenRouter 或 Gemini Key，或者你的 Anthropic 套餐。不想登录的话，可以显式传 --provider 参数，或设置环境变量 CLAUDE_MEM_ONLINE_OPTIN=false。

也可以沿用原文的方式，在 Claude Code 里从插件市场安装：

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

装完重启 Claude Code，之后每次新会话都会自动带上历史上下文。注意：npm install -g claude-mem 只会装 SDK，不会注册 Hook 和后台服务，不要用这种方式安装。

如果你用 OpenClaw，官方还提供一键安装脚本，会处理依赖、插件注册和 Worker 启动：

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

安装前最好先确认 Claude Code 本身工作正常，可以对照接入前的四项检查。

第 2 步：用三层搜索查记忆

装好后，claude-mem 通过 MCP 给 Claude Code 提供记忆搜索工具，按三层渐进式使用：

层级工具返回内容单条大约消耗
第一层search紧凑的记忆索引和 ID50–100 token
第二层timeline某条记录前后的时间线上下文—
第三层get_observations筛选后几条记录的完整详情500–1,000 token

分三层是为了省 token：先粗筛，再细看，比一次拉取全部详情便宜得多。

实际使用时直接用自然语言问：

# Claude Code 里直接问
"之前那个认证的 bug 我们是怎么修的？"

# claude-mem 先搜索索引，找到相关记录
# 然后拉详情，把当时的修改方案告诉你

不用记文件名，也不用翻 git log。

claude-mem 原文配图 3

第 3 步：在 Web 界面查看记忆

claude-mem 会在本地启动一个 Web 服务，原文给出的地址是 http://localhost:37777。打开后可以看到：

  • 实时记忆流：Claude Code 正在做什么、记下了什么；
  • 历史浏览：按项目、按时间筛选历史记录；
  • 引用跳转：每条记录都有 ID，可以直接引用。

这个界面不是必需的，但调试时很有用，能清楚看到 claude-mem 到底记了什么。

claude-mem 原文配图 4

claude-mem 的技术架构

  • 生命周期 Hook：在会话开始、提交 Prompt、工具调用前后、停止、会话结束等节点挂钩（原文写的是 5 个，官方 README 现在列了 6 个，增加了工具调用前的 PreToolUse）；
  • Worker 服务：基于 Bun 的本地 HTTP API，负责记忆存取，同时提供 Web 界面；
  • SQLite 数据库：存会话记录、观察日志、压缩摘要，支持 FTS5 全文搜索；
  • Chroma 向量数据库：语义加关键词的混合搜索；
  • mem-search Skill：自然语言查询接口，支持渐进式展开。

原文发布时 claude-mem 的数据都在本地；现在的安装流程增加了官方托管的 observer 选项，选择前可以看一下它处理的是哪些数据。

隐私控制：用 private 标签排除敏感内容

不想被记录的内容，可以用 <private> 标签包起来，被包住的部分不会进入记忆库。比如在会话里粘贴了密钥或敏感配置，加上 <private> 就不会被存下来。

使用注意事项

  • 自动记忆不等于正确记忆，定期在 Web 界面检查记下了什么，发现错误及时清理；
  • 选择托管 observer 或第三方 Key 时，留意费用和数据去向；
  • 原文写作时 claude-mem 是近 4 万 star 的项目，现在已经超过 10 万（2026 年 10 月数据），迭代很快，以官方文档为准。

总结

claude-mem 把“每次开会话重新交代背景”这件事自动化了：后台记录、AI 压缩、新会话自动注入，再配上三层搜索和本地 Web 界面。如果你每天在同一个项目里用 Claude Code，值得装上试试。还没开通 Claude Code 的话，可以通过 AIGoCode 直接接入使用。

参考链接