Claude-Mem(跨会话记忆)

作者 设施特

每次新开会话,AI 又把同一批文件读一遍、把你上周修过的 bug 再犯一遍。Claude-Mem 在旁边挂一个观察员 agent 边干活边记笔记,下个会话开场只给一份索引,需要细节才展开,按需取用省 token。GitHub 11.5 万 star。

Github
Skill 效率办公 v1.0.0 热度 340

将提示词发送给你的 AI 安装该 Skill

复制下方提示词,粘贴到 Cursor / Claude Code / WorkBuddy 等本地 Agent,按说明安装。

请根据 https://www.cweto.cn/?ai_hub=skill_install ,安装本站 Skill @ai_hub/work-49(Claude-Mem(跨会话记忆))。
详情页:https://www.cweto.cn/work-49.html
GitHub:https://github.com/thedotmack/claude-mem
请装到当前 Agent 的 skills 目录(见安装说明中的路径表),完成后重启或刷新 Agent。
安装说明 GitHub
支持的本地 Agent 目录
  • Claude Code → ~/.claude/skills/
  • Cursor → ~/.cursor/skills/
  • Windsurf → ~/.codeium/windsurf/skills/
  • Codex → ~/.codex/skills/
  • Gemini CLI → ~/.gemini/skills/
  • WorkBuddy → ~/.workbuddy/skills/
  • OpenClaw 变体 → 各自 skills 目录

Skill 说明

Claude-Mem 是什么

Claude-Mem 解决的是编码 agent 的失忆问题:每开一个新会话,agent 都从零开始,重读同样的文件、重问同样的问题、重新踩你上周已经一起修过的坑。它的做法是在主 agent 旁边跑第二个 agent,在它干活时不停记笔记,下个会话开场先给一份精简索引,需要细节时再按需拉取。

记忆注入从你在某个项目的第二个会话开始生效;如果想让 agent 一次吃透整个仓库,可以运行 /learn-codebase(典型仓库约 5 分钟,可选)。它支持 Claude Code、Codex、Cursor、OpenCode 等十余种 agent;Copilot CLI、Goose、Roo Code、Warp 只能搜索记忆,不会记录会话。

能力说明
会话接力新会话开场带历史观察索引,分层展开,能看到每层花多少 token
三段式检索search 拿索引 → timeline 看上下文 → get_observations 取详情
token 节省先过滤再取详情,官方称约省 10 倍 token
隐私用 <private> 包裹的内容不会被存下来
多语言观察记录可用中文、日文、韩文等 29 种语言写入
团队共享TeamBrain 可选共享工作区,个人请求与评审笔记分开

数据存在本机 ~/.claude-mem,SQLite 存会话与观察,Chroma 做语义检索之上的向量搜索,云同步是可选项。项目采用 Apache-2.0 协议,GitHub 上约 11.5 万 star。

Claude-Mem 怎么安装

需要 Node.js 20.19 以上的 20.x 或 22.12 以上;Bun 和 uv 缺失时安装脚本会自动装。最简装法:

npx claude-mem install

安装器会自动发现你机器上的 agent,问你要给哪些装。也可以直接在 Claude Code 插件市场装:

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

只装某一个 agent 时加 --ide 参数:

npx claude-mem install --ide opencode
npx claude-mem install --ide antigravity
npx claude-mem install --ide pi

注意:npm install -g claude-mem 只装 SDK 库,不会注册钩子也不装 worker 服务,必须用 npx claude-mem install 或插件命令安装。

Claude-Mem 怎么使用

  1. 装完重启 agent。第一次使用时观察记录会从你第一条提示词开始写。
  2. 在同一个项目里开第二个会话,开场就会带上第一次会话的记忆索引。
  3. 想找以前做过的事,让 agent 用 mem-search 技能检索,它会按索引、时间线、详情三步走,只在必要时拉全文。
  4. 启动时会打印 worker 地址,打开可以看到 My Work 面板:实时请求、进度、需要人接手的地方和评审队列。
  5. 不想记下来的内容用 <private> 标签包住,就不会入库。
  6. 要换成中文记录,编辑 ~/.claude-mem/settings.json,把 CLAUDE_MEM_MODE 设为 code--zh,然后重启 agent。
  7. 出问题先跑 npx claude-mem doctor,它会检查 Bun、uv、钩子启动器和 worker 并告诉你修什么。
  8. 不想要匿名统计就执行 npx claude-mem telemetry disable。

Claude-Mem 适合谁用

  • 长期在同一个代码库上和 agent 协作、反复解释背景的开发者
  • 会话一长就得压缩上下文、压完就丢记忆的重度用户
  • 关心 token 成本、希望检索时少烧钱的人
  • 同时用 Claude Code、Codex、Cursor 等多个 agent,想让它们共享一套记忆的人
  • 对隐私敏感、要求记忆只存本地不上云的用户

Claude-Mem 项目地址

  • GitHub 仓库:https://github.com/thedotmack/claude-mem
  • 官方文档:https://docs.claude-mem.ai/
  • 安装指南:https://docs.claude-mem.ai/installation
  • 检索工具说明:https://docs.claude-mem.ai/usage/search-tools
  • 问题反馈:https://github.com/thedotmack/claude-mem/issues