Alat coding
Codex CLI
Konfigurasi OpenAI Codex CLI untuk menggunakan TokenLab API
Serahkan pengaturan kepada agen saya
Salin tugas ini ke agen yang sudah berfungsi di komputer Anda:
Baca panduan ini dan bantu saya menghubungkan Codex CLI ke TokenLab:
https://tokenlab.sh/docs/id/integrations/codex-cli
Periksa terlebih dahulu versi yang terpasang dan konfigurasi yang aktif.
Pertahankan akun, penyedia, izin, dan pengaturan lain yang sudah ada.
Cadangkan file lokal dan tampilkan perubahan yang diusulkan.
Biarkan saya memasukkan kunci API yang diperlukan secara lokal; jangan pernah meminta, menampilkan, atau menempelkannya di chat.
Periksa terlebih dahulu apakah konfigurasi dapat dimuat.
Jelaskan secara terpisah biaya setiap pengujian yang mengirim permintaan berbayar sebelum menjalankannya.Gambaran Umum
Codex CLI terhubung ke TokenLab melalui /v1/responses. Model yang dipilih harus mencantumkan openai_responses dalam tokenlab.accepted_request_formats; fitur dapat berbeda menurut model.
Kompaksi jarak jauh Codex CLI didukung di POST /v1/responses/compact. Codex mengirim model sesi saat ini di body.model untuk /compact dan auto-compact, jadi model yang ingin dipakai untuk kompaksi harus tersedia di jalur Responses. Jangan mengonfigurasi /v1/compact.
Persyaratan Sistem
Ikuti panduan CLI resmi untuk macOS, Linux, atau Windows. Windows native dan WSL adalah lingkungan terpisah; lihat panduan Windows. npm adalah pilihan instalasi, bukan syarat biner native.
Instalasi
npm install -g @openai/codex@0.149.0Verifikasi instalasi:
codex --versionKonfigurasi
Langkah 1: Atur API Key
Ikuti langkah terminal panduan cepat untuk macOS, Linux, WSL, atau Windows PowerShell guna mengatur TOKENLAB_API_KEY tanpa menulis kunci ke riwayat perintah. Jalankan Codex dari terminal tersebut. Untuk penggunaan berkelanjutan, gunakan pengelola rahasia lokal, bukan kunci teks biasa di profil shell.
Langkah 2: Konfigurasi tokenlab.config.toml
Dengan Codex 0.149.0, gunakan tokenlab.config.toml terpisah dalam CODEX_HOME aktif (biasanya ~/.codex). Buat hanya jika namanya belum dipakai, atau cadangkan profil TokenLab yang ada sebelum mengeditnya. codex --profile tokenlab memuat profil secara eksplisit tanpa mengubah config.toml, auth.json, akun, atau izin. Jangan gunakan tabel lama [profiles.tokenlab]. Jalankan tanpa profil ini untuk kembali ke pengaturan biasa. Lihat konfigurasi profil resmi.
model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
[model_providers.tokenlab]
env_key = "TOKENLAB_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000Mode WebSocket ini adalah bridge Responses-over-WebSocket untuk klien Codex. Mode ini hanya menerima event resmi response.create; stream bersifat implisit, sedangkan background dan response.cancel tidak tersedia pada transport ini. Ini bukan OpenAI Realtime API dan tidak menerima session.update, conversation.item.*, input_audio_buffer.*, audio biner, atau envelope Realtime bertingkat response.create.response.
Buat file konfigurasi yang dipilih jika belum ada. Setelah mengeditnya, mulai sesi baru dengan perintah yang sesuai di bawah.
Codex saat ini memakai wire_api = "responses", bukan chat/completions. Hilangkan requires_openai_auth atau isi false agar penyedia memakai env_key.
Permintaan Responses tidak diubah menjadi Chat Completions. Kolom opsional dan mendatang bergantung pada model yang dipilih.
Penggunaan Dasar
Mulai mode interaktif:
codex --profile tokenlabPerintah langsung:
codex --profile tokenlab "Fix the bug in main.py line 42"Menentukan model:
codex --profile tokenlab -m gpt-5.6-sol "Build a REST API server"Pilih model
Pilih model yang saat ini mencantumkan openai_responses dalam tokenlab.accepted_request_formats. Bandingkan model dengan tugas Anda dan periksa harga di halaman model.
Perintah Interaktif
| Perintah | Deskripsi |
|---|---|
/help | Tampilkan bantuan |
/exit or Ctrl+C | Keluar |
/clear | Bersihkan percakapan |
/status | Tampilkan model aktif, izin, dan penggunaan token |
/model <name> | Ganti model |
Verifikasi Konfigurasi
Periksa hanya apakah variabel lingkungan sudah diatur tanpa mencetak nilainya. Pemeriksaan ini tidak memvalidasi key:
if [ -n "${TOKENLAB_API_KEY:-}" ]; then
printf '%s\n' 'TOKENLAB_API_KEY is set'
else
printf '%s\n' 'TOKENLAB_API_KEY is not set'
fiJalankan Codex lalu /status untuk memeriksa model aktif dan izin. Jika menggunakan profil, jalankan profil yang sama. Lihat perintah status resmi.
Saat siap mengirim request nyata, jalankan perintah berikut. Perintah ini menggunakan saldo TokenLab. Periksa balasan dan catatan yang sesuai di Request. Variabel yang sudah diatur atau aplikasi yang berhasil dimulai belum membuktikan request berhasil.
codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."Kasus Penggunaan Umum
Tinjauan kode:
git diff | codex --profile tokenlab "Review these code changes"Hasilkan pesan commit:
git diff --staged | codex --profile tokenlab "Generate a commit message for these changes"Perbaiki kesalahan:
codex --profile tokenlab "Fix the TypeScript errors in src/components/"Jelaskan kode:
cat main.py | codex --profile tokenlab "Explain what this code does"