OpenAI Codex中継接続チュートリアル:カスタムBase URLによるGPT設定

  • 发布时间
  • 语言ja

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 / Anthropichttps://www.relay-api.comAnthropic Messages
GPT / OpenAIhttps://www.relay-api.com/v1OpenAI Chat Completions
Geminihttps://www.relay-api.com/v1betaGoogle 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」からコピーして使用してください。