The gist

Claude Usage Dashboard is a local utility created by The Product Compass newsletter. It solves the problem of limited usage visibility in Anthropic's official UIs by reading local log files generated by Claude Code tools. The tool provides detailed breakdowns of token counts, model usage, and estimated costs, giving developers a complete picture of their consumption across the CLI and VS Code extension.

What it does

Scans local JSONL log files from Claude Code to populate a usage database.
Serves a local web dashboard with charts for visualizing token usage and costs.
Displays usage summaries directly in the terminal for quick checks.
Estimates costs based on Anthropic's public API pricing for different models.
Integrates the dashboard directly into VS Code as an activity bar sidebar.

How it works

This open-source tool is a Python script with no external dependencies. It parses JSONL log files created by Claude Code in ~/.claude/projects/, storing the data in a local SQLite database. You can run it from the command line to view stats or launch a local web server at localhost:8080 to see a dashboard with charts. It is also available as a VS Code extension that embeds the dashboard.

Best for

This tool is ideal for developers using Claude Code who want to monitor their personal token consumption and estimated API costs locally, without relying on Anthropic's official dashboard.

Watch out for

The dashboard cannot track usage from 'Cowork' sessions, as those run server-side and do not generate local logs. Cost estimates are based on API pricing and will not reflect the actual cost structure of a Pro or Max subscription.