CC Switch

項目は3つ、ドロップダウンは2つです。エンドポイントに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マーカーが表示されるのは、プロトコルの変換が必要なプロバイダーだけです。

「Needs Routing」マーカーが表示されない理由

CC Switchのローカルルートは、プロトコル間の橋渡しをします。Claude CodeはAnthropic Messagesリクエストを/v1/messagesに送信します。OpenAI Chat CompletionsまたはResponses APIしか公開していないゲートウェイは、このリクエストに応答できないため、ルートが送信時にリクエストを変換し、応答時に元へ変換します。この変換では、ストリーミングイベント、ツール呼び出し、thinking設定の形式が組み替えられます。機能はしますが、エディターとモデルの間にもう1つの処理が加わります。

KunavoはPOST /v1/messagesを直接提供するため、Claude Code側では変換が不要です。プロバイダーはAnthropic Messages (Native)のままになり、ルートは経由しません。また、同じキーで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の3つのティアを実際のモデルIDに割り当てます。3つすべてとDefault fallback modelを設定してください。そうしないと、一致しないリクエストが元のClaude名のまま送信され、上流でエラーになります。料金はカタログからリアルタイムで取得した、100万トークンあたりの米ドル建て料金（入力／出力）です。

アプリのデバッグ前に確認する

リクエストを1組（2件）送れば、失敗の原因がキー、エンドポイント、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以降が対象です。それ以前のバージョンではフォームが異なります。ここに記載したフィールドが見つからない場合は、アプリの「About」画面を確認してください。Kunavo側の仕様は、Messages API、チャット補完、インテグレーションハブで説明しています。