クイックスタート

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

前提条件

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

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

OS とアーキテクチャに合ったパッケージを選んでください。2 つのダウンロード元の中身はまったく同じで、中国本土からは「中国ミラー」のほうが高速です。リンクは常に最新バージョンを指します。過去のバージョンは Releases ページに、全パッケージの一覧はダウンロードページにもあります。

macOS

アーキテクチャ	パッケージ	ダウンロード
Apple Silicon（M シリーズ）	`cc-router_macOS-arm64.dmg`	グローバル · 中国ミラー
Intel	`cc-router_macOS-x64.dmg`	グローバル · 中国ミラー

どちらか分からない場合は、画面左上の Apple メニュー →「この Mac について」を開きます。「チップ Apple M…」と表示されていれば Apple Silicon、「プロセッサ … Intel …」と表示されていれば Intel を選んでください。

.dmg をダブルクリックしてマウントし、cc-router を「アプリケーション」フォルダにドラッグします。

Windows

アーキテクチャ	パッケージ	ダウンロード
x64	`cc-router_windows-x64-setup.exe`	グローバル · 中国ミラー
x64（MSI）	`cc-router_windows-x64.msi`	グローバル · 中国ミラー
ARM64	`cc-router_windows-arm64-setup.exe`	グローバル · 中国ミラー

個人の PC なら setup.exe がおすすめです。グループポリシーやソフトウェア配布ツールで一括展開する場合は .msi を使ってください。ダウンロードしたファイルをダブルクリックするとインストーラーが起動します。Windows で Claude Desktop と組み合わせて使う方法は Claude Desktop 連携（Windows）を参照してください。

Linux

アーキテクチャ	パッケージ	ダウンロード
x64 · AppImage	`cc-router_linux-x64.AppImage`	グローバル · 中国ミラー
x64 · deb	`cc-router_linux-x64.deb`	グローバル · 中国ミラー
ARM64 · AppImage	`cc-router_linux-arm64.AppImage`	グローバル · 中国ミラー
ARM64 · deb	`cc-router_linux-arm64.deb`	グローバル · 中国ミラー

.AppImage（推奨。アプリ内の自動更新に対応）：chmod +x cc-router_linux-*.AppImage && ./cc-router_linux-*.AppImage
.deb（Debian / Ubuntu）：sudo apt install ./cc-router_linux-*.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 設定を自動生成できます