クイックスタート

このページでは cc-router のダウンロード・インストール手順と、Claude Code への接続方法を説明します。

前提条件

OS：macOS、Windows、または Linux
Claude Code がインストール済み
サポート対象の LLM プロバイダのアカウントと API キーが最低 1 つ（智譜 GLM、DeepSeek、Kimi、MiniMax、Alibaba Bailian など、完全な一覧は README を参照）

ダウンロードとインストール

Releases ページから、お使いのプラットフォーム向けのインストーラを取得してください。

macOS

.dmg ファイルをダウンロードし、ダブルクリックでマウントしてから cc-router を「アプリケーション」にドラッグ。

Windows

.exe または .msi ファイルをダウンロードし、ダブルクリックでインストールウィザードを実行。

Linux

.AppImage または .deb をダウンロード：

.AppImage：chmod +x cc-router_*.AppImage && ./cc-router_*.AppImage
.deb：sudo dpkg -i cc-router_*.deb

仮想モデルの設定

cc-router を初めて起動するとオンボーディングが始まります：

サブスクを追加 —— プロバイダ → 接続先（サブスク / 従量 API）→ API キーを入力。cc-router がそのサブスクで利用可能なモデル一覧を自動取得します
仮想モデルにバインド —— 取得した実モデルを opus / sonnet / haiku の 3 つの仮想スロットへ割り当てます
スケジューリングモードを選択 —— 同じスロットに複数サブスクを紐付けた場合、順次（前者を使い切るか失敗するまで切り替えない）または ラウンドロビン（リクエストごとに巡回）を選びます

プロバイダの追加やスロットの調整は、メイン画面の モデル ページからいつでも変更できます。

Claude Code に接続

起動後、cc-router は 127.0.0.1:23456 でローカルプロキシを待ち受けます。cc-router の設定ページを開き、env スニペット全体をコピーして ~/.claude/settings.json の env フィールドに貼り付けてください：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:23456",
    "ANTHROPIC_AUTH_TOKEN": "アプリ内で表示される実際のトークンを貼り付け",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "model-sonnet",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "model-haiku"
  }
}

model-opus、model-sonnet、model-haiku は cc-router が Claude Code に公開する仮想モデル名です。アプリが裏で実モデル名へ変換します。

モデルが 1M コンテキストに対応している場合は model-opus[1m] という書き方が可能です（Claude Code が解釈する記法）。

ポートが使用中の場合

既定のポート 23456 が使われている場合、cc-router は空きポートまで自動で +1 します。ポート番号を一致させるため、必ず設定ページから最新のスニペットをコピーしてください。

保存後 Claude Code を再起動すれば、リクエストは cc-router 経由で設定した実モデルへルーティングされます。

次のステップ

cc-router のメイン UI で リクエストログ を開き、Claude Code のリクエストが正しくルーティングされているか確認
内蔵されていないプロバイダを追加したい場合は README の「新しい provider の追加」セクションを参照。Claude Code を使っているなら、付属の new-provider スキルを実行すれば provider 設定を自動生成できます