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で切替、または設定で直接指定できます：

フラッグシップ枠にはclaude-opus-4-7（1M）もあります。完全なラインナップ（GPT、Gemini含む）はモデルと価格を参照。

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

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

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

model_provider = "qcode"
model = "gpt-5.3-codex"
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を実行して接続を確認してください。現在のCodex CLIのバージョンは0.142.0です。GPTモデルの選択肢：gpt-5.5（$5/$30、1M）、gpt-5.4（$2.5/$15、1M）、gpt-5.4-mini（$0.75/$4.5、400K）、gpt-5.3-codex（$1.75/$14、272K）。

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

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

1. Claudeタブで複数のプロバイダーを保存します。例：QCode.cc（主力）、QCode.cc (asia)（本土ノード）、Anthropic Official（予備）。
2. 切り替えるには、対象プロバイダー横の有効化をクリックします——CC Switchが対応するANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKENを~/.claude/settings.jsonに書き直します。
3. 新しい設定を反映させるにはClaude Codeを再起動（または新しいターミナルを開く）してください——実行中のclaudeセッションは新しい環境変数をホットリロードしません。
4. Codexも同様：Codexタブで有効項目を切り替えると~/.codex/config.tomlが書き直されます。

トレイのショートカット：CC Switchはシステムトレイに常駐します。トレイアイコンを右クリックすると、メインウィンドウを開かずに保存済みプロバイダー間を直接切り替えられます。具体的なメニュー項目はアプリのバージョンに依存します。

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

同じ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 4.8 / Sonnet 4.6およびGPT-5.xが含まれます。

注意：これは画像の「入力」（理解）であり、画像の「生成」ではありません。 モデルに画像を生成させるには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です（Gemini系は2倍課金）。

予備エンドポイント¶

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

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

共有クォータ¶

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

実用的なヒント¶

• サフィックス付きの命名：プロバイダー名に(asia) / (work)などのサフィックスを付けると、トレイ切替時に一目で見分けられます。
• 切替後にCLIを再起動：環境変数はプロセス起動時に読まれます。プロバイダー切替後は新しいターミナルを開くかclaude / codexを再起動してください。
• 末尾にスラッシュを付けない：すべての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はプロバイダーごとにキーを独立して保存します

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

切替は設定ファイルを書き直すだけで、実行中のclaude / codexプロセスはホットリロードしません。新しいターミナルを開くかCLIを再起動してから再試行してください。

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の対応フィールドを上書きします。カスタム内容はCC Switchのプロバイダー設定に入れるか、有効化前にバックアップしてください。

次のステップ¶

• 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の両方を動かします。