> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Menggunakan APIMart di Codex CLI

> Panduan terperinci untuk mengonfigurasi dan menggunakan layanan API APIMart di Codex CLI, sehingga Anda dapat mengakses beberapa model AI untuk bantuan pemrograman dengan konfigurasi sederhana.

## Pendahuluan

Codex CLI adalah agen coding terminal open source dari OpenAI yang dapat membaca dan menulis file, menjalankan perintah, memperbaiki bug, dan menyelesaikan tugas coding penuh langsung dari baris perintah.
Dengan terhubung melalui APIMart, Anda dapat menggunakan beberapa model, termasuk GPT dan Claude, di Codex CLI dengan harga yang lebih fleksibel dan kompetitif.

## Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. **Node.js sudah terinstal**
   Unduh dan instal dari [situs Node.js](https://nodejs.org/) (disarankan LTS terbaru, v20 atau lebih baru) untuk memasang Codex CLI melalui npm

2. **API key APIMart sudah diperoleh**
   Masuk ke [Konsol APIMart](https://apimart.ai/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`)

<Note>**Tips:** Jika Anda belum memiliki akun APIMart, daftar terlebih dahulu di [APIMart](https://apimart.ai) dan dapatkan API key Anda.</Note>

## Langkah 1: Instal Codex CLI

Pilih salah satu metode berikut untuk instalasi:

<Tabs>
  <Tab title="npm (Direkomendasikan)">
    Instal secara global dengan npm; berfungsi di semua sistem operasi:

    ```bash theme={null}
    npm install -g @openai/codex
    ```

    <Note>Jika mengalami masalah izin, tambahkan `sudo` di depan perintah (macOS / Linux).</Note>
  </Tab>

  <Tab title="Homebrew (macOS)">
    Pengguna macOS juga dapat menginstal dengan Homebrew:

    ```bash theme={null}
    brew install codex
    ```
  </Tab>
</Tabs>

### Verifikasi instalasi

Setelah menginstal, jalankan perintah berikut untuk memastikan:

```bash theme={null}
codex --version
```

Jika nomor versi ditampilkan, instalasi berhasil.

## Langkah 2: Konfigurasikan API APIMart

Codex CLI mengelola penyedia model melalui file konfigurasi di direktori `~/.codex/`. Yang perlu dilakukan adalah menambahkan penyedia kustom yang mengarah ke APIMart.

### 2.1 Temukan direktori konfigurasi

* **macOS / Linux:** `~/.codex/`
* **Windows:** `C:\Users\<username>\.codex\`

<Note>Jika direktori belum ada, jalankan `codex` sekali di terminal lalu tekan `Ctrl + C` untuk keluar; direktori akan dibuat otomatis.</Note>

### 2.2 Konfigurasikan API key

Di direktori konfigurasi, buat atau edit file `auth.json` lalu isi key APIMart Anda:

```json theme={null}
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
```

| Field            | Deskripsi                                   |
| ---------------- | ------------------------------------------- |
| `OPENAI_API_KEY` | API key APIMart Anda (diawali dengan `sk-`) |

### 2.3 Konfigurasikan penyedia model

Di direktori konfigurasi, buat atau edit file `config.toml` lalu tambahkan penyedia APIMart:

```toml theme={null}
# Model default
model = "gpt-5.5"
# Penyedia default — cocok dengan [model_providers.apimart] di bawah
model_provider = "apimart"

# Konfigurasi penyedia APIMart
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true
```

| Field                  | Deskripsi                                                                     |
| ---------------------- | ----------------------------------------------------------------------------- |
| `model`                | ID model default; pilih salah satu dari daftar model di bawah                 |
| `model_provider`       | Penyedia default; harus cocok dengan ID di dalam `[model_providers.xxx]`      |
| `name`                 | Nama tampilan penyedia; dapat disesuaikan                                     |
| `base_url`             | URL APIMart yang kompatibel dengan OpenAI — tetap `https://api.apimart.ai/v1` |
| `wire_api`             | Protokol wire — versi Codex terbaru memerlukan `responses` (Responses API)    |
| `requires_openai_auth` | Atur ke `true` untuk autentikasi menggunakan key dari `auth.json`             |

Setelah menyimpan kedua file, mulai ulang Codex CLI agar perubahan berlaku.

<Warning>Pastikan `auth.json` adalah JSON valid dan `config.toml` adalah TOML valid. Jangan gunakan tanda kutip full-width atau smart quotes, karena konfigurasi tidak akan diterapkan.</Warning>

## Langkah 3: Mulai

### Verifikasi konfigurasi

Di direktori proyek mana pun, jalankan perintah berikut untuk memastikan semuanya terhubung:

```bash theme={null}
codex "Introduce yourself in one sentence"
```

Jika Anda mendapat balasan AI, konfigurasi sudah berfungsi. Jika muncul layar masuk atau error `401` / `403`, lihat bagian FAQ di bawah.

### Mode interaktif

Jalankan `codex` langsung untuk masuk ke UI interaktif; ideal untuk tugas coding lengkap:

```bash theme={null}
codex
```

Setelah masuk, jelaskan kebutuhan Anda dalam bahasa alami, misalnya:

```
Create an Express.js server with a JSON-returning health check endpoint
```

Codex akan menganalisis proyek Anda, menghasilkan kode, menjalankan perintah, dan meminta konfirmasi sebelum melakukan operasi sensitif.

### Mode persetujuan

Saat pertama kali dijalankan, Codex akan meminta Anda memilih tingkat persetujuan:

| Mode            | Deskripsi                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------ |
| **Read Only**   | Hanya pembacaan file yang diizinkan; perubahan atau perintah apa pun memerlukan konfirmasi |
| **Auto**        | Dapat membaca/menulis file dan menjalankan perintah di direktori kerja (direkomendasikan)  |
| **Full Access** | Melakukan operasi apa pun tanpa konfirmasi; gunakan dengan hati-hati                       |

Kami menyarankan memulai dengan mode **Auto**. Ketik `/approvals` di UI interaktif untuk mengubahnya kapan saja.

### Beralih model

Di UI interaktif, ketik `/model` untuk beralih cepat, atau ubah kolom `model` di `config.toml` lalu mulai ulang.

## Model yang Didukung

Untuk Codex CLI, model seri GPT-5 berikut direkomendasikan:

| ID Model        | Keunggulan                                   | Kasus Penggunaan yang Direkomendasikan         |
| --------------- | -------------------------------------------- | ---------------------------------------------- |
| `gpt-5.5`       | Flagship terbaru, kemampuan coding teratas   | Pilihan pertama untuk Codex, rekayasa kompleks |
| `gpt-5.4`       | Flagship generasi sebelumnya, sangat mumpuni | Coding kompleks, desain arsitektur             |
| `gpt-5.4-mini`  | Ringan, cepat, hemat biaya                   | Coding harian, iterasi cepat                   |
| `gpt-5.3-codex` | Model coding yang dioptimalkan untuk Codex   | Tugas coding agentik                           |
| `gpt-5.2`       | Stabil dan seimbang                          | Tugas coding rutin                             |

<Tip>
  **Tips pemilihan model:** Seri GPT-5 di atas paling cocok dengan Codex CLI. Untuk pengalaman terbaik, pilih `gpt-5.5`; `gpt-5.3-codex` dioptimalkan khusus untuk skenario coding agentik Codex.
</Tip>

## Perintah Umum

Perintah dan pintasan yang sering digunakan di Codex CLI:

| Perintah                | Deskripsi                                 |
| ----------------------- | ----------------------------------------- |
| `codex`                 | Masuk ke UI interaktif                    |
| `codex "task"`          | Mulai dengan instruksi awal               |
| `codex exec "task"`     | Mode non-interaktif — jalankan dan keluar |
| `codex --model gpt-5.4` | Mulai dengan model tertentu               |
| `codex --version`       | Menampilkan nomor versi                   |
| `/model`                | Beralih model di dalam UI interaktif      |
| `/approvals`            | Sesuaikan mode persetujuan di dalam UI    |
| `Ctrl + C`              | Keluar dari UI interaktif                 |

## FAQ

### Q1: Layar sign-in ChatGPT muncul setelah menjalankan?

Jika Anda melihat "Sign in with ChatGPT" atau yang serupa setelah menjalankan, konfigurasi belum berlaku.

**Pemecahan Masalah:**

1. Pastikan `config.toml` dan `auth.json` berada di dalam `~/.codex/`
2. Pastikan `model_provider` di `config.toml` diatur ke `apimart`
3. Pastikan `auth.json` adalah JSON valid dan key terisi lengkap

### Q2: Mendapat error 401 / 403?

| Kode Status        | Arti                                  | Solusi                                                         |
| ------------------ | ------------------------------------- | -------------------------------------------------------------- |
| `401 Unauthorized` | API key hilang atau tidak valid       | Periksa key di `auth.json`; harus diawali dengan `sk-`         |
| `403 Forbidden`    | Izin tidak cukup atau key kedaluwarsa | Buka [Konsol](https://apimart.ai/keys) untuk memverifikasi key |

Pastikan juga `base_url` diatur ke `https://api.apimart.ai/v1`, bukan URL resmi OpenAI.

### Q3: Koneksi gagal?

1. Periksa koneksi jaringan Anda
2. Pastikan `base_url` di `config.toml` benar
3. Jika Anda berada di balik proxy, pastikan proxy mengizinkan akses ke `api.apimart.ai`

### Q4: `wire_api = "chat"` tidak lagi didukung?

Versi Codex CLI terbaru (0.84.0 dan setelahnya) telah menghapus protokol `chat`. Perbarui `wire_api` di `config.toml` menjadi `responses`:

```toml theme={null}
wire_api = "responses"
```

APIMart mendukung Responses API; cukup mulai ulang Codex setelah perubahan.

### Q5: Pemanggilan tool atau eksekusi gagal?

Pastikan `wire_api` di `config.toml` diatur ke `responses`. Jika masih mengalami masalah kompatibilitas, beralihlah ke model seri GPT-5 yang direkomendasikan (misalnya `gpt-5.5`, `gpt-5.3-codex`) karena lebih andal dengan Codex CLI.

### Q6: Gunakan environment variable alih-alih auth.json?

Anda juga dapat mengonfigurasi key melalui environment variable. Ubah blok penyedia di `config.toml` menjadi:

```toml theme={null}
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"
```

Kemudian atur environment variable `APIMART_API_KEY` ke key APIMart Anda. `auth.json` tidak lagi diperlukan dalam setup ini.

### Q7: Bagaimana cara beralih model?

Dua cara:

1. **Di UI interaktif**: Ketik `/model` untuk beralih
2. **Edit konfigurasi**: Ubah kolom `model` di `config.toml` lalu mulai ulang Codex CLI

### Q8: Bagaimana memeriksa penggunaan dan penagihan?

Masuk ke [Konsol APIMart](https://apimart.ai/overview) untuk melihat statistik panggilan API, detail konsumsi token, dan tren biaya.

## Dukungan dan Bantuan

Jika Anda mengalami masalah saat menggunakan Codex CLI:

* 📚 [Pusat Dokumentasi APIMart](https://docs.apimart.ai)
* 💬 [Komunitas Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Dukungan teknis: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Mulai dengan APIMart" icon="rocket" href="https://apimart.ai">
  Daftar APIMart sekarang, dapatkan API key Anda, dan rasakan asisten pemrograman multi-model di Codex CLI!
</Card>