Codex CLI: kunci Anda sendiri alih-alih langganan

Codex bukan pemberi saran di editor, melainkan pelaksana mandiri. Anda merumuskan tugas dengan kata-kata, ia sendiri yang memutuskan file mana yang akan dibaca, perintah mana yang akan dijalankan, dan apa yang harus diubah. Ia memiliki sekitar sepuluh alat: menjalankan perintah, membaca file, mengelola rencana kerja, meminta klarifikasi dari pengguna, membuat agen turunan untuk sub-tugas.

Ada dua mode kerja. Interaktif — codex tanpa argumen, dialog di terminal dengan tampilan setiap langkah. Non-interaktif — codex exec «tugas», satu kali jalan hingga hasil: nyaman untuk skrip dan CI.

Keamanan sudah terpasang: secara default agen bekerja di sandbox dan meminta konfirmasi sebelum melakukan perubahan. Tingkat kontrol diatur dalam konfigurasi — mulai dari «tanya semua» hingga menjalankan sepenuhnya otonom dengan hak tulis ke direktori kerja.

Keistimewaan lainnya adalah status dialog. Codex tidak meminta server untuk mengingat apa pun: ia memegang seluruh rentetan dialog sendiri dan mengirimkannya secara utuh setiap kali melangkah. Bagi Anda, ini berarti korespondensi tidak menumpuk di sisi penyedia model, dan perubahan endpoint tidak akan merusak sesi yang sudah dimulai.

Perbedaan dari Claude Code dan agen terminal lainnya adalah protokolnya. Codex berkomunikasi dengan model melalui Responses API, di mana korespondensi tidak dijelaskan sebagai daftar pesan datar, melainkan rentetan elemen: teks, pemanggilan alat, hasil panggilan, blok penalaran. Ini memberikan alat model dialog yang lebih ketat, dan Anda perlu memiliki endpoint yang memahami protokol ini.

Codex menyimpan pengaturan di ~/.codex/config.toml. Penyedia Anda sendiri dijelaskan dengan blok [model_providers.*], dan bidang kunci di sini adalah wire_api: tanpanya, Codex akan mencoba berbicara dalam Chat Completions dan tidak akan membangun siklus agen.

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

Kunci tidak ditulis ke dalam file: env_key menamai variabel lingkungan tempat Codex mengambilnya. Nama variabelnya unik, bukan OPENAI_API_KEY — sehingga pengaturan ini tidak mencegat alat Anda yang lain yang bekerja dengan OpenAI.

export JOINGONKA_API_KEY=jg-kunci-anda

Bidang model menetapkan model default, dan model_provider — blok mana yang akan digunakan. Keduanya dapat ditimpa saat peluncuran, sehingga satu konfigurasi dapat dengan mudah melayani beberapa penyedia: kerja, eksperimental, dan cadangan.

Kunci diberikan di kabinet pribadi setelah pendaftaran, di sana juga terlihat saldo dan penggunaan. Jika Anda lebih suka tidak menyentuh konfigurasi umum, blok yang sama dapat diteruskan satu kali melalui -c: codex -c model_provider=joingonka …. Dan untuk menjaga beberapa konfigurasi independen, tentukan direktori pengaturan dengan variabel CODEX_HOME.

Cara tercepat untuk memastikan koneksi berfungsi adalah dengan melakukan tes sekali jalan:

codex exec "Jawab dalam satu baris: berapa 17*3?"

Di header respons, Codex mencetak dengan siapa ia bekerja: model, provider: joingonka, mode sandbox, dan ID sesi. Jika penyedia Anda ada di sana dan jawaban muncul di bawah, koneksi dalam kondisi hidup.

Selanjutnya, periksa hal utama mengapa Codex digunakan, yaitu bekerja dengan file. Taruh file kecil dengan kesalahan yang jelas di direktori dan minta Codex untuk menemukannya:

codex exec "Baca calc.py dan katakan dalam satu kalimat apakah ada kesalahan."

Agen harus memanggil alat baca sendiri, membuka file, dan menjawab dengan tepat, termasuk menunjukkan baris kesalahannya. Jika ini terjadi, siklus agen penuh (permintaan → pemanggilan alat → hasil → jawaban) melalui gateway telah tersusun dengan benar.

Jika ada yang tidak beres, diagnosis biasanya dapat dibaca langsung dari pesan:

Permintaan pertama dalam sesi mungkin memakan waktu beberapa detik: Codex mengirimkan sistem prompt besar dan deskripsi semua alatnya, dan node jaringan perlu menerima tugas tersebut. Respons berikutnya akan datang lebih cepat.

Semua model jaringan tersedia dengan harga yang sama, jadi pilihannya adalah tentang perilaku, bukan anggaran. Di bawah ini adalah hasil dari pengujian langsung tugas yang sama (membaca file dan mencari kesalahan) melalui Codex pada setiap model.

Rekomendasi default adalah DeepSeek V4 Flash: pekerjaan agen akan cepat terbentur volume konteks, dan 380K token memberikan kemampuan untuk menyimpan banyak file sekaligus. Jika Anda menginginkan respons yang sangat singkat, gunakan Kimi K2.6. Model dapat diubah dengan satu baris model di konfigurasi atau flag -c model=… tanpa perlu mengedit file.

Daftar model jaringan terbaru selalu tersedia di GET https://gate.joingonka.ai/v1/models.

Alat agen menggunakan token secara berbeda daripada chat: untuk setiap kalimat Anda, Codex menambahkan sistem prompt dan deskripsi semua alat, lalu melakukan dialog multi-langkah dengan model. Dalam pengujian langsung, tugas sederhana «baca file dan temukan kesalahan» memakan biaya sekitar 18-20 ribu token. Ini adalah biaya yang wajar untuk otonomi, dan itulah sebabnya harga per token sangat krusial.

Melalui JoinGonka Gateway, token berharga $0.0047 per juta di input dan $0.014 per juta di output — harga sama untuk semua model jaringan dan diperbarui di halaman ini dari sumber langsung.

Sebagai perbandingan — bagaimana opsi berbayar diatur di Codex sendiri dan pesaingnya:

Pembayaran dilakukan untuk penggunaan aktual, tanpa langganan bulanan dan tanpa kuota jumlah permintaan: tidak ada jendela lima jam, batas «prompt», atau pengali di jam sibuk. Saldo diisi dengan mata uang kripto, sisa saldo dan penggunaan harian terlihat di dashboard pribadi. Penjelasan mendetail tentang ekonomi ada di artikel tentang API termurah.

Riwayat percakapan disimpan oleh Codex sendiri. Ia mengirimkan seluruh riwayat di setiap permintaan dan tidak meminta server untuk mengingat apa pun — dan kami juga tidak menyimpan korespondensi. Kode dan prompt Anda tidak tertinggal di gateway setelah mendapatkan respons.

Pencarian web berfungsi. Codex menyatakan alat pencarian dalam setiap permintaan dan gateway menerimanya: pencarian dilakukan di pihak kami, hasilnya dicampur ke dalam respons model.

Alat-alatnya bersifat lokal, bukan cloud. Codex mengeksekusi perintah dan membaca file secara lokal, tepat di mesin Anda, sehingga akses ke proyek tidak bergantung pada penyedia model.

Sandbox. Di Linux, Codex menggunakan bubblewrap untuk mengisolasi perintah yang dijalankan. Jika tidak ada di sistem, Codex akan memberi peringatan dan menggunakan salinan bawaan — ini tidak memengaruhi pekerjaan, tetapi lebih praktis untuk menginstal paket melalui manajer paket standar.

Jika Anda perlu bekerja dengan gambar — tangkapan layar antarmuka, diagram di foto — gunakan alat dengan model yang memiliki kemampuan visi untuk tugas-tugas tersebut: model di jaringan Gonka adalah model teks. Untuk kode, perintah, dan file, ini bukan batasan.

Jika Codex tidak sesuai, coba agen terminal lainnya: panduan memulai cepat API menunjukkan cara menghubungkan alat apa pun yang kompatibel dalam beberapa menit.