Claude Meter

See It In Action

claude-meter today --compact

$ claude-meter today --compact

Claude Meter — Today (Mar 22, 2026)

  Entries: 3,241 | Sessions: 28

  Tokens:   Input 245.3K | Output 892.1K | Fresh 1.1M
  Cache:    Read 312.5M | 5m 8.2M | 1h 14.7M | Full 335.4M

  Models:   opus-4-6 94% | haiku-4-5 6%

  Cost:     $142.38 (opus $134.10 | haiku $8.28)

  Pricing:  bundled defaults

claude-meter this-month

$ claude-meter this-month

╔══════════════════════════════════════════════════════════╗
║               Claude Meter — March 2026                ║
╚══════════════════════════════════════════════════════════╝

  Period:          Mar 1 – Mar 22, 2026
  Files Scanned:   2,568
  Entries:         106,461

┌─ Token Usage ──────────────────────────────────────────────┐
│  Input Tokens:          5.9M                       │
│  Output Tokens:         11.6M                      │
│  Cache Read:            8.3B                       │
│  Full Total:            8.8B                       │
└──────────────────────────────────────────────────────────┘

┌─ Estimated Cost ──────────────────────────────────────────┐
│  Total:              $8,531.68                    │
│    opus-4-6:         $7,882.23                    │
│    haiku-4-5:        $649.45                      │
└──────────────────────────────────────────────────────────┘

Real Screenshots

Actual output from a real Claude Code session.

Monthly Usage Report

Claude Code Statusline

Statusline with Rate Limit Bars

statusline — replace mode

Sonnet 4.6 [======              ] 31% 62k/200k git:main | my-project
Today: 1.2M ~$85.20 | Month: 47.5M ~$1.2K
Usage ██░░░░░░ 5% (4h 35m / 5h) | █░░░░░░░ 3% (1d 23h / 7d)

Rate limit bars show your 5-hour and 7-day usage windows with time remaining. Auto-hidden for API users.

Features

⏱

Token Tracking

Input, output, cache read, and cache creation tokens with 5-minute and 1-hour granularity.

📈

Per-Model Breakdown

See exactly how usage splits across Opus, Sonnet, and Haiku models.

💰

Exact Cost Estimates

Uses real cache breakdowns from your logs. No guessing, no averaging.

📅

Flexible Time Ranges

Today, this week, this month, custom date ranges, or all time.

⚡

Live Watch Mode

Real-time dashboard that auto-refreshes as you work.

💻

Statusline Integration

See costs and rate limit usage right inside your Claude Code terminal session.

🔒

100% Private

Everything stays local. No network calls, no telemetry, no analytics.

🌐

Cross-Platform

Works on Windows, macOS, and Linux with zero configuration needed.

📚

JSON Output

Pipe to jq, feed into scripts, or build your own dashboards.

Commands

claude-meter today

Today's usage and costs

claude-meter this-month

Current month summary

claude-meter watch

Live auto-refreshing dashboard

claude-meter today --json

Machine-readable JSON output

claude-meter doctor

Full diagnostics health check

claude-meter install-statusline

Add cost display to your terminal

claude-meter range <start> <end>

Custom date range analysis

claude-meter config

View and manage configuration

Bundled Pricing

Official Anthropic pricing (March 2026). Updated with each release.

Model	Input	Output	Cache Write 5m	Cache Write 1h	Cache Read
Opus 4.6	$5/M	$25/M	$6.25/M	$10/M	$0.50/M
Opus 4.5	$5/M	$25/M	$6.25/M	$10/M	$0.50/M
Sonnet 4.6	$3/M	$15/M	$3.75/M	$6/M	$0.30/M
Sonnet 4.5	$3/M	$15/M	$3.75/M	$6/M	$0.30/M
Haiku 4.5	$1/M	$5/M	$1.25/M	$2/M	$0.10/M