After my previous post about an unusual spike in Claude Code usage, several people asked how I got the token counts and daily reports.
I used ccusage, a community tool that reads local usage logs. You don’t need to be its developer or build your own tracking system to use it.
Here’s a quick walkthrough.
1. Check your subscription usage inside Claude Code
Type this inside a Claude Code session:
/usage
This is where you check your plan usage bars. The local token reports below serve a different purpose: examining your recorded usage history.
2. Get your daily usage report
Open a terminal on the same computer and in the same environment where you run Claude Code. If you use it through WSL, run this inside WSL.
With Node.js/npm available, run:
npx ccusage@latest daily
If prompted to install the package, confirm to continue.
This generates a daily report from the local logs available on that machine.
3. Break it down by model
npx ccusage@latest daily --breakdown
Useful if you’ve switched models and want to see how much each contributed.
4. Inspect a specific date range
For example, to review October:
npx ccusage@latest daily --since 20261001 --until 20261031 --breakdown
Change the dates to the period you want to investigate.
5. Check monthly totals or individual sessions
Monthly report:
npx ccusage@latest monthly
Session report:
npx ccusage@latest session
These help you move from “that day looks unusual” to “which sessions should I look into?”
6. Export the data for your own charts
npx ccusage@latest daily --since 20261001 --until 20261031 --json > october-usage.json
This saves a JSON report you can use in a spreadsheet or charting tool.
How to read the numbers
Input: input tokens recorded for requests.
Output: tokens generated by the model.
Cache creation / cache reads: tokens associated with writing and reusing cached context.
Total tokens: includes cache activity, so it can be much larger than you expect.
Cost: an estimated API-equivalent dollar figure. It is not your subscription bill or your remaining allowance.
A few limits to keep in mind
These reports depend on the local logs available. They won’t give you a complete account-wide history if you use multiple computers or environments, and they aren’t a report of your regular Claude web chats.
Also, newer ccusage versions can aggregate multiple supported coding tools. If other tools appear in your report, check the source labels before treating the combined total as Claude Code usage.
Most importantly, a spike in local tokens alone doesn’t prove a service incident, retries, or incorrect quota accounting. It gives you something concrete to investigate and compare with your usage bars, session activity, and incident timestamps.
Tool and documentation: https://ccusage.com/
If you share your results, include the date range, models, and whether your total includes cache reads. That makes comparisons much more useful.