Claude-Mem：让 AI 编码助手拥有长期记忆

维多利亚少年-

465人浏览 · 2026-05-09 09:54:46

维多利亚少年- · 2026-05-09 09:54:46 发布

一句话定位：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 驱动