token-usage-optimizer
rusel95 tarafından
DevOps & CloudÖzet
Maximize your Claude Code subscription value with smart usage monitoring and burn rate optimization.
Açıklama
Bu Beceri Ne Yapar
Tracks Claude Code subscription usage across 5-hour session and 7-day weekly quotas. Calculates burn rate to show whether you're under-using, on pace, or at risk of hitting limits before reset. Sends one-time alerts at configurable thresholds and generates daily plain-text reports.
Claude Code's interface doesn't expose burn rate or weekly quota progress, so this fills that gap with plain shell scripts and no external dependencies beyond curl.
Ne Zaman Kullanılır
- Checking session quota remaining before starting a long coding task
- Getting an evening summary of weekly Claude Code consumption
- Deciding whether to use Claude more aggressively or slow down today
- Monitoring burn rate across a Max 100 or Max 200 subscription
- Setting up an automated alert when session usage crosses 50%
Örnek İş Akışı
User asks: how much of my Claude Code quota have I used this week?
- 1
Runs check-usage.sh, which checks the local 10-minute cache before making an API call
- 2
Fetches utilization data from the Anthropic OAuth API if cache is stale
- 3
Calculates burn rate by comparing weekly utilization against the expected daily budget for the detected plan
- 4
Outputs SESSION and WEEKLY percentages alongside a BURN_RATE status
SESSION=22.0, WEEKLY=49.0, BURN_RATE=OK — user is on pace for their subscription plan
Gereksinimler
- Claude Code subscription (Pro, Max 100, or Max 200)
- Claude Code OAuth access token (sk-ant-oat01-...)
- Claude Code OAuth refresh token (sk-ant-ort01-...)
Kurulum
clawhub install rusel95/token-usage-optimizerCLI komutunu çalıştırın ya da istemi Claude Code, Cursor, Codex veya kullandığınız kodlama ajanına yapıştırın.