OpenAI Codex中継接続チュートリアル:カスタムBase URLによるGPT設定
OpenAI Codex(Codex CLI)ターミナルコーディングエージェントの接続チュートリアル:インストール、環境変数またはconfig.tomlによるカスタムBase URLとキーの設定、GPTモデルの利用方法について解説します。
1. Codexとは
OpenAI Codex(Codex CLI)は、OpenAI公式のターミナル用コーディングエージェントであり、カスタムAPIエンドポイントをサポートしています。これを当サイトのゲートウェイのOpenAI互換エントリーポイントに向けることで、GPTシリーズモデルとあなたの sk- キーを使用できるようになります。
2. Codex CLIのインストール
npm install -g @openai/codex
インストール後、ターミナルで codex と入力します。codex --model gpt-5.5 を使用するか、対話モードのモデル選択からモデルを切り替えることができます。
3. Codexの設定
① 環境変数(最も迅速)
export OPENAI_BASE_URL="https://www.relay-api.com/v1"
export OPENAI_API_KEY="sk-あなたのキー"
codex --model gpt-5.5
② 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.5"
保存後、codex --model gpt-5.5 を実行すれば完了です。
4. インターフェースアドレス対照表
| モデルグループ | 当サイトのエントリーポイント(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 |
5. よくあるトラブルシューティング
| 現象 | 対応 |
|---|---|
| 401 / 403 | キーが無効、未有効化、または残高不足です。sk- キーが正しいか確認し、チャージを行ってください。 |
| 404 / モデル利用不可 | モデル名とプラットフォームのslugが一致していないか、モデルが無効です。モデルIDを確認してください。 |
| Unknown model | モデルIDは正確(大文字・小文字含む)に入力してください。モデル広場で確認できます。 |
セキュリティアドバイス:APIキーを公開リポジトリに記述しないでください。.env や環境変数を使用しましょう。生成タスクはトークン消費が激しいため、残高に注意してください。
Base URLに関する説明:当サイトは /v1beta/models/... と /v1beta/v1beta/models/...(および /v1/... と /v1/v1/...)の両方を受け付けます。そのため、クライアントが自動的に /v1 や /v1beta を補完するかどうかに関わらず、どちらでも呼び出し可能です。Base URLにはドメインルート、または /v1beta を含むアドレスのどちらでも設定できます。モデルIDは、コントロールパネルの「トークン」ページ右上にある「モデルID」からコピーして使用してください。
