Açık Kaynak Araç ile Claude Kod Kullanımını Gerçek Zamanlı İzleme

"Vibe Kodlama" çağında, yapay zeka destekli kodlama yardımcıları modern geliştirme iş akışının temel taşı haline geldi. Anthropic'in Claude Code'u, devasa kod tabanlarını anlama ve karmaşık programlama görevlerini hızlandırma yeteneğiyle özellikle güçlü bir müttefik olarak öne çıkıyor. Ancak tüm gücüne rağmen geliştiriciler genellikle yaygın ve sinir bozucu bir darboğazla karşılaşıyor: token kullanım limitlerinin belirsiz ve affetmez doğası. Yoğun bir kodlama seansı, aniden gelen "oturum sona erdi" mesajıyla kesintiye uğrayabilir ve geliştiricileri tüketimleri hakkında karanlıkta bırakabilir.

Bu kritik sorunlu noktayı doğrudan ele alan araç, geliştirici Maciek-roboblog tarafından oluşturulan, güzel tasarlanmış, açık kaynaklı bir terminal aracı olan Claude Code Usage Monitor'dür. Bu sadece bir sayaç değildir; Claude AI etkileşimleriniz için kapsamlı bir komuta merkezidir. Token yönetiminizi reaktif bir tahmin oyunundan proaktif, stratejik bir avantaja dönüştürmek için gerçek zamanlı takip, görsel ilerleme çubukları, akıllı tüketim oranı hesaplamaları ve akıllı tahminler sunar. Bu makale, bu vazgeçilmez yardımcı programı nasıl kuracağınız, kullanacağınız ve ustalaşacağınız konusunda kesin bir rehber sunmaktadır.

Neden Claude Code Usage Monitor'e İhtiyacınız Var?

Monitörün değerini anlamak için öncelikle çözdüğü zorluğu kavramak gerekir. Claude Code'un kullanımı, 5 saatlik kayan oturum penceresi sistemi tarafından yönetilir. İlgili token limitiyle birlikte bir oturum, Claude'a gönderdiğiniz ilk mesajla başlar ve tam beş saat sonra sona erer. Daha da önemlisi, bir geliştirici aynı anda birden fazla, çakışan oturumu aktif tutabilir. Sabah 10:30'da yeni bir konuşma başlatırsanız, Oturum A başlar. Öğleden sonra 12:15'te başka bir konuşma başlatırsanız, Oturum B, Oturum A ile eş zamanlı olarak çalışır.

Bu sistem esnek olsa da, manuel takibi neredeyse imkansız bir görev haline getirir. Hangi oturumun limitine yaklaşıyorsunuz? Birleşik token tüketim oranınız nedir? Özel bir araç olmadan geliştiriciler körü körüne ilerler, çalışmalarını etkili bir şekilde planlayamazlar ve düşünce akışları ortasında kesilme riskiyle karşı karşıya kalırlar, bu da odaklarını bozar ve üretkenliği raydan çıkarır.

Claude Code Usage Monitor Nasıl Kurulur ve Ayarlanır?

Claude Code Usage Monitor, kolay benimsenme için tasarlanmıştır ve hem test için hızlı bir başlangıç hem de günlük kullanım için şiddetle tavsiye edilen sağlam, üretime hazır bir kurulum sunar.

Ön Gereksinimler

Başlamadan önce sisteminizde aşağıdakilerin kurulu olduğundan emin olun:

1. Python 3.6+
2. Node.js (temel ccusage CLI aracını kurmak için)

Hızlı Başlangıç (Sadece Test İçin)

Hızlı bir değerlendirme için aşağıdaki komutları kullanabilirsiniz:Bash

# Bağımlılıkları yükleyin
npm install -g ccusage
pip install pytz

# Klonlayın ve çalıştırın
git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
cd Claude-Code-Usage-Monitor
python ccusage_monitor.py

Basit olmasına rağmen, bu yöntem paketleri global olarak kurar ve uzun vadeli kararlılık veya proje izolasyonu için ideal değildir.

Üretim Kurulumu (Önerilen)

Temiz, kararlı ve profesyonel bir kurulum için Python sanal ortamı kullanmak tartışılamaz. Proje bağımlılıklarını izole eder, sisteminizin Python kurulumuyla çakışmaları önler ve projeyi kolayca taşınabilir ve yeniden üretilebilir hale getirir.

Adım Adım Rehber:

ccusage'ı Global Olarak Kurun: Bu temel bağımlılık, Claude'dan kullanım verilerini alır.Bash

npm install -g ccusage

Depoyu Klonlayın:Bash

git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
cd Claude-Code-Usage-Monitor

Sanal Ortam Oluşturun:Bash

# Bu, proje dizininizde 'venv' adında bir klasör oluşturur
python3 -m venv venv

Sanal Ortamı Aktif Edin: Proje üzerinde çalışmak için yeni bir terminal oturumu başlattığınızda bunu her seferinde yapmalısınız.Bash

# Linux/macOS üzerinde:
source venv/bin/activate

# Windows üzerinde:
venv\Scripts\activate

Komut isteminizin artık ortamın aktif olduğunu belirten (venv) ile başlaması gerekir.

Python Bağımlılıklarını Yükleyin: Sanal ortam aktifken gerekli paketleri yükleyin.Bash

pip install pytz

Betik Dosyasını Çalıştırılabilir Yapın (İsteğe Bağlı, Linux/macOS için):Bash

chmod +x ccusage_monitor.py

Monitörü Çalıştırın:Bash

# Linux/macOS üzerinde (çalıştırılabilir yapıldıysa):
./ccusage_monitor.py

# Tüm sistemlerde:
python ccusage_monitor.py

Günlük Kullanım ve Profesyonel İpuçları

Kurulum tamamlandıktan sonra günlük iş akışınız basitleşir:Bash

cd Claude-Code-Usage-Monitor
source venv/bin/activate
./ccusage_monitor.py
# İşiniz bittiğinde, sadece şunu yazın:
deactivate

Maksimum verimlilik için bir shell takma adı (alias) oluşturun. ~/.bashrc veya ~/.zshrc dosyanıza aşağıdaki satırı ekleyin:Bash

alias claude-monitor='cd ~/path/to/Claude-Code-Usage-Monitor && source venv/bin/activate && ./ccusage_monitor.py'

Artık terminalinizde sadece claude-monitor yazarak monitörü herhangi bir yerden başlatabilirsiniz.

Monitöre Hakim Olmak: Kullanım ve Yapılandırma

Monitörü çalıştırmak, betiği yürütmek kadar basittir, ancak gerçek gücü komut satırı seçenekleriyle ortaya çıkar.

Temel Kullanım:

Varsayılan ayarlarla (Pro plan, ~7.000 token) çalıştırmak ve düzgünce çıkmak için Ctrl+C'ye basın.

Yapılandırma Seçenekleri:

Planınızı Belirtin: Doğru limitler için monitörü abonelik seviyenize göre ayarlayın.Bash

# Pro plan (~7.000 token) - Varsayılan
./ccusage_monitor.py --plan pro

# Max5 plan (~35.000 token)
./ccusage_monitor.py --plan max5

# Max20 plan (~140.000 token)
./ccusage_monitor.py --plan max20

# En yüksek önceki oturumunuzdan otomatik algılama
./ccusage_monitor.py --plan custom_max

Sıfırlama Saatlerini ve Saat Dilimlerini Özelleştirin: Monitör varsayılan olarak Europe/Warsaw saat dilimini kullanır. Daha sezgisel planlama için yerel çalışma saatinizle hizalayın.Bash

# US Eastern Saati'nde sıfırlama saatini 9 AM olarak ayarlayın
./ccusage_monitor.py --reset-hour 9 --timezone US/Eastern

# Uluslararası ekip işbirliği için UTC kullanın
./ccusage_monitor.py --timezone UTC

Kaputun Altında: Akıllı Özellikler ve Nasıl Çalıştıkları

Monitörün zarafeti, net, uygulanabilir içgörüler sağlayan gelişmiş arka uç özelliklerinde yatar.

• Gerçek Zamanlı İzleme: Araç, sorunsuz, titreşimsiz bir ekranla her 3 saniyede bir yenilenerek token tüketiminize canlı bir bakış sunar.
• Görsel İlerleme Çubukları: Token ve zaman ilerlemesi için renk kodlu çubuklar, durumunuz hakkında anında, sezgisel bir anlayış sağlar. Yeşil güvende olduğunuzu, sarı bir uyarıyı ve kırmızı limite yaklaştığınızı gösterir.
• Akıllı Tahminler: Monitör sadece mevcut kullanımı göstermez; son bir saatteki token tüketiminizi analiz ederek bir "tüketim oranı" hesaplar. Bu hıza dayanarak, oturum sıfırlanmadan önce tokenlarınızı tüketip tüketmeyeceğinizi tahmin eder ve bir uyarı görüntüler.
• Akıllı Plan Değiştirme: Monitörü varsayılan pro planında çalıştırırsanız ancak kullanımınız ~7.000 token limitini aşarsa, araç bunu fark edecek kadar akıllıdır. Otomatik olarak custom_max moduna geçecek, gerçek daha yüksek limitinizi bulmak için geçmişinizi tarayacak ve sizi değişiklik hakkında bilgilendirerek sorunsuz bir şekilde izlemeye devam edecektir.

Gerçek Dünya İş Akışları ve En İyi Uygulamalar

Faydalarını en üst düzeye çıkarmak için monitörü geliştirme alışkanlıklarınıza entegre edin.

Yaygın Senaryolar:

• Sabah Geliştiricisi: Güne monitörü çalışma programınızla hizalayarak başlayın. Bash

# New York'ta 9 AM başlangıcıyla sıfırlamaları hizalayın
./ccusage_monitor.py --plan max5 --reset-hour 9 --timezone America/New_York

• Değişken Limitlere Sahip Yoğun Kullanıcı: Tam token limitinizden emin değilseniz, monitörün sizin için bulmasına izin verin. Bash

# En yüksek önceki kullanımınızı otomatik algılayın
./ccusage_monitor.py --plan custom_max

• İş Akışı Entegratörü: Monitörü, istediğiniz zaman bağlanabileceğiniz kalıcı izleme için özel bir tmux veya screen penceresinde çalıştırın. Bash

tmux new-session -d -s claude-monitor './ccusage_monitor.py --plan max20'
# Durumu daha sonra kontrol edin
tmux attach -t claude-monitor

En İyi Uygulamalar:

1. Erken Başlayın: En doğru takip ve tahminler için kodlama oturumunuzun başında monitörü başlatın.
2. Sanal Ortam Kullanın: Bu, kararlı, çakışmasız bir deneyim için 1 numaralı en iyi uygulamadır.
3. Tüketim Oranınızı İzleyin: Oranın yükseldiğini görürseniz, limite yaklaştıkça daha az token yoğunluklu görevleri düşünün. Büyük yeniden düzenlemeleri veya kod üretimini yeni bir oturumunuz olduğunda planlayın.
4. Saat Diliminizi Ayarlayın: Zihinsel saatinizle uyumlu doğru sıfırlama saati tahminleri için daima --timezone bayrağını kullanın.

Sorun Giderme

No active session found hatasıyla karşılaşırsanız, çözmek için adımlar şunlardır:

1. Bir Oturum Başlatın: Claude web arayüzüne gidin ve en az iki mesaj gönderin. Bu, bir oturumun düzgün bir şekilde başlatıldığından ve kaydedildiğinden emin olur.
2. Yapılandırma Yolunu Belirtin (Gerekirse): Nadir durumlarda, Claude'un yapılandırma yolu standart olmayabilir. Manuel olarak belirtebilirsiniz: Bash

CLAUDE_CONFIG_DIR=~/.config/claude ./ccusage_monitor.py

Sonuç: AI İş Akışınızın Komutasını Almak

Claude Code Usage Monitor, topluluk odaklı, açık kaynaklı araçların geliştiricilerin günlük karşılaştığı pratik sorunları nasıl çözebileceğinin güçlü bir örneğidir. Kullanıcıyı belirsiz limitlerin pasif bir kurbanından, kendi iş akışının yetkilendirilmiş bir komutanına yükseltir. Netlik, öngörülebilirlik ve kontrol sağlayarak, bu araç, sürekli kesinti korkusu olmadan Claude Code'un tüm gücünden yararlanmanızı sağlar. AI'yı zanaatlarına sorunsuz ve verimli bir şekilde entegre etmek isteyen her ciddi geliştirici için vazgeçilmez bir yardımcı programdır.