​一句话定位​：Claude-Mem 是一款开源的 AI 编码助手持久化记忆插件，安装后全自动运行，让 Claude Code / Codex CLI / OpenCode 等工具跨会话记住你的编码历史。

项目信息

GitHub	thedotmack/claude-mem
Stars	⭐ 46.1K+
版本	v12.0.0（持续活跃更新）
协议	Apache-2.0
作者	Alex Newman (@thedotmack)
支持平台	Claude Code / Codex CLI / OpenCode / Cursor / Gemini CLI / Windsurf / OpenClaw

解决什么痛点

AI 编码助手（Claude Code / Codex / OpenCode）每次新开会话都是「失忆」状态——忘记项目结构、技术决策、昨天调了半天的 bug。开发者被迫反复解释上下文，或者手动维护 CLAUDE.md / AGENTS.md 文件。

claude-mem 的解决方式：全自动捕获 → ​AI​​​ 压缩 → 持久化存储 → 按需注入​，把每次会话从「冷启动」变成「热恢复」。

关键技术点

5 个生命周期​钩子

• SessionStart
• UserPromptSubmit
• PostToolUse
• Stop
• SessionEnd

每次 tool call 自动记录，零手动干预

​三层渐进式披露​**（核心创新）**

• Layer 1: search → 紧凑索引（~50-100 tokens/条）
• Layer 2: timeline → 时间线上下文
• Layer 3: get_observations → 按需拉取全量

≈ 10x ​token​​ 节省

AI​ 压缩引擎

使用 Claude Agent SDK 将长对话压缩为语义摘要，存入本地 SQLite + FTS5 全文检索

本地向量数据库

Chroma + all-MiniLM-L6-v2 (ONNX)，不走外部 API，语义+关键词混合检索

支持的 IDE / CLI 工具

工具	安装命令	说明
Claude Code	npx claude-mem install	原生插件支持，体验最佳
Codex CLI	npx claude-mem install --ide codex	OpenAI Codex CLI 完整支持，通过 MCP Server 接入
OpenCode	npx claude-mem install --ide opencode	开源编码 Agent 完整支持
Gemini CLI	npx claude-mem install --ide gemini-cli	Google Gemini CLI 支持
Cursor	npx claude-mem install --ide cursor	通过 MCP 协议接入
Windsurf	npx claude-mem install --ide windsurf	通过 MCP 协议接入
OpenClaw Gateway	curl -fsSL https://install.cmem.ai/openclaw.sh | bash	一键脚本集成

​跨平台​：Linux / macOS / Windows 全平台支持​跨 ​IDE​：一套记忆，多个工具共享——你在 Claude Code 里的编码记忆，用 Codex 或 OpenCode 时也能访问到

关键特性

自动化

• ✅ 全自动运行，零手动干预
• ✅ 自动生成/更新 CLAUDE.md 文件
• ✅ 自动压缩长对话为语义摘要

隐私 & 安全

• ✅ 数据全部本地存储
• ✅ <private> 标签排除敏感内容
• ✅ 不上传任何第三方服务

高级功能

• ✅ 多机同步（claude-mem-sync，SSH）
• ✅ Beta: Endless Mode（仿生记忆架构）
• ✅ 多语言（code–zh 中文模式内置）
• ✅ 引用系统（可追溯历史记录）
• ✅ Web Viewer UI（localhost:37777）

实际收益

指标	效果	说明
重复上下文输入	-95%	不用每次重新解释项目
Context limit 命中率	-80%	压缩摘要代替原始对话
每日有效 tool calls	+20x	同样 context 做更多事
跨会话任务恢复时间	5-30min → <10s	自动注入历史上下文
API 费用（长项目）	省 40-60%

为什么需要它？Session 不够吗？

​原生 Session（短期记忆 = ​RAM​**）**

• ✅ 单次会话内有记忆
• ❌ 会话结束 → 全部丢失
• ❌ 新开 terminal → 啥都不记得
• ❌ Context window 200K → 长会话撞墙

claude-mem（长期记忆 = 硬盘+索引）

• ✅ 跨会话：今天记得昨天做了什么
• ✅ 跨项目：A 项目的经验 B 项目能用
• ✅ 突破 context：只注入压缩摘要
• ✅ 持久化：重启/换设备，记忆还在

安装指南（3 分钟搞定）

前置条件

• Node.js 18+（推荐 20+）

安装步骤

Claude Code​ 用户：

npx claude-mem install

Codex​ ​​CLI​ 用户：

npx claude-mem install --ide codex

OpenCode​ 用户：

npx claude-mem install --ide opencode

​或通过插件市场（Claude Code​**）：**

/plugin marketplace add thedotmack/claude-mem

验证安装

npx claude-mem status

看到 Worker running + hooks registered 就说明生效了。

安装完成后重启你的 IDE / CLI 工具即可。日常使用​完全无感​，不需要任何手动操作。

日常使用

正常写代码即可，claude-mem 在后台自动运行。

可选的手动操作（一般用不到）：

命令	作用
/memory search <关键词>	主动搜索历史记忆
/memory stats	查看记忆统计
/memory forget	删除某条记忆
浏览器localhost:37777	可视化查看全部记忆

竞品对比

方案	定位	存储	自动化程度
claude-mem	编码会话记忆	本地 SQLite + 向量	全自动
CLAUDE.md	项目上下文	静态文件	手动维护
Context Mode	上下文管理	文件	半自动
mem0	通用 Agent 记忆	云/本地	API 驱动
Zep	对话记忆	云端	API 驱动

注意事项

• 每次 tool call 会消耗少量 API token 做压缩（远小于省下的重复 token）
• 首次安装后第一次会话会稍慢（初始化向量数据库）
• 项目方发了 Solana 代币（$CMEM），社区偏 crypto 炒作向——技术归技术，token​​ 归 token，保持警觉

总结

​推荐给​：日常用 Claude Code / Codex CLI / OpenCode 写代码

​核心价值​：让 AI 编码助手拥有跨会话的长期记忆，消灭重复解释成本，省 token 省钱

​安装成本​：一行命令，3 分钟搞定，之后全自动运行