An elegant macOS menu bar app for real-time monitoring of your Claude AI usage.
✨ Monitors all Claude platforms: Web • Claude Code • Desktop • Mobile App ✨
Features • Installation • User Guide • FAQ • Support
- 📊 Real-time Monitoring - Display Claude subscription's usage quota (5-hour/7-day) in menu bar
- 🎯 Dual Limit Support - Show 5-hour and 7-day limits simultaneously with dual-ring icon
- 🎨 Smart Colors - Automatic color changes based on usage (5-hour: green/orange/red; 7-day: cyan/blue-purple/deep purple)
- ⏰ Precise Timing - Quota reset time displayed with minute precision
- 🔄 Smart Refresh System - Intelligent 4-level adaptive refresh or fixed intervals (1/3/5/10 min)
- ⚡ Manual Refresh - Click refresh button to update data instantly (10-second debounce protection)
- 💻 Native Experience - Pure native macOS app, lightweight and elegant
Works seamlessly with all Claude products:
- 🌐 Claude.ai (Web interface)
- 💻 Claude Code (CLI tool for developers)
- 🖥️ Desktop App (macOS/Windows)
- 📱 Mobile App (iOS/Android)
All platforms share the same usage quota, monitored in one place!
-
🕓 Multiple Display Modes
- Percentage Only - Clean and intuitive, view at a glance
- Icon Only - Subtle and elegant, detailed info on click
- Icon + Percentage - Complete information, quick visual identification
-
🌍 Multilingual Support
- English
- 日本語
- 简体中文
- 繁体中文
- More languages coming soon...
- ⚙️ Visual Settings - No code modification needed, GUI configuration for all options
- 🆕 Smart Update Alerts - Menu bar badge and rainbow animation notify new versions
- 🚀 Launch at Login - Optional automatic startup when system boots
- ⌨️ Keyboard Shortcuts - Common operations support shortcuts (⌘R, ⌘,, ⌘Q)
- 👋 Friendly Onboarding - Detailed setup wizard on first launch
- … Menu Display - Multiple menu access methods, detail view and right-click
- 🛠️ Debug Mode - Developer options: fake data testing, simulated updates, instant refresh
- 🏠 Local Storage Only - All data stored locally only, never collect or upload any personal information
- 🔐 Keychain Protection - Sensitive information secured in Keychain, no plain text keys
- 📖 Open Source Transparency - Code fully public, anyone can audit
- 🛡️ Sandbox Protection - App Sandbox enabled for enhanced security
| Icon Only | 5-Hour | 5-Hour+Icon | 5-Hour+7-Day | 5+7+Icon | Monochrome (Adaptive) |
|---|---|---|---|---|---|
 |
 |
 |
 |
 |
  |
5-Hour Limit Mode - Ring Color Indicators:
🟢 Green (0-69%) - Safe usage 🟠 Orange (70-89%) - Monitor usage 🔴 Red (90-100%) - Approaching limit
7-Day Limit Mode - Ring Color Indicators:
🔵 Cyan (0-69%) - Safe usage 🟣 Blue-Purple (70-89%) - Monitor usage 🟪 Deep Purple (90-100%) - Approaching limit
Dual Limit Mode - Dual Ring Display:
When both 5-hour and 7-day limits exist, menu bar shows dual rings:
- Inner Ring (5-hour limit): 🟢 Green → 🟠 Orange → 🔴 Red
- Outer Ring (7-day limit): 🔵 Cyan → 🟣 Blue-Purple → 🟪 Deep Purple
5-Hour Limit Mode |
7-Day Limit Mode |
Dual Limit Mode |
General - Launch at login, customize display, refresh, and language options
Authentication - Configure Claude account authentication
About - Version info and related links
Set Up Authentication - Go directly to authentication settings to complete setup
Set Up Later - Close welcome screen, configure later in settings
- Go to Releases page
- Download the latest
.dmgfile - Double-click to open, drag app to Applications folder
- Right-click the app and select "Open" on first launch (allow unsigned app)
- Allow Keychain access for authentication info (Need to allow again after version updates. Authorization prompt appears twice: Organization ID, Session Key)
- macOS 13.0 or later
- Xcode 15.0 or later
- Git
# Clone repository
git clone https://github.com/f-is-h/Usage4Claude.git
cd Usage4Claude
# Open in Xcode
open Usage4Claude.xcodeproj
# Press Cmd + R to run in Xcode-
Launch App
Welcome screen will appear on first run -
Configure Authentication
Click "Go to Authentication Settings" button -
Get Required Info
- Click "Open Claude Usage Page in Browser"
- Open browser developer tools (press F12 or Cmd + Option + I)
- Switch to "Network" tab
- Refresh the page
- Find request named
usage - View Headers and find:
sessionKey=sk-ant-...value inCookie- Organization ID in URL (format:
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
-
Enter Information
- Paste Organization ID into "Organization ID" field
- Paste Session Key into "Session Key" field
- Monitoring will start automatically after configuration
- Default Display - Menu bar shows usage percentage
- View Details - Click menu bar icon or percentage
- Manual Refresh - Click refresh button in detail window or use shortcut ⌘R
- Show Menu - Click "…" icon in detail window or right-click menu bar icon
- Keyboard Shortcuts
- ⌘R - Manual refresh data
- ⌘, - Open General Settings
- ⌘⇧A - Open Authentication Settings
- ⌘Q - Quit app
- Update Alerts - When new version available, menu bar icon shows badge and menu items display rainbow text
- Check Updates - Menu → Check for Updates
Smart Frequency (Recommended)
- Automatically adjusts refresh rate based on usage patterns
- Active mode (1 min) - Fast refresh when actively using Claude
- Idle modes (3/5/10 min) - Progressively slower refresh when idle
- Significantly reduces API calls during idle periods (up to 10x)
- Instantly returns to 1-minute refresh when usage detected
Fixed Frequency
- 1 minute - Recommended for consistent monitoring
- 3 minutes - Balanced monitoring
- 5 minutes - Low frequency monitoring
- 10 minutes - Minimal API calls
Q: What if the app shows "Session Expired"?
A: Session Keys expire periodically (usually weeks to months), need to re-obtain:
- Open Settings → Authentication
- Follow configuration guide to get new Session Key
- Paste new Session Key
Q: How to enable auto-launch on startup?
A: Two methods:
Method 1: Using built-in option (Recommended)
- Open Settings → General
- Check "Launch at Login" option
Method 2: Via System Settings
- Open System Settings → General → Login Items
- Click "+" to add Usage4Claude
Q: How much system resources does it use?
A: Very lightweight:
- CPU Usage: < 0.1% (idle)
- Memory: ~20MB
- Network: Only 1 request per minute
Q: Which macOS versions are supported?
A: Requires macOS 13.0 (Ventura) or later. Supports both Intel and Apple Silicon (M1/M2/M3) chips.
Q: Why does it need Keychain permission?
A:
- Keychain is macOS's system-level password manager
- Your Session Key and Organization ID are encrypted in Keychain
- This is Apple's recommended secure storage method
- Only this app can access the information, other apps cannot view it
Q: Is my data safe? How is privacy protected?
Completely safe!
Data Storage:
- All data stored only on your local Mac
- No collection, no tracking, no statistics of any information
- No network requests except Claude API calls
- No third-party services used
Authentication Security:
- Session Key encrypted via macOS Keychain (system-level encryption)
- Keychain uses AES-256 encryption + hardware protection (T2 / Secure Enclave)
- Only this app can access your credentials, other apps cannot read them
- You can revoke access anytime via "Keychain Access" app
Code Transparency:
- 100% open source
- No obfuscation or hidden features
- Community can audit and verify
Additional Protection:
- App Sandbox enabled (limits system access)
- No access to your files, contacts, or other apps
- Minimal permissions (only network + Keychain)
You can verify all of this by reviewing the source code on GitHub!
Q: Does it work with Claude Code / Desktop App / Mobile App?
A: Yes, it works with all Claude platforms!
Since all Claude products (Web, Claude Code, Desktop App, Mobile App) share the same 5-hour usage quota, Usage4Claude monitors your combined usage across all platforms.
Whether you're:
- Coding in terminal with
claude code - Chatting on claude.ai
- Using the desktop app
- Using mobile apps
You'll see your real-time total usage in the menu bar. No platform-specific configuration needed!
Built with modern macOS native technologies:
- Language: Swift 5.0+
- UI Framework: SwiftUI + AppKit hybrid
- Architecture: MVVM
- Networking: URLSession
- Reactive: Combine Framework
- Localization: Built-in i18n support
- Platform: macOS 13.0+
- Basic monitoring features
- Menu bar real-time display
- Circular progress indicator
- Smart color alerts
- Real-time countdown
- Multiple menu bar display modes
- Visual settings interface
- Multilingual support
- First-launch onboarding
- Update checking with visual alerts
- Keychain authentication storage
- Shell auto-package DMG
- GitHub Actions auto-release
- Settings interface display optimization
- Launch at login option
- Keyboard shortcuts support
- Manual refresh feature
- Three-dot menu dark mode adaptation
- Dual limit mode support (5-hour + 7-day)
- Dual-ring menu bar icon
- Unified color scheme management
- Debug mode (fake data, simulated updates)
-
Developer Experience
- 🚧 GitHub Actions check online version
-
Display Optimization
- 🚧 Settings interface dark mode adaptation
-
Display Optimization
- Detail window Focus state
-
Feature Addition
- More 7-day usage modes support (OAuth・Opus)
- Usage notifications
- More language localizations
- Auto Setup
- Browser extension for auto-authentication
- Automatic credential configuration
-
More Display Methods
- Desktop widgets
- Browser extension icon usage display
-
Data Analysis
- Usage history records
- Trend charts
-
Multi-platform Support
- iOS / iPadOS version
- Apple Watch version
- Windows version
All contributions are welcome! Whether it's new features, bug fixes, or documentation improvements.
For detailed contribution guidelines, please see CONTRIBUTING.md.
- Fork this repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Thanks to all who have contributed to this project!
For detailed version history and updates, please see CHANGELOG.md.
If this project helps you, please support in the following ways:
Giving a star is the biggest encouragement!
If you like this project, please share it with more people!
This project is licensed under the MIT License - see LICENSE file for details
MIT License
Copyright (c) 2025 f-is-h
You are free to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software.
- Thanks to Claude AI - Most code written by AI
- Thanks to all contributors and users for their support
- Icon design inspired by Claude AI official branding
- Issues: Submit issues or suggestions
- Discussions: Join discussions
- GitHub: @f-is-h
This project is an independent third-party tool with no official affiliation with Anthropic or Claude AI. Please comply with Claude AI's Terms of Service when using this software.