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

> Claude Sonnet 5.5 geçişi, model kimliğini değiştirmekle bitmiyor. tool_choice, thinking ayarı ve bilgisayar kullanımı aracındaki kıran değişiklikleri, Sonnet 4.5'in 30 Kasım 2026'daki emekliliğini ve geçişi test ortamında nasıl deneyeceğinizi anlatıyoruz.

Yayın: 2026-10-07 · Güncelleme: 2026-10-07 · Yazar: sunucu.com.tr Ekibi · Kaynak: https://sunucu.com.tr/blog/claude-sonnet-5-5-gecisi-api-kiran-degisiklikler-sonnet-4-5-emekliligi

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](/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](/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:

```bash
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](https://platform.claude.com/docs/en/release-notes/overview)
