English | 日本語 | 简体中文 | 繁體中文 | 한국어 | Français | Deutsch
Track your Claude and Codex subscription usage from the menu bar.
Features · Installation · Usage · Privacy & Security · FAQ · Contributing
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.
| Service | Apps | Limits |
|---|---|---|
| Claude | claude.ai, Claude Code, desktop, mobile, Cowork | 5-hour, 7-day, Extra Usage, plus weekly usage per model (Opus, Sonnet, Fable, etc., as returned for the account) |
| Codex | Codex CLI, IDE extension, Codex web | 5-hour, 7-day, credits balance |
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.
| Option | Values |
|---|---|
| Display Content | Percentage Only, Icon Only, Icon and Percentage |
| Icon Size | Compact, Standard, Prominent |
| Theme | Color Translucent, Color with Background, Monochrome |
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%.
| Category | Levels | Default |
|---|---|---|
| 5-Hour | 1 | 90% |
| Weekly (including per-model weekly usage) | 2 | 75%, 90% |
| Extra Usage / credits | 2 | 75%, 90% |
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.
- Download the latest
.dmgfrom Releases and drag the app into Applications - Gatekeeper blocks the first launch; see the first FAQ entry to allow it
- 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.xcodeprojPress ⌘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):
- Open the claude.ai usage page in a browser
- Open the developer tools (⌥⌘I), switch to the Network tab and reload the page
- Find the
usagerequest and copy the fullsessionKey=sk-ant-...value from the Cookie request header - 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.
| Tab | Contents |
|---|---|
| Display | Menu bar appearance, limit types, graph style, appearance, time format |
| Data | Refresh mode, notification thresholds, Codex reset announcement |
| Accounts | Claude and Codex accounts, browser login, manual Session Key, connection diagnostics |
| General | Interface language, launch at login, restore defaults |
| About | Version information and links |
- 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
The app won't open: "cannot verify the developer"
The app is not notarized by Apple, so the first launch has to be allowed manually:
- macOS 15 and later: double-click the app and click "Done" in the dialog. Then go to System Settings → Privacy & Security and click "Open Anyway" at the bottom of the page
- macOS 14 and earlier: Control-click the app, choose "Open", and confirm in the dialog
This is needed once. After that the app opens normally, and in-app updates don't require it again.
Keychain access is requested again after an update
The Keychain identifies an app by its signature. This app uses a self-signed certificate, so some updates cause the system to ask again. Choose "Always Allow". Credentials in the Keychain can only be read by this app.
"Request blocked by security system"
The Cloudflare protection in front of claude.ai blocks requests it judges to be automated. Visit claude.ai once in a browser and complete the human check; the app usually recovers after that. It is triggered more often behind a VPN or proxy. This block is unrelated to the account itself, and signing in again is not needed.
"Session expired"
Session Keys and sign-in tokens expire periodically, anywhere from a few weeks to a few months. Sign in again in Settings → Accounts.
"Too many requests"
The usage endpoint has hit its rate limit. The app backs off automatically and retries later, keeping the previous data on screen. Refreshing manually again and again extends the backoff.
Codex keeps asking to sign in again
With "Advanced Security" enabled on a ChatGPT account, sign-in tokens expire much sooner, so the app has to sign in again frequently. For long-term Codex monitoring, consider turning that option off.
No usage data for a Claude account
The message "Your plan does not provide usage data" means the account has no usage dashboard on claude.ai. Free accounts have none; on Team and Enterprise, ask an admin to enable the member usage dashboard. Signing in again does not change this.
The menu bar icon is missing
macOS hides some icons when the menu bar runs out of space, and tools like Bartender or Hidden Bar may also collapse it. Hold ⌘ and drag menu bar icons to rearrange them.
The app quits unexpectedly
Export a diagnostic report from Settings → Accounts → Connection Diagnostics and attach it to an issue. The report states whether the last exit was abnormal and includes recent logs. It is redacted before export.
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 Cl
0 comments
log in to comment.