Claude Mem

社区

为 Claude Code 及其他智能体提供跨会话的持久记忆

分类: 开发工具第 258 / 438
Stars: ★ 111.9k 非常热门
运行环境: Node.js 20+ · Bun
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 1 天前
工具数: 3

50FMRS · D

claude-mem 是一个功能明确、文档详尽的开源记忆压缩系统，核心面向 Claude Code，通过钩子捕获、AI 摘要和 3 层 MCP 检索工具（search/timeline/get_observations）实现跨会话记忆，同时提供本地 SQLite 存储和可选云同步。使用时需注意其本地 HTTP 服务、默认全量记录行为，以及与官方软件无关的第三方代币信息。

最强项 · 文档质量 15/20 最弱项 · 安全与权限 5/20

可靠性

6/20

安全与权限

5/20

维护活跃度

14/20

文档质量

15/20

安装易用性

10/20

查看各项评分依据

可靠性 6/20: 未提供服务器清单（manifest not cached），README中也未展示任何CI工作流或测试证据。系统由多个组件构成（Worker服务由Bun管理、SQLite数据库、Chroma向量数据库、7个钩子脚本），复杂度较高，且Bun、uv等运行时依赖为“缺失时自动安装”，这类隐式安装步骤本身就是启动脆弱性的来源。README声称提供4个MCP工具但实际只描述了3个（search、timeline、get_observations），存在声明与实际描述不一致的迹象。由于缺乏可验证的执行证据（无CI、无测试文件、无MCP握手记录），按静态校准规则不能给出高于12的分数，因证据链条薄弱进一步扣分至6分。
安全与权限 5/20: 存在多重、叠加的数据边界与信任风险：(1) OpenClaw安装方式为`curl -fsSL ... | bash`，直接执行未经审查的远程脚本；(2) 声称“捕获代理会话期间的一切操作”，默认将工具调用内容发送给未明确说明提供商的“AI”进行压缩，隐私保护仅依赖用户手动添加`<private>`标签的选择退出机制，而非默认最小化采集；(3) “Cloud Sync”功能默认可将记忆数据同步至第三方域名cmem.ai，README未披露传输加密、留存策略或显式同意流程；(4) 自动安装额外运行时（Bun、uv）扩大了攻击面；(5) README末尾出现与项目功能无关的加密代币（CMEM，含链上合约地址）推广内容，虽不构成传统红线类别（如恶意软件、凭据窃取），但显著削弱了该项目的可信度评估基础。上述风险叠加、且缺乏最小权限说明与确认机制，故评为低分而非红线区间。
维护活跃度 14/20: 项目活跃迹象明显：版本号13.4.0、Apache-2.0许可证清晰、docs站点覆盖架构/配置/开发/故障排查等分层文档、发布分支策略（main/core-dev/community-edge）说明清楚、支持Discord与X官方账号、提供自动化bug报告生成脚本。但存在治理瑕疵：README未提及SECURITY.md或专门的安全响应渠道；开放issue数达358，显示存在较大未解决积压；末尾出现的第三方加密代币“官方背书”内容偏离软件工程范畴，对维护者判断力和项目聚焦度构成合理质疑。综合评为14分。
文档质量 15/20: 文档覆盖面广，包含安装、使用、搜索工具、云同步、上下文工程、架构（钩子、Worker服务、数据库、搜索架构）、配置与开发指南的分层链接，并提供30余种语言的README翻译及MCP工具调用的代码示例。但绝大部分详细文档托管在外部站点docs.claude-mem.ai，无法在本次静态审查中验证其准确性；README本身未披露具体的成本、速率限制、AI提供商选择或数据留存细节，也未提供可直接复制的MCP客户端配置JSON示例。因此评为15分，体现结构完整但存在未披露假设与验证缺口。
安装易用性 10/20: 提供多种安装路径（npx脚本、插件市场命令、OpenClaw一键curl安装、多IDE适配），覆盖面广。但依赖链较重：需要Node ≥20、Bun（自动安装）、uv（自动安装）、SQLite，多个运行时的隐式自动安装增加了实际部署中的不确定性和平台兼容性风险；未展示标准MCP客户端（如Claude Desktop）的command/args配置JSON示例。根据静态校准规则，在缺乏可验证执行证据的情况下setup分数不得超过15，结合安装步骤虽有文档但流程较为脆弱、依赖较多，评为10分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件连接数据库

适合谁

在长期项目中使用 Claude Code（或其他受支持智能体）、希望获得跨会话持久记忆的开发者
希望自动获得工具使用摘要、免于手动记笔记的团队

不适合谁

不希望智能体活动被默认记录和本地存储、且不打算使用 <private> 标签排除敏感内容的隐私敏感场景
只进行一次性、单会话任务、不需要跨会话上下文的用户
不允许安装后台工作进程（Bun）和 Python 包管理器（uv）的受限环境

所需权限

本地文件系统读写权限，用于会话日志、SQLite 数据库及配置文件（~/.claude-mem）
运行和管理后台工作进程（Bun）以及 Python 包管理器（uv）的权限
网络访问权限，用于 AI 摘要压缩调用以及可选的 cmem.ai 云同步
访问 Claude Code（或其他智能体）生命周期钩子和工具使用记录，以捕获观察内容

风险与副作用

默认会捕获并存储智能体会话中的所有工具使用活动，敏感内容需手动用 <private> 标签排除
在本地运行带网页查看器的 HTTP 工作服务，会在本机/局域网内暴露已存储的记忆数据
可选的云同步功能会将记忆数据发送至第三方服务 cmem.ai
若缺少 Bun、uv 等运行时会自动安装，扩大了信任和供应链风险面
该项目关联一个第三方发行的加密代币（CMEM），这并非核心软件的一部分，属于需要留意的额外金融风险，而非代码本身存在恶意的证据

安装接入

准备工作

运行环境：Node.js 20+ · Bun

其他可选配置项（1 个）

CLAUDE_MEM_MODE 可选在 ~/.claude-mem/settings. 中设置，控制工作流模式与生成观察的语言，例如 code--zh 为简体中文模式。

运行 npx claude-mem install 完成安装（OpenCode 用户使用 npx claude-mem install --ide opencode，Antigravity CLI 用户参考官方设置指南）；也可以在 Claude Code 内通过 /plugin marketplace add thedotmack/claude-mem 和 /plugin install claude-mem 从插件市场安装。安装完成后重启 Claude Code，之前会话的上下文会自动出现在新会话中。注意：npm install -g claude-mem 只安装 SDK/库本身，不会注册插件钩子或启动工作进程，官方明确建议使用上述安装方式。OpenClaw 网关用户可运行 curl -fsSL https://install.cmem.ai/openclaw.sh | bash 一键安装。

验证是否装好

运行 npx claude-mem install 并重启 Claude Code，然后询问“搜索我之前会话的记忆”；若 search 工具出现在工具列表并返回历史观察结果，则安装成功。

常见排障

安装完成或修改 CLAUDE_MEM_MODE 后需重启 Claude Code 使配置生效
确认 Node.js 版本 ≥ 20，以及 Bun、uv 已安装（缺失时会自动安装）
确认工作服务正在运行，启动时会打印网页查看器地址
检查 ~/.claude-mem/settings.json 中的 AI 模型、端口、日志级别等配置
向 Claude 描述问题即可触发内置的 troubleshoot 技能进行自动诊断
在插件市场目录下运行 `npm run bug-report` 生成详细的错误报告

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索我的记忆中关于 authentication bug 的记录
用 timeline 查看观察 #123 前后发生了什么
获取观察 #123 和 #456 的完整内容
搜索之前会话里 type 为 bugfix 的记录，限制 10 条

工具能力 3

search 只读

对记忆索引进行全文检索，可按类型、日期、项目过滤，返回精简的结果索引（每条约 50-100 个 token），用于三层检索流程的第一步。

timeline 只读

获取某个观察记录或查询结果周围的时间线上下文，了解当时发生了什么。

get_observations 只读

根据 ID 获取观察记录的完整详情（建议批量传入多个 ID 以提升效率），是三层流程中信息量最大、token 消耗最高的一步。

使用场景

在 Claude Code 新会话开始时自动恢复此前项目的上下文

用自然语言检索过去编码会话中的决策、修复记录或调试过程

在跨越多个会话的长期项目中保持知识连续性

支持客户端

Claude Code

OpenCode

OpenClaw

Codex部分支持

Gemini部分支持

GitHub Copilot部分支持

依据项目文档列出，未经本站实测。

详细介绍

claude-mem 是一个开源（Apache-2.0）记忆压缩系统，主要面向 Claude Code。它通过 5 个生命周期钩子自动捕获智能体在会话中的工具使用记录，用 AI 将其压缩为语义摘要，存入本地 SQLite 数据库，并在未来会话开始时把相关上下文重新注入对话。系统由本地 Bun 工作进程提供 HTTP API 和网页查看器，并使用 Chroma 向量数据库实现语义+关键词混合检索。除 Claude Code 外，作者还提供了适用于 OpenCode 和 OpenClaw 网关的安装方式，并声称与 Codex、Gemini、Hermes、Copilot 等智能体也能配合使用，但相关安装细节未在文档中给出。