Claude Code Harcama Takip Araçları Karşılaştırması
Claude Code harcama takipçileri farklı verileri okur. Yerel log ayrıştırıcıları, yerleşik kullanım ekranları ve OpenTelemetry yığınlarının neyi gösterdiğini karşılaştırın.
Claude Code harcama takipçisi gerçekte neyi okur
Her Claude Code harcama takipçisi üç veri kaynağından birini okur ve kaynak, hangi soruyu yanıtlayabileceğini belirler. Bir günlük ayrıştırıcı (log parser), kendi diskinizdeki oturum döküm dosyalarını okur. Bir kontrol paneli (dashboard), Anthropic'in hesabınız veya kuruluşunuz için tuttuğu kullanım kayıtlarını okur. Bir metrik arka ucu (metrics backend), Claude Code'u açtığınızda yaydığı OpenTelemetry (OTel) akışını okur. Her üçü de aynı anda doğru olabilir ancak yine de birbirleriyle çelişebilirler; çünkü farklı şeyleri saymaktadırlar.
Bu kılavuz token'ları yeniden açıklamaz. Claude Code token kullanımını nasıl hesaplar bölümü girdi, çıktı, önbellek yazma ve önbellek okuma işlemlerini kapsar; bu kısım netleşmeden hiçbir kontrol paneli anlam ifade etmez. Buradaki soru daha dardır: her araç biçimi için neyi görebilir ve neyi asla göremez.
Neden aynı gün içinde üç farklı Claude Code harcama takip aracı ortaya çıktı
Aynı gün içinde üç ayrı Claude Code harcama takip aracı yayınlandı. Bunlar aynı aracın üç farklı sürümü değildi ve işin faydalı kısmı da tam olarak bu. Biri yerel oturum dosyalarını ayrıştırıyordu. Biri hesap kullanım ekranlarını sarmalıyordu. Diğeri ise kendi kendinize çalıştırdığınız barındırılan bir izleme arka ucu idi.
Bu araçların aynı anda ortaya çıkmasının nedeni, bir ajan oturumunun maliyetinin artık belirgin olmamasıdır. Bir sohbetin maliyeti, kabaca ekranda görebildiğiniz kadardır. Bir ajan ise yirmi dosyayı okur, test paketini çalıştırır ve her adımda tüm konuşmayı yeniden gönderir; dolayısıyla fatura, sizin asla yazmadığınız bir bağlam tarafından oluşturulur. Bir abonelikte, Claude Code tarafından gösterilen oturum dolar tutarı, Anthropic'in faturalandırma için geçerli olmadığını belirttiği bir tahmindir ve önemli olan sayı, bazı günlerde diğerlerinden daha hızlı dolan bir kullanım çubuğudur. Bu üç biçimin her biri, bu boşluğun farklı bir kısmını doldurmaktadır.
Şekil 1: Yerel bir günlük ayrıştırıcısı ile bugünün maliyetini hesaplama
Claude Code, her konuşmayı ~/.claude/projects/<project>/<session-id>.jsonl dizininde JSON Lines (JSONL) formatında saklar; burada <project>, alfasayısal olmayan karakterlerin - ile değiştirildiği çalışma dizini yolunuzdur. Bu dosyadaki her asistan yanıtı, isteğe ait token sayılarını içerir. Bir günlük ayrıştırıcısı (log parser) bunları toplar ve fiyatlandırır.
ccusage, çoğu kullanıcının tercih ettiği yöntemdir. Kurulum gerektirmez:
npx ccusage@latest daily
npx ccusage@latest daily --breakdown
npx ccusage@latest blocks
npx ccusage@latest session --jsondaily, tarih bazlı toplamları verir. --breakdown, her satırı modele göre ayırır; böylece bir öğleden sonra yapılan Opus kullanımının haftalık maliyetin büyük kısmını oluşturduğunu görebilirsiniz. blocks, aboneliğin sıfırlandığı beş saatlik dilimlere göre gruplandırma yapar. session konuşma başına toplamları verirken, daily --instances proje bazlı gruplandırma yaparak hangi deponun (repository) maliyetli olduğunu görmenizi sağlar. Aralık sınırlarını belirlemek için --since ve --until parametrelerini ekleyin ve sürümünüzün beklediği tarih formatı için npx ccusage@latest daily --help komutunu çalıştırın. Ekim 2026 itibarıyla araç, Codex ve OpenCode dahil olmak üzere diğer aracı CLI'larını da okuyabilmektedir; bu, karşılaştırma yapıyorsanız önemlidir. Varsayılan raporlar tespit edilen tüm kaynakları birleştirir; Claude Code'a odaklanmak için daily veya session öncesinde claude parametresini ekleyin.
Fiyatlandırma, model fiyat tablosundan alınır ve aracın üç maliyet modu vardır. --mode auto, Claude Code tarafından dosyaya yazılan costUSD değerini kullanır; bu değer mevcut değilse token sayıları üzerinden hesaplama yapar. --mode calculate, her zaman tokenlar üzerinden hesaplama yapar ve kaydedilmiş maliyetleri yok sayar. --mode display, yalnızca kaydedilmiş maliyetleri gösterir ve maliyeti olmayan satırlar için $0.00 çıktısını verir. Eğer bir toplam yanlış görünüyorsa, aynı raporu önce calculate, ardından display ile çalıştırın. İkisi arasındaki büyük fark, çoğu girdinin kaydedilmiş bir maliyeti olmadığını ve okuduğunuz her şeyin bir tahmin olduğunu gösterir. Sözleşmeli fiyatlar üzerinden ödeme yapıyorsanız, ccusage.json yapılandırma dosyasındaki defaults altında yer alan pricingOverrides parametresi, bireysel modellerin fiyatlarını değiştirir.
Aynı veriler isteminize de beslenebilir. ccusage statusline, Claude Code durum çubuğu için kompakt bir satır yazdırır ve diğer tüm durum satırı komutları gibi ~/.claude/settings.json ile bağlanır. Ayarlar bloğu ve aldığı alanlar için Claude Code durum satırı oluşturma bölümüne bakın.
Günlük ayrıştırıcısının göremediği tek şey, bu makinede gerçekleşmeyen işlemlerdir. İkinci bir dizüstü bilgisayar, claude.ai üzerindeki bir oturum veya bir ekip arkadaşınızın çalışması: bu transkriptler ilgili disklerde kalır. Eski terminal oturumları, cleanupPeriodDays altında varsayılan olarak 30 günlük hareketsizlikten sonra temizlenir; ancak saklama süresi yapılandırılabilir: yıllarca süren geçmişi tutmak için 3650 gibi büyük bir değer kullanın. Desktop veya Cowork üzerinde başlatılan veya en son devam ettirilen oturumların transkriptleri, HIPAA yapılandırmaları gibi istisnalar haricinde, varsayılan olarak bu sürenin ötesinde tutulur.
Bir risk daha vardır ve bu yapısal bir durumdur. Anthropic belgeleri, girdi formatının Claude Code'a özgü olduğunu ve sürümler arasında değişebileceğini belirtir; bu nedenle bu dosyaları doğrudan ayrıştıran betikler herhangi bir sürüm güncellemesinde bozulabilir. Bu, bu türdeki tüm araçlar için geçerlidir. JSONL üzerinde elle yazılmış bir jq tek satırlık komutunun göründüğünden daha kötü bir fikir olmasının nedeni de budur: bakımı yapılan ayrıştırıcılar format değişikliklerini sizin yerinize takip eder; sizin tek satırlık komutunuz ise bir alan yeniden adlandırıldığı gün yanlış bir sayıyı kesin bir dille raporlayacaktır.
Son olarak, dolar tutarı aboneliklerde bir uyarı gerektirir. Pro veya Max plan limitiniz dahilindeki kullanım token başına faturalandırılmaz; bu nedenle çıkan sayı, tokenlarınızın liste API fiyatları üzerinden ne kadara mal olacağını gösterir. Bu, kullanımınızın yoğunluğunu ölçer. Faturanız değildir. İstisna, kullanım kredileridir: bunları etkinleştirirseniz, plan limitini aşan kullanım standart API fiyatları üzerinden ayrı bir ücret olarak faturalandırılır ve claude.ai o ayın harcamasını Ayarlar > Kullanım altında gösterir. Asıl soru hangi planda olmanız gerektiği ise, bu karşılaştırma ayrı bir konudur: API faturalandırması ile Claude aboneliğinin karşılaştırılması bölümüne bakın.
Şekil 2: Yerleşik kullanım ekranları bütçeyi hangi modelin tükettiğini gösterir
Claude Code kendi raporlama özelliğini sunar ancak çoğu kullanıcı bunu asla açmaz. Bir oturum içindeyken /usage komutunu çalıştırın. Üst kısımdaki Session bloğu, mevcut oturum için model bazında token sayılarını ve dolar cinsinden bir tutarı gösterir; bu tutar, yönetici tarafından yönetilen ayarlarda bir modelPricing tablosu tanımlanmadığı sürece standart liste fiyatları üzerinden yerel olarak hesaplanır. Eğer bir tablo tanımlanmışsa, Total cost satırı at your organization's configured rates ifadesini gösterir. Her iki durumda da bu rakam bir tahmindir ve faturanızdan farklılık gösterebilir. Pro veya Max planlarında Anthropic, bu kullanım plan dahilinde olduğu için tutarın faturalandırma açısından bir önemi olmadığını belirtir. Toplamlar, /clear ile yeni bir konuşma başlatıldığında sıfırlanır.
Pro, Max, Team veya koltuk tabanlı Enterprise planlarında aynı ekran, plan limitinizin ne kadarını kullandığınızı gösterir. Kullanım tabanlı Enterprise planlarında tükenecek bir kota yoktur, çünkü her token API fiyatları üzerinden faturalandırılır. Bu planlarda ekran ayrıca son kullanımı; yetenekler, alt aracılar, eklentiler ve bireysel MCP sunucuları bazında toplamın yüzdesi olarak dağıtır. Uzun bağlam veya önbellek ıskalamaları (cache miss) gibi son kullanımların %10 veya daha fazlasını oluşturan davranışları işaretler. Son 24 saat ile son 7 gün arasında geçiş yapmak için d veya w tuşlarına basın. Bu rakamlar yaklaşıktır ve bu makinedeki yerel oturum geçmişinden hesaplanır; dolayısıyla ikinci bir cihazdaki kullanım dahil edilmez. Bir kota tükendiğinde Claude Code limiti belirtir ve sıfırlanma zamanını gösterir; boş bir tüketim çubuğu kotanın tükendiği anlamına gelmez. Oturum bekletilebilir ve sıfırlanma sonrasında devam edilebilir; limite ulaştığınızda ne yapmanız gerektiği model, bağlam ve plan ile ilgili ayrı bir karardır.
Bir geliştiricinin üzerindeki durumlarda rakamlar hesap düzeyine taşınır. Bir API organizasyonu; Console Cost sayfasına, üye başına harcama ve kabul edilen satırları gösteren bir Claude Code paneline ve yönetici anahtarı ile aynı günlük kullanıcı bazlı metrikleri döndüren bir Claude Code Analytics API'sine erişir. Team ve Enterprise planları, yönetici konsolunda CSV dışa aktarma seçeneğiyle günlük güncellenen bir harcama raporu alır; bu rapor, koltuk tabanlı planlardaki kullanım kredisi harcamalarını ve kullanım tabanlı Enterprise planlarındaki tam kullanımı kapsar. Enterprise planı ayrıca bir analitik API'si ekler. Bunlardan hangisini göreceğiniz, her geliştiricinin nasıl giriş yaptığına bağlıdır; bu nedenle karma bir organizasyon iki raporu okuyup manuel olarak toplamalıdır.
Bütçe planlaması için, Anthropic'in Ekim 2026 itibarıyla yayınladığı maliyet dokümantasyonundaki rakamlar; aktif gün başına geliştirici başına ortalama 13 dolar civarında ve aylık geliştirici başına 150 ila 250 dolar arasındadır; kullanıcıların %90'ı aktif gün başına 30 doların altındadır. Bunu kurumsal dağıtımlardan elde edilmiş bir kıyaslama verisi olarak kabul edin, ekibiniz için bir tahmin olarak değil. Bir pilot grup çalıştırın ve verileri dışa vurmadan önce ölçüm yapın.
Panellerin göremediği şey, gün ve kişi bazının altındaki detaylardır. Size Salı günkü kullanımın çoğunun Opus tarafından yapıldığını söylerler. Hangi istemin, hangi deponun veya hangi CI işinin buna neden olduğunu söylemezler. Ayrıca raporlar günlük güncellendiği için gecikmelidirler; bu nedenle bir öğleden sonra kontrolden çıkan bir aracı yakalamaktan ziyade bir inceleme aracıdırlar. Kontrolden çıkan bir aracı yakalamak raporlara değil limitlere ihtiyaç duyar; bu da aracı maliyetlerini bir VPS üzerinde sınırlı tutma konusunun içeriğidir.
Şekil 3: Kendi OpenTelemetry yığınınız hangi istemin gerilediğini size söyler
Telemetriyi etkinleştirip dışa aktarıcıları yapılandırdığınızda Claude Code, OpenTelemetry metrikleri ve olayları yayar. Bu, kullanıcı bazlı token ve maliyet verilerini gerçek zamanlıya yakın bir şekilde kontrol ettiğiniz bir sisteme aktarmanın tek yoludur. Metrikler, USD cinsinden claude_code.cost.usage, token cinsinden claude_code.token.usage, claude_code.session.count ve claude_code.active_time.total verilerini içerir.
Token metriği, sahip olduğu öznitelikler nedeniyle ilgi çekicidir. Her veri noktası, input, output, cacheRead veya cacheCreation olabilen type değerini; ayrıca main, subagent veya auxiliary olabilen model ve query_source değerlerini taşır. Ayrıca agent.name, skill.name, mcp_server.name ve mcp_tool.name verilerini de içerir. Kendi yapılandırdığınız MCP sunucularının ve özel alt ajanlarınızın adları, OTEL_LOG_TOOL_DETAILS=1 ayarını yapmadığınız sürece custom olarak gelir; bu ayar ayrıca Bash komutlarını ve araç girdilerini araç olaylarına ekler. Bu, hiçbir panonun yanıtlayamayacağı soruları yanıtlamak için yeterlidir: faturanın ne kadarı kendi işlemlerinizden ziyade alt ajanlardan kaynaklanıyor, bir MCP sunucusu girdi token'larınızı ikiye katladı mı, birisi CLAUDE.md dosyasını düzenledikten sonra önbellek okumaları çöktü mü? Önbellek davranışı genellikle sürprizlerin gizlendiği yerdir ve istem önbelleklemenin ne zaman kendini amorti ettiği konusu, neye baktığınızı açıklar.
Bu konuda her tartışmada gündeme geldiği için yapılması gereken bir düzeltme vardır. Langfuse, iyi bir self-hosted izleme (tracing) arka ucudur ve bir VPS üzerinde çalıştırılması ajan izleme için Langfuse'u self-host etmek bölümünde ele alınmıştır. Langfuse'un OTLP uç noktası yalnızca izleri (traces) kabul eder. Claude Code varsayılan olarak metrikleri ve günlük olaylarını dışa aktarır, span'leri değil; bu nedenle OTEL_EXPORTER_OTLP_ENDPOINT değerini Langfuse'a yönlendirmek projeyi boş bırakır ve size okunmaya değer bir hata mesajı vermez. Span dışa aktarımı mevcuttur ancak CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 ve OTEL_TRACES_EXPORTER ayarlarını yapana kadar kapalı kalan bir beta özelliği olarak kalır. Langfuse'un kendi Claude Code entegrasyonu farklı bir yol izler: bir Stop kancası veya bunu yükleyen bir eklenti, her yanıttan sonra oturum dökümlerini okur ve bunları izlere dönüştürür; bu nedenle bir günlük ayrıştırıcısının (log parser) yerel kısıtlamalarını paylaşır. Langfuse, kendi kodunuzun her span'i istemi, modeli ve maliyetiyle oluşturduğu, API üzerinde kendiniz inşa ettiğiniz ajanlar için doğru araçtır. Claude Code CLI'dan gelen harcama toplamları için bir metrik deposu en uygun eşleşmedir.
Kendi VPS'niz üzerinde Claude Code harcama takibini yapılandırma
Metrikleri almak için bir toplayıcı (collector) ve bunları depolamak için Prometheus olmak üzere iki servis yeterlidir. Her ikisini de genel internete kapalı tutun; çünkü açık bir OTLP portu, onu bulan herkesten veri kabul eder. /opt/ccmetrics/compose.yaml dosyasını oluşturun:
services:
collector:
image: otel/opentelemetry-collector-contrib:latest
command: ["--config=/etc/otel/config.yaml"]
volumes:
- ./collector.yaml:/etc/otel/config.yaml:ro
ports:
- "10.8.0.1:4318:4318"
restart: unless-stopped
prometheus:
image: prom/prometheus:latest
volumes:
- ./prometheus.yml:/etc/prometheus/prometheus.yml:ro
- prom-data:/prometheus
ports:
- "127.0.0.1:9090:9090"
restart: unless-stopped
volumes:
prom-data:10.8.0.1, sunucunun bir WireGuard tüneli içindeki adresidir; bu sayede toplayıcıya yalnızca kendi makinelerinizden erişilebilir. Portun önündeki adres burada gerçek bir işlev görür, çünkü yayınlanan Docker portları ufw tarafından filtrelenmez: bkz. Docker yayınlanan portları neden ufw'yi atlar. Tünelin kurulumu için bkz. kendi VPS'nizde WireGuard VPN.
/opt/ccmetrics/collector.yaml:
receivers:
otlp:
protocols:
http:
endpoint: 0.0.0.0:4318
processors:
batch:
exporters:
prometheus:
endpoint: 0.0.0.0:8889
service:
pipelines:
metrics:
receivers: [otlp]
processors: [batch]
exporters: [prometheus]/opt/ccmetrics/prometheus.yml. 8889 numaralı port ana makineye hiçbir zaman yayınlanmaz, çünkü Prometheus toplayıcıya Compose ağı üzerinden servis adıyla erişir:
global:
scrape_interval: 30s
scrape_configs:
- job_name: claude-code
static_configs:
- targets: ["collector:8889"]cd /opt/ccmetrics
docker compose up -d
docker compose logs collectorToplayıcı günlüğü Everything is ready. Begin running and processing data. ile bitmelidir. Yapılandırma hatası nedeniyle duran bir günlük, YAML dosyasının ayrıştırılamadığı anlamına gelir ve container sürekli yeniden başlatılır.
Şimdi Claude Code'u bu noktaya yönlendirin. Claude Code çalıştıran her makinede, ~/.claude/settings.json dosyasına şunu ekleyin:
{
"env": {
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "otlp",
"OTEL_LOGS_EXPORTER": "none",
"OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
"OTEL_EXPORTER_OTLP_ENDPOINT": "http://10.8.0.1:4318",
"OTEL_METRIC_EXPORT_INTERVAL": "10000"
}
}Bir oturum başlatın, bir komut gönderin, dışa aktarma aralığını (burada 10 saniye, varsayılan olarak 60 saniye) bekleyin ve ardından Prometheus'a ne öğrendiğini sorun:
curl -s http://localhost:9090/api/v1/label/__name__/values | grep -o 'claude_code[a-z_]*'claude_code_ ile başlayan birkaç isim almalısınız. Dışa aktarıcı noktaları alt çizgiye dönüştürür ve birimi ekler, bu nedenle tam dizeler toplayıcı sürümünüze bağlıdır. Boş bir sonuç, hiçbir verinin ulaşmadığı anlamına gelir. Protokolün ve portun eşleştiğini kontrol edin; çünkü http/protobuf 4318 portuna, grpc ise 4317 portuna gider ve bir uyumsuzluk sessizce başarısız olur. claude --debug-file /tmp/claude-debug.log komutunu çalıştırın ve dosyada Claude Code'un OTel dışa aktarma hatalarını bildirdiği [3P telemetry] satırlarını arayın.
Tek bir makine ve sunucusuz bir yapı için yukarıdakilerin hepsini atlayın. CLAUDE_CODE_ENABLE_TELEMETRY=1 ve OTEL_METRICS_EXPORTER=prometheus ayarlarını yapın; Claude Code, http://localhost:9464/metrics adresinde kendi kazıma (scrape) uç noktasını açacaktır. Listelenen tek dışa aktarıcı prometheus olduğunda, Claude Code dışa aktarılan metriklerden USD, tokens ve s birimlerini çıkarır, böylece kazıma işlemi geçerli Prometheus metin formatında kalır. Metrik isimleri değişmez ve otlp,prometheus gibi dışa aktarıcıları birleştiren bir ayar, birimleri korur.
Bu yapılandırmayla birlikte bir gizlilik kararı alınması gerekir. Varsayılan olarak makineden yalnızca sayımlar ve meta veriler çıkar; istem metni veya araç çıktısı çıkmaz. OTEL_LOG_USER_PROMPTS=1, dışa aktarılan olaylara istem metnini ekler ve OTEL_LOG_ASSISTANT_RESPONSES=0 ile geçersiz kılınmadığı sürece asistan yanıt metnini de etkinleştirir. OTEL_LOG_TOOL_CONTENT=1, seçilen araç çıktısını izleme aralıklarına (trace spans) ekler; içerik sınırında (varsayılan 60 KB) dışlamalar ve kırpmalar uygulanır. Bu bayraklar, seçtikleri içerikte kaynak kodunu ve gizli bilgileri açığa çıkarabilir; bağlamdaki her şeyi otomatik olarak dışa aktarmazlar. Tam konuşma gövdeleri için ayrı bir OTEL_LOG_RAW_API_BODIES ayarı gerekir. Bunları bilinçli olarak açın ve önce gizli bilgileri ajan bağlamının dışında tutma konusunu okuyun.
Betik ve CI çalıştırmaları için harcama takibi
Etkileşimli olmayan çalıştırmalar, ekran başında kimse bulunmadığı için genellikle beklenmedik sonuçlar doğurur. claude -p, --output-format json ile birlikte çalıştırma maliyetini sonuç yükü (payload) içerisinde raporlar:
claude -p "summarise the failing tests" --output-format json | jq '.total_cost_usd'Yük, total_cost_usd değerini ve model bazlı dökümü içerir; böylece bir CI işi, herhangi bir kontrol paneline ihtiyaç duymadan kendi harcamasını kaydedebilir. Tüm yerel verilerde olduğu gibi bu da istemci tarafında yapılan bir tahmindir. --continue veya --resume ile devam eden bir görüşme, önceki çalıştırmalar da dahil olmak üzere tüm görüşmenin toplam maliyetini raporlar. Değeri bir dosyaya ekleyebilir veya yukarıda belirtilen toplayıcıya bir metrik olarak gönderebilirsiniz. Bu, mevcut en düşük maliyetli ve işlevsel harcama takibi yöntemidir ve çalıştırma başına bir adet jq çağrısı maliyeti oluşturur.
Hata modları ve karşılaşacaklarınız
Rapor boş. npx ccusage@latest daily satır yazdırmaması, Claude Code'un yazdığı konumu okumadığı anlamına gelir. CLAUDE_CONFIG_DIR bu konumu değiştirir; ccusage da aynı değişkeni okuduğu için her ikisini de aynı değerle çalıştırın. Eski oturumlar eksikse cleanupPeriodDays değerini kontrol edin: Terminal oturumları varsayılan olarak 30 gün işlem yapılmadığında temizlenir, ancak Desktop ve Cowork transkriptleri normalde bu sürenin ötesinde saklanır.
İki makine farklı toplamlar bildiriyor. Bu beklenen bir durumdur ve hata değildir. /usage dökümü ve tüm günlük ayrıştırıcılar yalnızca yerel oturum geçmişini okur, bu nedenle başka bir cihazdan veya claude.ai üzerinden yapılan kullanım her ikisinde de görünmez.
Yerel toplam fatura ile eşleşmiyor. Sözleşmeli fiyatları yapılandırmadığınız sürece yerel rakamlar standart liste fiyatları üzerinden token sayıları ile hesaplanır: /usage için yönetilen ayarlarda bir modelPricing tablosu veya ccusage için pricingOverrides kullanılır. Abonelik kapsamında, plan limitindeki kullanım token başına faturalandırılmaz, yalnızca kullanım kredileri faturalandırılır. API faturalandırması için Console Cost sayfası esas alınmalıdır.
Aynı işi yaparken maliyet arttı. Her şeyden önce önbellek sütunlarını kontrol edin. Uzun bir oturum, her adımda tüm geçmişini yeniden gönderir; önbellek sıcakken önbellek fiyatından, soğuduğunda ise tam giriş fiyatından ücretlendirilir, bu nedenle uzun bir mola tüm konuşmanın yeniden işlenmesine neden olur. Bu durum, küçük bir çıktı sayısının yanında büyük bir giriş sayısı olarak görünür ve giriş ve çıktı token fiyatlandırması bu ikisinin neden birbirinden bağımsız hareket ettiğini açıklar.
Alt temsilcilerin (subagents) olduğu bir gün imkansız görünüyor. Her alt temsilci kendi bağlam penceresini çalıştırır, bu nedenle token kullanımı kaç tanesinin çalıştığına ve her birinin ne kadar sürdüğüne bağlı olarak ölçeklenir. Bir planda, /usage ataması bu makine için alt temsilci payını yüzde olarak verir. İstek bazında ayrıntı için OTel verileri, bunları claude_code.token.usage üzerindeki query_source özniteliği aracılığıyla ayırır. Bir günlük ayrıştırıcı size toplamı gösterir ancak ayrıntıları tahmin etmenize neden olur.
FAQ
ccusage, Max plan kapsamında faturalandırıldığım tutarı gösterir mi?
Hayır. Bir aboneliğin plan limiti dahilindeki kullanım token başına faturalandırılmaz; bu nedenle günlük ayrıştırıcı (log parser), token'larınızı standart liste API fiyatları üzerinden ücretlendirir ve aynı işlemin API üzerinden ne kadara mal olacağını gösterir. Bu, bir günün ne kadar yoğun geçtiğine dair iyi bir göreceli ölçümdür ve projeleri veya modelleri birbirleriyle karşılaştırmak için kullanışlıdır. Ödemeniz gereken tutar için Console üzerindeki Cost sayfası API faturalandırmasını, plan faturalandırma sayfası ise abonelik bilgilerini kapsar. Kullanım kredileriniz etkinse, limit aşımı standart API fiyatları üzerinden faturalandırılır ve claude.ai bu harcamayı Settings > Usage altında gösterir.
Claude Code, bu araçların okuduğu oturum dosyalarını nerede saklar?
~/.claude/projects/<project>/<session-id>.jsonl dizininde; burada <project>, alfanümerik olmayan karakterlerin - ile değiştirildiği çalışma dizini yoludur. Her satır bir mesaj, araç kullanımı veya meta veri girişi için bir JSON nesnesidir. CLAUDE_CONFIG_DIR tüm dizini taşır ve settings.json içindeki cleanupPeriodDays, saklama süresini kontrol eder; bu süre terminal oturumları için varsayılan olarak 30 günlük hareketsizliktir; Desktop ve Cowork transkriptleri genellikle bu sürenin ötesinde saklanır. Anthropic, giriş formatını dahili olarak tanımlar ve sürümler arasında değişebileceğini belirtir; bu nedenle dosyaları kendi betiğiniz yerine güncel tutulan bir araçla ayrıştırın.
Claude Code telemetrisini Langfuse'a gönderebilir miyim?
Varsayılan telemetri ile hayır. Langfuse OTLP uç noktası izleri (traces) kabul eder, ancak Claude Code varsayılan olarak span yerine metrikler ve günlük olayları dışa aktarır; bu nedenle verilerin ulaşabileceği bir yer yoktur. Span dışa aktarımı etkinleştirmeniz gereken bir beta özelliğidir ve Langfuse'un kendi Claude Code entegrasyonu, bunun yerine oturum transkriptlerini izlere dönüştüren bir Stop kancası kullanır. Harcama toplamları için Claude Code metriklerini bir OpenTelemetry toplayıcısına gönderin ve bunları Prometheus'ta saklayın. Langfuse'u, kendi kodunuzun istemi, modeli ve maliyeti taşıyan span'ler yaydığı, API üzerinde bizzat oluşturduğunuz ajanlar için kullanın.
Yerel verilerim neden Console kullanım sayfasıyla eşleşmiyor?
Çünkü farklı şekillerde hesaplanırlar. /usage ve günlük ayrıştırıcılar, başında bulunduğunuz makinedeki oturum dosyalarından token sayılarını toplar ve ardından, /usage için yönetilen ayarlardaki modelPricing veya ccusage için pricingOverrides aracılığıyla sözleşmeli fiyatlar yapılandırılmadığı sürece bunları standart liste fiyatları üzerinden ücretlendirir. Console, organizasyonunuzun makineler ve anahtarlar genelindeki kullanımını kapsar; Claude Code analitik panosundaki harcama rakamları tahmin olduğundan, gerçek API maliyetleri için Cost sayfasını kullanın. Uyumsuzluk normaldir. Çok büyük bir fark genellikle ikinci bir cihazın, bir CI çalıştırıcısının veya başka bir ekip üyesinin aynı hesaba faturalandırma yaptığını gösterir.
CI içindeki bir claude -p çalıştırmasının maliyetini nasıl takip ederim?
--output-format json ile çalıştırın ve sonucu claude -p "..." --output-format json | jq '.total_cost_usd' gibi bir araçla total_cost_usd üzerinden okuyun. Aynı veri yükü, model bazlı dökümü ve oturum kimliğini içerir. Bu değeri iş başına kaydedin; böylece herhangi bir ajan, pano veya ek servis olmadan işlem hattı (pipeline) bazlı harcama verisine sahip olursunuz.