适合谁
- 在长期项目中使用 Claude Code（或其他受支持智能体）、希望获得跨会话持久记忆的开发者
- 希望自动获得工具使用摘要、免于手动记笔记的团队
C
50FMRS · D
claude-mem 是一个功能明确、文档详尽的开源记忆压缩系统，核心面向 Claude Code，通过钩子捕获、AI 摘要和 3 层 MCP 检索工具（search/timeline/get_observations）实现跨会话记忆，同时提供本地 SQLite 存储和可选云同步。使用时需注意其本地 HTTP 服务、默认全量记录行为，以及与官方软件无关的第三方代币信息。
claude-mem 是一个开源（Apache-2.0）记忆压缩系统，主要面向 Claude Code。它通过 5 个生命周期钩子自动捕获智能体在会话中的工具使用记录，用 AI 将其压缩为语义摘要，存入本地 SQLite 数据库，并在未来会话开始时把相关上下文重新注入对话。系统由本地 Bun 工作进程提供 HTTP API 和网页查看器，并使用 Chroma 向量数据库实现语义+关键词混合检索。除 Claude Code 外，作者还提供了适用于 OpenCode 和 OpenClaw 网关的安装方式，并声称与 Codex、Gemini、Hermes、Copilot 等智能体也能配合使用，但相关安装细节未在文档中给出。
工具能力
search
对记忆索引进行全文检索，可按类型、日期、项目过滤，返回精简的结果索引（每条约 50-100 个 token），用于三层检索流程的第一步。
timeline
获取某个观察记录或查询结果周围的时间线上下文，了解当时发生了什么。
get_observations
根据 ID 获取观察记录的完整详情（建议批量传入多个 ID 以提升效率），是三层流程中信息量最大、token 消耗最高的一步。
安装接入
运行 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 一键安装。
选型与风险
不适合谁
- 不希望智能体活动被默认记录和本地存储、且不打算使用 <private> 标签排除敏感内容的隐私敏感场景
- 只进行一次性、单会话任务、不需要跨会话上下文的用户
- 不允许安装后台工作进程（Bun）和 Python 包管理器（uv）的受限环境
所需权限
- 本地文件系统读写权限，用于会话日志、SQLite 数据库及配置文件（~/.claude-mem）
- 运行和管理后台工作进程（Bun）以及 Python 包管理器（uv）的权限
- 网络访问权限，用于 AI 摘要压缩调用以及可选的 cmem.ai 云同步
- 访问 Claude Code（或其他智能体）生命周期钩子和工具使用记录，以捕获观察内容
风险与副作用
- 默认会捕获并存储智能体会话中的所有工具使用活动，敏感内容需手动用 <private> 标签排除
- 在本地运行带网页查看器的 HTTP 工作服务，会在本机/局域网内暴露已存储的记忆数据
- 可选的云同步功能会将记忆数据发送至第三方服务 cmem.ai
- 若缺少 Bun、uv 等运行时会自动安装，扩大了信任和供应链风险面
- 该项目关联一个第三方发行的加密代币（CMEM），这并非核心软件的一部分，属于需要留意的额外金融风险，而非代码本身存在恶意的证据
常见排障
- 安装完成或修改 CLAUDE_MEM_MODE 后需重启 Claude Code 使配置生效
- 确认 Node.js 版本 ≥ 20，以及 Bun、uv 已安装（缺失时会自动安装）
- 确认工作服务正在运行，启动时会打印网页查看器地址
- 检查 ~/.claude-mem/settings.json 中的 AI 模型、端口、日志级别等配置
- 向 Claude 描述问题即可触发内置的 troubleshoot 技能进行自动诊断
- 在插件市场目录下运行 `npm run bug-report` 生成详细的错误报告
使用场景
在 Claude Code 新会话开始时自动恢复此前项目的上下文
用自然语言检索过去编码会话中的决策、修复记录或调试过程
在跨越多个会话的长期项目中保持知识连续性
支持客户端
Claude Code完整支持
OpenCode完整支持
OpenClaw完整支持
Codex部分支持
Gemini部分支持
GitHub Copilot部分支持