RouteMux Docs
IntegrationsDev tool

Claude Code

两个环境变量把 Claude Code 指到 RouteMux —— 不用配置文件,不用插件。

Claude Code 从环境变量读取端点,所以切到 RouteMux 只需要填两个值,代码零改动。

配置

export ANTHROPIC_BASE_URL="https://api.routemux.com"
export ANTHROPIC_AUTH_TOKEN="sk-..."          # 你的 RouteMux key

或者写进 ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.routemux.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-..."
  }
}

末尾不要加 /v1

ANTHROPIC_BASE_URL 填裸域名即可。Anthropic 客户端自己会追加 /v1/messages, base URL 末尾再带 /v1 就变成了 /v1/v1/messages

RouteMux 会把这个双重前缀归一化而不是直接报错,但你链路上的其他工具未必会 —— 一开始填对就绕开了这一整类问题。

选模型

GET /v1/models 返回的任意 slug。Claude Code 期望 Anthropic 风格的 id:

export ANTHROPIC_MODEL="anthropic/claude-sonnet-5"

验证

curl https://api.routemux.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"anthropic/claude-sonnet-5","max_tokens":32,
       "messages":[{"role":"user","content":"ping"}]}'

返回 402 说明钱包余额为零 —— 充值后重试。失败请求一律不计费。

排查

现象原因
每个请求都 401key 缺失或格式不对。RouteMux 的 key 以 sk- 开头。
400 AMBIGUOUS_API_KEY发了两把不同的 key —— 一把在 Authorization、另一把在 x-api-key。清掉没在用的那个。
/v1/v1/...404base URL 末尾带了 /v1,去掉。
提示模型「不存在」这把 key 没开通该模型。以 GET /v1/models 的返回为准。

On this page