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 / Anthropic | https://www.relay-api.com | Anthropic Messages |
| GPT / OpenAI | https://www.relay-api.com/v1 | OpenAI Chat Completions |
| Gemini | https://www.relay-api.com/v1beta | Google generateContent |
五、トラブルシューティング
| 現象 | 対処法 |
|---|---|
| 401 / 403 | キーが無効、未有効化、または残高不足。sk- キーが正しいか確認し、チャージを行ってください。 |
| 404 / モデル利用不可 | モデル名とプラットフォームの slug が一致しない、またはモデルが未有効化。モデルIDを確認してください。 |
| Unknown model | 指定するモデルIDは正確(大文字・小文字を区別)である必要があります。モデル広場で確認してください。 |
セキュリティに関するヒント:APIキーを公開リポジトリに含めないでください。.env や環境変数を使用してください。生成タスクはトークン消費が大きいため、残高にご注意ください。
