Langsung ke konten utama

OpenAI Codex CLI

OpenAI Codex CLI adalah agen coding baris perintah dari OpenAI. Panduan ini menjelaskan cara mengonfigurasikannya agar berfungsi dengan KiosAPI.

Persyaratan Sistem

Instalasi

Instal Codex CLI secara global melalui npm:
Atau melalui Homebrew (macOS/Linux):
Verifikasi instalasi:

Dapatkan Kunci API Anda

  1. Masuk ke Dashboard KiosAPI
  2. Buka Token Management
  3. Buat atau salin kunci API yang ada (diawali dengan sk-)
  4. Pilih grup Codex-Pro (0.04×) atau Codex-Plus (0.02×) — cek grup mana yang mencakup model yang kamu mau di halaman harga
  5. Simpan dan salin kuncinya (diawali sk-)
Token di grup yang salah tidak bisa memanggil model Codex. Lihat Memilih Grup Token.

Konfigurasi

1. Buat file konfigurasi

Buat ~/.codex/config.toml:
Pengaturan wire_api = "responses" memberi tahu Codex agar menggunakan format Responses API OpenAI, yang didukung KiosAPI.

2. Atur variabel lingkungan

Atur kunci KiosAPI Anda sebagai variabel lingkungan KIOSAPI_KEY. Windows (PowerShell):
macOS / Linux: Tambahkan ke ~/.bashrc atau ~/.zshrc:
Kemudian muat ulang:

Penggunaan

Mode interaktif

Pertanyaan langsung

Menggunakan profil KiosAPI

Plugin VSCode

Codex juga tersedia sebagai ekstensi VSCode. Setelah memasangnya, konfigurasikan KiosAPI dengan variabel lingkungan yang sama di pengaturan VSCode atau terminal Anda.
Ekstensi VSCode membaca variabel lingkungan dari shell Anda. Pastikan KIOSAPI_KEY diekspor di shell yang menjalankan VSCode, atau atur di terminal terintegrasi.

Konfigurasi Lanjutan

Mode CI Noninteraktif

Untuk pipeline CI/CD, jalankan Codex dalam mode noninteraktif:

Server MCP

Codex mendukung server Model Context Protocol (MCP) untuk akses alat tambahan. Tambahkan server MCP di ~/.codex/config.toml:

Pemecahan Masalah

Kesalahan Autentikasi (401)

  • Pastikan KIOSAPI_KEY sudah benar: echo $KIOSAPI_KEY
  • Pastikan kunci diawali dengan sk-
  • Periksa bahwa env_key di konfigurasi sesuai dengan nama variabel lingkungan

Model Tidak Ditemukan

Kesalahan Koneksi

  • Pastikan base_url adalah https://kiosapi.com/v1 (dengan /v1)
  • Periksa koneksi jaringan dan pengaturan firewall Anda

Verifikasi Pengaturan

Butuh Bantuan?