Claude Opus 5.5: Yenilikler, Fiyatlandırma, Kırılma Değişiklikleri ve Claude Code'da Kullanım Rehberi

Ahmet Bilgiç 24 Eylül 2026

Anthropic, 22 Eylül 2026'da Claude Opus 5.5'i yayınladı ve Claude Code aynı gün çıkan 2.1.280 sürümüyle bu modeli varsayılan Opus hâline getirdi. Opus 5'in üzerinden iki ay geçmişken gelen bu sürüm, "biraz daha iyi bir model" haberinden fazlası: fiyat düştü, varsayılan effort seviyesi değişti, thinking artık kapatılamıyor, API'de dört kırılma değişikliği var ve Pro planındaki Claude Code kullanıcıları artık varsayılan olarak Opus ile çalışıyor. Bu yazıda yalnızca Anthropic'in resmi duyurusu, Claude Platform dokümantasyonu ve Claude Code sürüm notlarına dayanarak neyin değiştiğini, maliyetin nasıl hesaplandığını, Opus 5'ten geçişte hangi kodların kırılacağını ve Claude Code'da modeli nasıl kullanacağınızı anlatıyorum. Opus 5'in kendisini, /model ve /effort komutlarının temellerini daha önce Claude Opus 5 rehberinde yazmıştım; burada o bilgiyi tekrarlamak yerine 5.5 ile değişenlere odaklanıyorum.

Claude Opus 5.5 Nedir ve Ne Sunuyor?

Resmi model sayfası Opus 5.5'i "uzun süreli ajan tabanlı kodlama ve bilgi işi için" tasarlanmış model olarak tanımlıyor. Anthropic'in duyurusu üç iddiayı öne çıkarıyor: çoğu işte Claude Fable 5.1 seviyesinde performans, Opus 5'e göre tipik iş yüklerinde yüzde 40 daha düşük çalışma maliyeti ve yüzde 30 daha hızlı çıktı üretimi. Maliyet düşüşünün iki kaynağı var: liste fiyatı indi ve model aynı işi daha az token ile bitiriyor. Duyurudaki müşteri alıntıları da bu ikinci noktayı vurguluyor; GitHub, VS Code'da Opus 5'ten daha fazla terminal görevini yarıdan az adımda çözdüğünü, Box ise değerlendirmelerinde Opus 5'in kullandığı token'ın üçte birini kullandığını söylüyor.

Temel teknik özellikler resmi model sayfasından:

Özellik Claude Opus 5.5
API model kimliğiclaude-opus-5-5 (tarih son eki yok, sabit snapshot)
Bağlam penceresi1 milyon token (varsayılan, beta başlığı gerekmez)
Maksimum çıktı128K token (Batch API'de output-300k-2026-03-24 beta başlığıyla 300K)
ThinkingAdaptive, her zaman açık
Varsayılan effortmedium
Fiyat4 $ / 20 $ (milyon girdi / çıktı token)
Bilgi kesim tarihiHaziran 2026 (eğitim verisi de Haziran 2026)
Yayın / emeklilik22 Eylül 2026 / 22 Eylül 2027'den önce değil
PlatformlarClaude API, Amazon Bedrock (anthropic.claude-opus-5-5), Google Cloud, Microsoft Foundry, Claude Platform on AWS

Bir ayrıntı: 1M token, Opus 4.7 ile gelen yeni tokenizer'da yaklaşık 555 bin İngilizce kelimeye karşılık geliyor; Sonnet 4.6 ve öncesinden geliyorsanız aynı metin yaklaşık yüzde 30 daha fazla token üretir. Prompt cache için asgari uzunluk 512 token.

Opus 5.5, Opus 5 ve Fable 5.1 Karşılaştırması: Benchmark Sonuçları Ne Söylüyor?

Anthropic'in duyuru sayfasındaki tablodan seçtiğim satırlar. Rakamlar resmi sayfada verildiği gibi; kendi ölçümüm değil.

Benchmark Opus 5.5 Fable 5.1 Opus 5
Terminal-Bench 4.0%66,4%55,8%52,3
FrontierCode v1.1%54,4%50,3%48,0
CursorBench 4.0%57,8%51,8%46,6
GDPval-AA v2.11846 Elo1735 Elo1708 Elo
AutomationBench%40,0%31,4%26,9
Humanity's Last Exam (araçlı)%67,7%65,6%63,6
OSWorld 2.0 (kısmi)%81,8%80,7%74,0
Chartography (araçlı)%89,0%88,4%83,4

Terminal-Bench ve CursorBench'teki sıçrama, modelin neden "ajan tabanlı kodlama" için konumlandırıldığını açıklıyor. Ancak dokümantasyon Fable 5.1'i hâlâ "zorlu akıl yürütme ve uzun ufuklu ajan işleri" için öneriyor; models overview sayfasındaki tavsiye şu: çoğu iş yükü için Opus 5.5 ile başlayın, kendi değerlendirmeleriniz yüksek effort'ta bile yetersiz kalırsa Fable 5.1'e geçin. Fable 5.1'in fiyatı 10 $ / 50 $, yani Opus 5.5'in iki buçuk katı; gecikmesi de "daha yavaş" olarak sınıflandırılıyor.

Güvenlik tarafında duyuru, Opus 5.5'in otomatik davranış denetiminde "bugüne kadar test ettiğimiz en güçlü performansa sahip model" olduğunu, geri alınması zor eylemlere önceki modellerden çok daha az yöneldiğini, prompt injection'a daha dirençli olduğunu ve containment sınırlarını aşma girişimlerinin yüzde 85 azaldığını belirtiyor. Biyoloji ve siber güvenlik alanlarında Fable 5.1 ile benzer koruma önlemleriyle dağıtılıyor; bunun pratik sonuçlarına aşağıda "Güvenlik sınıflandırıcıları" bölümünde döneceğim.

Fiyatlandırma: Opus 5'e Göre Ne Kadar Ucuzladı?

Liste fiyatları resmi pricing sayfasından. Asıl dikkat çeken satır cache okuması: standart modellerde cache hit temel girdi fiyatının yüzde 10'udur, Opus 5.5'te ise yüzde 5'e indirildi.

Kalem (milyon token) Opus 5.5 Opus 5 Değişim
Girdi4 $5 $−%20
Çıktı20 $25 $−%20
5 dakikalık cache yazma5 $6,25 $−%20
1 saatlik cache yazma8 $10 $−%20
Cache okuma0,20 $0,50 $−%60
Batch API (girdi / çıktı)2 $ / 10 $2,50 $ / 12,50 $−%20
Fast mode (girdi / çıktı)8 $ / 40 $10 $ / 50 $−%20

Cache okumasındaki yüzde 60'lık indirim, Claude Code gibi her turda aynı uzun prefix'i (sistem promptu, CLAUDE.md, araç tanımları, konuşma geçmişi) tekrar gönderen ajan döngülerinde en çok hissedilecek kalem. Somut bir örnek: bir turda 200 bin token girdi olsun, bunun 150 bini cache'den okunsun, çıktı 20 bin token olsun. Opus 5'te maliyet 50 bin × 5 $ + 150 bin × 0,50 $ + 20 bin × 25 $ = 0,25 + 0,075 + 0,50 = 0,825 $. Opus 5.5'te 50 bin × 4 $ + 150 bin × 0,20 $ + 20 bin × 20 $ = 0,20 + 0,03 + 0,40 = 0,63 $. Yalnızca liste fiyatıyla yüzde 24 tasarruf; modelin daha az token harcadığı iddiasını da eklediğinizde Anthropic'in yüzde 40 rakamına yaklaşıyorsunuz. Cache'in Claude Code'daki yerini merak ediyorsanız maliyet ve context yönetimi rehberinde /cost ve /context komutlarını ayrıntılı anlatmıştım.

Diğer fiyat notları: 1M token bağlam penceresi standart fiyata dahil, 200K üzeri istekler için uzun bağlam primi yok. Batch API yüzde 50 indirimli ve prompt cache çarpanlarıyla birlikte kullanılabiliyor.

Claude Code'da Opus 5.5: Hangi Sürüm, Hangi Plan, Hangi Alias?

Claude Code'un 2.1.280 sürüm notu Opus 5.5 ile ilgili dört değişiklik listeliyor:

  • Claude Opus 5.5 (claude-opus-5-5) eklendi ve varsayılan Opus modeli oldu: 1M bağlam, milyon token başına 4 $ / 20 $, cache okuması 0,20 $.
  • Pro ve Team Standard planlarının varsayılan modeli Sonnet'ten Opus'a taşındı; böylece Max, Team Premium ve Enterprise ile aynı davranışa geldiler.
  • /effort model başına kaydedilir hâle gelmeden önce kaydedilmiş bir effort seviyesi, Opus 5.5 gibi yeni modellere artık uygulanmıyor; siz seçene kadar model kendi varsayılanında başlıyor.
  • Opus 4.7, Opus 4.8 ve Fable 5, -p modunda veya Agent SDK'da, proje ya da yönetilen ayarlardaki effortLevel ve model başına seviye karşısında kendi lansman varsayılanlarını dayatmayı bıraktı.

İkinci madde Türkiye'deki çoğu bireysel kullanıcı için en somut değişiklik. Opus 5 çıktığında Pro ve Team Standard koltuklarının varsayılanı Sonnet 5'te kalmıştı; model yapılandırma belgesi artık Pro, Max, Team, Enterprise ve Anthropic API hesaplarının tamamı için varsayılanı Opus 5.5 olarak veriyor. Claude Platform on AWS, Amazon Bedrock ve Google Cloud Agent Platform'da da varsayılan Opus 5.5; yalnızca Microsoft Foundry Sonnet 4.5'te kalıyor.

Alias'lar hangi modele gidiyor?

opus alias'ı Anthropic API'de artık Opus 5.5'e çözümleniyor, ama bu her platformda aynı değil:

Sağlayıcı opus sonnet
Anthropic APIOpus 5.5Sonnet 5
Claude Platform on AWSOpus 5.5Sonnet 4.6
Amazon BedrockOpus 5.5Sonnet 4.5
Microsoft FoundryOpus 4.6Sonnet 4.5

Diğer alias'lar: best, Fable'ın kullanılabildiği hesaplarda Fable'ı, aksi hâlde Opus'u seçer; fable Fable 5.1'i; opusplan plan aşamasında Opus, uygulama aşamasında Sonnet kullanır; default ise sizin override'ınızı temizleyip hesap türünüzün varsayılanına döner. Opus 5.5 zaten 1M bağlamla çalıştığı için opus[1m] son eki bu modelde ek bir şey açmaz.

Modeli seçme ve sabitleme

Önce sürümünüzü güncelleyin; Opus 5.5 için en az 2.1.280 gerekir:

claude update
claude --version

Oturumu doğrudan Opus 5.5 ile başlatmak ya da oturum içinde geçmek için:

claude --model opus
claude --model claude-opus-5-5

# oturum icinde
/model opus
/model claude-opus-5-5
/status

Argümansız /model seçici açar; Enter seçimi yeni oturumlar için varsayılan olarak kaydeder, s tuşu yalnızca o oturuma uygular (2.1.257 ve üzeri). Kalıcı ayar için ~/.claude/settings.json:

{
    "model": "claude-opus-5-5",
    "modelSettings": {
        "opus": { "effort": "medium" }
    }
}

Öncelik sırası şöyle: oturum içi /model, başlangıçtaki --model, ANTHROPIC_MODEL ortam değişkeni, ayar dosyasındaki model alanı ve yalnızca yeni oturumların varsayılanını belirleyen ANTHROPIC_DEFAULT_MODEL (2.1.236 ve üzeri). Enterprise yöneticileri claude.ai admin konsolundan organizasyon varsayılanı belirleyebilir; bu durumda /model içindeki Default seçeneği "Org default" etiketiyle görünür, ama --model ve ayar dosyası onu yine ezer. Bedrock'ta belirli bir kimliği zorlamak için (Foundry'de aynı değişkene o platformun kimliği olan claude-opus-5-5 verilir):

export ANTHROPIC_DEFAULT_OPUS_MODEL='anthropic.claude-opus-5-5'

Effort: Varsayılan Neden medium ve Nasıl Kalibre Edilir?

Opus 5.5'in Opus 5'ten en çok sürpriz yaratacak davranış farkı, varsayılan effort'un high'dan medium'a inmesi. Effort belgesi bunu açıkça yazıyor: "effort alanını atlayan bir istek Opus 5'te olduğundan bir seviye aşağıda çalışır." Anthropic bunun bir gerileme olmadığını iddia ediyor, çünkü seviye adları modeller arasında aynı miktarda düşünmeye karşılık gelmiyor: Anthropic'in testlerinde medium effort'taki Opus 5.5, kodlama ve bilgi işi değerlendirmelerinde high effort'taki Opus 5'i daha az adım ve token ile yakalıyor ya da geçiyor; bazı kodlama değerlendirmelerinde low bile çok daha düşük maliyetle ona yaklaşıyor. Deloitte'un duyurudaki alıntısı da bu yönde: en düşük effort ayarında bile bilinen hataların yüzde 72'sini yakalamış.

Beş seviye ve Opus 5.5 için resmi öneriler:

Seviye Opus 5.5'te ne zaman
lowGecikmeye duyarlı, basit işler; subagent'lar; thinking kapalı çalışan eski entegrasyonların yeni başlangıç noktası
mediumVarsayılan. Kodlama ve bilgi işinde Opus 5'in high'ına denk; önce burada ölçün
highKalite kazancını ölçtüğünüz karmaşık akıl yürütme ve zor kodlama görevleri
xhigh30 dakikayı aşan, milyonlarca token bütçeli uzun ufuklu ajan işleri; tur başına belirgin biçimde daha fazla düşünür
maxToken harcamasında sınır olmayan en derin analiz; azalan getiri olasılığı yüksek

İki uyarı önemli. Birincisi, aynı seviyede Opus 5.5 tur başına Opus 5'ten daha fazla düşünme eğiliminde, özellikle xhigh ve max'ta; Opus 5 için seçtiğiniz seviyeyi olduğu gibi taşırsanız daha uzun turlar ve daha fazla çıktı token'ı beklemelisiniz. İkincisi, thinking token'ları size gösterilmese bile max_tokens sınırına ve çıktı faturasına dahil; prompting belgesi uzun ajan turları için 128.000, yani modelin maksimumunu tavsiye ediyor, migrasyon belgesi ise xhigh ve max için 64K'dan başlamayı öneriyor.

Claude Code'da seviye seçimi:

/effort            # etkilesimli slider
/effort medium     # dogrudan
/effort auto       # aktif model icin kaydedilmis seviyeyi temizle
claude --effort low -p "Bu dosyadaki TODO'lari listele"

Ayar dosyasında model başına modelSettings.opus.effort, tüm modeller için effortLevel, ortam değişkeni olarak CLAUDE_CODE_EFFORT_LEVEL kullanılır. Tek seferlik derin düşünme için prompt'a ultrathink kelimesini ekleyebilirsiniz; oturum ayarı değişmez. 2.1.280'deki değişikliği tekrar hatırlatayım: daha önce başka bir model için kaydettiğiniz effort artık Opus 5.5'e sızmıyor, siz /effort ile seçene kadar model medium'da başlıyor.

API tarafında effort output_config.effort ile gönderilir ve varsayılana eşit değer göndermek, alanı hiç göndermemekle aynı davranışı verir:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 4096,
    "output_config": {"effort": "medium"},
    "messages": [{"role": "user", "content": "Mikroservis ve monolit mimarilerin odunlesmelerini analiz et"}]
  }'

Üst düzey effort değerini istekler arasında değiştirmek prompt cache'i geçersiz kılar. Opus 5.5, Opus 5 ve Fable 5.1 ise mid-conversation-output-config-2026-07-01 beta başlığıyla mesaj başına effort değişikliğini destekler: boş içerikli bir role: "system" mesajına output_config.effort ekleyince yeni seviye sonraki kullanıcı turundan itibaren geçerli olur ve cache korunur.

Thinking Artık Kapatılamıyor: Ne Değişti?

Opus 5'te thinking varsayılan olarak açıktı ama high ve altındaki effort seviyelerinde thinking: {"type": "disabled"} ile kapatılabiliyordu. Opus 5.5'te bu kapı kapandı: hem disabled hem de elle bütçe veren {"type": "enabled", "budget_tokens": N} biçimi her effort seviyesinde 400 invalid_request_error döndürüyor. Hata mesajı da yolu gösteriyor:

"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

thinking alanını hiç göndermemek ya da {"type": "adaptive"} göndermek eşdeğer; beta başlığı gerekmiyor. Daha az düşünme istediğiniz yerde artık thinking'i kapatmak yerine effort'u düşürüyorsunuz. Bu değişikliğin yanıt gövdesine üç yansıması var:

  • Yanıtlar thinking bloğuyla başlayabilir. content[0].text gibi konuma göre okuyan kod ya da ilk content_block_start olayını metin sayan bir stream işleyicisi kırılır. Blokları type alanına göre seçin.
  • Thinking metni varsayılan olarak boş gelir. thinking.display varsayılanı "omitted"; blok yalnızca signature ile gelir. Okunabilir özet için display: "summarized" ayarlayın.
  • Araç çağrıları arasındaki notlar thinking bloğuna taşındı. Modelin iki araç çağrısı arasında yazdığı kısa "şunu buldum, şimdi şunu yapıyorum" notları artık text değil, ilerleme güncellemesi türünde thinking bloğu olarak dönüyor. Hata vermez, ama bu notları kullanıcıya akıtan bir arayüz araç çağrıları arasında sessizleşir. Çözüm thinking-display-updates-2026-08-18 beta başlığıyla display: "updates" ayarlamak; her notun kısa bir özeti gelir.

Ajan döngüsü yazıyorsanız ek bir kural: araç sonuçlarını geri gönderirken assistant mesajını aldığınız gibi, thinking blokları boş olsa bile eksiksiz ve değiştirmeden geri gönderin. Düzenlenmiş, yeniden sıralanmış ya da kısmen atılmış thinking blokları 400 ile reddedilir.

Claude Code kullanıcısıysanız bunlarla uğraşmanız gerekmiyor; istekleri Claude Code kuruyor. Model yapılandırma belgesi Opus 5.5 için thinking'in kapatılamadığını belirtiyor, 2.1.281 sürüm notu da Alt+T kısayolunun uyumsuz modellerde thinking'i kapatmayı teklif etmesinin düzeltildiğini yazıyor; düşünme miktarını /effort ile ayarlarsınız.

API'deki Dört Kırılma Değişikliği Nelerdir?

"What's new in Claude Opus 5.5" sayfası Opus 5'te çalışan kodu etkileyen dört kırılma değişikliği sayıyor. İlk üçü Fable 5.1'de de geçerli.

Değişiklik Opus 5'te Opus 5.5'te Ne yapmalı
Thinking kapatma disabled high ve altında kabul Her seviyede 400 thinking alanını kaldır, effort seç
Zorlanmış araç kullanımı tool_choice: any / tool kabul 400: tool_choice: type "tool" and "any" are not supported for this model. auto + strict: true ya da structured outputs; prompt'ta aracın ne zaman geçerli olduğunu söyle
Thinking bloklarının bağlanması Model bağlaması yok Blok üreten modele ve konuşma prefix'ine bağlı Konuşmayı yalnızca sona ekleyerek büyüt; mid-conversation system message kullan
computer_20251124 aracı Beta başlığıyla kabul Claude API ve Google Cloud'da 400 (Bedrock'ta çalışmaya devam ediyor) {"type": "computer_toolset_20260801"} kullan, ajan döngüsünü toolset'e göre güncelle

Migrasyon belgesi bunlara ek olarak her isteğin sağlaması gereken üç koşul daha listeliyor: temperature, top_p ve top_k ya hiç gönderilmemeli ya da varsayılanda bırakılmalı, aksi hâlde reddedilir; messages dizisi prefill edilmiş bir assistant turuyla bitemez; 1M bağlam için hiçbir beta başlığı gerekmez, eski modeller için gönderilen başlığın etkisi olmaz. Zorlanmış araç kullanımı değişikliği, JSON çıktı almak için tool_choice: {"type": "tool"} kalıbına dayanan pek çok eski entegrasyonu etkileyecek; resmi öneri şemayı structured outputs'a taşımak ya da auto ile birlikte strict tool use açmak.

Preserved Thinking: Thinking Blokları Neden Modele ve Konuşmaya Bağlı?

Anthropic'in Fable 5.1 ile tanıttığı ve duyuruda "damıtma karşıtı koruma" olarak adlandırdığı preserved thinking, Opus 5.5 ile birlikte Opus ailesine de geldi. Mekanizma şu: bir thinking ya da redacted_thinking bloğu sonraki bir istekte geri gönderildiğinde API, bloğun imzasında iki şeyi kontrol eder. Birincisi, isteği alan model bu bloğu okuyabiliyor mu? İkincisi, bloktan önce gelen her şey, yani üst düzey system prompt, tools dizisi ve önceki mesajlar, blok üretildiğindeki hâliyle aynı mı?

Model uyumluluğu resmi tabloya göre:

  • Opus 5.5, Opus 5 ile daha eski Opus, Sonnet ve Haiku modellerinin thinking bloklarını okur; Fable ve Mythos modellerininkini okumaz.
  • Claude API'de Fable 5.1 ve Mythos 5.1, Opus 5.5'in bloklarını okur; başka hiçbir model okumaz.
  • Opus 5'ten Opus 5.5'e ya da Opus 5.5'ten Fable 5.1'e geçen bir konuşma akıl yürütmesini korur. Opus 5.5'ten başka bir modele inen ya da Fable/Mythos'tan Opus 5.5'e gelen konuşma, geçişten sonraki turları önceki modelin akıl yürütmesi olmadan çalıştırır.

Okunamayan blokları API sessizce atar; istek başarılı olur, atılan bloklar faturalanmaz ve thinking-binding-controls-2026-08-01 beta başlığı gönderilirse atılanlar yanıtın input_transformations dizisinde raporlanır. Prefix kontrolü ise daha sert: 31 Ağustos 2026 00:00 UTC ve sonrasında açılan hesaplarda varsayılan olarak zorunlu ve bloktan önce bir şey değiştiyse istek 400 döner. Hata mesajı "The block is bound to a different conversation" cümlesini içerir ve genellikle neyin değiştiğini söyleyerek biter. Bloğu atmayı tercih ederseniz aynı beta başlığıyla thinking.block_binding.prefix_mismatch_behavior alanını "drop_block" yaparsınız; daha eski hesaplarda bu alanı vermek isteğe bağlı olarak kontrolü açar.

Neyin "düzenleme" sayıldığı önemli. Mesajları sona eklemek, cache_control işaretlerini taşımak ve sunucu taraflı compaction geçerli kalır. Önceki bir mesajı düzenlemek, eski bir tool_result'u yerinde kısaltmak, system string'ini değiştirmek ya da tools dizisine araç eklemek ise sonraki blokların tamamını geçersiz kılar. Her biri için resmi alternatif var: talimat değişikliği için mid-conversation system message, araç değişikliği için inline-tools-2026-09-15 başlığıyla tool_addition / tool_removal blokları, eski turları atmak için compact-2026-09-04 başlığıyla on-demand compaction.

Kimin bir şey değiştirmesi gerektiği de netleştirilmiş: isteklerinizi Claude Code, claude.ai, Claude Managed Agents ya da Claude Agent SDK kuruyorsa hiçbir şey yapmanıza gerek yok. Kendi ajan döngünüzü yazıyorsanız ve system prompt'u yeniden kuruyor, eski araç sonuçlarını yerinde kısaltıyor ya da konuşmanın bir kısmını istemci tarafında özetleyip son turları olduğu gibi tutuyorsanız entegrasyonunuzu gözden geçirmelisiniz. Test yöntemi basit: beta başlığını block_binding olmadan gönderin; her yanıttaki input_transformations boş dönüyorsa prefix'iniz sağlam demektir.

Fast Mode: Opus 5.5'te Hız ve Fiyat

Fast mode farklı bir model değil; aynı ağırlıkları daha hızlı bir çıkarım yapılandırmasıyla çalıştıran, araştırma önizlemesindeki bir özellik. Saniyedeki çıktı token'ını 2,5 kata kadar artırır, ilk token süresini değiştirmez, kalite ve yeteneklerde fark yaratmaz. Opus 5.5 ile fiyatı da indi: milyon token başına 8 $ girdi, 40 $ çıktı; Opus 5 ve Opus 4.8'de 10 $ / 50 $. Fast mode fiyatlandırması 200K üzerindeki isteklerde de aynı çarpanla devam eder, prompt cache ve data residency çarpanlarıyla üst üste biner.

Sınırlar: yalnızca Claude API'de (Managed Agents dahil), Amazon Bedrock, Claude Platform on AWS, Google Cloud ve Microsoft Foundry'de yok; Batch API ve Priority Tier ile birlikte kullanılamaz; Opus 4.7'de hata verir, Opus 4.6'da sessizce standart hızda çalışıp standart fiyattan faturalanır. Ayrı bir rate limit'i var, aşıldığında 429 ve retry-after başlığı döner. Hızlı ve standart istekler cache prefix'ini paylaşmaz; oturum ortasında geçiş cache kaybı demektir.

API'de:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: fast-mode-2026-02-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 4096,
    "speed": "fast",
    "messages": [{"role": "user", "content": "Bu modulu dependency injection kullanacak sekilde refactor et"}]
  }'

Yanıtın usage.speed alanı "fast" ya da "standard" olarak hangi hızın kullanıldığını söyler. Claude Code'da ise /fast komutu, Option+F (macOS) / Alt+F (Windows, Linux) kısayolu ya da ayar dosyasındaki "fastMode": true ile açılır; 2.1.281 sürüm notu fast mode'un rate limit'e takılan istekleri art arda yeniden denemesinin düzeltildiğini de belirtiyor.

Opus 5'ten Opus 5.5'e Geçiş: Adım Adım Migrasyon

Migrasyon belgesinin Opus 5 için verdiği liste, tüm başlangıç modelleri için ortak olan ilk grubun tamamı. Sırasıyla:

  1. Model kimliğini claude-opus-5-5 yapın.
  2. thinking: {"type": "disabled"} ve {"type": "enabled", ...} ayarlarını kaldırın; yerine bir effort seviyesi seçin.
  3. effort'u açıkça belirtin: varsayılan medium, Opus 5'te high idi.
  4. tool_choice türlerinden any ve tool'u auto + strict tool use ya da structured outputs ile değiştirin.
  5. Claude API veya Google Cloud'da computer use kullanıyorsanız computer_toolset_20260801'e geçin; Bedrock'ta computer_20251124 kalabilir.
  6. İçerik bloklarını type'a göre okuyun, thinking bloklarını araç döngüsünde değiştirmeden geri gönderin.
  7. Arayüzünüz araç çağrıları arasındaki metni gösteriyorsa display: "updates" (beta) ya da "summarized" ayarlayıp boş olmayan thinking bloklarını render edin.
  8. stop_reason: "refusal" için işleyici yazın ve fallback yapılandırın.
  9. Seçtiğiniz effort seviyesinde maliyet ve gecikmeyi yeniden ölçün.
  10. Thinking'i kapatmış bir kodunuz vardıysa max_tokens'ı gözden geçirin; xhigh ve max'ta 64K'dan başlayın.

Kod tarafında en basit değişiklik şu:

model = "claude-opus-5"    # Once
model = "claude-opus-5-5"  # Sonra

# Kaldirilacak:
thinking = {"type": "disabled"}
tool_choice = {"type": "tool", "name": "extract_json"}

# Yerine:
output_config = {"effort": "medium"}
tool_choice = {"type": "auto"}   # + arac tanimina strict: true

Bu işi elle yapmak istemiyorsanız migrasyon belgesinin önerdiği yol Claude Code'daki yerleşik Claude API skill'i:

/claude-api migrate this project to claude-opus-5-5

Skill model kimliği değişimini, kırılan parametre değişikliklerini, prefill'in yerine geçecek yapıyı ve hedef model için effort kalibrasyonunu kod tabanında uygular, ardından elle doğrulamanız gereken maddelerin listesini üretir. Dosyaları düzenlemeden önce kapsamı (tüm çalışma dizini, bir alt dizin ya da belirli dosya listesi) onaylatır; Bedrock ve Claude Platform on AWS istemcilerini algılayıp model kimliği biçimlerini o platforma göre ayarlar. Claude Managed Agents kullanıyorsanız model adını güncellemek dışında değişiklik gerekmiyor.

Opus 5.5 İçin Değişen Prompt Kalıpları

"Prompting Claude Opus 5.5" belgesi, mevcut Opus 5 promptlarının değişiklik olmadan iyi çalışması gerektiğini söylüyor; aşağıdakiler yalnızca belirli bir sorun gözlemlediğinizde uygulanacak düzeltmeler. Claude Code'da gündelik kullanım için prompt engineering rehberindeki genel ilkeler geçerliliğini koruyor.

Gözetimsiz ajan koşuları erken duruyorsa

Opus 5.5 çok parçalı uzun görevlerde kullanıcıyı bilgilendirmeye eğilimli ve bu güncellemelerin bazıları turu araç çağrısıyla değil metinle, yani stop_reason: "end_turn" ile bitiriyor. Böyle bir turu "görev bitti" sayan gözetimsiz bir döngü orada durur. Resmi öneri: metinle biten turu kanıt değil rapor olarak ele alın, görevin parçalarını modelin güncellediği bir kontrol listesinde tutun, açık maddeler varken tur biterse bunları adlandıran kısa bir kullanıcı mesajı gönderin ve aynı görevde iki üç otomatik devamdan sonra durun ki gerçekten takılan bir koşu incelenebilsin. Belgede system prompt'un sonuna eklenecek uzun bir "turunu nasıl bitirmemen gerektiğini" anlatan örnek paragraf da var; bunu oturumun ilk isteğinden itibaren ekleyin, çünkü sonradan eklemek system prompt'u değiştirir ve önceki thinking bloklarını geçersiz kılar.

Uzun turlar sessiz görünüyorsa

Dört kaldıraç: display: "updates" ile ilerleme notlarını almak; modelin kullanıcıya bir şeyi birebir iletmesi gerekiyorsa ilk istekten itibaren tanımlı basit bir "kullanıcıya mesaj gönder" aracı vermek; öngörülebilir güncellemeleri system prompt'ta istemek; sessizlik uzuyorsa birkaç sessiz adımdan sonra clear_at: "next_user_message" ile turn-scoped bir hatırlatma eklemek. Anthropic son yöntemin uzun sessiz aralığa sahip görev oranını maliyeti değiştirmeden yaklaşık yarıya indirdiğini bildiriyor.

Diğer kalıplar

  • Çok uygulamalı iş akışları: Model hızla işe koyulmaya eğilimli; e-posta, doküman, tablo ve CRM kayıtları arasında çalışan ajanlara "harekete geçmeden önce görevin açıkça anmadığı kaynaklar dahil ilgili olabilecek her şeyi listeleyip aç" diyen tek bir cümle, testlerde doğru tamamlanan görev sayısını belirgin biçimde artırmış.
  • Zaman sinyalleri: Çok ajanlı kurulumlarda her mesajın sonuna elapsed 340s / 1200s gibi bir bütçe satırı eklemek, ekiplerin işi paralelleştirip daha erken bitirmesini sağlıyor. Bütçe tavsiye niteliğinde, sert durdurma için kendi zaman aşımınızı tutun.
  • Sohbet uygulamaları: "Cevap vermeden önce dikkatlice düşün" tarzı satırları kaldırmayı düşünün; model ne kadar düşüneceğine kendisi karar veriyor ve testlerde bu satırın kaldırılması kalite kaybı olmadan yanıtları hızlandırmış.
  • Yapıştırılan metin: Kullanıcının başka yerden kopyaladığı içeriği aynı rastgele kimliği taşıyan <pasted_content id="ab12"> etiketleriyle sarıp system prompt'a bu etiketlerin anlamını açıklayan notu eklemek, içerikten gelen talimatlara direnci artırıyor. Etiketler düz metin olduğundan taklit edilebilir; tek koruma katmanı olarak görmeyin.
  • Görsel girdiler: Model yoğun grafikleri, diyagramları ve ekran görüntülerini araç olmadan çok daha doğru okuyor; Anthropic'in testinde en düşük effort'ta bile Opus 5'in en yüksek effort'undan daha doğru değer okumuş. Eski modeller için kurduğunuz görsel iskeleyi yeniden test edin.

Güvenlik Sınıflandırıcıları ve Refusal Yönetimi

Opus 5.5 üç sınıflandırıcıyla geliyor: siber güvenlik (Opus 5'te de vardı), biyoloji (Fable 5.1 ile aynı, Opus 5'ten geliyorsanız yeni) ve reasoning_extraction (yeni). Sonuncusu, modelin iç akıl yürütmesini yanıt metninde yeniden üretmeye zorlayan istekleri reddediyor. Pratik sonucu şu: thinking kapalıyken "akıl yürütmeni cevapta yaz" diye eklediğiniz talimatlar varsa kaldırın, display: "summarized" ile özetlenmiş thinking bloklarını okuyun. Kaynak kodda güvenlik açığı aramak serbest; yüksek riskli çift kullanımlı siber etkinlikler değil. Biyoloji sınıflandırıcısı gündelik sağlık ve eğitim sorularını etkilemiyor; yaşam bilimleri işi yapan organizasyonlar için Life Sciences Verification Program var.

Bir reddetme HTTP 200 ile döner; stop_reason: "refusal" ve politika alanını adlandıran bir stop_details nesnesi taşır. Sunucu taraflı fallback (fallbacks: "default", beta) isteği Anthropic'in o kategori için önerdiği modelde yeniden dener; reasoning_extraction reddetmeleri ise yeniden denenmeden size döner. Claude Code bu işi sizin için yapıyor: model yapılandırma belgesine göre Fable 5.1 ve Opus 5.5'te siber güvenlik reddetmesi Opus 4.8'e, biyoloji reddetmesi Opus 5'e otomatik geçişle karşılanıyor; bu davranışı ayar dosyasında "switchModelsOnFlag": false ile kapatabilirsiniz.

Gerçek Dünya Senaryosu: Bir Projeyi Opus 5.5 ile Uçtan Uca Çalıştırmak

Orta boy bir Node.js projesinde, Opus 5 ile high effort'ta çalışmaya alışkın bir geliştirici olduğunuzu varsayalım. Amaç, Opus 5.5'e geçerken maliyeti ölçmek ve kaliteden ödün vermediğinizden emin olmak.

1. Sürümü ve modeli doğrulayın.

claude update
claude --model opus
/status

/status çıktısında modelin Opus 5.5 olduğunu görmelisiniz. Daha önce Opus 5 için /effort high kaydettiyseniz endişelenmeyin; 2.1.280'den itibaren o kayıt Opus 5.5'e uygulanmıyor, oturum medium'da başlıyor.

2. Aynı görevi varsayılan effort'ta koşturun. Örneğin daha önce Opus 5'e verdiğiniz bir görevi seçin:

> src/auth altindaki JWT dogrulamasini refresh token destekleyecek sekilde genislet,
  mevcut testleri gecir, yeni davranis icin test ekle ve degisiklikleri ozetle.

Görev bitince /cost ile oturumun token dökümüne bakın. Karşılaştırmak istediğiniz üç şey: toplam çıktı token'ı (thinking dahil), tur/araç çağrısı sayısı ve cache okuma oranı. Anthropic'in vaadi, medium'daki Opus 5.5'in high'daki Opus 5'i daha az adımda yakalaması; bunu kendi projenizde doğrulamadan ekip ayarlarınızı değiştirmeyin.

3. Yalnızca gerekirse seviyeyi yükseltin. Test kapsamı eksik kaldıysa ya da model bir kenar durumu atladıysa /effort high ile aynı görevi tekrar koşturun. xhigh'a ancak ölçülebilir fark görürseniz çıkın; aynı seviyede Opus 5.5 zaten tur başına daha fazla düşünüyor.

4. Otomasyon ve subagent'lar için düşük effort'u ayırın. CI'da ya da script içinde çalışan görevlerde effort'u komut satırından sabitleyin; CLI ve otomasyon rehberinde anlattığım -p modu burada devreye girer:

claude -p --model claude-opus-5-5 --effort low \
  "Bu PR'daki degisikliklerin TODO ve FIXME notlarini tablo olarak listele"

Subagent'ların modelini ayrı tutmak için CLAUDE_CODE_SUBAGENT_MODEL ortam değişkeni var; keşif ve özet gibi işleri Sonnet 5 ya da Haiku 4.5'e vermek toplam maliyeti daha da düşürür.

5. Uzun bir refactor'da fast mode'u değerlendirin. Gecikmenin sizi beklettiği bir işte /fast ile hızı açın; fiyatın iki katına çıktığını ve cache prefix'inin sıfırlandığını unutmayın. Oturum başında karar verip aynı hızda kalmak en ekonomik yol.

6. API entegrasyonunuz varsa migrasyonu skill'e bırakın. Aynı oturumda /claude-api migrate this project to claude-opus-5-5 çalıştırın ve özellikle tool_choice ile thinking alanlarına dokunan dosyaları test edin.

Sıkça Sorulan Sorular

Claude Opus 5.5 ile Opus 5 arasındaki en önemli fark nedir?

Maliyet, davranış ve yetenek. Girdi 5 $'dan 4 $'a, çıktı 25 $'dan 20 $'a, cache okuması 0,50 $'dan 0,20 $'a indi; Anthropic tipik iş yüklerinde yüzde 40 daha düşük maliyet ve yüzde 30 daha hızlı çıktı bildiriyor. Varsayılan effort medium'a indi, thinking kapatılamıyor, araç çağrıları arasındaki notlar thinking bloğu olarak dönüyor. Terminal-Bench 4.0'da yüzde 52,3'ten yüzde 66,4'e çıkış var ve medium'daki Opus 5.5, high'daki Opus 5'i daha az token ile yakalıyor.

Claude Code'da Opus 5.5'i kullanmak için ne yapmam gerekiyor?

claude update ile 2.1.280 veya üzerine geçin. Anthropic API üzerinden giriş yapan Pro, Max, Team ve Enterprise hesaplarında zaten varsayılan; opus alias'ı Opus 5.5'e gider. /model opus, claude --model claude-opus-5-5 ya da ayar dosyasındaki model alanıyla seçin, /status ile doğrulayın. Bedrock ve Google Cloud'da alias da Opus 5.5'e çözümlenir; Foundry'de Opus 4.6'ya gittiği için ANTHROPIC_DEFAULT_OPUS_MODEL ile sabitleyin.

Opus 5.5'te thinking'i kapatabilir miyim?

Hayır. thinking: {"type": "disabled"} ve elle bütçe her seviyede 400 döndürür; alanı hiç göndermemek ya da adaptive göndermek eşdeğerdir. Düşünme derinliğini yalnızca output_config.effort kontrol eder; daha az düşünme için low'a çekin. Claude Code'da da aynı kural geçerli, Alt+T bu modelde thinking'i kapatmayı teklif etmez.

Opus 5'te çalışan API kodum Opus 5.5'te neden 400 hatası veriyor?

Dört kırılma değişikliğinden birine takılıyorsunuz: thinking kapatma, tool_choice any/tool, prefix'i değiştirilmiş thinking bloğu (31 Ağustos 2026 sonrası hesaplarda) ya da Claude API/Google Cloud'da computer_20251124. Ayrıca temperature, top_p, top_k ve assistant prefill de reddedilir. Claude Code'da /claude-api migrate this project to claude-opus-5-5 bu değişiklikleri otomatik uygular.

Opus 5.5'te hangi effort seviyesini kullanmalıyım?

Varsayılan medium ile başlayıp kendi değerlendirme setinizde seviyeleri karşılaştırın; Opus 5'ten taşıdığınız ayarı olduğu gibi kullanmayın. Seviye adları modeller arasında aynı düşünme miktarına karşılık gelmiyor; aynı seviyede Opus 5.5 tur başına daha çok düşünüyor, özellikle xhigh ve max'ta. Bu seviyeleri ölçülebilir kazanç için saklayın ve max_tokens'ı yüksek tutun.

Fast mode Opus 5.5'te ne kadar ve nerede çalışıyor?

8 $ / 40 $ (milyon girdi / çıktı token), çıktı hızı 2,5 kata kadar, kalite aynı. Yalnızca Claude API'de araştırma önizlemesi; Bedrock, Claude Platform on AWS, Google Cloud, Foundry ve Batch API'de yok. API'de speed: "fast" ve fast-mode-2026-02-01 başlığı; Claude Code'da /fast, Option+F / Alt+F ya da fastMode ayarı. Hız değiştirmek cache'i sıfırlar.

Özet

Claude Opus 5.5, 22 Eylül 2026'da yayınlandı ve Claude Code 2.1.280 ile Pro'dan Enterprise'a tüm claude.ai planlarının varsayılan modeli oldu. Liste fiyatı yüzde 20, cache okuması yüzde 60 düştü; Anthropic tipik iş yüklerinde yüzde 40 daha ucuz, yüzde 30 daha hızlı çıktı ve daha az adımda biten görevler vaat ediyor. Varsayılan effort medium; Opus 5'in high'ına denk kabul ediliyor ama kendi projenizde ölçmeden güvenmeyin. Thinking artık her istekte açık ve derinliği yalnızca effort belirliyor; API'de zorlanmış araç kullanımı, eski computer use aracı, sampling parametreleri ve prefill reddediliyor; thinking blokları preserved thinking ile modele ve konuşmaya bağlanıyor. Bu değişikliklerin hiçbiri Claude Code kullanıcısını kod yazmaya zorlamıyor; claude update, /model opus, /status ve /effort yeterli. API entegrasyonu olanlar için /claude-api migrate skill'i işin büyük kısmını üstleniyor. Opus 5'in temellerini Claude Opus 5 rehberinde, token ve cache maliyetlerini izlemeyi maliyet ve context yönetimi rehberinde, otomasyon senaryolarını da CLI ve otomasyon rehberinde bulabilirsiniz.

Bu yazı Ahmet Bilgiç tarafından ahmetbilgic.com için yazılmıştır. Diğer yazılar için: medium.com/@ahmet_bilgic07