Claude Code Usage Analyzer

Analyze Claude Code session data to generate usage reports with token counts, cost estimates, billing block tracking, tool usage stats, and per-project breakdowns.

Inspired by paulrobello/par_cc_usage.

How it works

Claude Code stores session data as JSONL files in:

• ~/.config/claude/projects/ (Linux/macOS primary)
• ~/.claude/projects/ (legacy Unix)
• %USERPROFILE%\.claude\projects\ (Windows, default)
• Custom path via CLAUDE_CONFIG_DIR env var (all platforms)

The script parses these files, extracts assistant message token usage, deduplicates by request ID, and computes:

• Total token usage (input, output, cache)
• Cost estimates using Anthropic pricing
• 5-hour billing block tracking with burn rate
• Per-model breakdown (Opus vs Sonnet)