开源发现

编码 Agent一开新会话就「失忆」：上次修 bug的路径、踩过的坑、项目约定都要再讲一遍。claude-mem（GitHub：`thedotmack/claude-mem`）是一套面向编程 Agent的持久化记忆压缩系统：在会话里自动捕获工具调用观察，用 AI压缩成语义摘要，并在后续会话里把相关上下文注回——默认围绕 Claude Code，也覆盖 OpenClaw、Codex、Gemini、Hermes、Copilot、OpenCode、Grok Bot等。本文整理时仓库公开星标约 108088、fork约 9482（以 GitHub实时数为准）；主语言 TypeScript；协议 Apache-2.0；当前仓库版本约 15.8.0，要求 Node ^20.19／≥22.12（Bun ≥1.1.31）；站点与文档见 https://claude-mem.ai 、https://docs.claude-mem.ai/ 。

它不是「再贴一段长 prompt」：安装后走生命周期钩子 + 本机 Worker（Express／Bun）+ SQLite（FTS5）与可选 Chroma向量检索，以及面向 Agent的 MCP／`mem-search` 渐进式检索。安装入口以官方 `npx claude-mem install`（或 Claude Code `/plugin`）为准；`npm install -g` 只装 SDK／库，不会注册钩子与 Worker。

图片来源：官方仓库 docs/public/claude-mem-logo-for-dark-mode.webp

它解决什么问题

多日、多会话的真实开发里，Agent最贵的往往不是单次补全，而是连续性：为什么这么改、上次失败原因、仓库约定与敏感边界。纯靠对话窗口或手工粘贴笔记，要么超窗被截断，要么人要当「记忆搬运工」。claude-mem把观察（工具读写、决策痕迹等）自动落库，再经 Claude Agent SDK（也可配 Gemini／OpenRouter等）压缩成可检索摘要；新会话 SessionStart时按配置注入近期上下文，需要时再用自然语言搜索历史。

另一侧是令牌成本：一次把全文塞回上下文既贵又吵。官方用渐进式披露（先索引、再时间线、再按 ID取全文），并在检索路径上强调约 10× 的令牌节省思路（先筛再取详）。隐私侧可用 `<private>` 标签排除入库内容，并有自动脱敏等配置入口（以文档为准）。

图片来源：官方仓库 docs/public/cm-preview.gif

它能做什么

• 跨会话记忆流水线：SessionStart／UserPromptSubmit／Pre／PostToolUse／Stop／SessionEnd等钩子捕获会话与工具观察 → Worker用 SDK抽取结构化学习 → SQLite存会话／观察／摘要 → 下次会话再注入；可选 Cloud Sync备份到 cmem.ai。
• 本机 Worker与查看器：Bun管理的本地 HTTP API，默认按用户映射端口；带 React实时记忆流／SSE查看器，「My Work」与可选 TeamBrain共享工作区（各人自选分享范围）。
• MCP三层检索：`search`（紧凑索引）→ `timeline`（时序上下文）→ `get_observations`（按 ID批量取全文）；另有 `mem-search` Skill、Claude Desktop Skill、FTS5全文与可选 Chroma语义检索。
• 多 IDE／宿主安装：`npx claude-mem install` 及 `--ide`（如 opencode、t3code、antigravity、omp、pi、dsh、grok-bot等）；OpenClaw可用官方一键脚本；Claude Code可用 marketplace `/plugin`。
• 模式与语言：`CLAUDE_MEM_MODE`（如 `code`、`code--zh`）控制工作流与观察生成语言；文档称多语言模式覆盖面较广。截图入库默认关闭、可按配置开启。
• 工程栈（官方口径）：TypeScript；SQLite + bun:sqlite；Express 5；esbuild；测试用 `bun test`。设置文件默认 `~/.claude-mem/settings.json`。

图片来源：官方仓库 docs/public/claude-mem-logo-for-light-mode.webp

有什么好处

自动、少打断：装好后观察与摘要在后台走，不必每轮手工「请记住」。

检索分层、成本可控：索引先行、详情按需，避免把整库观察一次打进上下文；引用可用观察 ID，便于在查看器或 API里回溯。

本地优先、边界清楚：核心数据在本机 SQLite；云同步、托管 observer／试用与商业边界以官方文档与 LICENSE／ip-boundary说明为准。开源主体为 Apache-2.0，便于嵌进工具链与企业 Agent运行时。

适配多宿主：同一套记忆思路可挂到多种编码 Agent／网关，而不是锁死单一 IDE。

图片来源：官方仓库 docs/public/claude-mem-logomark.webp

适合谁

适合已经在用 Claude Code（或其他官方支持的编码 Agent／OpenClaw等）、需要跨会话项目记忆的个人开发者与小团队；适合想给 Agent加「可搜索的本地记忆 + MCP」而不是无限加长 system prompt的人；也适合需要中文观察模式（如 `code--zh`）、本机查看器与可选团队共享的工作流。

若你只需要一次性粘贴笔记、或无法接受本机 Worker／钩子与第三方观察模型调用，请先对照安装与配置文档。权威来源：https://github.com/thedotmack/claude-mem ；文档：https://docs.claude-mem.ai/ 。本文只做开源发现介绍，不替代官方 README、许可证与合规要求。