Codex CLI: kunci Anda sendiri alih-alih langganan

Codex bukan sekadar pemberi saran di editor, melainkan pelaksana mandiri. Anda merumuskan tugas dengan kata-kata, ia sendiri yang memutuskan file mana yang dibaca, perintah mana yang dijalankan, dan apa yang diubah. Ada sekitar selusin alat yang tersedia: menjalankan perintah, membaca file, menyusun rencana kerja, meminta klarifikasi dari pengguna, melahirkan agen anak untuk subtugas.

Dua mode kerja. Interaktif — codex tanpa argumen, dialog di terminal dengan setiap langkah ditampilkan. Non-interaktif — codex exec "task", sekali jalan sampai selesai: praktis untuk skrip dan CI.

Keamanan sudah terpasang: secara default agen bekerja di sandbox dan meminta konfirmasi sebelum melakukan perubahan. Tingkat kendali diatur di konfigurasi — dari "tanya semuanya" hingga eksekusi sepenuhnya otonom dengan izin menulis ke direktori kerja.

Keistimewaan lain — keadaan dialog. Codex tidak meminta server mengingat apa pun: ia menyimpan seluruh riwayat di sisinya dan mengirimkannya utuh di setiap giliran. Artinya bagi Anda, percakapan tidak mengendap di sisi penyedia model, dan pergantian endpoint tidak merusak sesi yang sedang berjalan.

Bedanya dengan Claude Code dan agen terminal lain justru pada protokolnya. Codex berkomunikasi dengan model melalui Responses API, di mana percakapan dijelaskan bukan sebagai daftar pesan datar, melainkan sebagai aliran elemen: teks, pemanggilan alat, hasil pemanggilan, blok penalaran. Ini memberi model dialog yang lebih ketat bagi alat, dan bagi Anda — keharusan memiliki endpoint yang memahami protokol ini.

Jalur cepat — penginstal. Perintah npx @joingonka/setup --tool codex akan menambahkan sendiri blok penyedia ke ~/.codex/config.toml dengan wire_api = "responses", model beserta jendela konteks aslinya, sambil mempertahankan komentar dan pengaturan Anda yang lain, lalu memverifikasi kunci dan model lewat permintaan langsung. Jika di konfigurasi sudah dipilih penyedia lain, penginstal tidak akan menyentuhnya dan akan memberi tahu perintah untuk sekali jalan. Kunci diletakkannya langsung di file (izin 600), di kolom experimental_bearer_token — satu-satunya tempat Codex bisa menyimpan kunci secara literal; Codex sendiri menganggapnya eksperimental. Varian manual di bawah ini memakai variabel lingkungan.

Codex menyimpan pengaturan di ~/.codex/config.toml. Penyedia kustom dijelaskan lewat blok [model_providers.*], dan kolom kuncinya adalah wire_api: tanpanya, Codex akan mencoba berbicara dengan Chat Completions dan siklus agennya tidak akan terbentuk.

# ~/.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 file: env_key menyebut nama variabel lingkungan tempat Codex akan mengambilnya. Nama variabelnya milik Anda sendiri, bukan OPENAI_API_KEY — dengan begitu, pengaturan ini tidak menyerobot alat lain Anda yang bekerja dengan OpenAI.

export JOINGONKA_API_KEY=jg-your-key

Kolom model menetapkan model default, dan model_provider menentukan blok mana yang dipakai. Keduanya bisa ditimpa saat menjalankan, jadi satu konfigurasi bisa melayani beberapa penyedia sekaligus: produksi, eksperimental, dan cadangan.

Kunci diterbitkan di dasbor akun setelah mendaftar; di sana juga terlihat saldo dan pemakaian. Jika Anda enggan menyentuh konfigurasi global, blok yang sama bisa diberikan sekali jalan lewat -c: codex -c model_provider=joingonka …. Dan untuk menyimpan beberapa konfigurasi yang independen, tunjuk direktori pengaturan lewat variabel CODEX_HOME.

Cara tercepat untuk memastikan koneksinya berfungsi adalah sekali uji jalan:

codex exec "Answer in one line: what is 17*3?"

Di bagian atas balasannya, Codex mencetak dengan siapa ia bekerja: model, provider: joingonka, mode sandbox, dan ID sesi. Jika di situ tertera penyedia Anda dan di bawahnya ada jawaban yang masuk, berarti koneksi hidup.

Selanjutnya, uji hal utama yang menjadi alasan orang memasang Codex: bekerja dengan file. Letakkan file kecil berisi bug yang jelas di direktori, lalu minta Codex menemukannya:

codex exec "Read calc.py and tell me in one sentence whether it has a bug."

Agen harus memanggil sendiri alat pembaca, membuka file, dan menjawab secara konkret — dengan menyebut nomor barisnya. Jika itu terjadi, siklus agen penuh (permintaan → pemanggilan alat → hasil → jawaban) melalui gateway berjalan dengan benar.

Jika ada yang tidak beres, diagnosisnya biasanya bisa langsung dibaca dari pesannya:

Permintaan pertama dalam sesi bisa memakan beberapa detik: Codex mengirim prompt sistem yang besar dan deskripsi semua alatnya, sementara node jaringan perlu menerima tugasnya. Balasan berikutnya datang lebih cepat.

Semua model jaringan tersedia dengan satu harga, jadi pilihan ini adalah tentang perilaku, bukan anggaran. Di bawah ini adalah hasil pengujian real-time dari tugas yang sama (membaca file dan mencari kesalahan di dalamnya) melalui Codex pada DeepSeek V4 Flash dan MiniMax M2.7; GLM-5.3 Flash masuk ke jaringan setelah pengujian — properti modelnya disertakan untuknya.

Rekomendasi default adalah DeepSeek V4 Flash: pekerjaan agen dengan cepat mencapai batas volume konteks, dan 380K token memberikan kemampuan untuk menyimpan banyak file sekaligus. Jika tugas memerlukan pemikiran tentang logika yang rumit — gunakan GLM-5.3 Flash, tetapi berikan cadangan untuk max_tokens: sebagian anggaran jawaban digunakan untuk penalaran. Model dapat diubah dalam satu baris model di konfigurasi atau dengan flag -c model=… tanpa mengedit file.

Daftar model jaringan saat ini 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.0069 per juta di input dan $0.021 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.