CodexでOpenAI互換中継サービスのベースURLを設定する方法

インストールと起動

Codex CLIはOpenAIのローカルコーディングエージェントです。公式のインストール手順は次のとおりです。

npm i -g @openai/codex
codex

初回起動時に、ChatGPTでログインするかAPIキーを使用するかを選択します。中継サービスを利用する場合は、通常、APIキーとOpenAI互換エンドポイントを使用します。

サービスの対応範囲を確認する

Codexは単純なチャット用シェルではありません。コードの読み取り、ファイルの編集、コマンドの実行を行うため、サービス側がOpenAI Responses API、またはCodexで動作するOpenAI互換インターフェースに明確に対応している必要があります。

サービス運営者に次の点を確認してください。

• ベースURLがOpenAI互換か
• Responses APIに対応しているか
• 使用するモデル名
• ストリーミングとツール呼び出しに対応しているか
• 特別なヘッダーやクエリパラメーターが必要か

サービスをまだ選んでいない場合は、AI API中継サービスの料金比較とAI API中継サービス一覧を確認してください。前者は料金体系とサービス内クレジットの換算率、後者はOpenAI互換を含む対応モデルと支払方法を比較するためのページです。

設定

一時的なテストでは、まず環境変数を使用します。

export OPENAI_API_KEY="your proxy API key"
export OPENAI_BASE_URL="https://your-proxy.example/v1"
codex

長期利用する場合は、~/.codex/config.tomlにプロバイダーを登録し、OpenAI公式、中継サービス、ローカルモデル、チームゲートウェイごとにプロファイルを分ける方法を検討してください。

デバッグの順序

1. codex --versionが最新か確認します。
2. 現在のターミナルでOPENAI_API_KEYとOPENAI_BASE_URLが有効か確認します。
3. Codexに必要な具体的なAPI形式をサービス運営者に確認します。「OpenAI形式に対応しているか」だけでは不十分です。
4. config.tomlを使用している場合は、一時的に環境変数へ戻し、確認対象を減らします。

Codexは更新が速く、設定項目も今後変わる可能性があります。ガイドでは「検証可能な最小構成」と高度なプロファイル設定を分けてください。複雑なTOML設定をそのままコピーすると、問題が発生した場所を特定できなくなります。