The three commands worth knowing
npx ccusage@latest daily --json: one entry per day with tokens, cost and a per-model breakdown. The best input for a plan recommendation.
npx ccusage@latest blocks --json: usage grouped into 5-hour windows, the same windows Claude’s session limits use. Good for seeing when you would hit a limit.
npx ccusage@latest session --json: one entry per conversation, to find the sessions that cost the most.
Where the data comes from
ccusage reads the JSONL logs Claude Code writes under ~/.claude/projects, one file per session. Everything stays on your machine.
From JSON to a decision
Paste the JSON into Burnmeter’s Claude Code tab. It re-prices every model with the current table and compares Claude Pro, Max and Ultra against the API and Cursor’s plans.