claude-usage

System tray token monitor

Watch your tokens burn in real-time. Feel your wallet weep in high definition. Because ignorance isn't bliss - it's an invoice.

View on GitHub Install now Buy me a coffee
claude-usage Linux system tray tooltip showing progress bars
claude-usage Windows system tray tooltip

How it works

Three steps between you and knowing exactly how fast your money disappears.

1

Install

One command. No config. Faster than reading your next API bill.

curl -sL ... | bash
2

Tray icon appears

A tiny purple chip appears in your tray. Your new financial anxiety companion.

3
claude-usage tooltip showing progress bars

Hover to monitor

Hover to see exactly how much Claude is eating. Progress bars, countdowns, regret.

Installation

Choose your platform. Installation is free - unlike everything else on this page.

One-line installer Recommended

Works on x64 and ARM64 Linux. Downloads the latest release, installs the binary, creates a desktop entry, and sets up autostart.

curl -sL https://raw.githubusercontent.com/utajum/claude-usage/master/scripts/install-linux.sh | bash
Installer options
--no-autostart Skip autostart setup
--no-desktop Skip desktop entry creation
--uninstall Remove claude-usage and all files

Manual binary download

Download the binary directly if you prefer to manage installation yourself.

x64:
curl -sL https://github.com/utajum/claude-usage/releases/latest/download/claude-usage-linux-amd64 -o claude-usage && chmod +x claude-usage
ARM64:
curl -sL https://github.com/utajum/claude-usage/releases/latest/download/claude-usage-linux-arm64 -o claude-usage && chmod +x claude-usage

Or just download the binary

Grab it and run it yourself. No installer, no desktop integration.

x64 ARM64

Just chmod +x and run. Put it wherever you want.

Requirements

Linux x64 / ARM64 Claude Code installed & logged in

Download DMG Recommended

For Intel and Apple Silicon Macs. Download the DMG from GitHub Releases.

Download from GitHub Releases
1 Open the .dmg file and drag claude-usage to Applications
2 Right-click the app and select Open (required first time for Gatekeeper)
3 The app lives in your menu bar — hover to see usage stats

Binary download

Download the standalone binary for your architecture.

Apple Silicon:
curl -sL https://github.com/utajum/claude-usage/releases/latest/download/claude-usage-darwin-arm64 -o claude-usage && chmod +x claude-usage
Intel:
curl -sL https://github.com/utajum/claude-usage/releases/latest/download/claude-usage-darwin-amd64 -o claude-usage && chmod +x claude-usage
Autostart setup

To launch automatically at login, build with make install-macos which creates the .app bundle and configures autostart via LaunchAgents. See the README for manual plist setup.

Requirements

macOS 11+ (Intel or Apple Silicon) Claude Code installed & logged in

PowerShell installer Recommended

Download the ZIP from GitHub Releases, extract it, and run the installer.

1 Download claude-usage-windows-amd64.zip from Releases
2 Extract the ZIP archive
3 Right-click install-windows.ps1 → Run with PowerShell

Or run from a terminal:

powershell -ExecutionPolicy Bypass -File install-windows.ps1
Installer options
-NoAutostart Skip Startup shortcut creation
-Uninstall Remove claude-usage and all files

Installs to %LOCALAPPDATA%\Programs\claude-usage\. Creates Start Menu and Startup shortcuts.

Or just download the exe

Grab the standalone executable and manage it yourself. No installer needed.

claude-usage-windows-amd64.exe

Just run it. No installation, no PowerShell, no admin rights. Put it wherever you want.

Requirements

Windows 10/11 x64 Claude Code installed & logged in
Or build from source

Requires Go 1.22+ (CGO needed for macOS/Windows)

git clone https://github.com/utajum/claude-usage.git cd claude-usage make build

Use make build-all for all platforms, make install-linux for full Linux install with desktop integration, or make install-macos to build the .app bundle.

Features

Everything you need to stare at your API usage like it's a stock ticker during a crash.

Monitor

System Tray Icon

Always visible, always judging. A tiny reminder that AI isn't free.

5-Hour Progress

A progress bar for your rolling 5-hour window. Watching it fill up is the new doomscrolling.

Weekly Progress

See your weekly burn rate. Great for budgeting, terrible for peace of mind.

Model Breakdown

Find out which model is draining your quota faster. Spoiler: it's Opus.

Detect

Reset Countdown

Counts down to your next refill. Like watching the microwave, but it's your API budget.

Throttle Detection

Visual warnings when Anthropic says "slow down, big spender."

Auto-Refresh

Updates every 5 minutes from the Anthropic API automatically.

Native System Tray

Built with fyne.io/systray. Native look on all platforms.

Deploy

Cross-Platform

Linux (pure Go), macOS (CGO), and Windows (CGO).

One-Command Install

curl | bash on Linux, DMG for macOS, PowerShell for Windows.

OAuth Integration

Reads credentials from ~/.claude/.credentials.json. No manual setup.

OpenCode Support

Linux version works with OpenCode. Reads OpenCode credentials.

Stop guessing. Start panicking accurately.

Install in seconds. Because "I wonder how many tokens I've used" shouldn't keep you up at night.

View on GitHub Buy me a coffee

Found a bug? Open an issue