連携ガイド

Claude Code

Claude Code v2.x は Anthropic Messages API で通信します。接続先を https://www.coderouter.io に向け（/v1/messages は Claude Code が自動で付け足します）、モデルには auto を指定してください。

1 行でセットアップ

curl -fsSL https://www.coderouter.io/setup.sh | bash -s -- cr_YOUR_KEY_HERE
claude

このスクリプトは、下記の変数を ~/.claude/settings.json の env ブロックに追加し、ほかの設定には手を加えません。まず既存のファイルをバックアップし、CodeRouter でキーを確認し（モデルは呼び出しません）、何を変更したかを正確に表示します。シェルに ANTHROPIC_API_KEY が設定されている場合は警告も出します。動作には python3 または node が必要です（macOS と Linux）。元に戻すには curl -fsSL https://www.coderouter.io/setup.sh | bash -s -- --uninstall を実行します。API キーのページには、ご自身のキーが入った状態のコマンドが表示されます。

または：このセッションだけ環境変数で設定

export ANTHROPIC_BASE_URL=https://www.coderouter.io
export ANTHROPIC_AUTH_TOKEN=cr_YOUR_KEY_HERE
export ANTHROPIC_MODEL=auto
export ANTHROPIC_DEFAULT_OPUS_MODEL=auto
export ANTHROPIC_DEFAULT_SONNET_MODEL=auto
export ANTHROPIC_DEFAULT_HAIKU_MODEL=auto

# v2.x の実験的ベータ機能は、サードパーティのゲートウェイで不具合を起こすことがあります。
# この環境変数で無効にします。常に設定したままでも問題ありません。
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

claude

または手動で — ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.coderouter.io",
    "ANTHROPIC_AUTH_TOKEN": "cr_YOUR_KEY_HERE",
    "ANTHROPIC_MODEL": "auto",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "auto",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "auto",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "auto",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

CodeRouter を経由しているか確認する

起動後、Claude Code のヘッダーに Claude Max ではなく API Usage Billing と表示されていれば正しく設定できています。Claude Max と表示される場合は、Claude へのログインが認証情報として使われています。/status を実行して Claude Code がどの認証情報を選んだかを確認し、ログアウトしてから起動し直してください：

/logout               # Claude Code の中で実行
claude auth logout    # またはシェルから実行
# その後 claude を再起動します（変数を export した場合は、その変数が入ったシェルから）

Codex CLI

Codex CLI は OpenAI Responses API で通信します。CodeRouter はこれを https://www.coderouter.io/api/v1/responses で提供しています。Codex の設定で wire_api = "responses" を付けて CodeRouter をモデルプロバイダーとして追加し、モデルには auto を指定してください。

~/.codex/config.toml

model = "auto"
model_provider = "coderouter"

[model_providers.coderouter]
name = "CodeRouter"
base_url = "https://www.coderouter.io/api/v1"
env_key = "CODEROUTER_API_KEY"
wire_api = "responses"

キーの設定

export CODEROUTER_API_KEY=cr_YOUR_KEY_HERE   # 永続化するには ~/.zshrc か ~/.bashrc に追記します
codex

Cursor

Cursor はモデル名を文字列のホワイトリストで管理しているため、ピッカーに表示させるには auto をカスタムモデルとして追加する必要があります。設定は UI だけで完結し、環境変数は不要です。

1. Cursor を開き、Cmd+Shift+P（または Ctrl+Shift+P）を押して「Cursor Settings」と入力します
2. 左サイドバーの Models をクリックします
3. OpenAI API Key セクションで 「Override OpenAI Base URL」 をオンにし、次の値を貼り付けます：
   • URL：https://www.coderouter.io/api/v1
   • キー：cr_YOUR_KEY_HERE
4. Verify をクリックします。緑の ✓ が表示されれば成功です
5. Models まで上にスクロールし、+ Add custom model をクリックして auto と入力します
6. auto のチェックボックスをオンにして有効にします
7. チャットのモデル選択（チャット右上のドロップダウン）で auto を選びます

トラブルシューティング

「There's an issue with the selected model (auto)」

Claude Code でのみ発生します。原因は 3 つ考えられます（可能性の高い順）：

1. cr_ キーが認証情報として使われておらず、リクエストが Claude のサブスクリプションに送られています（たとえば、キーを ANTHROPIC_API_KEY に設定していて Claude Code が承認後にしか使わない場合や、セットアップ前にセッションを開始していた場合）。キーを ANTHROPIC_AUTH_TOKEN に設定して Claude Code を再起動し、/status を確認したうえで、バッジが Claude Max ではなく API Usage Billing になっていることを確かめてください。
2. 古い Claude Code v2.1.x で新しいベータ機能が有効になっている場合です。env に CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 を追加してください。
3. ベース URL の形式が誤っていて、リクエストに /v1 が二重に付いている場合です。CodeRouter は内部のリライトにより、https://www.coderouter.io と https://www.coderouter.io/api/v1 のどちらも受け付けます。

「Your free trial has ended」／「usage credit is used up」（HTTP 429）

無料トライアルは 7 日間で $5 分の使用量があり、クレジットカードは不要です。登録から 7 日が経過するか、クレジットを使い切るかの早いほうで終了し、その後のリクエストにはこれらのメッセージのいずれかとともに HTTP 429 が返ります。使い続けるには、残高をチャージして従量課金で利用するか（/pricing を参照）、/dashboard/models でご自身のプロバイダーキーを追加して、そのキーで利用してください。クレジットの残りが少なくなると、入力だけで残りのクレジットとほぼ同じ額がかかるリクエストには「usage credit is used up for this request」が返り、必要な額と残額が示されます。短いリクエストであれば通る場合があります（CodeRouter が変更するパラメーターを参照）。

「Rate limit exceeded」（HTTP 429）

キー単位とユーザー単位のレート制限があります。デフォルト値：無料トライアル 60、従量課金 1,000、Team 2,400 リクエスト/分（以前のプランはそれぞれの上限のままです）。再試行のタイミングは、レスポンスヘッダーの X-RateLimit-Reset で確認してください。

そのほかのエラー

次の情報を添えて support@coderouter.io までメールしてください：

• 正確なエラーメッセージと HTTP ステータスコード
• エージェントの名前とバージョン
• 再現用の curl コマンド全体（cr_ キーは除いてください）

その他のツールと詳細

以下のツールの設定、確認手順、CodeRouter が変更するパラメーター、長い会話の扱い、コーディングエージェントのセッションのルーティング方法、エラーの一覧は英語のガイドにあります：

• Aider
• Cline
• Continue.dev
• OpenClaw
• GitHub Copilot
• OpenAI SDK
• Anthropic SDK
• セットアップの確認（ドライラン、レスポンスヘッダー）
• CodeRouter が変更するパラメーター
• コーディングエージェントのセッション（ルーティングポリシー）
• すべてのエラー