Kesalahan 401 Codex CLI: perbaiki rute autentikasi yang tepat

401 Codex CLI berarti autentikasi ditolak oleh server yang menangani permintaan tersebut. Pemeriksaan paling cepat dan berguna adalah kombinasi host tujuan, penyedia yang dipilih, dan sumber kredensial. Variabel lingkungan yang kosong adalah salah satu kemungkinan; itu bukan penjelasan untuk setiap 401. Ikuti cabang yang sesuai dengan penyiapan Anda.

Pertama, identifikasi koneksi yang gagal

Simpan status, teks kesalahan, stempel waktu, dan ID permintaan jika tersedia. Hapus header otorisasi, kunci, dan token sebelum membagikan detail. Jangan menempelkan auth.json ke tiket dukungan: isinya mungkin mengandung kredensial. Kesalahan dari satu integrasi tidak membuktikan bahwa koneksi model rusak.

1. Periksa CLI dan metode login

codex --version
codex login status

# POSIX shell: report presence only, without printing the secret
if [ -n "${KUNAVO_API_KEY:-}" ]; then
  printf 'KUNAVO_API_KEY is set\n'
else
  printf 'KUNAVO_API_KEY is missing or empty\n'
fi

Jalankan pemeriksaan di terminal yang sama dengan terminal yang menjalankan Codex. Ganti nama variabel dalam pemeriksaan keberadaan jika penyedia Anda menggunakan env_key yang berbeda. “Diatur” hanya mengonfirmasi bahwa suatu nilai ada; ini tidak dapat membuktikan bahwa nilainya masih berlaku atau diterima oleh tujuan.

Untuk login ChatGPT pribadi yang berhenti diperbarui, gunakan codex logout diikuti oleh codex login, lalu selesaikan alur browser untuk akun yang dimaksud. Ini mengubah status login yang tersimpan; langkah ini tidak diperlukan untuk setiap kesalahan penyedia khusus. Dalam otomatisasi terkelola, ikuti metode autentikasi administrator. Lihat panduan autentikasi resmi.

2. Cocokkan kunci API dengan penerbit dan tujuannya

Kunci OpenAI Platform digunakan pada rute OpenAI API. Kunci Kunavo digunakan pada rute Kunavo. Login browser ChatGPT yang berhasil tidak memvalidasi kunci gateway, dan saldo gateway bukan saldo OpenAI Platform. Periksa host sebenarnya dalam kesalahan sebelum mengganti apa pun.

Di dasbor penerbit, pastikan kunci tersebut masih ada dan aktif. Periksa proyek terkait serta pembatasan akses apa pun. Referensi kesalahan OpenAI API mencakup kredensial tidak valid, keanggotaan organisasi, dan kegagalan daftar izin IP sebagai kesalahan autentikasi. Gunakan pesan yang menyertainya untuk memilih perbaikan; membuat kunci berulang kali tidak memperbaiki kebijakan akun atau jaringan.

3. Periksa konfigurasi penyedia yang digunakan Codex

# Compare these non-secret fields with your intended provider.
model = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"
wire_api = "responses"

model_provider yang dipilih harus cocok dengan blok penyedia. Kolom env_key memberi nama variabel; kolom ini tidak berisi rahasianya. Verifikasi konfigurasi aktif dan setiap penggantian profil atau baris perintah, lalu mulai ulang Codex setelah memperbaikinya. Hindari menyalin blok penyedia yang tidak terkait ke konfigurasi yang sedang berfungsi.

Referensi konfigurasi OpenAI mendokumentasikan protokol Responses. URL dasar yang diakhiri dengan /v1 berbeda dari URL permintaan lengkap /v1/responses. Jalur yang salah biasanya memerlukan diagnosis endpoint meskipun autentikasi sudah berhasil. Periksa juga requires_openai_auth: jika diaktifkan, autentikasi OpenAI diprioritaskan daripada env_key, sebagaimana dijelaskan dalam panduan autentikasi.

4. Ubah satu hal dan coba lagi satu tugas kecil

1. Pertahankan detail kesalahan dan identifikasi rute yang dipilih.
2. Perbaiki login, kredensial, atau kolom penyedia yang ditunjukkan oleh bukti.
3. Mulai ulang proses CLI atau editor yang terdampak agar menerima pengaturan baru.
4. Jalankan permintaan kecil sebelum memulai ulang tugas coding yang panjang.
5. Jika kegagalan berlanjut, kirimkan kesalahan yang telah disunting dan ID permintaan kepada penyedia, bukan kredensialnya.

429 berikutnya, peringatan saldo, atau kesalahan model yang hilang adalah cabang diagnosis baru. Pertahankan perbaikan autentikasi dan tangani masalah berikutnya, bukan membatalkan semua pengaturan. Panduan batas Codex memisahkan kasus-kasus tersebut. Untuk penyiapan Kunavo, gunakan integrasi Codex lengkap dan kelola kunci di dasbor Anda.

Pertanyaan umum

Dokumentasi resmi dan bantuan CLI lokal diperiksa pada 17 September 2026. Tidak ada kredensial yang perlu dibagikan untuk mengikuti pemeriksaan ini.