一天一个新 Skill · 第 68 期
claude-mem:给你的 AI 编程搭档装一个不会失忆的脑子
每次新开会话,都要把项目背景重新讲一遍?claude-mem 给 Claude Code 加了持久记忆——这期我们实测的是它的看家本事:跨会话记忆留存。
实测读数
| 项目 | 读数 | 实测方式 |
| 版本 | claude-mem v13.34.2(npm latest) | npm view claude-mem version |
| 安装 | npm install -g claude-mem,npm 自报 2 分钟(25 包) | npm 安装输出 |
| IDE 集成 | --ide claude 成功(Bun 1.3.11、uv 0.9.20 自动备好) | 安装输出 |
| Worker | 启动成功,PID 48332,端口 37703 | claude-mem status |
| 跨会话记忆写入 | 4 条事实写入成功(work_state_write 经 MCP) | MCP 响应原文 |
| 跨会话读回 | 新开独立 MCP 进程,4/4 逐字读回,含中文与色值 #0B1E3A/#FFB300 | MCP 响应原文 |
| 提示词留存 | Session A 的原始 prompt 被留存,可 claude-mem search "Aurora" 搜到 | search 输出 |
| 数据库 | ~/.claude-mem/claude-mem.db,本地 499,712 bytes | /api/stats |
正文要点
- 98k★ 的 thedotmack/claude-mem,npm 一条命令装完(实测 2 分钟),数据全程留在本机 ~/.claude-mem。
- 写入的记忆存在本机库里:写代码、改文件的过程被留档,新开会话直接问,它先想起来再干活。(自动捕捉为官方宣称能力,见下方诚实边界 1)
- 演示实测:写入 4 条项目事实(上线日期/配色/负责人/测试环境),新进程逐字读回 4/4,中文、色值一个不丢。
- 历史随手查:search 一条命令,全库检索(本机当前为关键词降级)。
演示视频
「暗房 · 显影记忆」— 实测演示片,中文男声配音 + 字幕(约 50 秒)
装法
前置依赖(先说清再装):claude-mem 本体安装、本地记忆库、work_state 跨会话读写零账号可用;但「自动观察总结」依附你已有的 Claude Code 套餐跑——没有套餐时该能力不可用(本机今日即因额度耗尽未复验)。
npm install -g claude-mem
claude-mem install --ide claude
claude-mem start
claude-mem search "你的关键词"
记忆复验:claude-mem mcp 起 MCP,用 work_state_write / work_state_read 跨进程读写(本次 4/4 逐字命中)。装完先跑 claude-mem doctor。
诚实边界
- 自动观察(auto-observation)为官方宣称能力,本机今日未复验:/api/stats 实测 observations=0、summaries=0。原因有二,均为本机环境事实:a) 本机 Claude Code CLI 额度已耗尽(403,余额 -$93.68),hook 链路起不来;b) codex-cli 集成安装超 10 分钟未完成,且 codex exec 下插件 hook 未触发。此能力本文不做实测结论。
- 语义检索离线:chroma-mcp 预热失败(uvx 装包报错),search 自动降级为关键词检索——关键词检索本身可用。
- tree-sitter 缺失:smart_search/smart_outline 停用(安装时明确提示可
claude-mem repair)。
- 零 Key 口径的准确说法:claude-mem 本身不收 Key、记忆全存本地 ~/.claude-mem;但它依附你已有的 Claude Code 套餐跑总结,cmem.ai 登录是可选的(云端同步/试用,不登录不影响本地记忆)。文案不写成"完全不需要任何 AI 套餐"。
- 读回验证用的是 MCP work_state 通道(官方 MCP 工具,跨进程持久化),不是自动观察摘要。
收尾一句:装完先跑 claude-mem doctor 最稳。