Codex CLI 401 hatası: doğru kimlik doğrulama yolunu düzeltme

Codex CLI 401, isteği işleyen sunucunun kimlik doğrulamayı reddettiği anlamına gelir. En hızlı yararlı kontrol; hedef ana bilgisayar, seçili sağlayıcı ve kimlik bilgisinin kaynağını birlikte incelemektir. Boş bir ortam değişkeni olasılıklardan biridir; her 401'in açıklaması değildir. Kurulumunuza uyan dalı izleyin.

Önce hangi bağlantının başarısız olduğunu belirleyin

Mevcut olduğunda durumu, hata metnini, zaman damgasını ve istek kimliğini kaydedin. Ayrıntıları paylaşmadan önce yetkilendirme başlıklarını, anahtarları ve token'ları kaldırın. Kimlik bilgileri içerebileceğinden auth.json ifadesini destek talebine yapıştırmayın. Bir entegrasyondaki hata, model bağlantısının bozuk olduğunu göstermez.

1. CLI'yi ve oturum açma yöntemini kontrol edin

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

Kontrolleri Codex'i başlatan terminalde çalıştırın. Sağlayıcınız farklı bir env_key kullanıyorsa varlık kontrolündeki değişken adını değiştirin. “Ayarlı” ifadesi yalnızca bir değerin varlığını doğrular; değerin güncel olduğunu veya hedef tarafından kabul edildiğini kanıtlayamaz.

Yenilemeyi durdurmuş kişisel bir ChatGPT oturumu için codex logout komutunu, ardından codex login komutunu kullanın ve hedeflenen hesap için tarayıcı akışını tamamlayın. Bu işlem kayıtlı oturum açma durumunu değiştirir; her özel sağlayıcı hatası için zorunlu değildir. Yönetilen otomasyonda yöneticinin kimlik doğrulama yöntemini izleyin. Resmî kimlik doğrulama kılavuzuna bakın.

2. Bir API anahtarını sağlayıcısı ve hedefiyle eşleştirin

OpenAI Platform anahtarı OpenAI API yolunda kullanılmalıdır. Kunavo anahtarı Kunavo yoluna aittir. Başarılı bir ChatGPT tarayıcı oturumu ağ geçidi anahtarını doğrulamaz; ağ geçidi bakiyesi de OpenAI Platform bakiyesi değildir. Herhangi bir şeyi değiştirmeden önce hatadaki gerçek ana bilgisayarı kontrol edin.

Sağlayıcının kontrol panelinde anahtarın hâlâ var olduğunu ve etkin olduğunu doğrulayın. İlişkili projeyi ve erişim kısıtlamalarını kontrol edin. OpenAI API hata referansı, kimlik doğrulama hataları altında geçersiz kimlik bilgilerini, kuruluş üyeliğini ve IP izin listesi başarısızlıklarını kapsar. Düzeltmeyi seçmek için eşlik eden mesajı kullanın; tekrar tekrar anahtar oluşturmak hesap veya ağ politikasını onarmaz.

3. Codex'in kullandığı sağlayıcı yapılandırmasını kontrol edin

# 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"

Seçili model_provider, sağlayıcı bloğuyla eşleşmelidir. env_key alanı değişkeni adlandırır; gizli değeri içermez. Etkin yapılandırmayı ve profil ya da komut satırı geçersiz kılmalarını doğrulayın, ardından düzelttikten sonra Codex'i yeniden başlatın. Çalışan yapılandırmanızın üzerine ilgisiz bir sağlayıcı bloğu kopyalamaktan kaçının.

OpenAI'ın yapılandırma referansı Responses protokolünü belgeler. /v1 ile biten bir temel URL, tam bir /v1/responses istek URL'sinden farklıdır. Yanlış yol, kimlik doğrulama başarılı olduktan sonra bile genellikle uç nokta tanılaması gerektirir. Ayrıca requires_openai_auth seçeneğini de kontrol edin: etkin olduğunda OpenAI kimlik doğrulaması, kimlik doğrulama kılavuzunda açıklandığı üzere env_key üzerinde öncelik kazanır.

4. Tek bir şeyi değiştirin ve tek bir küçük görevi yeniden deneyin

1. Hata ayrıntılarını koruyun ve seçili yolu belirleyin.
2. Kanıtın işaret ettiği oturum açma, kimlik bilgisi veya sağlayıcı alanını düzeltin.
3. Yeni ayarı alması için etkilenen CLI veya düzenleyici sürecini yeniden başlatın.
4. Uzun bir kodlama görevini yeniden başlatmadan önce küçük bir istek çalıştırın.
5. Hata devam ederse sağlayıcıya kimlik bilgisini değil, sansürlenmiş hatayı ve istek kimliğini gönderin.

Daha sonra alınan 429, bakiye uyarısı veya eksik model hatası yeni bir tanılama dalıdır. Kimlik doğrulama düzeltmesini koruyun ve her ayarı geri almak yerine sonraki sorunu ele alın. Codex sınırları kılavuzu bu durumları birbirinden ayırır. Kunavo kurulumu için eksiksiz Codex entegrasyonunu kullanın ve anahtarları kontrol panelinizden yönetin.

Sık sorulan sorular

Resmî belgeler ve yerel CLI yardımı 17 Eylül 2026'da kontrol edilmiştir. Bu kontrolleri izlemek için hiçbir kimlik bilgisinin paylaşılması gerekmez.