核心信息
Claude-Mem 是 AI 编程代理的持久化上下文记忆压缩系统（76.3k Stars），自动捕获代理在会话中的所有行为，用 AI 压缩后注入到未来会话中，兼容 Claude Code、OpenClaw、Codex、Gemini CLI 等主流代理。
- 作者：Alex Newman（@thedotmack）
- Stars：76.3k
- Forks：6.5k
- 许可证：Apache-2.0
- 版本：v13.2.0（2026-05-12，270 个 Release，1899 commits）
- 技术栈：TypeScript 91.5%（Node.js ≥18, Bun, SQLite, Chroma 向量库）
- 官网：https://claude-mem.ai
核心功能
| 功能 | 说明 |
|---|---|
| 持久化记忆 | 会话间上下文自动保留，无需手动干预 |
| 渐进式披露 | 分层记忆检索，带 token 成本可见性 |
| MCP 搜索工具 | 4 个工具（search/timeline/get_observations），三层工作流，~10 倍 token 节省 |
| Web 查看器 | http://localhost:37777 实时记忆流 UI |
| 隐私控制 | <private> 标签排除敏感内容 |
| 引用系统 | 每条观察分配 ID，可单独检索 |
| Endless Mode | Beta 实验性仿生记忆架构 |
| 多语言模式 | code、code—zh、code—ja 等 |
技术架构
| 组件 | 说明 |
|---|---|
| 5 个生命周期 Hook | SessionStart → UserPromptSubmit → PostToolUse → Stop → SessionEnd |
| Worker 服务 | HTTP API 端口 37777，Bun 管理 |
| 存储引擎 | SQLite (FTS5 全文搜索) + Chroma 向量数据库（混合语义/关键词搜索） |
| mem-search 技能 | 自然语言查询 + 渐进式披露 |
记忆工作流
SessionStart → 注入相关记忆
UserPromptSubmit → 捕获用户输入
PostToolUse → 记录工具调用和结果
Stop → 压缩当前上下文为观察
SessionEnd → 持久化存储
安装方式
npx claude-mem install # 一键安装
npx claude-mem install --ide gemini-cli # Gemini CLI或 Claude Code 插件市场：/plugin marketplace add thedotmack/claude-mem
关联连接
- Claude_Mem — 项目实体页面
- Agent_Memory — 四层记忆架构（claude-mem 是跨会话持久化记忆的工程实现）
- MemOS — 同为 AI 记忆系统（claude-mem 专注编码代理上下文压缩，MemOS 通用记忆 OS）
- Context_Engineering — claude-mem 的核心是上下文工程范式
- Agentic_Systems — 记忆是智能体的核心组件