claude-mem 自定义后端设置

claude-mem 的 claude Provider 通过 Claude Agent SDK 发起请求。官方的 Custom Anthropic-Compatible Backends 流程只改变后台 observation Worker，不会改变交互式 Claude Code 会话；配置必须写进 claude-mem 自己的目录，不能只在 shell 中 export。

第一步：编辑 ~/.claude-mem/.env

TokenHub 网关使用 Anthropic-compatible Bearer Token 时，写入：

ANTHROPIC_AUTH_TOKEN=YOUR_TOKENHUB_API_KEY
ANTHROPIC_BASE_URL=__API_BASE_URL__

官方说明该文件应使用 0600 权限，目录使用 0700；Worker 下一次写入时也会自动强制这些权限。ANTHROPIC_BASE_URL 由 Claude Agent SDK 原样读取，claude-mem 不会解析或重写 URL。

不要依赖当前终端中的 ANTHROPIC_BASE_URL。claude-mem 为 Worker 构造隔离环境，只有写入 ~/.claude-mem/.env 才能在重启后稳定生效。若网关明确要求 x-api-key 而不是 Bearer Token，再改用 ANTHROPIC_API_KEY。

第二步：在 settings.json 固定 Worker 模型

编辑 ~/.claude-mem/settings.json：

{
  "CLAUDE_MEM_PROVIDER": "claude",
  "CLAUDE_MEM_MODEL": "YOUR_TOKENHUB_ANTHROPIC_MODEL_ID"
}

CLAUDE_MEM_MODEL 会原样传给 SDK。claude-mem 不会翻译模型别名，也不会读取 Claude Code 的 ANTHROPIC_DEFAULT_HAIKU_MODEL，所以必须填写 TokenHub 接受的完整 Anthropic-compatible Model ID。

第三步：用官方命令重启并看 Worker 日志

npm run worker:restart
npm run worker:logs

等待下一次 observation flush。成功时日志会先出现 SDK Starting SDK query，随后出现 Response received；网关错误会原样进入 worker-error.log，不会静默回退到公开 Anthropic 端点。

按 Worker 隔离机制排错

• Claude Code 已走 TokenHub、claude-mem 没有：这是两套配置，检查 ~/.claude-mem/.env 和 settings.json。
• 修改后仍走旧地址：必须 worker:restart，仅重开终端不够。
• 模型不存在：CLAUDE_MEM_MODEL 没有别名转换，重新复制 TokenHub Model ID。
• 网关返回鉴权错误：TokenHub Bearer 网关使用 ANTHROPIC_AUTH_TOKEN；只有明确要求时才用 ANTHROPIC_API_KEY。
• TokenHub 只有 OpenAI Chat Completions：不能直接使用 claude Provider，需要先经过 LiteLLM 等 Anthropic 协议网关。

官方资料

• claude-mem：Custom Anthropic-Compatible Backends