{"slug": "claudemeter-macos-menu-bar-app-to-track-claude-usage-and-limits", "title": "ClaudeMeter – macOS menu bar app to track Claude usage and limits", "summary": "A new free macOS menu bar app called ClaudeMeter displays real-time Claude usage and limits, including session utilization, weekly limits, and optional API spend tracking. Developed by yotake, the app polls Anthropic's usage endpoint every five minutes and supports multiple accounts, requiring an OAuth token from the Claude CLI for authentication.", "body_md": "[日本語 README はこちら / Japanese README](/yotake/claude-meter/blob/main/README.ja.md)\n\nA lightweight macOS menu bar app that shows your Claude usage in real time.\n\nClaudeMeter is free. If it saves you time, you can\n\n.[sponsor development ❤️]\n\n*Settings panel (expanded)*\n\nThe UI follows your macOS language (Japanese / English).\n\nThe same numbers as **claude.ai → Settings → Usage**, right in your menu bar:\n\n**Current session**— 5-hour rolling window utilization, with time until reset** Weekly limits**— all models / Sonnet only / Opus only, with reset day** Codex rate limits***(optional)*— read from your local Codex CLI logs**API spend***(optional)*— this month's spend via a Claude**Admin** key**Multiple accounts**— track several subscriptions/keys at once\n\nThe menu bar shows the selected account's session % (e.g. `21%`\n\n), tinted by a\nburn-rate forecast. Click the icon for the full breakdown.\n\nPolls `https://api.anthropic.com/api/oauth/usage`\n\nevery 5 minutes for\nsubscription usage (5-hour session + 7-day limits). That endpoint requires an\n**OAuth token with the user:profile scope**.\n\nClaudeMeter does **not** access the macOS Keychain directly (an ad-hoc–signed\napp reading the Keychain can trigger antivirus warnings). Instead, you paste the\nOAuth token that the `claude`\n\nCLI already manages, once, into the popover.\n\nThe pasted token is stored at\n`~/Library/Application Support/ClaudeMeter/credentials.json`\n\n(mode `0600`\n\n) and\nthe app **auto-refreshes it** using the refresh token, so you normally never\npaste again.\n\nNote:the first auto-refresh rotates the refresh token, so the`claude`\n\nCLI may ask you to log in again next time. After that, ClaudeMeter and the CLI manage tokens independently.\n\nThe usage endpoint throttles aggressive polling. On a 429 the app waits the\nserver's `Retry-After`\n\n(+60s) and recovers automatically — don't spam refresh.\n\n- macOS 13 (Ventura) or later\n- A Claude\n**Max / Pro** subscription (required to reach the usage endpoint) *(build from source only)*Swift Command Line Tools —`xcode-select --install`\n\n- Download\n`ClaudeMeter-<version>.dmg`\n\nfrom[Releases](https://github.com/yotake/claude-meter/releases), open it, and drag`ClaudeMeter.app`\n\nto Applications. - The released build is currently\n**ad-hoc signed (not notarized)**, so Gatekeeper blocks the first launch. Allow it with any of:- Right-click\n`ClaudeMeter.app`\n\n→**Open**→** Open**in the dialog **System Settings → Privacy & Security**→** Open Anyway**- Remove the quarantine attribute from Terminal:\n\n```\nxattr -d com.apple.quarantine /Applications/ClaudeMeter.app\n```\n\n- Right-click\n- Click the menu bar icon and paste your token (see\n**Setup** below).\n\nIf you already use the `claude`\n\nCLI, copy its token to the clipboard:\n\n```\nsecurity find-generic-password -s \"Claude Code-credentials\" -w | pbcopy\n```\n\n`security`\n\nis Apple's signed, built-in CLI. If a Keychain prompt appears, click\n**Allow** (ClaudeMeter itself never touches the Keychain). Then open the\npopover, paste into the field, and press **Save**. It shows\n\"Authenticated (auto-refresh)\" and refreshes the token for you from then on.\n\nOptional:\n\n- Paste a Claude\n**Admin** key (`sk-ant-admin…`\n\n) instead to track API spend. - Set a custom\n**Codex sessions folder** in Settings if your logs aren't in the default`~/.codex/sessions`\n\n(it also honors the`CODEX_HOME`\n\nenv var).\n\n```\n./build.sh\nopen ClaudeMeter.app\n```\n\n**System Settings → General → Login Items** → add `ClaudeMeter.app`\n\n.\n\n`release.sh`\n\nbuilds a universal (Apple Silicon + Intel) DMG into `dist/`\n\n:\n\n```\n./release.sh                 # ad-hoc signed DMG (Gatekeeper warns users)\n```\n\nTo produce a **notarized** DMG with no Gatekeeper warning (needs an Apple\nDeveloper Program membership), set the signing identity and notary credentials\nand re-run — see the header of `release.sh`\n\nfor the exact env vars:\n\n```\nSIGN_ID=\"Developer ID Application: Your Name (TEAMID)\" \\\nNOTARY_PROFILE=\"claude-meter\" \\\n./release.sh\n```\n\nNo secrets are written to the repo — credentials are read from the environment / login keychain at run time only.\n\nClaudeMeter is free and open source. If it's useful to you, a small tip via\n** GitHub Sponsors ❤️** helps cover the\nApple Developer membership and keeps it maintained.\n\n- It uses a\n**private API**(`/api/oauth/usage`\n\n) and reads local CLI tokens/logs, so an Anthropic/OpenAI change can break it. - If a token expires and you see an error, grab a fresh one (run\n`claude`\n\nonce, then`security … | pbcopy`\n\nagain) and re-paste via**Update token**.", "url": "https://wpnews.pro/news/claudemeter-macos-menu-bar-app-to-track-claude-usage-and-limits", "canonical_source": "https://github.com/yotake/claude-meter", "published_at": "2026-06-23 23:28:59+00:00", "updated_at": "2026-06-23 23:51:13.958729+00:00", "lang": "en", "topics": ["ai-tools", "developer-tools"], "entities": ["ClaudeMeter", "Anthropic", "Claude", "macOS", "OAuth", "Claude CLI", "Codex CLI", "yotake"], "alternates": {"html": "https://wpnews.pro/news/claudemeter-macos-menu-bar-app-to-track-claude-usage-and-limits", "markdown": "https://wpnews.pro/news/claudemeter-macos-menu-bar-app-to-track-claude-usage-and-limits.md", "text": "https://wpnews.pro/news/claudemeter-macos-menu-bar-app-to-track-claude-usage-and-limits.txt", "jsonld": "https://wpnews.pro/news/claudemeter-macos-menu-bar-app-to-track-claude-usage-and-limits.jsonld"}}