Cara Menggunakan CLI OpenAI Codex dengan API Key Sendiri

Codex CLI adalah antarmuka yang ampuh untuk berinteraksi dengan AI melalui terminal Anda. Namun, mengunci diri pada satu penyedia layanan saja akan membatasi potensi Anda.

Dengan menghubungkan Codex CLI ke Zeabur AI Hub, Anda dapat mengarahkan kueri Anda ke model papan atas mana pun (seperti Claude, Grok, atau Gemini) menggunakan alat yang sama persis. Pengaturan ini bekerja dengan basis bayar sesuai penggunaan (pay-as-you-go)—tidak perlu repot mengelola banyak langganan untuk penyedia AI yang berbeda.

Berikut adalah cara mengaturnya.

🧱 Prasyarat

1. Instal Codex CLI:

   npm install -g @openai/codex
   

2. Kredensial Zeabur:

   • Buka Dashboard Zeabur Anda untuk mendapatkan AI Hub API Key.

3. Pilih Endpoint Anda

   Zeabur saat ini menyediakan dua endpoint. Pilih yang secara geografis paling dekat dengan Anda:

   • Asia (Tokyo): https://hnd1.aihub.zeabur.ai/
   • US West (San Francisco): https://sfo1.aihub.zeabur.ai/

---

⚙️ Panduan Pengaturan Cepat

Anda perlu mengonfigurasi Codex untuk berkomunikasi dengan API terpadu Zeabur, bukan langsung ke penyedia tertentu.

1. Buat File Konfigurasi

Buat atau edit file konfigurasi di ~/.codex/config.toml. Tempelkan konfigurasi berikut untuk mendefinisikan Zeabur sebagai penyedia:

# Model default yang digunakan
model = "gemini-3-pro-preview"
model_provider = "zeabur"

[model_providers.zeabur]
name = "Zeabur AI Hub"
# Catatan: Pastikan Anda menambahkan /v1 ke endpoint
base_url = "<https://hnd1.aihub.zeabur.ai/v1>"
env_key = "ZEABUR_API_KEY"
wire_api = "chat"

2. Atur API Key Anda

Anda perlu membuat API key Anda tersedia untuk alat tersebut.

Opsi A: Sekadar mencoba (Sementara)

Untuk penggunaan satu sesi:

export ZEABUR_API_KEY="zeabur-api-key-anda"
codex "Who are you?"

Opsi B: Atur sekali untuk selamanya (Permanen)

Agar tidak perlu mengatur kunci setiap saat, tambahkan ke profil shell Anda.

1. Buka konfigurasi shell Anda (misalnya, ~/.zshrc atau ~/.bashrc):

   nano ~/.zshrc
   

2. Tempelkan baris ini di bagian paling bawah:

   export ZEABUR_API_KEY="zeabur-api-key-anda"
   

3. Simpan dan muat ulang: source ~/.zshrc

---

💸 Mulai Coding (Dengan Model Apa Saja)

Sekarang Anda dapat menggunakan alat CLI dengan fleksibilitas untuk mengganti model secara langsung.

Penggunaan Dasar:

codex "Write a hello world function in Python"

Mengganti Model:

Anda dapat menimpa model default yang ditentukan dalam konfigurasi Anda menggunakan flag -m.

# Gunakan Gemini
codex -m gemini-3-pro-preview "hi"

# Gunakan Claude
codex -m claude-sonnet-4-20250514 "hi"

# Gunakan GPT-4o
codex -m gpt-4o "hi"

Mengapa ini lebih baik:

• Fleksibilitas: Beralih antara Grok, Claude, dan GPT tanpa mengganti alat.
• Efisiensi Biaya: Bayar hanya untuk token yang Anda gunakan melalui Zeabur, daripada membayar biaya bulanan tetap untuk banyak langganan AI.

---

🔧 Pemecahan Masalah (Troubleshooting)

Jika Anda mengalami masalah:

• 401 Unauthorized:
  • Periksa apakah base_url di konfigurasi Anda menyertakan /v1.
  • Verifikasi variabel lingkungan Anda sudah diatur: echo $ZEABUR_API_KEY.
• Model Not Found:
  • Pastikan nama model (misalnya, gpt-4o) saat ini didukung oleh Zeabur AI Hub. Periksa dashboard Zeabur untuk daftar ID model yang tersedia.

Selamat Coding!