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。