TokenMetrics: AI agent token harcamasını projeye göre görünür kılmak
Claude Code, Codex CLI ve Gemini CLI loglarını yerelde okuyan bir masaüstü uygulaması, token kullanımını proje, model ve oturuma göre gösteriyor.
Şu an ne yapıyor
AI agent token kullanımını yerel loglardan toplayıp proje, model, oturum ve zaman bazında gösteriyor; tahmini maliyet ve abonelik limiti takibi sunuyor. Claude Code, Codex CLI veya Gemini CLI'ı yoğun kullanıp harcamasını görmek isteyen geliştirici kurabilir.
- Başlangıç
- Kasım 2026 — Devam ediyor
Tür
Teknolojiler
Abonelik limitine sığmaya çalışırken fark ettiğim şey, hangi proje için ne kadar token harcadığımı bilmediğimdi; yalnızca tahmin ediyordum. TokenMetrics bu tahmini bir ölçüme çevirmek için yazdığım Go uygulaması. Hikâyenin kişisel tarafı blog yazısında.
Zaten var olan loglardan okumak
Bu denemedeki ilk kararım, yeni bir sarmalayıcı ya da vekil sunucu kurmamak oldu. Agent’ların bıraktığı yerel kayıtları okuyorum: Claude Code, Codex CLI ve Gemini CLI. API hesapları için Anthropic ve OpenAI Admin API’lerini de ekleyebiliyorsunuz; log bırakmayan servisler için elle giriş ve CSV içe aktarma koydum.
Taramayı artımlı yaptım. Uygulama her dosyada nereye kadar okuduğunu saklıyor, kaydı kimliğiyle yazıyor ve aynı mesajı iki kez saymıyor. Log dosyası silinse de kaydı veritabanında tutuyorum. Bunun bedeli, ham logdan yeniden hesaplanan toplamın saklanandan düşük çıkabilmesi; yazdığım doğrulama araçları bu durumu uyuşmazlık olarak değil “sonuçsuz” olarak raporluyor.
Ölçümü okunur kılmak
Benim için asıl mesele toplamı bilmek değil, kullanımı görebilmekti. Özet ekranı bugünü, son 7 ve 30 günü; grafik servise ya da modele bölünmüş token akışını gösteriyor. Karşılaştırma ekranı model ve servis başına girdi, çıktı ve cache token’larını, istek sayısını ve tahmini maliyeti veriyor. Projeler ekranı kullanımı agent’ın çalıştığı dizine göre kırıyor. Limitler ekranı 5 saatlik ve haftalık pencereleri izliyor; eşik aşılınca işletim sistemi bildirimi ve tepsi simgesi uyarıyor.
Maliyet ve limitler
Maliyeti gömülü bir fiyat tablosundan, limit yüzdelerini sizin girdiğiniz değerlerden hesaplıyorum, çünkü sağlayıcılar abonelik limitlerini yayımlamıyor. Bu yüzden arayüzde hepsini “tahmini” diye etiketledim.
Gizlilik kapsamını dar tuttum: ayrıştırıcılarım token sayılarını ve üst veriyi (model, zaman, proje dizini, oturum kimliği) okuyor; istemleri ve cevapları okumuyor. Veriyi tek bir SQLite dosyasında yerelde tutuyorum, Admin API anahtarlarını işletim sisteminin anahtarlığına yazıyorum.
Bugünkü sınırlar ve sıradaki iş
Sürüm 0.1.0, beta. Eksikleri de var: log bırakmayan kullanım yalnızca elle girişle görünüyor; kayıtlarda hangi aboneliğe yazıldığını henüz ayırmadım; ikili dosyaları imzalamadım ve macOS uygulamasını notarize etmedim. Arayüz şimdilik yalnızca Türkçe.
Sırada birkaç haftalık gerçek kullanım verisi biriktirmek var. Veri biriktikçe hangi projenin payının tahminimden ne kadar saptığını burada paylaşacağım.
