ccusage nedir? Claude Code kullanım ve maliyet raporu, kurulum, dolar tutarı ve gizlilik

Terminalde `npx ccusage@latest` (ya da `bunx ccusage`) yazarsın; ccusage bilgisayarındaki kodlama ajanlarının (Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot CLI dahil 18 kaynak) yerel kayıt dosyalarını okur ve günlük, haftalık, aylık ve oturum bazında token kullanımı ile tahmini maliyet tablosu verir. Kurulum, hesap ve anahtar gerekmez; analiz yerelde yapılır, dosyaları yalnız okur. Önemli: dolar tutarı bir tahmindir; belge "maliyetler tahmindir, gerçek faturayı yansıtmayabilir" diyor. Aboneliktesen tutar, aynı kullanımın kullandıkça-öde fiyatıyla ne tutacağını gösterir, ödediğin ücret değildir. MIT lisanslı.

Ne yapar: Kodlama ajanlarının token kullanımını ve tahmini maliyetini gösterir
Tür: Komut satırı aracı (npm paketi)
Nerede: Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI ve daha fazlası
Gereksinim: Node.js ya da Bun 1.3+
Dolar tutarı: Tahmin; gerçek fatura değil
Türkçe: Resmî kaynak yazmıyor
Ücret: Ücretsiz (MIT); hesap ve anahtar yok

ccusage ne işe yarar?

"Bu ay Claude Code'a kaç token harcadım?", "hangi sohbet en pahalıydı?", "hangi projede harcama arttı?" gibi sorulara terminalde tablo olarak yanıt verir. Kaynağı, ajanların kendi bilgisayarında tuttuğu kullanım kayıtlarıdır; hiçbir şeye giriş yapmazsın.

Token ve maliyet raporu almakNe alırsın: Günlük, haftalık, aylık tabloAyrı kurulum gerekir En pahalı oturumu bulmakNe alırsın: Oturum başına dökümAyrı kurulum gerekir

Komut	Ne gösterir
`ccusage` ya da `ccusage daily`	Bulunan tüm kaynakları güne göre.
`ccusage weekly` / `monthly`	Haftaya ve aya göre.
`ccusage session`	Oturum (sohbet) başına.
`ccusage blocks`	Claude Code 5 saatlik bloklar (--active, --recent, --token-limit).
`ccusage statusline`	Claude Code alt satırı için tek satır çıktı (Beta).
`ccusage claude daily`	Raporu tek kaynağa daraltır (claude, codex, gemini, opencode…).

Kime yarar: Claude Code ya da Codex'i yoğun kullanan ve kullanımını görmek isteyenlere. Kullanım sınırını (abonelikteki pencere) tahmin etmek için de işe yarar.

ccusage nasıl kurulur ve çalıştırılır?

Kurulum gerekmez; bir paket çalıştırıcıyla doğrudan çalıştırılır. Belge hızlı başlangıç için Bun'ı öneriyor (Bun 1.3+). Node için asgari sürüm belgede ve npm kaydında yazmıyor. Komutlar ccusage belgelerinden aynen alındı.

Bun ile› bunx ccusage

Node ile› npx ccusage@latest

pnpm ile› pnpm dlx ccusage

npm ile› npm install -g ccusage

Bun, yarn ve pnpm karşılıkları da belgede var. Kurulumu ccusage --version ve ccusage daily ile doğrularsın.

~/.claude/settings.json içine› {"statusLine": {"type": "command", "command": "bun x ccusage statusline", "padding": 0}}

Bun yoksa komut npx -y ccusage statusline. Durum satırı varsayılan olarak çevrimdışı çalışır.

Kurulum sayfasında geçen ccusage blocks --live, belgenin kendisine göre v18.0.0'da kaldırıldı; kullanma.

ccusage nasıl kullanılır?

Terminalde komutu çalıştırırsın; tarih aralığı, JSON çıktı ve proje süzgeci gibi seçenekler var.

Mayıs ayı özeti› npx ccusage@latest monthly --since 20260501 --until 20260531

Model kırılımıyla, JSON olarak› npx ccusage@latest daily --breakdown --json

Tek projeyi süz› npx ccusage@latest daily --project projem

Ağa çıkmadan çalıştır› npx ccusage@latest daily --offline

Claude Code kayıtlarını ccusage ~/.config/claude/projects/ ve ~/.claude/projects/ klasörlerinden okur; başka klasörde tutuyorsan CLAUDE_CONFIG_DIR ayarla. Claude Code kayıtları varsayılan olarak yalnız 30 gün tutulabilir (cleanupPeriodDays), eski aylar boş çıkabilir.

ccusage hangi ajanlarla çalışır?

Claude CodeVar	Yerel kayıtlar; durum satırı ve 5 saatlik blok özellikleri yalnız burada.
Codex, OpenCode, Amp, Droid, Gemini CLI, GitHub Copilot CLI ve diğerleriVar	Her birinin yerel kayıt klasörü okunur; bazı kaynaklar Beta ya da Deneysel işaretli.
Birden çok bilgisayarYok	Yalnız bu makinedeki yerel dosyaları okur; çoklu cihaz desteği yok (issue #222 açık).

Codex'in sıkıştırılmış (.jsonl.zst) kayıtlarının atlandığını bildiren açık bir kayıt var (#1888, 14.10.2026).

ccusage neye erişir, veri gönderiyor mu?

Okur

Ajanların yerel kullanım kayıtları (Claude Code için ~/.config/claude/projects ve ~/.claude/projects; Codex için ~/.codex ve benzeri) ve isteğe bağlı bir yapılandırma dosyası.

Yazar

Belge "salt okunur: ccusage dosyaları yalnız okur, hiç değiştirmez" diyor. Raporu terminale yazar; durum satırı Claude Code'a tek satır metin döner.

Veri

Belgeye göre analiz tamamen yerel ve kullanım verin bilgisayarından çıkmıyor. Fiyat tablosu için ağ kullanılabilir (LiteLLM, models.dev ve geçmiş fiyat çizelgeleri); --offline ağsız çalışır. Belgede telemetri hakkında bir ifade yok; bu "telemetri yok" demek değildir, kesin bilgi için açık kaynak koda bak.

GitHub Security Advisories ve OSV taramasında kayıt yok ve depoda SECURITY.md yok; bu "güvenli" demek değildir.

ccusage ücretsiz mi? Dolar tutarı ne demek?

Evet. MIT lisanslı açık kaynak; plan, hesap ya da anahtar yok. README'de sponsor tanıtımları var (bir ekip maliyet izleme ürünü gibi), ama araç için gerekli değiller. GitHub lisans alanı "NOASSERTION" gösteriyor, çünkü LICENSE dosyası depo kökünde değil bir alt klasörde.

Gösterdiği dolar tutarı bir tahmindir. Belge: "Costs are estimates and may not reflect actual billing". Aboneliktesen (Pro ya da Max gibi) tutar, aynı kullanımın kullandıkça-öde API fiyatıyla ne tutacağını gösterir, aboneliğine kesilen ücret değildir; belge bunu "abonelik değeri" olarak anlatıyor ve plan adlarını anmıyor. Fiyatı olmayan bir modelin maliyeti sessizce 0 çıkabilir (issue #1736).

Yapabilirsin

MIT: kullanmak, değiştirmek serbest

Yasak

Dolar tutarını fatura ya da bütçe kanıtı olarak kullanma

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
"No Claude Code usage data found"	Kayıtlar ~/.config/claude/projects ya da ~/.claude/projects altında olmalı; başka yerdeyse CLAUDE_CONFIG_DIR ayarla (virgülle birden çok klasör).
Eski aylar boş ya da eksik	Claude Code kayıtları varsayılan olarak yalnız 30 gün tutulabilir; cleanupPeriodDays ayarı değiştirilebilir. Silinmiş kayıt görünmez.
Bir modelin maliyeti 0 dolar görünüyor	Model fiyat veritabanında yoksa ya da çevrimdışı modda fiyat verisi yoksa maliyet 0 çıkar. Güncelle ya da --offline olmadan çalıştır. Kullanıcıların bildirdiği Issue #1736 açık.
Kullanıcıların bildirdiği Codex kullanımının bir kısmı eksik	Issue #1888 (14.10.2026, açık): sıkıştırılmış kayıtlar atlanıyor.
Toplam Claude Code'un kendi gösterdiğiyle uyuşmuyor	Maliyet tahmin; --mode (auto, calculate, display) farklı sonuç verir. Kullanıcıların bildirdiği Issue #1638.

ccusage nasıl kaldırılır?

Kurmadan çalıştırdıysan: Kalıcı kurulum yok; yalnız paket yöneticisinin önbelleği kalır.
Genel kurulumu kaldır: npm uninstall -g ccusage (Bun, yarn ve pnpm karşılıkları belgede).
Durum satırını kapat: ~/.claude/settings.json içindeki statusLine bloğunu sil.

Sık sorulan sorular

ccusage ne işe yarar?

Bilgisayarındaki kodlama ajanlarının (Claude Code, Codex, Gemini CLI vb.) yerel kayıtlarından günlük, haftalık, aylık ve oturum bazında token kullanımı ve tahmini maliyet tablosu çıkarır.

Claude Code kayıtlarını nereden okuyor?

~/.config/claude/projects ve ~/.claude/projects klasörlerinden; ikisi de varsa birleştirir. CLAUDE_CONFIG_DIR ayarlıysa varsayılanların yerine o kullanılır.

Gösterdiği dolar tutarını ödüyor muyum?

Hayır, bu bir tahmin. Belge maliyetlerin gerçek faturayı yansıtmayabileceğini yazıyor. Abonelikteysen tutar, aynı kullanımın kullandıkça-öde fiyatıyla ne tutacağını gösterir; faturan değildir.

Maliyeti nasıl hesaplıyor, internet kullanıyor mu?

Token sayısını model fiyatlarıyla çarpar (LiteLLM, models.dev ve geçmiş fiyat çizelgeleri). Varsayılan modda kayıtta hazır maliyet varsa onu kullanır. Varsayılan çalışmada fiyat verisi ağdan yenilenebilir; --offline ağa çıkmadan önbellekteki ya da gömülü fiyatı kullanır (iki belge bunu biraz farklı anlatıyor).

Verilerim bir yere gönderiliyor mu?

Belgeye göre analiz tamamen yerel, kullanım verin bilgisayarından çıkmıyor ve araç dosyaları yalnız okuyor. Fiyat tablosu için ağ isteği olabilir. Belge telemetri hakkında bir şey yazmıyor.

Node.js ya da Bun şart mı?

Çalıştırmak için bir paket çalıştırıcı gerekir: npx için Node.js, bunx için Bun 1.3+. Belge hızlı başlangıç için bunx'i öneriyor.

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: Telemetri olup olmadığı (belgede ifade yok) · fiyat verisinin çekildiği tam adres · Node.js asgari sürümü (engines alanı yok) · Windows'ta Claude Code kayıt yolunun tam karşılığı · abonelik kullanıcısı için resmî bir yorum (belge Pro ve Max adlarını anmıyor). Her biri ilgili bölümde yazılı.