CC Usage
Monitor your Claude Code API usage and costs with detailed analytics
Author: @ryoppippi | GitHub Repo | 2700 Stars|90 Forks|MIT License|Updated Jun 22, 2025
Overview
CC Usage is a command-line tool that helps you track and analyze your Claude Code API consumption. Get detailed insights into your usage patterns, costs, and optimize your Claude Code workflows.
Features
- Daily & Monthly Reports - View token usage and costs aggregated by date or month
- 5-Hour Block Monitoring - Track usage within Claude's billing windows with active block monitoring
- Live Dashboard - Real-time monitoring showing active session progress and token burn rate
- Model Tracking - See which Claude models you're using with per-model cost breakdown
- Date Filtering - Filter reports by date range and export data in JSON format
- MCP Integration - Built-in Model Context Protocol server for integration with other tools
Installation
Quick Start (Recommended)
npx ccusage@latest # or: bunx ccusage # or: pnpm dlx ccusage
Global Installation
npm install -g ccusage && ccusage daily
Usage
Daily Usage Report
# View daily token usage and costs
ccusage daily
Monthly Reports
# Monthly usage summary
ccusage monthly
For additional options and advanced usage, read the official documentation.
Integration with Claude Code
CC Usage works alongside your existing Claude Code setup to provide transparency into your API consumption patterns.
Workflow Integration
- Track usage during development sessions
- Optimize prompt efficiency based on usage data
- See how much money you saved with Claude Max or Pro
CC Usage is an independent community project. For technical support and updates, please refer to the official GitHub repository.