Ccusage

CCUsage - Claude Code Token Usage Statistics

Analyze token consumption and costs from Claude Code CLI usage.

Quick Start

npx ccusage@latest --json --offline

Default command shows daily breakdown. Always use --json for structured output and --offline to avoid API calls.

Commands

Common Filters

# Date range
npx ccusage@latest daily --json --offline --since 20260301 --until 20260311

# Specific project
npx ccusage@latest daily --json --offline --project "my-project"

# Model breakdown
npx ccusage@latest daily --json --offline --breakdown

# Instance breakdown
npx ccusage@latest daily --json --offline --instances

JSON Output Structure

Daily/Monthly/Weekly

{
  "daily": [{
    "date": "2026-03-11",
    "inputTokens": 1000,
    "outputTokens": 500,
    "cacheCreationTokens": 2000,
    "cacheReadTokens": 5000,
    "totalTokens": 8500,
    "totalCost": 0.05,
    "modelsUsed": ["claude-sonnet-4-6"],
    "modelBreakdowns": [...]
  }]
}

Session

{
  "sessions": [{
    "sessionId": "-path-to-project",
    "inputTokens": 1000,
    "outputTokens": 500,
    "totalCost": 0.05,
    "lastActivity": "2026-03-11",
    "modelsUsed": [...],
    "projectPath": "project-name"
  }]
}

Blocks

{
  "blocks": [{
    "id": "2026-03-11T08:00:00.000Z",
    "startTime": "...",
    "endTime": "...",
    "isActive": false,
    "totalTokens": 8500,
    "costUSD": 0.05,
    "models": [...]
  }]
}

Common Queries

Today's usage:

npx ccusage@latest daily --json --offline --since $(date +%Y%m%d)

This month:

npx ccusage@latest monthly --json --offline --since $(date +%Y%m01)

Cost by model:

npx ccusage@latest daily --json --offline --breakdown

Most active sessions:

npx ccusage@latest session --json --offline --order desc

Key Options