Claude Code kullanım izleyicisi – kullanım limitlerini aşmayı önlemek için gerçek zamanlı takip aracı

 (github.com/Maciek-roboblog)
12 puan yazan GN⁺ 2025-06-21 | 2 yorum | WhatsApp'ta paylaş
  • Claude AI token kullanımı, tükenme hızı ve tüketim tahmini gibi çeşitli bilgileri gerçek zamanlı olarak terminalde gösteren bir izleme aracı
  • Her 3 saniyede bir yenilenen renkli ilerleme çubuğu, akıllı token tükenme tahmini
  • Temel plan limiti aşıldığında oturum kayıtlarını analiz ederek anında gerçek limite geçiş yapar
  • Pro/Max5/Max20/custom_max gibi kullanım planlarını otomatik olarak algılar ve destekler
  • Oturum bazında token limitine yaklaşma·aşma ve oturum sıfırlanmadan önce tükenme riski durumlarında gerçek zamanlı uyarılar
  • Gerçek Claude kullanım akışına optimize edilmiş bir arayüz sunar
  • npm, pip ile kurulum, sanal ortam (venv/virtualenv) kullanımı önerilir, Mac/Linux/Windows'un tamamını destekler

Claude oturumlarını anlamak

  • 5 saatlik rolling window yapısı
    • İlk mesajın gönderildiği andan itibaren oturum 5 saat sürer
    • Limitler oturum bazında uygulanır, birden fazla oturum aynı anda etkin olabilir
    • Gerçek sıfırlama, benim mesajımı temel alarak her 5 saatte bir gerçekleşir
  • Oturum/token sıfırlama zamanını kendi programınıza göre belirleyebilirsiniz

Kullanım senaryoları

  • İşe giden/sabah çalışan geliştiriciler: token sıfırlama zamanını iş başlangıcına (ör. 09:00) göre ayarlayarak daha verimli planlama yapabilir
  • Gece çalışanlar: gece yarısı gibi kendi programlarına uygun token sıfırlaması kullanabilir
  • Değişken limit kullananlar: custom_max modu ile gerçek ortama uygun limiti otomatik algılar
  • Global/uzaktan çalışan geliştiriciler: birden çok saat dilimi arasında geçiş, ekip bazında sıfırlama saati belirleme → iş birliği optimizasyonu
  • Hızlı durum kontrolü: yalnızca çalıştırmak yeterli (ayar gerektirmez)

Ortam kurulumunda en iyi pratikler

  • Oturum başlar başlamaz izlemeyi başlatın
    • Claude ile çalışmaya başladığınız anda izleyiciyi çalıştırın (./ccusage_monitor.py)
    • Desteklenen planlar
      • pro: yaklaşık 7.000 token (test ve hafif kullanım)
      • max5: yaklaşık 35.000 token (günlük geliştirme)
      • max20: yaklaşık 140.000 token (büyük projeler ve orta/yüksek yoğunluklu kullanım)
      • custom_max: otomatik algılama modu (gerçek kullanım geçmişine göre maksimum değer kullanılır)
    • Tüm oturum boyunca token takibi doğruluğu artar
    • Token tüketim hızı hesaplama ve limite yaklaşınca erken uyarı mümkün olur
  • Python sanal ortamı (venv) kullanın
    • Bağımlılık çakışmalarını önler, ortamı izole eder ve proje bazında yeniden üretilebilirlik sağlar
    • Kurulum ve çalıştırma: 
      python3 -m venv venv  
source venv/bin/activate  
pip install pytz
    • Kaldırmak için yalnızca sanal ortam klasörünü silmeniz yeterlidir, temiz bir kaldırma sağlar
  • Özel shell alias tanımlayın
    • Tekrarlayan komutları tek satırla kısaltılmış şekilde çalıştırın 
      alias claude-monitor='cd ~/Claude-Code-Usage-Monitor && source venv/bin/activate && ./ccusage_monitor.py'
    • .bashrc veya .zshrc gibi dosyalara eklenirse tek komutla izleyiciyi hemen başlatabilirsiniz

Kullanımda en iyi pratikler

  • Burn Rate (tüketim hızı) sürekli izleme
    • Token kullanımı aniden yükselirse dikkat edin
    • Kalan süre ve token miktarına göre çalışma yoğunluğunu ayarlayın
    • Oturum sıfırlaması (token başlangıç durumuna dönmesi) öncesi ve sonrası büyük refactoring gibi işleri zamanlayın
  • Stratejik oturum planlaması
    • Büyük işleri token sıfırlamasından hemen sonra başlatın, limite yaklaşınca hafif işler yapın 
      ./ccusage_monitor.py --reset-hour 9
    • Oturum başına 5 saat kuralını kullanarak birden fazla oturumu çakışmalı şekilde yönetebilirsiniz
  • Saat dilimini açıkça belirtin
    • Gerçek çalışma/iş birliği zamanını yansıtarak doğru token sıfırlama tahmini ve takvim yönetimi sağlayın 
      ./ccusage_monitor.py --timezone Asia/Seoul
    • Birden fazla ülke veya ekiple çalışırken zaman farkı hatalarını önler, oturum bitiş zamanındaki karışıklığı azaltır

Optimizasyon ipuçları

  • Terminal ortamı ayarı
    • En az 80 karakter genişliğinde terminal önerilir
    • Görsel geri bildirimi en üst düzeye çıkarmak için renk desteği kullanın
    • Sürekli izleme için ayrı bir özel pencere önerilir
  • İş akışına entegrasyon
    • tmux gibi terminal multiplexer'ları kullanarak geliştirme ile eşzamanlı izleme yapabilirsiniz 
      tmux new-session -d -s claude-monitor './ccusage_monitor.py'  
tmux attach -t claude-monitor
  • Çoklu oturum stratejisi
    • Her oturum için sabit 5 saat, çakışan oturumları aynı anda yönetmek mümkündür
    • Uzun işleri birden çok oturuma dağıtın, her oturumun limiti/bitiş süresine dikkat edin

Gerçek iş akışı örnekleri

  • Büyük proje geliştirme 
    ./ccusage_monitor.py --plan max20 --reset-hour 8 --timezone America/New_York
    • 08:00 token sıfırlaması → ana özellik geliştirmeye başlama
    • 10:00'da Burn Rate kontrolü sonrası çalışma hızını ayarlama
    • 12:00'de öğleden sonraki planı gözden geçirme ve düzenleme
    • 14:00'te yeni oturum açıp karmaşık sorunları ele alma
    • 16:00'da hafif işler/akşam oturumu hazırlığı
  • Öğrenme/deney odaklı kullanım 
    ./ccusage_monitor.py --plan pro
    • Hafif öğrenme ve deneysel kod yazımı için uygundur
  • Sprint odaklı yoğun geliştirme 
    ./ccusage_monitor.py --plan max20 --reset-hour 6
    • Yoğun ve yüksek miktarda token tüketimi beklenen geliştirme için özelleştirilmiş ayar

İlgili okumalar

2 yorum

 
GN⁺ 2025-06-21
Hacker News görüşleri

  • Claude'un şeffaflık eksikliği sinir bozucu geliyor ve bu fikri gerçekten çok beğendiğimi paylaşmak istiyorum Claude Code'un masaüstü uygulamasına kıyasla temel avantajı bağlamı ve limit yönetimini daha iyi yapabilmesi (ör. compact modu, kalan kapasite % göstergesi), ama yine de bunun henüz yeterli olmadığı hissi var Ek bir tavsiye olarak, proje README'sinde çok fazla emoji kullanılmasının bana kişisel olarak oldukça profesyonellik dışı geldiğini ve sanki AI tarafından düzgün yönetilmeden sadece "vibe" ile kodlanmış bir proje gibi bir kaygı uyandırdığını paylaşmak istiyorum

    • Ben yazılım dünyasına ilk girdiğim zamanlarda, bir codebase'de emoji kullanırken yakalansan akıl hastanesine gönderilecekmişsin gibi bir ortam vardı Şimdi dönem tamamen değişti; emojileri görsel olarak bağlamı düzenlemek için sık kullanıyorum Artık kodlarım beni mutlu edecek kadar çok emoji içeriyor

    • Bugünlerde startup'larda ya da genç şirketlerde bu tarz emoji stilini çok görüyorum Muhtemelen Notion etkisi büyük Bizim şirkette liste, sayfa ya da takvim daveti gibi bir şey oluştururken bile hep emoji seçiyoruz

    • AI coding için yapılmış bir yazılıma böyle yorumlar gelmesi gerçekten ironik geliyor

    • Koda gerçekten bakarsanız, 400 satırlık tek bir Python dosyasının sadece ccusage etrafında bir wrapper olduğunu görürsünüz Bu yüzden böyle hissetmek anlaşılabilir bence

    • AI'nın yazdığı PR açıklamalarında ya da README'lerde prompt'a mutlaka "kısa, süslü ifadeler veya emoji olmadan" şartını ekliyorum Bunu yapınca dikkat dağıtan emoji partisi düzgün bir dokümana dönüşüyor Tabii duruma göre değişebilir

  • Ben ccusage'in geliştiricisiyim; insanların açık kaynağımızı farklı şekillerde kullanmasından mutluyum Happy vibe coding! diye pozitif bir mesaj bırakıyorum

  • Referans olması için, geçmişte bir oturumda gördüğüm en yüksek token limiti yaklaşık 337,492 idi ve Max20 planı ile Opus'u yaklaşık %99 oranında kullandığımı paylaşayım Claude Code'u 27 Mayıs'tan beri kullanıyorum; toplamda 1,374,439,311 token tüketmişim, bu da yaklaşık 3,397 dolara denk geliyor

    • Ben de Max20 planıyla yaklaşık 2,100 dolarlık kullanım yapmış durumdayım API'de gerçekten çok büyük bir marj mı var, yoksa zarar mı ediyorlar merak ediyorum Her gün kullanıyorum ama aşırı kullandığımı düşünmüyorum

    • Opus'ta sık sık rate limit'e takılıyor musunuz, ayrıca Sonnet'e kıyasla yavaş geldiği oluyor mu merak ediyorum

  • Şu ana kadar kullandığım token'ların limite ne kadar yaklaştığını sezgisel olarak anlayabiliyorum Konuşmanın kendisinin de üst sınıra dayanmak üzere olduğu anları hissediyorum; o noktada kalan son kaynakla bir özet oluşturup yeni bir sohbete geçerek çalışmaya devam ediyorum Bu AI araçları artık sanki biyolojik saatimin bir parçası olmuş gibi Her hafta çarşamba günü ChatGPT'nin haftalık limiti sıfırlandığı için, çarşamba yeni pazar günü gibi hissettiriyor

  • Token kullanımı zaman penceresi geçse bile %100'e ulaşmazsa sıfırlanmıyor gibi görünüyor Örneğin %90 kullanıp bir sonraki pencereye geçiyorsunuz, sonra kalan %10'u da hızla tüketince uzun süre beklemek zorunda kalıyorsunuz

  • Birden fazla Claude Code oturumunu aynı anda kullanmayı mümkün kılan bir UI aracı yaptım: crystal Aynı anda birçok özellikle uğraştığım için hesabımın limitlerine sık sık yaklaşıyorum Genelde limite reset zamanına yakın ulaşıyorum ama ne zaman ara vermem gerektiğini önceden bilmek daha iyi olurdu

    • Claude Code'u çok yoğun kullanıyorum ama worktree'ler ve çoklu oturum çalışmaları için kendi araçlarımı yazmaya çekiniyorum çünkü git bilgime yeterince güvenmiyorum Açıkçası bu aracı kullanmak bile biraz korkutuyor; ideal olarak her worktree'yi container içinde çalıştırmak isterdim ama bunu Crystal kadar akıcı hale getirmek zor gibi geliyor

    • Bu aracı seviyorum ama Crystal ismi, daha önce kullandığım programlama dili Crystal ile karışıyor

    • GitHub'da bir issue bırakırsanız (burada), benim usage monitor'ümle entegrasyon denemesi yapabilirim

    • Harika olmuş Ben de bunu proje bazında değil, eşzamanlı 5 proje için de sağlayan bir araç yaptırmayı neredeyse Laude'a söyleyecektim Kullanım alanı çok fazla, buna katılıyorum

  • Gerçekten ilginç; Pro planın token limiti gerçekten sadece 7,000 mi diye merak ediyorum Yani bu, 7,000 kelimeden bile az demek ama pratikte çok daha fazlasını kullanabiliyormuşum gibi geliyor Bu kadarsa konuşma biraz uzayınca hemen sınıra çarpması gerekirdi ama ben daha hiç yaşamadım Yoksa bu limit sadece Claude Code için mi geçerli, Claude Code'u henüz çok fazla kullanmadığım için emin değilim

    • Pro plan aylık $20. Yakın zamanda claude code erişimi açıldı Ama bazı kullanıcıların sadece birkaç sorgudan sonra limite takıldığını duydum Bu yüzden o civardaki bir sayı doğru olabilir diye düşünüyorum Sohbet arayüzündeki limit ile Claude Code limiti ayrı şeyler

  • Aşırı iyi, bunu yaptığınız için teşekkürler uv ile kurulup kurulamayacağını merak ediyorum uv bağlantısını da paylaşarak kurulum sürecini shell komutlarıyla satır satır özetlemiş

    • Eğer ilgili repo project.toml gibi bir paket yapısıyla hazırlanmış olsaydı, pipx(pipx) ile şöyle daha hızlı kurulabilirdi açıklaması

pipx install git+https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor ccusage_monitor uv tarafında da buna benzer bir komut (uvx) vardır herhalde, ama pipx ile aynı işlev ve amaçta mı emin değilim görüşü

  • Bu arada, pip ile kurulabilen neredeyse her şey uv ile de kurulabilir; yani uv ile yapmak da daha kolay olabilir bilgisini paylaşıyor

  • Bu aracın ccusage'i shell'den çağırıp çalıştırmanın dışında başka faydalı bir yanı var mı diye merak ediyorum Dürüst olmak gerekirse bu tür projeler biraz hayal kırıklığı yaratıyor ve sanki AI aracıyla tek seferde ortaya çıkarılmış gibi hissettiriyor Show HN'de tüm gerçek işin başka bir araç tarafından yapıldığından hiç bahsedilmemesi de üzücü

  • Dün Claude Code'da ilginç bir deneyim yaşadım Eski PHP ile yazılmış bir phtml tablo sayfasını yeni bir div düzenine çevirmeye çalıştı, başarısız oldu ve bana yaklaşık $4'a mal oldu WSL sorunu da olabilir ama umarım bu sık yaşanan bir şey değildir

    • Claude Code'un epey bir öğrenme eğrisi var Gereksinimleri yeterince tartışıp modele net sorular sorduracak şekilde uzun konuşma oturumları yürütmek gerekiyor Yine de bazen böyle başarısızlıklar olabilir; bu yüzden bunun çok pahalı bir araç olduğunu akılda tutmak gerek YouTuber'ların ya da blogger'ların anlattığı gibi sihir değil