CC Switch 4.0 の集約モードとワンクリック取り込み
2026-10-13 時点、CC Switch 4.0 は直接接続・ルーティング・集約を各アプリ画面の上部にある 3 つのタブへ分離しました。公式リリースノートは、新しく搭載された集約モードについて、複数プロバイダのモデルを Claude Code や Codex の同じモデル一覧に載せて選んだモデルのプロバイダへリクエストが飛ぶものだと説明しています。本ページの CC Switch に関する記述は公式リリースノートと README に基づき、v4.0.0 は 2026-10-04、v4.0.10 は 2026-10-12 に公開され、公式リリース一覧で最も新しいのは 2026-10-13 に公開された v4.0.11 です。CC Switch 自体のコマンドライン版はありません。公式 README はグラフィカルインターフェースを必要とするデスクトップアプリのみと明記しています。v4.0.10 からはアプリ未起動時の ccswitch:// ディープリンクが失われなくなり、リンクは API 形式を宣言でき、取り込み直後に切り替えるかも選べます。
更新日 2026-10-13
このツールを QCode エンドポイントに接続。Claude・GPT・中国系モデルを 1 キーで。
- トークン従量課金・最新単価は /models
- カード（Visa / Mastercard / AMEX）・Apple Pay・Google Pay・暗号資産で支払い可能
- チャージ後すぐにセルフサービスで開通
4 つの要点
直接接続 / ルーティング / 集約
公式リリースノートによれば、各アプリ画面の上部がこの 3 タブになり、タブをクリックしただけでは表示内容が変わるだけで設定は書き換わりません。モードを切り替えるボタンは何が起きるかを表示し、直接接続への復帰は 1 回ででき、取り消しも可能です。
集約が必要とする Claude Code のバージョン
公式 README の集約の項は、集約はフェイルオーバーを提供せず、Claude Code は 2.1.243 以上が必要と明記しています。一覧が変わった後は Codex の再起動が必要で、Claude Code は不要です。
ワンクリック取り込みリンク
v4.0.10 の中心です。公式の記述では、アプリが起動していない時にリンクを押しても失われなくなりました。リンクはまず保存され、確認ダイアログが表示されて初めて処理完了扱いになります。確認ダイアログには取り込み直後にこのプロバイダへ切り替えるスイッチが増え、既定はオフです。
リンクが API 形式を宣言
v4.0.10 のサイト管理者向け新パラメータです。1 つのパラメータでそのサービスの API 形式（anthropic、openai_chat、openai_responses など）を宣言し、CC Switch が各アプリ側の項目に置き換えます。このパラメータのないリンクの挙動は変わりません。
集約モードは何をする機能か
2026-10-13 時点、集約は CC Switch 4.0 が追加した 3 番目の接続方法で、公式リリースノートは、新しく搭載された集約モードが複数プロバイダのモデルを Claude Code や Codex の同じモデル一覧に載せてクライアント内で切り替えられるものだと説明しています。対象にした困りごとも具体的です。以前は別プロバイダのモデルを使いたければ、まず CC Switch に戻してプロバイダを切り替え、それからクライアントで作業を再開する必要がありました。今は複数社を追加すれば、それらのモデルがクライアントのモデル選択画面に並ぶので、選んだモデルのプロバイダへリクエストが飛びます。公式の限界も明確です。集約は手動で有効化する必要があり、対応は Claude Code と Codex、選んだモデル単位で振り分け、フェイルオーバーは提供しません。形式変換とフェイルオーバーはルーティング側の機能です。README は前提を 2 つ足しており、Claude Code は 2.1.243 以上が必要で、Claude の公式サブスクリプションは現時点で集約に対応しません。このバージョンでは設定の書き方も作り替えられ、プロバイダ切り替えはアドレス・認証情報・モデル・プロトコルの 4 項目だけを置き換え、その他はそのまま残ります。
公式リリースノートの内容と日付
v4.0.0 の本文は冒頭でこれをこれまでで最大の更新と呼び、GitHub の公式リリースには published_at が 2026-10-04T11:01:01Z、元データの prerelease は true と記録されています。v4.0.10 の小見出しは 4.0 正式版の 6 番目の修正版で、published_at は 2026-10-12T16:38:21Z、prerelease は false です。本文の 1 文目は、この版の重点がワンクリック取り込みリンク（ccswitch:// ディープリンク）にあると明記し、中国語・英語・日本語のサイト管理者向けガイドとオンラインのリンク生成器も同時に公開されています。その後の 2026-10-13 に v4.0.11 が公開されました（GitHub の元データでは published_at が 2026-10-13T15:35:29Z、prerelease が false）。本ページが確認した時点では公式リリース一覧の最も新しい 1 件です。この版についてリリースノートは、アプリページにインストール済みツールをアンインストールする入口を増やし、プラン型の枠の確認をすべてのアプリで既定オンにしたと説明しています。v4.0.10 では接続モードの説明も書き直し、各モードの長所から述べています。直接接続はクライアント本来の使い方にもっと近く、ルーティングはプロバイダをホットで切り替えフェイルオーバーと形式変換ができ、集約はクライアント内で複数社のモデルを切り替えられます。背景も触れられており、CC Switch は 2025 年 8 月に発表され、当時は各社の API 形式の差が大きく、プロバイダ切り替えは全体の上書きで実装されていました。それが主要フィールドの置換へ作り替えられた形です。
4.0 前後のタイムライン
CC Switch の公式 GitHub リリース一覧で最も古い 1 件は v2.0.3 で、published_at は 2025-08-22T00:12:40Z です。v4.0.0 のリリースノートは CC Switch の発表を 2025 年 8 月としています。
v4.0.0 が公開（GitHub の元データでは prerelease が true）。サイドバーからトレイまで UI が作り替えられ、集約モードが導入され、設定書き込みは全体書き換えから主要フィールドの置換へ変わりました。
v4.0.10 が公開（prerelease は false）。ccswitch:// リンクが未起動でも失われなくなり、apiFormat などの管理者向けパラメータとオンライン生成器が追加され、ルーティングモードで settings.json に書かれる haiku の別名も claude-haiku-4-5 から claude-haiku-5-5 へ変わりました。
確認済みと公式が書いていないこと
確認済み（公式リリースノートと README で一字一句照合可能）
以下は本ページで取得した公式本文と README の原文で一字一句確認できる項目です。直接接続・ルーティング・集約の 3 タブ分離と、タブクリックでは設定が変わらないこと。集約が複数プロバイダのモデルを Claude Code と Codex の同一一覧に載せ、選んだモデル単位で振り分けること。集約は手動有効化で対応は Claude Code と Codex、フェイルオーバー非対応、Claude Code は 2.1.243 以上が必要、Claude の公式サブスクリプションは現時点で集約未対応。一覧変更後は Codex が再起動必要で Claude Code は不要。プロバイダ切り替えは全体書き換えから、アドレス・認証情報・モデル・プロトコルの置換へ変わりました。v4.0.10 は未起動時のディープリンク消失を直し、確認ダイアログに即切替スイッチ（既定オフ）と apiFormat を追加。オンライン生成器はプロバイダ・MCP・プロンプト・Skill の 4 種。公開日は v4.0.0 が 2026-10-04、v4.0.10 が 2026-10-12、v4.0.11 が 2026-10-13 で、いずれも GitHub の published_at に基づきます。
未確認と公式が示していない範囲
3 点は一次資料がないため、前提にしないでください。1 点目、CC Switch 自体のコマンドライン版です。公式 README はグラフィカルインターフェースを要するデスクトップアプリのみと明記し、例外として挙げるのは別建てで公開されるコミュニティ製の CC Switch CLI だけです。よって本ページはターミナルから CC Switch を操作するコマンドを書いていません。2 点目、公式リリース同士の正式版の言い方が一致しません。v4.0.0 は prerelease が true、v4.0.10 は 4.0 を正式版と呼び prerelease が false で、続く v4.0.11 も prerelease が false です。本ページは published_at の日付だけを載せ、結論を出していません。3 点目、同種ツールとの優劣をめぐるネット上の議論は照合できる資料がなく、本ページでは扱いません。v4.0.10 はデータベース構造が引き続き 20 と明記しますが、それは将来のバージョンへの互換の約束ではありません。
直接接続・ルーティング・集約の選び方
直接接続 対 ルーティング
公式リリースノートの区分では、直接接続はクライアントがそのままプロバイダへ接続する方法で日常向き、ルーティングはローカルルーティング経由で 1 つのプロバイダへ転送し、API 形式の変換とフェイルオーバー設定ができるため、プロトコル非対応かフェイルオーバーが必要な場合に向きます。QCode を使う Codex 設定でローカルルーティングを有効にする必要はありません。QCode ドキュメントは、Codex プロバイダ編集画面のローカルルーティングマッピングのスイッチが Chat Completions のみのサービス向けだと記し、Responses プロトコルを提供する QCode ではオフにするよう案内しています。
ルーティング 対 集約
どちらもローカルルーティングを通しますが、振り分け方が違います。ルーティングは 1 つのプロバイダへ転送し、集約は選んだモデルに応じて複数社へ振り分けます。1 つのセッションで複数社のモデルを混ぜる用途です。集約はフェイルオーバーを提供せず、手動有効化で、対応は Claude Code と Codex のみ、Claude の公式サブスクリプションは現時点で集約に使えません。公式の注意として、セッション途中でモデルを切り替えると新しい側がプロンプトキャッシュを再構築するため、切り替え直後の 1 ターンの費用がはっきり高くなります。
CC Switch 4.0 に QCode を追加する手順
① 導入または更新：公式 README はデスクトップ版のパッケージとパッケージマネータのコマンドを示しています。Windows 10 以上は msi かポータブル版の zip、macOS 12 以上は brew install --cask cc-switch、Arch は paru -S cc-switch-bin、そのほかの Linux は .deb、.rpm、.AppImage です。ターミナル利用について README は率直で、CC Switch 本体はグラフィカルインターフェースを要するデスクトップアプリのみ、サーバー・SSH・デスクトップ環境のないマシンでは別建てのコミュニティ製 CC Switch CLI を推奨すると書かれています。この CLI は対話型のターミナル UI（TUI）とコマンドラインモードの両方を持ち、brew install cc-switch-cli で導入できます。README は、既定でデスクトップ版と ~/.cc-switch データディレクトリを共有する点、CLI が対応するデータベースのバージョンがデスクトップ版に時々遅れる点も注意しています。② Claude 側は QCode ドキュメントどおりに：CC Switch を起動し、上部のアプリ切り替えで Claude を選び、右上の追加ボタンでプロバイダを作成、プリセットでカスタムを選択し、ANTHROPIC_BASE_URL に https://api.qcode.cc/api、ANTHROPIC_AUTH_TOKEN にコンソールで取得した cr_ 始まりのキーを入れます。保存後そのカードの Enable を押すと CC Switch がこの 2 項目を ~/.claude/settings.json に書き込み、ターミナルで claude を実行して接続を確認します。③ Codex 側：Codex でカスタムプロバイダを追加し、Base URL を https://api.qcode.cc/openai にします。QCode ドキュメントの config.toml ではプロバイダ名を qcode（TOML のキー名になるため小文字推奨）としています。wire_api は responses、既定のモデルは gpt-6-sol または gpt-5.6-terra、ローカルルーティングマッピングのスイッチはオフのままにします。Codex のバージョンは手元の codex --version の表示を基準にしてください。④ 集約を使う：Claude または Codex 画面で集約タブを開き、混ぜたい各社を追加し、そのうち 1 社を既定に選べば、集約モデルを指定しなかったリクエストはそこへ送られます。一覧が変わったら案内どおりクライアントを再起動します。Codex CLI はバナーからバックグラウンドサービスを 1 クリックで再起動できます。⑤ リンクで取り込む：ccswitch:// リンクを開くと取り込みの確認ダイアログが表示され、取り込み直後に切り替えたければそこのスイッチをオンにします（既定はオフ）。オンにすると、クライアントのリクエストはリンク内のアドレスへ切り替えられると案内されます。QCode ドキュメントは、ディープリンクで初めて起動されるとウィンドウを作り直して少し時間がかかると補足しています。
QCode の場合
CC Switch はそれ自体が推論エンドポイントではなく、各 CLI の設定ファイルを書くだけです。実際に働くのは QCode で発行したキーになります。コンソールで発行する cr_ 始まりのキー 1 本で 2 つのプロトコルが使えます。キーはプロトコルを区別せず、形式はリクエストのパスが決めるためです。Claude 用のプロバイダは ANTHROPIC_BASE_URL に https://api.qcode.cc/api（Anthropic プロトコル、完全なパスは /api/v1/messages）、Codex 用は base_url に https://api.qcode.cc/openai、wire_api に responses を入れます。Claude モデルは Anthropic プロトコルのエンドポイントのみで、OpenAI 互換のパスに入れるとエラーになります。QCode で呼び出せるモデル ID には claude-sonnet-5、claude-sonnet-5-5、claude-opus-5、claude-opus-5-5、claude-haiku-5-5、gpt-6.1-sol、gpt-6-sol、gpt-5.6-sol、gpt-5.6-terra が挙げられます。開始は前払い制で、まずチャージし、その残高からプランを購入します。Alipay、WeChat Pay、クレジットカード（Visa、Mastercard、AMEX）、Apple Pay、Google Pay、暗号資産（多通貨・多ネットワーク）が使え、人民元チャージは ¥100 から、ドルチャージの範囲は $1 から $2,000 です。課金はトークン単位で、モデル別の料金は /models に掲載されています。
よくある質問
CC Switch 4.0 の集約モードとは何ですか？
複数プロバイダのモデルを 1 つのモデル一覧にまとめる機能です。公式リリースノートは、集約モードが複数プロバイダのモデルを Claude Code や Codex の同じモデル一覧に載せ、クライアント内で切り替えられると説明します。選んだモデルのプロバイダへリクエストが飛ぶので、クライアントを離れる必要はありません。手動で有効化が必要、対応は Claude Code と Codex、振り分けはモデル単位、フェイルオーバーは提供しません。
CC Switch にコマンドライン版（CLI）はありますか？
CC Switch 本体にはありません。公式 README のコマンドライン版やヘッドレス版の有無に関する質問への回答は率直で、CC Switch はグラフィカルインターフェースを要するデスクトップアプリとしてのみ公開されるとしています。サーバー、SSH、デスクトップ環境のないマシン向けには、別建てで公開されるコミュニティ製の CC Switch CLI が挙げられています。これは対話型のターミナル UI（TUI）とコマンドラインモードの両方を持ち、brew install cc-switch-cli で導入でき、既定ではデスクトップ版と ~/.cc-switch データディレクトリを共有します。ただし README は、CLI が対応するデータベースのバージョンがデスクトップ版に時々遅れると注意しています。README にある別の CLI 関連機能は Apps 画面で、これは Claude Code や Codex といったコマンドラインツール自体のバージョンを確認して更新するもので、CC Switch をターミナルから操作する仕組みではありません。よって本ページはターミナルから CC Switch を操作するコマンドを挙げていません（掲載の導入コマンドは README の原文です）。
ccswitch:// の取り込みリンクはアプリ未起動だと失われますか？
v4.0.10 以降は失われません。公式本文は従来の挙動を次のように記しています。Windows と Linux では、未起動時にリンクを押すとアプリは起動するものの確認ダイアログが出ず、軽量モードではウィンドウの再構築時に失われ、macOS では同じリンクに確認が 2 度出ていました。現在はリンクがまず保存され、確認ダイアログが表示されて初めて処理完了扱いとなるため、途中で中断されても失われず、後から届いた古いリンクが新しいものを上書きすることもありません。QCode ドキュメントは、ディープリンクで初めて起動されるとウィンドウを作り直して少し遅くなると補足しています。
CC Switch の Claude 用と Codex 用のプロバイダには、どのエンドポイントを入れますか？
クライアントごとに QCode のプロバイダを 1 つずつ保存します。Claude 側は ANTHROPIC_BASE_URL に https://api.qcode.cc/api と cr_ 始まりのキー、Codex 側は base_url に https://api.qcode.cc/openai と wire_api の responses を入れます。どちらも同じ QCode.cc の API Key を使い、QCode のドキュメントによればプラン枠は共有で二重課金にはなりません。Claude モデルは Anthropic プロトコルのエンドポイント限定で、OpenAI 互換のパスには入れられません。
集約モードで注意すべき点は？
公式が書くのは 5 点です。Claude Code は 2.1.243 以上が必要。集約はフェイルオーバーを提供しない。手動有効化で対応は Claude Code と Codex、Claude の公式サブスクリプションは現時点で集約に使えない。一覧変更後は Codex が再起動必要で Claude Code は不要。セッション途中でモデルを切り替えると新しいモデルがプロンプトキャッシュを再構築するため、切り替え直後の 1 ターンの費用がはっきり高くなる、という点です。
中国本土で QCode にチャージするには？
Alipay か WeChat Pay が使えます。QCode の支払いドキュメントは、中国本土で人民元で支払う場合 Alipay が第一候補（手数料は転嫁しない）で WeChat が代替となり、どちらも人民元建て残高に加算されると記しています。金額制限も掲載されており、人民元チャージは ¥100 から。チャージ後にコンソールの cr_ 始まりキーを CC Switch のカスタムプロバイダに入れて開始します。課金はトークン単位で、モデル別の料金は /models に掲載されています。
情報源
CC Switch 側：公式リポジトリ farion1231/cc-switch の 2 件の GitHub リリースの本文とメタデータ（v4.0.0 は published_at 2026-10-04T11:01:01Z・prerelease true、v4.0.10 は published_at 2026-10-12T16:38:21Z・prerelease false）、および main ブランチの README を 2026-10-13 に取得して保存しました。QCode 側：docs.qcode.cc の CC Switch 設定ページ（ページ内に更新 2026-10-08 と表記）、エンドポイントと API パスのページ、支払い方法の総覧（更新 2026-10-01）を同日に取得しました。v4.0.11 のリリースノートと公式リリース一覧は 2026-10-14 に取得しました。
関連記事
CC Switch の使い方：Claude Code と Codex の API 切り替え
CC Switch の Claude 画面でカスタムプロバイダを作り、ANTHROPIC_BASE_URL に https://api.qcode.cc/api と cr_ キーを入れ、Enable で settings.json へ書き込みます。Codex は /openai を別に作成。反映されない場合と 401 の点検も載っています。
Codex CLI のサードパーティ API 設定：config.toml・base_url・エラー
config.toml の model_provider、base_url、wire_api、env_key の書き方と、よくあるエラーの読み方をまとめています。
中国で Claude Code を使う 2026｜Alipay・WeChat Pay
中国本土で ANTHROPIC_BASE_URL を QCode に向け、Alipay か WeChat Pay でチャージして開始します。
本ページの内容は 2026-10-13 に確認し、現在の最新版を示すリリースの記録は 2026-10-14 に取り直して照合しました。CC Switch はサードパーティのオープンソースツール（MIT ライセンス）で、機能・画面の文言・切り替えの挙動は公式のリリースページと README を基準とします。本ページは互換性に代わって約束をせず、両プロジェクトの見解を代弁するものではありません。QCode 側の設定項目と支払いは公式ドキュメントに従い、変更が予告なく行われる場合があります。モデルの利用可否は /models を基準にしてください。