Claude Code token kullanımını nasıl kontrol edersiniz: ajanlarınızın harcamalarını görmek için 4 yol

Eğer Claude Code'u günde birkaç dakikadan fazla çalıştırıyorsanız, token'lar sizin gerçek para biriminizdir. Ne zaman bir hız limitine ulaştığınızı, aboneliğinizi ne kadar hızlı tükettiğinizi ve uzun bir ajan çalışmasının değerli olup olmadığını belirler. Sorun şu ki, Claude Code size bu sayıyı yüksek sesle söylemiyor. Gitmeli ve bakmalısınız.

İşte Claude Code token kullanımını kontrol etmenin dört yolu, en hızlı yerleşik komuttan her ajanı gerçek zamanlı olarak gösteren bir canlı ölçüme kadar. Ne kadar derine inmeniz gerektiğine göre birini seçin.

1. En hızlı yol: /cost komutu

Herhangi bir Claude Code oturumunun içinde, yazın:

/cost

Claude Code, mevcut oturum için toplam maliyeti ve token sayısını, ayrıca ne kadar süre çalıştığını yazdırır. "Bu oturum şimdiye kadar ne harcadı" sorusuna en hızlı cevaptır ve hiçbir şey yüklemenizi gerektirmez.

Ancak dikkat: /cost, bulunduğunuz oturumla sınırlıdır. Size dün ne harcadığınızı, farklı bir projenin maliyetini veya belirli bir ajanın diğerine nasıl karşılaştırıldığını söylemez. Tek bir hızlı kontrol için mükemmeldir. Herhangi bir tarihsel bilgi için okumaya devam edin.

2. Kaynağı okuyun: oturum transkriptleri

Claude Code, her oturumu disk üzerine JSONL transkripti olarak yazar. macOS ve Linux'ta bunları burada bulacaksınız:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

Her satır bir mesajdır ve asistan mesajları, tam sayılarla birlikte bir usage nesnesi taşır: input_tokens, output_tokens ve önbellek alanları (cache_creation_input_tokens, cache_read_input_tokens). Önbellek okumaları ilginç kısımdır: taze girdi kadar ucuzdur, bu nedenle yüksek önbellek vurma oranına sahip bir oturum, ham token sayısının önerdiğinden çok daha az maliyetlidir.

Bu gerçek bilgidir. Aşağıdaki iki araç da dahil olmak üzere diğer tüm araçlar, bu aynı dosyaları okur. Kendi raporunuzu yazmak istiyorsanız, JSONL üzerinde jq kullanarak oraya ulaşabilirsiniz.

3. Özel bir CLI: ccusage

Kendi ayrıştırıcınızı yazmak istemiyorsanız, topluluk ccusage aracı bu transkriptleri okur ve günlük, aylık ve oturum başına toplamları toplar:

npx ccusage@latest

Bu iyi bir orta yol: /cost'tan daha fazla tarih, jq ile manuel olarak çalışmaktan daha az iş. Ancak terminalde kalır, bu nedenle "ne harcadım" sorusunu yanıtlar ama "hangi ajan, şu anda, bunu harcıyor" sorusunu yanıtlamaz.

4. Canlı bir ölçüm: AgentsRoom'da oturum başına kullanım

Yukarıdaki üç yöntem, bir kör nokta paylaşır: geçmişe yönelik ve tek akışlıdır. Birden fazla ajanı paralel çalıştırdığınız anda, her ajanın kullanımını canlı olarak, her terminalde bir komut yazmadan görmek istersiniz.

Bu, Claude Code token kullanım ölçerinin AgentsRoom'da yaptığı şeydir. Aynı JSONL transkriptlerini okur, oturum başına ve şunları gösterir:

• her ajan için girdi, çıktı ve önbellek token'ları, oturum çalışırken güncellenir
• önbellek vurma oranı, bağlamın yeniden gönderilmek yerine yeniden kullanıldığını görebilmeniz için
• bir oturum hız limitine yaklaşırken bir uyarı

Kullanımı oturum başına atfettiği için, birden fazla Claude Code hesabı yan yana çalıştırdığınızda bile doğru kalır: her hesap kendi toplamlarını tutar, bu da müşteri başına yeniden faturalandırmayı kolaylaştırır.

Hangisini kullanmalısınız

• Sadece bu oturumun sayısına mı ihtiyacınız var? /cost.
• Özel bir rapor oluşturmak mı istiyorsunuz? JSONL transkriptlerini doğrudan okuyun.
• Terminalde günlük ve aylık toplamlar mı istiyorsunuz? ccusage.
• Birden fazla ajan çalıştırıyor ve kullanımını canlı olarak, her ajan ve her hesap için izlemek mi istiyorsunuz? AgentsRoom'daki ölçeri kullanın.

Kullanımı kontrol etmek birinci adımdır. Sayılar sizi rahatsız ediyorsa, bir sonraki adım onları azaltmaktır: Claude Code token maliyetlerini nasıl azaltacağınızı görmek için, gerçekten önemli olan kaldıraçları inceleyin, önbellek yeniden kullanımıyla başlayarak.