API 中转站通用配置指南（2026）

🎯 一份配置，适配所有中转站

大部分中转站都兼容 OpenAI API 标准协议。只要掌握了基础配置方法，换站只需要替换两个值：

baseUrl（API 地址）
apiKey（密钥）

本教程适用于：

✅ 所有 OpenAI API 兼容的中转站
✅ 所有 Anthropic Claude 兼容的中转站
✅ 多种客户端和工具

📋 快速开始

1. 获取凭证

注册中转站账号
在后台创建 API Key
记录两个值：
- Base URL（类似 https://api.example.com/v1）
- API Key（类似 sk-xxxxxxxxxxxx）

2. 选择工具

跳转到对应章节：

OpenClaw
Claude Code
Codex
Gemini CLI
通用 curl 测试

1. OpenClaw 配置

编辑 ~/.openclaw/openclaw.json，在 models.providers 中添加：

{
  "models": {
    "mode": "merge",
    "providers": {
      "your-proxy": {
        "baseUrl": "https://your-proxy.com",
        "apiKey": "sk-your-api-key",
        "api": "openai-chat",
        "models": [
          {
            "id": "gpt-4o",
            "name": "GPT-4o"
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "api": "anthropic-messages"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "your-proxy/gpt-4o"
      }
    }
  }
}

替换：

your-proxy → 你的中转站名称（可自定义）
https://your-proxy.com → 中转站 baseUrl
sk-your-api-key → 你的 API Key

保存后重启 OpenClaw：

openclaw restart

2. Claude Code 配置

Claude Code 支持环境变量和配置文件两种方式。

Windows 系统

方法1：环境变量（PowerShell）

临时设置（仅当前终端）：

$env:ANTHROPIC_BASE_URL="https://your-proxy.com/claude"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

永久设置（全局生效）：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://your-proxy.com/claude', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-your-api-key', 'User')

方法2：配置文件

创建 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://your-proxy.com/claude",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

方法3：VS Code 插件

创建 ~/.claude/config.json：

{
  "primaryApiKey": "sk-your-api-key"
}

macOS/Linux 系统

方法1：环境变量（Zsh/Bash）

临时设置（仅当前终端）：

export ANTHROPIC_BASE_URL="https://your-proxy.com/claude"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

永久设置（Zsh - macOS 默认）：

echo 'export ANTHROPIC_BASE_URL="https://your-proxy.com/claude"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"' >> ~/.zshrc
source ~/.zshrc

永久设置（Bash - Linux 默认）：

echo 'export ANTHROPIC_BASE_URL="https://your-proxy.com/claude"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"' >> ~/.bashrc
source ~/.bashrc

方法2：配置文件

创建 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://your-proxy.com/claude",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

验证配置

macOS/Linux：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Windows PowerShell：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

3. Codex 配置

1. 安装 Codex

npm install -g @openai/codex

2. 配置文件

编辑 ~/.codex/config.toml：

model_provider = "your-proxy"
model = "gpt-5"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.your-proxy]
name = "your-proxy"
base_url = "https://your-proxy.com/codex/v1"
wire_api = "responses"
requires_openai_auth = true

3. 配置密钥

编辑 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

4. 使用（可选）

# 切换到特定模型
codex -m gpt-5-codex

4. Gemini CLI 配置

1. 安装 Gemini CLI

npm install -g @google/gemini-cli

2. 配置环境变量

编辑 ~/.gemini/.env：

GOOGLE_GEMINI_BASE_URL=https://your-proxy.com/gemini
GEMINI_API_KEY=sk-your-api-key
GEMINI_MODEL=gemini-3-pro-preview

3. 配置 settings

编辑或创建 ~/.gemini/settings.json：

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

4. 若出现 401 错误

输入 /auth，然后填上 key

5. 通用 curl 测试

在配置任何工具前，先用 curl 测试 API 是否可用。

OpenAI 兼容接口

curl https://your-proxy.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

测试 Chat Completion

curl https://your-proxy.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hi"}],
    "max_tokens": 10
  }'

Anthropic Claude 兼容接口

curl https://your-proxy.com/claude/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "Hi"}]
  }'

🎨 Python OpenAI SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://your-proxy.com/v1",
    api_key="sk-your-api-key"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

⚠️ 常见问题

1. URL 路径问题

不同工具需要不同的路径后缀：

OpenAI 兼容： /v1 或无后缀
Claude： /claude 或 /v1
Gemini： /gemini
Codex： /codex/v1

2. 认证方式

大部分中转站使用：

Authorization: Bearer sk-xxx（OpenAI 标准）
x-api-key: sk-xxx（Claude 标准）

某些可能需要：

api-key: sk-xxx

3. 模型名称映射

不同中转站可能有不同的模型名称映射：

gpt-4o → 可能是 gpt-4o-2024-08-06
claude-opus-4-6 → 可能是 claude-opus-4-6-20250514

查看中转站文档确认可用模型列表。

🚀 一键配置模板（复制粘贴）

Claude Code（Zsh/Bash）

export ANTHROPIC_BASE_URL="https://your-proxy.com/claude"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

Claude Code（PowerShell）

$env:ANTHROPIC_BASE_URL="https://your-proxy.com/claude"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

OpenClaw（JSON 模板）

{
  "baseUrl": "https://your-proxy.com",
  "apiKey": "sk-your-api-key"
}

📚 相关阅读

最后更新： 2026-02-12
维护者： Atuia
反馈： 发现错误或有改进建议？欢迎提交 PR 或 Issue

🎯 一份配置，适配所有中转站

📋 快速开始

1. 获取凭证

2. 选择工具

1. OpenClaw 配置

2. Claude Code 配置

Windows 系统

方法1：环境变量（PowerShell）

方法2：配置文件

方法3：VS Code 插件

macOS/Linux 系统

方法1：环境变量（Zsh/Bash）

方法2：配置文件

验证配置

3. Codex 配置

1. 安装 Codex

2. 配置文件

3. 配置密钥

4. 使用（可选）

4. Gemini CLI 配置

1. 安装 Gemini CLI

2. 配置环境变量

3. 配置 settings

4. 若出现 401 错误

5. 通用 curl 测试

OpenAI 兼容接口

测试 Chat Completion

Anthropic Claude 兼容接口

🎨 Python OpenAI SDK

⚠️ 常见问题

1. URL 路径问题

2. 认证方式

3. 模型名称映射

🚀 一键配置模板（复制粘贴）

Claude Code（Zsh/Bash）

Claude Code（PowerShell）

OpenClaw（JSON 模板）

📚 相关阅读

AnyRouter

相关推荐

Hybgzs API 深度测评：延迟 2.3s，Claude 可用，性价比待确认

MB666、LoveYY、RunAnytime 怎么选？新手首月筛选清单（2026）

AnyRouter、LinuxDo NewAPI、RunAnytime 怎么选？低成本中转的三角决策框架（2026）

KFC API 深度测评：606ms 延迟、62 TPS、100% 并发成功率