文档 · 接入指南

Claude Code 接 TopxAI：ANTHROPIC_BASE_URL 和密钥

2026-10-02

两个环境变量把 Claude Code 指到 https://ai.topxea.com，模型选 claude-sonnet-5-5、claude-opus-5-5 或 claude-fable-5-1。

Claude Code 走 Anthropic Messages 接口，TopxAI 在 https://ai.topxea.com/v1/messages 提供同一个接口。两个环境变量设置端点和密钥，模型变量选择目录里的模型。

设置

export ANTHROPIC_BASE_URL=https://ai.topxea.com
export ANTHROPIC_AUTH_TOKEN=sk-...        # Claude 线路或自动路由的 TopxAI 密钥
export ANTHROPIC_MODEL=claude-sonnet-5-5    # 可选：默认模型
claude

ANTHROPIC_AUTH_TOKEN 把密钥放在 Bearer 头里，ANTHROPIC_API_KEY 放在 x-api-key 头里。TopxAI 两种都认，用你 shell 里已有的那个。基础地址填域名根，不带 /v1：Claude Code 自己会拼 /v1/messages。

想长期生效，把同样的值写进 ~/.claude/settings.json 的 env：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.topxea.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Claude Code 还会读 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL，用来在模型之间切换。把它们设成目录里的 ID（claude-opus-5-5、claude-sonnet-5-5），切换时就不会请求 TopxAI 没有的模型。

从 Sonnet 5 迁移

把已保存的 ANTHROPIC_MODEL 或 ANTHROPIC_DEFAULT_SONNET_MODEL 从 claude-sonnet-5 改为 claude-sonnet-5-5。旧 ID 退出目录，不设转发别名。端点和没有模型限制的密钥继续使用；设有允许模型列表的密钥，请把新 ID 加入列表。换模型后开启新对话，避免把绑定旧模型的思考内容块带给 Sonnet 5.5。

token 与缓存价格全部不变。自适应思考默认使用 high，TopxAI 将旧版关闭思考的请求转换为 between_tools 加 low。自定义客户端若强制选择工具，需改用自动选择；使用 Anthropic 原生计算机工具的客户端需迁移到新的 toolset 格式。参数说明及 Anthropic 官方迁移指南见 Sonnet 5.5 迁移文章。

用哪把密钥

自动路由的密钥把每个请求送到能提供该模型、售价最低的线路，先看共享池。Claude 官方线路的密钥固定走官方线，按牌价 90% 收费。两种都在密钥页创建，线路那一页讲了区别。

CC Switch

手上有好几个端点，密钥页每行菜单里的 CC Switch 会打开一个 ccswitch:// 导入链接，端点、密钥、模型已经填好。

Claude Code 会发什么

Claude Code 每个请求都带自己的系统提示和工具定义，这些 token 按输入计费，和别的输入一样。提示缓存按模型页上的缓存读、缓存写价格算，用量日志把缓存命中和未命中的数量分开列出。

不通时

401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
curl 能通、工具不通：这一页按工具列出常见原因。

10 月 2 日供应商实测中，部分 between_tools 请求返回 502，包括两条线路的 medium，以及官方线的 OpenAI none。两条线路的显式 low adaptive 模式已通过实测：如符合你的任务，可在 Messages 使用 thinking: {"type":"adaptive"} 配合 output_config: {"effort":"low"}，或在 Chat Completions 使用 reasoning_effort: "low"。Adaptive 模式仍可能在回答前思考，这部分 token 按输出计费。TopxAI 保留请求的思考模式，不会悄悄换成另一种模式。

模型：claude-sonnet-5-5, claude-opus-5-5 · 模型与价格

Claude Code 接 TopxAI：ANTHROPIC_BASE_URL 和密钥

设置

从 Sonnet 5 迁移

用哪把密钥

CC Switch

Claude Code 会发什么

不通时

相关