Claude Code usage

Claude Code Stats

Track and visualize your Claude Code usage, costs, and session statistics with a local HTML dashboard.

Install

Install
pip install "claudestats-core @ git+https://github.com/AeternaLabsHQ/claude-code-stats@v1.0.0"

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/AeternaLabsHQ/claude-code-stats.git

From the README

Claude Code Usage Statistics

A self-hosted analytics dashboard for Claude Code. Parses your local session transcripts, calculates hypothetical API costs, and generates an interactive HTML dashboard.

_Disclaimer:_ _Unofficial, community-built tool. Not affiliated with or endorsed by Anthropic._
Upgrading from 0.8.x? Your existing config.json keeps working and no migration step is required. See MIGRATION.md for what changed, including how to restore the previous color scheme.

What you get

Highlights:

- Five focused tabs - Token & API Value, Plan & Billing, Activity & Projects, Sessions, Insights & System; card-based interface with light / dark themes
- Cost & token analytics - API-equivalent cost, full token breakdown (input / output / cache-read / cache-write), cache efficiency, plan vs. actual usage
- Metric toggle - Switch the daily and cumulative charts between USD, your billing currency, and consumed tokens (input + output); the money KPI follows along
- Cache health & anomaly detection - Idle-gap (TTL) overhead tracking plus detection of no-gap cache invalidations like the 2026 Claude Code cache bugs, with a per-day flush chart as an early-warning signal
- Session replay & table - Interactive node-graph with timeline playback, plus a searchable, sortable session table with CSV / XLSX / Markdown / ZIP export
- Multi-attribute filtering - Range sliders for tokens, cost, duration, tool calls, agent dispatches, errors; one-click presets and persistent state across reloads
- Limits & plan recommendation (beta) - Detects rate-limit and server-overload events from transcripts, 5-hour rolling-window tracker, empirically calibrated plan-tier suggestion
- Per-tool token attribution - Output tokens and cost broken out by tool per session, plus a separate reasoning…
Read the full README on GitHub

Details

Language
Python
License
MIT
Last updated
14 October 2026
Topics
claude-codecli-toolscost-trackingdashboarddeveloper-toolsusage-stats

FAQ

What is Claude Code Stats?

Track and visualize your Claude Code usage, costs, and session statistics with a local HTML dashboard. It is a usage for Claude Code, from AeternaLabsHQ/claude-code-stats on GitHub.

How do I install Claude Code Stats?

Run pip install "claudestats-core @ git+https://github.com/AeternaLabsHQ/claude-code-stats@v1.0.0", then follow the setup in the README.

Is Claude Code Stats popular?

AeternaLabsHQ/claude-code-stats has 42 GitHub stars and 16 forks. It was last updated on 14 October 2026.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.