CC Switch 設定

CC Switch で QCode.cc を Claude Code と Codex CLI に接続する。フォーム入力、複数プランの切替、公式ログインとの併用、切替が効かないとき、上書きされた設定の復元

CC Switch 設定¶

CC Switchは、クロスプラットフォームのデスクトップアプリケーション（Windows / macOS / Linux）で、Claude Code、Codex、Gemini CLI、OpenCode、OpenClawなどのCLIツールのAPIプロバイダー設定を統一したビジュアルインターフェースで管理できます。このガイドでは、CC SwitchにQCode.ccをカスタムプロバイダーとして追加する方法、複数のプロバイダー/アカウントをワンクリックで切り替える方法、よくある使用シーンとトラブルシューティングを説明します。

CC Switchを使う理由¶

• 設定ファイルの手動編集不要：ビジュアルフォームがsettings.json / config.tomlを代替
• ワンクリックでプロバイダー切替：qcode.cc、公式Anthropic、ローカルプロキシを即座に切替
• Claude + Codexエコシステム：Claude CodeとCodex CLIの設定を1つのアプリで管理
• マルチアカウント / マルチプラン管理：同じプロバイダーに複数の設定（例：仕事用キーと個人用キー）を保存していつでも切替
• システムトレイのショートカット：メインウィンドウを開かずにトレイメニューから切替

CC Switchの本質は「設定プロファイル（profile）スイッチャー」です——各プロバイダー設定を対応するCLIの標準設定ファイルに書き込み、有効化時に上書き、切替時に元へ戻します。これを理解すると、複数のプロバイダーが同時に有効になるという誤解を防げます。

前提条件¶

• Claude Code CLIまたはCodex CLIがインストール済み
• QCode.cc APIキー（cr_で始まる）が必要。ダッシュボードから取得
• 同じキーがAnthropic、OpenAI、Geminiなど複数のプロトコルエンドポイントで通用します。接続先とAPIフォーマットを参照

CC Switchのインストール¶

GitHub Releasesからプラットフォームに対応したインストーラーをダウンロード：

各プラットフォームの具体的なインストール手順や署名の警告はプロジェクトのREADMEを参照してください。

Claudeプロバイダーの設定（Claude Code用）¶

CC Switchを起動 → 左側のClaudeタブに切替 → 右上のプロバイダーを追加（Add Provider）をクリック → カスタム（Custom）を選択 → 以下のように入力：

なぜasia.qcode.ccを推奨？ これはQCode.ccの香港ノードで、中国本土ユーザーには最も低遅延です。不安定な場合はapi.qcode.cc（グローバルRoute 53）に戻してください。同じキーがapi / asia / us / euの4つのドメインで通用します。

保存後、有効化（Activate）をクリックして現在のClaudeプロバイダーとして設定します。CC SwitchはANTHROPIC_BASE_URLとANTHROPIC_AUTH_TOKENを~/.claude/settings.jsonに自動的に書き込みます。ターミナルでclaudeを実行して接続を確認してください。

デフォルトモデルの選択¶

QCode.ccはフラッグシップから軽量まで完全なモデルラインナップを提供します。Claude Codeでは/modelで切替、または設定で直接指定できます：

単価は 2026-08-16 に qcode.cc/models から読んだスナップショットです。正本はそのページ。4.x は消さず、既定の推奨だけ 5 系へ移します。完全なラインナップ（GPT、Gemini、国内系）も同じページです。

Codexプロバイダーの設定（Codex CLI用）¶

Codexタブに切替 → プロバイダーを追加 → カスタム → 以下のように入力：

CC Switchは以下の~/.codex/config.tomlと~/.codex/auth.jsonを生成します：

model_provider = "qcode"
model = "gpt-5.6-terra"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true

保存して有効化後、codexを実行して接続を確認してください。GPTモデルの選択肢：gpt-5.6-terra / gpt-5.6-sol / gpt-5.6-luna / gpt-5.5 / gpt-5.4 / gpt-5.6-mini（単価とコンテキストは qcode.cc/models 参照）。Codex CLI の版は本機の codex --version を見てください。このページの古い数字を信じないでください。

複数のプロバイダー/アカウント間の切替¶

CC Switchの核心的な価値は「切替」にあります。よくある構成：

1. Claudeタブで複数のプロバイダーを保存します。例：QCode.cc（主力）、QCode.cc (asia)（本土ノード）、Anthropic Official（予備）。
2. 切り替えるには、対象プロバイダー横の有効化をクリックします——CC Switchが対応するANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKENを~/.claude/settings.jsonに書き直します。
3. 新しい設定を効かせる：公式 README は Claude Code がいまはプロバイダーデータのホットスイッチに対応と書いています。公式 FAQ と issue #3057 は別のケースを記録しています——ディスク上の settings.json は新しいのに、実行中のセッションは旧プロバイダーのまま。今のセッションがまだ旧ノードに行っているなら、そのセッションを閉じて新しいターミナルを開き、もう一度 claude を実行してください。Codex とその他の CLI は FAQ どおりターミナルを開き直します。
4. Codexも同様：Codexタブで有効項目を切り替えると~/.codex/config.tomlが書き直されます。

トレイのショートカット：CC Switchはシステムトレイに常駐します。トレイアイコンを右クリックすると、メインウィンドウを開かずに保存済みプロバイダー間を直接切り替えられます。具体的なメニュー項目はアプリのバージョンに依存します。トレイ切替が書く live ファイルはメイン画面の「有効化」と同じです。落とし穴は下の「接続したあと」を見てください。

マルチアカウント / マルチプランの例¶

同じQCode.ccアカウントに2つの設定を保存し、それぞれ別のAPIキーを入力：

有効なプロバイダーを切り替えるだけで、2つのクォータ間をシームレスに移動でき、請求が混ざりません。

使用シーン¶

• 国内ネットワークの変動：主力にasia.qcode.cc、不安定なときはワンクリックでグローバルのapi.qcode.ccへ。
• 複数プロバイダーの比較：同じタスクをQCode.ccと公式Anthropicで実行し、応答とコストを比較。
• チーム / 個人の分離：別々のキーで仕事と個人の使用量を分け、経理を容易に。
• Claude + Codexの連携：1つのアプリでClaude CodeとCodex CLIを同時に管理し、それぞれAnthropicプロトコルエンドポイントとOpenAIプロトコルエンドポイントに接続。

Claude Codeの高度な機能（QCode接続後も利用可能）¶

CC Switchはプロバイダーの切替のみを担当し、Claude Code自体の機能には影響しません。QCodeに接続後も、以下の機能は通常どおり動作します（Claude Codeが現在設定しているモデル上で実行されます）：

ビジョン入力：スクリーンショット / 図から要件を理解¶

Claude Codeはビジョン対応モデルに画像を渡せます：プロンプトに貼り付け（Ctrl+V）、画像をドラッグ&ドロップ、または画像ファイルのパスを参照します。よくある用途：

• デザインカンプ / スクリーンショットからUIを再現
• エラースクリーンショットからバグを特定
• アーキテクチャ図やチャートを読む

QCode経由で利用できるビジョン対応モデルには claude-opus-5 / claude-sonnet-5、販売継続中の claude-opus-4-8 / claude-sonnet-4-6、および GPT-5.x が含まれます。能力フラグの正本は qcode.cc/models です。

注意：これは画像の「入力」（理解）であり、画像の「生成」ではありません。 モデルに画像を生成させるにはgpt-image-2モデルを使用してください。gpt-image-2 画像生成を参照。

ダイナミックワークフロー（バックグラウンドサブエージェントのオーケストレーション）¶

プロンプトにキーワードultracodeを含める（または単に「ワークフローを実行して」と頼む）と、Claude Codeのダイナミックワークフローが起動します：数十から数百のバックグラウンドサブエージェントを並列にオーケストレーションし、コードベース全体のレビュー、移行、調査に最適です。サブエージェントがバックグラウンドで実行される間も作業を続けられます。/workflowsコマンドで実行状況を確認できます。この機能はClaude Codeが現在設定しているモデル上で実行されるため、Claude CodeがQCodeを指しているときも利用できます。関連：サブエージェント。

ヘッドレスモード / 自動化出力¶

スクリプトやCIでは-pでワンショット実行し、出力フォーマットを指定します：

# 構造化JSON（result / total_cost_usd / usage / session_idを含む）、jqで解析
claude -p "このリポジトリのテストカバレッジを要約" --output-format json | jq '.result'

# 改行区切りのストリーミングJSONイベント、リアルタイムパイプに最適
claude -p "src/ のセキュリティリスクをレビュー" --output-format stream-json

パイプやCIの詳しい使い方は自動化とCI/CDを参照。

Gemini / Antigravityについて¶

CC SwitchのビジュアルリストにはGemini CLIが含まれますが、注意してください：GoogleはGemini CLIを退役させました（Pro/無料層のEOLは2026-06-18、エンタープライズ有料キーは影響なし）。後継はGoogle Antigravity CLI（2026-05-19から利用可能）です。QCode経由でGemini系モデルを使うには、Antigravityへの切替を推奨します：

• ~/.config/antigravity/config.tomlを編集
• base_urlをhttps://api.qcode.cc/openai/v1に設定し、QCode APIキーを入力、モデルを選択
• Antigravityは新しく進化中です——正確な設定キー名は公式ドキュメントを参照してください

QCode 上で販売中・本稿でよく出す Gemini は gemini-2.5-pro と gemini-3.5-flash です。倍率や単価は qcode.cc/models を見てください。口頭の「2 倍」はそのページがそのときそう書いていない限り使わないでください。

予備エンドポイント¶

主要エンドポイントに接続できない場合は、代替に切り替えてください（同じキーがどこでも通用）：

セルフチェック：Base URLのパスに直接アクセスして401が返るのは正常です——パスが正しく、認証が欠けているだけという意味です。

共有クォータ¶

CC Switch内のClaudeとCodexプロバイダーは同じQCode.cc APIキーを使用し、同じサブスクリプションクォータを共有します（請求についてを参照）。2つのプロバイダーを追加しても二重請求にはなりません。異なるキーで複数のプロバイダーを作成した場合は、各キーが独立して課金され、互いに影響しません。

接続したあと：切替、併用、復元¶

ここは「CC Switch」検索で入ってきた人が、つながったあとに聞く話です。フォームの埋め方は上。動いてからの話だけ書きます。

複数プラン / 複数キー¶

プロバイダー 1 件 = BASE_URL + キー +（Codex なら）モデルです。同じ QCode アカウントに何行でも置けます。例:

有効なプロバイダーは常に 1 つです。CC Switch は 2 セットを同時に ~/.claude/settings.json へ書きません。公式 Anthropic と QCode を比べるなら「有効化」を行き来してください。両方ライブにはなりません。

切替後も CLI が旧プロバイダーのまま¶

この順で見てください。先にキーを疑わないでください。

1. ~/.claude/settings.json（Codex は ~/.codex/config.toml）を開き、ANTHROPIC_BASE_URL / base_url が今有効化した行になっているか確認する
2. ファイルは変わったのにセッションが変わらない：issue #3057 の挙動です。Claude Code は起動時に settings.json の env を環境変数へ入れ、実行中のセッションは読み直しません。今の claude / codex を閉じて新しいターミナルを開く
3. 公式 README は Claude Code のホットスイッチを謳っています。あなたのビルドで効くなら再起動は不要です。まだ旧ノードに行っているならセッションを開き直す
4. FAQ は Gemini CLI のトレイ切替を即時反映と書いています。Gemini CLI 自体は EOL です（上文）。Claude / Codex にその文を当てないでください

公式 Anthropic / ChatGPT ログインとの併用¶

公式 README / FAQ:

1. プリセットから Official Login（Claude / Codex）または Google Official（Gemini）を追加
2. 有効化 / Enable をクリック
3. 対応する CLI を開き直し、そのツール自身の Log out / Log in（または OAuth）を一通りやる
4. そのあと「公式ログイン」と QCode.cc カスタムのあいだを行き来できる

settings.json を手でいじって公式 OAuth と QCode の ANTHROPIC_AUTH_TOKEN を混ぜないでください。有効化のとき CC Switch は自分が管理するフィールドを書き直します。複数の公式 Codex アカウント間の切替は README の「Codex は異なる公式プロバイダーを切り替えられる」に従ってください。

トレイ切替の落とし穴¶

• アイコンが無い：macOS はメニューバー設定、Windows はタスクバーのオーバーフロー、Linux は libappindicator が要ることがある（公式 FAQ）
• 軽量モード（トレイの Lightweight Mode）：メインウィンドウを閉じ、トレイだけ残す。機能は残る。最初の ccswitch:// ディープリンクはウィンドウを作り直すので少し遅い（公式 FAQ、v3.13.0 以降）
• トレイは押したのに CLI が変わらない：トレイが書くのはメイン画面の「有効化」と同じ live ファイルです。実行中の claude は殺しません。上の手順でセッションを開き直す
• 名前に (asia) / (work) を付けるとトレイメニューで区別できる

設定を上書きされたあとの復元¶

有効化 / テイクオーバーのとき、CC Switch はプロバイダーのフィールドを CLI の live ファイルへ書きます。複数の issue（#2992、#4274、#1656）は、管理対象外のキー（enabledPlugins、hooks、statusLine、permissions など）ごとファイル全体が消えた報告です。プラグイン本体はディスクに残っていることが多く、enabledPlugins が無いので読み込まれません。

確認できる復元経路（公式 README / ユーザーマニュアル。第三者の口伝ではない）:

1. アプリ自身のバックアップ：~/.cc-switch/backups/（ローテーション。公式は直近 10 個）
2. 自分で出したエクスポート：設定のエクスポート名は cc-switch-export-{timestamp}.sql。インポートは今の DB を上書きするので、戻す前にもう一度エクスポートする
3. 共通設定スニペット（README FAQ「切替後にプラグインが消えた」）：プロバイダー編集 → 共通設定パネル →「現在のプロバイダーから抽出」。以後の新規プロバイダーで「共通設定を適用」をオン（デフォルトオン）のままにする。初回起動で取り込んだデフォルトプロバイダーに、当時の完全な項目が残っているはず
4. Claude の手編集：~/.claude/settings.json だけいじって共通設定に抽出していないなら、自分のバックアップ / Time Machine / エディタのローカル履歴から戻し、共通設定へ貼る。次の有効化が自動マージすることは期待しない

CC Switch 自身の DB は ~/.cc-switch/cc-switch.db、端末 UI は ~/.cc-switch/settings.json。後者を消すと UI が初期化されるだけで、Claude の hooks は戻りません。

実用的なヒント¶

• サフィックス付きの命名：プロバイダー名に(asia) / (work)などのサフィックスを付けると、トレイ切替時に一目で見分けられます。
• 先にファイルを見て、新しいセッションを開く：正本は ~/.claude/settings.json / ~/.codex/config.toml。実行中プロセスはホットリロードしません（FAQ / #3057）。
• 末尾にスラッシュを付けない：すべてのBase URLは末尾に/を付けてはいけません。誤ったパスになる恐れがあります。
• キーは個別に管理：CC Switchはプロバイダーごとにキーを独立して保存します。キーをローテートする際は各々を更新してください。
• 設定をバックアップ：~/.claude/settings.jsonを手動編集していた場合、有効化で上書きされます。先にバックアップするか共通スニペットへ抽出してください。

よくある質問¶

保存後に「有効化」ボタンがグレーアウトしている¶

ANTHROPIC_BASE_URL / Base URLの末尾に余分な/がないことを確認してください。CC Switchは末尾のスラッシュに敏感です。

401 Unauthorizedエラー¶

1. APIキーがcr_で始まり、前後にスペースがないことを確認
2. qcode.cc/dashboardでキーが有効であることを確認
3. ClaudeだけがエラーでCodexが正常（またはその逆）の場合、一方のプロバイダーのキーが正しく入力されていない可能性があります——CC Switchはプロバイダーごとにキーを独立して保存します

プロバイダーを切り替えても反映されない¶

まず live ファイルが新しいプロバイダーになっているか見てください。ファイルが変わっているなら今の claude / codex セッションを閉じて開き直します（公式 FAQ、#3057）。トレイだけ押して古いウィンドウで打ち続けないでください。

Codexが起動後にずっとスピンしている¶

config.tomlのbase_urlが/openaiで終わっていることを確認してください（/openai/v1ではありません）。wire_api = "responses"フィールドも必須です。

ClaudeとCodexを同時に使えますか？¶

はい。CC SwitchはClaudeの設定を~/.claude/に、Codexの設定を~/.codex/に書き込みます。2つの設定は完全に独立しています。必要に応じて別々のターミナルでclaudeとcodexを実行してください。

settings.jsonを手動編集しました——有効化で失われますか？¶

はい。有効化時、CC Switchはそのプロバイダーの値で~/.claude/settings.jsonの対応フィールドを上書きします。一部のビルドではファイル全体が置き換わり、enabledPlugins / hooks が消えた報告があります（#2992、#4274）。余分な項目は共通設定スニペットへ入れ、有効化前にバックアップし、消えたら ~/.cc-switch/backups/ かエクスポートした .sql から戻してください。

公式 Anthropic ログインへ戻すには¶

プリセットの Official Login を追加 → 有効化 → CLI を開き直し → 公式の Log out / Log in。空の env に cr_ キーを残すハイブリッド設定を手で作らないでください。

次のステップ¶

• WorkBuddy 連携 — 同じキーを Tencent WorkBuddy のカスタムモデルへ
• Claude Codeチュートリアル — Claude Codeのコアワークフローをマスター
• Codexチュートリアル — Codex CLIをより深く活用
• VS Code統合 — エディタで直接Claude Codeを使用
• サブエージェント — ダイナミックワークフローでバックグラウンドエージェントをオーケストレーション
• 自動化とCI/CD — ヘッドレスモードとスクリプト統合
• 請求について — プランとクォータを理解する

まだQCode.cc APIキーをお持ちでない場合は、qcode.cc/pricingでプランを選んでください——1つのキーがCC Switch内でClaude CodeとCodex CLIの両方を動かします。