English | 日本語 | 简体中文 | 繁體中文 | 한국어 | Français | Deutsch

Track your Claude and Codex subscription usage from the menu bar.

Features · Installation · Usage · Privacy & Security · FAQ · Contributing · Website

Claude and Codex can be configured individually or together. All apps of a service share one quota, and the menu bar always shows its total usage.

With one service configured, the interface has a single column. With both, the detail window splits into two columns and the menu bar shows both icons side by side.

Claude Pro, Max, Team and Enterprise are supported. Free accounts have no usage dashboard and cannot be read. On Team and Enterprise, an admin must enable the member usage dashboard.

Ring shows the used share of each limit, with reset times listed below.

Pace plots each limit against elapsed time, with a diagonal marking even consumption. Above the diagonal means usage is outpacing time; below means there is headroom. Weekly limits can count weekdays only.

Switch between them in Settings → Display → Graph Style. Clicking the limit list toggles between "used share and reset time" and "available share and time remaining".

Each limit type has its own shape and color, and the color changes as usage rises.

	Icon	5-Hour	7-Day	Extra Usage	Model 1 Weekly (e.g. Fable)	Model 2 Weekly (e.g. Opus, Sonnet)	Monochrome
Claude
Codex

Weekly per-model usage takes the Model 1 and Model 2 styles in the order the API returns the models, with names as returned for the account. The menu bar shows at most the first two models; the detail window lists every model, alternating between the two styles.

Claude colors:

• 5-Hour: → →
• 7-Day: → →
• Extra Usage: → →
• Model 1 Weekly (e.g. Fable): → →
• Model 2 Weekly (e.g. Opus, Sonnet): → →

Codex colors:

• 5-Hour: → →
• 7-Day: → →
• credits: → →

In the monochrome theme, limits stay distinguishable by shape, and the icons invert automatically with the menu bar. Menu bar brightness follows the wallpaper, not the system Light or Dark appearance.

By default the menu bar shows every limit that has data. To pick them individually, switch to Custom Display in Settings → Display → Limit Types.

A system notification is sent when usage reaches a threshold, and again when a quota resets. Thresholds are set per category, from 50% to 100% in steps of 5%.

Smart mode adapts to how usage changes: once a minute while usage moves, then stepping down to every 3, 5 and 10 minutes when nothing changes, and back to once a minute as soon as a change is detected. While idle, it sends about a tenth of the requests.

Fixed mode refreshes every 1, 3, 5 or 10 minutes.

Rate limits trigger an automatic backoff. When a refresh fails, the previous data stays on screen with a marker next to the title. The app refreshes on wake from sleep and when the detail window opens; clicking the ring or graph refreshes manually, with a 10-second debounce.

Claude supports multiple accounts and multiple organizations under one account; Codex accounts are managed separately. Each account can have an alias. Switch accounts from the "…" menu in the detail window or the menu bar icon's right-click menu.

Sign-in runs in the system browser, so Google, Microsoft, enterprise SSO and passkeys all work. Claude also accepts a manually entered Session Key.

When OpenAI announces an upcoming global quota reset, a badge appears next to the Codex column title; otherwise nothing is shown. The data comes from the third-party community project codex-reset.com, not an official API, and can be turned off in Settings.

English, 日本語, 简体中文, 繁體中文, 한국어, Français (@mtreize), Deutsch (@schaitl). The system language is used by default. New translations are welcome; see Contributing.

1. Download the latest .dmg from Releases and drag the app into Applications
2. Gatekeeper blocks the first launch; see the first FAQ entry to allow it
3. When the app first reads its credentials, grant Keychain access and choose "Always Allow"

Requires macOS 13 (Ventura) or later, on Intel or Apple silicon.

Updates are installed in-app by Sparkle. Each update is verified against an EdDSA signature before it is installed. Homebrew is not offered at this time.

Requires Xcode 26 or later.

git clone https://github.com/f-is-h/Usage4Claude.git
cd Usage4Claude
open Usage4Claude.xcodeproj

Press ⌘R in Xcode to run. The app is written in Swift and SwiftUI, with AppKit for the menu bar and window management.

The first launch opens an onboarding window where both Claude and Codex can be signed in. Onboarding can be skipped; accounts can be added later in Settings → Accounts.

Browser Login: click the sign-in button, authorize in the system browser, and the app picks up the result automatically. The callback is received on a temporary local port. If a firewall blocks local connections, the browser stays on a localhost address; paste that address into the sign-in window to finish.

Manual Session Key (Claude only):

1. Open the claude.ai usage page in a browser
2. Open the developer tools (⌥⌘I), switch to the Network tab and reload the page
3. Find the usage request and copy the full sessionKey=sk-ant-... value from the Cookie request header
4. Paste it into the input field. The Organization ID is fetched automatically, and every organization under the Session Key is added

Left-click the menu bar icon to open the detail window; right-click for the menu. The menu holds account switching, Settings, Check for Updates, and links to the Claude and Codex status pages.

When a new version is available, the menu bar icon shows a badge and Check for Updates is marked in the menu.

• No server; data stays on the Mac, with no analytics or telemetry
• Network requests fall into three groups only: the Claude and Codex sign-in and usage endpoints, Sparkle checking GitHub for updates, and codex-reset.com when the Codex reset announcement is on
• Session Keys and tokens are stored in the Keychain, never in plain text; API responses are not written to the disk cache
• App Sandbox is enabled. Beyond network access, it only opens the local port used by the sign-in callback and the system services Sparkle needs to install updates
• Diagnostic reports are redacted before export, with tokens and other sensitive fields replaced
• The source code is fully public and open to audit

Changes in each release are recorded in CHANGELOG.md.

In progress: ongoing improvements and issue fixes

Under consideration: more interface languages, desktop widgets, usage history charts

Not planned

• Services other than Claude and Codex. Menu bar space is limited, and every added provider takes space from every user's menu bar. The project focuses on doing these two well rather than becoming a general usage dashboard.
• Uploading data of any kind. The project has no server and has no plans to add one.
• App Store distribution. The app reads usage through undocumented APIs, which does not meet App Store requirements.

Issues and pull requests are welcome; see CONTRIBUTING.md for the process.

Adding a language: copy Usage4Claude/Resources/en.lproj/Localizable.strings into a new <language-code>.lproj folder and translate the values. CI checks that every language has the same keys.

Code

Translation

Feedback and Feature Requests

MIT License; see LICENSE. Copyright © 2025-2026 f-is-h.

This is an independent third-party tool with no official affiliation with Anthropic or OpenAI. Follow each service's terms when using it.

Most of the code was written by Claude and Codex. The icon design draws on both companies' official branding.

Report problems in Issues; for everything else, use Discussions.