自动配置指南

TopRouter 提供统一的 API 端点来访问 200+ 模型。为了避免手动配置错误，您可以使用以下模板环境变量和验证命令来设置您的客户端。

::: important API 基础地址 官方的 API 基础地址 (Base URL) 为：https://toprouter.cc (请勿在末尾添加 /v1)。 :::

1. 准备 API Key

在进行配置前，请先登录控制台创建 API Key：

1. 访问 API 密钥管理页面。
2. 点击 创建 API Key。
3. 复制生成的 API Key 并妥善保管 (该密钥仅会显示一次)。

---

2. 环境变量配置

OpenAI 兼容客户端环境变量

适用于 OpenAI SDK、Cherry Studio、Cursor 以及其他兼容 OpenAI 格式的客户端，请配置以下变量：

export OPENAI_BASE_URL="https://toprouter.cc"
export OPENAI_API_KEY="您的_toprouter_api_key"
export OPENAI_MODEL="openai/gpt-5.5" # 示例模型

Claude Code 环境变量

在使用 Claude Code 命令行工具连接 Anthropic 兼容端点时，请进行如下配置：

export ANTHROPIC_BASE_URL="https://toprouter.cc"
export ANTHROPIC_API_KEY="您的_toprouter_api_key"
# 可选设置：禁用非必要网络流量和归属报头
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0

认证冲突提示

请勿同时设置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY，否则在某些 Claude Code 版本中可能会导致认证冲突。

---

3. Windows PowerShell 环境变量持久化

如果您是 Windows 用户，并希望在每次启动 PowerShell 时自动加载环境变量：

1. 在 Notepad 中打开您的 PowerShell 配置文件：

   notepad $PROFILE

2. 在文件末尾添加以下行并保存：

   $env:OPENAI_BASE_URL="https://toprouter.cc"
   $env:OPENAI_API_KEY="您的_toprouter_api_key"
   $env:OPENAI_MODEL="openai/gpt-5.5"

3. 重启 PowerShell 或在当前窗口运行 . $PROFILE 以应用配置。

---

4. 连接验证

配置完成后，您可以在终端运行以下 cURL 命令来验证 API Key 和 Base URL 是否配置正确：

curl https://toprouter.cc/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.5",
    "messages": [{"role": "user", "content": "回复 toprouter-ok"}]
  }'