Claude-Mem
为编码代理保留跨会话、可检索的项目记忆。
按维度查看评分与理由
证据显示：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 服务，请确保信任来源。
- 未验证发布者身份，建议从官方渠道获取并验证校验和。
这个 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 有哪些优点和局限？
- 用生命周期钩子自动捕获工具使用观察，并在未来会话中注入相关上下文，减少人工整理记忆的步骤。
- 提供 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？
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> 标签中。
常见问题
它会把所有内容都保存下来吗？
<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。