CC Switch API 設定方法

穷哥么コンソールのワンクリックインポートを使い、プロバイダー、エンドポイント、モデル、API KeyをCC Switchへ安全に渡します。失敗時は公式フィールドに従って手動設定できます。

クイック設定

推奨入口
https://qionggeme.com/console/token
API Key行の操作メニューで「CC Switch」を選択します。
インポートプロトコル
ccswitch://v1/import
リンクにAPI Keyが含まれる場合があります。公開チャット、チケット、スクリーンショットへ貼らないでください。
Codex Endpoint
https://qionggeme.com/v1
Responsesネイティブ。ローカルルーティング変換は不要です。
Claude / Gemini Endpoint
https://qionggeme.com
インポート状態
enabled=true
インポート後も対象プロバイダーが有効か確認してください。

事前準備：

設定手順

  1. 穷哥么のAPI Keyページを開く

    https://qionggeme.com/console/token を開き、インポートするAPI Keyを見つけます。その行の操作メニューで 「CC Switch」 を選択します。その後生成されるKey入りリンクをブラウザーのアドレスバーからコピーしないでください。

  2. 対象アプリ、プロバイダー名、メインモデルを選ぶ

    ダイアログで Claude、Codex、Gemini のいずれかを選び、識別しやすいプロバイダー名とメインモデルを指定します。モデルIDは 料金ページの現在利用可能なID と完全に一致させてください。

  3. 「Open CC Switch」をクリックする

    コンソールは ccswitch://v1/import Deep Linkを生成し、CC Switchを開きます。生成内容には apiKey、model、homepage、enabled=true が含まれます。Codexの endpoint は https://qionggeme.com/v1、Claude / Geminiは https://qionggeme.com です。

  4. CC Switchでインポート内容を確認する

    CC Switchの確認画面で、アプリ種類、プロバイダー名、エンドポイント、モデルを確認してから承認します。公式仕様ではインポート前に設定プレビューを表示し、ユーザー確認を求めます。信頼できない出所や異常なフィールドがある場合はキャンセルしてください。

  5. プロバイダーを有効化し、対象CLIを再起動する

    対象アプリのプロバイダー一覧へ戻り、インポートしたプロバイダーが有効であることを確認します。Claude Code、Codex、Gemini CLIがインポート前から動作していた場合は終了して再起動し、設定を読み直させます。特にCodexは公式切替ガイドでも切替後のターミナル再起動が必要とされています。

  6. ワンクリックインポートに失敗したら手動追加する

    CC Switchの対象アプリTabでカスタムプロバイダーを追加します。

    • Codex Tab：エンドポイントに https://qionggeme.com/v1 を入力し、API Keyとモデルを設定します。ネイティブ responses を使用し、ローカルルーティング変換は不要です。
    • Claude Tab：エンドポイントに https://qionggeme.com を入力し、API Keyとモデルを保存して有効化します。

    手動設定でもコンテンツサイトのアドレスや、/docs 付きのAPIエンドポイントは使用しないでください。

設定例

# 安全確認リスト（実際のAPI Keyや完全なDeep Linkは表示しません）
プロトコル: ccswitch://v1/import
resource: provider
Codex endpoint: https://qionggeme.com/v1
Claude/Gemini endpoint: https://qionggeme.com
フィールド: apiKey, model, homepage, enabled=true

# Codexの手動設定
Base URL: https://qionggeme.com/v1
Wire API: responses
ローカルルーティング変換: 不要

トラブルシューティング

「Open CC Switch」を押してもアプリが開かない

CC Switchがインストール済みで、一度は起動しているか確認します。公式説明ではインストール時に ccswitch:// が登録されます。登録されていない場合は公式Deep Link資料に従って再インストールまたは修復し、API Keyページ から再度インポートしてください。

インポート失敗またはフィールド不足と表示される

Key入りリンクを手動編集せず、コンソールへ戻ってアプリ、プロバイダー名、メインモデルを選び直します。それでも失敗する場合は手動設定を利用し、エンドポイントが https://qionggeme.com/v1 または https://qionggeme.com で、/docs を含まないことを確認します。

インポート成功後もCLIが古いプロバイダーを使う

CC Switchで新しいプロバイダーが有効か確認し、実行中の対象CLIを完全に終了して再起動します。Codexは現在のターミナルを閉じ、新しいウィンドウで起動してください。

Codexリクエストが失敗し、ローカルルーティングが必要に見える

Codexエンドポイントが https://qionggeme.com/v1、プロトコルがネイティブ responses であることを確認します。穷哥么ではCC Switchのローカル変換は不要です。変換が必要なのは、Responses非対応でChat CompletionsやAnthropic Messagesだけを提供する上流などです。

401、残高不足、モデル不存在が発生する

API Keyの有効性、トークン権限、残高を確認し、モデル料金ページ でモデルIDを確認します。KeyまたはKey入りDeep Linkを公開の場所へ送らないでください。

準備はできましたか？

穷哥么に登録してAPI Keyを取得し、提供中の全モデルをすぐに利用できます。

今すぐ登録

よくある質問

CC Switchのワンクリックインポートでは何が書き込まれますか？

穷哥么が生成するプロバイダー設定にはapiKey、model、homepage、enabled=trueが含まれ、アプリ別にendpointを設定します。Codexは https://qionggeme.com/v1、Claude / Geminiは https://qionggeme.com です。

ccswitch://のインポートリンクを他人へ送ってもよいですか？

API Keyを含むDeep Linkは共有しないでください。公開チャット、サポートチケット、スクリーンショット、ブラウザー履歴同期、ログなどから漏えいする可能性があります。共同作業では機密フィールドを削除し、各自のKeyを使ってください。

Codexでローカルルーティング変換が不要なのはなぜですか？

穷哥么のCodexエンドポイント https://qionggeme.com/v1 がResponsesプロトコルをネイティブにサポートするためです。Base URL、API Key、モデルを直接設定できます。

インポート後すぐ反映されないのはなぜですか？

まずプロバイダーが有効か確認してください。起動中のCLIは古い設定を保持している可能性があるため再起動が必要です。Codexの公式切替説明では現在のターミナルを閉じて開き直すよう案内されています。

APIエンドポイントに/docsを含むアドレスを使えますか？

使えません。Codexは https://qionggeme.com/v1、Claude / Geminiは https://qionggeme.com を使い、APIエンドポイントに/docsを含めません。

関連ガイド

Codex CLI カスタム API 設定方法

Codex公式のカスタムmodel provider機能で穷哥么へ接続します。API Keyは環境変数に保存し、providerはResponses APIを使用します。

ガイドを読む →

Claude Code API 設定方法

環境変数を使ってClaude Codeを穷哥么のAPIプロキシへ接続します。公式サブスクリプションがなくても、対応するClaudeモデルを従量課金で利用できます。

ガイドを読む →

Cockpit Tools API 設定方法

Cockpit ToolsはCodex profileを管理します。「プロバイダー追加 → インスタンスへ紐付け → 有効化して起動」の順に操作して、Codexを穷哥么 APIへ切り替えます。

ガイドを読む →