1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | claude-mem |
| 作者/维护者 | thedotmack（GitHub 个人开发者） |
| 来源链接 | https://github.com/thedotmack/claude-mem |
| 许可证 | Apache License 2.0（来自 GitHub API） |
| GitHub Stars | 87,125（来自 GitHub API，认证取数） |
| Forks | 7,537（来自 GitHub API） |
| 最新版本 | v13.11.0，发布于 2026-07-13（来自 GitHub Releases API，累计 297 个版本） |
| 安装方式 | npx claude-mem install，或 Claude Code 内 /plugin marketplace add thedotmack/claude-mem |
2. 功能介绍与亮点
claude-mem 是一套面向 AI coding agent 的持久记忆系统：通过 5 个生命周期钩子（SessionStart / UserPromptSubmit / PostToolUse / Stop / SessionEnd）自动捕获会话中的工具调用与操作过程，用 AI 压缩成语义摘要，存入本地 SQLite（含 FTS5 全文检索）与 Chroma 向量库，并在后续会话中按需检索、注入相关上下文——让 agent “记住”之前做过的事，无需每次重新解释项目背景。
核心亮点：
- 本地优先：核心功能全程本地运行，无需外部 API Key；云同步（cmem.ai）为可选项，且明确说明“写入即同步、无常驻进程”
- 渐进式披露检索：搜索 → 时间线 → 详情三层加载，避免一次性把大量历史记忆塞进上下文
- 隐私控制：支持
<private>标签排除敏感内容不入库 - 多平台覆盖：仓库简介注明兼容 Claude Code、OpenClaw、Codex、Gemini、Hermes、Copilot、OpenCode 等多个 agent 生态
- 维护极其活跃：近一年内发布 297 个版本，最新版本发布于运行前一天
3. 适用场景
所属分类：元技能与 Agent 增强
适合频繁在多天/多会话间持续同一项目的开发者：每次打开 Claude Code 都要重新说明项目结构、历史决策、踩过的坑？claude-mem 把这些自动沉淀为可检索的记忆，尤其适合长周期项目维护者、需要多个 agent 共享项目上下文的团队、以及厌倦反复粘贴 CLAUDE.md 背景说明的初中级用户。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方主打场景，钩子机制与插件市场安装均围绕它设计，文档最完整
- OpenClaw：✅ 支持，仓库文档提及“专用安装器”对接 OpenClaw 网关
- Codex：仓库简介列为受支持平台之一，但抓取到的详细文档未展开具体接入机制，未验证细节，建议使用前自行确认
- Hermes Agent：仓库简介同样列为受支持平台，但同样缺乏细节材料，未验证
5. 推荐理由
在“元技能与 Agent 增强”这一类别里，claude-mem 是目前社区热度最高、增长最快的记忆类工具之一：8.7 万 star、7500+ fork，且维护频率极高（近乎每天有版本迭代）。它解决的是几乎所有长期使用 coding agent 的用户都会遇到的真实痛点——上下文丢失，而且默认本地运行、无强制外部依赖，安装门槛低，是本次运行中综合表现最突出的候选。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 10 | 87k+ stars 远超“≥5k“门槛，7500+ fork，多平台社区讨论广泛 |
| 可用性 | 8 | 一条命令安装，文档完整（docs.claude-mem.ai）；但依赖 Bun 运行时管理后台 worker 服务，比纯提示词类 skill 多一层环境要求 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.67 | 三项均值，达标（≥7.0），安全性未触发一票否决线（<6） |
安全检查清单：
① Shell 执行/权限范围：通过钩子在本地启动 worker 服务并读写 SQLite/向量库，范围明确、有官方文档说明，非任意命令执行
② 联网外发：默认本地运行不联网；云同步为可选项且文档明示同步时机，透明
③ API Key/凭据：核心功能无需强制 API Key；配置文件存于 ~/.claude-mem/settings.json，云同步才需 cmem.ai 账号
④ 可疑指令：抓取材料中未发现混淆代码或明显数据外发指令；但文档未明确说明如何防御“记忆内容被恶意注入后在未来会话中被当作可信上下文回放”这类风险，是一个可关注的薄弱点，非当前已发现的问题
⑤ 作者信誉：个人开发者账号，非官方机构，但项目规模与活跃度已获大量独立验证
⑥ License：Apache 2.0，明确、宽松
⑦ 维护时间：近一年 297 次发布，最新版本发布于运行前一天，维护极活跃
7. 跟同类 Skills 相比的优势
| 项目 | Stars | 定位 | 与 claude-mem 的差异 |
|---|---|---|---|
| claude-mem（本次推荐） | 87,125 | 会话级语义记忆压缩 + 检索 | 生态覆盖最广、维护最活跃、检索能力最完整（SQLite+向量混合） |
| planning-with-files（OthmanAdi） | 25,297 | 文件化任务规划，防止 /clear 丢失计划 | 定位是“计划”而非“记忆”，二者可互补而非替代 |
| claude-memory-compiler（coleam00） | 1,243 | 从会话中提炼结构化知识条目 | 依赖 Claude Agent SDK 做提炼，规模与维护活跃度远不及 claude-mem，且自 4 月发布后无进一步更新 |
| claude-code-memory-setup（lucasrosati） | 848 | Obsidian + 知识图谱式记忆 | 面向愿意接入 Obsidian 生态的用户，配置门槛更高 |
claude-mem 的差异化在于：开箱即用（无需额外接入 Obsidian 等第三方工具）、检索粒度更细（渐进式披露）、且是这几个同类项目中唯一保持高频版本迭代的。
8. 用户评价
本次已对 Reddit、Hacker News 发起 2 次专门抓取，均未定位到可独立验证、抓取成功的具体用户评价原文——搜索结果多为工具目录页与相关记忆方案的列表提及。据规则不凑数、不为凑数追加抓取，如实说明：本次未收集到足够的已验证用户评价。
9. 其他补充
项目文档站 docs.claude-mem.ai 提供多语言指南，覆盖安装、使用、架构、配置、开发与故障排查；GitHub topics 标注涉及 embeddings、RAG、Chroma、mem0 等技术栈，可见其记忆检索设计参考了当前主流的 RAG 方案。
10. 安装使用方式
- 命令行安装：
npx claude-mem install（自动注册钩子并配置本地 worker 服务） - Claude Code 插件市场：
/plugin marketplace add thedotmack/claude-mem - 注意事项：安装会启动一个由 Bun 管理的本地 worker 服务，并非“装完即走”，首次使用建议查看 docs.claude-mem.ai 的 Quickstart 确认服务已正常运行；如需在 OpenClaw 上使用，需按文档使用专用安装器
11. 注意事项
- 依赖 Bun 运行时维护后台 worker 服务，比纯文本类 skill 多一层环境依赖，初次配置需留意服务是否正常启动
- 项目由单一个人开发者维护，尽管当前活跃度很高，仍存在个人维护者项目常见的“巴士系数”风险
- 官方材料未明确说明针对“记忆内容被污染后在未来会话中被当作可信上下文”的防护机制，长期项目使用者可关注后续更新
- Codex、Hermes Agent 的具体兼容细节本次未获取到足够材料验证，建议实际接入前先小范围测试