OpenAI Codex 中継接続ガイド:カスタム Base URL による GPT 設定

OpenAI Codex(Codex CLI)ターミナルコーディングエージェントの接続ガイド:インストール、環境変数や config.toml を用いたカスタム Base URL と API キーの設定、GPT モデルの使用方法について。

一、Codex とは

OpenAI Codex(Codex CLI) は、カスタム API エンドポイントをサポートする OpenAI 公式のターミナルコーディングエージェントです。当サイトのゲートウェイの OpenAI 互換入口を指定することで、GPT シリーズモデルと sk- キーを使用して利用可能です。

二、Codex CLI のインストール

npm install -g @openai/codex

インストール後、ターミナルで codex と入力します。codex --model gpt-5.4 を使用するか、対話モードでのモデル選択によりモデルを切り替えられます。

三、Codex の設定

① 環境変数(最速)

export OPENAI_BASE_URL="https://www.relay-api.com/v1"
export OPENAI_API_KEY="sk-あなたのキー"
codex --model gpt-5.4

② config.toml(長期利用におすすめ)

# ~/.codex/config.toml
[model_providers.myrelay]
name = "極智API中継"
base_url = "https://www.relay-api.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

[model]
model_provider = "myrelay"
model = "gpt-5.4"

保存後、codex --model gpt-5.4 を実行してください。

四、APIアドレス対応表

モデルグループ当サイトの入口 (Base URL)プロトコル
Claude / Anthropichttps://www.relay-api.comAnthropic Messages
GPT / OpenAIhttps://www.relay-api.com/v1OpenAI Chat Completions
Geminihttps://www.relay-api.com/v1betaGoogle generateContent

五、トラブルシューティング

現象対処法
401 / 403キーが無効、未有効化、または残高不足。sk- キーが正しいか確認し、チャージを行ってください。
404 / モデル利用不可モデル名とプラットフォームの slug が一致しない、またはモデルが未有効化。モデルIDを確認してください。
Unknown model指定するモデルIDは正確(大文字・小文字を区別)である必要があります。モデル広場で確認してください。

セキュリティに関するヒント:APIキーを公開リポジトリに含めないでください。.env や環境変数を使用してください。生成タスクはトークン消費が大きいため、残高にご注意ください。