claudeusage.dev
Verified September 2026 · Open source · Local utility · Public beta

Keep Claude usage visible in your terminal, browser, or Mac menu bar

Claude Usage reads the subscription limits already available to your authenticated Claude Code installation. It adds no hosted account, database, analytics, or telemetry.

Install version 0.5.0

Free · No sudo · No separate account
CLI + local web dashboardmacOS · Linux
$curl -fsSL https://www.claudeusage.dev/install.sh | sh
Download Mac app

The shell installer is readable before execution. It checks Python 3.9+, stages updates atomically, and preserves an existing installation if a download fails.

One usage contract, three surfaces

Each surface consumes the same normalized Claude state and model-window identities.

CLI

Fast human output plus stable JSON for automation.

Local dashboard

A self-contained page bound only to 127.0.0.1.

Mac menu bar

Background visibility, optional alerts, and Launch at Login.

Universal macOS menu-bar app

The beta is ad-hoc sealed but has no Developer ID signature or notarization. macOS may require one manual approval on first launch.

Download ZIP
  • Universal Apple Silicon and Intel build for macOS 13 or newer
  • Menu-bar title for the five-hour and all-model weekly windows
  • Every available Claude model-specific window in the menu
  • Pressure guidance, even-use weekly budget, and session-only pace
  • Optional notifications at 10%, 5%, and 0% remaining
  • Launch at Login, manual refresh, dashboard shortcut, and safe diagnostics

First launch

  1. Extract the ZIP and move Claude Usage.app into Applications.
  2. Try opening it once.
  3. Open System Settings → Privacy & Security.
  4. Choose Open Anyway for Claude Usage, then confirm Open.

Do not disable Gatekeeper.

CLI commands

claude-usageShow current remaining usage and local reset times.
claude-usage --webOpen the private localhost dashboard with 60-second refresh.
claude-usage --jsonReturn normalized schema-v1 JSON for scripts and integrations.
claude-usage --diagnostics-jsonCreate an allowlisted support snapshot without credentials.

Privacy model

Usage requests go directly from your machine to Anthropic using the OAuth session already held by Claude Code. claudeusage.dev never receives credentials, percentages, prompts, projects, diagnostic output, or usage history.

Pace samples live only in the running process. The Mac app persists only notification opt-in and delivered-event keys.

Compatibility

Requires Claude Code signed in with a Claude OAuth subscription and Python 3.9 or newer. The direct usage interface is internal and undocumented; incompatible endpoint changes fail clearly instead of falling back to scraping or browser automation.

Uninstall cleanly

claude-usage-install.sh --uninstallclaude-usage-install.sh --uninstall-menu-bar

App uninstall unregisters Launch at Login first. Neither command alters Claude Code or its login. Read the full technical notes in the source repository. Return to the usage guide.