Codex CLI di saldo prabayar, lewat satu blok provider

Codex CLI adalah agent coding berbasis command line dari OpenAI. Konfigurasinya punya setelan model_provider yang nilai default-nya openai, sehingga request dikirim ke antarmuka OpenAI sendiri. Setelan itu bisa diganti: definisikan provider Anda di config.toml dengan alamat endpoint dan nama environment variable tempat key disimpan, lalu arahkan model_provider ke sana. Perintah dan cara pakai Codex tetap sama; yang berganti hanya pihak yang menagih.

Codex hanya berbicara satu protokol, yaitu Responses API dari OpenAI: referensi konfigurasinya menyebut wire_api hanya mendukung nilai responses. Karena itu hal pertama yang perlu dipastikan dari sebuah gateway adalah tersedianya /v1/responses, bukan hanya /v1/chat/completions. Di sini kedua rute ada, dan Codex memakai yang pertama.

Blok di bawah berisi empat baris, dan API key tidak ditulis di file. Arti tiap setelan:

• model_provider memilih blok berdasarkan nama tabelnya. Nama itu Anda tentukan sendiri, tetapi openai, ollama, lmstudio, amazon-bedrock, amazon-bedrock-runtime, dan gcp adalah id bawaan Codex yang tidak bisa ditimpa.
• base_url diisi https://api.relayswitch.io/v1, dengan /v1; Codex menambahkan /responses di belakangnya.
• env_key adalah nama environment variable tempat key disimpan, bukan key itu sendiri. Karena key tetap di environment variable, file konfigurasi aman untuk di-commit atau disinkronkan.
• wire_api hanya punya satu nilai yang berlaku, responses, dan itu juga nilai default-nya, jadi baris ini boleh dihapus.
• requires_openai_auth bernilai default false dan tidak perlu ditulis: provider kustom memakai key dari env_key, bukan login akun OpenAI.

Tulis blok tadi di ~/.codex/config.toml. Direktori itu ditentukan oleh environment variable CODEX_HOME dan default-nya ~/.codex; provider harus ditulis di file tingkat pengguna ini. Setelah itu export key di terminal tempat Codex dijalankan, lalu mulai. Tambahkan baris export ke file konfigurasi shell supaya terminal baru ikut membawanya.

Sebelum menjalankan Codex, kirim satu request Responses yang kecil untuk memastikan key dan alamatnya benar. Opsi -i menampilkan baris status dan header respons, termasuk id request.

Jika jawabannya 200, jalankan codex dan kirim perintah pertama. Request itu muncul di halaman Usage pada console dalam hitungan detik, lengkap dengan token dan biayanya. Untuk mengganti model sementara, pakai codex --model diikuti id-nya.

Tabel ini memuat model GPT di katalog dalam USD per satu juta token, dengan harga input, cached input, dan output yang terpisah. Codex dirancang untuk model GPT dan rute Responses, jadi pastikan id yang Anda tulis di config.toml menjawab uji curl di atas.

Codex mengirim ulang percakapan dan output tool pada setiap giliran. Token itu ditagih dengan harga cached input saat mengenai cache, dan respons melaporkan jumlah token yang ter-cache; kena atau tidaknya bergantung pada model dan request itu sendiri. Cara berhematnya jadi konkret: pakai model yang lebih murah untuk perubahan harian dan pindah ke yang lebih mahal hanya untuk review dan refactor yang sulit, mulai sesi baru setelah satu tugas selesai agar konteks tidak terus memanjang, dan buat key khusus Codex dengan anggaran dolar serta batas belanja harian. Saat batas tercapai, gateway menjawab 402 dan hanya key itu yang berhenti; sisa saldo akun tidak tersentuh.

Profile adalah file bernama ~/.codex/<name>.config.toml yang hanya berisi baris yang berbeda dari config.toml, dan ditumpuk di atasnya saat Codex dijalankan dengan codex --profile <name>. Sejak Codex 0.134.0, tabel [profiles.<name>] di dalam config.toml tidak lagi dibaca dan pemilih profile = di tingkat atas dihapus; tutorial yang ditulis sebelum itu masih memakai cara lama dan tidak berfungsi jika disalin. Nilai model_reasoning_effort mengikuti tingkat yang didukung model yang dipilih; Codex mengirimnya di setiap request dan gateway meneruskannya ke model apa adanya.

Saat memakai provider kustom, menu /model di Codex tetap menampilkan model OpenAI bawaannya, bukan model provider Anda. Memilih salah satu akan menulis ulang file profile yang aktif: modelnya berganti, provider-nya tidak. Jika id yang tertulis ada di katalog, Codex berjalan dengan harga model itu; jika tidak, jawabannya 404. Untuk mengganti model, pakai --profile atau --model.

Status 401 sampai 404 dikembalikan sebelum request mencapai model, sedangkan 429, 502, dan 503 tidak membawa jawaban; semuanya tidak ditagih. Tabel lengkap per status ada di halaman OpenAI API. Untuk coding dengan Claude di terminal, pakai Claude Code; keduanya berjalan dengan key dan saldo yang sama, dan cara membuat key ada di halaman Claude API key.