CC Switch 設定
CC Switchデスクトップアプリを使って、QCode.ccをClaude CodeとCodex CLIにワンクリックで接続する
CC Switch 設定¶
CC Switchは、クロスプラットフォームのデスクトップアプリケーション（Windows / macOS / Linux）で、Claude Code、Codex、Gemini CLI、OpenCode、OpenClawの5つのCLIツールのAPIプロバイダー設定を統一したビジュアルインターフェースで管理できます。このガイドでは、CC SwitchにQCode.ccをカスタムプロバイダーとして追加する方法を説明します。
CC Switchを使う理由¶
- 設定ファイルの手動編集不要：ビジュアルフォームがsettings.json / config.tomlを代替
- ワンクリックでプロバイダー切替：qcode.cc、公式Anthropic、ローカルプロキシを即座に切替
- Claude + Codexエコシステム：Claude CodeとCodex CLIの設定を1つのアプリで管理
- システムトレイのショートカット：メインウィンドウを開かずにトレイメニューから切替
前提条件¶
- Claude Code CLIまたはCodex CLIがインストール済み
- QCode.cc APIキー（
cr_で始まる）が必要。ダッシュボードから取得
CC Switchのインストール¶
GitHub Releasesからプラットフォームに対応したインストーラーをダウンロード：
| プラットフォーム | パッケージ |
|---|---|
| Windows 10+ | CC-Switch-v{ver}-Windows.msiまたはポータブル版.zip |
| macOS 12+ | .dmgパッケージ；またはbrew tap farion1231/ccswitch && brew install --cask cc-switch |
| Linux | .deb / .rpm / .AppImage；Arch用：paru -S cc-switch-bin |
Claudeプロバイダーの設定（Claude Code用）¶
CC Switchを起動 → 左側のClaudeタブに切替 → 右上のプロバイダーを追加（Add Provider）をクリック → カスタム（Custom）を選択 → 以下のように入力：
| フィールド | 値 |
|---|---|
| プロバイダー名 | QCode.cc |
| ANTHROPIC_BASE_URL | https://api.qcode.cc/api |
| ANTHROPIC_AUTH_TOKEN | QCode.cc APIキー（cr_で始まる） |
保存後、有効化（Activate）をクリックして現在のClaudeプロバイダーとして設定します。CC SwitchはANTHROPIC_BASE_URLとANTHROPIC_AUTH_TOKENを~/.claude/settings.jsonに自動的に書き込みます。ターミナルでclaudeを実行して接続を確認してください。
Codexプロバイダーの設定（Codex CLI用）¶
Codexタブに切替 → プロバイダーを追加 → カスタム → 以下のように入力：
| フィールド | 値 |
|---|---|
| プロバイダー名 | qcode（小文字推奨、TOMLキー名として使用） |
| Base URL | https://api.qcode.cc/openai |
| APIキー | QCode.cc APIキー |
| デフォルトモデル | gpt-5.3-codex-spark（推奨）またはgpt-5.4 |
CC Switchは以下の~/.codex/config.tomlと~/.codex/auth.jsonを生成します：
model_provider = "qcode"
model = "gpt-5.3-codex-spark"
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を実行して接続を確認してください。
フォールバックエンドポイント¶
プライマリエンドポイントに接続できない場合は、代替エンドポイントに切り替えてください：
| エンドポイント | Claude Base URL | Codex Base URL |
|---|---|---|
| 国際CDN（推奨） | https://api.qcode.cc/api |
https://api.qcode.cc/openai |
| 深圳ダイレクト | http://103.236.53.153/api |
http://103.236.53.153/openai |
| 香港 | http://103.218.243.5/api |
http://103.218.243.5/openai |
共有クォータ¶
CC Switch内のClaudeとCodexプロバイダーは同じQCode.cc APIキーを使用し、同じサブスクリプションクォータを共有します（請求についてを参照）。2つのプロバイダーを追加しても二重請求にはなりません。
よくある質問¶
保存後に「有効化」ボタンがグレーアウトしている¶
ANTHROPIC_BASE_URL / Base URLの末尾に余分な/がないことを確認してください。CC Switchは末尾のスラッシュに敏感です。
401 Unauthorizedエラー¶
- APIキーが
cr_で始まり、前後にスペースがないことを確認 - qcode.cc/dashboardでキーが有効であることを確認
- ClaudeだけがエラーでCodexが正常（またはその逆）の場合、一方のプロバイダーのキーが正しく入力されていない可能性があります——CC Switchはプロバイダーごとにキーを独立して保存します
Codexが起動後にずっとスピンしている¶
config.tomlのbase_urlが/openaiで終わっていることを確認してください（/openai/v1ではありません）。wire_api = "responses"フィールドも必須です。
ClaudeとCodexを同時に使えますか？¶
はい。CC SwitchはClaudeの設定を~/.claude/に、Codexの設定を~/.codex/に書き込みます。2つの設定は完全に独立しています。必要に応じて別々のターミナルでclaudeとcodexを実行してください。
次のステップ¶
- Claude Codeチュートリアル — Claude Codeのコアワークフローをマスター
- Codexチュートリアル — Codex CLIをより深く活用
- VS Code統合 — エディタで直接Claude Codeを使用
- 請求について — プランとクォータを理解する