Claude API Sürümü 2026-10-21: Neler Değişti ve Güvenli Yükseltme Nasıl Yapılır?

Claude API sürümü 2026-10-21, 2023-06-01'den bu yana ilk yeni anthropic-version değeridir. Messages API'de üç kırıcı değişiklik yapar: temperature, top_p ve top_k artık 400 hatası döndürür, assistant mesajlarındaki document blokları 400 döndürür ve user mesajlarındaki text bloklarındaki citations 400 döndürür. Ayrıca birkaç Admin API ve Enterprise Analytics API alanını yeniden adlandırır. anthropic-version: 2026-10-21 göndererek veya yeni SDK ana sürümlerine (Python 2.0.0, TypeScript 1.0.0, Go 2.0.0 ve diğerleri) yükselterek bu sürüme geçiş yaparsınız.

İşin püf noktası: SDK'yı yükseltmek, çoğu ekibin yeni sürüme "yanlışlıkla" geçmesinin yoludur. Bir ana sürümü aşan rutin bir pip install -U anthropic veya npm update komutu, tüm istekleri tek seferde 2026-10-21'e çevirir. Bu kılavuz Anthropic'in belgelediği her değişikliği listeler, hangilerinin gerçek kodda sorun çıkardığını gösterir ve güvenli bir yükseltme sırası sunar.

anthropic-version başlığı nedir?

anthropic-version başlığı, aldığınız Claude API'nin şeklini sabitleyen zorunlu bir istek başlığıdır. Tek bir sürüm içinde Anthropic mevcut girdi ve çıktı parametrelerini sabit tutar, ancak isteğe bağlı girdiler, yeni çıktı değerleri, akış olay türleri gibi yeni enum varyantları ve yeni hata koşulları ekleyebilir. Kırıcı değişiklikler yalnızca yeni bir sürüm tarihiyle gelir.

Sürümleme sayfasına göre üç sürüm mevcuttur:

Resmî bir SDK kullanıyorsanız başlığı asla kendiniz ayarlamazsınız. Her SDK ana sürümü, o ana sürüm yayımlandığında geçerli olan sürümü gönderir. Bu yüzden çoğu kod tabanı için SDK yükseltmesi ile API sürüm yükseltmesi aynı olaydır.

Claude API 2026-10-21 kırıcı değişiklikleri

Bu değişiklikler POST /v1/messages için, token sayımı için ve 2026-10-21 ile oluşturulmuş bir Message Batch içindeki her istek için geçerlidir.

1. temperature, top_p ve top_k kaldırıldı

Çoğu kişinin karşılaşacağı değişiklik budur. temperature, top_p veya top_k gönderen her istek, varsayılan değeri gönderseniz bile, her modelde 400 hatası döndürür. Bir yapılandırma dosyasında kalmış temperature: 1.0 çağrıyı bozmaya yeter.

Çıktı kalitesine ne olacağı modele bağlıdır:

• Claude 4.7 ve sonrası zaten yalnızca varsayılan örnekleme değerlerini kabul eder, dolayısıyla parametreleri kaldırmak örnekleme biçimini hiç değiştirmez.
• Başka değerleri kabul eden eski modeller, örneğin Claude Sonnet 4.6, temperature değerini düşürmekten elde ettiğiniz etkiyi kaybeder. Geçiş kılavuzu bu konuda açık: onun yerini alan başka bir ayar yok.

Bir istek gerçekten varsayılan olmayan bir değere bağlıysa Anthropic size iki seçenek sunar: göndermeyi bırakın ya da o belirli isteği 2023-06-01'de tutun.

2. assistant mesajlarındaki document blokları 400 döndürür

Bazı uygulamalar konuşma geçmişini doğrudan bir assistant turuna yerleştirilmiş document bloğuyla yeniden oynatır. 2026-10-21 altında bu reddedilir. Belgeleri user mesajlarına taşıyın. Başka bir bloğun içine yerleştirilmiş bir belge, örneğin Claude'un döndürdüğü bir web fetch araç sonucu, hâlâ kabul edilir.

3. user mesajlarındaki citations 400 döndürür

Bir user mesajında boş olmayan bir citations dizisine sahip text bloğu artık başarısız olur ve bu search_result bloklarının içindeki metni de kapsar. Bu bloklardan citations alanını çıkarın. Geri gönderdiğiniz Claude'un kendi assistant yanıtlarındaki alıntılar hâlâ sorunsuzdur ve belgeler ile arama sonuçlarındaki "citations": {"enabled": true} da öyledir.

4. Admin API ve Enterprise Analytics alan adı değişiklikleri

Yanıtlar artık eski alan adlarını içermiyor:

İnce olan değişiklik API anahtarıyla ilgili olan. 2023-06-01 altında workspace_id, hem Default Workspace'e bağlı anahtarlar hem de tüm çalışma alanlarına ait anahtarlar için null idi. 2026-10-21 altında scope.workspace_id, Default Workspace'in gerçek kimliğini tutar ve tüm çalışma alanlarına ait bir anahtarda workspace_id olmadan scope: {"type": "organization"} bulunur. Panonuz null değerini "Default Workspace" olarak değerlendiriyorsa, yükseltmeden sonra anahtarları yanlış etiketleyecektir.

2026-10-21 gönderen SDK sürümleri

Anthropic, 21 Ekim 2026'da yeni SDK ana sürümlerini yayımladı ve sürüm notlarına göre her biri varsayılan olarak 2026-10-21 gönderiyor:

Yeni ana sürümler ayrıca API sürümüne hiç bağlı olmayan değişiklikler de getiriyor:

• API anahtarları X-Api-Key yerine Authorization: Bearer <key> olarak gönderiliyor. Claude API ikisini de kabul eder, ancak X-Api-Key okuyan bir proxy, gateway, log filtresi veya test stub'ı artık anahtarı göremez.
• Text Completions, TypeScript, Go, Java ve Ruby SDK'larından ve CLI'dan kaldırıldı. Messages API'yi kullanın.
• betas, beta olmayan Models metotlarından kaldırıldı. Bunun yerine client.beta.models çağırın.
• Tipli SDK'larda MessageParam artık rol başına bir tür içeren bir birleşim (union), dolayısıyla bazı tür açıklamalarının güncellenmesi gerekir.
• Go, /v2 ile biten yeni bir içe aktarma yolu gerektiriyor ve Bedrock, Vertex, Foundry, AWS veya Google Cloud paketlerini kullanan TypeScript kullanıcıları bu paketleri aynı yükseltmede v1'e taşımalı, aksi halde paket yöneticisi çekirdek SDK'nın ikinci, daha eski bir kopyasını kurar.
• Lisans MIT'den Apache 2.0'a değişti.

Başka bir şey yapmadan önce mevcut ana sürümünüzü sabitleyin. Bu, bir bağımlılık botunun sizi sprint ortasında yükseltmesini engeller.

Amazon Bedrock istisnası

Amazon Bedrock'ta 2026-10-21 yalnızca Claude 4.7 ve sonrası modellerle çalışır. Orada hâlâ Opus 4.6 veya daha eski bir modeli çağırıyorsanız mevcut SDK sürümünüzde kalın ya da mevcut başlığınızı göndermeye devam edin ve önce modeli değiştirin.

Claude API sürüm 2026-10-21'e güvenli şekilde nasıl yükseltilir

Geçiş kılavuzunun sırası şöyle: sürümü değiştir, kırıcı değişiklikleri düzelt, yayımlamadan önce test et. Pratikte bu şöyle görünür.

1. Eski SDK ana sürümünü sabitleyin. Örneğin Python'da anthropic<2 veya npm'de "@anthropic-ai/sdk": "^0".
2. Kodunuzda ve yapılandırmalarınızda temperature, top_p, top_k, X-Api-Key, completions.create ve yukarıdaki tablodaki herhangi bir Admin API alanını arayın.
3. Örnekleme konusunda karar verin. Claude 4.7 ve sonrasında parametreleri silin. Eski modellerde ya varsayılan örneklemeyi kabul edin ya da o çağrıları 2023-06-01'de tutun.
4. Mesaj oluşturmayı düzeltin. Assistant tarafındaki belgeleri user turlarına taşıyın ve user text bloklarından citations alanını çıkarın.
5. Aynı yükleri her iki sürüm altında test edin ve durum kodları ile yanıt şekillerini karşılaştırın.
6. SDK'yı yükseltin ve kod düzeltmelerini aynı anda yayımlayın. Anthropic, yükseltmeyi düzeltmelerinizden önce değil, onlarla birlikte yayımlamanızı söylüyor.

SDK olmadan geçiş tek bir başlıktır:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Bu gövdeye "temperature": 0.2 ekleyin ve 400 alırsınız. Aynı gövdeyi anthropic-version: 2023-06-01 ile gönderin, başarılı olur. Bu iki sonuç tam olarak 5. adımın üretimde gönderdiğiniz her yük için yakalaması gereken şeydir.

Claude Code'un her iki sürümü Apidog CLI ile test etmesini sağlayın

5. adım elle yapıldığında zahmetlidir: onlarca yük şekliniz var ve her birinin iki kez çalışması gerekiyor. Bunu kodlama ajanınıza devredin. Apidog CLI, Claude Code'a (veya Codex, Cursor ve OpenCode'a) test senaryoları oluşturup çalıştırması için komutlar verir, böylece karşılaştırmayı ajan yapar ve siz özeti okursunuz.

Bir kez kurun:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code when prompted

Ardından Claude Code'a tek bir istem verin:

In Apidog project <id>, create an environment "claude-api" with base URL
https://api.anthropic.com. For each JSON payload in ./fixtures/claude/, add a
POST /v1/messages test case that sends the header anthropic-version: {{anthropic_version}}
and asserts status 200 and a non-empty content array. Run every case twice, once with
anthropic_version=2023-06-01 and once with 2026-10-21, and list each case that passes
on the old version but fails on the new one, with the error message.

Ajan, herhangi bir şey yazmadan önce her yük şemasını kontrol eder, sonra senaryoları çalıştırır:

apidog environment create claude-api --project <id> --base-url https://api.anthropic.com
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "anthropic_version=2023-06-01" -r cli,json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "anthropic_version=2026-10-21" -r cli,json

--env-var bayrağı, test senaryosuna dokunmadan başlık değerini değiştirir, böylece fark tek bir değişkenden oluşur. Her iki çalıştırmayı da Apidog uygulamasında görmek için --upload-report ekleyin veya bir bağımlılık güncellemesinin üretime bir temperature alanı göndermesini engellemek için 2026-10-21 çalıştırmasını -r junit ile CI'a koyun. Claude Code'da Apidog CLI kılavuzu kurulumu daha ayrıntılı ele alıyor ve apidog run referansı tüm bayrakları listeliyor. Apidog'un Ücretsiz planı 4 kullanıcıya kadar kapsar.

2023-06-01 kullanımdan kaldırıldı mı?

Hiçbir kullanımdan kaldırma tarihi yayımlanmadı. Sürümleme sayfası 2023-06-01'i herhangi bir kullanımdan kaldırma bildirimi olmadan listeliyor ve geçiş kılavuzunun kendisi, varsayılan olmayan bir temperature gerektiren istekleri 2023-06-01'de tutmanızı söylüyor. Anthropic hâlâ "mümkün olan her durumda" en son sürümü öneriyor.

Bu, planlama açısından önemli. Bugünkü yükseltme isteğe bağlı, ancak 2026-10-21 üç yıldan uzun süredir ilk yeni sürüm ve gelecekteki kırıcı değişiklikler de aynı şekilde gelecek, dolayısıyla sürüm testini şimdi rutin bir CI işi olarak ele almak, sonradan aceleye gelen bir geçişten daha ucuz. Zaten Claude API hız limitleri veya Claude API maliyeti etrafında ince ayar yapıyorsanız, sürüm kontrolünü aynı iş akışına ekleyin. API sürümleme en iyi uygulamaları kılavuzumuz, bunun gibi tarih tabanlı sürümlerin neden işleri kolaylaştırdığını açıklıyor.

SSS

Claude API sürüm 2026-10-21'e şimdi yükseltmek zorunda mıyım?

Hayır. 2023-06-01 hâlâ çalışıyor ve yayımlanmış bir kullanımdan kaldırma tarihi yok. Yeni başlığı gönderdiğinizde veya varsayılan olarak bunu kullanan bir SDK ana sürümünü kurduğunuzda yükseltmiş olursunuz.

SDK yükseltmesinden sonra isteğim neden 400 döndürüyor?

Yeni SDK ana sürümleri 2026-10-21 gönderir; bu sürüm temperature, top_p ve top_k ile assistant tarafındaki document bloklarını ve user text bloklarındaki citations alanını reddeder. Önce yükünüzde bunları kontrol edin.

Bazı isteklerde temperature'ı koruyabilir miyim?

Evet, o belirli istekleri 2023-06-01'de tutarak. 2026-10-21 altında onun yerini alan bir ayar yok ve Claude 4.7 ve sonrası modeller zaten yalnızca varsayılanlarla örnekleme yapıyor.

2026-10-21 Amazon Bedrock'ta çalışıyor mu?

Yalnızca Claude 4.7 ve sonrası modeller için. Eski Bedrock modelleri, siz modeli değiştirene kadar mevcut SDK sürümünüzü veya başlığınızı gerektirir.

Proxy'm API anahtarımı hâlâ görecek mi?

X-Api-Key okuyorsa görmeyecek. Yeni SDK'lar anahtarı Authorization: Bearer olarak gönderir. Proxy'yi Authorization okuyacak şekilde güncelleyin veya SDK'yı X-Api-Key göndermesi için kendiniz yapılandırın.

Yeni sürüm akış olaylarını değiştiriyor mu?

Anthropic, 2026-10-21 için herhangi bir akış biçimi değişikliği listelemiyor. Bugün kullandığınız akış biçimi 2023-06-01 ile gelmişti.