Codex'te GPT-5.6 Sorunlarını Tanılayın

Codex üzerinden yapılan bir GPT-5.6 çağrısı başarısız olduğunda, tek bir hata mesajı neyi düzeltmeniz gerektiğini göstermeye yetmez. API anahtarı modele erişemiyor olabilir, /v1 yolu yanlış olabilir ya da doğrudan Responses çağrısı çalışırken sağlayıcı Codex'in eklediği metaverileri reddediyor olabilir. Aynı komutu yeniden çalıştırmak genellikle yalnızca sorunu yeniden üretir; sorunun hangi katmanda olduğunu göstermez.

Bu ücretsiz kit olasılıkları katman katman test eder: tam model ID'lerini, temel Responses çıktısını, SSE'deki sabit metin belirtecini ve sonlandırıcı response.completed olayını, belirtilen fonksiyon adını ve birebir eşleşen JSON argümanlarını doğrular. Son olarak geçici yapılandırmayla boş bir dizinde Codex'i çalıştırır ve temizlenmiş tek bir JSON raporu oluşturur. Doğrudan kontroller yalnızca sabit belirteçler gönderir; Codex kontrolü mevcut yapılandırmanızı değiştirmez. Kit model kalitesini ölçmez.

Kit neyi kanıtlar?

Kontroller bilerek katmanlara ayrılmıştır:

1. GET /v1/models, anahtarın her bir model ID'sini tam olarak görebildiğini doğrular.
2. Akış kullanmayan minimal Responses çağrısı temel üretimi doğrular ve dönen model ID'sini kontrol eder.
3. SSE kontrolü, metin belirtecinin tam olarak eşleşmesini ve akışın sonunda bir response.completed olayı gelmesini zorunlu tutar.
4. Katı fonksiyon kontrolü belirtilen fonksiyonu ve tam JSON argümanlarını zorunlu tutar.
5. Yalıtılmış bir codex exec çalıştırması, kurulu Codex CLI'yi aynı sağlayıcı üzerinden test eder.

Bir katmanın başarılı olması, sonrakinin de başarılı olacağı anlamına gelmez. Asıl değer bu ayrımdadır: doğrudan API kontrolleri geçiyor ve yalnızca codex_cli_smoke başarısız oluyorsa API anahtarını veya model ID'sini değiştirmek gerçek sorunu büyük olasılıkla çözmez.

Mevcut kurulumunuza dokunmadan çalıştırın

check.mjs dosyasını ve kullandığınız shell'e uygun başlatıcıyı aynı dizine koyun. Bash veya Zsh'de, anahtarın kendisini shell geçmişine yazmadan sessizce okuyun:

chmod +x run.sh
printf 'OmniaKey API key: ' >&2
IFS= read -r -s OMNIAKEY_API_KEY
printf '\n' >&2
export OMNIAKEY_API_KEY
./run.sh
unset OMNIAKEY_API_KEY

Windows PowerShell'de:

$secureKey = Read-Host 'OmniaKey API key' -AsSecureString
$env:OMNIAKEY_API_KEY = [System.Net.NetworkCredential]::new('', $secureKey).Password
.\run.ps1
Remove-Item Env:OMNIAKEY_API_KEY
$secureKey = $null

Varsayılan çalıştırma önce Sol, Terra ve Luna'da temel Responses çıktısını; ardından Sol'da akış, fonksiyon çağrısı üretimi ve uçtan uca Codex akışını test eder. Bu, Codex kuruluysa beş sabit doğrudan üretim ve yalıtılmış bir Codex turu demektir. Kit ücretsiz olsa da API kullanımı ücretlendirilebilir.

Daha derin kontrolleri üç modelde de tekrarlamak için --full kullanın. Bu seçenek dokuz doğrudan üretim ve üç Codex turu yapar. Doğrudan API isteklerinin yeniden deneme sayısı ve Codex sağlayıcısındaki iki yeniden deneme sınırı sıfırdır; kit yapay olarak 429 üretmeye çalışmaz. Model sabit araç kullanmama talimatını yok sayıp bir araç döngüsü başlatırsa tek bir Codex turu bir model isteği daha yapabilir ve rapor bu kontrolü başarısız olarak işaretler:

./run.sh --full

Codex'i çağırmadan tek bir modeli test etmek için:

./run.sh --model gpt-5.6-terra --skip-codex

Anahtar yalnızca ortam değişkeni üzerinden kabul edilir ve komut satırı argümanı olarak hiç kullanılmaz. Yukarıdaki sessiz giriş komutları anahtarın gerçek değerini shell geçmişinin dışında tutar; ancak diğer tüm süreç ortam değişkenleri gibi bu değer de tanımlı olduğu sürece yeterli izne sahip yerel süreçlerce incelenebilir. Script, raporu yazmadan önce sağlayıcının denetlediği tüm metin alanlarından anahtarın tam değerini ve yaygın Bearer ile sk-... biçimlerini çıkarır.

Rapor neleri kaydeder?

Her rapor kit sürümünü, UTC zaman damgasını, endpoint URL'sinin origin değerini ve temel yolunu, işletim sistemini, mimariyi, Node ve Codex sürümlerini, seçilen modelleri, iki timeout değerini ve açıkça sıfıra ayarlanmış yeniden deneme sınırlarını içerir. Katmana ve sonuca göre geçerli kontrol alanları şunları içerebilir:

• istenen ve raporlanan model ID'leri;
• pass, fail veya skip durumu;
• HTTP durumu ile istek ID'lerini ve rate limit bilgilerini taşıyan, izin listesindeki yanıt başlıkları;
• endpoint döndürüyorsa yanıt ID'si ve token kullanımı;
• geçen süre ile karşılanmayan sözleşme koşulu veya atlama nedeni;
• API anahtarı veya ham yanıt gövdesi içermeyen normalleştirilmiş hata kategorisi.

POSIX sistemlerde çıktı dosyası yalnızca sahibi tarafından okunabilecek izinlerle oluşturulur. Request ID'leri kimlik bilgisi değildir; yine de bir sağlayıcının isteği izlemesine yardımcı olabilecekleri için raporu paylaşmadan önce gözden geçirin.

Çıkış kodu 0, çalıştırılan tüm kontrollerin başarılı olduğu anlamına gelir. 1, çalıştırılan kontrollerden en az birinin başarısız olduğunu gösterir. 2, argümanların, anahtar ortam değişkeninin, URL'nin veya başka bir ön koşulun geçersiz olduğu anlamına gelir. Codex kurulu değilse bu durum API hatası gibi gösterilmez; skip olarak raporlanır.

Doğrulanmış GPT-5.6 bilgileri

OpenAI şu anda aşağıdaki tam API ID'lerini ve rolleri belgeliyor:

gpt-5.6 takma adı şu anda gpt-5.6-sol modeline yönlendiriliyor. Teşhis için açık ID'leri kullanın: bir takma ad, uyumluluk testinin ihtiyaç duymadığı ek bir yönlendirme belirsizliği yaratır.

Üç modelin güncel sayfaları da 1,050,000 token API bağlam penceresi, 922,000 maksimum input, 128,000 maksimum output ve 2026-02-16 bilgi kesim tarihi listeliyor. Ayrıca Responses, Chat Completions ve Batch desteğinin yanı sıra akış, yapılandırılmış çıktılar ve fonksiyon çağrısı özelliklerini belirtiyor. Birincil kaynaklar için Sol, Terra ve Luna sayfalarına bakın.

Bunlar API model sınırlarıdır; her Codex istemci yapılandırmasının tüm pencereyi sunacağı anlamına gelmez. Codex'in kendi model kataloğu, model_context_window ayarı ve otomatik compaction davranışı vardır. Bu kit bir milyon token'lik prompt göndermez ve API sayfasındaki üst sınırdan etkili Codex penceresi çıkarmaz.

Minimal Codex sağlayıcı yapılandırması

Güncel Codex yapılandırması, özel sağlayıcılar için kullanıcı düzeyindeki ~/.codex/config.toml dosyasını kullanır. Güncel yapılandırma referansı, wire_api için desteklenen değer olarak responses değerini listeler. Minimal OmniaKey örneği şöyledir:

model = "gpt-5.6-sol"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
base_url = "https://api.omniakey.com/v1"
env_key = "OMNIAKEY_API_KEY"
wire_api = "responses"

env_key ile requires_openai_auth alternatif kimlik doğrulama yöntemleridir. Güncel Codex kimlik doğrulama belgelerine göre requires_openai_auth = true ayarı Codex'in env_key değerini yok saymasına neden olur; bu sağlayıcı bloğuna eklemeyin.

Gerçek yapılandırmayı düzenlemeden önce yedekleyin:

cp ~/.codex/config.toml ~/.codex/config.toml.before-gpt56

PowerShell karşılığı:

Copy-Item "$HOME\.codex\config.toml" "$HOME\.codex\config.toml.before-gpt56"

Uyumluluk kontrol aracı bu dosyayı düzenlemenizi veya içindeki sağlayıcı ayarlarını kullanmanızı gerektirmez. Codex smoke test'i kullanıcı yapılandırmasını yok sayar, geçici bir CODEX_HOME oluşturur, sağlayıcı ayarlarını yalnızca ilgili işleme aktarır, boş bir çalışma dizini ile salt okunur sandbox kullanır ve ardından dizini siler. İşleme yalnızca anahtar ile izin listesindeki çalışma zamanı, yerel ayar, geçici dizin, proxy ve TLS ortam değişkenleri aktarılır; rapor bunların değerlerini değil, yalnızca adlarını kaydeder.

Salt okunur sandbox yazmayı engeller, ancak olası her okumayı engellemez. Araç kullanmama talimatı içeren sabit prompt doğrulanır; yine de bu katı bir güvenlik sınırı değildir. Makinede Codex işleminin okuyamaması gereken dosyalar varsa --skip-codex kullanın veya kiti yalıtılmış bir container ya da sanal makinede çalıştırın.

Kalıcı değişiklik yapmadan önce Codex yapılandırma referansını ve OmniaKey kodlama ajanları rehberini okuyun.

Hataları tahminle değil, katmanına göre okuyun

401 ile 403'ü aynı teşhiste birleştirmeyin. 401 genellikle kimlik doğrulamaya işaret eder; 403 ise geçerli bir kimliğin izni olmadığı anlamına gelebilir. Benzer şekilde 404, yanlış /v1 temel yolundan veya geçerli bir yolda kullanılamayan modelden kaynaklanabilir.

OpenAI'ın hata rehberi, hatalı isteklerde istek biçimini kontrol etmeyi, rate limit durumunda çağrıları yavaşlatmayı ve sunucu hatasından sonra kısa bir yeniden deneme yapmayı önerir. Kit, ilk hatanın görünür kalması için yeniden denemeleri bilerek size bırakır.

Özel sağlayıcılardaki güncel tuzak

Açık durumdaki iki Codex raporu, #31870 ve #31882, Codex 0.144.x sürümlerinde Azure ve özel sağlayıcılar üzerinden GPT-5.6 hatalarını belgeliyor. Bildirilen durumlarda doğrudan Responses çağrıları başarılı olurken Codex istekleri X-OpenAI-Internal-Codex-Responses-Lite veya ayrılmış collaboration namespace'i hakkında 400 hatalarıyla başarısız oldu.

Bu issue'lar saha raporlarıdır; her özel sağlayıcının başarısız olduğunu kanıtlamaz. Kitin doğrudan API ve Codex katmanlarını ayrı çalıştırmasının nedeni tam olarak budur.

Raporunuz bu ayrımı gösteriyorsa:

1. codex_version, tam hata kategorisi ve istek ID'sini kaydedin.
2. En son kararlı Codex sürümüne yükseltin ve aynı kit sürümünü yeniden çalıştırın.
3. İki issue'nun hâlâ açık olup olmadığını ve bir bakım sorumlusunun düzeltme yayımlayıp yayımlamadığını kontrol edin.
4. Hata sürerse temizlenmiş raporu sağlayıcınıza veya Codex desteğine gönderin.

Issue #31882, Responses-Lite ve çok ajanlı metaverileri devre dışı bırakmak için model kataloğunun tamamını yeniden tanımlayan bir yapılandırmayı tarif ediyor. Bu yöntem kırılgandır: yapılandırma katalog metaverilerinin yerini alır, güncelleme sonrasında eskiyebilir ve ihtiyaç duyduğunuz davranışları devre dışı bırakabilir. Kitin 1.0.0 sürümü bildirilen hata imzalarını tespit eder; ancak Codex'e bilerek yama uygulamaz veya sessizce eski sürüme dönmeyi önermez.

Bu kit neleri ölçmez?

Bu bir uyumluluk probudur, model kalitesi benchmark'ı değildir. Kodlama doğruluğunu, uzun bağlam davranışını, önbellek isabet oranını, üretim gecikmesini, SSE verisinin aşamalı iletim zamanlamasını, faturalanan fiyatı, görüntü girdisini, barındırılan araçları, çok ajanlı çalışmayı veya tam fonksiyon çağrısı devam döngüsünü karşılaştırmaz. Yeşil rapor, kaydedilen sürümler ve endpoint ile test edilen sözleşmelerin bir kez çalıştığı anlamına gelir. Her iş yükü için sonuç tahmin etmez veya süreç düzeyinde dosya sistemi yalıtımı sağlamaz.

Sonucun yeniden üretilebilmesi için oluşturulan raporu ve kitin tam dosyalarını saklayın. İndirmeleri SHA256SUMS ile doğrulayın, Codex veya sağlayıcı değişikliğinden sonra yeniden çalıştırın ve yalnızca son durumu değil, kontrolleri tek tek karşılaştırın.

Kontrol edilen kaynaklar

• GPT-5.6 kullanımı
• Codex'te GPT-5.6 modelleri
• GPT-5.6 Sol model sayfası
• GPT-5.6 Terra model sayfası
• GPT-5.6 Luna model sayfası
• Codex yapılandırma referansı
• Alternatif sağlayıcılar için Codex kimlik doğrulaması
• OpenAI API hata rehberi
• Codex issue #31870 ve #31882; kontrol tarihinde ikisi de açıktı