claude-mem：让Claude Code拥有跨会话记忆的开源工具安装教程

Claude Code 每次开新会话都会”失忆”——之前的对话上下文、项目决策、踩过的坑全部归零。claude-mem 是一个开源工具，专门解决这个问题：它自动记录你和Claude Code的交互，生成语义摘要，并在后续会话中智能注入相关上下文。

claude-mem是什么？

claude-mem（v6.5.0）是一个持久记忆压缩系统，由 Alex Newman 开发。它通过5个生命周期钩子（SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd）自动捕获Claude Code的操作记录，存入SQLite数据库，并通过Chroma向量数据库提供语义搜索。

项目地址：github.com/thedotmack/claude-mem

安装方法

方法一：npx一键安装（推荐）

npx claude-mem install

这条命令会自动下载claude-mem，配置Claude Code的钩子脚本，安装Bun运行时，并启动Worker服务。整个过程通常在1-2分钟内完成。

方法二：通过Claude Code插件市场

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

方法三：支持其他IDE

# Gemini CLI
npx claude-mem install --ide gemini-cli

# OpenCode
npx claude-mem install --ide opencode

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

系统要求

Node.js ≥ 18.0.0
Claude Code（最新版）
Bun（自动安装）
SQLite 3（内置）

核心功能

1. 自动持久记忆

claude-mem在你使用Claude Code时自动工作，不需要手动操作。每次会话的工具调用、代码修改、文件操作都会被记录为”观察”（observation），存入本地SQLite数据库。

2. 渐进式上下文注入

新会话启动时，claude-mem不会把所有历史记录塞进去（那样token成本太高）。它使用3层MCP搜索工作流：

search层：紧凑索引，每条结果约50-100 tokens
timeline层：按时间线排列的上下文
get_observations层：完整详情，每条约500-1000 tokens

这种设计比直接注入原始记录节省约10倍的token。

3. 语义搜索

通过内置的Chroma向量数据库，你可以用自然语言查询历史记录：

“上次那个Docker配置问题是怎么解决的？”
“之前讨论过的数据库迁移方案”
“项目中用到的认证中间件”

4. Web查看器

claude-mem自带一个Web界面，运行在 http://localhost:37777，可以实时查看记忆流、搜索历史记录、管理观察数据。

5. 隐私控制

不希望某些内容被记录？用 <private> 标签包裹敏感信息，claude-mem会自动跳过这些内容。

配置

配置文件位于 ~/.claude-mem/settings.json。支持多种语言模式：

code：英文模式
code--zh：简体中文模式
code--ja：日文模式

也可以通过环境变量设置：CLAUDE_MEM_MODE=code--zh

MCP搜索工具

安装后，Claude Code会获得3个新的MCP工具：

search：全文搜索记忆索引，支持按类型/日期/项目过滤
timeline：获取某个观察或查询的时间线上下文
get_observations：通过ID批量获取完整观察详情

使用体验

安装后基本不需要干预。claude-mem在后台自动运行，当你开启新会话时，它会自动注入相关的历史上下文。随着使用时间增长，记忆库越来越丰富，Claude Code对你项目的理解也会越来越深入。

特别适合以下场景：

长期维护的项目，需要跨多天/多周的上下文连续性
团队协作，新成员可以快速获取项目历史决策
复杂调试过程，需要回顾之前的排查步骤

简评

claude-mem解决了AI编程助手的一个核心痛点——上下文丢失。安装简单、自动运行、token成本控制得当。如果你每天都在用Claude Code，这个工具值得一装。不过要注意，记忆库越大，首次加载的延迟可能越长，建议定期清理过时的观察记录。

来源：
claude-mem GitHub仓库

文章版权声明 1、本网站名称：枫选
2、本站永久网址：https://feng.cx
3、本网站的文章部分内容可能来源于网络，仅供大家学习与参考，如有侵权，请联系站长进行删除处理。
4、本站一切资源不代表本站立场，并不代表本站赞同其观点和对其真实性负责。
5、本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
6、本站资源大多存储在云盘，如发现链接失效，请联系我们我们会第一时间更新。

THE END