claude-mem 是由开发者 thedotmack 主导、托管于 GitHub（https://github.com/thedotmack/claude-mem）的持久记忆压缩系统，专为 Claude Code 编程辅助工具设计，核心目标是解决会话间上下文丢失、重复解释的痛点，实现跨会话知识连续性。
核心定位与原理
● 自动捕获 Claude Code 的工具使用、用户交互、代码修改等“观察”，通过 Claude Agent SDK 生成语义摘要，存储到 SQLite（持久）+ ChromaDB（向量检索）；
● 下次会话启动时，按相关性自动注入历史上下文，支持分层检索与语义搜索，兼顾效率与隐私。
关键功能
| 功能 | 说明 |
| 持久跨会话记忆 | 会话结束/重连后，项目知识不丢失，执行 /clear 也保留核心记忆 |
| 渐进式披露 | 分层检索（索引→详情→原始记录），显示令牌成本，降低消耗 |
| 技能化搜索 | mem-search 自然语言查项目历史，约省 2250 个 token |
| Web 查看器 | http://localhost:37777 实时查看记忆流、过滤项目 |
| 隐私控制 | <private> 标签排除敏感内容存储，本地存储不联网 |
| 桌面技能集成 | Claude 桌面对话中直接调用记忆搜索 |
| 引用与配置 | 按 ID 引用历史观察，细粒度控制上下文注入 |
| Beta 功能 | 如 Endless Mode 等实验性能力 |
安装与使用
1. 一键安装（Node.js 环境）：
npm install -g claude-mem && claude-mem install2. 启动后自动运行 Worker 服务（默认端口 37777），无需额外配置；
3. 在 Claude Code 中直接使用 mem-search 技能或通过 Web UI 管理记忆。
技术架构与授权
● 核心组件：ChromaDB（向量存储）、SQLite（持久存储）、Claude Agent SDK（摘要生成）、Worker 服务（钩子监听/注入）；
● 授权：免费永久使用（Free-to-use forever），本地存储保障隐私；代码为构建后的 JS 包（非完全开源，作者计划后续添加增值功能）。
适用场景与价值
● 适用：长期多会话的项目开发、跨设备协作、需要历史知识沉淀的 AI 辅助编程；
● 价值：减少重复解释、降低令牌消耗、提升 Claude 对项目的理解连续性，尤其适合企业/团队长期项目。
注意事项
● 依赖 Claude Code 运行，需确保插件版本与 Claude Code 兼容；
● 本地存储路径：~/.claude-mem/，可备份/迁移；
● 存在少量已知 bug（如特定版本钩子不触发、内存泄漏等），可关注 GitHub Issues 获取修复更新。
需要我帮你整理一份快速上手指南（含常用命令、隐私配置、版本升级与问题排查）吗？