Menggunakan APIMart di Codex CLI

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:

Node.js sudah terinstal Unduh dan instal dari situs Node.js (disarankan LTS terbaru, v20 atau lebih baru) untuk memasang Codex CLI melalui npm
API key APIMart sudah diperoleh Masuk ke Konsol APIMart untuk mendapatkan API key Anda (diawali dengan sk-)

Tips: Jika Anda belum memiliki akun APIMart, daftar terlebih dahulu di APIMart dan dapatkan API key Anda.

Langkah 1: Instal Codex CLI

Pilih salah satu metode berikut untuk instalasi:

npm (Direkomendasikan)
Homebrew (macOS)

Instal secara global dengan npm; berfungsi di semua sistem operasi:

npm install -g @openai/codex

Jika mengalami masalah izin, tambahkan sudo di depan perintah (macOS / Linux).

Pengguna macOS juga dapat menginstal dengan Homebrew:

brew install codex

Verifikasi instalasi

Setelah menginstal, jalankan perintah berikut untuk memastikan:

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\

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

2.2 Konfigurasikan API key

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

{
  "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:

# 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.

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.

Langkah 3: Mulai

Verifikasi konfigurasi

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

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:

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

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.

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

Jika Anda melihat “Sign in with ChatGPT” atau yang serupa setelah menjalankan, konfigurasi belum berlaku. Pemecahan Masalah:

Pastikan config.toml dan auth.json berada di dalam ~/.codex/
Pastikan model_provider di config.toml diatur ke apimart
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 untuk memverifikasi key

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

Q3: Koneksi gagal?

Periksa koneksi jaringan Anda
Pastikan base_url di config.toml benar
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:

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:

[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:

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

Q8: Bagaimana memeriksa penggunaan dan penagihan?

Masuk ke Konsol APIMart untuk melihat statistik panggilan API, detail konsumsi token, dan tren biaya.

Dukungan dan Bantuan

Jika Anda mengalami masalah saat menggunakan Codex CLI:

Mulai dengan APIMart

Daftar APIMart sekarang, dapatkan API key Anda, dan rasakan asisten pemrograman multi-model di Codex CLI!

Documentation Index

​Pendahuluan

​Prasyarat

​Langkah 1: Instal Codex CLI

​Verifikasi instalasi

​Langkah 2: Konfigurasikan API APIMart

​2.1 Temukan direktori konfigurasi

​2.2 Konfigurasikan API key

​2.3 Konfigurasikan penyedia model

​Langkah 3: Mulai

​Verifikasi konfigurasi

​Mode interaktif

​Mode persetujuan

​Beralih model

​Model yang Didukung

​Perintah Umum

​FAQ

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

​Q2: Mendapat error 401 / 403?

​Q3: Koneksi gagal?

​Q4: wire_api = "chat" tidak lagi didukung?

​Q5: Pemanggilan tool atau eksekusi gagal?

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

​Q7: Bagaimana cara beralih model?

​Q8: Bagaimana memeriksa penggunaan dan penagihan?

​Dukungan dan Bantuan

Mulai dengan APIMart

Pendahuluan

Prasyarat

Langkah 1: Instal Codex CLI

Verifikasi instalasi

Langkah 2: Konfigurasikan API APIMart

2.1 Temukan direktori konfigurasi

2.2 Konfigurasikan API key

2.3 Konfigurasikan penyedia model

Langkah 3: Mulai

Verifikasi konfigurasi

Mode interaktif

Mode persetujuan

Beralih model

Model yang Didukung

Perintah Umum

FAQ

Q1: Layar sign-in ChatGPT muncul setelah menjalankan?

Q2: Mendapat error 401 / 403?

Q3: Koneksi gagal?

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

Q5: Pemanggilan tool atau eksekusi gagal?

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

Q7: Bagaimana cara beralih model?

Q8: Bagaimana memeriksa penggunaan dan penagihan?

Dukungan dan Bantuan