Skip to main content

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.

CC Usage command line interface showing daily usage report with token counts, costs, and colorful table formatting


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.