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.