Claude-Mem
为编码代理保留跨会话、可检索的项目记忆。
- Star 数
- ★ 113k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 73/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude CodeClaude.ai（部分支持）
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 维护长期代码库的开发者，希望新会话能找回此前排查过的认证问题和修改背景。
- 不适合
- 需要免除 Node.js、Bun 和 uv 运行依赖的团队
- 需要与 Claude Code 同等详尽的其他代理集成文档的用户
- 无法规范标记敏感工具使用记录的团队
- 源码审查
- 73/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Claude-Mem 是面向 Claude Code 的持久化记忆压缩系统，也在仓库描述中列为支持 Codex、OpenCode 等代理环境。它通过生命周期钩子捕获会话中的工具使用观察，生成语义摘要，并在后续会话中注入相关上下文。系统由 Bun 管理的本地 Worker Service、SQLite 数据库、Chroma 向量数据库、Web Viewer 和 mem-search Skill 组成。Worker 提供本地 HTTP API、搜索端点及实时记忆流界面；SQLite 保存会话、观察和摘要。它适合需要在多次编码会话间延续项目知识的用户，但其完整安装流程主要围绕 Claude Code 插件设计。
Claude-Mem 在 SessionStart、UserPromptSubmit、PostToolUse、Stop 和 SessionEnd 生命周期中运行钩子脚本，收集代理的工具使用观察并生成语义摘要。它将会话、观察和摘要写入 SQLite，并以 Chroma 向量数据库结合关键词检索进行混合搜索。后续会话可获得注入的相关上下文；也可通过 MCP 的 search 先取得精简索引、用 timeline 查看某条观察附近的时间线，再以 get_observations(ids=[...]) 批量取回完整观察内容。Worker Service 由 Bun 管理，提供本地 HTTP API、搜索端点和 Web Viewer；<private> 标签可排除敏感内容的存储。
- 使用 Claude Code 维护长期代码库的开发者，希望新会话能找回此前排查过的认证问题和修改背景。
- 在多轮调试中频繁调用工具的工程师，需要先搜索历史观察，再按 ID 取回少量完整细节以控制上下文开销。
- 使用 OpenCode 的开发者，希望通过
npx claude-mem install --ide opencode为编码会话增加持久记忆。 - 运行 OpenClaw Gateway 的团队，需要安装持久记忆插件，并可选将实时观察流接入 Telegram、Discord 或 Slack。
- 需要本地查看项目记忆流、会话、观察和摘要的技术负责人，可使用 Worker 的 Web Viewer 与本地 API。
如何安装或部署这个 Agent？
Claude Code 的安装命令为：npx claude-mem install。随后重启 Claude Code；仓库说明指出，之后的新会话会自动出现此前会话的上下文。OpenCode 使用：npx claude-mem install --ide opencode；Antigravity CLI 使用：npx claude-mem install --ide antigravity。也可在 Claude Code 中执行 /plugin marketplace add thedotmack/claude-mem，再执行 /plugin install claude-mem。需要 Node.js 20.0.0 或更高版本；Bun 和 uv 缺失时会自动安装，SQLite 3 随系统使用。仓库未说明安装所需的 API 密钥或凭证。
如何使用这个 Agent？
安装并重启后，Claude-Mem 会自动运行，无需手动触发记录。可编辑 ~/.claude-mem/settings.json 调整 AI 模型、Worker 端口、数据目录、日志级别和上下文注入设置；例如设置 {"CLAUDE_MEM_MODE":"code--zh"} 后重启 Claude Code，可启用简体中文模式。检索时按渐进披露流程依次使用 search(query="authentication bug", type="bugfix", limit=10)、timeline 和 get_observations(ids=[123,456])。将不应保存的内容包在 <private> 标签中。
这个 Agent 有哪些优点和局限？
- 用生命周期钩子自动捕获工具使用观察，并在未来会话中注入相关上下文，减少人工整理记忆的步骤。
- 提供 SQLite 全文存储与 Chroma 语义检索的混合搜索，并以
search、timeline、get_observations分层取数。 - 本地 Worker 同时提供 HTTP API、搜索端点和 Web Viewer，方便以界面或程序方式检查记忆。
- 支持
<private>标签排除敏感内容存储，并提供上下文注入的细粒度配置。
- 完整的文档化安装和生命周期钩子流程以 Claude Code 插件为中心；其他列出的代理环境在所给材料中缺少同等详细的接入步骤。
- 需要 Node.js 20+，并依赖 Bun、uv、SQLite 3 与 Chroma 向量数据库，运行环境比单纯 CLI 工具更复杂。
- 系统会记录工具使用观察和会话摘要；虽可用
<private>排除内容，采用前仍需制定敏感信息标记规范。 npm install -g claude-mem仅安装 SDK/库，不会注册插件钩子或配置 Worker，部署方式容易被误用。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude-Mem 当前 | 73 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 113k | 今天 | TypeScript | Codex · Claude Code |
| Ori Mnemos | 80 · 表现良好 | 命令行工具免费 | ★ 335 | 1 个月前 | TypeScript | Claude Code · OpenAI API · Claude API |
| Claudex | 69 · 存在缺口 | 命令行工具免费 | ★ 97 | 4 个月前 | JavaScript | Claude Code |
| PowerContext | 55 · 缺口较多 | 命令行工具免费 | ★ 1.5k | 1 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：SECURITY.md 明确声明默认绑定 127.0.0.1、端口范围校验、无 root 权限、数据本地存储，并详细说明数据流向（包括发送给上游模型提供商）。扣分：用户确认机制薄弱，仅提及 <private> 标签，未说明安装或操作时的明确用户同意；回滚机制未明确说明，仅提及版本更新。
证据显示：CI 工作流包含类型检查、构建、测试、捆绑大小保护，以及针对服务器运行时的 Docker e2e 测试；测试覆盖多个适配器和安全回归。扣分：依赖可用性未完全验证，因为未提交根锁文件，依赖安装使用 npm install 而非 npm ci；失败消息未在文档中详细说明，仅提及故障排除指南。
证据显示：README 支持多种 IDE（Claude Code、OpenCode、Antigravity CLI、OpenClaw），提供多种安装方式，并支持多种语言模式。扣分：能力边界未明确说明，例如哪些操作被捕获、哪些被排除；触发精度未详细说明，仅提及生命周期钩子。
证据显示：README 结构清晰，包含快速入门、文档链接、配置、故障排除；提供多种语言的翻译；许可证为 Apache-2.0，并附有完整 LICENSE 文件；版本号在 package.json 中明确。扣分：已知限制未明确列出，仅提及故障排除；变更日志未在提供的文件中显示，但 README 中提及 CHANGELOG.md。
证据显示：输出可用性高，提供 MCP 搜索工具、Web 查看器 UI、技能；边际价值高，提供跨会话持久记忆、渐进式披露、约 10 倍令牌节省；成本效益未量化，但提及令牌节省。扣分：成本效益未提供具体数据，仅声称节省。
证据显示：README 中的声明与 SECURITY.md 和 package.json 中的信息一致；测试文件验证了特定行为（如 bun-runner 回归、BMP 安全）；但未提供外部来源的佐证。扣分：事实与推断未明确分离，例如 README 中的性能声明未提供基准测试。
- 该工具会捕获所有会话数据并发送给上游模型提供商，使用前应审查设置和隐私标签。
- 安装脚本会修改 Claude Code 配置并启动后台 worker 服务，请确保信任来源。
- 未验证发布者身份，建议从官方渠道获取并验证校验和。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
What's new Onboarding finds your existing work. Setup now leads with discovering your existing work, rules and focus from your transcripts. The main button is "Discover My Work, Rules & Focus", and "Skip this step" is a smaller action under it. The "Share anonymous usage statistics to help improve your Claude-mem experience" box starts checked; unchecking it is kept, and nothing is sent until you press Discover. When hosted setup is busy, claude-mem checks capacity before uploading, remembers the cooldown across restarts and lets you finish setup. (#5270, #5308, #5384 by @thedotmack) …在 GitHub 查看 ↗ -
发布说明摘录
What's new Devin support. npx claude-mem install can now set up Devin CLI and Devin Desktop: hooks are written for you, Devin's tool names are understood, and the memory search tools are registered. (#5172, #5276 by @patrickballard and @ssthormess) My Work refresh on your terms. My Work and Past Focus have a "Refresh now" button (#5249 by @Kirat0201). New settings choose the refresh model per provider: CLAUDE_MEM_WORK_VIEW_CLAUDE_MODEL, CLAUDE_MEM_WORK_VIEW_CODEX_MODEL and CLAUDE_MEM_WORK_VIEW_GEMINI_MODEL (#5236 by @LucianVane). …在 GitHub 查看 ↗ -
发布说明摘录
Privacy fix Browser setup no longer uploads your prompts to cmem.ai without asking. Fixes #5176. The browser setup opened by npx claude-mem install (since v15.2.0) scanned local agent histories and uploaded the full text of the last 30 days of prompts, with session IDs, project names, folder paths and timestamps, without asking. What changed (#5220) - The scan now reads local history only, then stops and asks. Nothing leaves the machine until you answer. - A new consent panel states what is sent and lists each detected tool with its prompt count. Only ticked tools are uploaded. …在 GitHub 查看 ↗
常见问题
它会把所有内容都保存下来吗？
<private> 标签排除敏感内容的存储；其他工具使用观察、会话和摘要会写入本地记忆系统。检索完整历史会消耗很多上下文吗？
search 获取约 50–100 token/结果的索引，再只对筛选出的 ID 调用 get_observations 获取约 500–1,000 token/结果的详情。全局安装 npm 包是否足够？
npm install -g claude-mem 只安装 SDK/库；要注册插件钩子并设置 Worker，应使用 npx claude-mem install 或 Claude Code 的插件命令。能否使用中文生成观察？
~/.claude-mem/settings.json 中的 CLAUDE_MEM_MODE 设为 code--zh，然后重启 Claude Code。