CC Switch

在 CC Switch 中管理 Claude Code 与 Codex 的 routerra.ai 配置。

安装与准备

  1. 从 CC Switch Releases下载对应系统安装包，安装并打开。目标 CLI 需另行安装，CC Switch 负责管理其配置。本指南采用 v3.20.1+ 的密钥处理方式。
  2. 在 routerra.ai API 密钥创建密钥，从模型复制可用模型 ID。

添加并启用应用配置

  1. 在侧栏选择目标应用，进入 Direct → Add Provider → Custom Configuration，命名为 routerra.ai。Claude Code 使用下方 JSON，在 CLI 中用 /model YOUR_CLAUDE_MODEL_ID 选择模型。Codex 填写 API Key、端点 https://routerra.ai/v1 和支持 Responses 的模型，上游格式选择 Responses。下方 TOML 展示生成的 provider 字段。
  2. 点击 Add，在卡片点击 Enable，再重启目标 CLI。CC Switch v3.20.1+ 切换 Codex 时，将 provider 密钥以 experimental_bearer_token 写入 ~/.codex/config.toml，不写入 auth.json。此流程不要使用旧的 requires_openai_auth = true 配方。
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerra.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID"
  }
}

生成的 Codex 配置

启用 Codex 配置后，在 ~/.codex/config.toml 中检查这些字段。

model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"

检查连接

保存不等于启用：检查 provider 卡片和生成的 CLI 文件。切换无效时，关闭 CLI，移除冲突的 shell 环境变量，再打开。Codex 显示官方账户不能说明请求路由，请查看 routerra.ai 用量。需在直接切换时保留已有官方登录，启用 Settings → General → Codex App Enhancements → Keep official login for direct switches。模型发现返回 404/405 时可手动填写 ID。