thedotmack/claude-mem
⭐ 74,313 · TypeScript · GitHub 仓库
一个Claude Code插件，可自动记录您在编码会话中Claude的所有操作，利用AI（通过Claude的agent-sdk）进行压缩，并将相关上下文注入到未来的会话中。
ai ai-agents ai-memory anthropic artificial-intelligence chromadb claude claude-agent-sdk
一句话总结
为 Claude Code 提供自动、持久的记忆功能，能够在不同会话间捕获、压缩并注入上下文信息。
🔥 核心能力与独特卖点
自动上下文捕获与压缩 - 记录编码会话中的每一次工具调用和观察结果，并通过 Claude 的 agent-sdk 进行语义压缩。这解决了 AI 助手在会话间遗忘项目状态的核心痛点，无需再手动记笔记或重新构建上下文。
渐进式信息呈现 - 采用分层记忆检索策略，根据相关性和 Token 成本注入历史上下文。它不是将所有内容都塞入上下文窗口，而是智能地优先处理最相关的记忆，在保持会话连续性的同时高效利用 Token 预算。
基于技能语义搜索 -
mem-search技能允许你使用自然语言查询整个项目历史。由 Chroma 向量数据库和 SQLite FTS5 组成的混合搜索引擎驱动，将累积的会话历史转化为可搜索、可操作的知识库。实时 Web 查看器与 API - 在
http://localhost:37777提供实时记忆流，包含 10 个搜索端点并附带观察引用。你可以精确追溯每条记忆的来源，确保系统透明且可审计。多 IDE 与多平台支持 - 开箱即用支持 Claude Code、Gemini CLI 和 OpenCode，同时集成 OpenClaw 网关以及 Telegram、Discord 和 Slack 的通知推送。这是一个跨平台的记忆层，而非单一 IDE 的临时方案。
技术架构
| 组件 | 技术栈 | 作用 |
|---|---|---|
| 生命周期钩子 | 6 个 Shell 脚本（SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd） | 捕获编码会话中的所有事件 |
| 工作进程 | Bun 运行时，HTTP API 监听 37777 端口 | 提供 Web 查看器 UI 和搜索端点 |
| 本地存储 | 带 FTS5 的 SQLite | 本地记忆存储的全文搜索 |
| 向量搜索 | Chroma 向量数据库 | 用于相关性排序的混合语义搜索 |
| AI 压缩 | Claude agent-sdk | 从原始观察结果生成语义摘要 |
| 智能安装 | 缓存依赖检查器（预钩子脚本） | 通过依赖缓存实现高效安装 |
快速入门指南
# 将插件安装到 Claude Code
npx claude-mem install# 为 Gemini CLI 安装
npx claude-mem install --ide gemini-cli# 为 OpenCode 安装
npx claude-mem install --ide opencode# 备选方案：通过 Claude Code 插件市场安装
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem# 集成 OpenClaw 网关
curl -fsSL https://install.cmem.ai/openclaw.sh | bash优势、局限与适用场景
优势
- 完全自动化 - 安装后无需任何手动干预；记忆捕获和注入完全透明进行。
- 隐私控制 - 使用
<private>标签可排除敏感内容被捕获。 - 精细配置 - 精确控制每次会话注入多少上下文。
- 可追溯引用 - 每条记忆都包含观察 ID，支持完整的审计追踪。
- 多语言文档 - 社区广泛采用，入门门槛低。
局限
- 需要 Node.js >=18.0.0 - 不兼容较旧的运行时环境。
- 依赖外部 AI 服务 - 压缩功能依赖 Claude agent-sdk，无离线备用方案。
- Beta 功能尚不稳定 - 无限模式等高级功能可能存在稳定性问题。
- 本地资源消耗 - 工作进程监听 37777 端口，会占用 CPU 和内存。
不适合谁使用？
- 资源受限机器的开发者 - 工作进程和 Chroma 向量数据库的额外开销可能影响低配系统性能。
- 严格隔离或离线环境的团队 - AI 压缩步骤需要调用 Claude 的外部 API。
- 短会话工作流 - 如果编码会话通常不超过 5 分钟，安装配置的投入可能得不偿失。
- 高度敏感 IP 的项目 - 即使有
<private>标签，对外部 AI 服务的依赖也可能违反合规政策。
理想使用场景
- 长期、复杂项目 - 持续数周或数月的开发工作，上下文连续性可大幅减少重新构建上下文的时间。
- 多开发者代码库 - 新团队成员无需通读整个提交历史，即可从累积的项目记忆中受益。
- 研究与探索性编码 - 当需要数周后重新审视实验分支或调试会话时。
- CI/CD 与自动化工作流 - 配合 Discord/Slack/Telegram 的通知推送，实时监控 AI 代理活动。
社区与活跃度
GitHub 上 74,313 颗星 标志着巨大的社区认可和快速普及。这绝非小众实验——它是该平台上最受欢迎的 AI 代理工具之一。该项目维护活跃，最近更新于 2026 年 5 月 10 日，表明开发持续进行、功能不断迭代。从 chromadb 到 supermemory 的广泛主题标签显示，这是一个架构精良的项目，与更广泛的 AI 代理生态系统深度融合，而非孤立存在。凭借多语言文档和对三大主流编码助手（Claude Code、Gemini CLI、OpenCode）的支持，该项目在可访问性和跨平台兼容性上投入了大量精力。这股势头是真实存在的——这是一款能够改变团队对 AI 辅助开发认知的工具。