Claude Code token maliyeti: bir oturum gerçekte ne yakar

Kısa cevap: oturum başına sent değil dolar bekleyin.

Claude Code bir sohbet penceresi değil, agentic bir araçtır. Sizden gelen tek bir istek düzinelerce model çağrısı tetikleyebilir ve her çağrı, büyüyen konuşmanın tamamını input token olarak yeniden gönderir. Bu yüzden maliyeti belirleyen output değil, input hacmidir. Output token'lar genellikle input'un yanında yuvarlama hatası kalır. Toplulukça bildirilen yaklaşık rakamlar, orta ölçekli bir repoda ciddi bir saatlik oturumu kabaca 5 ila 20 milyon token olarak gösteriyor. Sonnet 4.6 için Anthropic doğrudan oranlarında (milyon input başına $3, milyon output başına $15), çoğu oturum caching indirimi olmadan yaklaşık $2 ile $40 arasına düşer; yoğun Opus günleri bunun çok üzerine çıkar. Prompt caching, gerçek faturaları naif matematiğin altına çeker, ama şekil aynı kalır: büyük repolarda uzun oturumlar gerçek para tutar. Elinizde üç kaldıraç var. Bağlam penceresine giren şeyi azaltmak, rutin işi daha ucuz modellere yönlendirmek ve isteklerin faturalandırıldığı yeri değiştirerek token başına oranı düşürmek. Bu sayfanın devamı her birini somut sayılarla ele alıyor.

Token'lar gerçekte nereye gidiyor.

İki mekanizma bunu yumuşatır. Birincisi, Anthropic prompt caching: Claude Code sabit önekleri cache'lenebilir olarak işaretler, cache yazmaları bir prim öder, cache okumaları normal input oranının yaklaşık onda birine faturalandırılır. İkincisi, bağlam sıkıştırma: /compact komutu geçmişi özetler ve ham transkripti düşürür. İkisi de çok yardımcı olur, ama ikisi de temel kuralı değiştirmez: pencerede oturan her şey, onu içeren her çağrıda ödenir. Bu yüzden aynı prompt farklı repolarda çok farklı miktarlarda maliyete mal olur. Sade bir CLAUDE.md ile taze bir oturumda sorulan bir soru ucuzdur. Bir düzine büyük dosya okumuş bir oturuma 30 tur girdikten sonra sorulan aynı soru, altı haneli bir token penceresinin üzerine biner.

• Sistem promptu ve araç tanımları: kabaca 15 ila 20K token, her bir model çağrısında yeniden gönderilir.
• CLAUDE.md, kural dosyaları ve MCP araç şemaları: oturum başında yüklenir ve sonraki her çağrıda taşınır.
• 500 satırlık bir kaynak dosya kabaca 5-7K token'dır ve bir kez okunduktan sonra pencerede kalır.
• Araç sonuçları: test çıktısı, grep isabetleri ve terminal logları konuşmaya eklenir ve sonraki her turda input olarak yeniden faturalandırılır.
• Agentic döngünün kendisi: tek bir "bu başarısız testi düzelt" isteği, Claude Code geri bildirmeden önce 10 ila 40 model çağrısı üretebilir.

Gerçekçi oturum maliyeti matematiği.

Tahmin etmek yerine tur tur modelleyin. Tipik orta ölçekli bir oturum yaklaşık 40 model çağrısı çalıştırır. Birkaç dosya ve bir miktar test çıktısı biriktikten sonra, tam pencere çağrı başına ortalama 90K token'a ulaşır. 90K'dan kırk çağrı, 3,6M input token'dır. Output küçük kalır: çağrı başına yaklaşık 1.000 token'dan kırk çağrı, yaklaşık 40K output token'dır. Aşağıdaki tablo, üç oturum profilini Anthropic doğrudan liste oranlarıyla fiyatlandırıyor. Bunları tavan olarak düşünün: prompt caching tekrar eden öneki ağır şekilde indirimliyor, bu yüzden cache'lenmiş oturumlar genelde daha düşük gelir. Örüntü yine de geliştiricilerin bildirdikleriyle örtüşüyor. Ara sıra öğleden sonraları birkaç dolara mal olur; Opus'u API üzerinde günlük sürücü olarak çalıştırmak ayda birkaç yüz dolara çıkabilir.

Plan vs API: Claude Code hangi yolla daha ucuz?

Anthropic, Claude Code'u iki şekilde satar: dönen pencerelerde kullanım limitleri uygulanan sabit ücretli abonelik planlarına paketlenmiş olarak, ya da API üzerinde token başına ölçülü. Claude Code API fiyatlandırması, sınır ve kesim olmadan, oturumlarınızın yaktığı her ne ise ona uygulanan yukarıdaki model oranlarından ibarettir. Başabaş noktası basit aritmetik. Tipik oturumunuz Sonnet'te doğrudan oranlarla yaklaşık $11'e mal oluyorsa, $20'lık bir plan, limitlerin altında kaldığınız sürece ayda yaklaşık iki oturumda kendini amorti eder. Sorun limitlerin kendisi: yoğun agentic kullanım, tam olarak dönen limitleri tetikleyen örüntüdür ve sabit oran, oturum ortasında kilitlendiğiniz anda ucuz olmaktan çıkar. API faturalandırması bu dengeyi tersine çevirir. Asla kesilmezsiniz ve tam olarak yaktığınız kadar ödersiniz. Birçok yoğun kullanıcı hibrit bir kuruluma varır: interaktif çalışma için bir plan, CI işleri ve taşma için bir API anahtarı.

Claude Code token maliyetini nasıl azaltırsınız.

Son iki kaldıraç birleşince katlanır. Ucuz bir modeli indirimli bir endpoint üzerinden yönlendirmek, rutin iş için $10'lık bir oturumu bir doların çok altına indirebilir. Bir gateway seçeneği APIsRouter'dir: kullandıkça öde faturalandırması olan ve aboneliği olmayan OpenAI uyumlu bir API. Global modeller resmi listenin yüzde 20 altında fiyatlandırılır, Çin modelleri kendi resmi oranlarının altında yer alır, ilk yükleme yüzde 100 bakiye ekler ve /topup'taki kayıtsız checkout önce ödemeyi alıp anahtarı e-posta ile gönderir. Aşağıdaki katalog, bir yönlendirme merdiveninin pratikte nasıl göründüğünü gösteriyor. Bütçe katmanını tercih ederseniz Kimi K2.6 (kimi-k2.6) da mevcuttur.

• CLAUDE.md'yi sade tutun. Her satır, her oturumdaki her model çağrısında tekrar eden bir ücrettir.
• Görev başına yeni bir oturum başlatın ve uzun bir oturum kaydığında /compact çalıştırın. 150K token'lık bir pencere her çağrıda 150K faturalandırır.
• Okumaları kapsamlandırın. Claude Code'u serbestçe taramak yerine belirli dosyalara yönlendirin, build çıktısını ve vendored dizinleri hariç tutun.
• Kullanmadığınız MCP sunucularını devre dışı bırakın. Araç şemaları her çağrıda sistem promptuyla birlikte taşınır.
• Modele göre yönlendirin. Mimari ve zorlu hata ayıklama için Opus'u tutun, varsayılan olarak Sonnet çalıştırın, boilerplate, test iskeleti ve commit mesajlarını daha ucuz modellere itin.
• Base URL'yi doğrudan liste fiyatlarında faturalandırmak yerine bir gateway'e yönlendirerek token başına oranın kendisini düşürün.

Yapılandırma örneği: Claude Code'u yeniden yönlendirin ve doğrulayın.

Claude Code, başlangıçta ANTHROPIC_BASE_URL'yi okur, yani token'ların nerede faturalandırıldığını değiştirmek bir iş akışı değişikliği değil, bir ayar değişikliğidir. Endpoint ve anahtarı ~/.claude/settings.json içine koyun; her oturum bunları başlangıçta alır. Model ID'leri aynı kalır, araç yürütmesi makinenizde yerel olarak devam eder ve geri alma tek bir satırı yorum satırı yapmaktan ibarettir. OpenAI uyumlu araçlar ve script'ler için base URL /v1 ile biter (https://api.apisrouter.com/v1). Günlük sürücünüzü ona yönlendirmeden önce anahtarı tek seferlik bir curl ile doğrulayın:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apisrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-APIsRouter-...",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"
  }
}

Sık sorulan sorular