For Claude Code users

Know exactly what
Claude Code costs you
in real time

TokenWatch reads your local session logs and shows a live cost dashboard — per session, per project, per day. No proxy. No API key. Installs in 30 seconds.

pip install tokenwatch

Free forever · macOS, Linux, Windows · Python 3.11+

TokenWatch — localhost:7842 ● live
Today's spend
$1.2847
Projected $4.20/day
Last 7 days
$18.43
24 sessions
Last 30 days
$64.10
Avg $2.14/day
Top project
my-saas-app
$38.20 this month

"Running MAX ($200/month) since it came out. Cost in June so far would have been $8,844.45 — so that's interesting."

r/ClaudeAI · 574 upvotes

"You can only know how many tokens were required AFTER your request was completed. If your request requires many tool calls, it will be very expensive."

r/cursor · community warning

"Token usage without any sense of transparency just makes zero sense."

r/ClaudeAI · most-shared quote

Everything you need to stop overspending

⚡
Real-time cost stream
Live meter updates within 300ms of Claude Code responding. Watch the number tick up as it works.
📊
Per-session breakdown
Click any session to see cost per message, token counts, cache hits, and model used.
🔔
Budget alerts
Desktop notification when you hit 80% and 100% of your daily budget. macOS, Linux, Windows.
📁
Project breakdown
See which projects burn the most. Doughnut chart updated live as you work.
💰
Live pricing
Prices fetched automatically — never manually update a config file when Anthropic changes rates.
🔒
100% local
Reads Claude Code's local session logs. No proxy, no API key, no data leaves your machine.

Up and running in 30 seconds

No config files. No API keys. No account required.

Step 1

Install

pip install tokenwatch

Step 2

Run

tokenwatch — opens your browser automatically.

Step 3

Use Claude Code

Work normally. Your costs appear live as Claude responds.

Step 4

Auto-start

Run bash install_autostart.sh once to start on login.

Simple pricing

Start free. Upgrade when you want more history and reporting.

Free

$0 /forever

For individual developers getting started.

  • ✓ Live cost dashboard
  • ✓ 7-day history
  • ✓ Budget alerts (80% + 100%)
  • ✓ Session drill-down
  • ✓ Project breakdown chart
  • ✓ macOS auto-start
  • 🔒 CSV / JSON export
  • 🔒 30–90 day history
  • 🔒 Weekly email digest
Read the docs →

Pro

$9 /month

For power users who want full history and reporting.

  • ✓ Everything in Free
  • ✓ 90-day history
  • ✓ CSV / JSON export
  • ✓ Weekly email digest
  • ✓ Custom alert thresholds
  • ✓ Priority support
  • ✓ Early access to new features
Get Pro — $9/mo

Documentation

Everything you need to install, configure, and get the most out of TokenWatch.

🚀
Getting started
Install, run, and set up auto-start in under 5 minutes.
🔍
Troubleshooting
No data showing? Cost looks wrong? Start here.
⭐
Free vs Pro
Full feature comparison and how to activate your license.
💬
FAQ
Privacy, pricing, cancellation, and common questions.
Browse all documentation →