Claude Sonnet 5.5 Rehberi: Yenilikler, Fiyat, Effort Kalibrasyonu, Kırılma Değişiklikleri ve Claude Code'da Kullanım

Q: Sonnet 5.5 ile Sonnet 5 arasında fiyat farkı var mı?

Yok. İki model de milyon girdi token'ı için 2 $, milyon çıktı token'ı için 10 $, önbellek okuması için 0,20 $ fiyatlandırılır; prompt caching ve Batch API oranları da aynıdır. Anthropic'in ölçümlerinde Sonnet 5.5 aynı işi daha az token'la bitirdiği için görev başına maliyet %30'a kadar düşer. Ayrıca 1M context standart fiyata dahildir, 200K üstü için ek ücret yoktur.

Q: Sonnet 5.5'te thinking'i kapatabilir miyim?

Claude Code'da hayır: Option+T / Alt+T anahtarı ve /config satırı bu modelde 'Thinking can't be turned off' gösterir; MAX_THINKING_TOKENS=0 ve alwaysThinkingEnabled: false etkisizdir. API'de thinking: {"type": "disabled"} 400 hatası verir; en düşük ayar thinking: {"type": "between_tools"} ile ön düşünmeyi kapatmaktır. between_tools yalnızca low, medium ve high effort'ta çalışır.

Q: Claude Code'da Sonnet 5.5 neden aniden Sonnet 5'e düştü?

Sonnet 5.5 güvenlik sınıflandırıcılarıyla çalışır. Bir istek siber güvenlik kategorisinde işaretlenirse Claude Code isteği Sonnet 5 üzerinde yeniden çalıştırır ve transkriptte bir bildirim gösterir; oturum fallback modelinde kalır, /model ile geri dönersiniz. Biyoloji işaretinde fallback yoktur, istek reddedilir. İlk istekte bile tetiklenebilir çünkü CLAUDE.md ve git durumu da gönderilir; claude --safe-mode ile özelleştirmelerin neden olup olmadığını test edebilirsiniz.

Q: Sonnet 5'ten Sonnet 5.5'e geçerken API kodumda ne kırılır?

Beş kırılma değişikliği var: thinking disabled yerine between_tools; tool_choice any/tool artık 400 verir (auto + strict: true kullanın); thinking blokları modele ve konuşmaya bağlı (Opus 5, Opus 5.5, Fable ve Mythos bloklarını okumaz); Claude API ve Google Cloud'da computer_20251124 yerine computer_toolset_20260801 gerekir; advisor tool Opus 4.8, Opus 4.7 ve Sonnet 5'i danışman kabul etmez. Ek olarak araç çağrıları arasındaki uzun notlar thinking bloğu olarak döner. Claude Code'da /claude-api migrate komutu geçişi otomatikleştirir.

Anthropic, 28 Eylül 2026'da Claude Sonnet 5.5'i yayımladı. Claude 5.5 ailesinin ikinci üyesi olan model, Sonnet 5'e göre yüzde 30'dan fazla hızlı çıktı üretiyor ve çoğu işte görev başına maliyeti yüzde 30'a kadar düşürüyor; fiyat etiketi ise değişmedi. Bu yazıda teknik özellikleri, Sonnet 5 ve Opus 5.5 ile benchmark karşılaştırmasını, yeniden kalibre edilen effort seviyelerini, API'deki beş kırılma değişikliğini, güvenlik sınıflandırıcılarının Claude Code'daki davranışını ve modeli günlük iş akışınıza yerleştirmeyi yalnızca resmi kaynaklara dayanarak anlatıyorum. Bir hafta önce çıkan Opus 5.5'i incelediğim Claude Opus 5.5 rehberi bu yazının tamamlayıcısı.

Claude Sonnet 5.5 Nedir ve Nerede Konumlanıyor?

Anthropic, Sonnet 5.5'i Opus 5.5'in "daha hızlı ve daha düşük maliyetli tamamlayıcısı" olarak tanımlıyor. Opus 5.5 dikkatli yargı gerektiren karmaşık işler için tasarlanırken Sonnet 5.5'in güçlü olduğu alanlar iyi tanımlanmış günlük görevler, hata düzeltme ve düzgün belge, sunum ve tablo üretimi. Ailenin üçüncü üyesi olan ve yüksek hacimli, maliyete duyarlı uygulamalar için tasarlanan Claude Haiku 5.5'in önümüzdeki haftalarda geleceği açıklandı; yani şu an için Haiku tarafında hâlâ Haiku 4.5 var.

Model kimliği claude-sonnet-5-5. 4.6 neslinden bu yana olduğu gibi kimlikte tarih eki yok ve bu tarihsiz kimlik kendi başına sabitlenmiş bir snapshot. Anthropic API dışında Amazon Bedrock (anthropic.claude-sonnet-5-5), Google Cloud, Microsoft Foundry ve Claude Platform on AWS üzerinde de aynı gün kullanıma açıldı. Sıfır veri saklama (zero data retention) seçeneği Opus 5.5 ve Sonnet 5'te olduğu gibi Sonnet 5.5 için de mevcut.

Teknik Özellikler: Context, Çıktı Limiti, Thinking ve Fiyat

Model sayfasındaki değerleri tek tabloda topluyorum:

Özellik	Claude Sonnet 5.5
API model kimliği	`claude-sonnet-5-5`
Bağlam penceresi	1 milyon token (tek seçenek; 200K varyantı yok)
Maksimum çıktı	128K token; Message Batches API'de `output-300k-2026-03-24` beta başlığıyla 300K
Thinking	Adaptive, varsayılan açık; en düşük ayar `between_tools`
Varsayılan effort	Claude API'de `high`; Claude Code ve Claude uygulamalarında `medium`
Fiyat	2 $ girdi / 10 $ çıktı (milyon token)
Prompt caching	5 dakikalık yazma 2,50 $, 1 saatlik yazma 4 $, okuma 0,20 $; en küçük önbelleklenebilir prompt 512 token
Batch API	Girdi ve çıktıda %50 indirim
Bilgi kesim tarihi	Haziran 2026 (eğitim verisi de Haziran 2026)
Yayın / emeklilik	28 Eylül 2026 / 28 Eylül 2027'den önce değil
Hız sınıfı	"Fast" (Opus 5.5 "Moderate", Haiku 4.5 "Fastest")

İki ayrıntı dikkat çekiyor. Birincisi, 1M bağlam penceresi standart fiyata dahil: 900 bin token'lık bir istek, 9 bin token'lık istekle aynı birim fiyattan faturalanıyor ve Opus 4.6 döneminin "200K üstü ek ücret" mantığı bu nesilde yok. İkincisi, temperature, top_p veya top_k parametrelerine varsayılan dışı bir değer vermek 400 hatası döndürüyor; Sonnet 5'ten gelen kodda bunlar yoksa zaten sorun yaşamazsınız.

Sonnet 5.5, Sonnet 5 ve Opus 5.5: Benchmark Sonuçları Ne Söylüyor?

Duyuru sayfasındaki tabloyu aktarıyorum. Dördüncü sütundaki GPT-6 Sol değerleri OpenAI'ın kendi raporladığı sayılardır; Terminal-Bench için GPT-6 Sol sonucu yayımlanmadığından Anthropic o satırda GPT-5.6 Sol'u kullandığını belirtiyor.

Değerlendirme	Sonnet 5.5	Sonnet 5	Opus 5.5	GPT-6 Sol
Terminal-Bench 4.0 (ajan tabanlı kodlama)	%70,6	%10,3	%66,4	—
FrontierCode 1.1 (Main)	%46,2 (Max) / %52,1 (Xhigh)	%42,4	%54,4	%49,3
CursorBench 4.0	%55,5	%34,1	%57,8	—
GDPval-AA v2.1 (bilgi işi)	1844 Elo	1449 Elo	1846 Elo	1487 Elo
AA-Briefcase v1.1 (bilgi işi)	1811 Elo	1359 Elo	1822 Elo	1483 Elo
Humanity's Last Exam (araçlı)	%64,5	%54,9	%67,7	—
OSWorld 2.1 (kısmi, bilgisayar kullanımı)	%80,1	%57,0	%81,8	—
Chartography (araçsız, grafik okuma)	%61,6	%15,6	%64,4	%53,6

Tablodan üç çıkarım yapılabilir:

Sonnet 5 ile arasındaki fark bir nesil farkı gibi. Terminal-Bench'te %10,3'ten %70,6'ya, Chartography'de %15,6'dan %61,6'ya sıçrama var. Anthropic bunu "bazı alanlarda dramatik" iyileşme olarak nitelendiriyor.
Opus 5.5 ile fark küçük, ama var. GDPval-AA'da iki puan, CursorBench'te 2,3 puan geride; Terminal-Bench'te ise önde. Anthropic buna rağmen Opus 5.5'in "sürekli yargı gerektiren karmaşık, açık uçlu işlerde açıkça daha güçlü" kaldığını vurguluyor.
FrontierCode'da Max effort, Xhigh'dan düşük. Dipnotta açıklanan nedeni ilginç: FrontierCode, insan düzenlemesi gerektirmeden birleştirilebilecek değişiklikleri ölçüyor ve kapsam dışı değişiklikleri cezalandırıyor. Max effort'ta Sonnet 5.5 daha sık Claude Code'un code-review skill'ini çalıştırmış; bu skill incelemeyi çok sayıda subagent'a dağıttığı için iki örnekte zaman aşımına ya da görev kapsamı dışında ek düzenlemelere yol açmış ve skor düşmüş.

Maliyet-skor eğrileri de önemli. Anthropic'e göre birçok benchmark'ta Low veya Medium effort'taki Sonnet 5.5, Sonnet 5'in en iyi skorunu görev başına yaklaşık onda bir maliyetle geçiyor; FrontierCode'da High effort'ta GPT-6 Sol'un en iyi skoruna yaklaşık beşte bir maliyetle ulaşıyor. Anthropic'in formülasyonu şöyle: Sonnet 5.5, Opus 5.5'i en iyi düşük effort ayarlarında tamamlıyor; yüksek ayarlarda ise benzer maliyetle benzer performans gösterebiliyor.

Fiyatlandırma: Sonnet 5 ile Aynı, Opus 5.5'in Yarısı

Sonnet 5.5'in fiyatı Sonnet 5 ile birebir aynı. Yüzde 30'luk tasarruf iddiası birim fiyattan değil, aynı işi daha az token'la bitirmesinden geliyor. Güncel model ailesinin tamamını yan yana koyarsak:

Model	Girdi / Çıktı (1M token)	Önbellek okuma	Bağlam	Fast mode
Claude Fable 5.1	10 $ / 50 $	Girdinin %2,5'i	1M	Yok
Claude Opus 5.5	4 $ / 20 $	Girdinin %5'i	1M	Var (8 $ / 40 $)
Claude Sonnet 5.5	2 $ / 10 $	0,20 $ (girdinin %10'u)	1M	Yok
Claude Haiku 4.5	1 $ / 5 $	Girdinin %10'u	200K	Yok

Fast mode satırı sık sorulan bir konuyu kapatıyor: Claude Code'daki /fast komutu Opus 5.5, Opus 5 ve Opus 4.8'e özel; Sonnet veya Haiku modellerinde fast mode yok. Batch API'de %50 indirimle Sonnet 5.5 toplu işlerde 1 $ / 5 $ seviyesine iniyor.

Claude Code'da Sonnet 5.5: Hangi Sürüm, Hangi Alias, Hangi Komut?

Claude Code tarafında Sonnet 5.5 desteği v2.1.284 ile geldi; sürüm notu modeli "Anthropic API'de artık varsayılan Sonnet modeli" olarak tanıtıyor. Eski bir sürümdeyseniz model isteği "Claude Code does not support this model" hatasıyla düşer; çözüm claude update.

Dikkat edilmesi gereken nokta şu: Sonnet 5.5 Claude Code'un varsayılan modeli değil. v2.1.280'den bu yana Pro, Max, Team, Enterprise ve Anthropic API hesaplarının tamamında varsayılan Opus 5.5. Sonnet 5.5 bir tercih; sonnet alias'ı üzerinden seçersiniz. Alias'ın hangi modele çözüldüğü sağlayıcıya göre değişir:

Sağlayıcı	`opus`	`sonnet`
Anthropic API	Opus 5.5	Sonnet 5.5
Claude Platform on AWS	Opus 5.5	Sonnet 4.6
Amazon Bedrock, Google Cloud Agent Platform	Opus 5.5	Sonnet 4.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5

Anthropic API dışındaki sağlayıcılarda sonnet hâlâ eski bir modele gidiyor. Bu ortamlarda Sonnet 5.5'i kullanmak için tam model adını yazmanız ya da ANTHROPIC_DEFAULT_SONNET_MODEL değişkenini sağlayıcınızın kimliğine sabitlemeniz gerekir. Model seçiminin öncelik sırası şöyle (ilk eşleşen kazanır):

# 1) Oturum içinde anında geçiş (Enter: varsayılan olarak kaydet, s: yalnızca bu oturum)
/model sonnet

# 2) Başlangıçta, yalnızca o oturum için
claude --model sonnet
claude --model claude-sonnet-5-5

# 3) Ortam değişkeni, yalnızca o oturum için
export ANTHROPIC_MODEL=sonnet

# 4) Ayar dosyası (~/.claude/settings.json), kalıcı
{ "model": "sonnet" }

# 5) Yeni oturumların varsayılanı (v2.1.236+), yukarıdakilerden hiçbiri ayarlı değilse
export ANTHROPIC_DEFAULT_MODEL=sonnet

# Bedrock / Google Cloud'da sonnet alias'ını Sonnet 5.5'e sabitlemek
export ANTHROPIC_DEFAULT_SONNET_MODEL='anthropic.claude-sonnet-5-5'   # Bedrock
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5-5'             # Google Cloud

/model ile yaptığınız seçim kullanıcı ayarlarınızdaki model alanına yazılır ve sonraki oturumlara taşınır; seçiciyi açıp satırın üzerinde s'ye basarsanız değişiklik yalnızca o oturumda kalır. Devam ettirilen (--resume) oturumlar transkript kaydedildiği andaki modeli korur; --model bayrağı ya da ANTHROPIC_MODEL bu korumayı ezer.

1M Context: Sonnet 5.5'te [1m] Eki Neden Gerekmiyor?

Opus 4.6 ve Sonnet 4.6 döneminde 1M pencereye ulaşmak için opus[1m] ya da sonnet[1m] varyantını seçmek, bazı planlarda da kullanım kredisi açmak gerekiyordu. Sonnet 5.5'te bu adımlar yok. Model yapılandırma belgesi şöyle diyor: Anthropic API'de Sonnet 5.5 ve Sonnet 5 her zaman 1M context ile çalışır; 200K varyantı, seçilecek bir [1m] eki ve herhangi bir planda kullanım kredisi gereksinimi yoktur. sonnet[1m] alias'ı bu modellerde etkisizdir. Pro plan da dahil.

Pencere dolmadan önce oturum otomatik sıkıştırılır (auto-compact); Sonnet 5.5 için varsayılan eşik yaklaşık 967K token. Daha erken sıkıştırma istiyorsanız CLAUDE_CODE_AUTO_COMPACT_WINDOW ile eşiği değiştirebilirsiniz. Kurumsal ortamda bağlamı 200K'da tutmak gerekiyorsa CLAUDE_CODE_DISABLE_1M_CONTEXT=1 her yerel 1M modelini 200K pencereye sabitler. Bir LLM gateway arkasında da Claude Code aynı 1M penceresini varsayar; gateway'iniz daha düşük bir sınır uyguluyorsa /autocompact 200k çalıştırın.

Uzun bağlamın maliyet tarafını yönetmek için maliyet ve context yönetimi rehberindeki /context ve /usage pratikleri Sonnet 5.5'te de aynen geçerli.

Effort Seviyeleri Neden Yeniden Kalibre Edildi ve Hangisini Seçmeli?

Sonnet 5.5 beş effort seviyesinin tamamını destekliyor: low, medium, high, xhigh, max. Ancak Anthropic açık bir uyarı yapıyor: seviyeler Sonnet 5'e göre yeniden kalibre edildi, aynı isimli seviye artık aynı miktarda düşünme üretmiyor. Sonnet 5'teki ayarınızı taşımak yerine kendi değerlendirmelerinizle yeni bir tarama yapmanız öneriliyor. Varsayılanlar da iki yüzeyde farklı: Claude Platform API'sinde high, Claude Code ve Claude uygulamalarında medium.

Resmi öneriler özetle şöyle:

Seviye	Sonnet 5.5'te ne zaman?
`low`	Sohbet ve gecikmeye duyarlı işler; her sonucu gözden geçirdiğiniz hızlı alışverişler. Düşünmeyi kısa tutar, bir değişikliği doğrulamayı atlayabilir.
`medium`	Claude Code'un varsayılanı. İyi tanımlanmış ajan tabanlı kodlama ve çok adımlı araç kullanımı için başlangıç noktası. Uzun görevlerde kullanıcıya danışmak için durma eğilimi biraz daha yüksek.
`high`	API varsayılanı. Daha zor veya uzun ajan görevleri; doğrulamanın önemli olduğu, uç durumların muhtemel olduğu işler.
`xhigh`	Yalnızca kendi ölçümlerinizde kalite kazancı gördüğünüz yerlerde. Düşünme ve yanıtlar belirgin uzar; `between_tools` bu seviyede kabul edilmez.
`max`	Kendi başına çalışmasını istediğiniz zor problemler. Görev sonrası kendi inceleme ve doğrulama turlarını başlatabilir, subagent açabilir; rutin işte gereksiz maliyet.

Claude Code effort'u şu sırayla çözer: önce açık bir seçim (CLAUDE_CODE_EFFORT_LEVEL, --effort ya da /effort), sonra ayarlarınız, en son modelin kendi varsayılanı. Opus 5.5'teki incelik burada da geçerli: kullanıcı ayar dosyanızdaki üst düzey effortLevel anahtarı Opus 5.5 ve sonrasında çıkan modeller için sayılmaz; bu modeller siz bir seviye seçene kadar kendi varsayılanlarında başlar. Claude Code seviyeyi model başına modelSettings altında kaydeder:

// ~/.claude/settings.json
{
  "model": "sonnet",
  "modelSettings": {
    "claude-sonnet-5-5": { "effort": "low" },
    "claude-opus-5-5":   { "effort": "medium" }
  }
}

# Oturum içinde kaydırıcı; Enter kalıcı, s yalnızca bu oturum (v2.1.257+)
/effort

# Doğrudan seviye
/effort high

# Kayıtlı seviyeyi temizle, modelin varsayılanına dön
/effort auto

# Başlangıçta tek oturum için
claude --model sonnet --effort high

# Tek bir tur için daha derin düşünme (effort ayarı değişmez)
"ultrathink: bu yarış koşulunun kök nedenini bul"

max seviyesini CLAUDE_CODE_EFFORT_LEVEL dışında bir yoldan seçerseniz yalnızca o oturuma uygulanır; ayar dosyalarındaki effortLevel ve modelSettings anahtarları max kabul etmez. Skill ve subagent frontmatter'ındaki effort alanı, o skill veya subagent çalışırken oturum seviyesini geçersiz kılar.

Thinking Kapatılamıyor: Claude Code'da Ne Görürsünüz?

Sonnet 5.5, Opus 5.5 ve Fable modelleri gibi her zaman adaptive thinking ile çalışır. Claude Code'da macOS'ta Option+T, Windows ve Linux'ta Alt+T kısayolu ve /config içindeki thinking satırı bu modellerde anahtar yerine "Thinking can't be turned off" uyarısını gösterir. Kayıtlı alwaysThinkingEnabled: false ya da MAX_THINKING_TOKENS=0 Sonnet 5.5'te etkisizdir; thinking'i kabul eden bir modele geçtiğinizde kayıtlı ayar yeniden devreye girer. Ne kadar düşüneceğine model, effort seviyesine bakarak adım adım kendisi karar verir.

Düşünme çıktısı varsayılan olarak katlanmış gelir; Ctrl+O ile ayrıntılı moda geçip görebilirsiniz. Tam özetler için ayarlara showThinkingSummaries: true ekleyin. Üretilen tüm thinking token'ları çıktı token'ı olarak faturalanır.

opusplan ve Subagent'lar: Opus 5.5 ile Sonnet 5.5'i Birlikte Kullanmak

Sonnet 5.5'in asıl değeri Opus 5.5 ile iş bölümünde ortaya çıkıyor. Claude Code'un opusplan alias'ı plan modunda opus'u, uygulama aşamasında sonnet'i kullanır. Anthropic API'de bu artık "Opus 5.5 planlar, Sonnet 5.5 yazar" demek. Her iki alias da yerel 1M modellere çözüldüğü için iki aşama da 1M pencerede koşar; eski modeller için gereken opusplan[1m] biçimine burada ihtiyaç kalmaz.

Subagent tarafında iki kol var. Ana konuşmanın modelini miras alan subagent'lar, siz /model ile geçiş yaptığınızda yeni modele geçer; Claude Code subagent'ın modelini başlatıldığı anda oturumun modelinden çözer. Özel bir subagent'ı küçük modelde tutmak için tanımına model alanı yazarsınız. Tüm subagent'ların varsayılanını ise CLAUDE_CODE_SUBAGENT_MODEL belirler:

# Ana oturum Opus 5.5'te kalsın, keşif ve test koşuları Sonnet 5.5'e gitsin
export CLAUDE_CODE_SUBAGENT_MODEL=sonnet
claude --model opus

# Ya da tek bir subagent tanımında (.claude/agents/explorer.md)
---
name: explorer
description: Kod tabanında dosya ve sembol arar, özet döner
model: sonnet
effort: low
tools: Read, Grep, Glob
---

Subagent mimarisinin ayrıntıları, kapsamlar ve frontmatter alanları için subagent rehberine bakabilirsiniz. Bir not: v2.1.284 sürüm notlarına göre Explore subagent'ı, oturum Claude Code'un tanımadığı bir model kimliğinde (örneğin proxy arkasındaki özel bir model) çalışıyorsa artık Opus'a geçmiyor, o modeli miras alıyor.

Güvenlik Sınıflandırıcıları ve Fallback: Sonnet 5.5 Neden Sonnet 5'e Düşer?

Sonnet 5.5, siber güvenlik yetenekleri Opus 5 düzeyine geldiği için Opus 5.5'tekine benzer siber güvenlik korumaları ve fallback mekanizmasıyla çıkan ilk Sonnet modeli. Yine ilk kez bir Sonnet modeli, akıl yürütme çıkarımını (reasoning extraction) engelleyen güvenlik sınıflandırıcılarıyla yayımlandı; Anthropic bunu sahte hesaplarla model yeteneklerini kopyalamaya çalışan "distillation" saldırılarına karşı önlem olarak açıklıyor. Biyoloji korumaları Sonnet 5 ile aynı. Anthropic'in ifadesiyle her iki koruma da dar bir yüksek riskli istek kümesini hedefliyor; rutin yazılım geliştirme ve yaşam bilimleri işlerinin çoğu etkilenmiyor.

Claude Code'daki davranış model yapılandırma belgesinde kategoriye göre tanımlı:

Siber güvenlik işareti: İstek Sonnet 5 üzerinde yeniden çalıştırılır ve transkriptte bir bildirim görünür. v2.1.284'ten itibaren bu bildirim neden tetiklendiğini açıklar ve prompt'u düzenleyip yeniden deneme seçeneği sunar.
Biyoloji işareti: Sonnet 5.5'in biyoloji fallback modeli yok; istek reddedilir.
Fallback sonrası: Oturum fallback modelinde kalır. Orijinal modele dönmek için /model çalıştırın.
Sormasını istemek: /config içinde "Switch models when a message is flagged" seçeneğini kapatın ya da switchModelsOnFlag: false ayarlayın. İşaretlenen istek oturumu durdurur, size "fallback modeline geç" veya "prompt'u düzenle ve aynı modelde yeniden dene" seçenekleri sunulur. Fallback modeli olmayan kategorilerde (Sonnet 5.5'te biyoloji) bu prompt gösterilmez, istek reddedilir.
Tetikleyiciyi bulmak: Fallback oturumun ilk isteğinde bile tetiklenebilir çünkü ilk istek CLAUDE.md içeriği ve git durumu gibi çalışma alanı bağlamını taşır. claude --safe-mode ile CLAUDE.md, skill, MCP sunucusu ve hook'ları devre dışı bırakıp özelleştirmelerin neden olup olmadığını test edebilirsiniz; git durumu ve dizin adları yine gönderilir.

Bedrock, Google Cloud Agent Platform ve Foundry'de model kimlikleri sağlayıcıya özel olduğu için fallback yalnızca Claude Code iki modeli de tanıyabildiğinde çalışır. Sonnet 5.5 için iki koşul var: bir Opus hedefi çözülmeli (ANTHROPIC_DEFAULT_OPUS_MODEL ya da listede bir Opus 4.8 girdisi) ve yeniden çalıştırma modeli ANTHROPIC_DEFAULT_SONNET_MODEL ile ya da listedeki bir Sonnet 5 girdisiyle sağlanmalı.

API tarafında ret, HTTP 200 ile stop_reason: "refusal" olarak döner ve stop_details beş kategoriden birini adlandırır: cyber, bio, frontier_llm (rakip model geliştirmeye yardım), reasoning_extraction (iç akıl yürütmeyi yanıt metninde yeniden üretme isteği) ve general_harms. Sunucu tarafı fallback (fallbacks: "default", beta, yalnızca Claude API) cyber ve frontier_llm retlerini Sonnet 5'te yeniden dener; diğer üç kategoriyi denemez. Meşru güvenlik araştırması yapanlar için Cyber Verification Program, yaşam bilimleri için Life Sciences Verification Program başvuru yolu olarak gösteriliyor.

API'deki Beş Kırılma Değişikliği Nelerdir?

Sonnet 5 üzerinde çalışan kodu Sonnet 5.5'e taşırken beş değişiklik isteğinizi kırabilir; bir altıncısı ise hata vermeden yanıtın biçimini değiştirir. Claude Code kullanıcısıysanız bunların çoğunu Claude Code sizin yerinize halleder; Agent SDK ya da doğrudan Messages API ile çalışıyorsanız tek tek gözden geçirmeniz gerekir.

Değişiklik	Sonnet 5'te	Sonnet 5.5'te
Thinking'i kapatma	`thinking: {"type": "disabled"}`	`disabled` 400 verir; `between_tools` kullanılır
Zorunlu araç kullanımı	`tool_choice` `any` / `tool` kabul	İkisi de 400 (token sayma ucunda da); `auto` + `strict: true`
Thinking blokları	Modeller arası taşınabilir	Modele ve konuşmaya bağlı; okunamayan bloklar sessizce düşürülür
Computer use	`computer_20251124`	Claude API ve Google Cloud'da `computer_toolset_20260801` zorunlu
Advisor tool	Opus 4.8 / 4.7 / Sonnet 5 danışman olabilir	Yalnızca Opus 5, Opus 5.5, Sonnet 5.5, Fable 5/5.1, Mythos 5/5.1
Araç çağrıları arası metin (biçim değişikliği)	`text` bloğu	Bir iki cümleden uzun notlar `thinking` bloğu

between_tools: Ön Düşünmeyi Kapatmanın Yeni Yolu

En çok uygulamayı etkileyecek değişiklik bu. Sonnet 5.5'te thinking alanı gönderilmeyen bir istek adaptive thinking ile çalışır. Thinking'i tamamen kapatmanın yolu yok; en düşük ayar between_tools: model yanıt vermeden önce düşünmez, yalnızca araç çağrıları arasında yazdığı kısa ilerleme notları thinking bloğu olarak gelir. Araç yoksa yanıt sadece metinden oluşur. Kurallar:

Tüm platformlarda beta başlığı olmadan çalışır; low, medium ve high effort'ta kabul edilir. xhigh veya max ile 400 döner.
Yanına başka alan almaz: display, budget_tokens veya block_binding ile birlikte 400 verir.
between_tools ile effort konuşma ortasında değiştirilemez; yürürlükteki seviyeden farklı bir mesaj bazlı output_config.effort 400 döner. Tur bazında effort değiştirmek istiyorsanız adaptive thinking kullanın.
Sunucu tarafı fallback ile Sonnet 5'e düşen bir between_tools isteği orada disabled olarak koşar.
Prompt'unuzda "düşünme" talimatı varsa kaldırın; between_tools ile bu tür talimatlar modelin görünür çıktıya iç XML etiketleri yazma olasılığını artırıyor.

# Önce (Sonnet 5)
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-sonnet-5",
    "max_tokens": 16000,
    "thinking": {"type": "disabled"},
    "output_config": {"effort": "xhigh"},
    "messages": [{"role": "user", "content": "..."}]
  }'

# Sonra (Sonnet 5.5): disabled -> between_tools, xhigh -> high
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-sonnet-5-5",
    "max_tokens": 16000,
    "thinking": {"type": "between_tools"},
    "output_config": {"effort": "high"},
    "messages": [{"role": "user", "content": "..."}]
  }'

Zorunlu Araç Kullanımı Yerine auto + strict

tool_choice ile belirli bir aracı zorlamak artık mümkün değil. Önerilen desen: tool_choice: {"type": "auto"} gönderip aracı strict: true ile işaretlemek, böylece çağrı geldiğinde girdinin şemaya uyması garanti olur. Model artık aracı çağırmadan da yanıt verebildiği için ne zaman kullanması gerektiğini prompt'ta söylemelisiniz. Bir istekte en fazla 20 strict araç olabilir; MCP, computer use ve browser use toolset girdileri strict kabul etmez. Amazon Bedrock'ta Sonnet 5.5 için structured outputs (dolayısıyla strict tool use) henüz yok; orada auto gönderip araç girdisini kendi kodunuzda doğrularsınız.

Thinking Blokları Artık Modele, Konuşmaya ve Hesaba Bağlı

Sonnet 5.5, Sonnet 5, Opus 4.8, Haiku 4.5 ve daha eski modellerin thinking bloklarını okur; Opus 5, Opus 5.5, Fable ve Mythos bloklarını okumaz. Okuyamadığı blokları API düşürür, istek 200 döner ve düşürülen bloklar faturalanmaz. Her Sonnet 5.5 thinking bloğu ayrıca öncesindeki konuşma üzerinden imzalanır; 31 Ağustos 2026 00:00 UTC ve sonrasında açılan hesaplarda önceki geçmişi düzenleyip bloğu yeniden göndermek 400 verir. Çözüm konuşmayı yalnızca ekleyerek (append-only) tutmak, değişiklikleri konuşma ortası sistem mesajlarıyla yapmak. Bloklar üretildikleri hesaba da bağlı; başka bir hesap gönderirse API bloğu sessizce düşürür. Duyuru bunun Claude Code'da oturum ortasında hesap değiştirmeyi de kapsadığını belirtiyor.

Araç Çağrıları Arasındaki Metin Sessizleşiyor

Sonnet 5.5, araç çağrıları arasında bir iki cümleden uzun notları ilerleme güncellemesi olan thinking bloğu olarak döndürür; kısa notlar text kalır. Varsayılan display: "omitted" altında bu blokların metni boş olduğu için yalnızca text bloklarını gösteren bir arayüz uzun bir ajan turunda sessiz kalır, hata vermez. Notları görmek için display alanını "updates" (beta, thinking-display-updates-2026-08-18 başlığı) ya da "summarized" yapın; her boş olmayan thinking bloğunu ardından gelen tool_use bloğundan önce gösterin. between_tools kullanıyorsanız notlar display olmadan metinleriyle gelir.

Geçişi Otomatikleştirmek: /claude-api migrate

Claude Code'daki yerleşik Claude API skill'i bu değişikliklerin çoğunu kod tabanınızda sizin için uygular:

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

Skill, model kimliği değişimini, kırılan parametre değişikliklerini, prefill yerine geçen kalıpları ve effort kalibrasyonunu uygular, elle doğrulanacak maddelerin listesini çıkarır. Dosyalara dokunmadan önce kapsamı (tüm çalışma dizini, alt dizin ya da dosya listesi) onaylatır; Bedrock ve Claude Platform on AWS istemcilerini algılayıp model kimliği biçimlerini ona göre ayarlar. Claude Managed Agents kullananlar için ise model adını güncellemek dışında değişiklik gerekmiyor.

Sonnet 5.5 ile Gelen Yeni API Özellikleri

Kırılma değişikliklerinin yanında Sonnet 5'te olmayan birkaç özellik Sonnet 5.5'e geldi:

Mesaj bazlı effort (beta): Konuşma ortasında output_config.effort değiştirmek prompt önbelleğini korur; üst düzey effort değerini istekler arasında değiştirmek ise önbelleği geçersiz kılar. Adaptive thinking gerektirir.
Konuşma ortası sistem mesajları ve araç değişiklikleri (araç değişikliği beta): Talimat ve araçları konuşmayı düzenlemeden değiştirmenin yolu.
Mesaj içinde araç tanımlama (beta, inline-tools-2026-09-15): Konuşma ortası sistem mesajındaki tool_addition bloğu tam bir araç tanımı taşıyabilir; önbelleği kaybetmeden araç ekleyip şema değiştirebilirsiniz.
İsteğe bağlı sıkıştırma (beta, compact-2026-09-04): Üst düzey compaction parametresi tüm konuşmayı özetleyen imzalı bir blok döndürür; sonraki istekte bu bloğu özetlenen mesajların yerine koyarsınız.
512 token'lık önbellek eşiği: En küçük önbelleklenebilir prompt Sonnet 5'teki 1.024'ten 512'ye indi.

Tokenizer Sonnet 5 ile aynı; aynı metin aynı token sayısını üretir.

Sonnet 5.5 İçin Prompt Kalıpları: Resmi Rehber Ne Öneriyor?

Anthropic'in "Prompting Claude Sonnet 5.5" rehberi mevcut Sonnet 5 prompt'larının değişiklik gerektirmeden iyi çalışmasını bekliyor; gözlemlediğiniz davranışa göre müdahale önerileri veriyor:

Erken danışma: low ve medium effort'ta model uzun kodlama görevlerinde iş bitmeden plan onaylatmak ya da kendi yanıtlayabileceği bir soruyu sormak için durabiliyor. İlk çare effort'u yükseltmek; ikincisi sistem prompt'una işi sonuna kadar götürmesini söyleyen bir paragraf eklemek. Bu paragraf riskli ya da geri alınamaz eylemlerle ilgili kendi kurallarınızın yerine geçmez.
İstenmeyen eklemeler: Model, depo konvansiyonlarına uyan test ve dokümantasyon ekleme eğiliminde; yalnızca istenen değişikliği istiyorsanız bunu açıkça söyleyin.
xhigh ve max'ta aşırı titizlik: Görev bitince kendi inceleme turlarını başlatabilir, subagent açabilir. Anthropic'in max effort testinde bu titizliği göreve yönlendiren bir sistem prompt'u, reviewer subagent'ları durdurup oturum maliyetini kalite değişmeden yaklaşık üçte bir düşürmüş.
Doğrulama: low effort'ta model bazen testi çalıştırmadan "tamamlandı" diyebiliyor (örneğin bağımlılıklar kurulu değilse). Sistem prompt'una test ya da build çıktısı olmadan iş bitti dememesini söyleyen bir paragraf eklemek, kalite değişmeden yüzeysel kontrolleri nadir hale getiriyor.
JSON isteyen akıl yürütme görevleri: Birkaç adım hesap gerektiren işlerde model özellikle low ve medium'da düşünmeden yanıt verebiliyor. Structured outputs kullanın ve sistem prompt'unun sonuna önce düşünmesini isteyen bir satır ekleyin. stop_reason: "max_tokens" dönen her yanıtı, geçerli JSON içerse bile başarısız sayıp yeniden deneyin.
Tur ortası kullanıcı mesajları: Model dolaylı prompt enjeksiyonuna direnmek için eğitildiği için, bir tool_result bloğunun içine konan gerçek kullanıcı mesajını enjeksiyon sanabiliyor. Kullanıcı metnini asla tool_result içine koymayın; aynı kullanıcı mesajının sonuna ayrı bir text bloğu olarak ekleyin.
Toleranslı araç adı eşleme: Model nadiren bir aracı yalnızca harf büyüklüğü farklı bir adla (bash yerine Bash) çağırabiliyor. Harness'iniz belirsizlik yoksa çağrıyı kabul etsin ya da is_error: true ile beklenen adı söylesin.
Refusal yönetimi: Prompt'unuz modelden akıl yürütmesini yanıtta göstermesini istiyorsa bu talimatı kaldırın; reasoning_extraction retlerine davetiye çıkarıyor. Akıl yürütmeyi display: "summarized" ile özetlenmiş thinking bloklarından okuyun.

Gerçek Dünya Senaryosu: Sonnet 5.5'i Günlük Akışa Yerleştirmek

Orta ölçekli bir TypeScript monorepo'sunda çalışan bir ekip düşünelim. Hedef: Opus 5.5'i yalnızca gerçekten yargı gerektiren işlere ayırıp günlük işi Sonnet 5.5'e vermek, maliyeti düşürürken kaliteyi korumak.

1. Varsayılanı belirleyin. Ekip, proje ayar dosyasında modeli sonnet yapmak yerine kişisel tercihe bırakıyor, ancak herkesin başlangıç noktası aynı olsun diye bir ortam değişkeni öneriyor:

# ~/.zshrc veya ~/.bashrc
export ANTHROPIC_DEFAULT_MODEL=sonnet
export CLAUDE_CODE_SUBAGENT_MODEL=sonnet

Böylece /model ile kayıtlı bir seçim ya da --model bayrağı yoksa yeni oturumlar Sonnet 5.5'te açılır ve /model seçicisindeki Default satırı "Set by ANTHROPIC_DEFAULT_MODEL" etiketini gösterir.

2. İyi tanımlı bir hatayı düzeltin. Bir issue'da yeniden üretim adımları net. Sonnet 5.5 varsayılan medium effort'ta çalışıyor:

claude "packages/api/src/auth/refresh.ts içindeki token yenileme hatasını düzelt.
Issue #412'deki yeniden üretim adımlarını kullan, ilgili testi çalıştır ve
test çıktısını göstermeden 'tamamlandı' deme."

Son cümle, resmi prompt rehberinin doğrulama önerisinin uygulanmış hali.

3. Zorlaşan noktada effort'u yükseltin. Hata bir yarış koşuluna dönüştü. /effort kaydırıcısında high seçip s ile yalnızca bu oturuma uygulamak, kayıtlı medium varsayılanına dokunmaz. Tek bir tur için prompt'a ultrathink eklemek de yeter.

4. Mimari karar için Opus'a geçin, uygulamayı Sonnet'e bırakın. Yenileme akışının yeniden tasarlanması gerekiyorsa /model opusplan ile plan modunda Opus 5.5'in planlamasını, plan onaylanınca uygulamanın Sonnet 5.5'e geçmesini sağlarsınız. İkisi de 1M pencerede koşar.

5. Keşfi ucuza yapın. CLAUDE_CODE_SUBAGENT_MODEL=sonnet sayesinde ana oturum Opus'ta olsa bile Claude'un açtığı keşif ve test subagent'ları Sonnet 5.5'te çalışır. Kod tabanı tarayan özel bir subagent için frontmatter'a effort: low eklemek maliyeti daha da düşürür.

6. Fallback'e hazırlıklı olun. Güvenlik modülünde bir istek siber güvenlik sınıflandırıcısına takılırsa Claude Code bildirimle birlikte Sonnet 5'e düşer. Kural: bildirimi oku, prompt'u düzenleyip yeniden dene ya da işi bitirip /model sonnet ile geri dön.

Sonnet 5.5 mi, Opus 5.5 mi? Karar Tablosu

Durum	Öneri	Gerekçe (resmi kaynak)
Kapsamı net hata düzeltme, küçük özellik	Sonnet 5.5, `medium`	Duyuru: "iyi tanımlanmış günlük görevler ve hata düzeltmede en güçlü"
Belge, sunum, tablo üretimi	Sonnet 5.5	Duyuru bunları Sonnet 5.5'in güçlü alanları arasında sayıyor
Hızlı iterasyon, kısa döngüler	Sonnet 5.5, `low`/`medium`	%30+ daha hızlı çıktı; düşük effort'ta onda bir maliyet
Açık uçlu, uzun soluklu, yargı gerektiren iş	Opus 5.5	Duyuru: Opus 5.5 "açıkça daha güçlü"; prompt rehberi: en zor uzun işler için Opus
Planlama Opus, uygulama Sonnet	`opusplan`	Model yapılandırma belgesi
Keşif, arama, test koşusu subagent'ları	Sonnet 5.5 (veya Haiku 4.5)	`CLAUDE_CODE_SUBAGENT_MODEL` / frontmatter `model`
Fast mode gereken canlı debug	Opus 5.5 + `/fast`	Fast mode yalnızca Opus modellerinde

Sorun Giderme

"Claude Code does not support this model": Sürümünüz 2.1.284'ten eski. claude update çalıştırın; Homebrew'da brew upgrade claude-code, WinGet'te winget upgrade Anthropic.ClaudeCode.
/model sonnet Bedrock'ta Sonnet 4.5 getiriyor: Beklenen davranış; ANTHROPIC_DEFAULT_SONNET_MODEL ile sağlayıcı kimliğini sabitleyin ya da tam model adını yazın.
Thinking anahtarı kayıp: Sonnet 5.5'te thinking kapatılamaz; /config satırı bunu açıkça yazar. Düşünme miktarını effort ile ayarlayın.
Yeni oturum beklediğim modelde açılmadı: s ile seçim, --model ve -p modundaki /model yalnızca o oturum içindir; proje veya yönetilen ayarlardaki model, kabuktaki ANTHROPIC_MODEL ve organizasyon varsayılanı her açılışta yeniden uygulanır.
API'de between_tools 400 veriyor: Effort xhigh/max'ta mı, yanında display veya budget_tokens var mı, mesaj bazlı farklı bir effort gönderiliyor mu kontrol edin.
Geçmişi düzenledikten sonra 400: Thinking blokları konuşmaya imzalı. 31 Ağustos 2026 sonrası hesaplarda konuşmayı yalnızca ekleyerek sürdürün, değişiklikleri konuşma ortası sistem mesajlarıyla yapın.

Sıkça Sorulan Sorular

Claude Code'da Sonnet 5.5 otomatik olarak mı geliyor?

Hayır. Pro, Max, Team, Enterprise ve Anthropic API hesaplarında Claude Code'un varsayılan modeli Opus 5.5. Sonnet 5.5 için /model sonnet çalıştırın ya da claude --model sonnet ile başlatın. sonnet alias'ının Sonnet 5.5'e çözülmesi için Claude Code v2.1.284 veya üstü gerekir; eski sürümde claude update.

Sonnet 5.5 ile Sonnet 5 arasında fiyat farkı var mı?

Yok. İki model de milyon girdi token'ı için 2 $, çıktı için 10 $, önbellek okuması için 0,20 $; prompt caching ve Batch API oranları da aynı. Anthropic'in ölçümlerinde Sonnet 5.5 aynı işi daha az token'la bitirdiği için görev başına maliyet %30'a kadar düşüyor. 1M context standart fiyata dahil, 200K üstü için ek ücret yok.

Sonnet 5.5'te thinking'i kapatabilir miyim?

Claude Code'da hayır: Option+T / Alt+T anahtarı ve /config satırı "Thinking can't be turned off" gösterir; MAX_THINKING_TOKENS=0 ve alwaysThinkingEnabled: false etkisizdir. API'de thinking: {"type": "disabled"} 400 verir; en düşük ayar thinking: {"type": "between_tools"} ile ön düşünmeyi kapatmaktır ve yalnızca low, medium, high effort'ta çalışır.

Claude Code'da Sonnet 5.5 neden aniden Sonnet 5'e düştü?

Sonnet 5.5 güvenlik sınıflandırıcılarıyla çalışır. İstek siber güvenlik kategorisinde işaretlenirse Claude Code onu Sonnet 5 üzerinde yeniden çalıştırır ve transkriptte bildirim gösterir; oturum fallback modelinde kalır, /model ile geri dönersiniz. Biyoloji işaretinde fallback yoktur, istek reddedilir. İlk istekte bile tetiklenebilir çünkü CLAUDE.md ve git durumu da gönderilir; claude --safe-mode ile özelleştirmelerin neden olup olmadığını test edin.

Sonnet 5.5'te varsayılan effort neden Claude Code'da medium, API'de high?

Anthropic, Claude Code ve Claude uygulamalarında varsayılanı medium, Claude Platform API'sinde high olarak belirledi. Seviyeler Sonnet 5'e göre yeniden kalibre edildiği için eski ayarınızı taşımamanız, kendi değerlendirmelerinizle yeni bir tarama yapmanız öneriliyor. Resmi öneri: ajan tabanlı kodlamada iyi tanımlı işler için medium, zor ve uzun işler için high; sohbet ve gecikmeye duyarlı işlerde medium veya low.

Sonnet 5'ten Sonnet 5.5'e geçerken API kodumda ne kırılır?

Beş kırılma değişikliği var: disabled yerine between_tools; tool_choice any/tool 400 verir (auto + strict: true kullanın); thinking blokları modele ve konuşmaya bağlı (Opus 5, Opus 5.5, Fable ve Mythos bloklarını okumaz); Claude API ve Google Cloud'da computer_20251124 yerine computer_toolset_20260801; advisor tool Opus 4.8, Opus 4.7 ve Sonnet 5'i danışman kabul etmez. Ek olarak araç çağrıları arasındaki uzun notlar thinking bloğu olarak döner. Claude Code'da /claude-api migrate geçişi otomatikleştirir.

Özet

Claude Sonnet 5.5, fiyatı değişmeden Sonnet 5'in çok üstüne çıkan, birçok benchmark'ta Opus 5.5'e birkaç puan yaklaşan ve bunu daha hızlı, daha az token'la yapan bir model. Claude Code'da v2.1.284 ile sonnet alias'ı üzerinden geliyor, ama varsayılan model Opus 5.5 olmaya devam ediyor; Sonnet 5.5 bilinçli bir tercih. 1M context ek adım gerektirmiyor, thinking kapatılmıyor, varsayılan effort Claude Code'da medium ve seviyeler yeniden kalibre edildiği için eski ayarlar taşınmamalı. Siber güvenlik sınıflandırıcısı tetiklenince Sonnet 5'e düşüyor; biyolojide fallback yok. API tarafında between_tools, zorunlu araç kullanımının kalkması, konuşmaya bağlı thinking blokları, computer use toolset'i ve advisor kısıtları beş kırılma değişikliğini oluşturuyor. En verimli kullanım kalıbı, Opus 5.5'i yargı gerektiren işlere ayırıp günlük kodlamayı, subagent'ları ve opusplan'ın uygulama aşamasını Sonnet 5.5'e bırakmak.

Devam okumaları için: ailenin diğer yarısını Claude Opus 5.5 rehberinde, Sonnet 5.5'i keşif ve test işlerinde çalıştırmanın altyapısını subagent rehberinde, 1M pencerenin maliyet yönetimini maliyet ve context yönetimi 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