Tutorial Integrasi OpenAI Codex: Konfigurasi GPT dengan Base URL Kustom
Tutorial integrasi agen coding terminal OpenAI Codex (Codex CLI): Instalasi, konfigurasi Base URL kustom dan kunci API melalui variabel lingkungan atau config.toml untuk menggunakan model GPT.
1. Apa itu Codex
OpenAI Codex (Codex CLI) adalah agen coding terminal resmi dari OpenAI yang mendukung endpoint API khusus. Dengan mengarahkannya ke gateway OpenAI-compatible milik situs ini, Anda dapat menggunakan model seri GPT dengan kunci sk- Anda.
2. Instalasi Codex CLI
npm install -g @openai/codexSetelah instalasi, ketik codex di terminal; gunakan codex --model gpt-5.5 atau pilih model melalui pemilihan interaktif untuk beralih model.
3. 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.5② config.toml (Direkomendasikan, untuk penggunaan jangka panjang)
# ~/.codex/config.toml
[model_providers.myrelay]
name = "Gateway API Jizi"
base_url = "https://www.relay-api.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
[model]
model_provider = "myrelay"
model = "gpt-5.5"Setelah disimpan, jalankan codex --model gpt-5.5 untuk memulai.
4. Referensi Alamat Interface
| Grup Model | Alamat Entry (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 |
5. Pemecahan Masalah Umum
| Masalah | Solusi |
|---|---|
| 401 / 403 | Kunci tidak valid, belum diaktifkan, atau saldo habis; periksa kembali kunci sk- dan isi ulang saldo. |
| 404 / Model tidak tersedia | Nama model tidak cocok dengan slug platform, atau model tersebut belum diaktifkan; verifikasi ID model. |
| Unknown model | ID model yang dimasukkan harus akurat (termasuk huruf besar/kecil), gunakan Model Plaza untuk mencocokkan. |
Saran Keamanan: Jangan tulis kunci di repositori publik, gunakan .env atau variabel lingkungan; tugas pembuatan konten menghabiskan banyak token, perhatikan saldo Anda.
Penjelasan Base URL: Situs ini menerima /v1beta/models/... dan /v1beta/v1beta/models/... (serta /v1/... dan /v1/v1/...), jadi apakah klien menambahkan /v1 atau /v1beta secara otomatis tidak akan memengaruhi panggilan: Base URL dapat diisi dengan domain root atau alamat yang menyertakan /v1beta. Silakan salin ID model dari bagian "Model ID" di sudut kanan atas halaman "Token" pada konsol.