# 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.
- Tür: Open-Source, Desktop
- Olgunluk: Beta
- Durum: Geliştiriliyor
- Odak: AI ve AI destekli geliştirme
- Başlangıç: 2026-11-08
- Teknolojiler: Go, Wails, Svelte, TypeScript, SQLite
- Etiketler: #ai, #token, #maliyet, #gorsellestirme
- Kaynak kodu: https://github.com/muhammetsafak/TokenMetrics
- Kaynak: https://muhammetsafak.com/tr/labs/tokenmetrics-lab/
- Dil: tr-TR
- Yazar: Muhammet Şafak

---
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](https://muhammetsafak.com/tr/blog/hangi-proje-icin-ne-kadar-token-yaktim-tokenmetrics/).

## 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.