CC-Switch Codex
このページでは、CC Switchを介してCodexプロバイダーを管理する方法について説明します。CodexクライアントやCodex CLIで直接設定するのとは異なり、まずCC Switchでプロバイダー情報を管理・保持し、それをCodexに適用（反映）する手順を中心に解説します。
公式情報 ダウンロードやドキュメントは公式サイトの情報をご確認ください。
このページで説明すること
Codexは通常、OpenAIまたはOpenAI互換インターフェースを通じて動作するため、主に「Base URL」「Key」「モデル名」の3項目を確認します。Base URLに /v1 を含める必要があるかどうかは、プロバイダーの管理画面の案内に従ってください。
開始前の確認事項
| 確認項目 | 確認方法 | 理由 |
|---|---|---|
| Codexが正常に起動できること | まずCodex CLIまたは該当クライアント自体が正常に動作することを確認します | CC SwitchはCodex本体をインストールしません |
| プロバイダーがOpenAI互換インターフェースをサポートしていること | 管理画面でAPIアドレス、Base URL、OpenAI互換性などの説明が確認できる | Codexが互換インターフェースへリクエストを送信できる必要があるため |
| モデルがCodex用途で利用可能であること | 管理画面のモデル一覧で利用可能なモデル名が確認できる | ClaudeやGeminiのモデル名をCodexに設定しないでください |
| Keyの状態が正常であること | 管理画面のトークンが期限切れ・無効化されておらず、残高が十分にある | 401エラーのほとんどはKeyの確認から原因を特定できます |
各項目の入力方法
| 設定項目 | 入力方法 | 初心者の注意点 |
|---|---|---|
| プロバイダー名 | プロバイダーの名称や用途を入力 | 例：「メインOpenAI互換プロバイダー」 |
| 対象ツール / プリセット | CodexまたはOpenAI/Codex関連のプリセットを選択 | Claude CodeやGeminiを選択しないでください |
| Base URL | プロバイダーの管理画面に記載されているAPIリンクをコピー | 通常はプロバイダーが提供するAPIアドレスです。/v1 を含めるかどうかは管理画面の記載例に従ってください |
| API Key | 完全なKeyをコピー | 前後に余分なスペースを入れず、メモ名などを誤ってコピーしないようにしてください |
| モデル名 | 管理画面のモデル一覧から正確にコピー | モデル一覧の取得に失敗した場合は手動で追加し、管理画面の名称をそのまま正確にコピーしてください |
Codexに適用する
- CC Switchを開き、プロバイダー管理画面へ移動します。
- 新規プロバイダーを追加するか、既存のOpenAI互換プロバイダーを選択します。
- 対象ツールとしてCodexまたはOpenAI/Codex関連のプリセットを選択します。
- Base URL、API Key、モデル名を入力して保存します。
- Apply / Switchを実行して、このプロバイダー設定をCodexに適用します。
- 現在のターミナルウィンドウを閉じて再度開き、テストを行います。
動作確認テスト
まず最短の質問でリクエストをテストし、通信が通るか確認します。テストが成功したら、実際のプロジェクトでの利用に進んでください。
Codex 最小テスト
codex "Please reply only: CC-Switch Codex is active"モデルが存在しないというエラーが返ってきた場合はまずモデル名を確認し、認証エラー（Unauthorized）の場合はKeyを確認してください。接続タイムアウトが発生した場合は、Base URLとネットワーク接続を確認してください。