Codex CLI menggunakan Responses API milik OpenAI, bukan /v1/chat/completions. Integrasi GetVibe memerlukan wire_api = "responses"; base URL chat-completions yang disalin ke contoh SDK generik bukan pengganti yang setara. Penyiapan yang dibuat secara otomatis dikelola di dokumentasi Codex CLI dan dapat diperbarui dari /api/integrations/codex.toml.
Instal dan tetapkan key
Instal CLI dan buat direktori konfigurasinya. Simpan API key di environment, bukan di dalam file TOML:
npm install -g @openai/codex
mkdir -p ~/.codex
export GETVIBE_API_KEY="your-dashboard-key"Tambahkan provider block ini ke ~/.codex/config.toml:
model = "gpt-5.6-luna"
model_provider = "getvibe"
model_reasoning_effort = "medium"
model_reasoning_summary = "auto"
model_context_window = 786432
[model_providers.getvibe]
name = "GetVibe"
base_url = "https://getvibeapi.com/v1"
env_key = "GETVIBE_API_KEY"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 5
stream_idle_timeout_ms = 600000Jangan masukkan $GETVIBE_API_KEY ke dalam nilai TOML. Codex membaca variabel yang namanya ditentukan oleh env_key; teks di dalam file konfigurasi tidak diperluas oleh shell. Untuk penyiapan yang dikelola tim, sediakan variabel environment melalui shell profile atau secret manager yang menjalankan Codex.
Pilih model yang mendukung Responses
Konfigurasi Codex yang dibuat secara otomatis disusun berdasarkan katalog yang dipublikasikan dan merekomendasikan model coding serta profile untuk tugas cepat dan mendalam. Sebelum memilih model lain, periksa apakah model tersebut tercantum untuk Responses API dan memiliki batas konteks yang ingin Anda tetapkan. Pada snapshot katalog yang diperiksa pada 3 Oktober 2026, GPT-6 Luna adalah $0.0055 input · $0.0274 output per 1 juta token, GPT-6 Sol adalah $0.1096 input · $0.548 output per 1 juta token, dan GPT-6.1 Sol adalah $0.1096 input · $0.548 output per 1 juta token per satu juta token input dan output. Setiap nilai dirender dari halaman model aktif.
Profile berguna ketika kelas tugas memiliki kebutuhan biaya dan reasoning yang berbeda. Gunakan profile cepat untuk ringkasan atau pesan commit, dan profile yang lebih mendalam untuk perubahan lintas file. Konfigurasi yang dibuat untuk project menunjukkan pola ini dan memperbarui ID yang direkomendasikan saat katalog publik berubah. Jangan mengedit context window secara manual hingga melebihi batas yang didukung halaman model: Codex kemudian dapat mengirim request yang terlalu besar dan gagal di upstream.
Verifikasi dengan tugas repository read-only
Jalankan Codex di checkout sementara. Minta Codex menjelaskan satu fungsi tanpa melakukan pengeditan. Pastikan Codex menggunakan provider GetVibe dan request selesai. Kemudian minta patch kecil dengan izin review yang eksplisit. Jika CLI menyatakan provider tidak ditemukan, periksa nama tabel yang tepat dan pastikan model_provider cocok dengan nama tersebut. Jika autentikasi gagal, verifikasi GETVIBE_API_KEY di shell yang sama dengan yang digunakan untuk menjalankan Codex.
Ketika respons menyatakan bahwa tools tidak dapat digunakan, pertama-tama verifikasi dukungan Responses pada model yang dipilih dan versi CLI. Model ID yang terlihat di katalog umum tidak berarti setiap protokol tersedia untuk model tersebut. Simpan model ID yang tepat di log agar kegagalan tools dapat dibedakan dari kegagalan endpoint atau autentikasi.
Kelola konteks dan biaya agent
Codex membaca file repository dan mengirimkan hasil tools kembali sebagai bagian dari percakapannya. Kecualikan output yang dibuat secara otomatis dan direktori dependency melalui pengaturan ignore, minta Codex memeriksa hanya path yang relevan, dan hindari mengulangi spesifikasi yang sangat besar di setiap prompt. Biaya tugas agent mencakup setiap turn, bukan hanya patch final. Bandingkan penggunaan di dashboard setelah tugas yang representatif dengan tarif input dan output pada halaman model.
Untuk perbandingan model yang adil, gunakan commit repository, prompt, kebijakan persetujuan, dan test yang sama. Gunakan bug fix dan tugas lintas file, lalu nilai keberhasilan test serta jumlah turn perbaikan. Tarif katalog GPT-6 Luna pada 3 Oktober 2026 ditampilkan sebagai $0.0055 input · $0.0274 output per 1 juta token; tagihan request aktual bergantung pada jumlah konteks dan output yang digunakan tugas tersebut.
Profile dan default yang aman
Mulailah dengan reasoning medium untuk tugas coding normal, lalu bandingkan low untuk kecepatan dan high untuk reasoning yang sulit jika model mendukung pengaturan tersebut. Reasoning yang lebih besar dapat meningkatkan penggunaan output. Hindari menetapkan context global yang sangat besar hanya karena kebiasaan; file yang dibuat secara otomatis memilih window spesifik model yang terukur. Biarkan perilaku persetujuan Codex aktif sampai Anda memahami command yang diajukannya.
Jika CLI berhasil dimulai tetapi tidak pernah mencapai GetVibe, periksa konfigurasi efektif, bukan hanya file yang Anda edit: Codex mungkin dijalankan dengan profile atau lokasi konfigurasi lain. Jalankan request yang tidak berbahaya, periksa penggunaan di dashboard, lalu gunakan Codex pada repository penting.
Gunakan profile untuk kelas tugas yang berulang
Profile Codex memungkinkan tim mempertahankan satu provider sambil mengubah model dan reasoning effort untuk suatu tugas. Profile cepat dapat merangkum diff atau menyusun pesan commit; profile mendalam dapat menyelidiki kegagalan multi-file. Cantumkan nama profile dalam command yang didokumentasikan tim agar dua developer tidak tanpa sadar membandingkan default yang berbeda. Profile harus menggunakan model ID yang saat ini dipublikasikan dan kompatibel dengan Responses.
Konfigurasi GetVibe yang dibuat secara otomatis menyediakan pola untuk profile cepat dan mendalam, tetapi dapat berubah seiring perubahan rekomendasi. Perbarui dari endpoint yang didokumentasikan, bukan dengan menyalin context limit model yang lama. Codex dapat memadatkan history sesuai context window yang dikonfigurasi, sehingga window yang lebih besar daripada yang diterima route dapat mengubah tugas panjang menjadi request error, bukan konteks yang berguna.
Jaga fokus konteks repository
Sebelum menjalankan agent, pastikan aturan ignore mengecualikan package cache, build output, generated API client, dan fixture berukuran besar. Beri tahu Codex package atau test yang harus diperiksa terlebih dahulu. Untuk bug, minta Codex mereproduksi kegagalan, menyebutkan file yang akan diubah, lalu membuat patch sekecil mungkin dan menjalankan test. Ini mengurangi output tools yang berulang dan membuat hasilnya lebih mudah direview.
Untuk perbandingan biaya yang adil, jalankan prompt yang sama pada commit yang sama. Sertakan tugas yang tidak memerlukan pengeditan agar Anda dapat melihat apakah agent mematuhi batasan, serta tugas yang memerlukan test run agar Anda dapat menghitung loop perbaikan. Catat penggunaan token dan apakah patch berhasil, bukan hanya panjang respons final.
Reasoning dan batas output
Gunakan reasoning effort terendah yang memenuhi target kualitas Anda. Effort tinggi berguna untuk beberapa tugas perencanaan, tetapi dapat meningkatkan latensi dan penggunaan output. Tetapkan output budget yang cukup besar untuk patch dan penjelasan yang diminta tanpa membuatnya tidak terbatas. Ketika respons berhenti terlalu cepat, periksa finish reason sebelum mengulangi seluruh request; continuation yang terarah mungkin menggunakan lebih sedikit konteks.
Jaga agar persetujuan command otomatis tetap konservatif. Codex dapat mengajukan shell command yang destruktif atau mengubah file di luar cakupan yang dimaksud. Periksa diff dan output test sebelum menyetujuinya, bahkan ketika ringkasan reasoning terdengar meyakinkan.
Error umum
- Endpoint salah: base URL harus diakhiri dengan
/v1, danwire_apiharus beruparesponses. - 401: export
GETVIBE_API_KEYdi process environment; TOML tidak memperluas variabel shell. - Context error: sesuaikan
model_context_windowdengan halaman model yang dipublikasikan. - Perilaku tools berbeda: uji model yang kompatibel dengan Responses dan gunakan versi CLI terbaru.
Untuk field request JSON, lihat Messages and Responses; untuk saldo dan metering, lihat dokumentasi penggunaan.