Claude-Mem:让 AI 编程助手拥有跨会话记忆,7.3 万星标的开源神器

用 Claude Code 写代码的朋友一定遇到过这个痛点：每次开新会话，AI 就像失忆了一样，完全不记得之前做过什么。你得反复解释项目背景、架构决策、之前踩过的坑。

Claude-Mem 就是来解决这个问题的。

这个开源项目在 GitHub 上已经拿下了 73,000+ Stars，是目前最火的 Claude Code 记忆插件之一。它能自动捕获你每次编程会话中的关键信息，压缩存储，并在未来的新会话中智能注入相关上下文。

简单说：让 Claude Code 拥有跨会话的长期记忆。

它能做什么？

🧠 持久化记忆 — 会话结束不丢上下文，下次打开自动恢复

📊 渐进式披露 — 不是一股脑把所有历史塞进去，而是分层检索，按需注入，节省 Token

🔍 语义搜索 — 用自然语言查询过去的会话历史，比如"上次我们怎么实现的认证模块？"

🖥️ Web 可视化 — 自带 Web 界面（localhost:37777），实时查看记忆流

🔒 隐私控制 — 用 <private> 标签标记敏感内容，不会被存储

🤖 全自动 — 安装后无需任何手动操作，默默在后台工作

安装方法

三种方式，任选其一：

方式一：npx 一行命令（推荐）

npx claude-mem install

方式二：Claude Code 插件市场

在 Claude Code 会话中输入：

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

方式三：支持 Gemini CLI 和 OpenCode

# Gemini CLInpx claude-mem install --ide gemini-cli# OpenCodenpx claude-mem install --ide opencode

安装完成后重启 Claude Code 即可。就这么简单。

⚠️ 注意：npm install -g claude-mem 安装的只是 SDK 库，不会注册插件钩子。务必用 npx claude-mem install 安装。

系统要求

• Node.js >= 18.0.0
• Claude Code 最新版（支持插件）
• Bun（缺失会自动安装）
• SQLite 3（内置）

它是怎么工作的？

Claude-Mem 的架构设计很精巧，核心由几个部分组成：

1. 生命周期钩子（Hooks）

它注册了 5 个生命周期钩子：SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd。在会话的每个关键节点自动捕获信息。

2. Worker 服务

一个运行在 37777 端口的 HTTP 服务，提供 10 个搜索端点和 Web 查看器界面，由 Bun 管理。

3. SQLite + Chroma 双存储

SQLite 存储会话、观察记录和摘要；Chroma 向量数据库提供语义搜索能力，实现混合检索。

4. 渐进式披露策略

不是把所有历史上下文一次性塞给 Claude，而是分三层：

• 第一层：搜索索引（~50-100 tokens/条）
• 第二层：时间线上下文
• 第三层：完整详情（~500-1000 tokens/条）

先粗筛再细选，节省约 10 倍 Token 消耗。

实战案例

案例一：跨会话 Bug 追踪

周一你和 Claude 修了一个认证 Bug，周三开新会话时问：

"我们之前修过认证相关的 Bug 吗？"

Claude-Mem 会自动搜索历史记录，找到那次会话的关键决策和修复方案，Claude 直接接上上下文继续工作。

案例二：项目架构回顾

新成员加入项目，或者你自己隔了一段时间回来：

"这个项目的数据库是怎么设计的？"

Claude-Mem 会检索所有相关的架构决策记录，给出完整的上下文，包括当初为什么选择 SQLite、表结构设计的考量等。

案例三：文件变更追踪

"worker-service.ts 最近改了什么？"

搜索工具会列出所有涉及该文件的观察记录，包括修改原因、关联的 Bug 修复和功能迭代。

配置与自定义

配置文件在 ~/.claude-mem/settings.json，首次运行自动创建。

切换中文模式：

{  "CLAUDE_MEM_MODE": "code--zh"}

内置支持 code（英文）、code--zh（简体中文）、code--ja（日文）三种模式。

隐私保护：

在对话中用 <private> 标签包裹敏感信息：

<private>这里的密码是 xxx</private>

标记的内容不会被存储到记忆库中。

为什么它这么火？

Claude-Mem 的核心价值在于它解决了一个真实的、普遍的痛点：AI 编程助手的上下文断裂。

每次新开会话都要重复解释一遍项目背景，这不仅浪费时间，还容易遗漏关键信息。Claude-Mem 通过自动化的记忆捕获和智能的上下文注入，让 AI 真正成为你的"编程搭档"而不是"每次都要重新认识的陌生人"。

再加上它完全开源（Apache 2.0 协议）、安装简单、全自动运行，几乎没有使用门槛。