Codex CLI adalah agent coding resmi OpenAI yang jalan di terminal. Ia mendukung provider custom lewat file config.toml, jadi backend-nya bisa diganti ke gateway OpenAI-compatible tanpa mengubah cara kerja agent-nya.
Panduan ini mengikuti format yang sama dengan yang direkomendasikan dashboard gateway: provider appverse dengan wire_api responses.
Sebelum mulai
- Paket AI Gateway aktif (Token Plan atau Pay As You Go). Belum punya? Pilih paket dulu di sini.
- API key aktif dari dashboard gateway.
- Codex CLI sudah terinstal. Belum? Jalankan npm install -g @openai/codex.
- Satu Model ID dari tabel harga model.
Langkah integrasi
- 1
Edit config.toml
Buka file ~/.codex/config.toml, lalu isi model default dan blok provider appverse berikut.
wire_api responses memakai format Responses API yang dilayani gateway. Bila kamu butuh format Chat Completions klasik, ganti nilainya menjadi chat.
~/.codex/config.toml model = "MODEL_ID_DARI_DASHBOARD" model_provider = "appverse" [model_providers.appverse] name = "appverse" base_url = "https://ai.appverse.id/v1" wire_api = "responses" - 2
Isi auth.json dengan API key
Buka file ~/.codex/auth.json dan set mode autentikasi ke API key gateway.
File ini berisi key yang bisa dipakai memakai saldo kamu, jadi jangan pernah di-commit ke repository atau dibagikan.
~/.codex/auth.json { "auth_mode": "apikey", "OPENAI_API_KEY": "API_KEY_KAMU" } - 3
Restart Codex dan uji
Tutup sesi Codex yang sedang berjalan, lalu buka lagi supaya config baru terbaca. Kirim satu prompt kecil di folder project untuk memastikan respons keluar.
Bila muncul error model tidak ditemukan, yang kamu isi kemungkinan nama tampilan model. Ganti dengan Model ID persis dari dashboard atau tabel harga.
Tips pemakaian
- Blok model_providers boleh berisi lebih dari satu provider. Berganti backend cukup dengan mengubah nilai model_provider atau flag model saat menjalankan Codex.
- Amankan auth.json dengan izin file terbatas di komputer pribadi kamu, dan jangan pernah menyalinnya ke repo atau CI.
- Pantau saldo dan pemakaian dari dashboard gateway supaya kuota tidak habis di tengah task panjang.
Pertanyaan yang sering muncul
Kenapa muncul error model tidak ditemukan?
Yang diisi biasanya nama tampilan model, bukan Model ID. Codex mengirim nilai model apa adanya ke gateway, jadi nilainya harus persis Model ID dari dashboard.
Apa arti auth_mode apikey di auth.json?
Artinya Codex mengautentikasi dengan API key, bukan login akun ChatGPT. Key yang dipakai adalah API key gateway Appverse kamu.
Apa beda wire_api responses dan chat?
Dua-duanya format request ke gateway. Dashboard merekomendasikan responses untuk Codex, sementara chat memakai endpoint /v1/chat/completions yang kompatibel dengan hampir semua tool OpenAI-compatible.
Apakah prompt saya disimpan di gateway?
Tidak. Gateway menerapkan ZDR (Zero Data Retention): prompt dan response tidak disimpan, tidak dibaca, dan tidak dipakai untuk training.