Claude Sonnet 5.5 geçişi: API'deki kıran değişiklikler ve Sonnet 4.5 emekliliğine hazırlık

Anthropic, 28 Eylül 2026'da Claude Sonnet 5.5'i yayımladı. Birkaç gün sonra da Sonnet 4.5'in 30 Kasım 2026'da emekliye ayrılacağını duyurdu. Claude API'yi bir uygulamada, destek botunda ya da ajan iş akışında kullanıyorsanız Claude Sonnet 5.5 geçişi önümüzdeki haftalarda sizin de gündeminizde olacak. Bu geçiş, model adını değiştirip bırakmakla bitmiyor: Sonnet 5'ten gelen bazı istekler artık hata veriyor.

Ne değişti

Yeni modelin API kimliği claude-sonnet-5-5. Model standart olarak 1 milyon token bağlam penceresiyle geliyor ve tek yanıtta en fazla 128 bin token çıktı üretebiliyor. Erişim tarafında seçenek geniş: Claude API, Amazon Bedrock, Claude Platform on AWS, Google Cloud ve Microsoft Foundry.

Asıl dikkat edilmesi gereken kısım, Sonnet 5'e göre davranışı değişen noktalar.

tool_choice ile zorunlu araç kullanımı 400 döndürüyor

tool_choice alanında any ya da tool türüyle modeli araç çağırmaya zorlayan istekler Sonnet 5.5'te 400 hatasıyla reddediliyor. "Model her zaman şu fonksiyonu çağırsın" diye kurulmuş yapılandırılmış çıktı akışları en çok bundan etkilenecek. Bu akışları, modelin aracı kendisinin seçtiği biçime ya da istem tarafında yönlendirmeye çevirmeniz gerekecek.

Düşünmeyi kapatmak için yeni değer

Baştaki düşünme adımını kapatmak için thinking türünü disabled olarak göndermek artık işe yaramıyor. Yerine between_tools kullanılmalı. Bu ayar yalnız high ve daha düşük effort düzeylerinde geçerli. Ayrıca 5 Ekim 2026'dan beri Models API, bir modelin disabled değerini kabul edip etmediğini capabilities.thinking.types.disabled alanında bildiriyor. Birden fazla modeli destekleyen kodda bu alanı okuyup ayarı modele göre seçmek, sabit kodlamaktan daha sağlam bir yol.

Düşünme blokları hesaba bağlı

Sonnet 5.5'in ürettiği düşünme blokları yalnız onları üreten hesapta ya da ona bağlı hesaplarda anlam taşıyor. Başka bir hesap bu blokları geri gönderirse API onları sessizce atıyor, istek yine başarılı dönüyor. Hata almadığınız için fark etmesi zor: konuşma geçmişini farklı API anahtarları ya da hesaplar arasında taşıyan sistemlerde model önceki akıl yürütmeyi görmeden devam edebilir.

Eski bilgisayar kullanımı aracı

Claude API ve Google Cloud üzerinde Sonnet 5.5, computer_20251124 sürümlü bilgisayar kullanımı aracını kabul etmiyor. Bu aracı kullanan otomasyonların araç tanımını güncellemesi gerekiyor.

Sonnet 4.5 kimleri etkiler

Anthropic, claude-sonnet-4-5-20250929 modelini 1 Ekim 2026'da kullanımdan kaldırılacaklar listesine aldı ve emekliliği 30 Kasım 2026'ya planladı. Önerilen hedef Sonnet 5.5. Kodunda bu kimliği sabit yazmış her entegrasyon, o tarihten sonra çalışmayı bırakma riski taşıyor. Yani elinizde iki aydan kısa bir süre var.

Claude Sonnet 5.5 geçişi Türkiye'deki ekipler için ne anlama geliyor

Gizli bağımlılıklar. Türkiye'de pek çok KOBİ'de yapay zeka entegrasyonu tek bir geliştiricinin yazdığı küçük bir betik ya da bir ajansın teslim ettiği bir eklenti olarak duruyor. Model kimliği bir ortam değişkeninde değil de kodun içinde sabitse, emeklilik günü sorun sessizce ortaya çıkar. Önce envanter çıkarmak gerekiyor.

Maliyet ve bağlam. 1 milyon token bağlam, uzun sözleşmeleri, muhasebe dökümlerini ya da büyük kod tabanlarını tek istekte işlemeyi kolaylaştırıyor. Ama bağlamı doldurmak her istekte daha fazla token demek. Fiyatlandırmayı resmi sayfadan kontrol edip uzun bağlamı yalnız gerçekten gereken iş akışlarında açmak mantıklı.

KVKK ve veri akışı. Modele giden veri, entegrasyonun nerede çalıştığından bağımsız olarak sağlayıcıya gider. Ancak istekleri hazırlayan, kişisel verileri maskeleyen ve günlükleri tutan katman sizin sunucunuzda. Geçiş sırasında bu katmanı da gözden geçirmek, kişisel verinin istemlere gereksiz yere girip girmediğini kontrol etmek için iyi bir fırsat.

Hesaplar arası düşünme blokları. Müşterileri için farklı API hesapları yöneten ajanslar ve yazılım evleri, hesap değiştirince düşünme bağlamının kaybolduğunu bilmeli. Konuşma geçmişini hangi hesapla başlattıysanız onunla sürdürmek en temiz yol.

Nasıl denenir

1. Envanter çıkarın. Depolarınızda ve sunucu yapılandırmalarınızda eski model kimliklerini, tool_choice ve disabled kullanımlarını arayın.
2. Model kimliğini yapılandırmaya taşıyın. Kimliği ortam değişkeninden okursanız ileride geri dönüş tek satırlık bir değişiklik olur.
3. Ayrı bir test ortamı kurun. Canlı botu doğrudan yeni modele çevirmek yerine, aynı kodu ayrı bir bulut sunucu üzerinde staging olarak çalıştırıp gerçek iş akışlarından alınmış örnek isteklerle deneyin.
4. Hataları ve çıktı kalitesini ayrı ayrı izleyin. 400 hataları kolay yakalanır; düşünme bloklarının atılması ya da yanıt biçimindeki değişiklikler ise yalnız çıktı karşılaştırmasıyla görünür.
5. Geri dönüş planı hazırlayın. Geçişten önce yapılandırma dosyalarınızın, istem şablonlarınızın ve ortam değişkenlerinizin kopyasını alın. Bunu elle yapmak yerine planlı yedekleme ile düzenli hale getirmek, bir sonraki model geçişinde de işinizi kolaylaştırır.

Envanter adımı için basit bir arama yeterli:

grep -rnE "claude-sonnet-4-5|tool_choice|\"disabled\"|computer_20251124" ./src ./config

Bulunan her satırı tek tek değerlendirin: tool_choice geçen her yer sorunlu değildir, yalnız any ve tool türleriyle zorlama yapanlar etkilenir.

Sık sorulan sorular

Sonnet 4.5 30 Kasım'dan sonra da çalışır mı?

Anthropic emekliliği 30 Kasım 2026'ya planladı. O tarihten sonra bu modele güvenmemek gerekiyor; geçişi önceden tamamlamak en güvenli yol.

Sadece model kimliğini değiştirmek yeterli mi?

Her zaman değil. tool_choice ile zorunlu araç kullanımı, thinking'in disabled ile kapatılması ve computer_20251124 aracı Sonnet 5.5'te farklı davranıyor. Bunları kullanan kodun güncellenmesi gerekiyor.

Neden hata almadığım halde yanıt kalitesi düştü?

Düşünme bloklarını başka bir hesaptan gönderiyorsanız API onları atar ama isteği başarılı sayar. Konuşmayı başlatan hesapla devam edip etmediğinizi kontrol edin.

1 milyon token bağlam için ek ayar gerekiyor mu?

Sürüm notlarına göre Sonnet 5.5 bu bağlamı standart olarak destekliyor. Ayrıntılar ve fiyatlandırma için resmi belgelere bakın.

Kaynaklar

• Claude Platform release notes