# Cara Menggunakan CLI OpenAI Codex dengan API Key Sendiri

> Buka Potensi Codex CLI dengan Zeabur AI Hub

<AIHubShutdownNotice />

**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**](https://zeabur.com/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**:
    
    ```bash
    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:

```toml
# 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:

```bash
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`):
    
    ```bash
    nano ~/.zshrc
    ```
    
2. Tempelkan baris ini di bagian paling bawah:
    
    ```bash
    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:**

```bash
codex "Write a hello world function in Python"
```

**Mengganti Model:**

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

```bash
# 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!