AI 编程助手每次开新会话都会忘记上一个会话的项目上下文，这个「会话失忆」问题在长时间项目里尤其明显。开源项目 claude-mem 给出了一套系统化解法：自动记录助手会话中的操作，压缩成语义摘要存入本地数据库，并在下一次会话开始时把相关记忆重新注入。该项目目前在 GitHub 上拥有 92.8k stars，最新版本 v13.21.2 于 2026 年 8 月 31 日发布，作者是 Alex Newman（@thedotmack），采用 Apache-2.0 许可。

claude-mem 解决的问题

Claude Code 这类 AI 编程助手默认以会话为单位工作：新会话启动时，助手对项目背景的认知基本归零，开发者需要重新描述需求、重复交代约定。claude-mem 的目标是让上下文在会话之间存活——它不需要人工维护，全部自动运行。

工作原理：钩子采集、摘要压缩、按需注入

claude-mem 通过 5 个生命周期钩子（SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd）捕获会话中的工具调用与操作观察，交给 AI 生成语义摘要。摘要与原始记录存放在本地 SQLite 数据库（支持 FTS5 全文检索）和 Chroma 向量库中，由 Bun 驱动的 Worker Service 提供本地 HTTP API 和 Web 查看器。

下次会话启动时，记忆系统按相关性把历史上下文注入新会话，形成「采集 → 压缩 → 注入」的闭环。

检索设计：三层工作流，先看索引再取详情

记忆的取用遵循渐进式披露，由 3 个 MCP 工具配合完成：

  • search：先返回紧凑的检索索引，约 50–100 tokens/条；
  • timeline：查看某条结果周围的时间上下文；
  • get_observations：只对筛选出的 ID 拉取完整详情，约 500–1,000 tokens/条。

先过滤、后取详情的顺序，让每次检索省去大量无关 token 开销，官方口径约为 10 倍 token 节省。

安装与运行环境

安装只需一条命令：

npx claude-mem install

支持 OpenClaw、OpenCode、Antigravity CLI，也可从 Claude Code 插件市场安装。运行环境要求 Node.js 20.0 及以上、Claude Code（带插件支持）、Bun、uv 与 SQLite 3（后两者缺失时自动安装）。

隐私与模式配置

配置集中在 ~/.claude-mem/settings.json，可控制注入内容与存储位置。需要排除敏感内容时，用 <private> 标签标记，相关记录不会进入存储或注入。工作模式通过 CLAUDE_MEM_MODE 设置，内置 code（英文）与 code--zh（简体中文）等模式，切换后观察记录的语言与工作流随之变化。

在线记忆服务首 30 天免费，试用结束后自动回退到 Anthropic 套餐，不会中断使用。

结语

claude-mem 把跨会话记忆做成了无需人工干预的本地基础设施：自动采集、压缩存储、按需注入，并用分层检索控制 token 成本。92.8k stars、319 个版本迭代和 134 名贡献者，是这个方向被开发者接受程度的直接指标。如果你正在被 AI 助手的「会话失忆」困扰，一条 npx claude-mem install 命令就可以开始体验。