Pemecahan masalah kendala Codex
Fokus utama pemecahan masalah Codex adalah antarmuka yang kompatibel dengan OpenAI. Umumnya, lakukan pemecahan masalah dengan urutan ini: Base URL, Key, nama model, apakah Provider saat ini berfungsi.
Apa yang harus dipastikan terlebih dahulu?
| Butir pemeriksaan | Cara melihat | Mengapa |
|---|---|---|
| Provider mendukung antarmuka yang kompatibel dengan OpenAI | Backend dapat menampilkan alamat API, Base URL, kompatibilitas OpenAI, dan petunjuk lainnya | Codex harus dapat melakukan request ke antarmuka yang kompatibel |
| Base URL | Salin tautan API yang disediakan oleh provider | Apakah diperlukan /v1 Ikuti contoh backend, jangan menebak sendiri |
| Status Key | Key tidak dinonaktifkan, belum kedaluwarsa, dan saldo akun normal | 401 Sebagian besar dimulai dengan memeriksa Key |
| Nama Model | Salin sesuai daftar model di backend | Nama model, huruf besar/kecil, tanda hubung, atau nomor versi akan menyebabkan kegagalan jika salah ditulis |
Masalah umum
| Gejala | Prioritas pemeriksaan | Solusi |
|---|---|---|
| 401 / Unauthorized | API Key | Buat ulang atau salin Key, dan pastikan Key tidak dinonaktifkan, belum kedaluwarsa, serta saldo akun normal. |
| 404 / model not found | Nama Model | Jangan menulis nama model dari ingatan; salin sesuai dengan daftar model di backend provider. Jika pengambilan daftar model didukung, ambil daftar terlebih dahulu; jika gagal, tambahkan secara manual. |
| Masalah terkait Base URL | Apakah tautan API lengkap | Base URL adalah tautan API yang disediakan oleh provider. Apakah memerlukan /v1 Ikuti contoh backend, jangan menebak. |
| Request tidak terkirim padahal Key normal | Apakah protokol cocok | Pastikan provider saat ini menawarkan antarmuka yang kompatibel dengan OpenAI, bukan Claude, Gemini, atau antarmuka yang hanya mendukung web chat. |
| Tidak berpengaruh setelah menggunakan CC-Switch | Pemilihan alat target | Pastikan Provider diterapkan ke Codex, bukan Claude Code; mulai ulang terminal atau klien sebelum mencoba lagi. |
Pengujian minimal
Uji dengan pertanyaan paling singkat terlebih dahulu untuk memastikan request terkirim sebelum menangani proyek yang sebenarnya.
Pengujian Minimal Codex
codex "Please reply only: Codex configuration test successful"Templat masukan
Saat memberikan masukan ke provider, tulis seperti ini
Tool: Codex System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened