memsvc · 记忆服务接入指南

Claude Code 的长期记忆服务（与 mem0 协议对等，自建在 chiefleo.com）。所有 Mac 共用同一份记忆：写入即时可见、检索无额度；每条写入都会异步复制到 mem0 官方——那边是可视化看板，也是异地热备。

新 Mac 三步接入

  1. 先决条件：Claude Code 已安装、并用「Claude 启动器」打开过至少一次（这样 ~/.claude.json 已存在）。
  2. 打开「终端」App，粘贴下面这一整行，回车： 
    curl -fsSL https://mem.chiefleo.com/setup.sh -o /tmp/memsvc-setup.sh && bash /tmp/memsvc-setup.sh --to memsvc
  3. 终端提示「令牌（粘贴后回车，不显示）」时：打开 macOS「密码」App → 搜索 memsvc 记忆服务令牌 → 点「密码」→ 「拷贝密码」→ 回到终端 ⌘V 粘贴（屏幕上不会显示任何字符，这是正常的）→ 回车。
    看到 ✓ 令牌有效 与 ✓ mem0 条目已指向 memsvc 就完成了。脚本先拿令牌到服务器验证，对了才会写入本机。
  4. 用「Claude 启动器」重新打开 Claude Code（正在运行的会话要重开才会用上）。新对话里说一句「用 mem0 搜一下 memsvc」，Claude 能搜到记忆即接入成功。

随时核对

bash /tmp/memsvc-setup.sh --status

只打印当前指向与令牌文件是否存在，不打印令牌。

可视化看板

打开 app.mem0.ai，用户 mem0-mcp 下就是全部记忆（镜像延迟通常在一分钟内）。看板只用来看：在那边改的内容不会回流到 memsvc，下次本地改动会把它覆盖。

故障切换（memsvc 打不开时）

要做什么命令
切到 mem0 官方（镜像里有全部记忆）bash /tmp/memsvc-setup.sh --to mem0
本机没有备份条目时会提示粘贴 mem0 API key（app.mem0.ai → API Keys；建议也存进「密码」App）。
memsvc 恢复后切回bash /tmp/memsvc-setup.sh --to memsvc

切换后要重开 Claude Code 会话；切换后第一次同步记忆会重建账本，多花约 30 秒，属正常。

常见问题

现象原因与做法
命令卡住或报「连不上 mem.chiefleo.com」公司电脑首次访问会被云壳拦：到云壳「防护记录 → 域名拦截」把 mem.chiefleo.com 加白，再跑一次。别用 hosts 或代理规则绕。
「服务器说这个令牌不对（401）」多半拷成了用户名：回「密码」App 点「密码」那一栏再「拷贝密码」。
「本机没有 python3」终端里运行 xcode-select --install，装完再跑第 2 步。
「三次写入都被覆盖」Claude Code 正在运行并回写配置：先完全退出 Claude App，再跑一次。