Claude Fable 5.1'e Geçiş: Fable 5 veya Opus 5'ten Tüm Kırıcı Değişiklikler

Claude Fable 5.1'e geçiş çoğunlukla model kimliğini değiştirmekten ibarettir. API yüzeyi, limitler, jeton başına fiyatlandırma, tokenize edici, her zaman açık uyarlanabilir düşünme ve reddetme yönetimi Fable 5 ile aynıdır. Ancak Fable 5'in döndürmediği üç yeni hata vardır. Bunlardan biri, geçmiş düzenleme kontrolü, bir yıldır sorunsuz çalışan istemci altyapısını sessizce bozabilir. Opus 5'ten geçişte dört değişiklik daha dikkate alınmalıdır. Bu kılavuz, Anthropic'in geçiş kılavuzundan ve Claude Fable 5.1'deki Yenilikler belgesinden derlenmiş bir kontrol listesidir. Her adım, karşılaşma olasılığınıza göre sıralanır; hata metinleri, düzeltmeler ve üretim öncesi test önerileri içerir. Genel bakış için Claude Fable 5.1 nedir? yazısıyla başlayabilirsiniz. Adım 0: Geçiş gerekip gerekmediğini doğrulayın Anthropic, Opus 5 ile başlamanızı; Fable 5.1'i ise yoğun mantık yürütme, uzun süreli ajan çalışmaları veya Opus 5 değerlendirmelerinin yüksek çabayla bile yetersiz kaldığı senaryolar için kullanmanızı öneriyor. Opus 5 değerlendirmelerinizi geçiyorsa Fable 5.1, belirgin bir kazanım olmadan jeton maliyetinizi iki katına çıkarabilir. Fable 5 kullanıyorsanız Fable 5.1 aynı liste fiyatına, daha ucuz önbellek okumalarına ve iddia edilen daha iyi sonuçlara sahiptir. Bu durumda temel soru, uygulamanızın ne kadar yoğun donanım çalışması gerektirdiğidir. Karşılaştırmalar için: Geçişten önce şu üç uygunluk kontrolünü yapın: - Veri saklama: Fable 5.1, 30 günlük veri saklama gerektirir. Anthropic açıkça yetki vermedikçe sıfır veri saklama (ZDR) kapsamında kullanılamaz. ZDR kullanan bir kuruluş, başka bir belirti olmadan her istekte 400 invalid_request_error alır. Opus 5, ZDR altında kullanılabilir. - Öncelik Katmanı: Fable 5.1 tarafından desteklenmez; Fable 5 destekler. - Oran limitleri: Fable 5.1 ve Fable 5, tek bir Fable 5.x havuzunu paylaşır. Kademeli geçiş aynı boş kapasiteden yararlanır. Adım 1: Model adını güncelleyin model = "claude-fable-5" # Önce model = "claude-opus-5" # Veya önce model = "claude-fable-5-1" # Sonra Amazon Bedrock'taki model kimliği: anthropic.claude-fable-5-1 Google Cloud, Microsoft Foundry ve AWS üzerindeki Claude Platformu claude-fable-5-1 kullanır. Claude Yönetilen Aracıları kullanıyorsanız gereken tek değişiklik model adıdır. Kritik değişiklik 1: Zorunlu araç kullanımı artık 400 döndürüyor Fable 5, tool_choice için auto , none , any ve tool değerlerini kabul ediyordu. Fable 5.1 ise Messages API, Batches API ve jeton sayma uç noktasında tool ve any değerlerini reddeder: tool_choice: type "tool" and "any" are not supported for this model. Anthropic'e göre neden, her zaman açık düşünmenin zorunlu çağrıyla atlanması ve modelin düşünme sürecini araç bağımsız değişkenlerine yazabilmesidir. Önce: Fable 5 response = client.messages.create( model="claude-fable-5", max_tokens=16000, tools=[record_summary_tool], tool_choice={"type": "tool", "name": "record_summary"}, messages=[{"role": "user", "content": "Summarize: The meeting moved to Thursday."}], ) Sonra: Fable 5.1 tool_choice değerini auto olarak bırakın, araç adını talimatta açıkça belirtin ve bağımsız değişkenlerin şemanızla eşleşmesini sağlamak için strict: true kullanın. Katı araç kullanımı hakkında daha fazla bilgi edinin. record_summary_tool["strict"] = True record_summary_tool["input_schema"]["additionalProperties"] = False response = client.messages.create( model="claude-fable-5-1", max_tokens=16000, tools=[record_summary_tool], tool_choice={"type": "auto"}, messages=[{ "role": "user", "content": ( "Summarize: The meeting moved to Thursday. " "Call the record_summary tool with your result." ), }], ) Kullanım amacına göre şu geçişleri yapın: - JSON döndürmek için bir aracı zorladıysanız output_config.format ile yapılandırılmış çıktılara geçin. - Uygulama o turda araç çağrısını gerektiriyorsa, son kullanıcı mesajından sonra aracı adlandıran ve çağrının gerekli olduğunu belirten bir role: "system" mesajı ekleyin. Bu mesajı sonraki geçmişte koruyun. - any ile “tam olarak bir araç” davranışına güveniyorsanızdisable_parallel_tool_use: true ,auto ile birlikte hâlâ çalışır; ancak artık en fazla bir çağrı anlamına gelir. - Araç çağrısı gelmediğinde çalışan yeniden deneme döngülerini kaldırın. Anthropic, Fable 5.1'in açık araç talimatlarını güvenilir biçimde izlediğini belirtiyor. - CMEK kullanan kuruluşlarda Fable modelleri için strict: true ve yapılandırılmış çıktılar mevcut değildir. Bu durumda yalnızca açık talimatlara güvenin. Kritik değişiklik 2: Eski modeller Fable 5.1 düşünme bloklarını okuyamaz Her düşünme bloğu, onu üreten modeli kaydeder. Fable 5.1 şu modellerden gelen blokları okuyabilir: - Opus 5 - Fable 5 - Mythos 5 - Daha önceki modeller Bu nedenle mevcut bir konuşmayı Fable 5.1'e taşırken akıl yürütmeyi koruyabilirsiniz. Ancak Mythos 5.1 dışında hiçbir model Fable 5.1 bloğunu okuyamaz. Bir Fable 5.1 konuşması yönlendirici anahtarı, istemci tarafı yeniden denemesi veya sınıflandırıcı geri dönüşü nedeniyle eski bir modele düşebilir. API, hedef model blokları görmeden önce bunları düşürür. İstek başarılı olur ve düşürülen jetonlar faturalandırılmaz; ancak hedef model akıl yürütme olmadan yeniden planlama yaptığından geçişten sonraki ilk turda maliyet ve gecikme artabilir. Kodda yapılması gereken bir blok dönüşümü yoktur. Düşünme bloklarını değiştirmeden geri gönderin. Bunları kendiniz kaldırmak imza doğrulama hatalarına yol açabilir. Görünürlüğü artırmak için şu beta başlığını gönderin: thinking-binding-controls-2026-08-01 Yanıt, reason: "model_binding_mismatch" ile düşürülen blokları input_transformations içinde bildirir. Kritik değişiklik 3: Önceki dönüşleri düzenlemek düşünme bloklarını geçersiz kılar Bir Fable 5.1 düşünme bloğu, kendisinden önce gelen şu içeriğe bağlıdır: - Tam system komut istemi - tools dizisi - Mesaj geçmişi - Korunmuş düşünme blokları Geçmiş düzenleme kontrolünün uygulandığı hesaplarda bu içeriklerden biri değiştikten sonra bloğu yeniden oynatmak isteği reddeder: messages.5.content.0: Invalid signature in thinking block. The block is bound to a different conversation. Remove the block, or set thinking.block_binding.prefix_mismatch_behavior to "drop_block". That setting requires the thinking-binding-controls-2026-08-01 value in the anthropic-beta header. Kimler için geçerli? 31 Ağustos 2026 tarihinde veya sonrasında oluşturulan hesaplarda kontrol varsayılan olarak uygulanır. Daha eski hesaplar uyumsuzluğu kaydeder; yalnızca istek thinking.block_binding.prefix_mismatch_behavior değerini ayarlarsa buna göre hareket eder. Anthropic, gelecekte bu kontrolü tüm hesaplar için uygulamayı planlıyor. Başkalarının kendi API anahtarlarıyla çalıştırdığı bir araç gönderiyorsanız bu alanı açıkça ayarlayarak test edin. Yeni hesap kullanan kişiler bu kuralla sizden önce karşılaşabilir. Claude Code, claude.ai, Yönetilen Aracılar ve Agent SDK öneki sizin için tutarlı tutar. Mythos 5.1 ise bu kontrolü hiç çalıştırmaz. Hangi değişiklikler sonraki blokları geçersiz kılar? - Önceki bir dönüşü düzenlemek, yeniden sıralamak veya kaldırmak; buna eski araç sonuçlarını silmek de dahildir. - Bir sonraki istekte kaldıracağınız istek başına metin eklemek. - İstekler arasında system veyatools içeriğini yeniden oluşturmak. - Daha sonra farklı baytlar döndüren bir görsel URL'si kullanmak. Hangi değişiklikler güvenlidir? - Yalnızca yeni mesaj eklemek. - En eski düşünme bloklarını baştan başlayarak kaldırmak. - system ,tools vemessages dışındaki parametreleri değiştirmek. - cache_control işaretçilerini taşımak. - Sunucu tarafı sıkıştırma veya bağlam düzenleme kullanmak. Kurtarma: Uyumsuz bloğu düşürün Beta başlığını gönderin ve davranışı drop_block olarak ayarlayın: response = client.beta.messages.create( model="claude-fable-5-1", max_tokens=16000, thinking={ "type": "adaptive", "block_binding": { "prefix_mismatch_behavior": "drop_block" }, }, betas=["thinking-binding-controls-2026-08-01"], messages=history, ) for t in response.input_transformations or []: print(t.path, t.reason) # prefix_binding_mismatch veya model_binding_mismatch API, ilk uyumsuz bloğu ve ondan sonraki tüm düşünme bloklarını düşürür, işlemeye devam eder ve her düşürmeyi raporlar. Bu davranış yalnızca mevcut istek için geçerlidir; bu nedenle alanı sonraki isteklere de göndermeye devam edin. Bir geçmiş düzenlemesinin çalışmayı durdurmasını istiyorsanız CI ortamında açıkça error ayarlayın. Korunmuş düşünme kılavuzu, üç adımlı denetimi ve bozulmaya yol açan yaygın sıkıştırma biçimlerini açıklar. | Yapıyordunuz | Bunun yerine | |---|---| Oturum ortasında system içeriğini düzenlemek | Oturum başlangıcında sabitleyin. Değişikliğin geçerli olduğu yere role: "system" mesajı ekleyin. | Oturum ortasında tools içeriğini düzenlemek | Tam araç setini baştan bildirin. tool_addition veya tool_removal bloklarını system mesajıyla gönderin ve mid-conversation-tool-changes-2026-07-01 beta özelliğini kullanın. | | Her dönüşte bir hatırlatıcı ekleyip silmek | clear_at: "next_user_message" kullanan dönüş kapsamlı bir system mesajı gönderin. mid-conversation-system-clear-at-2026-08-21 beta özelliğini kullanın. | | Eski araç sonuçlarını istemci tarafında silmek | Sunucu tarafı bağlam düzenlemesini kullanın. | | Son dönüşleri kelimesi kelimesine koruyan istemci tarafı sıkıştırma yapmak | Sunucu tarafı sıkıştırma veya bir özet mesajı ile yeni kullanıcı dönüşü kullanın; eski içeriği yeniden oynatmayın. | | Dönüşler arasında bir görsele URL ile yeniden başvurmak | Görseli bir kez Dosyalar API'sine yükleyin ve sonraki isteklerde file_id gönderin. | Opus 5'ten geliyorsanız: dört ek değişiklik 1. Düşünme hiçbir çabayla devre dışı bırakılamaz Opus 5, high veya daha düşük seviyelerde aşağıdaki ayarı kabul ediyordu: thinking={"type": "disabled"} Fable 5.1 bu ayarla her çaba seviyesinde 400 döndürür. Alanı kaldırın, daha düşük çabayla harcamayı kontrol edin ve düşünmeden çalışan rotalar için max_tokens değerini yeniden değerlendirin. 2. Araçlar arasındaki anlatım düşünme bloklarına taşınır Opus 5'te araç çağrıla