CC Switch

三個欄位和兩個下拉選單。端點填入 https://api.kunavo.com，使用您的 sk-kn-… 金鑰，然後——多數指南會遺漏的部分——將 API Format 保持為 Anthropic Messages (Native)，並將 Auth Field 保持為 ANTHROPIC_AUTH_TOKEN。Kunavo 原生支援 Messages API，因此 Claude Code 端不需要本機路由。

Provider Name   Kunavo
API Key         sk-kn-...
API Endpoint    https://api.kunavo.com      <- service root, no /v1, no trailing slash

Advanced Options
  API Format    Anthropic Messages (Native) <- the default; do NOT switch
  Auth Field    ANTHROPIC_AUTH_TOKEN (Default)

逐步設定（Claude Code 分頁）

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 在 CC Switch 中開啟頂層的 Claude Code 分頁，然後按一下加號按鈕。保留預設的 Custom Configuration，不要改用預設範本。
3. 填入 Provider Name、API Key，並將 API Endpoint 設為 https://api.kunavo.com。
4. 展開 Advanced Options，確認 API Format 為 Anthropic Messages (Native)，且 Auth Field 為 ANTHROPIC_AUTH_TOKEN (Default)。兩者都是預設值；此處的重點是確認設定，而不是變更它們。
5. 儲存後，按一下 Activate。卡片不應顯示 Needs Routing 標記——只有需要轉換協定的供應商才會出現該標記。

為什麼不會出現「需要路由」標記

CC Switch 的本機路由用於橋接不同協定。Claude Code 會將 Anthropic Messages 請求傳送至 /v1/messages；只提供 OpenAI Chat Completions 或 Responses API 的閘道無法處理這類請求，因此路由會在送出時轉換請求，並在返回時轉換回應。轉換過程會重新塑造串流事件、工具呼叫和思考設定的格式——這種做法可行，但會在編輯器和模型之間多出一個環節。

Kunavo 直接提供 POST /v1/messages，因此 Claude Code 端無須轉換：供應商維持 Anthropic Messages (Native)，路由完全不會介入。Kunavo 也在同一把金鑰下提供 POST /v1/chat/completions 和 POST /v1/responses，因此才能使用下方的 Codex 設定方式。

在 Codex 中執行 Claude 模型

這是其他供應商指南沒有涵蓋的設定方式。Codex 使用 OpenAI Responses API，因此直接指向 /v1/messages 端點會收到 404——CC Switch 的解法是讓 Codex 維持使用本機路由並進行轉換。在 Codex 分頁中沒有 Anthropic 預設範本，因此同樣需要使用 Custom Configuration：

Provider Name      Kunavo
API Key            sk-kn-...
API Request URL    https://api.kunavo.com
Default Model      claude-sonnet-5

Advanced Options
  Upstream Format  Anthropic Messages (routing required)

模型對應

CC Switch 會將 Claude Code 的三個層級對應至實際模型 ID。請填入全部三個欄位及 Default fallback model——否則，未對應的請求會沿用原本的 Claude 名稱傳送，並在上游報錯。費率以美元／1M 個 token 計，依序為輸入／輸出，並即時從型錄讀取。

先確認，再除錯應用程式

一組成對請求就能確認故障出在金鑰、端點還是 CC Switch。如果兩個請求都回傳 200，其他仍有問題的部分就是表單中的欄位——幾乎總是 Auth Field，或是不該出現在端點中的 /v1。

# Settles whether a failure is the key, the endpoint, or CC Switch.
# 200 + a JSON list of model ids means the same key works in the app.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

# The Anthropic face, which is the one the Claude Code tab actually calls.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

參考資料

CC Switch 是開源軟體，位於 github.com/farion1231/cc-switch。上述欄位名稱和行為取自其自有指南——Claude Code 路由指南和Codex 路由指南，兩份指南都註明適用於 3.17.0 及更新版本。較舊版本的表單有所不同；如果找不到此處提及的欄位，請查看應用程式的「關於」面板。Kunavo 端的文件請參閱Messages API、聊天完成和整合中心。