Monitor real-time token usage and prevent budget overruns
ccusage offers live monitoring dashboard with 5-hour billing window tracking, allowing users to see active token consumption and projected costs in real-time to stay within budget
How to use ccusage
How to use ccusage
Claude code usage analysis tool
Overview
What it is
Learn how to analyze your Claude Code token usage and costs with ccusage CLI tool. Fast, informative tutorials and examples.
Intent
I need it when
Analyze Claude usage privately without uploading data to external servers
ccusage processes all data 100% locally with zero data uploads, maintaining complete privacy while providing offline analysis capabilities with cached pricing data
Quickly install and start analyzing Claude costs without complex setup
ccusage uses bunx for instant startup with no installation required, providing ultra-small package size and immediate access to analysis features
Track and analyze Claude Code API costs with detailed breakdowns
ccusage provides daily, monthly, and session-based reports showing token consumption and costs by model, enabling developers to understand spending patterns and identify optimization opportunities
Export usage data for integration with existing analytics and automation pipelines
ccusage supports JSON export functionality enabling seamless integration with custom analytics tools and automated workflows for further analysis
Drop
Not a fit when
- User needs cloud-based analysis with data uploads and remote processing
- User requires GUI interface instead of command-line tool
- User needs support for non-Claude AI models or APIs
- User wants managed service without local installation requirements
- User needs real-time alerts or automated cost control enforcement
Commercials
Pricing
Free open-source CLI tool with optional paid ShipAny boilerplate templates View pricing