Claude Code Router

CCR 現在是桌面應用程式，不再使用 config.json：將 Kunavo 新增為自訂 API 端點，接著讓路由規則將每種請求類別傳送至不同模型。

Providers → Add provider
  Preset provider   Other / custom API endpoint
  Name              Kunavo
  API endpoint      https://api.kunavo.com
  API key           sk-kn-...
  Models            claude-sonnet-5, claude-opus-5, claude-haiku-4-5

Agent Config → Add profile → Claude Code
  Model         Kunavo/claude-sonnet-5
  Opus model    Kunavo/claude-opus-5
  Haiku model   Kunavo/claude-haiku-4-5

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 在 CCR Desktop 中開啟 Providers → Add provider，選取預設項目 Other / custom API endpoint，然後填入 Name、API endpoint 和 API key。
3. 在 Models 下新增模型 ID——使用 Search models 載入型錄，或透過 Custom models 手動輸入 ID。
4. 對兩到三個模型執行 Check Connection。這會送出真實請求，因此只選取要驗證的模型即可，不必勾選整份清單。
5. 開啟 Agent Config → Add profile → Claude Code，設定 Model 和各級別的 Opus／Sonnet／Haiku 覆寫項目，儲存後再從 CCR 啟動 Claude Code。

已於 2026年9月6日 根據 CCR 提供者設定頁面 進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Claude Code Router 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
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-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

為什麼各級別對應是關鍵

Claude Code 會依級別而非個別請求來選擇模型：主要循環會要求 Sonnet 或 Opus 級別，而背景工作——子代理程式、搜尋、摘要——則會要求小型／快速模型。CCR 的 Agent Config 將這些級別分別設為獨立欄位，因此昂貴的模型只處理需要它的請求，而請求量大的級別則使用便宜的 ID。這正是要在 Claude Code 前方使用路由器的原因，而從 Claude Code 自己的設定中看不出這項差異。