CC Switch 設定

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

API キーが必要ですか？ 登録する →·エンドポイントと Base URL →

最終確認：2026-09-18 · 📄 公式ドキュメント準拠（CC Switch v3.20.3、2026-09-11 公開）

概要¶

CC Switchは、クロスプラットフォームのデスクトップアプリケーション（Windows / macOS / Linux）で、9 個のツール（Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、MiniMax Code ※公式 README の一覧、マニュアル画面図はやや旧い）の 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 を選択 → 右上の 「＋」（プロバイダー追加） → アプリ別プロバイダーのタブでプリセットから カスタム（Custom） を選び → パネルの JSON を直接編集（UI 文言は版で変わるため実画面優先）：

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

保存後、カードの 「有効化」（英語 UI では Enable。カード操作ボタンはホバーで表示）を押して現在のClaudeプロバイダーに設定します。CC SwitchはANTHROPIC_BASE_URLとANTHROPIC_AUTH_TOKENを~/.claude/settings.jsonに自動的に書き込みます。ターミナルでclaudeを実行して接続を確認してください。

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

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

単価・コンテキスト長は qcode.cc/models の最新表示を正とします（古びるため数字はこのページに載せません）。完全なラインナップ（GPT、Gemini、国内系）も同じページです。なお v3.20.3 以降、Claude プロバイダー編集画面にはロール別（Sonnet / Opus / Fable / Haiku / サブエージェント）のモデルマッピングパネルと「全ロールへ一括適用」があります。

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

上部のアプリ切替器で Codex → 「＋」プロバイダー追加 → カスタム → 以下のように入力：

⚠️ Codex プロバイダー編集画面の「ローカルルーティングが必要」は Chat Completions のみ対応アップストリームをローカル変換するためのスイッチです。QCode 接続ではオフのままで——QCode は Responses をネイティブ提供するため、誤って有効にするとローカル常駐プロキシが必要になります。

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

model_provider = "qcode"
model = "gpt-6-sol"
model_reasoning_effort = "high"

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

保存して「有効化」を押し、codexを実行して接続を確認してください。GPTモデルの選択肢：gpt-6-sol / gpt-5.6-terra / gpt-5.6-sol（単価とコンテキストは 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はシステムトレイに常駐します。v3.13.0 以降、トレイ右クリックメニューはアプリ別サブメニュー（Claude / Codex / Gemini）に区分され、各サブメニューのタイトルに現在の有効プロバイダーと使用量要約が表示されます。プロバイダー名をクリックすると切替完了。トレイ切替が書く 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への切替を推奨します：

• CC Switch は Gemini CLI を引き続き第一級アプリとして管理、入口は Claude / Codex と同じ
• QCode 経由の Gemini 系モデルの手順は Google Antigravity CLI 接続 参照、正確な設定キーは 公式ドキュメント を参照

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「切替後にプラグインが消えた」）：プロバイダー編集 → 共通設定パネル →「現在のプロバイダーから抽出」。以後の新規プロバイダーで「共通設定を書き込む」をオンのまま（デフォルトオン。README では「共通設定を適用」/ "Write Shared Config" と表記が揺れている。初回起動で取り込んだデフォルトプロバイダーに、当時の完全な項目が残っているはず
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）。
• 末尾にスラッシュを付けない：QCode は Base URL 末尾の / なしを要求します（付くと SDK が //v1/... 型の誤パスを組む）。
• キーは個別に管理：CC Switchはプロバイダーごとにキーを独立して保存します。キーをローテートする際は各々を更新してください。
• 設定をバックアップ：~/.claude/settings.jsonを手動編集していた場合、有効化で上書きされます。先にバックアップするか共通スニペットへ抽出してください。

よくある質問¶

保存後に「有効化」ボタンが押せない¶

順に確認：① エンドポイント欄が空でない ② パネルの JSON / TOML 構文が正当（手編集で最も壊れやすい） ③ Base URL 末尾の / を外す（QCode のエンドポイントは末尾スラッシュなしを要求。CC Switch 自体の末尾スラッシュ挙動は公式文書に記載なし、この順序は当方の経験）。

Claude Code 2.1.265–2.1.267 で全リクエストが 400（Artifact スキーマ）¶

Claude Code 2.1.265–2.1.267 が送る Artifact ツールのスキーマは厳格なゲートウェイに全面拒否（400、Invalid schema for function 'Artifact'）されます。CC Switch 3.20.3（2026-09-11）以降、Claude プロバイダー編集画面に「Disable Artifact Tool（Artifact ツールを無効化）」のクイック切替が増え、有効化で env.CLAUDE_CODE_DISABLE_ARTIFACT="1" が書かれます。公式修正は Claude Code を ≥2.1.268 へ更新すること。詳細はトラブルシューティング。QCode 側組合せの全再現確認は未実施なので、発生時は request id を添えてチケット化してください。

401 Unauthorizedエラー¶

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

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

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

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

config.toml の base_url は QCode のエンドポイント慣例どおり /openai まで（/openai/v1 ではない）。wire_api = "responses" は必須。最も多い見落とし：トップレベルの model_provider がない、または [model_providers.xxx] の表名と不一致——この場合 Codex は内蔵 openai 公式エンドポイントへフォールバックします（公式 issue #7263 に同じ症状の記録あり）。

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

企業版 →