Claude Usage Monitor

Track your Claude.ai usage across multiple accounts right from your Mac menu bar.

---

Features

• Multi-account support — Add multiple Claude accounts (Work, Personal, etc.), each with its own session and weekly usage bars
• Cloudflare bypass — API calls routed through a hidden WebKit instance so Cloudflare bot protection doesn't block the app
• Keyboard shortcut — Toggle popup with Cmd+U from anywhere
• Auto-refresh — Updates every 5 minutes automatically
• Privacy-first — All data (cookies, settings) stored locally in UserDefaults
• Pro plan support — Shows weekly Sonnet usage for Pro subscribers
• Menu bar only — No Dock icon, stays out of your way

Installation

1. Download ClaudeUsageMonitor-1.x.x.dmg from the latest release
2. Double-click to mount
3. Drag ClaudeUsageMonitor.app to the Applications folder
4. Eject the DMG
5. Open ClaudeUsageMonitor from Applications

Setup

Get your session cookie

1. Go to claude.ai/settings/usage
2. Open Developer Tools (Cmd+Option+I) → Network tab
3. Refresh the page, click the "usage" request
4. Copy the full "Cookie" value from the Request Headers

Add an account

On first launch, you'll see the onboarding screen. Paste your cookie and give the account a label (e.g. "Work"). You can add more accounts any time via "+ Add Account".

Build from Source

Requirements: macOS 12.0+, Xcode Command Line Tools

cd app && ./build.sh

The app bundle is created at app/build/ClaudeUsageMonitor.app. The script compiles a universal binary (arm64 + x86_64), signs it, and opens the app automatically.

Hot-reload during development — kill the running instance, rebuild, and relaunch in one line:

pkill -x ClaudeUsageMonitor; cd app && ./build.sh

Create a DMG installer:

cd app && ./create_dmg.sh

Project Structure

• ClaudeUsageMonitor.swift — Full application source
• Info.plist — App bundle metadata
• build.sh — Build script (universal binary: arm64 + x86_64)
• create_dmg.sh — DMG installer creation

Key Technologies

• SwiftUI — Modern macOS UI framework
• AppKit — Menu bar integration
• WebKit — Hidden WKWebView for API calls (Cloudflare bypass)
• Carbon — Global keyboard shortcut (Cmd+U)
• UserDefaults — Local storage for accounts and settings

Disclaimer

This app uses Claude.ai's internal API endpoints which may change without notice. It is not affiliated with or endorsed by Anthropic. Use at your own risk.

Inspired by ClaudeUsageBar by Artzainnn — this fork adds multi-account support, a redesigned popup UI, and a Cloudflare bypass so the app keeps working even as Claude.ai tightens API security.

License

MIT License — see LICENSE for details.