RealRelay.ai
程式碼代理

CC Switch 設定指南

使用 CC Switch 把 Claude Code 與 Codex 指向 RealRelay.ai:從主控台一鍵匯入供應商,或手動新增,然後檢查連線並選擇模型。

建立 API 密鑰瀏覽模型目錄
協定
Anthropic Messages · OpenAI Responses
基礎位址
https://www.realrelay.ai
官方文件
github.com
已對照工具官方文件核對
2026-10
實驗性. 尚未在 RealRelay.ai 上完整端對端測試。步驟依據該工具的官方文件；若某一步失敗，請附上錯誤訊息聯絡支援。

概覽

CC Switch 是一款桌面應用程式,用來管理命令列程式碼代理的供應商設定。你不必逐一編輯各工具的設定檔,只要在 CC Switch 中新增一次供應商,再切換過去即可。本指南涵蓋它在 RealRelay.ai 上最常見的兩個目標:Claude Code 與 Codex。

  • Claude Code 使用 Anthropic Messages 協定。它的端點是不含 /v1 的網站位址,因為 Claude Code 會自行加上 /v1/messages。

  • Codex 使用 OpenAI Responses 協定。它的端點是含 /v1 的網站位址;Codex 會在後面加上 /responses。

  • 不論哪一種,你都需要一組在主控台的 API 金鑰頁面取得的 API 金鑰,以及一個完全依照 GET /v1/models 列出寫法的模型 ID。

CC Switch 只負責寫入設定;請求是由 Claude Code 或 Codex 發出的,所以請先安裝它們。Codex 只能搭配 RealRelay.ai 在 /v1/responses 上提供的少數模型使用,例如 openai/gpt-5.3-codex。這套設定尚未在 RealRelay.ai 上完整端對端跑過。

一鍵設定

主控台可以透過 CC Switch 的 ccswitch:// 連結,把金鑰直接交給 CC Switch。請先安裝 CC Switch(見下方「安裝」),讓瀏覽器知道如何開啟這個連結。

  1. 1

    開啟金鑰的選單

    在 API 金鑰頁面中,開啟你要使用的金鑰在 Actions 欄中的 ⋯ 選單,然後選擇 CC Switch。

  2. 2

    填寫 Import to CC Switch 對話框

    選擇 Application,為供應商填寫 Name,並選擇 Primary Model(必填)。若是 Claude,也請設定 Haiku、Sonnet 與 Opus 模型,讓 Claude Code 使用的每個槽位都指向你的金鑰可以呼叫的模型。

    Console → API Keys → ⋯ → CC Switch
    1Application:   Claude2Name:          RealRelay.ai Claude3Primary Model: anthropic/claude-sonnet-4-64Haiku Model:   anthropic/claude-sonnet-4-65Sonnet Model:  anthropic/claude-sonnet-4-66Opus Model:    anthropic/claude-sonnet-4-6
    Console → API Keys → ⋯ → CC Switch
    Application:   CodexName:          RealRelay.ai CodexPrimary Model: openai/gpt-5.3-codex
  3. 3

    開啟 CC Switch 並匯入

    點選 Open CC Switch,並允許瀏覽器開啟應用程式。CC Switch 會顯示端點、遮蔽後的金鑰與模型。主控台會預先開啟 Switch to this provider after import;如果你只想先儲存供應商、稍後再用,請把它關閉。然後點選 Import。

主控台會替你填入正確的端點:Claude 用網站根位址,Codex 用含 /v1 的位址。請不要在對話框中選擇 Gemini;RealRelay.ai 沒有可供 Gemini CLI 使用的 Gemini 文字模型。如果你的主控台沒有顯示 CC Switch 選項,下方的手動步驟可以達到相同結果。

安裝

從 CC Switch 的 GitHub Releases 頁面下載,或使用套件管理工具安裝。它需要 Windows 10、macOS 12,或具備 glibc 2.35 與 WebKitGTK 4.1 的 Linux(例如 Ubuntu 22.04 或 Debian 12)或更新版本。

macOS (Homebrew)
brew install --cask cc-switch

也可以從 Releases 下載 .dmg。此版本已簽署並經過公證,可在 Apple silicon 與 Intel Mac 上執行。

從 Releases 下載 .msi 安裝程式,或免安裝的 .zip。ARM 版 Windows 另有獨立的 arm64 版本。

從 Releases 下載適用於你架構的 .deb、.rpm 或 .AppImage。在 Arch Linux 上:

Arch Linux (paru)
paru -S cc-switch-bin

第一次啟動時,CC Switch 會把你目前的 Claude Code 與 Codex 設定儲存為名為 default 的供應商,方便你之後切換回來。

設定

若要手動新增供應商,請在側邊欄選擇工具,點選 Add Provider(右上角的 + 按鈕),選擇 Custom Configuration,填寫表單後點選 Add。請把 sk-*** 換成你的金鑰。

CC Switch → Claude Code → Add Provider → Custom Configuration
1Provider Name: RealRelay.ai2API Key:       sk-***3API Endpoint:  https://www.realrelay.ai4Upstream Format: Anthropic Messages (Native)5Main Model:    anthropic/claude-sonnet-4-6

表單下方的設定編輯器會顯示 CC Switch 將寫入 ~/.claude/settings.json 的內容。其中應包含:

CC Switch → Claude Code → config (settings.json)
1{2  "env": {3    "ANTHROPIC_BASE_URL": "https://www.realrelay.ai",4    "ANTHROPIC_AUTH_TOKEN": "sk-***",5    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-4-6",6    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-sonnet-4-6",7    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4-6",8    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-sonnet-4-6"9  }10}
CC Switch → Codex → Add Provider → Custom Configuration
1Provider Name:   RealRelay.ai2API Key:         sk-***3API Endpoint:    https://www.realrelay.ai/v14Upstream Format: Responses (native)5Default Model:   openai/gpt-5.3-codex

編輯器中有存放金鑰的 auth.json 部分,以及存放端點與模型的 config.toml 部分:

CC Switch → Codex → auth.json
{  "OPENAI_API_KEY": "sk-***"}
CC Switch → Codex → config.toml
1model_provider = "custom"2model = "openai/gpt-5.3-codex"3model_context_window = 40000045[model_providers.custom]6name = "RealRelay.ai"7base_url = "https://www.realrelay.ai/v1"8wire_api = "responses"9requires_openai_auth = true

  • API Endpoint 是兩者之間唯一不同的值:Claude Code 不含 /v1,Codex 要含 /v1。

  • Upstream Format 請維持原生選項。這樣兩個工具都會直接與 RealRelay.ai 通訊,不需要 CC Switch 的本機路由。

  • 對於 Claude Code,RealRelay.ai 接受以 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY 傳入金鑰。對於 Codex,CC Switch 在你切換時會把金鑰寫進 ~/.codex/config.toml,而不是 auth.json。

  • model_context_window 告訴 Codex 模型的視窗有多大,因為 RealRelay.ai 的模型清單中沒有這項資訊。400,000 適用於 openai/gpt-5.3-codex。

接著在供應商卡片上點選 Enable。Claude Code 不需重新啟動就會套用變更。Codex 則請在切換後重新啟動它,或重新開啟終端機。

驗證

  1. 1

    直接呼叫端點

    用你的金鑰,執行你所設定工具對應的請求。若收到含 id 的 JSON 回覆(Claude Code 為 msg_…,Codex 為 resp_…),就代表位址、金鑰與模型都沒問題。

    Terminal · Claude Code endpoint
    1curl -sS "https://www.realrelay.ai/v1/messages" \2  -H "Authorization: Bearer sk-***" \3  -H "anthropic-version: 2023-06-01" \4  -H "content-type: application/json" \5  -d '{"model": "anthropic/claude-sonnet-4-6", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
    Terminal · Codex endpoint
    1curl -sS "https://www.realrelay.ai/v1/responses" \2  -H "Authorization: Bearer sk-***" \3  -H "content-type: application/json" \4  -d '{"model": "openai/gpt-5.3-codex", "input": "Reply with OK"}'
  2. 2

    確認目前啟用的供應商

    在 CC Switch 中,該工具啟用中的應是 RealRelay.ai 卡片。

  3. 3

    啟動工具

    在專案中啟動它,並執行 /status。基礎位址應為 RealRelay.ai,模型則為你所選的模型。送出一則簡短訊息;收到回覆即確認整條路徑暢通,而該請求也會出現在主控台的用量日誌中。

    Claude Code
    claude/status
    Codex
    codex/status

模型

  • Claude Code:在供應商上設定主要模型,以及 Haiku、Sonnet 與 Opus 模型。Claude Code 會把背景工作(例如標題)交給 Haiku 槽位,所以若留空,就會送出 RealRelay.ai 清單中沒有的模型名稱。模型欄位旁的 Fetch Models 會以 RealRelay.ai 的模型清單填入選單。

  • Codex:把你想在 /model 中使用的每個模型,連同其上下文視窗,加進供應商的 Model Mapping 表格。Default Model 留空時,會使用第一列。Codex 只在啟動時讀取這份清單,所以修改後請重新啟動它。

  • 若要更換每個新工作階段的模型,請在 CC Switch 中編輯供應商,而不是修改工具本身的檔案;CC Switch 會在你下次切換時改寫那些檔案。

各端點提供哪些模型,列於選擇模型。Claude Code 本身的設定,請參閱 Claude Code 指南。

疑難排解

  • 點選 Open CC Switch 後沒有反應。CC Switch 尚未安裝,或瀏覽器擋下了連結。請安裝並啟動一次,再點選按鈕,並允許瀏覽器開啟應用程式。

  • 出現兩張 RealRelay.ai 卡片。每點一次匯入連結,就會新增一個供應商。請刪除多出來的卡片。

  • Claude Code 回傳 404。Claude 端點以 /v1 結尾。請把它移除。

  • Codex 回傳 404。Codex 端點缺少 /v1。請補上。

  • Codex 出現模型錯誤。該模型不在 /v1/responses 上提供。請使用 openai/gpt-5.3-codex 這類 Responses 模型;一般的 openai/gpt-5.x、Claude 與 GLM 模型都只支援 Chat Completions。

  • 卡片顯示「Needs Routing」。上游格式不是該工具的原生格式。Claude Code 請改回 Anthropic Messages (Native),Codex 請改回 Responses (native)。

  • Codex 仍在使用舊的供應商或模型清單。請重新啟動 Codex。如果 CC Switch 顯示要重新啟動 Codex daemon 的提示,請照做。

  • 401。金鑰錯誤、已停用或額度用完。請在 API 金鑰頁面確認。

  • Claude Code 回傳 400 並指出未知欄位,例如 context_management:請在供應商的設定中加入以下內容,以關閉實驗性請求欄位。

    CC Switch → Claude Code → config → env
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"