Claude API ucretsiz mi ve kredi sistemi nasil calisir?

Claude API'nin ücretsiz bir katmanı var mı?

Claude API'nin ücretsiz bir katmanı bulunmamaktadır. Aylık ücretsiz token kotası veya 0 USD karşılığında kullanılabilecek bir plan yoktur. Yeni bir hesap, API'yi test etmek için küçük bir miktar ücretsiz kredi alır; ancak Anthropic'in fiyatlandırma belgelerinde bu miktarın ne kadar olduğu belirtilmemektedir. Bu krediler tükendiğinde, istekler ücretli kredilerden veya diğer API kredi hibelerinden karşılanır. Eğer ayrıca bir Max, Ultra veya Team aboneliği için ödeme yapıyorsanız, bu planlar aşağıda belirtilen aylık bir API kredisi içerir. Yapay zeka güvenliği veya uyumluluğu üzerine araştırma yapıyorsanız, Anthropic'in Harici Araştırmacı Erişim Programı (External Researcher Access Program), Ekim 2026 itibarıyla onaylanan her başvuru sahibinin hesabına 1.000 USD değerinde API kredisi tanımlamaktadır. Anthropic, başvuruları her ayın ilk Pazartesi günü inceler ve reddedilen başvurulara geri dönüş yapmaz.

Doğrudan yanıt budur. Bu kılavuzun geri kalanı, bu durumdan yola çıkarak platformun hangi kısımlarının tamamen ücretsiz olduğu, bunun neden Claude uygulamalarındaki ücretsiz plandan farklı bir soru olduğu ve ilk programınızı çalıştırmanın en ucuz ve dürüst yolu hakkındadır.

Claude API hesabında neler ücretsizdir

Platformun bazı bölümleri için token ücreti alınmaz ve bu bölümler göründüklerinden daha önemlidir.

• Token sayımı. Token sayma uç noktası ücretsizdir. Mesaj oluşturma işleminden ayrı, kendine ait bir dakika başına istek limiti vardır; bu nedenle bir istemi (prompt) ölçmek, onu göndermek için ayrılan bütçeden harcama yapmaz.
• Konsolun kendisi. Bir organizasyon oluşturmak, kullanım sayfanızı okumak ve playground (eski adıyla Workbench) alanını açmak ücretsizdir. Playground üzerinde bir istem çalıştırmak standart bir API isteğidir; bu nedenle bu kısım, diğer tüm çağrılar gibi token üzerinden ücretlendirilir.
• Dosya işlemleri. Files API üzerinden dosya yüklemek, listelemek ve silmek ücretsizdir. Yalnızca bir dosyanın içeriği, girdi token'ı olarak bir isteğe dahil edildiğinde ücret ödersiniz.
• Web fetch. Web fetch aracı, konuşmaya dahil ettiği içeriklerin token maliyeti dışında ek bir ücret getirmez. Web araması ücretsiz değildir: Ekim 2026 itibarıyla 1.000 arama başına 10 USD olarak ücretlendirilir.
• Kod çalıştırma (belirli bir sınıra kadar). Her organizasyon, Ekim 2026 itibarıyla aylık 1.550 saat ücretsiz container süresine sahiptir; bu süreden sonra container başına saatlik 0.05 USD ücret uygulanır. Kod çalıştırma işlemi, 20260209 ve sonraki sürümlerinde web araması veya web fetch içeren isteklerde ek bir maliyet oluşturmaz.

Bunların hiçbiri ücretsiz bir katman (free tier) değildir. Bu durum, ölçümlemenin şeffaf olduğu anlamına gelir: altyapı için değil, yalnızca çıkarım (inference) için ücretlendirilirsiniz. Ücretsiz web fetch özelliği, kendisi de ücretsiz olan veri kaynaklarıyla iyi bir uyum sağlar ve anahtarsız bir piyasa verisi API'si üzerinden hisse senedi ve opsiyon analizi çalıştırmak, ödediğiniz tek şeyin getirilen verinin isteme dahil ettiği token'lar olduğu uygulamalı bir örnektir.

Ödeme yapmadan önce istem maliyetini hesaplama

Sayım işlemi ücretsiz olduğu için, bir isteğin boyutunu önceden öğrenebilirsiniz. Bu sayı bir tahmindir ve Anthropic belgelerine göre gerçek bir isteğin kullandığı token miktarı küçük farklılıklar gösterebilir. Bu uç nokta, SDK'ların kullandığı uç nokta ile aynıdır ve birkaç istisna dışında gerçek bir mesajla aynı gövdeyi kabul eder: web araması, web getirme veya kod yürütme gibi sunucu araçlarını, MCP bağlayıcısını veya URL ya da dosya kimliği ile iletilen görsel ve PDF'leri içeren istekleri reddeder; bu nedenle görsel ve PDF'leri saydırmak için base64 formatında gönderin.

Aşağıdaki örnek için bir çalışma alanına (workspace) tanımlanmış bir anahtar kullanın. Anahtarınız bir çalışma alanına tanımlı değilse, anthropic-workspace-id ile birlikte çalışma alanı kimliğini de gönderin; bu parametrenin atlanması invalid_request_error hatasıyla birlikte HTTP 400 yanıtı döndürür.

curl https://api.anthropic.com/v1/messages/count_tokens \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-haiku-4-5",
    "system": "You are a scientist",
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Başarılı bir yanıt, {"input_tokens": 14} gibi tek satırlık bir JSON verisidir. Bu değeri modelinizin girdi ücretiyle çarparak, isteği göndermeden önce girdi maliyetine dair yakın bir tahmin elde edebilirsiniz. Sayım işlemini gerçekten çağıracağınız model üzerinden yapın; çünkü Claude 4.7 ve sonraki modeller, Haiku 4.5 gibi eski modellere kıyasla aynı metin için yaklaşık %30 daha fazla token üretir. authentication_error ile birlikte HTTP 401 hatası alırsanız, anahtarın hatalı, iptal edilmiş veya süresi dolmuş olup olmadığını kontrol edin. Doğru sağlanan bir anahtar da süresi dolduktan sonra bu hatayı döndürür; süresini Console üzerinden kontrol edin ve yeni bir anahtar oluşturun, çünkü süresi dolan anahtarlar yeniden etkinleştirilemez. Anahtar doğru görünmesine rağmen çağrı hala kimlik doğrulaması yapmıyorsa veya Claude'a bir Anthropic anahtarı yerine Bedrock, Vertex ya da Foundry üzerinden erişiyorsanız, istemci kimlik doğrulaması yapmanın dört yolu her bir yöntemin ne beklediğini ve kimlik bilgilerinin nerede tutulması gerektiğini açıklar.

Bunun uygulama içi ücretsiz plandan neden farklı bir soru olduğu

İnsanlar her ikisini de aratır ancak bu iki konu birbiriyle neredeyse tamamen alakasızdır. Claude uygulamalarındaki ücretsiz plan, kredi kartı gerektirmeden uzun süre kullanabileceğiniz, değişken bir kullanım penceresiyle sınırlandırılmış gerçek bir üründür ve Claude ücretsiz katmanının gerçekte neleri içerdiği başlığı, neleri kapsadığını ve ne zaman sıfırlandığını açıklar. API ise arkasında böyle bir plan bulunmayan, ön ödemeli bir ölçüm sistemidir.

İnsanların kafasını karıştıran sonuç şudur: Çoğu planda abonelik ve API anahtarı ayrı cüzdanlardır. Pro için ödeme yapmak bir anahtara bakiye yüklemez ve API kredileri sohbet limitinizi artırmaz. Claude Code, bu ayrımın insanları en çok karıştırdığı yerdir çünkü her iki yöntemle de çalışabilir: Claude Code'un Pro planına dahil olup olmadığı konusu, hangi planların bunu kapsadığını ve ne zaman sessizce bir anahtar üzerinden ücretlendirmeye geçtiğini belirtir. Eğer hiç ödeme yapmamaya çalışmak yerine bu ikisi arasında bir seçim yapıyorsanız, Claude API maliyeti ile abonelik karşılaştırması gerçek iş yükleri üzerindeki hesaplamaları detaylandırır.

İki istisna mevcuttur. 7 Ekim 2026 tarihinden itibaren Max ve Team planları aylık API kredisi içermektedir. Ekim 2026 itibarıyla bu miktar Max planında 100$, eskiden Max 20x olarak bilinen Ultra planında ise 200$'dır. Team planında ise Standard koltuk başına 20$ veya Premium koltuk başına 100$ olup, havuzda toplanır ve 500$ ile sınırlandırılır. Bu krediyi, bir Console organizasyonunu bağlayarak talep edersiniz (yeni aboneler 7 gün beklemelidir) ve Claude Platform'a bir ödeme yöntemi eklemeniz gerekmez. Bu kredi; API'yi, Agent SDK'yı ve Managed Agents'ı kapsar ancak etkileşimli Claude Code'u kapsamaz. Ayrıca, bağlı Console organizasyonundan alınan bir API anahtarı ile kendiniz çalıştırdığınızda claude -p'i de kapsar; Claude Code GitHub Action, bir IDE eklentisi veya Claude masaüstü uygulaması tarafından başlatılan çalıştırmalar kapsama dahil değildir. Kullanılmayan krediler her fatura döneminin sonunda sona erer. Kredi harcandığında, ayrıca API kredisi satın almadığınız veya bir faturalandırma anlaşmanız bulunmadığı sürece bir sonraki kredi gelene kadar istekler durur. Free, Pro ve Enterprise planları bu krediyi almaz; bu nedenle sadece kredi için bir plan satın almadan önce Max planına yükseltme yapmadan önce nelerin değerlendirilmesi gerektiği konusunu okuyun. Diğer istisna ise koltuk başına fiyatlandırmayı standart API oranlarında ölçülen token kullanımıyla eşleştiren Claude Enterprise'dır ve Enterprise koltuk fiyatlandırmasının nasıl çalıştığı konusu, sayaç çalışmaya başlamadan önce koltuk minimumunun neleri karşıladığını açıklar.

Krediler tükendiğinde bir isteğin maliyeti

Bunlar, Ekim 2026 itibarıyla milyon token başına geçerli olan birinci taraf API ücretleridir.

[
  {
    "label": "Haiku 4.5",
    "input_usd": 1,
    "output_usd": 5
  },
  {
    "label": "Sonnet 5",
    "input_usd": 2,
    "output_usd": 10
  },
  {
    "label": "Opus 5",
    "input_usd": 5,
    "output_usd": 25
  }
]

Haiku 4.5, milyon girdi token'ı başına 1 dolar ve milyon çıktı token'ı başına 5 dolar faturalandırır. Opus 5, aynı hacimler için 5 ve 25 ücret alır; bu nedenle seçtiğiniz model, herhangi bir istem iyileştirmesi yapılmadan önce faturayı 5 katına çıkarabilir. Sonnet 5, başlangıç fiyatı olarak 2 dolar ve 10 dolar üzerinden piyasaya sürülmüştür ve Anthropic o günden bu yana bu fiyatı standart hale getirmiştir; dolayısıyla 1 Eylül 2026 için planlanan 3 dolar ve 15 dolara yükseliş gerçekleşmemiştir. Çıktı maliyeti, her bir modelde girdi maliyetinin beş katıdır ve bu sayfadaki en önemli bilgi budur: uzun bir sorudan ziyade, sohbet tarzında verilen bir yanıt daha maliyetlidir. hangi Claude modelini kullanmanız gerektiği konusu, bu modelleri işlenmiş bir görev üzerinde karşılaştırır. Fable 5, milyon girdi token'ı başına 10 dolar ve çıktı başına 50 dolar ile bu üç modelin de üzerindedir; bu nedenle bu ücretlerin gerçekte ne sağladığı konusunu, rutin bir işi ona yönlendirmeden önce netleştirmekte fayda vardır. Fiyat listesinde üç yeni model daha bulunmaktadır: Haiku 5.5, 100.000 token'a kadar olan istemler için milyon girdi token'ı başına 0,10 dolar ve çıktı başına 0,50 dolar; Sonnet 5.5, 2 dolar ve 10 dolar; Opus 5.5 ise 4 dolar ve 20 dolar faturalandırır.

Deneme yapmak için en uygun maliyetli gerçek yollar

Dört kaldıraç işin neredeyse tamamını yapar ve hiçbiri indirim gerektirmez.

• Testinizi geçen en küçük modelle başlayın. Sınıflandırma, ayıklama, etiketleme ve yönlendirme işlemleri nadiren bir sınır modeli (frontier model) gerektirir. Haiku 4.5, Opus 5'in fiyatının beşte biridir ve daha hızlı yanıt verir.
• max_tokens sınırını belirleyin. Bu, üretilen token'lar üzerinde kesin bir tavan değeridir ve çıktı, maliyetin pahalı olan yarısıdır. Tek kelimeyle yanıt veren bir sınıflandırıcı, 16.000 token'lık bir bütçeye sahip olmamalıdır.
• İstemin (prompt) asla değişmeyen kısmını önbelleğe alın. Bir önbellek okuması, çoğu modelde temel girdi fiyatının %10'una (Opus 5.5 ve Sonnet 5.5'te %5, Fable 5.1'de %2,5) mal olur ve beş dakikalık bir önbellek yazımı 1,25 kat maliyetlidir; bu nedenle önbellekleme, tek bir okumadan sonra kendini amorti eder. Önbellekleme bir önek eşleşmesidir (prefix match); bu, sabit metnin önce, değişken sorunun ise en sonda gelmesi gerektiği anlamına gelir. Aksi takdirde hiçbir eşleşme olmaz ve yazma maliyetini boşuna ödemiş olursunuz.
• Etkileşimli olmayan her şeyi toplu işleyin (batch). Message Batches API, hem girdi hem de çıktı maliyetlerinde %50 indirim sağlar ve çoğu toplu iş bir saat içinde tamamlanır. Gece çalışan işler, geriye dönük veri yüklemeleri ve değerlendirme süreçleri bu kapsamda yürütülmelidir.

İlk küçük uygulama için maliyet hesabı

Bir günlük özetleme betiğini ele alalım: 1.000 çağrı, her biri yaklaşık 800 girdi token'ı değerinde günlük satırı gönderiyor ve yaklaşık 200 token'lık özet alıyor. Bu, Haiku 4.5 üzerinde 800.000 girdi token'ı ve 200.000 çıktı token'ı anlamına gelir.

[
  {
    "label": "Standard rates",
    "cost_usd": "1.80"
  },
  {
    "label": "Same job on the Batch API",
    "cost_usd": "0.90"
  }
]

Hesaplama şu şekildedir: 1 dolar üzerinden 0,8 milyon girdi token'ı artı 5 dolar üzerinden 0,2 milyon çıktı token'ı; bu da toplamda 1.80 dolar eder. Aynı iş toplu (batch) olarak gönderildiğinde maliyet 0.90 olur. Başlangıç kredi bakiyesi bu ölçekteki birçok testi karşılar; ücretsiz katmanın bulunmaması, insanların beklediğinden çok daha sonra sorun yaratır. Kendi sunucunuzda tam bir izleme yolu için, bir VPS üzerinde ilk Claude API uygulamasını oluşturma rehberi; anahtar yönetimi, akış (streaming) ve hata yollarını kapsar.

Kullanım kademeleri birer tavan sınırdır, tahsisat değildir

API, her organizasyonu kullanım geçmişine ve hesap durumuna göre otomatik olarak bir kullanım kademesine yerleştirir. Kademeler Start, Build, Scale ve Custom olarak adlandırılır; her biri hız sınırlarını ve aylık harcama tavanını belirler. Ekim 2026 itibarıyla tavanlar Start için 500$, Build için 1.000$ ve Scale için 200.000$ seviyesindedir; Custom kademesinde ise herhangi bir tavan bulunmamaktadır. Yeni organizasyonlar ve kullanım geçmişi az olanlar, bu geçmiş oluşana kadar söz konusu sınırların altında kalan bir Evaluation kademesinde başlayabilir.

Bunu bir tahsisat değil, bir sınır olarak değerlendirin. Start kademesinde olmak, harcayabileceğiniz 500$'ınız olduğu anlamına gelmez. Bu, bir takvim ayı içerisinde 500$'dan fazla harcama yapamayacağınız ve bu tutara ulaşıldığında kullanımın bir sonraki aya kadar duracağı anlamına gelir. Ayrıca kademe tavanının altında kendi harcama sınırınızı da belirleyebilirsiniz. Bir karta bağlı her hesapta yapılması gereken ilk işlem budur; çünkü kontrolsüz bir döngü, para kaybetmenin token başına maliyetten çok daha yaygın bir yoludur.

Ücretsiz kullanım kesin bir gereklilikse ne yapılmalı

Bütçe kesinlikle sıfırsa ve öyle kalması gerekiyorsa, API yanlış araçtır ve farklı planlar arasında arayış yapmak bu durumu değiştirmez. Geriye iki dürüst seçenek kalır. Etkileşimli çalışmalar için Claude uygulamalarındaki ücretsiz planı kullanın; bu planın pencere bazlı sınırlandığını ve programlanabilir bir uç nokta sunmadığını kabul edin. Ya da kiraladığınız donanım üzerinde açık ağırlıklı bir model çalıştırın; bu, token başına ödenen faturayı kontrol edebildiğiniz bir sunucu faturasıyla değiştirir: LLM'i self-host etmek için VPS üzerinde Ollama çalıştırma rehberi, her model boyutunun ihtiyaç duyduğu bellek miktarını ve küçük modellerin gerçekte neler yapabildiğini açıklar. Eğer asıl kısıtlamanın para değil de kullanım penceresi olduğu ortaya çıkarsa, aylık 20 dolar karşılığında Claude Pro, uygulamalardaki bu sınırı birçok ilk API faturasından daha düşük bir maliyetle kaldırır. Ancak bu planla birlikte API anahtarı veya API kredisi verilmez. Claude'u kod içerisinden çağırmaya en yakın seçenek, Pro aboneliğine dahil olan ve aynı kullanım sınırları dahilinde claude -p ile etkileşimsiz çalışabilen Claude Code'dur. Bu 20 doların ödenmeye değer olup olmadığı, ücretsiz sınırın sizi ne sıklıkla durdurduğuna bağlıdır; Pro için karar rehberi bu durumu gerçek kullanım modelleri üzerinden analiz eder. Eğer tek bir sağlayıcı yerine farklı sağlayıcılar arasında karşılaştırma yapıyorsanız, Claude ve ChatGPT planlarının fiyat karşılaştırması her iki taraftaki ücretsiz ve ücretli katmanları bir arada sunar ve kodlama işleri için hangisinin daha ekonomik olduğunu gösterir. Eğer halihazırda ödediğiniz bir abonelik, sıfırlamaya çalıştığınız harcamanın bir parçasıysa, planı iptal etmek veya düşürmek, satın almış olduğunuz ayı korur ve bir sonraki ödemeyi durdurur.

Bu iki uç durum arasındaki her şey için pratik çözüm; bütçelenmiş bir anahtar, düşük bir harcama limiti, küçük bir model ve ilk günden itibaren etkinleştirilmiş prompt caching kullanmaktır.

FAQ

Claude API kullanımı ücretsiz mi?

Hayır. Ücretsiz bir katman veya aylık ücretsiz token kotası bulunmamaktadır. Yeni hesaplara API'yi test etmeleri için küçük miktarda ücretsiz kredi tanımlanır. Bu kredi tükendikten sonra istekler, ücretli kredilerden veya diğer API kredi hibelerinden düşülür. Buna, Claude Platformu üzerinde herhangi bir ödeme yöntemi gerektirmeyen Max, Ultra ve Team planlarına dahil aylık API kredileri ve Anthropic'in Harici Araştırmacı Erişim Programı kapsamında onaylı yapay zeka güvenliği ve uyum araştırmacılarının hesaplarına tanımlanan 1.000 dolarlık API kredisi dahildir. Platformun token sayma, dosya yükleme ve silme işlemleri ile web getirme aracının (getirdiği içeriğin tokenları hariç) kullanımı gibi bazı bölümleri ücretsizdir.

Claude API'ye kaydolduğumda ücretsiz kredi alıyor muyum?

Evet, küçük bir miktar tanımlanır ancak Anthropic'in fiyatlandırma belgelerinde bu rakam belirtilmemiştir. Bunu, üzerine bir sistem inşa edeceğiniz bir bütçe olarak değil, entegrasyonunuzun çalıştığını kanıtlamaya yetecek bir miktar olarak değerlendirin. Kurumsal değerlendirmeler için sağlanan genişletilmiş deneme kredileri otomatik olarak verilmez, Anthropic satış ekibi aracılığıyla ayarlanır.

Claude Pro veya Max aboneliği API erişimini kapsıyor mu?

Pro aboneliği kapsamaz, Max aboneliği ise artık belirli bir miktar içermektedir. Pro aboneliği ve API anahtarı ayrı ayrı faturalandırılır ve farklı şekillerde ölçülür: Pro, Claude uygulamaları ve Claude Code içindeki limitlerinizi artırır, bunun dışında bir işlevi yoktur. Ekim 2026 itibarıyla Max aboneliği aylık 100 dolar, Ultra aboneliği ise 200 dolar API kredisi içerir; bu krediyi bir Console organizasyonunu bağlayarak talep edebilirsiniz. Bu kredi API çağrılarını kapsar ancak etkileşimli Claude Code kullanımını kapsamaz, her fatura döneminde sona erer ve uygulamalardaki limitlerinizi değiştirmez. Bu kredinin ötesinde, bir API anahtarı ön ödemeli kredilerden düşülür ve dakika başına istek ve token bazında sınırlandırılır.

Claude API'yi test etmenin en ucuz yolu nedir?

Öncelikle tokenlarınızı sayın, çünkü bu uç nokta ücretsizdir. Ardından testi, düşük bir max_tokens değeri ile Haiku 4.5 üzerinde çalıştırın. En az 4.096 tokenlık sabit bir istem önekini önbelleğe alın; böylece tekrarlanan çağrılar giriş fiyatının %10'u üzerinden ücretlendirilir. Etkileşimli olmayan tüm işlemleri ise Batch API üzerinden yarı fiyatına gönderin. Bu ayarlarla, Ekim 2026 itibarıyla bin adet küçük çağrının maliyeti bir doların altında kalmaktadır.