Langsung ke konten utama

​
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 (disarankan LTS terbaru, v20 atau lebih baru) untuk memasang Codex CLI melalui npm
  2. 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:
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).

​
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"
}
FieldDeskripsi
OPENAI_API_KEYAPI 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
FieldDeskripsi
modelID model default; pilih salah satu dari daftar model di bawah
model_providerPenyedia default; harus cocok dengan ID di dalam [model_providers.xxx]
nameNama tampilan penyedia; dapat disesuaikan
base_urlURL APIMart yang kompatibel dengan OpenAI — tetap https://api.apimart.ai/v1
wire_apiProtokol wire — versi Codex terbaru memerlukan responses (Responses API)
requires_openai_authAtur 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:
ModeDeskripsi
Read OnlyHanya pembacaan file yang diizinkan; perubahan atau perintah apa pun memerlukan konfirmasi
AutoDapat membaca/menulis file dan menjalankan perintah di direktori kerja (direkomendasikan)
Full AccessMelakukan 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 ModelKeunggulanKasus Penggunaan yang Direkomendasikan
gpt-5.5Flagship terbaru, kemampuan coding teratasPilihan pertama untuk Codex, rekayasa kompleks
gpt-5.4Flagship generasi sebelumnya, sangat mumpuniCoding kompleks, desain arsitektur
gpt-5.4-miniRingan, cepat, hemat biayaCoding harian, iterasi cepat
gpt-5.3-codexModel coding yang dioptimalkan untuk CodexTugas coding agentik
gpt-5.2Stabil dan seimbangTugas 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:
PerintahDeskripsi
codexMasuk ke UI interaktif
codex "task"Mulai dengan instruksi awal
codex exec "task"Mode non-interaktif — jalankan dan keluar
codex --model gpt-5.4Mulai dengan model tertentu
codex --versionMenampilkan nomor versi
/modelBeralih model di dalam UI interaktif
/approvalsSesuaikan mode persetujuan di dalam UI
Ctrl + CKeluar 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 StatusArtiSolusi
401 UnauthorizedAPI key hilang atau tidak validPeriksa key di auth.json; harus diawali dengan sk-
403 ForbiddenIzin tidak cukup atau key kedaluwarsaBuka Konsol 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: 
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:
  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 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!