CMEM Pro（手动 / 无界面）¶

当您已有 cmem.ai 账户，并且需要在不使用交互式安装程序的情况下接入 CMEM Pro 时（例如 CI、第二台机器或您通过 SSH 登录的机器），请使用本指南。常规安装路径仍然是 npx claude-mem install。

安装程序的作用¶

分为三个阶段：

1. 运行时 — 如果需要 Bun/uv，则安装 Bun/uv、IDE 插件文件和 worker 依赖。
2. 登录 — 对于 --provider claude 会跳过；对于未提供 --provider 的非交互式运行也会跳过（全新安装默认使用 claude；现有配置保留其提供商）。跳过登录的非交互式安装会在最后一行打印一个可选的登录链接；智能体应将该链接展示给用户，而不是自行打开。本地安装会在注册时联系一次 cmem.ai 以创建登录链接，并附带仅含数字的使用摘要（观察计数和令牌总数，不含提示词、路径或项目名称）；不会向 cmem.ai 发送任何其他内容。否则，CLI 不会询问电子邮箱：
3. POST https://cmem.ai/api/installer/oauth/start，内容为 { source: "npx-installer", device_name: <hostname>, install_state: "fresh" | "update", usage_summary?: { window_days: 28, active_days, observations, memory_tokens, days: [{ d: "YYYY-MM-DD", obs, tokens }] } }（当无法读取本地数据时省略 usage_summary）
4. 打印设备代码 XXXX-XXXX 并打开 authorization_url
5. 轮询 https://cmem.ai/api/pro/trial/poll，直到身份验证通过
6. 提供商 — 默认已预选 CMEM Pro。 选择它会打开 checkout_url（试用/认领），轮询直到 status: "ready"，然后写入设置并重启 worker。

使用个人密钥的 --provider openrouter 是另一条路径：将 CLAUDE_MEM_OPENROUTER_BASE_URL 留空（或设为 https://openrouter.ai/api/v1）。切勿将个人 sk-or- 密钥发送到 https://cmem.ai/api/inference。

安装程序写入的设置¶

凭据会先暂存，再激活。文件：~/.claude-mem/settings.json。

暂存（同步 + 试用元数据）¶

仅当令牌、用户 ID 和 hub URL 均非空时，云同步才会开启。参见 云同步。

激活（这一阶段让观察记录真正运行）¶

worker 通过通用的 OpenRouter 客户端与 cmem.ai 通信。没有单独的 CMEM 提供商实现。

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_BASE_URL": "https://cmem.ai/api/inference/v1",
  "CLAUDE_MEM_OPENROUTER_MODEL": "cmem-observer",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "cm_pro_YOUR_MEMORY_KEY",
  "CLAUDE_MEM_PRO_MEMORY_KEY": "",
  "CLAUDE_MEM_PRO_MEMORY_BASE_URL": "",
  "CLAUDE_MEM_PRO_MEMORY_MODEL": ""
}

保留暂存阶段中的云同步三项配置。memory_key 和 setup_token 通常是相同的（cm_pro_…）。如果轮询返回了不同的 memory_key，请将其用于 CLAUDE_MEM_OPENROUTER_API_KEY，并仅在 CLAUDE_MEM_CLOUD_SYNC_TOKEN 中保留 setup_token。

手动配置方法（您已有令牌）¶

1. 从 cmem.ai → Connect（或安装程序配对）中复制 setup_token、user_id、hub_url 和 memory_key（如果缺失，请使用 setup_token）。
2. 将暂存和激活的键合并到 ~/.claude-mem/settings.json 中。仅使用占位符：

{
  "CLAUDE_MEM_CLOUD_SYNC_TOKEN": "cm_pro_YOUR_SETUP_TOKEN",
  "CLAUDE_MEM_CLOUD_SYNC_USER_ID": "YOUR_USER_ID",
  "CLAUDE_MEM_CLOUD_SYNC_HUB_URL": "https://YOUR_HUB_URL",
  "CLAUDE_MEM_CLOUD_SYNC_DEVICE_ID": "",
  "CLAUDE_MEM_CLOUD_SYNC_DEVICE_NAME": "my-machine",
  "CLAUDE_MEM_PRO_TRIAL_STATE": "active",
  "CLAUDE_MEM_PRO_TRIAL_ENDS_AT": "",
  "CLAUDE_MEM_PRO_PLAN": "trial",
  "CLAUDE_MEM_PRO_FALLBACK_AT": "",
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_BASE_URL": "https://cmem.ai/api/inference/v1",
  "CLAUDE_MEM_OPENROUTER_MODEL": "cmem-observer",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "cm_pro_YOUR_MEMORY_KEY"
}

1. chmod 600 ~/.claude-mem/settings.json
2. 重启 worker，使其不再保留内存中旧的提供商/同步状态：

npx claude-mem restart

交互式安装程序也会在持久化提供商后停止 worker，原因相同。

1. 验证（端口为 CLAUDE_MEM_WORKER_PORT 或 ~/.claude-mem/.worker.port）：

curl -s "http://127.0.0.1:${CLAUDE_MEM_WORKER_PORT}/api/health"
curl -s "http://127.0.0.1:${CLAUDE_MEM_WORKER_PORT}/api/sync/status"

预期健康检查中提供商为 openrouter，同步中 configured: true 且 hub.reachable: true。

1. 第一条真实观察记录应通过模型 cmem-observer 存储。网关成功会清除 CLAUDE_MEM_PRO_FALLBACK_AT。网关的最终拒绝（额度已用尽、订阅已停用或密钥被拒绝）会设置该时间戳，记忆将回退到 Anthropic 方案，并在下次会话启动时转发网关自身的消息和链接。

不要混淆的内容¶

切勿将个人 OpenRouter 密钥发送到 cmem 网关。

后续步骤¶

• 安装 — 交互式三阶段安装程序
• 云同步 — 同步三件套复制的内容
• OpenRouter 提供方 — 个人 OpenRouter 密钥（而非 cmem.ai）