使い方ガイド · 2026-10-13 時点

CC Switch の使い方:Claude Code と Codex の API をワンクリックで切り替え

2026-10-13 時点で、CC Switch で Claude Code の API を切り替える手順は次の通りです。Claude のページで右上の「+」からカスタム設定を作り、ANTHROPIC_BASE_URL に https://api.qcode.cc/api、ANTHROPIC_AUTH_TOKEN に cr_ で始まるキーを入れて保存し、カードの「有効化」を押します。CC Switch がこの二つを ~/.claude/settings.json に書き込み、別のカードで「有効化」を押せばそちらに切り替わります。Codex は Codex のページで別の設定を作り、Base URL に https://api.qcode.cc/openai を入れます。4.0 系列は正式版になっており、2026-10-13 時点の最新の正式版は 2026-10-13 公開の v4.0.11 です(その前の v4.0.10 は 2026-10-12 公開)。4.0 で集約モードが追加され、v4.0.10 の重点は ccswitch:// のワンクリック取り込みリンク、v4.0.11 は「アプリ」ページでインストール済みツールをアンインストールする機能で、詳細は下の各節にあります。本ページでは QCode のドキュメントと CC Switch 公式 README に沿って、インストール、設定、切り替え、よくある問題を整理しました。

更新日 2026-10-14

このツールを QCode エンドポイントに接続。Claude・GPT・中国系モデルを 1 キーで。

#インストールと動作環境#Claude Code の設定#Codex の設定#切り替えが反映されない

設定前に押さえる四つのこと

/api

Claude Code のアドレス

ANTHROPIC_BASE_URL に https://api.qcode.cc/api、ANTHROPIC_AUTH_TOKEN に cr_ で始まるキーを入れます。末尾にスラッシュは付けません。

/openai

Codex のアドレス

Base URL は https://api.qcode.cc/openai で、/openai/v1 ではありません。生成される config.toml の wire_api = "responses" は残します。

有効化

切り替えはこのワンクリック

Claude Code と Codex は、それぞれ同時に有効な設定が一つだけです。別のカードで「有効化」を押すと、CC Switch がその組を設定ファイルに書き戻します。

v4.0.11

最新の正式版(2026-10-13 時点)

2026-10-13(UTC)に公開。v4.0.4(2026-10-07)から 4.0 系列は正式版で、それ以前の v4.0.0(2026-10-04)から v4.0.3(2026-10-06)は GitHub でプレビュー版に指定されています。

CC Switch が実際にしていること

2026-10-13 時点で、CC Switch はオープンソース(MIT ライセンス)のクロスプラットフォーム・デスクトップアプリで、Windows、macOS、Linux に対応し、Claude Code や Codex などのコマンドラインツールの API 設定をカードとして管理します。「有効化」を一回押すだけで別の組に切り替わります。

QCode のドキュメントはこれを設定プロファイルの切り替えツールと説明しています。CC Switch 自体は推論エンドポイントではなく、各設定をツールの標準設定ファイル(Claude Code は ~/.claude/settings.json、Codex は ~/.codex/config.toml)に書き込み、有効化で上書きし、切り替えで戻すだけです。

そのため Claude Code と Codex で効いている設定はそれぞれ常に一つで、二組が同時に効くことはありません。公式 README は、ワンクリックで切り替えられ、JSON / TOML / YAML の設定ファイルを手で編集する必要がなくなると説明しています。対応ツールの一覧はバージョンによって変わるため、公式 README で確認してください。

CC Switch の最近のリリース(2026-10-13 時点)

2026-10-13 時点で、GitHub Releases の最新の正式版は v4.0.11 で、2026-10-13(UTC)に公開されました。リリースノートは、この版でアンインストールが加わり、「アプリ」ページからインストール済みツールを削除できるが、対象は出所を確かめられたインストールだけで、設定とセッションのデータは残ると書いています。

その前の v4.0.10(2026-10-12 公開)の重点はワンクリック取り込みリンク(ccswitch:// のディープリンク)です。CC Switch を起動していない時にリンクを開いても失われなくなり、リンクで API 形式を指定でき、確認ダイアログで取り込み後にすぐ切り替えるかどうかを選べます。中国語・英語・日本語のサイト管理者向けガイドとオンラインリンク生成器も同時に公開されました。

系列の始まりである v4.0.0 は 2026-10-04、v4.0.1 と v4.0.2 は 2026-10-05、v4.0.3 は 2026-10-06 の公開で、この四つは GitHub ではプレビュー版でした。v4.0.4(2026-10-07)は正式版として公開され、v4.0.10 と v4.0.11 も正式版です。

v4.0 のリリースノートによれば、新しい集約モードは複数のプロバイダーのモデルを Claude Code や Codex の一つのモデル一覧に並べ、クライアントの中でそのまま切り替えられます。集約は手動でオンにする必要があり、今のところ Claude Code と Codex に対応し、選んだモデルごとにリクエストを振り分けますが、フェイルオーバーは提供しません。

設定の書き込み方式も作り直され、切り替え時はファイル全体の書き換えではなく主要フィールドだけを置き換え、それ以外はそのまま残します。前の v3.20.4 は 2026-09-22 公開で、Codex の設定を編集したり別の設定に切り替えたりすると保存済みの API キーが消える問題を直しました。QCode の CC Switch ドキュメントは 2026-10-08 更新で、v3.20.3(2026-09-11)の公式ドキュメントで確認し最終確認は 2026-09-18 と明記されており、画面の表記はバージョンによって異なる場合があります。

リリースとドキュメントのタイムライン

2026-09-11

CC Switch v3.20.3 公開。QCode の CC Switch ドキュメントはこの版の公式ドキュメントで確認されています。QCode のドキュメントによると、この版から Claude の設定エディターに Artifact ツールを無効にするクイックスイッチが加わりました。

2026-09-22

v3.20.4 公開。Codex の設定を編集したり別の設定に切り替えたりすると保存済みの API キーが消える問題を直しました。2026-10-07 の v4.0.4 で 4.0 が正式版になるまでは GitHub 上の最新の正式版でした。

2026-10-04

v4.0.0 のプレビュー版が公開され、集約モードが加わり、切り替え時はファイル全体ではなく主要フィールドだけを置き換えるようになりました。v4.0.4(2026-10-07)で 4.0 は正式版になり、2026-10-13 には v4.0.11 まで進んでいます。その前の v4.0.10(2026-10-12)の重点はワンクリック取り込みリンク、v4.0.11 はインストール済みツールのアンインストールです。

確認済み vs 未記載・記述が食い違う点

確認済み(ドキュメントの原文で照合可)

以下はいずれも QCode のドキュメント、CC Switch 公式 README、ユーザーマニュアル、GitHub のリリースノートで一字一句確認できます。Claude Code の設定は ANTHROPIC_BASE_URL = https://api.qcode.cc/api と ANTHROPIC_AUTH_TOKEN = cr_ で始まるキーで、有効化すると ~/.claude/settings.json に書き込まれる。

Codex の Base URL は https://api.qcode.cc/openai で、CC Switch は ~/.codex/config.toml と ~/.codex/auth.json を生成し、wire_api = "responses" が入る。Codex パネルにある、Chat Completions にしか対応しないサービス向けのローカルプロキシ変換スイッチは、QCode では切ったままにする。

同時に有効な設定は一つだけ。Claude と Codex の設定は同じキーを共有できる。CC Switch は設定ごとにキーを別々に保存する。カードの接続チェックはキーを検証しない。2026-10-13 時点で GitHub の最新の正式版は 2026-10-13 公開の v4.0.11 であり、その前の v4.0.10 は 2026-10-12 公開である。

v4.0.0 から v4.0.3 はプレビュー版、v4.0.4(2026-10-07)以降は正式版である。v4.0 のリリースノートは集約モードを手動でオンにし、複数のプロバイダーのモデルを一つの一覧にまとめると書き、v4.0.10 のリリースノートはアプリを起動していない時の ccswitch:// リンクも失われないと書き、v4.0.11 のリリースノートは「アプリ」ページからインストール済みツールをアンインストールできると書いている。

未記載・記述が食い違う点

次の三点について本ページは結論を出しません。

  1. 1切り替え後に Claude Code の再起動が要るか:公式 README は Claude Code がホットスイッチに対応し再起動は不要と書き、公式ユーザーマニュアルの FAQ もふつうは再起動不要だとして、効いていない時だけターミナルを閉じて開き直すか IDE を再起動するよう求めています。QCode のドキュメントが引く issue #3057 にも、実行中のセッションが古い設定のまま動き続けた例が記録されています。お使いの版で確かめ、古いアドレスに向かっているならセッションを開き直してください。
  2. 2有効化で手動で書き換えた settings.json が消えるか:QCode のドキュメントには、一部の版でファイル全体が上書きされ enabledPlugins や hooks が消えたという報告が記録されており、有効化前にバックアップするようも勧めています。v4.0 のリリースノートと公式ユーザーマニュアルの FAQ は、切り替え時にアドレス・認証情報・モデル・プロトコルの項目だけを置き換え、自分で追加したプラグインや hooks、権限、MCP、環境変数、コメントや整形はそのまま残すと書いています。4.0 は v4.0.4(2026-10-07)から正式版ですが、この版の実際の挙動を本ページでは試していません。
  3. 3Base URL 末尾のスラッシュ:QCode のエンドポイントは付けない前提ですが、CC Switch 自身がどう扱うかは、QCode のドキュメントによれば公式ドキュメントに記載がありません。

CC Switch を使うか、設定ファイルを手で編集するか

CC Switch と手作業の編集

どちらも同じファイルを書き換えます。CC Switch は ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を ~/.claude/settings.json に、base_url などを ~/.codex/config.toml に書き込むだけで、自身は推論エンドポイントではありません。

中国本土のネットワークで asia.qcode.cc と api.qcode.cc を切り替える、公式ログインと QCode を比べるなど、複数の組を頻繁に行き来するなら CC Switch が手早いです。一組しか使わない場合や、デスクトップ環境のないサーバーでは手で編集するほうが直接的です。CC Switch はグラフィカルな画面が要るデスクトップ版しかなく、デスクトップのない環境向けに公式 README はコミュニティが保守する CC Switch CLI を勧めています。

Claude Code と Codex

CC Switch では別々のページ、別々の設定です。Claude は ~/.claude/、Codex は ~/.codex/ に書き込まれて互いに干渉しないので、ターミナルで claude と codex をそれぞれ起動するだけです。違いはプロトコルとアドレスで、Claude Code は Anthropic プロトコルで https://api.qcode.cc/api、Codex は OpenAI Responses プロトコルで https://api.qcode.cc/openai を使います。

QCode のドキュメントは、Claude モデルは Anthropic のエンドポイントしか通れず、Codex は Responses を使う必要があると明記しています。両方の設定に同じ cr_ キーを入れられます。

六つの手順:インストール、設定、切り替え

  1. 1インストール:CC Switch の GitHub Releases からパッケージをダウンロードします。Windows 10 以降は .msi かポータブル版の .zip、macOS 12 以降は .dmg か brew install --cask cc-switch、Linux は .deb、.rpm、.AppImage のいずれか(公式の要件は glibc 2.35 以上と WebKitGTK 4.1)で、Arch では paru -S cc-switch-bin を使います。
  2. 2Claude Code の設定:上部の切り替えで Claude を選び、右上の「+」を押してプリセットで「カスタム」を選び、設定 JSON の ANTHROPIC_BASE_URL に https://api.qcode.cc/api、ANTHROPIC_AUTH_TOKEN に cr_ キーを入れます。名前は自由で、ドキュメントの例では QCode.cc です。
  3. 3保存したらカードにマウスを重ねて「有効化」を押します。CC Switch がこの二つを ~/.claude/settings.json に書き込むので、ターミナルで claude を実行して確かめます。
  4. 4Codex の設定:Codex に切り替えて「+」から「カスタム」を選び、Base URL に https://api.qcode.cc/openai、API Key に同じ cr_ キー、既定モデルに gpt-6-sol か gpt-5.6-terra を入れます。名前は自由で、ドキュメントの例は小文字の qcode(TOML のキー名として扱いやすい)です。config.toml では model_provider = "qcode" になります。パネルにある、Chat Completions 専用サービス向けのローカルプロキシ変換スイッチはオンにしないでください。
  5. 5保存して「有効化」を押し、codex を実行して確かめます。config.toml に base_url = "https://api.qcode.cc/openai" と wire_api = "responses" があるはずです。
  6. 6その後の切り替え:別のカードで「有効化」を押すか、システムトレイで設定名を直接クリックします。まず ~/.claude/settings.json(Codex は ~/.codex/config.toml)でアドレスが変わったことを確かめ、Codex はターミナルを開き直し、Claude Code が古いアドレスのままならセッションを閉じて開き直します。asia.qcode.cc 用にもう一組保存するなら、名前に (asia) などの接尾辞を付けるとトレイで見分けられます。4.0 以降は二つの新しい仕組みが増えました。一つは集約モードで、v4.0 から手動でオンにします。公式 README は Claude Code 2.1.243 以上が必要と書き、集約はフェイルオーバーを提供しませんが、複数のプロバイダーを追加するとそのモデルがすべて Claude Code や Codex のモデル選択画面に並び、選んだモデルのプロバイダーにリクエストが送られます。使い方は当サイトの「CC Switch 4.0 集約モード」ページを見てください。もう一つはワンクリック取り込みリンクで、プロバイダーのサイトにある ccswitch:// リンクから設定を追加できます。v4.0.10(2026-10-12)からは CC Switch を起動していない時にリンクを開いても失われず、確認ダイアログで取り込み後にすぐ切り替えるかどうかを選べます。

QCode では

QCode では、Claude Code と Codex の二つの設定に、コンソールで作成した同じ cr_ キーを入れられます。キーはプロトコルを問わず使え、どのプロトコルになるかはリクエストのパスで決まります。Claude Code の設定は https://api.qcode.cc/api で、モデルは claude-sonnet-5、claude-sonnet-5-5、claude-opus-5 などを選べ、Claude Code の中で /model を使って切り替えることもできます。

Codex の設定は https://api.qcode.cc/openai で、gpt-6-sol か gpt-5.6-terra を使います。三つの接続ドメインは機能が同じで、同じキーが使えます。北米と欧州向けは us.qcode.cc、中国本土のネットワークではドキュメントが asia.qcode.cc を勧めており、パスは変わりません。

ドメインごとに CC Switch の設定を一つずつ保存しておけます。二つの設定で一つのキーを共有しても、それで二重に課金されることはありません。課金はトークン単位で、各モデルの単価は /models をご覧ください。各リクエストは probe.qcode.cc でキーを入れると確かめられます。

よくある質問

CC Switch で切り替えたのに Claude Code に反映されません。

まずファイルを見て、それからセッションを開き直してください。~/.claude/settings.json を開き、ANTHROPIC_BASE_URL がいま有効化した組になっているか確かめます。ファイルは変わったのにセッションが変わらないなら、実行中の claude を閉じ、新しいターミナルで起動し直します。QCode のドキュメントが引く issue #3057 にまさにこの挙動が記録されていて、Claude Code はプロセスの起動時に settings.json の env を環境変数に読み込み、実行中のセッションは読み直しません。そもそも再起動が要るかについて、公式 README は Claude Code がホットスイッチに対応し再起動は不要と書き、公式ユーザーマニュアルの FAQ も通常は再起動不要だとして、効いていない場合だけターミナルを閉じて開き直すか IDE を再起動するよう案内しています。Codex については両方ともターミナルの開き直しを求めています。トレイからの切り替えも同じファイルに書き込むだけで、実行中の claude を止めてはくれません。集約モードを使っている場合はもう一段あります。公式 README とユーザーマニュアルは、Claude Code では集約モデルの変更がただちに反映され、Codex は集約の開始・終了や集約モデルの一覧変更後に完全な再起動が必要と書いています。集約モードについては当サイトの「CC Switch 4.0 集約モード」ページを見てください。

401 Unauthorized が出たらどこを見ればいいですか?

たいていはどれか一つの設定のキーが間違っています。キーが cr_ で始まり前後に空白がないことを確かめ、コンソールでまだ有効かを確認してください。Claude Code は 401 なのに Codex は動く(またはその逆)なら、問題はその設定です。CC Switch は設定ごとにキーを別々に保存するので、キーを替えたら一つずつ更新します。なお、カードの接続チェックはアドレスに届くかを見るだけで、公式ユーザーマニュアルはキーを検証しないと明記しています。チェックが通ってもキーが正しいとは限りません。

Codex が起動後ずっと読み込み中のままです。

まず ~/.codex/config.toml を確認します。base_url は /openai までで、/openai/v1 ではありません。wire_api = "responses" は必ず残します。QCode のドキュメントによると、最も多い原因は最上位の model_provider が書かれていないか、[model_providers.xxx] のテーブル名と一致していないことで、その場合 Codex は組み込みの openai 公式エンドポイントに戻ってしまいます。直したらターミナルを開き直して codex を実行してください。

Claude Code と Codex は同時に使えますか?

使えます。CC Switch は Claude の設定を ~/.claude/、Codex の設定を ~/.codex/ に書き込み、互いに干渉しないので、ターミナルで claude と codex をそれぞれ起動するだけです。両方に同じ cr_ キーを入れられ、Claude Code は https://api.qcode.cc/api、Codex は https://api.qcode.cc/openai です。QCode のドキュメントは、このように一つのキーを共有しても、設定を二つ作ったことで二重に課金されることはないと明記しています。

settings.json を手で編集しました。別の設定を有効化すると消えますか?

今の公式の答えは「消えない」ですが、本ページでは未検証なので、有効化する前にバックアップするのが安全です。QCode のドキュメントによると、有効化の際に CC Switch はその設定の値で ~/.claude/settings.json の該当項目を上書きし、有効化前のバックアップを勧める記述もあり、一部の版ではファイル全体が上書きされて enabledPlugins や hooks が消えたという報告もあります。v4.0 のリリースノートと公式ユーザーマニュアルの FAQ には、切り替えは主要フィールド(アドレス・認証情報・モデル・プロトコル)だけを置き換え、自分で追加したプラグインや hooks、権限、MCP、環境変数、コメントや整形はそのまま残すと書かれており、4.0 は v4.0.4(2026-10-07)から正式版です。消えた場合は ~/.cc-switch/backups/(公式には直近 10 個を保持)か、書き出した cc-switch-export-{timestamp}.sql から戻せます。また初回起動時、CC Switch は既存の Claude Code と Codex の設定を default という名前の設定として取り込みます。

公式の Anthropic ログインに戻すにはどうしますか?

一覧で組み込みの公式設定(Claude Code は Claude Official、Codex は OpenAI Official。削除していたらプリセットから追加し直します)を選び、「有効化」を押して CLI を再起動し、ツール自身のログイン手順を進めます。Claude Code は /login、Codex は codex login です。その後は公式ログインと QCode のカスタム設定を自由に行き来できます。QCode のドキュメントは、env を空にしたまま cr_ キーだけ残すような混ぜ合わせの設定を手作りしないよう注意しています。

情報源

設定方法、アドレス、トラブル対処:QCode ドキュメントの CC Switch 設定ページ(2026-10-08 更新。CC Switch v3.20.3(2026-09-11)の公式ドキュメントで確認し、最終確認は 2026-09-18 と明記されている)と、接続先と API 形式のページ(どのプロトコルがどのエンドポイントを通るか、三つの接続ドメイン、末尾スラッシュの規則)。いずれも 2026-10-13 に取得しました。CC Switch 側のインストール、動作環境、切り替えの反映ルール、接続チェック、公式ログイン:CC Switch の GitHub リポジトリの README(MIT ライセンス)と公式ユーザーマニュアルの FAQ ページを同日に取得。バージョンと日付:CC Switch の GitHub Releases API とリリースノート(v3.20.4、v4.0.0 から v4.0.4、v4.0.10 と v4.0.11 の公開日、プレビュー版・正式版の指定、本文)を同日に取得。

CC Switch で QCode につなぐ

一つの cr_ キーで、Claude Code は /api、Codex は /openai。「有効化」を押せば切り替わります。トークン課金で、各モデルの単価は /models でご確認ください。

関連記事

暗号資産チャージガイド

9 通貨・56 ネットワーク、手数料 0 で AI コーディング API クレジットを購入。

本ページの手順と引用は 2026-10-13 に照合したもので、QCode のドキュメント、CC Switch 公式 README、GitHub のリリースノートなど公式ページの記載が優先します。CC Switch の画面表記と切り替えの挙動はバージョンによって変わるため、お手元の版に従ってください。モデルの提供状況は /models が優先です。

どちらから始めるか迷ったら

まず 1 週間試す

小パック $4(枠 $30、7日間)

毎日使う

スターターは月 $9.00、毎日 $5 の枠付き。$1 の枠あたりわずか $0.060で、中パックは約 $0.113です