Claude API'de yeni sürüm: SDK'yı güncellemeden önce oku
Claude API'nin 2026-10-21 sürümü çıktı. Yeni SDK'lar bunu varsayılan kullanıyor ve temperature gibi parametreler artık hata veriyor. Neyi değiştirmen gerekiyor?

Anthropic 21 Ekim 2026'da Claude API'nin 2026-10-21 sürümünü yayımladı. Python 2.0.0, TypeScript 1.0.0 gibi yeni SDK sürümleri bu API sürümünü varsayılan olarak gönderiyor. Bu sürümde temperature, top_p ve top_k parametreleri 400 hatası veriyor, bazı alan adları değişiyor ve SDK'ların lisansı MIT'ten Apache 2.0'a geçiyor.
Anthropic 21 Ekim'de Claude API'nin yeni sürümünü yayımladı: 2026-10-21. Bu, API'nin üç yıldan uzun süredir kullanılan 2023-06-01 sürümünden sonraki ilk büyük değişiklik. Yeni SDK sürümleri bunu varsayılan olarak kullanıyor ve bazı değişiklikler mevcut kodu bozabiliyor.
Claude API'yi kendi uygulamanda, otomasyonunda ya da sitende kullanıyorsan, SDK'yı güncellemeden önce neyin değiştiğini bilmen gerekiyor. Aşağıda resmi sürüm notları ve geçiş kılavuzu üzerinden özetliyoruz.
Hangi SDK sürümleri yeni API'yi kullanıyor
Şu sürümler ve sonrası 2026-10-21 sürümünü varsayılan olarak gönderiyor:
| Dil | İlk sürüm |
|---|---|
| Python | 2.0.0 |
| TypeScript | 1.0.0 |
| C# | 13.0.0 |
| Go | 2.0.0 |
| Java | 3.0.0 |
| PHP | 1.0.0 |
| Ruby | 2.0.0 |
| ant CLI | 2.0.0 |
Daha eski SDK sürümleri her istekte anthropic-version: 2023-06-01 göndermeye devam ediyor. SDK kullanmadan API'yi doğrudan çağırıyorsan sürümü sen seçiyorsun: başlığı değiştirmediğin sürece eski davranış sürüyor.
API tarafında neler değişti
Messages API'de üç değişiklik var:
- temperature, top_p ve top_k kaldırıldı. Bu üç parametreden birini göndermek, varsayılan değerde bile olsa 400 hatası veriyor. İstek varsayılanlarla, yani temperature 1.0 ile çalışıyor. Claude 4.7 ve sonraki modeller zaten sadece varsayılanı kabul ettiği için onlarda fark yok. Claude Sonnet 4.6 gibi eski bir modelde daha tutarlı çıktı için temperature düşürüyorsan, bu etki kayboluyor ve yerini tutan bir ayar yok.
- Asistan mesajında doğrudan belge bloğu hata veriyor. Belgeleri kullanıcı mesajında göndermen gerekiyor.
- Kullanıcı mesajında
citationsiçeren metin blokları hata veriyor. Claude'un kendi cevaplarındaki alıntılar sorun değil.
Yönetici (Admin) API ve kurumsal analiz API'sinde de bazı alanların eski adları kaldırıldı. Örneğin API anahtarlarındaki workspace_id yerine artık scope alanı okunuyor.
SDK'larda neler değişti
API sürümünden bağımsız olarak yeni SDK'larda da uyumsuz değişiklikler var:
- Metin tamamlama (Text Completions) arayüzü tamamen kaldırıldı.
- API anahtarı artık
Authorization: Bearerbaşlığıyla gönderiliyor. - Bir istemci tek bir kimlik bilgisi tutuyor.
- Araç çalıştırıcıdaki istemci tarafı sıkıştırma kaldırıldı.
- ant CLI artık API anahtarını komut satırı bayrağı olarak kabul etmiyor, çünkü komut geçmişinde görünüyor.
- Lisans MIT'ten Apache 2.0'a geçti. Eski sürümler MIT olarak kalıyor ve kod değişikliği gerekmiyor.
Her dilin kendine özgü değişiklikleri de var. Kılavuzda dil dil ayrılmış durumda.
Nasıl geçiş yaparsın
Anthropic'in önerdiği sıra üç adım: önce SDK'yı yeni ana sürüme yükselt, sonra kodunu uyumsuz değişikliklere göre düzelt, en son yeni sürüme karşı test et.
Pratikte ilk iş, kodunda bu üç parametreyi aramak:
grep -rnE "temperature|top_p|top_k" --include=*.py --include=*.ts --include=*.js --include=*.php .
Python'da SDK sürümünü sabitleyerek beklenmedik bir yükseltmeyi önleyebilirsin:
# requirements.txt
anthropic<2.0.0
Hazır olduğunda sınırı kaldırıp 2.0.0'a geçersin. Claude Code kullanıyorsan geçişi ona da yaptırabilirsin:
Bu projede Anthropic SDK'yı API sürümü 2026-10-21'i kullanan yeni ana sürüme yükselt.
Geçiş kılavuzu: https://platform.claude.com/docs/en/api/migration-2026-10-21
temperature, top_p ve top_k kullanılan her yeri listele ve kaldır.
Değişiklikleri tek tek göster, testleri çalıştır, testler geçmeden commit atma.
Bizim yorumumuz: temperature'ın gidişi beklenen bir adım
Bizi şaşırtan değişiklik temperature'ın tamamen kalkması olmadı. Anthropic son modellerde bu parametreyi zaten fiilen kapatmıştı. Yeni nesil modellerde düşünme süresi ve çaba ayarları, cevabın kalitesini temperature'dan çok daha fazla belirliyor. API'yi bu gerçeğe uydurmak mantıklı. Ama eski bir modelde düşük temperature ile tutarlı JSON üreten bir otomasyonun varsa, yükseltmeden önce bunu test etmen şart.
Türkiye'deki geliştiriciler için en büyük risk, otomatik bağımlılık güncellemesi. Dependabot ya da Renovate gibi bir araç kullanıyorsan ve SDK sürümünü sınırlamadıysan, bir sabah üretimdeki kodun 400 hatası vermeye başlayabilir. Sürümü sabitle, geçişi bilerek yap.
Lisans değişikliği çoğu ekip için sorun değil, Apache 2.0 da serbest bir lisans. Ama kurumsal müşteriye yazılım teslim eden ajanslar, teslim belgelerindeki lisans listesini güncellemeli.
Claude API'ye yeni başlıyorsan bu değişiklik işini kolaylaştırıyor: eski kalıpları öğrenmeden doğrudan yeni sürümle başlarsın. Temel kavramlar için Claude Code nasıl kurulur yazımıza da bakabilirsin.
Sık sorulanlar
Hiçbir şey yapmazsam uygulamam bozulur mu?
SDK'yı güncellemediğin ve API'yi doğrudan çağırıyorsan anthropic-version başlığını değiştirmediğin sürece istekler eski 2023-06-01 sürümüyle gitmeye devam ediyor. Sorun, SDK'yı yeni ana sürüme yükselttiğin anda başlıyor.
temperature değeri olmadan tutarlı cevap nasıl alırım?
2026-10-21 sürümünde bunun yerini tutan bir ayar yok. Claude 4.7 ve sonraki modeller zaten sadece varsayılan değerleri kabul ediyordu, onlarda bir şey değişmiyor. Daha eski bir modelde düşük temperature'a güveniyorsan o isteği şimdilik 2023-06-01 sürümünde tutabilirsin.
Lisans değişikliği beni etkiler mi?
Kod değişikliği gerektirmiyor. Yeni SDK sürümleri Apache 2.0, eskileri MIT lisanslı kalıyor. Şirketinde bağımlılıkların lisansını takip eden bir liste varsa o kaydı güncellemen yeterli.
Eski API sürümü ne zaman kapanacak?
Sürüm notlarında ve geçiş kılavuzunda 22 Ekim 2026 itibarıyla 2023-06-01 için bir kapanış tarihi yok.
Haftada bir e-posta. Sadece işe yarayanlar.
Haftanın en iyi yapay zekâ araçları ve yeni rehberler. İstediğin an tek tıkla çık.
Claude Code nedir, nasıl kurulur? Türkçe başlangıç rehberi











