SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor · Güncellendi 2026-10-24

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 üç farklı Claude Code harcama takip aracı ortaya çıktı

Aynı gün üç 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 aracı oturumunun maliyetinin artık belirgin olmamasıdır. Bir sohbetin maliyeti kabaca ekranda görebildiğiniz kadardır. Bir aracı ise yirmi dosyayı okur, test paketini çalıştırır ve her adımda tüm konuşmayı yeniden gönderir; bu nedenle 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ı boşalan bir kullanım çubuğudur. Bu üç aracın her biri, bu boşluğun farklı bir kısmını doldurmaktadır.

Biçim 1: Yerel günlük ayrıştırıcısı size bugünün maliyetini söyler

Claude Code, her konuşmayı ~/.claude/projects/<project>/<session-id>.jsonl konumunda JSON Lines (JSONL) olarak saklar; burada <project>, alfanümerik olmayan karakterlerin - ile değiştirildiği çalışma dizini yolunuzdur. Bu dosyadaki her asistan yanıtı, isteğine ait token sayılarını taşır. Bir günlük ayrıştırıcısı bunları toplar ve fiyatlandırır.

ccusage, çoğu kişinin kullandığı yöntemdir. Kurulum gerektirmez:

npx ccusage@latest daily
npx ccusage@latest daily --breakdown
npx ccusage@latest blocks
npx ccusage@latest session --json

daily tarihe göre toplamları alır. --breakdown her satırı modele göre böler; bir Opus öğleden sonrasının haftanın büyük kısmına nasıl denk geldiğini bu şekilde anlarsınız. blocks, aboneliğin sıfırlandığı beş saatlik pencereye göre gruplandırır. session konuşma başına toplamları verir ve daily --instances projeye göre gruplandırır; böylece hangi deponun maliyetli olduğunu görebilirsiniz. Aralığı sınırlamak için --since ve --until 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, karşılaştırma yapıyorsanız önemli olan Codex ve OpenCode dahil olmak üzere diğer aracı CLI'larını da okur.

Fiyatlandırma bir model fiyat tablosundan gelir ve aracın üç maliyet modu vardır. --mode auto, mevcut olduğunda Claude Code'un dosyaya yazdığı costUSD değerini kullanır ve mevcut olmadığında token sayılarından hesaplama yapar. --mode calculate her zaman tokenlardan hesaplama yapar ve kaydedilen maliyetleri yok sayar. --mode display yalnızca kaydedilen maliyetleri gösterir ve maliyeti olmayan satırlar için $0.00 yazdırır. Bir toplam yanlış görünüyorsa, aynı raporu calculate altında ve ardından display altında çalıştırın. İkisi arasındaki büyük bir fark, çoğu girdinin kaydedilmiş bir maliyet taşımadığı anlamına gelir, bu nedenle okuduğunuz her şey bir tahmindir. Sözleşmeli fiyatlar ödüyorsanız, bir ccusage.json yapılandırma dosyasındaki defaults altında pricingOverrides, bireysel modellerin fiyatını değiştirir.

Aynı veriler isteminizi besleyebilir. 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 içine 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 şey, bu makinede gerçekleşmeyen işlemlerdir. İkinci bir dizüstü bilgisayar, claude.ai üzerindeki bir oturum veya bir ekip arkadaşının çalışması; bu transkriptler ilgili disklerde yaşar. Eski veriler de eksiktir, çünkü transkriptler cleanupPeriodDays ayarı altında varsayılan olarak 30 gün sonra temizlenir, bu nedenle arşivlemediyseniz geçen çeyrek gitmiştir.

Bir risk daha vardır ve bu yapısal bir risktir. Anthropic belgeleri, girdi biçiminin Claude Code'un dahili bir parçası olduğunu ve sürümler arasında değiştiğini belirtir, bu nedenle bu dosyaları doğrudan ayrıştıran betikler herhangi bir sürümde bozulabilir. Bu, bu biçimdeki her araç için geçerlidir. Bu aynı zamanda JSONL üzerinde elle yazılmış bir jq tek satırlık komutunun göründüğünden daha kötü bir fikir olmasının nedenidir: bakımı yapılan ayrıştırıcılar biçim değişikliklerini sizin yerinize takip eder, ancak sizin tek satırlık komutunuz bir alan yeniden adlandırıldığı gün kendinden emin bir şekilde yanlış bir sayı rapor edecektir.

Son olarak, dolar rakamının bir abonelik üzerinde bir uyarıya ihtiyacı vardır. Pro veya Max plan sınırınız dahilindeki kullanım token başına faturalandırılmaz, bu nedenle sayı, tokenlarınızın liste API fiyatlarında ne kadara mal olacağıdır. Kullanımınızın ne kadar yoğun olduğunu ölçer. Faturanız değildir. İstisna kullanım kredileridir: bunları açarsanız, plan sınırını aşan kullanım standart API fiyatlarından 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 olunacağı ise, bu karşılaştırma başlı başına bir egzersizdir: Claude aboneliğine karşı API faturalandırması bölümüne bakın.

Biçim 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 hiç açmaz. Bir oturum içindeyken /usage komutunu çalıştırın. En üstteki Session bloğu, model bazlı token sayılarını ve mevcut oturum için 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; 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ın plana dahil olduğunu ve faturalandırma için geçerli 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 bazlı Enterprise planlarında tükenecek bir kullanım kotası yoktur, çünkü her token API fiyatları üzerinden faturalandırılır. Bu planlarda ekran ayrıca son kullanımları; yetenekler, alt ajanlar, eklentiler ve bireysel MCP sunucuları bazında toplamın yüzdesi olarak dağıtır. Uzun bağlam veya önbellek isabeti (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. Çubuk düşük seviyede değil tamamen boşaldığında, ekran pencerenin kapandığını bildirir ancak çalışmaya nasıl devam edileceğini göstermez; limite ulaştığınızda ne yapmanız gerektiği model, bağlam ve plan tercihine bağlı ayrı bir karardır.

Tek bir geliştiricinin ötesinde, rakamlar hesap düzeyine taşınır. Bir API organizasyonu; Console kullanım 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 sunar; ancak bu rapor kullanım kredisi harcamalarını kapsar: koltuk kotası dahilindeki kullanım dolar cinsinden ölçülmez. Enterprise planı buna bir analiz 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 farklı 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, aylık ise 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 referans noktası olarak kabul edin, ekibiniz için bir tahmin olarak değil. Ekstrapolasyon yapmadan önce bir pilot grup çalıştırın ve ö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 "kaçak" ajanı bugün yakalamak için değil, geçmişe dönük inceleme aracı olarak kullanılırlar. Kaçak bir ajanı yakalamak raporlara değil sınırlamalara ihtiyaç duyar; bu konu bir VPS üzerinde ajan maliyetlerini sınırlandırma başlığının konusudur.

Şekil 3: Kendi OpenTelemetry yığınınız hangi istemin gerilediğini size bildirir

Claude Code, bir ortam değişkeni ayarladığınızda OpenTelemetry metriklerini ve olaylarını yayınlar; bu, kullanıcı bazlı token ve maliyet verilerini gerçek zamanlıya yakın bir şekilde kontrolünüz altındaki bir sisteme aktaran tek seçenektir. Metrikler, USD cinsinden claude_code.cost.usage, token cinsinden claude_code.token.usage, claude_code.session.count ve claude_code.active_time.total değerlerini içerir.

Token metriği, öznitelikleri 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 bilgilerini de içerir. Kendi yapılandırdığınız MCP sunucularının ve özel alt ajanlarınızın adları, Bash komutlarını ve araç girişlerini de araç olaylarına ekleyen OTEL_LOG_TOOL_DETAILS=1 değişkenini ayarlamadığınız sürece custom olarak gelir. Bu, hiçbir kontrol panelinin ulaşamayacağı soruları yanıtlamak için yeterlidir: faturanın ne kadarının kendi işlemlerinizden ziyade alt ajanlardan kaynaklandığı, bir MCP sunucusunun girdi token'larınızı ikiye katlayıp katlamadığı veya birisi CLAUDE.md dosyasını düzenledikten sonra önbellek okumalarının çöküp çökmediği. Ö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. 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ğişkenini Langfuse'a yönlendirmek projeyi boş bırakır ve okunmaya değer bir hata mesajı vermez. Span dışa aktarma özelliği mevcuttur, ancak CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 ve OTEL_TRACES_EXPORTER değişkenlerini ayarlayana 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 sınırlamalarını paylaşır. Langfuse, kendi kodunuzun her span'i istemi, modeli ve maliyetiyle oluşturduğu, API üzerinde kendinizin inşa ettiği 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 kurma

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 WireGuard tüneli içindeki adresidir; böylece toplayıcıya yalnızca kendi makinelerinizden erişilebilir. Portun önündeki adres burada kritik bir işlev görür, çünkü Docker tarafından yayınlanan 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 dosyasını oluşturun:

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 (host) 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 collector

Toplayı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şlatma döngüsüne girer.

Şimdi Claude Code'u bu noktaya yönlendirin. Claude Code çalıştıran her makinede, ~/.claude/settings.json dosyasına şunları 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 görmelisiniz. Dışa aktarıcı (exporter) 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 ve portun eşleştiğini doğrulayın, çünkü http/protobuf 4318 numaralı porta, grpc ise 4317 numaralı porta gider; uyumsuzluk durumunda işlem sessizce başarısız olur. claude --debug-file /tmp/claude-debug.log dosyasını çalıştırın ve Claude Code'un OTel dışa aktarma hatalarını bildirdiği [3P telemetry] satırlarını kontrol edin.

Tek bir makine kullanıyorsanız ve sunucunuz yoksa, yukarıdakilerin tamamını atlayın. OTEL_METRICS_EXPORTER=prometheus ayarını yapın; Claude Code, http://localhost:9464/metrics adresinde bir scrape uç noktası (endpoint) sunacaktı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 scrape işlemi geçerli Prometheus metin formatında kalır. Metrik isimleri değişmez; ancak otlp,prometheus gibi dışa aktarıcıları birleştiren bir ayar kullanıldığında birimler korunur.

Bu yapılandırmayla ilgili bir gizlilik kararı bulunmaktadır. Varsayılan olarak makineden yalnızca sayaçlar ve meta veriler çıkar; komut metni veya araç çıktısı gönderilmez. OTEL_LOG_USER_PROMPTS=1, dışa aktarılan olaylara komut metnini ekler; OTEL_LOG_TOOL_CONTENT=1 ise araç çıktılarını izleme aralıklarına (trace spans) dahil eder. Bu sinyallerden herhangi birini dışa aktardığınızda, telemetri kutunuz kaynak kodunuzu ve bağlam içindeki diğer her şeyi tutar. Bu özellikleri bilinçli olarak açın ve öncesinde 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ırmıyorsa, Claude Code'un yazdığı konumu okumuyor demektir. CLAUDE_CONFIG_DIR bu konumu değiştirir ve ayrıştırıcıya (parser) bu durumun bildirilmesi gerekir. Satırlar mevcut ancak yaklaşık bir ay öncesinde kesiliyorsa, bu cleanupPeriodDays özelliğinin tasarlandığı gibi çalıştığı anlamına gelir: transkriptler varsayılan olarak 30 gün sonra silinir.

İ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. Yerel rakamlar, sözleşmeli fiyatları yapılandırmadığınız sürece standart liste fiyatları üzerinden token sayıları ile hesaplanır: /usage için yönetilen ayarlardaki 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 kullanım sayfası esas alınmalıdır.

Aynı işi yapmanıza rağmen maliyet arttı. Başka bir şey yapmadan önce önbellek (cache) 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 ara, 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 temsilcilerle (subagents) dolu bir gün imkansız görünüyor. Her alt temsilci kendi bağlam penceresini (context window) ç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 detay için OTel verileri, claude_code.token.usage üzerindeki query_source özniteliği aracılığıyla bunları ayırır. Bir günlük ayrıştırıcısı size toplamı gösterecek ancak detayları tahmin etmenize neden olacaktır.

FAQ

ccusage, Max plan kapsamında faturalandırıldığım tutarı gösterir mi?

Hayır. Abonelik planı limitleri 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ğini anlamak için iyi bir göreceli ölçüdür ve projeleri veya modelleri birbirleriyle kıyaslamak için kullanışlıdır. Ödemeniz gereken tutar için Console kullanım sayfası API faturalandırmasını, plan faturalandırma sayfası ise abonelik ücretlerini kapsar. Kullanım kredileriniz aktifse, 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, 30 günlük saklama süresini kontrol eder. Anthropic, giriş formatını dahili olarak tanımlar ve sürümler arasında değişebileceğini belirtir; bu nedenle veriyi 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 bu mümkün değildir. Langfuse OTLP uç noktası izleri (traces) kabul eder; ancak Claude Code varsayılan olarak span yerine metrik ve günlük olayları dışa aktardığından verinin ulaşacağı bir yer yoktur. Span dışa aktarımı, manuel olarak açmanız gereken bir beta özelliğidir; Langfuse'un kendi Claude Code entegrasyonu ise oturum dökümlerini 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 Prometheus'ta saklayın. Langfuse'u, API üzerinde kendi oluşturduğunuz ve istemi, modeli ve maliyeti taşıyan span'ler üreten 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 yapılandırılmış sözleşmeli fiyatlar yoksa, bunları standart liste fiyatları üzerinden ücretlendirir. Console ise kuruluşunuzdan tüm makineler ve tüm anahtarlar genelinde, indirimler uygulandıktan sonra fiilen tahsil edilen tutarı raporlar. Uyuşmazlık 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 ortamındaki bir claude -p çalıştırmasının maliyetini nasıl takip ederim?

İşlemi --output-format json ile çalıştırın ve sonucu, örneğin claude -p "..." --output-format json | jq '.total_cost_usd' ile total_cost_usd değerini okuyarak alın. Aynı veri paketi, model bazlı dökümü ve oturum kimliğini içerir. Bu değeri her iş için kaydedin; böylece herhangi bir ajan, gösterge paneli veya ek bir servis olmadan işlem hattı bazlı harcama takibi yapmış olursunuz.

Bu yazı işinize yaradı mı?