Tutorial Integrasi OpenAI Codex: Konfigurasi Custom Base URL untuk GPT
Tutorial integrasi agen pengkodean terminal OpenAI Codex (Codex CLI): Instalasi, konfigurasi kustom Base URL dan kunci API melalui variabel lingkungan atau config.toml untuk menggunakan model GPT.
I. Apa itu Codex
OpenAI Codex (Codex CLI) adalah agen pengkodean terminal resmi dari OpenAI yang mendukung titik akhir API kustom. Arahkan ke gateway OpenAI-compatible situs ini untuk menggunakan model seri GPT dengan kunci sk- Anda.
II. Instalasi Codex CLI
npm install -g @openai/codexSetelah instalasi, masukkan codex di terminal; gunakan codex --model gpt-5.4 atau pilih model melalui pilihan interaktif untuk beralih antar model.
III. Konfigurasi Codex
① Variabel Lingkungan (Tercepat)
export OPENAI_BASE_URL="https://www.relay-api.com/v1"
export OPENAI_API_KEY="sk-kunci-anda"
codex --model gpt-5.4② config.toml (Direkomendasikan, untuk penggunaan jangka panjang)
# ~/.codex/config.toml
[model_providers.myrelay]
name = "Relay API Cerdas"
base_url = "https://www.relay-api.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
[model]
model_provider = "myrelay"
model = "gpt-5.4"Setelah disimpan, jalankan codex --model gpt-5.4 untuk memulai.
IV. Perbandingan Alamat Antarmuka
| Grup Model | Alamat Masuk Situs (Base URL) | Protokol |
|---|---|---|
| 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 |
V. Pemecahan Masalah Umum
| Gejala | Penanganan |
|---|---|
| 401 / 403 | Kunci tidak valid, belum diaktifkan, atau saldo habis; periksa kembali kunci sk- dan lakukan pengisian saldo. |
| 404 / Model tidak tersedia | Nama model tidak sesuai dengan slug platform, atau model belum diaktifkan; periksa ID model. |
| Unknown model | ID model yang dimasukkan harus akurat (termasuk huruf besar/kecil), verifikasi melalui dasbor model. |
Saran Keamanan: Jangan tulis kunci API langsung ke repositori publik; gunakan .env atau variabel lingkungan. Tugas pembuatan kode mengonsumsi banyak token, harap pantau saldo Anda.