Cockpit Tools API 設定方法

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

クイック設定

設定場所
Codexページ → モデルプロバイダーTab → カスタムプロバイダーを追加
Base URL
https://qionggeme.com/v1
コンテンツサイトや/docs付きアドレスは使用しません。
API Key
穷哥么コンソールで生成したAPI Key
文書にはプレースホルダーだけを記載し、実際のKeyを書かないでください。
wireApi
responses
chat_completionsを選ばないでください。
モデル
gpt-5.3-codex-spark
実際には現在のトークンに表示されるモデル一覧を基準とします。
反映操作
プロバイダーを紐付け → 有効化して起動
保存しただけでは切り替わりません。

事前準備：

この接続ではCockpit ToolsがCodex profileの auth.json と config.toml を管理します。CockpitのUIから切り替え、管理中の設定ファイルを同時に手動編集しないでください。

設定手順

  1. Codexの「モデルプロバイダー」Tabを開く

    Cockpit Toolsで Codexページ を開き、「モデルプロバイダー」 Tabへ移動して 「カスタムプロバイダーを追加」 をクリックします。このBase URLをCockpitのローカルサービスアドレス欄へ入力しないでください。ここでは外部モデルプロバイダーを設定します。

  2. 名前、Base URL、API Keyを入力する

    • 名前：例 qionggeme-codex
    • Base URL：https://qionggeme.com/v1
    • API Key：自分の穷哥么 API Keyを引用符や余分な空白なしで貼り付けます。

    Base URLはAPI入口であり、コンテンツサイトURLではありません。/docs を追加しないでください。

  3. wireApiをresponsesにしてモデルを指定する

    プロトコル欄 wireApi で responses を選択します。例として gpt-5.3-codex-spark を入力できます。現在のトークンで利用できない場合は一覧内のCodex互換モデルへ置き換えてください。chat_completions は選ばないでください。

  4. プロバイダー設定を保存する

    保存し、モデルプロバイダー一覧にカードが表示されることを確認します。ここでの「保存」は設定をCockpitへ保存するだけで、Codexインスタンスへの切り替えは行いません。

  5. インスタンスへ戻ってプロバイダーを紐付ける

    CockpitのCodexインスタンス管理へ戻り、対象インスタンスに保存したカスタムプロバイダーを紐付けます。紐付けなければ、保存済みでもCodex profileはそのプロバイダーを使用しません。

  6. 「有効化して起動」を明示的に実行する

    紐付け後、「有効化して起動」 を実行してインスタンス状態を確認します。この操作で初めてCockpitが対象Codex profileをプロバイダーへ切り替えます。保存と切り替えは別です。

  7. Codexが新しいプロバイダーを使うか確認する

    インスタンスが実行中であることを確認し、そのインスタンスからCodexを起動または再起動して簡単なリクエストを送ります。切り替え前のターミナルやprofileが動作中なら、古いプロセスを終了してください。

設定例

# Cockpit Tools → Codex → モデルプロバイダー → カスタムプロバイダーを追加
名前: qionggeme-codex
Base URL: https://qionggeme.com/v1
API Key:  あなたの穷哥么 API Key
wireApi:  responses
モデル:     gpt-5.3-codex-spark（または現在のトークンで利用可能なCodexモデル）

# 保存後に必ず行う操作
1. インスタンスへ戻る
2. プロバイダーを紐付ける
3. 「有効化して起動」を実行する

# 注意
設定の保存だけではインスタンスは切り替わりません。Cockpitが管理するauth.json / config.tomlを同時に手動編集しないでください。

トラブルシューティング

プロバイダーを保存したのにCodexが古い回線を使う

保存は永続化だけです。インスタンスへ戻りプロバイダーを紐付け、「有効化して起動」 を実行してからCodexを再起動します。カードの有無だけでなくインスタンス状態を確認してください。

chat_completionsを選びResponsesリクエストが失敗する

プロバイダーを編集し、wireApi を responses に変更します。Base URLは https://qionggeme.com/v1 のままにします。

プロバイダーはあるがインスタンスに反映されない

現在のインスタンスへ本当に紐付けたか確認します。紐付けは独立した操作で、インスタンスを変更した場合も再確認し、「有効化して起動」を実行します。

インスタンスが起動せず、ポートまたは状態が異常

Cockpitで実行状態とポートを確認し、他プロセスによるポート使用がないか調べます。使用中のプロセスを確認せずに終了させないでください。ポート変更後はインスタンスを再起動して確認します。

古いprofileを読み続ける、または手動編集後に状態が乱れた

管理対象インスタンスを停止し、現在の紐付けと有効状態を確認してからCockpitで「有効化して起動」をやり直します。Cockpitは auth.json と config.toml を管理するため、管理中は同時に手動編集しないでください。

準備はできましたか？

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

今すぐ登録

よくある質問

Cockpit ToolsのBase URLには何を入力しますか？

https://qionggeme.com/v1 を入力します。穷哥么のCodex API入口です。コンテンツサイトURLや/docs付きアドレスは使用しません。

wireApiがresponsesでなければならないのはなぜですか？

CodexがResponsesネイティブプロトコルを使用するためです。chat_completionsは別のプロトコルで、誤って選ぶとリクエスト形式またはルーティングが一致しません。

プロバイダーを保存すれば切り替え完了ですか？

いいえ。保存後にインスタンスへ紐付け、「有効化して起動」を実行し、実行状態と実際のリクエストを確認する必要があります。

Cockpit ToolsはどのCodexファイルを変更しますか？

CockpitはCodex profileのauth.jsonとconfig.tomlを管理し、有効化時に選択したプロバイダーへ切り替えます。管理対象ファイルの同時手動編集は推奨しません。

gpt-5.3-codex-sparkは必ず利用できますか？

設定例であり、実際のモデルは現在のトークンに表示される一覧を基準とします。存在しない場合は一覧内のCodex互換モデルへ変更してください。

関連ガイド

Codex CLI カスタム API 設定方法

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

ガイドを読む →

CC Switch API 設定方法

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

ガイドを読む →

Cherry Studio New API 設定方法

Cherry Studio公式のNew API連携資料に沿って穷哥么をプロバイダーとして追加し、OpenAI互換タイプとメインドメインのルートアドレスで設定します。

ガイドを読む →