Panduan: Codex CLI

Codex CLI mendukung provider kustom lewat model_providers di ~/.codex/config.toml. Sintaks di bawah diverifikasi dari sumber resmi: repo openai/codex (Oktober 2026).

Konfigurasi

model = "claude-opus-5-5"
model_provider = "ngoding"

[model_providers.ngoding]
name = "Ngoding"
base_url = "<API>/v1"
env_key = "NGODING_API_KEY"
wire_api = "responses"

export NGODING_API_KEY="sk-ngd-GANTI-DENGAN-KUNCIMU"

• base_url — endpoint dasar OpenAI-compatible. Ganti <API> dengan https://api.ngoding.in (tambah /v1).
• env_key — nama environment variable berisi kunci (lebih aman daripada menulis token di TOML).
• model_provider (top-level) — memilih provider ini sebagai default.

Peringatan versi: wire_api

Hanya "responses" yang valid di Codex CLI terkini. Nilai "chat" sudah dihapus upstream — Codex menolak config dengan pesan error bila wire_api = "chat" dipakai. Ini cocok untuk kami: endpoint /v1/responses tersedia untuk semua model.

Selain itu Codex di sini berjalan stateless: previous_response_id, background, conversation, dan prompt tersimpan selalu ditolak (400 unsupported_parameter) — lihat Responses. Kirim konteks lewat input/instructions setiap request, yang memang perilaku default Codex.

Web search Codex memakai tool web_search format Responses, yang di Ngoding dijalankan oleh server tool milik kami dan ditagih per pencarian di atas token. Request dengan web_search hanya menerima tool klien berjenis function; bila Codex mengirim apply_patch berbentuk custom, local_shell, atau shell non-fungsi (tergantung model), request ditolak 400 unsupported_tool. Jadi biarkan web_search mati di config.toml bila request Codex-mu ditolak karena itu, dan pastikan model yang kamu pakai punya capabilities.web_search.supported: true di GET /v1/models. Tanpa web_search, tool eksekusi-klien (local_shell, apply_patch, dan shell lokal) tetap diizinkan; shell dengan container hosted (container_auto) ditolak sampai sandbox eksekusi kode milik kami dibuka.