Claude 4.5'te düşünme modu nasıl kullanılır?

Claude 4.5’te “Thinking mode” (ayrıca extended thinking, thinking veya thinking blocks olarak da adlandırılır), modelin nihai yanıtı vermeden önce içsel, adım adım akıl yürütme (“chain-of-thought”) üretmek için ayrı bütçelenmiş belirli sayıda token harcamasını söyleyen, açıkça yapılandırılabilir bir çalışma modudur. Çok adımlı akıl yürütme, karmaşık kodlama ve ajan tabanlı iş akışları ile araştırma görevlerindeki performansı artırmak üzere tasarlanmıştır; bunun karşılığında daha derin iç değerlendirme için gecikme ve token maliyeti artar. Claude 4.5 bu yeteneği Messages API düzeyinde açık parametrelerle (ör. thinking / budget_tokens veya bir effort/“interleaved-thinking” başlığı) sunar, daha sonra doğrulama veya araç kullanımı için thinking bloklarını korur ve isteğe bağlı olarak şifreler; ayrıca üretim iş yükleri kurarken yönetmeniz gereken önbellek ve token muhasebesi davranışları da getirir.

Claude 4.5 nedir? (Ve hangi modellere dikkat etmeliyim?)

Claude 4.5, Anthropic’in artımlı “4.5” güncellemeleri olarak yayımlanan en yeni Claude model setidir (örneğin Sonnet 4.5 ve Opus 4.5). Sonnet 4.5, çoğu geliştirici için zekâ, kodlama ve ajan performansı arasında en iyi denge olarak konumlandırılır; Opus 4.5 ise çok yüksek çaba gerektiren akıl yürütmeye odaklanır ve çok turlu devamlılığı iyileştirmek için thinking bloklarını korur. Her iki model de Claude’un extended thinking yeteneklerini destekler; ancak bazı davranışlar (ör. özetlenmiş thinking ile tam thinking) modele göre farklılık gösterir.

Claude 4.5’teki performans artışları, özellikle Sonnet 4.5’te, bir yapay zekânın gerçek dünyadaki GitHub sorunlarını çözme yeteneğini ölçen SWE-bench Verified kıyaslamasında en net şekilde görülür.

Bu sayılar, Claude 4.5’in yalnızca kod parçacıkları yazmada daha iyi olmadığını; aynı zamanda tüm dosya sistemlerinde gezinme ve insan müdahalesi olmadan otonom görevleri yürütme konusunda da belirgin şekilde daha yetenekli olduğunu gösterir.

Bu neden önemlidir?

• Kodlama ve ajanlar: Sonnet 4.5, gerçek dünya yazılım görevleri ve uzun ufuklu kodlama işlerinde güçlü ilerlemeler gösterir; bu da onu kod üretimi, kod düzenleme ve otonom ajan akışları için doğal bir tercih hâline getirir.
• Extended thinking ve bağlam: Claude 4.5 ailesi modelleri, çok büyük iç çalışma alanlarıyla (on binlerce token veya daha fazlası) akıl yürütecek şekilde tasarlanmıştır; bu da istemleri, token bütçelerini ve araç etkileşimlerini nasıl tasarladığınızı değiştirir.

Claude 4.5’te Thinking Mode nedir?

Thinking Mode (resmî adıyla "Extended Thinking"), modelin son çıktıyı vermeden önce kendi kendine “nasıl düşündüğünü göstermesine” olanak tanıyan bir yetenektir. Hemen bir yanıta bağlanan standart modellerin aksine, Claude 4.5 birden fazla hipotezi keşfetmek, mantığındaki olası hataları belirlemek ve stratejisini geliştirmek için özel bir akıl yürütme alanı kullanır.

Bir yanıtın anatomisi

Standart bir etkileşimde model bir istem alır ve yanıtı üretmeye başlar. Thinking Mode’da ise yanıt iki ayrı bloğa bölünür:

Thinking mode’un temel özellikleri

• İstekle etkinleştirme: Bunu açmak ve modele iç akıl yürütme için bir token bütçesi vermek üzere API çağrısında {"type":"enabled","budget_tokens":10000} gibi bir thinking nesnesi gönderirsiniz.
• Bütçeleme: budget_tokens, modelin iç akıl yürütme tokenlarını sınırlar. Daha fazla bütçe => daha derin akıl yürütme potansiyeli, ancak daha yüksek maliyet ve gecikme. Claude 4 modellerinde, yalnızca özetlenmiş bir görünüm alsanız bile thinking tokenları faturalandırılır.
• Özetleme ve sansürleme: Birçok Claude 4 modelinde kullanıcı, thinking içeriğinin özetlenmiş bir sürümünü görür; bazı iç akıl yürütmeler güvenlik sistemleri tarafından sansürlenebilir (şifrelenebilir) ve redacted_thinking olarak dönebilir.
• İmzalar ve doğrulama: Thinking blokları, API’ye thinking bloklarını geri gönderirken doğrulama için kullanılan opak bir signature içerir (özellikle araç kullanırken gereklidir). İmzayı opak kabul etmelisiniz — çözümlemeye çalışmayın.
• Araçlarla iç içe geçen thinking: Claude 4, thinking bloklarını araç yürütmeleriyle iç içe geçirebilir (bazı durumlarda beta ve bayrak tabanlıdır). Bu, ajan tabanlı işler için güçlüdür (aracı çalıştır, düşün, başka bir aracı çalıştır, vb.).

Uygulamalı örnekler ve en güncel parametreler için Anthropic’in Messages/Extended Thinking belgeleri temel başvuru kaynağıdır.

Messages API thinking içeriğini nasıl döndürür?

Özetlenmiş ve tam thinking; şifreleme ve imzalar

Farklı Claude model sürümleri thinking’i farklı şekilde ele alır: daha yeni Claude 4 modelleri (Sonnet/Opus 4.5 gibi) genellikle iç akıl yürütmenin özetlenmiş herkese açık bir görünümünü döndürür; tam çalışma alanı ise şifrelenmiş olabilir ve yalnızca bir signature alanı (veya sansürlenmiş bloklar) üzerinden kullanılabilir. Araçlar kullanıldığında (veya araç çağrıları arasında iç durumu korumanız gerektiğinde), thinking bloklarını API’ye geri göndermeniz veya belgelerde açıklanan imza mekanizmasını kullanmanız gerekir. Bu mekanizma, hassas iç akıl yürütmeyi korurken gerektiğinde düşünce sürecinin güvenli biçimde devam etmesini sağlar.

Pratik kullanım deseni

Araç kullanımı / devam: Sonraki isteğiniz aynı iç durumu sürdürmek zorundaysa (ör. araçlar thinking’e göre çalıştırıldıysa), API’yi tekrar çağırırken dönen thinking bloğunu veya imzayı ekleyin; böylece model şifreyi çözebilir ve kaldığı yerden devam edebilir.

İstek: thinking: {type: "enabled", budget_tokens: N} gönderin.

Yanıt: (a) özetlenmiş herkese açık çıktı, (b) şifrelenmiş bir signature veya redacted_thinking bloğu ya da (c) her ikisini birden alabilirsiniz.

CometAPI, Claude 4.5 API’sini resmî API fiyatının %20’si karşılığında sunar ve Anthropic Messages üzerinden de çağrılabilir. Başlamadan önce bir API anahtarı edinmeniz gerekir.

Örnek 1 — thinking’i etkinleştiren basit curl (streaming yok)

curl https://api.cometapi.com/v1/messages \
  -H "x-api-key: $CometAPI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 16000,
    "thinking": {
      "type": "enabled",
      "budget_tokens": 10000
    },
    "messages": [
      {"role": "user", "content": "CSV içe aktarmaları için sağlam bir veri doğrulama stratejisi tasarla, testleri ve kodu göster."}
    ]
  }'

Yanıt content blokları içerir. Her bloğu inceleyin ve son çıktı için text bloklarını tercih edin; thinking blokları modelin iç analiz özetini içerir.

Örnek 2 — Python: istek gönderme, thinking ve text bloklarını ayrıştırma

import os, requests

API_KEY = os.environ["CometAPI_API_KEY"]
URL = "https://api.cometapi.com/v1/messages"
HEADERS = {
    "x-api-key": API_KEY,
    "anthropic-version": "2023-06-01",
    "content-type": "application/json"
}

payload = {
    "model": "claude-sonnet-4-5",
    "max_tokens": 16000,
    "thinking": {"type": "enabled", "budget_tokens": 8000},
    "messages": [{"role": "user", "content": "Python’da property-based testing nasıl yapılır açıkla; örnek kod ekle."}]
}

r = requests.post(URL, headers=HEADERS, json=payload)
r.raise_for_status()
resp = r.json()

# Blokları ayrıştır
for block in resp.get("content", []):
    if block.get("type") == "thinking":
        thinking_summary = block.get("thinking")
        print("=== THINKING (özet) ===")
        print(thinking_summary[:1000])  # günlükler için kırp
        print("signature:", block.get("signature")[:64], "...")
    elif block.get("type") == "text":
        print("=== FINAL TEXT ===")
        print(block.get("text"))

Bu kod, özetlenmiş thinking’i ve nihai yanıtı çıkarır ve yazdırır. Çok turlu ajan akışlarında sürekliliği korumanız gerekiyorsa, değiştirilmemiş thinking bloklarını bir sonraki isteğin messages dizisine ekleyin (sonraki örneğe bakın).

Örnek 3 — çok turlu akışta thinking bloklarını yeniden kullanma (Python sözde kodu)

# İlk yanıttan sonra (yukarıdaki resp):
# Thinking bloğunu da içeren assistant mesajını konuşmaya geri ekle
assistant_message = {
  "role": "assistant",
  "content": resp["content"]  # ham content dizisini dahil et (thinking + text blokları içerir)
}

# Sonraki kullanıcı turu: takip sorusu sor ve önceki assistant mesajını dahil et
payload2 = {
  "model": "claude-opus-4-5",  # Opus, turlar arasında thinking bloklarını daha iyi korur
  "max_tokens": 20000,
  "thinking": {"type": "enabled", "budget_tokens": 12000},
  "messages": [
    {"role": "user", "content": "Şimdi doğrulama mantığını bir avro hattına uyarlayın."},
    assistant_message
  ]
}
r2 = requests.post(URL, headers=HEADERS, json=payload2)

Araçlarla entegre veya uzun ajan iş akışları yaparken tam ve değiştirilmemiş thinking bloklarını korumak kritik önemdedir. Opus 4.5, thinking bloklarının korunması ve önbelleğe alınması için daha iyi varsayılanlara sahiptir.

Thinking çıktılarını nasıl stream eder ve bir UI’da ilerlemeyi nasıl gösteririm?

Streaming için en iyi uygulamalar

• SDK’nin streaming uç noktalarını kullanın (Python/TypeScript SDK’larında stream yardımcıları vardır). Uzun süren veya yüksek bütçeli akıl yürütme işlerinde streaming, HTTP zaman aşımlarını önler ve model hesaplama yaparken kısmi metin almanızı sağlar. Tipik kod, text_stream (Python) üzerinde bir yineleyici veya JS’de olay ayrıştırma kullanır.
• Bazen iki aşamalı akış bekleyin: model önce görünür akıl yürütme parçaları üretebilir, ardından yanıtı sonlandırabilir. UI’nizi parçalı içeriği ve “thinking…” ile nihai yanıt durumlarını işleyecek şekilde tasarlayın.
• API, streaming sırasında bir signature_delta veya content_block_delta döndürürse, bunu yakalayın ve belirtimde gerektiği şekilde sonraki çağrılara ekleyin.

Bir UI’da ara akıl yürütme ilerlemesini göstermeniz gerekiyorsa, yanıtı stream edin. Sunucu, thinking_delta olaylarını ve ardından text_delta olaylarını yayımlar.

curl https://api.cometapi.com/v1/messages \
  --header "x-api-key: $CometAPI_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 16000,
    "stream": true,
    "thinking": { "type": "enabled", "budget_tokens": 8000 },
    "messages": [ { "role": "user", "content": "Başarısız olan bu birim testini ayıklayarak bana adım adım anlat ve düzeltmeler öner." } ]
  }'

Streaming yaparken content_block_start, content_block_delta (içinde thinking_delta ve text_delta bulunur) ve content_block_stop olaylarını sırayla işleyin. Bu şekilde modelin adım adım akıl yürütmesini gerçekleşirken gösterebilirsiniz.

Claude Code thinking mode ile nasıl etkileşir? (terminal + VS Code)

Claude Code, Messages API ve araç çalıştırıcılarıyla entegre etkileşimli, ajan tabanlı kodlama terminalidir. CLI/IDE deneyimi thinking’i iki şekilde sunar:

• Genel / oturum bazlı ayarlar: Claude Code, davranışı ayarlamak için bir /config ayar paneli sunar (ajanın izinleri nasıl istediği, thinking bloklarının korunup korunmadığı vb.). Kalıcı bir davranış değişikliği istiyorsanız ham JSON’u yeniden yazmak yerine bu arayüzü kullanın.
• Model seçimi ve CLI komutları: REPL’de etkin model olarak claude-sonnet-4-5 veya claude-opus-4-5 seçebilirsiniz; araçlar ve thinking davranışı da sonra Messages API semantiğini izler. CHANGELOG ve sürüm notları, bazı Opus 4.5 dağıtımlarında thinking’in artık varsayılan olarak etkin olduğunu ve thinking yapılandırmasının /config üzerinden sunulduğunu belirtir.

Claude Code’da pratik akış:

1. REPL’de bir proje başlatın.
2. Thinking ile ilgili bayrakları (koruma, ayrıntı düzeyi vb.) incelemek için /config kullanın.
3. Ajandan uzun bir görev çalıştırmasını isteyin — thinking içeriği üretecek ve gerekirse belirli bash adımlarını çalıştırmak için izin isteyecektir. Daha sonra kararları doğrulamanız veya yeniden yürütmeniz gerekiyorsa thinking bloklarını koruyun.

Kurulum ve ayar

Claude Code, Node.js gerektirir ve global olarak kurulabilir.

# Claude Code CLI’yi kur
npm install -g @anthropic/claude-code

# Kimlik doğrulama
claude-code --init

Terminalde thinking’i etkinleştirme

Claude Code, akıl yürütme derinliğini kontrol etmek için çeşitli bayraklar ve doğal dil tetikleyicileri destekler.

İpuçları:

• Ajanın alternatif uygulamaları keşfetmesini istediğinizde think/think harder kullanın.
• Claude Code araç çağrıları yaptığında (test çalıştırma, git işlemleri), CLI/ajan bunları döndürüyorsa thinking bloklarını koruyun; aksi takdirde ajan adımlar arasında bağlamı kaybedebilir.

İç içe geçen thinking ve blok korumanın faydaları

Gelişmiş ajan tabanlı iş akışları için Claude 4.5, çok turlu etkileşimleri ve araç kullanımını önemli ölçüde geliştiren iki beta özelliği tanıtır: Interleaved Thinking ve Thinking Block Preservation.

Interleaved Thinking (Beta)

Standart akıl yürütme, çıktıdan önce bir kez gerçekleşir. interleaved-thinking-2025-05-14 başlığı ile etkinleştirilen Interleaved Thinking, Claude’un araç çağrıları arasında “düşünmesine” olanak tanır.

Claude’un bir sunucuda hata ayıkladığını hayal edin:

1. Düşün: "Önce loglara bakmalıyım."
2. Araç Çağrısı: read_file(logs.txt)
3. Düşün: "Loglar bir veritabanı zaman aşımı gösteriyor. Şimdi bağlantı havuzu ayarlarını kontrol etmeliyim."
4. Araç Çağrısı: read_file(db_config.yml)

Bu “sürekli yansıma”, modelin araçlardan aldığı verilere göre stratejisini uyarlamasını sağlar; katı, önceden tanımlanmış bir planı körü körüne izlemek yerine.

Thinking Block Preservation

Özellikle araç kullanımını içeren çok turlu konuşmalarda, önceki thinking bloklarını API’ye geri geçirmek kritik önemdedir.

• Akıl yürütme sürekliliği: Claude önceki düşüncelerini aldığında, mantıksal yolculuğunun bağlamını korur.
• Opus 4.5 optimizasyonu: Claude Opus 4.5’te bu davranış otomatikleştirilmiştir. Model, önceki tüm thinking bloklarını varsayılan olarak bağlamında korur; böylece 30+ saat süren oturumlarda bile on tur önce neden belirli mimari kararlar verdiğini “unutmaz”.

Claude 4.5 ile THINKING mode kullanımı için en iyi uygulamalar

Görev için doğru modeli ve bütçeyi seçin:

Hız, maliyet ve güçlü kodlama yetenekleri arasında en iyi dengeye ihtiyaç duyduğunuz kodlama ve ajan iş akışları için Sonnet 4.5 kullanın; en derin akıl yürütme, en büyük bağlam pencereleri veya uzun otonom oturumlar çalıştırmayı planladığınız durumlar için Opus 4.5 kullanın. Her ikisi de extended thinking’i destekler. budget_tokens değerini görevin karmaşıklığıyla orantılı seçin (denemeler için küçük başlayın; yalnızca anlamlı kalite artışları gözlemlerseniz bütçeyi yükseltin).

Maliyet ve gecikmeyi izleyin ve kontrol edin

Gördüğünüz özetlenmiş çıktı için değil, Claude’un ürettiği tüm thinking tokenları için ücretlendirilirsiniz. Bu da, yalnızca kısa bir özet görseniz bile uzun iç değerlendirmelerin maliyeti artırdığı anlamına gelir. Token kullanımını izleyin ve üretime geçerken kademeli ayar yapmayı düşünün (örneğin: 2k → 8k → 32k).

Thinking bloklarını yalnızca gerektiğinde koruyun

Thinking blokları daha sonra doğrulama ve iç içe araç kullanımı için kriptografik olarak imzalanabilir ve saklanabilir. İş akışınız modelin önceki iç değerlendirmelerini korumasını gerçekten gerektirmiyorsa (örneğin bir ajan adımları yeniden çalıştıracak ve korunan gerekçelere ihtiyaç duyacaksa), her sonraki istekte thinking bloklarını yankılamaktan kaçının. Thinking’i her zaman korumak bağlam hacmini artırır ve token muhasebesini karmaşıklaştırabilir.

Thinking’i kullanıcılara ne zaman stream etmelisiniz?

Stream edilmiş thinking, geliştirici araçları ve eğitsel UI’lar için mükemmeldir (model düşünürken “çalışma devam ediyor” göstermek gibi). Güvenlik ve sansürlemeyi değerlendirmeden, üretime dönük tüketici uygulamalarının son kullanıcılarına ham thinking’i stream etmeyin: özetlenmiş thinking tam da bu nedenle vardır. Stream ederseniz, iç akıl yürütmeyi etiketleyen UI öğeleri sağlayın (ör. “Asistan akıl yürütmesi — dahili”) ve son kullanıcının özetlenmiş mi yoksa tam akıl yürütmeyi mi göreceğini kontrol edin.

Araç kullanımı ve iç içe geçirme

Thinking’i araçlarla (kod yürütme, web getirme, yerel süreçler) birleştirirken, modelin aynı tur içinde araç seçmesi, onları çalıştırması ve sonuçlar üzerinde akıl yürütmesi gerekiyorsa interleaved thinking tasarımını kullanın. İç içe geçirme karmaşıklığı artırır (ve özellik bayrakları gerektirebilir), ancak ajan tabanlı otomasyon için güçlüdür. Hangi thinking’i koruduğunuzu açıkça belirtin ve thinking etkin bir çalıştırmada modelin araç seçimini nasıl yaptığını test edin.

Pratik sorun giderme ve operasyonel notlar

Yaygın hatalar ve anlamları

• Geçersiz thinking + zorunlu araç seçimi: Thinking isterken aynı zamanda thinking ile uyumsuz belirli araç kullanım kiplerini zorlarsanız, API hata döndürür — tool_choice: {"type":"tool","name":"..."} ile thinking’i birlikte zorlamayın.
• Budget > max_tokens: İç içe thinking senaryolarında etkili token kuralları farklıdır — platform belgeleri budget_tokens değerinin ne zaman max_tokens değerini aşabileceğini açıklar. Büyük bütçeleri test etmeden önce “interleaved thinking” bölümünü dikkatle okuyun.
• İmza doğrulama: Daha sonraki çağrılar için thinking bloklarını koruyorsanız, API’nin bunların Claude’dan geldiğini doğrulayabilmesi için dönen signature değerini ekleyin; bu, kurcalamayı önler ve zinciri doğrulanabilir tutar.

Gözlemlenebilirlik ve enstrümantasyon

Şunları kaydedin: (1) model seçimi, (2) thinking.budget_tokens, (3) gerçek thinking token tüketimi (bunun için faturalandırılırsınız), (4) streaming gecikmeleri (ilk thinking_delta anına kadar geçen süre) ve (5) nihai text tokenları. Bu metrikleri kullanıcıya dönük akışlar için bütçeler ve SLO’lar oluşturmak amacıyla kullanın.

Kademeli yaygınlaştırma ve insan denetimi

Thinking etkin modelleri özellik bayraklarının arkasında kademeli olarak devreye alın. Önce geliştirici veya dahili trafiğin bir yüzdesiyle başlayın, hataları veya sansürlenmiş içerikleri toplayın ve istemleri ile bütçeleri yinelemeli olarak iyileştirin. Hassas alanlarda, önemli miktarda iç akıl yürütme içeren çıktılar yayımlanmadan önce insan incelemesi isteyin.

Hata ayıklama ipuçları

• Küçük başlayın: Düşük budget_tokens ile etkinleştirin ve artımlı iyileşmeleri anlamak için ölçeklendirin.
• Streaming’i açın ve modelin ne zaman thinking blokları ürettiğini anlamak için content_block_delta / imza olaylarını günlüğe kaydedin.
• Claude Code kullanıyorsanız: /config ve proje düzeyindeki ayarları kontrol edin; davranış beklenen varsayılanlarla eşleşmiyorsa Claude Code değişiklik günlüğüne bakın.

Sonuç:

Claude 4.5, Extended Thinking ve Claude Code CLI gücüyle birleştiğinde, IDE’nin icadından bu yana geliştirici üretkenliğindeki en önemli sıçramayı temsil eder. Modelin “nasıl düşündüğünü göstermesine” ve karmaşık problemler üzerinde derinlemesine değerlendirme yapmasına izin vererek Anthropic, “chatbot” döneminin ötesine geçmiş ve “ajan tabanlı” döneme adım atmıştır.

İster Messages API’yi özel bir geliştirici aracına entegre ediyor olun, ister günlük PR’larınızı yönetmek için Claude Code kullanıyor olun, Thinking Mode’a hâkim olmak kritiktir. Güven için gereken şeffaflığı ve mükemmellik için gereken akıl yürütme derinliğini sağlar.

Geliştiriciler, Claude 4.5 (Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5) modeline CometAPI üzerinden erişebilir. Başlamak için CometAPI üzerindeki model yeteneklerini Playground içinde inceleyin ve ayrıntılı talimatlar için API kılavuzuna başvurun. Erişmeden önce CometAPI’ye giriş yaptığınızdan ve API anahtarını aldığınızdan emin olun. CometAPI, entegrasyonunuza yardımcı olmak için resmî fiyattan çok daha düşük bir fiyat sunar.

Hazır mısınız?→ Claude 4.5 ücretsiz deneme!