Skip to content

Daily Reports

Daily usage report showing token usage and costs by date with model breakdown

Daily reports show token usage and costs aggregated by calendar date, giving you a clear view of your Claude Code usage patterns over time.

Basic Usage

Show all daily usage:

bash
ccusage daily
# or simply:
ccusage

The daily command is the default, so you can omit it when running ccusage.

Example Output

Daily usage report showing token usage and costs by date with model breakdown

Understanding the Columns

Basic Columns

  • Date: Calendar date in YYYY-MM-DD format
  • Models: Claude models used that day (shown as bulleted list)
  • Input: Total input tokens sent to Claude
  • Output: Total output tokens received from Claude
  • Cost (USD): Estimated cost for that day

Cache Columns

  • Cache Create: Tokens used to create cache entries
  • Cache Read: Tokens read from cache (typically cheaper)

Responsive Display

ccusage automatically adapts to your terminal width:

  • Wide terminals (≥100 chars): Shows all columns
  • Narrow terminals (<100 chars): Compact mode with essential columns only

Command Options

Date Filtering

Filter reports by date range:

bash
# Show usage from December 2024
ccusage daily --since 20241201 --until 20241231

# Show last week
ccusage daily --since 20241215 --until 20241222

# Show usage since a specific date
ccusage daily --since 20241201

Sort Order

Control the order of dates:

bash
# Newest dates first (default)
ccusage daily --order desc

# Oldest dates first
ccusage daily --order asc

Cost Calculation Modes

Control how costs are calculated:

bash
# Use pre-calculated costs when available (default)
ccusage daily --mode auto

# Always calculate costs from tokens
ccusage daily --mode calculate

# Only show pre-calculated costs
ccusage daily --mode display

Model Breakdown

See per-model cost breakdown:

bash
ccusage daily --breakdown

This shows costs split by individual models:

┌──────────────┬──────────────────┬────────┬─────────┬────────────┐
│ Date         │ Models           │ Input  │ Output  │ Cost (USD) │
├──────────────┼──────────────────┼────────┼─────────┼────────────┤
│ 2025-06-21   │ opus-4, sonnet-4 │    277 │  31,456 │     $17.58 │
├──────────────┼──────────────────┼────────┼─────────┼────────────┤
│   └─ opus-4  │                  │    100 │  15,000 │     $10.25 │
├──────────────┼──────────────────┼────────┼─────────┼────────────┤
│   └─ sonnet-4│                  │    177 │  16,456 │      $7.33 │
└──────────────┴──────────────────┴────────┴─────────┴────────────┘

JSON Output

Export data as JSON for further analysis:

bash
ccusage daily --json
json
{
	"type": "daily",
	"data": [
		{
			"date": "2025-06-21",
			"models": ["claude-opus-4-20250514", "claude-sonnet-4-20250514"],
			"inputTokens": 277,
			"outputTokens": 31456,
			"cacheCreationTokens": 512,
			"cacheReadTokens": 1024,
			"totalTokens": 33269,
			"costUSD": 17.58
		}
	],
	"summary": {
		"totalInputTokens": 277,
		"totalOutputTokens": 31456,
		"totalCacheCreationTokens": 512,
		"totalCacheReadTokens": 1024,
		"totalTokens": 33269,
		"totalCostUSD": 17.58
	}
}

Offline Mode

Use cached pricing data without network access:

bash
ccusage daily --offline
# or short form:
ccusage daily -O

Common Use Cases

Track Monthly Spending

bash
# See December 2024 usage
ccusage daily --since 20241201 --until 20241231

Find Expensive Days

bash
# Sort by cost (highest first)
ccusage daily --order desc

Export for Spreadsheet Analysis

bash
ccusage daily --json > december-usage.json

Compare Model Usage

bash
# See which models you use most
ccusage daily --breakdown

Check Recent Activity

bash
# Last 7 days
ccusage daily --since $(date -d '7 days ago' +%Y%m%d)

Tips

  1. Compact Mode: If your terminal is narrow, expand it to see all columns
  2. Date Format: Use YYYYMMDD format for date filters (e.g., 20241225)
  3. Regular Monitoring: Run daily reports regularly to track usage patterns
  4. JSON Export: Use --json for creating charts or additional analysis

Released under the MIT License.