f-is-h/Usage4Claude

What it solves

Usage4Claude is a macOS menu bar application that allows users to track their subscription usage limits for Claude and Codex. It eliminates the need to manually check usage dashboards on the web, providing real-time visibility into remaining quotas for various time-based limits.

How it works

The app connects to Claude and Codex accounts via browser-based sign-in or manual session keys. It periodically refreshes usage data from the services' endpoints. It features a "Smart mode" for refreshing that adapts to the frequency of requests based on whether usage is changing, reducing unnecessary network calls.

Who it’s for

Users of Claude Pro, Max, Team, and Enterprise plans, as well as Codex users who want to monitor their 5-hour, 7-day, and model-specific weekly limits directly from their macOS menu bar.

Highlights

• Multi-Service Tracking: Monitors both Claude and Codex usage in a single interface.
• Visual Indicators: Uses color-coded icons in the menu bar that change color as usage increases (e.g., Green $\to$ Orange $\to$ Red).
• Dual Graph Styles: Offers "Ring" graphs for used share and "Pace" graphs to plot usage against elapsed time.
• Notification System: Sends system notifications when usage reaches custom thresholds (50% to 100%).
• Privacy-First: No central server; all data stays on the local Mac and credentials are stored in the Keychain.
• Account Management: Supports multiple accounts and organizations for Claude and separate management for Codex.