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