Claude token nedir? Claude Code token hesabı

Claude'da token nedir?

Token, Claude'un okuduğu ve yazdığı metin birimidir; bir sözcüğün parçası olabilir. Anthropic'in kendi sözlüğünde, Claude Opus 4.7 öncesindeki modeller için bir token yaklaşık 3.5 İngilizce karakter olarak tanımlanır. Güncel tokenizer'da bu değer 2.5 karaktere daha yakındır; çünkü Anthropic burada 1M tokenı yaklaşık 2.5M karakter olarak hesaplar. Her iki durumda da boşluklar ve noktalama işaretleri hesaba katıldığında sözcük başına 1 tokendan çok daha fazlası düşer. Bu nedenle 1,000 sözcüklük bir metin rahatlıkla 1,300 tokendan fazla olur. Kodda satır başına maliyet daha yüksektir: süslü parantezler, operatörler, alt çizgiler ve girintiler karakter başına İngilizce metne göre daha fazla token oluşturur. Birkaç yüz satırlık kaynak dosya genellikle birkaç bin token tutar. Agent'ın okumaya karar verdiği 2,000 satırlık bir dosya, yeni bir kod satırı yazılmadan önce beş haneli token tüketimine ulaşır.

Tokenizer'larla ilgili iki nokta genellikle karıştırılır. İlk olarak tokenizer'lar modele özeldir. Ekim 2026 itibarıyla Claude Opus 4.7 ve daha sonraki tüm modeller, buna güncel Fable 5.1, Opus 5.5, Sonnet 5.5 ve Haiku 5.5 de dahil olmak üzere, Haiku 4.5 gibi önceki Claude modellerine kıyasla aynı metin için yaklaşık %30 daha fazla token üreten yeni bir tokenizer kullanır. İçeriğe göre kesin artış değişir. Token başına fiyat bu artışla birlikte yükselmemiş olsa da token üzerinden yaptığınız bütçe hesapları bundan etkilenir. İkinci olarak, tiktoken, blog yazılarının çoğunda kullanılan kütüphane, Claude'un değil OpenAI'ın tokenizer'ıdır. Bu nedenle verdiği sayılar Anthropic'in faturalandırdığı değerlerle eşleşmez. Güvenilebilecek tek sayım, aşağıda açıklanan count_tokens endpoint'inden alınır.

Kodlama oturumunuzun maliyeti neden bu düzeydedir?

Her Claude faturası, API faturası veya abonelik limiti fark etmeksizin, temel olarak tek bir ölçüme dayanır: alınan ve üretilen token sayısı. Bazı API araçları ayrıca kendi ücret kalemini ekler. Örneğin web search, October 2026 itibarıyla 1.000 arama için $10 tutarındadır. Buna, sonuçların eklediği token ücretleri dahil değildir. Ancak bir kodlama oturumunda maliyeti asıl değiştiren token ölçümüdür. Pricing page bunu basit gösterir: bir milyon input token için belirli bir dolar tutarı ve bir milyon output token için başka bir tutar. Ancak agentic coding session sırasında input tarafındaki ölçüm, sezgisel olarak beklenenden çok daha hızlı artar. Bunun nedeni, her turda konuşmanın tamamının yeniden gönderilmesidir. On beş yıldır ölçümlendirmeli altyapı satıyorum. Müşterilerin çoğunun hangi değerin bu ölçümü artırdığını gerçekten açıklayamadığı başka bir ölçüm görmedim. Bu bölüm, ölçümün nasıl okunacağını açıklar: agentic session içinde input ve output olarak nelerin sayıldığı, yeniden gönderim döngüsünün neden bu kadar pahalı olduğu, prompt caching işleminin hesabı nasıl değiştirdiği ve hangi ayarların sonucu gerçekten etkilediği.

Her şey girdidir: ölçümün gerçekte saydığı şey

İnsanlar Claude'un yazdığı kod için ödeme yaptıklarını düşünür. Agentic bir oturumda bu, maliyet kalemlerinin küçük bir bölümüdür. Daha düşük tarifeli ancak hacmi çok daha yüksek olan girdi token'ları şunları içerir:

• Sistem istemi. Claude Code'un kendi çalışma altyapısı talimatları ile CLAUDE.md ve bellek dosyalarınız oturum başlangıcında yüklenir ve bundan sonraki her istekte gönderilir.
• Araç tanımları. Aracının çağırabileceği tüm araç şemaları. Bağladığınız her MCP sunucusu, bu sabit ek yüke katkıda bulunur. Ancak Claude Code artık varsayılan olarak tam MCP araç tanımlarını erteler. Bu nedenle bir araç ilk kez kullanılana kadar bağlamda yalnızca araç adları bulunur. Bu durum maliyeti azaltır, ancak ortadan kaldırmaz.
• Aracının okuduğu her dosya. Bir kaynak dosyanın Read işlemi, dosyanın tamamını bağlama ekler ve dosya burada kalır.
• Her araç sonucu. Test çalıştırmaları, grep çıktısı, terminal çıktıları ve derleme günlüklerinin tamamı girdi token'ları olarak geri gelir. 8,000 satır yazdıran başarısız bir test paketi küçük bir kitap gibidir. Ekim 2026 itibarıyla Claude Code, komut çıktısının yaklaşık 30,000 karakterini varsayılan olarak satır içi iletir. Daha uzun çıktılar, en fazla 2,000 karakterlik bir önizlemeyle birlikte kaydedilmiş dosya olarak gelir. Ancak bu sınırın altındaki her çıktı ve kaydedilmiş dosyanın daha sonra okunması tam olarak ücretlendirilir.
• O ana kadarki konuşmanın tamamı her turda yeniden gönderilir. Bu konu ayrı bir bölümü hak eder.

Yeniden gönderimin kimsenin hesaba katmadığı maliyeti

Claude API durum bilgisi tutmaz. İstekler arasında oturumunuzu hatırlamaz; aslında hiçbir şey bunu yapmaz. Bu nedenle 2. turda istemci, 1. turu, modelin yanıtını ve yeni mesajınızı birlikte gönderir. 50. turda ise 1. turdan 49. tura kadar bağlamda hâlâ bulunan her şeyi yeniden gönderir: okunmuş tüm dosyaları, araç sonuçlarını ve compact işlemiyle kaldırılmamış diff'leri; ardından 50. turu ekler. (Compaction eski geçmişi bir özetle değiştirir. Bir subagent'ın dosya okumaları kendi bağlamında kalır ve yalnızca sonucu geri gelir.) Model, korunan metin dökümünün tamamını her seferinde yeniden okur. Bu yeniden okunan token'ların tamamı input olarak ücretlendirilir.

Sonuç olarak tur başına maliyet, oturumun uzunluğuyla yaklaşık doğrusal olarak artar. Toplam oturum maliyeti ise yaklaşık karesel olarak büyür. 3. turda yarım cent tutan bir mesaj, aynı tek satırlık soru için 60. turda bunun 20 katına mal olabilir. Çünkü mesaj, 60 turun yükünü birlikte taşır. "Faturam neden bu kadar yüksek?" sorusunun yöneltildiği taleplerin çoğunu açıklayan temel gerçek budur. Bu, Claude'a özgü bir davranış değildir. Durum bilgisi tutuyormuş gibi görünen her LLM ürünü, temelinde yeniden gönderim döngüsü kullanan stateless bir API'dir.

Çıktı: gördükleriniz ve görmediğiniz düşünme süreci

Çıktı token'ları maliyetli olanlardır; güncel modellerde girdi ücretinin beş katıdır (Ekim 2026 itibarıyla 100.000 token'a kadar olan istemlerde Fable 5.1 için $10/$50, Opus 5.5 için $4/$20, Sonnet 5.5 için $2/$10, Haiku 5.5 için $0,10/$0,50). Çıktı; Claude tarafından üretilen metin ve kodun yanı sıra düşünme token'larını da içerir: modelin yanıt vermeden önce yaptığı içsel muhakeme. Burada iki gerçek önemlidir. Düşünme süreci çıktı oranları üzerinden ücretlendirilir ve max_tokens limitine karşı sayılır; stop_reason: "max_tokens" ile sonlanan bir API yanıtı ve kesilmiş bir cevap, genellikle düşünme sürecinin yanıtın kendisinden önce bütçeyi tükettiği anlamına gelir. Mevcut modellerde muhakeme özeti hiç görüntülenmeyebilir; API bunu Fable 5.1, Opus 5.5, Sonnet 5.5, Haiku 5.5 ve Opus 4.7'ye kadar olan eski modellerde varsayılan olarak gizler, ancak düşünme süreci gerçekleşmiş ve ücretlendirilmiştir. Görünmez olması ücretsiz olduğu anlamına gelmez.

Claude Code, çok adımlı işlerde ölçülebilir şekilde iyileştirme sağladığı için genişletilmiş düşünme sürecini varsayılan olarak etkinleştirir ve varsayılan bütçe, istek başına on binlerce token'a ulaşabilir. Daha basit görevlerde bu süreci kısabilirsiniz: /effort ile veya /model içinde çaba seviyesini düşürün ya da buna izin veren modellerde /config ile düşünme sürecini kapatın. Ekim 2026 itibarıyla Claude Code; Opus 5.5, Sonnet 5.5, Haiku 5.5 veya Fable modellerinde düşünme sürecini kapatamaz, bu nedenle burada kontrol mekanizmanız çaba seviyesidir. API, bunlardan ikisinde size daha fazla alan tanır. Haiku 5.5, eski Opus 5 gibi yüksek çaba veya altındaki seviyelerde thinking: {"type": "disabled"} kabul ederken, eski Sonnet 5 bunu xhigh ve max dahil her çaba seviyesinde kabul eder. Sonnet 5.5, "disabled" değerini reddeder ve bunun yerine thinking: {"type": "between_tools"} değerini alır; bu da düşük, orta veya yüksek çaba seviyelerinde ön düşünme sürecini devre dışı bırakır, böylece araç içermeyen bir istek doğrudan düşünme süreci olmadan yanıtlanır. Sadece Opus 5.5 ve Fable modelleri, ne gönderirseniz gönderin düşünme sürecini aktif tutar. Bu, bir hurafe değil, gerçek bir maliyet kontrol aracıdır.

Prompt caching maliyet hesabını değiştirir

Prompt caching, yeniden gönderme döngüsünün maliyetleri kontrolden çıkarmamasını sağlar. API; prompt'unuzun, system prompt'un, tool tanımlarının ve konuşma geçmişinin sabit bir prefix bölümünü cache'leyebilir. Sonraki istekte bu içeriği fiyatın çok küçük bir bölümü karşılığında sunabilir. Ekim 2026 itibarıyla çarpanlar şöyledir: Cache write işlemi temel input ücretinin 1.25 katına mal olur (1 saatlik varyantta 2 kat); cache read işlemi çoğu modelde 0.1 kat, Claude Opus 5.5 ve Claude Sonnet 5.5 modellerinde 0.05 kat, Claude Fable 5.1 modelinde 0.025 kattır. Write işlemleri ek ücretlidir; read işlemleri çoğu modelde %90, Opus 5.5 ve Sonnet 5.5 modellerinde %95, Fable 5.1 modelinde %97.5 indirimlidir. (Sonnet 5.5 için read ücreti 7 Ekim 2026 tarihinde 0.1 kattan 0.05 kata düşürülmüştür.) Tek bir read işlemi bile 5 dakikalık write ek ücretini fazlasıyla karşılar.

Claude Code cache işlemlerini sizin için yönetir. Sağlıklı bir oturumda bu büyük yeniden gönderimin neredeyse tamamı cache üzerinden sunulur. Ancak cache, belirli bir süre etkinlik olmadığında sona erer. Ekim 2026 itibarıyla Claude Code, abonelikte planınıza dahil kullanımı tüketirken ana konuşma için bir saatlik cache sunar. API key, cloud provider veya kullanım kredileriyle çalışırken son kullanımdan itibaren beş dakika cache sunar. (promptCacheTtl ayarı, bu durumda 2 kat write ücretiyle bir saatlik süre talep edebilir.) Beş dakikalık cache kullanılırken uzun süren bir kahve molasına çıkılır, geri dönülür ve bir mesaj gönderilirse cache sona ermiş olur. Biriken prefix'in tamamı cache ücretinden read edilmek yerine 1.25 kat üzerinden yeniden write edilir. 150K token içeren bir oturumda bu soğuk tur, 150K token'ın tamamını 1.25 kat üzerinden write eder. Sıcak tur ise bu token'ları 0.1 kat üzerinden read eder. Prefix için fark 12.5 kattır. Opus 5.5 ve Sonnet 5.5 modellerinde bu fark 25 kat, Fable 5.1 modelinde 50 kattır. Buradan çıkarılması gereken karşıt sonuç şudur: boşta bekleyip devam etme düzeni sürekli çalışmaktan daha pahalı olabilir. Çünkü TTL süresini aşan her boşluk, sonraki turu ucuz bir read işleminden pahalı bir yeniden write işlemine dönüştürür. Çalışmayı bloklar halinde yürütün. Beş dakikalık cache kullanılıyorsa büyük bir oturuma her on dakikada bir mesaj göndererek devam etmeyin.

API'yi VPS üzerindeki kendi uygulamanızdan çağırıyorsanız bunların hiçbiri otomatik gerçekleşmez. cache_control ile bu özelliği etkinleştirmeniz gerekir. Sık yapılan hata, system prompt içine zaman damgası veya istek kimliği eklemektir. Bu değer her istekte prefix baytlarını değiştirir ve caching özelliğini sessizce devre dışı bırakır. Bunun göstergesi, görünüşte aynı olan çağrılarda usage.cache_read_input_tokens değerinin sürekli olarak sıfırda kalmasıdır.

Formül ve uygulamalı örnek

Sabit olarak "bir oturumun maliyeti $X'tir" diyenleri dikkate almayın. Oturum maliyetleri iki büyüklük mertebesi arasında değişebilir. Geçerli olan formüldür:

turn cost = (uncached input        x base input price)
          + (cache writes          x 1.25 x base input price)
          + (cache reads           x read multiplier x base input price)
          + (output incl. thinking x output price)

read multiplier = 0.10 on most models, 0.05 on Opus 5.5 and Sonnet 5.5, 0.025 on Fable 5.1
session cost = sum over all turns

Claude Opus 4.8 üzerinde uygulamalı örnek. Bu model artık eski bir modeldir ancak hâlâ kullanılabilir ve Ekim 2026 itibarıyla giriş tokenları için milyon başına $5, çıkış tokenları için milyon başına $25 ücretlendirilir. Birikmiş bağlamı 80,000 token olan bir oturumun ortasındaki dönüşte 75,000 token önbellekten okunuyor, 3,000 token önbelleğe yeni yazılıyor, 2,000 token önbelleğe alınmamış yeni giriş ve düşünme tokenları dahil 1,500 çıkış tokenı bulunuyor.

• Önbellek okumaları: 75,000 × $0.50/M = $0.0375
• Önbellek yazmaları: 3,000 × $6.25/M = $0.019
• Önbelleğe alınmamış giriş: 2,000 × $5/M = $0.010
• Çıkış: 1,500 × $25/M = $0.0375

Dönüş başına yaklaşık $0.10; bunun gibi elli dönüş yaklaşık $5 tutar. Şimdi aynı dönüşü önbellek süresi dolduktan sonra ele alalım: Önbelleğe alınabilir 78,000 tokenın $6.25/M ücretle yeniden yazılması ve aynı 2,000 önbelleğe alınmamış tokenın $5/M ücretle işlenmesi, çıkış hesaba katılmadan yaklaşık $0.50 tutar. Bu, aynı iş için önbelleği sıcak olan dönüşün toplam maliyetinin yaklaşık beş katıdır. Önbelleklemenin etkisi tek bir sayıyla bundan daha açık gösterilemez. Güncel Claude Opus 5.5 modelinde ($4/$20, önbellek okumaları 0.05×) aynı sıcak dönüş yaklaşık $0.07 tutar (okumalar $0.015, yazmalar $0.015, önbelleğe alınmamış giriş $0.008, çıkış $0.030). Soğuk sürüm ise çıkıştan önce $0.40 tutar ve sıcak dönüşün maliyetinin yaklaşık altı katına yaklaşır. Aynı dört satır, sağlayıcıları karşılaştırmanın dürüst tek yoludur; çünkü liste fiyatları önbellek okumalarını ve düşünme tokenlarını tamamen göz ardı eder. Bu hesaplamaları üç gerçek iş üzerinde çalıştırmak, Claude faturasının OpenAI faturasının üstünde veya altında kaldığı yeri gösterir.

Tek bir dönüş yerine doğrudan faturalandırma biriminin ne anlama geldiğini görmek istiyorsanız bir milyon tokenın sayfa, dosya ve dolar karşılığını aynı hesabı bir üst düzeyde ele alarak gösterir. Tahmin yapmak için değil, karşılaştırma amacıyla: Anthropic tarafından yayımlanan kurumsal Claude Code dağıtımlarına ilişkin rakamlara göre, Ekim 2026 itibarıyla geliştirici başına etkin gün başına ortalama yaklaşık $13, aylık $150 ile $250 arasında maliyet oluşur ve kullanıcıların %90'ı günlük $30'un altında kalır. Sizin maliyetiniz model seçimine, oturum düzenine ve kod tabanının boyutuna bağlıdır. Aşağıdaki ayarların önemli olmasının nedeni tam olarak budur. Kod tabanı yerine iş ilanları ve özgeçmişler okuyan bir agent'ta da aynı mantık geçerlidir; Türkiye'den ai-job-search ile iş başvurusu yaparken hangi planın gerektiği ve maliyeti neyin büyüttüğü ayrı bir rehberde anlatılır.

Kendi kullanımınızı görme

Claude Code'da komut /usage şeklindedir (/cost hala çalışır, bir takma addır). Üst kısımdaki Session bloğu, mevcut oturum için token istatistiklerini ve yerel olarak hesaplanmış bir maliyet tahminini gösterir; abonelik planlarında aynı ekran, plan limit çubuklarınızı ve son kullanımların becerilere, alt aracılara, eklentilere ve bireysel MCP sunucularına göre dağılımını gösterir. Güncel sürümlerde Session bloğu ayrıca önbellekten sunulan girdi payını, isabet oranlarını ve önbelleğin şu anda sıcak olup olmadığını gösteren bir Prompt cache (main) satırı içerir. API hesaplarındaki kesin faturalandırma için Claude Console'daki kullanım sayfası tek doğru kaynaktır, CLI rakamı ise bir tahmindir. /context; bağlam penceresini neyin meşgul ettiğini, sistem istemini, araçları, MCP tanımlarını, dosyaları ve geçmişi gösteren renkli bir ızgara çizer; bu, şişmiş bir CLAUDE.md veya çok konuşan bir MCP sunucusunu tespit etmenin en hızlı yoludur. Tam ekran modunda öğe bazlı dağılımı daraltır, all parametresini geçmek ise bunu genişletir.

API'den gelen her yanıt size tam olarak ne olduğunu söyler:

response = client.messages.create(model="claude-sonnet-5-5", max_tokens=2048,
                                  messages=messages)
u = response.usage
total_prompt = u.input_tokens + u.cache_creation_input_tokens + u.cache_read_input_tokens
print(f"uncached={u.input_tokens} written={u.cache_creation_input_tokens} "
      f"read={u.cache_read_input_tokens} output={u.output_tokens}")

input_tokens değerinin yalnızca önbelleğe alınmamış kısım olduğunu unutmayın; gerçek istem boyutu, üç girdi alanının toplamıdır. Bir saat boyunca input_tokens: 4000 göstererek çalışan bir aracı ucuz değildir; diğer 200.000 token önbellekten sunulmuştur. Göndermeden önce tahmin yapmak için token sayma uç noktasını kullanın; bu uç nokta ücretsizdir, kendi hız sınırına sahiptir ve belirttiğiniz modelin tokenizer'ı ile sayım yapar (sonucu yakın bir tahmin olarak değerlendirin; faturalandırma gerçek isteği yansıtır):

count = client.messages.count_tokens(model="claude-sonnet-5-5",
                                     messages=[{"role": "user", "content": big_file}])
print(count.input_tokens)

Yukarıdaki nedenden dolayı asla tiktoken kullanmayın.

Abonelik planları ve kullandıkça öde

Bu kılavuzdaki işlemler her yerde aynıdır; yalnızca ücretlendirme modeli değişir. API anahtarıyla Anthropic, yayınlanan tarifeler üzerinden token başına kullandıkça öde modeliyle ücretlendirir. Yukarıdaki tüm rakamlar gerçek maliyetleri ifade eder. Bu sayaç çoğu kişinin beklediğinden daha erken çalışmaya başlar. Bunun nedeni, başvurulabilecek bir ücretsiz katmanın bulunmamasıdır. Kayıt sırasında verilen küçük bir kredi ve ücretlendirilmeyen birkaç endpoint dışında, kart bilgilerinizi kaydetmeden önce yeni bir API hesabının gerçekte neler sunduğu bunlarla sınırlıdır. 7 Ekim 2026'dan beri geçerli olan istisna Max veya Team aboneliğidir. Bu planlar artık Claude Platform üzerindeki kendi uygulamalarınız ve agent'larınız için aylık API kredileri içerir: Max 5x için ayda $100, Max 20x için $200; Team için Standard seat başına $20 ve Premium seat başına $100. Bu krediler ortak bir havuzda tutulur ve $500 ile sınırlıdır. Kredileri kullanmak için bir Console organization bağlanmalıdır. Kullanılmayan krediler her faturalandırma döneminin sonunda geçerliliğini yitirir. Bu krediler etkileşimli Claude Code kullanımını kapsamaz. Claude aboneliğinde (Pro, Max, Team ve eski seat tabanlı Enterprise planları) Claude Code kullanımı bunun yerine planınıza dahil olan kullanım hakkından düşer. Ekim 2026 itibarıyla bu hak, modeller ve claude.ai chat arasında ortak kullanılan, kayan beş saatlik bir session window ile haftalık bir window içerir. /usage dolar tutarı bilgilendirme amaçlıdır; fatura tutarı değildir. Ekim 2026 itibarıyla iki istisna vardır. Güncel usage-based Enterprise seat'lerinde hiç kullanım hakkı bulunmaz; bu nedenle her token, standart API tarifeleri üzerinden ücretlendirilir. Fable modelleri Pro, standart Team seat'leri veya standart eski Enterprise seat'leri için kullanım hakkına dahil değildir. Bu seat'lerde Fable modelleri pay-as-you-go kullanım kredileriyle çalışır. Bir window tamamen kullanıldığında, reset zamanıyla birlikte "Oturum sınırınıza ulaştınız" veya "Haftalık sınırınıza ulaştınız" mesajı görüntülenir. Window'lar modeller arasında ortak olduğu için /model ile model değiştirmek erişimi geri getirmez. Bu window'lar, o anda kullandığınız client yerine hesapla ilişkilidir. Bu durum, Linux üzerinde yerel olarak neyin çalıştığını ve her surface'i hangi planın kapsadığını belirlemeye çalışıyorsanız önemlidir. Gerçekte hangi iki window'un tükendiği, bekleme süresini ve bu sırada yapılabilecek en uygun işlemleri belirler. Bu nedenle görev ortasında bir sınıra ulaştığınızda kullanabileceğiniz seçenekleri bilmek gerekir. Planlarda isteğe bağlı olarak usage credits etkinleştirilebilir. Bu krediler /usage-credits ile yönetilir ve üst sınır aşıldıktan sonraki kullanımı satın almak için kullanılır. Plan kotalarını özellikle yazmıyorum. Bunlar bu konudaki en hızlı değişen rakamlardır. Bunun yerine claude.com/pricing sayfasını ve kendi /usage çubuklarınızı kontrol edin. Abonelikte de token mekanizması önemini korur. Gereksiz kaynak tüketen bir session, pencerenizi dolar harcayacağı şekilde tüketir. Abonelik tarafı için kullanımınıza hangi Claude planının uygun olduğuna bakın.

Gerçekte işe yarayan kaldıraçlar

• Agent'ın okuyacağı kapsamı sınırlandırın. "auth.py içindeki doğrulama hatasını düzelt" yalnızca bir dosyayı okur; "bu kod tabanını iyileştir" ise kırk dosyayı okur. CLAUDE.md her oturumda yüklendiği için içeriğini yalın tutun ve yalnızca temel bilgileri bırakın. İş akışına özgü talimatları, gerektiğinde yüklenen skill'lere taşıyın.
• Açık ve kısa tutun. İlişkisiz görevler arasında /clear yapılmadığında eski bağlam sonraki her mesajla yeniden gönderilir ve yeniden ücretlendirilir. Tek bir uzun görev içinde /compact Focus on the failing tests and the diff geçmişi özetleyerek bağlamı küçültür ve ikinci dereceden büyüme eğrisine girilmesini önler.
• Modele uygun boyut seçin. Çoğu kodlama işinin üstesinden Sonnet gelir; Ekim 2026 itibarıyla bir milyon token başına $2/$10 ücret uygulanır ve bu artık tanıtım fiyatı değildir: Sonnet 5.5 için ücret $2/$10'dur; planlanan 1 Eylül tarihli $3/$15 artışı iptal edildiği için Sonnet 5 de $2/$10 ücretini korumuştur. Buna karşılık Opus 5.5 için ücret $4/$20'dir. Haiku 5.5 için ücret $0.10/$0.50'dır; 100,000 tokene kadar olan prompt'larda bu ücret geçerlidir, bunun üzerindeki kullanım için ücret $0.50/$2.50 olur. Bu nedenle Haiku 5.5, log triage gibi mekanik subagent işleri için doğru araçtır. Fable 5.1 ise $10/$50 ücretiyle diğer uçta yer alır. Bu, Fable 5 ile aynı ücrettir ve her iki sayaçta da Opus 5.5 ücretinin iki buçuk katıdır. Bu nedenle rutin işler için seçili bırakmadan önce hangi işlerin gerçekten bu ücreti haklı çıkardığını bilmek gerekir. /model oturumun ortasında geçiş yapar.
• Ayrıntılı çıktıyı önceden filtreleyin. Test çalıştırmasının çıktısını Claude görmeden önce yalnızca hatalara indirecek bir hook, 20,000 tokenlık araç sonucunu 300 tokene düşürür. Bunu o tur her yeniden gönderildiğinde de uygular.
• Etkileşim gerektirmeyen işleri toplu çalıştırın. Kendi API pipeline'larınızda sınıflandırma, toplu inceleme ve gece çalışan işler için Batches API, asenkron teslimat karşılığında aynı modelleri %50 indirimli çalıştırır.
• Cache süresini dikkate alın. İşleri kesintisiz çalışma aralıkları halinde yürütün. VPS üzerindeki tmux içinde ayrılmış bir Claude Code oturumu boştayken ücret oluşturmaz; token yalnızca bir tur çalıştırıldığında tüketilir. Ancak cache TTL süresini aşan boşta kalma, warm cache avantajını ortadan kaldırır ve sonraki tur yeniden yazma maliyetini doğurur.

FAQ

Claude Code'da bir kodlama oturumu kaç token kullanır?

Sabit bir sayı yoktur. Dosyalar ve geçmiş biriktikçe, oturumun ortasındaki tek bir istek-cevap turu genellikle on binlerce prompt tokenı içerir. Çalışan bir oturumda toplam kullanım milyonlarca tokena ulaşabilir. Kullanımın büyük bölümü modele bağlı olarak temel ücretin onda biri veya daha düşük bir ücretle önbellekten karşılanır. Karşılaştırma için, Anthropic'in Ekim 2026 itibarıyla yayımladığı kurumsal verilere göre geliştirici başına aktif gün başına ortalama maliyet yaklaşık $13'tır; kullanıcıların %90'ı $30'ın altındadır. Kendi oturumunuzda /usage komutunu çalıştırın. Beş dakika boyunca izlemek, yayımlanmış herhangi bir ortalamadan daha güvenilir bir ölçüm sağlar.

Görüntüleyemediğim thinking tokenları için de ücret öder miyim?

Evet. Thinking tokenları output token olarak ve yüksek ücretlendirme üzerinden faturalandırılır. Ayrıca max_tokens sınırına dahil edilir. Güncel modeller, arayüz reasoning özetini göstermese bile bu tokenlar için ücret alır. Görünen yanıt tamamlanmadan önce yanıt stop_reason: "max_tokens" ile kesilirse bütçenin büyük olasılıkla thinking tokenları tarafından tüketildiği anlaşılır. Claude Code'da derin reasoning gerektirmeyen görevler için çaba düzeyi /effort ile düşürülebilir.

Uzun bir Claude Code oturumunda ileti başına maliyet neden artar?

Bunun nedeni API'nin durum bilgisi tutmamasıdır. Her turda, bağlamda hâlâ bulunan konuşma yeniden gönderilir. Buna her dosya okuması, araç sonucu ve compact işlemiyle kaldırılmamış önceki değişimler de dahildir. Bu nedenle 50. tur, 1. turdan 49. tura kadar olan içeriği de taşır. Prompt caching, çoğu modelde tekrarlanan ön eki temel input fiyatının onda biri üzerinden sunar; Opus 5.5 ve Sonnet 5.5 için bu oran %5, Fable 5.1 için %2.5'tir. Ancak ön ek büyümeye devam eder. Ayrıca cache TTL süresini aşan her boşluk, sonraki turu tam ücretli bir yeniden yazma işlemine dönüştürür. /compact geçmişi küçültür; /clear geçmişi sıfırlar.

Claude token kullanımımı ve maliyetimi nasıl kontrol ederim?

Claude Code'da /usage oturum token istatistiklerini, yerel maliyet tahminini ve aboneliklerde plan sınırı çubuklarını gösterir; /cost bunun diğer adıdır. /context pencereyi hangi içeriklerin doldurduğunu gösterir. Yetkili API faturalandırması için Claude Console'daki usage sayfası kullanılmalıdır. Kendi kodunuzda response.usage okunmalıdır. input_tokens, cache_creation_input_tokens ve cache_read_input_tokens değerlerinin toplamı gerçek prompt boyutunu verir. Önceden tahmin yapmak için count_tokens endpoint'i kullanılmalıdır; tiktoken kullanılmamalıdır.