ドキュメント

ドキュメント

Claude Code Router

CCRはClaude Codeとモデル提供元の間に位置するため、リクエストの種類ごとに異なる接続先を指定できます。Kunavoをカスタムエンドポイントとして追加し、Agent ConfigでClaudeの各ティアをモデルIDに割り当てます。

CCRは現在デスクトップアプリであり、config.jsonではありません:KunavoをカスタムAPIエンドポイントとして追加し、ルーティングルールで各リクエスト種別を別のモデルへ送ります。

CCR Desktop
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
config.jsonを手動で編集しても、もう反映されません。 CCRはランタイム設定を~/.claude-code-router/config.sqliteに保存します。SQLite設定がない場合に限り、移行元として従来のconfig.jsonを一度だけ読み込みます。初回実行後は、JSONファイルを編集しても通知なく無視されます。インターネット上の解説の多くと、以前の当社ガイドも、依然としてJSONファイルについて説明しています。
ここで指定するAPIエンドポイントは、ベースURLを含まないオリジンのhttps://api.kunavo.comです。CCRはこれに対してプロトコルを判定し、Kunavoは/v1/messagesでAnthropic Messages形式をネイティブに提供します。CCRにOpenAI互換形式で接続させたい場合は、代わりにhttps://api.kunavo.com/v1を指定してください。どちらのエンドポイントも同じキーで利用できます。
まだキーをお持ちですか?Kunavoアカウントを作成し、キーを作成します(sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Claude Code Router設定が表示されます。

手順

  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. 2つか3つのモデルでCheck Connectionを実行します。実際のリクエストを送信するため、一覧全体ではなく、確認に必要なモデルだけを選択してください。
  5. Agent Config → Add profile → Claude Codeを開き、ModelとティアごとのOpus/Sonnet/Haikuの上書き設定を行って保存し、CCRからClaude Codeを起動します。

CCRのプロバイダー設定ページで2026年9月6日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

これが短い概要です。完全な手順 — モデルの選択、実際のセッション費用、失敗するケース — はClaude Code Routerガイドにあります。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これが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、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

モデル IDKunavo 入力 / 出力Claude Code Routerでの位置付け
claude-opus-5$3.50 / $17.50Opusティア — 計画立案と難しい編集向け
claude-sonnet-5$1.40 / $7.00Sonnetティアとプロファイルのデフォルト
claude-haiku-4-5$0.70 / $3.50Haikuティア。サブエージェントの処理量を受け持ちます。
gpt-5-6-terra$0.70 / $4.20同じプロバイダーエントリから利用できる、長いコンテキスト向けのルート
請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト(エディターやチャットクライアントが送る内容の大半)では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

ティアごとの割り当てが重要な理由

Claude Codeはリクエストごとではなく、ティアごとにモデルを選びます。メインループはSonnetまたはOpusティアを使い、サブエージェント、検索、要約などのバックグラウンド処理は小型で高速なティアを使います。CCRのAgent Configでは各ティアを個別のフィールドで設定できるため、高価なモデルを必要なリクエストだけに使い、処理量の多いティアには安価なIDを割り当てられます。これがClaude Codeの前段にルーターを置く理由のすべてであり、Claude Code自体の設定からは確認できません。

よくある質問

Claude Code Routerは設定をどこに保存しますか?

SQLiteデータベースに保存します。macOSとLinuxでは~/.claude-code-router/config.sqlite、Windowsでは%APPDATA%\claude-code-router\config.sqliteです。従来のconfig.jsonは、SQLite設定がまだない場合に限り、移行元として一度だけ読み込まれます。移行後にconfig.jsonを編集しても、実行中の設定には反映されません。設定はデスクトップUIから変更してください。

Claude Code RouterにカスタムAPIエンドポイントを追加するには?

Providersを開き、Add providerをクリックして、プリセット「Other / custom API endpoint」を選択します。このプリセットは、OpenAI、Anthropic、Geminiのいずれかと互換性のあるアップストリームに対応しています。一意のName、API endpointのベースURL、API keyを入力し、モデルIDを取得するか、Custom modelsに直接入力して追加します。Check Connectionは、エンドポイント、キー、プロトコル、IDが連携して動作するか確認するため、実際のテストリクエストを送信します。

Claude Code Routerで、Claudeのティアごとに異なるモデルを割り当てられますか?

はい。それがClaude Code Routerを使う主な理由です。Agent ConfigのClaude Codeプロファイルには、デフォルトのModelに加えて、必要に応じてFable、Opus、Sonnet、Haikuの上書き設定を指定できます。Claude Codeは特定のIDではなくティアをリクエストするため、Haikuティアを安価なモデルに、Opusティアを高性能なモデルに割り当てれば、エージェント本来の動作に合わせて請求を分けられます。処理量の多いバックグラウンド作業には安価なIDを使い、計画立案には高価なIDを使います。

Claude Code RouterはAnthropic形式のゲートウェイに対応していますか?

はい。カスタムエンドポイントのプリセットは、指定したURLに対してプロトコルを判定し、対応プロトコルの1つとしてAnthropic Messagesをサポートしています。そのため、/v1/messagesを公開するゲートウェイは、オリジンをAPIエンドポイントとして直接追加できます。OpenAI互換のインターフェースも公開しているゲートウェイは、どちらの方法でも追加できます。違いは、CCRが接続時に使う通信形式だけです。