Claude Sonnet 4.7 ve Anthropic SDK 2026: Prompt Caching, Extended Thinking ve Tool Use Rehberi

Anthropic SDK Kurulumu (SDK Installation)

Python 3.10 ve üzeri bir ortamda Anthropic SDK tek komutla kurulur. Üretim sunucularımızda venv veya uv ile izole ortam tercih ediyoruz; küresel kurulum, bağımlılık çakışmalarına yol açabilir.

python3 -m venv .venv
source .venv/bin/activate
pip install -U anthropic

API anahtarı console.anthropic.com üzerinden alınır. Anahtarı asla kaynak koda gömme, .env dosyasında tut:

export ANTHROPIC_API_KEY="sk-ant-..."

İlk API Çağrısı (First API Call)

Claude Sonnet 4.7 ile temel bir mesaj çağrısı şu şekildedir. messages.create endpoint'i 2026 itibarıyla tüm yeni özelliklerin (caching, thinking, tools) ortak giriş noktasıdır.

from anthropic import Anthropic

client = Anthropic()

response = client.messages.create(
    model="claude-sonnet-4-7",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Alesta Web e-ticaret yazılımı nedir?"}
    ]
)

print(response.content[0].text)
print("Input tokens:", response.usage.input_tokens)
print("Output tokens:", response.usage.output_tokens)

Yanıt nesnesinin usage alanı her çağrıda token sayılarını döndürür. Bu sayılar üretim maliyet izlemesinde kritiktir.

Prompt Caching ile Maliyet Düşürme

Prompt caching, sistem prompt'u veya sabit bağlam bölümlerini Anthropic sunucularında 5 dakikaya kadar (genişletilebilir 1 saat) saklayan özelliktir. Cache hit durumunda input token maliyeti %90 oranında düşer.

response = client.messages.create(
    model="claude-sonnet-4-7",
    max_tokens=1024,
    system=[
        {
            "type": "text",
            "text": "Sen Alesta Web ekibinin Türkçe konuşan yazılım asistanısın..." * 500,
            "cache_control": {"type": "ephemeral"}
        }
    ],
    messages=[{"role": "user", "content": "Vue 3.6 nasıl kurulur?"}]
)

print("Cache creation tokens:", response.usage.cache_creation_input_tokens)
print("Cache read tokens:", response.usage.cache_read_input_tokens)

Cache stratejisi (caching strategy)

• Sabit içeriği başa koy: Sistem prompt'u → araç tanımları → konuşma geçmişi sırası önemlidir.
• Min 1024 token: Cache breakpoint en az 1024 input token'ı kapsamalıdır (Sonnet için).
• 4 breakpoint sınırı: Bir istekte en fazla 4 cache_control kullanılabilir.

Extended Thinking (Düşünen Mod)

Extended thinking, modelin yanıt üretmeden önce iç düşünme adımları çalıştırmasına izin verir. Karmaşık matematik, kod inceleme veya çok adımlı planlama için cevap kalitesi belirgin artar.

response = client.messages.create(
    model="claude-sonnet-4-7",
    max_tokens=8192,
    thinking={
        "type": "enabled",
        "budget_tokens": 4096
    },
    messages=[{"role": "user", "content": "Bu fonksiyondaki güvenlik açığını bul..."}]
)

for block in response.content:
    if block.type == "thinking":
        print("Düşünme:", block.thinking)
    elif block.type == "text":
        print("Yanıt:", block.text)

Düşünme blokları kullanıcıya gösterilebilir veya gizlenebilir; Alesta Web dahili araçlarımızda thinking bloklarını sadece debug modunda gösteriyoruz.

Tool Use (Araç Kullanımı)

Tool use, modelin harici fonksiyonları çağırmasına izin verir. 2026 itibarıyla Anthropic SDK paralel araç çağrılarını otomatik destekler.

tools = [{
    "name": "get_weather",
    "description": "Şehir için anlık hava durumunu döndürür",
    "input_schema": {
        "type": "object",
        "properties": {
            "city": {"type": "string"}
        },
        "required": ["city"]
    }
}]

response = client.messages.create(
    model="claude-sonnet-4-7",
    max_tokens=1024,
    tools=tools,
    messages=[{"role": "user", "content": "İstanbul'da hava nasıl?"}]
)

if response.stop_reason == "tool_use":
    for block in response.content:
        if block.type == "tool_use":
            print(f"Çağrılan araç: {block.name}, input: {block.input}")

1M Token Bağlam Penceresi (1M Context Window)

Claude Sonnet 4.7, 1 milyon token bağlam destekli sürümüyle (claude-sonnet-4-7[1m]) tüm bir kod tabanını veya yüzlerce sayfalık PDF'i tek istekte işleyebilir. Standart 200K bağlam yerine 1M kullanmak için model ID'ye [1m] eki gerekir.

Karşılaştırma tablosu (comparison table)

Sık Karşılaşılan Hatalar (Common Errors)

📚 Kaynaklar ve Referanslar / References

• Anthropic Resmi Dokümantasyon
• Prompt Caching Guide
• Extended Thinking Documentation
• Anthropic Python SDK (GitHub)