Anthropic’in güncel nesli Claude 5 ailesidir. Yazıldığı sırada (Ekim 2026) en yetenekli, geniş erişimli model olan Claude Fable 5.1 ile Claude Opus 5.5, Claude Sonnet 5.5 ve Claude Haiku 5.5’ten oluşuyor. Hepsi aynı Messages API üzerinden çalışır; biri ile diğeri arasında geçmek çoğunlukla tek bir model kimliğini değiştirmek demektir. Yelpaze hızlı değişir: aşağıdaki tabloyu bir anlık görüntü sayın ve bütçe belirlemeden önce fiyatları ve kimlikleri resmi dokümantasyondan doğrulayın.
Güncel model yelpazesi
| Model | API kimliği | Girdi / çıktı, 1 milyon token başına $ | En uygun olduğu iş |
|---|---|---|---|
| Claude Fable 5.1 | claude-fable-5-1 | $10 / $50 | En zor akıl yürütme ve uzun otonom işler |
| Claude Opus 5.5 | claude-opus-5-5 | $4 / $20 | Ürün özellikleri ve kodlama için varsayılan |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | $2 / $10 | Hızlı günlük kodlama, ajanlar, kurumsal |
| Claude Haiku 5.5 | claude-haiku-5-5 | $0.10 / $0.50 | Ucuz yüksek hacimli adımlar |
Ürün özellikleri ve ajan tabanlı kodlama için varsayılan seçimim Claude Opus 5.5: güncel Opus, selefinden ucuz ve gerçek işlerin çoğu için yeterince güçlü. Claude Sonnet 5.5 hız ve hacim içindir: günlük kod yardımı, destek ajanları, kurumsal iş akışları. Claude Haiku 5.5 sınıflandırma, yönlendirme, veri çıkarma ve diğer ucuz yüksek hacimli adımlara uyar. Claude Fable 5.1 yüksek fiyatını yalnızca en zor akıl yürütme ve uzun süreli otonom işlerde hak eder. Yaygın desen: planlamayı güçlü bir model, çok sayıdaki küçük adımları daha ucuz bir model yapar. Kendi verinizle ölçün: doğru model, değerlendirme setinizi geçen en ucuz modeldir.
API’de neler değişti
Eski Claude modelleri için yazılmış kod yenilerinde bozulabilir. Asistan prefill’i kaldırıldı; biçimi yapılandırılmış çıktılarla veya net talimatlarla yönetin. temperature ve top_p gibi örnekleme parametreleri en yeni modellerin çoğunda reddedilir. Opus 5.5’te düşünme kapatılamaz; maliyet ve gecikmeyi effort ayarıyla yönetin ve Opus 5.5’in varsayılanının high değil medium olduğunu unutmayın. tool_choice ile belirli bir aracı zorlamak reddedilir; net bir talimat ve katı araç şemalarıyla auto kullanın. Son olarak güvenlik sınıflandırıcıları bir yanıtı refusal durma nedeniyle bitirebilir: içeriği okumadan önce her zaman stop_reason’ı kontrol edin ve bu durumda ürününüzün ne yapacağına karar verin.
API anahtarını oluşturmak ve korumak
API anahtarı, bir faturalandırma hesabına bağlı bir paroladır: elinde olan kişi paranızı harcayabilir ve prompt’larınızın içeriğini okuyabilir. Anahtarları Anthropic Console’da oluşturun, her ortama veya projeye ayrı bir workspace içinde kendi anahtarını verin, net adlandırın ve harcama limitleri koyun; böylece sızıntı ya da kontrolsüz döngünün bir tavanı olur. Hizmet başına bir anahtar, geri kalanı durdurmadan birini iptal edebilmek demektir.
Anahtar yalnızca sunucuda durmalıdır. Asla tarayıcı koduna, mobil uygulama paketine, herkese açık bir depoya veya NEXT_PUBLIC_ gibi herkese açık önekli bir değişkene koymayın. Next.js’te Claude’u bir route handler veya server action içinden çağırın, anahtarı ortamdan okuyun ve ön yüzün yalnızca kendi uç noktanızla konuşmasını sağlayın; o uç nokta kullanıcıyı doğrular, hız sınırı uygular ve istek boyutunu sınırlar. Resmi SDK ANTHROPIC_API_KEY’i ortamdan otomatik okur, böylece istemci kaynak kodda anahtar olmadan oluşturulabilir.
Yerelde anahtarı git tarafından yok sayılan bir .env.local dosyasında tutun, depoya yalnızca değerleri boş bir .env.example ekleyin. Üretimde imajın içindeki bir dosya yerine barındırıcınızın veya bulutunuzun gizli bilgi deposunu kullanın. Anahtarları günlüklerden, hata raporlarından ve ekran görüntülerinden uzak tutun, depoda gizli bilgi taramasını açın. Bir anahtar sızarsa hemen iptal edip yenisini oluşturun; commit’i silmek yetmez. Yerel çalışmada anahtarı elle yönetmek yerine Anthropic CLI ile oturum açabilirsiniz, bulut iş yüklerinde ise workload identity federation uzun ömürlü anahtarları tümüyle ortadan kaldırır.
Mantıklı bir ilk istek
Tek bir sunucu tarafı çağrıyla başlayın: model kimliği, cömert bir max_tokens ve uzun çıktılarda zaman aşımına düşmemek için akış (streaming). Her çağrının maliyetini görmek için yanıttaki usage alanlarını okuyun; aynı uzun sistem prompt’unu veya belgeleri tekrar gönderiyorsanız prompt caching ekleyin, çünkü önbellekten okuma normal girdinin çok küçük bir kısmına mal olur. Türlendirilmiş hata yönetimi kullanın; hız sınırları ve aşırı yük normaldir, SDK bazılarını zaten yeniden dener. İlk günden özellik başına token ve maliyeti kaydedin ki fatura sizi şaşırtmasın.
Claude’u ürününüze doğru anahtar yönetimi, değerlendirme ve maliyet kontrolüyle entegre etmek istiyorsanız görevi ve ana kısıtı bana gönderin.
Bir sonraki ürüne kalacak birini verin.
Başlamaya hazır mısınız? Bana yazın — hemen başlayabilir ve kalabilirim. İki haftalık devir değil, uzun vadeli iş birliği. Projenizi, gereksinimleri ve ilerlemenin en iyi yolunu konuşalım.