QuotaLens

Ever hit a Claude rate-limit mid-flow with no warning?
QuotaLens fixes that — a macOS menu-bar gauge that shows your Claude and Codex quotas at a glance, before you run out.

English · 简体中文

Claude and Codex don't tell you how much quota you've used — until you're throttled. QuotaLens probes the official rate-limit headers and local session files so you always see a live ring + percentage in your menu bar, with per-account cards and a full statistics window one click away.

No dashboards. No browser tabs. Just a number in the corner.

QuotaLens lives in your menu bar as a small ring + percentage of your highest current usage. Click it for a panel with per-source cards — the authoritative 5-hour / 7-day limits, the current session, and a 24-hour timeline. A separate statistics window breaks down tokens, cost, and cache over any time range.

It tracks two tools side by side:

• Claude — one card per account, each probed with its own claude setup-token.
• Codex — read locally from ~/.codex/sessions, no network.

	Claude	Codex
Live 5h / 7d quota	✓  official probe	✓  official (local file)
Multiple accounts	✓  one token each	single (local login)
Token / cost history	✓  CLI account	✓
Network use	tiny probe, throttled	none

• Multiple Claude accounts — add each with its own token; every account is its own card. Up to 4 sources total.
• Authoritative limits — Claude reads the real anthropic-ratelimit-unified-* headers; Codex reads its official rate_limits from local rollout files.
• Token-expiry alerts — when a token expires the card flags it and sends a system notification to re-paste.
• Statistics window — tokens / cost / cache with a smooth multi-series trend chart. Pick Today / 3d / 7d / 30d / All or a custom range; short ranges render hourly. Hover for per-point detail.
• Launch at login — optional, via SMAppService.

Requirements: macOS 13+, Xcode 16+ (Swift 6 toolchain) — only needed if building from source.

brew tap mangiapanejohn-dev/tap
brew install --cask quotalens

Download QuotaLens.dmg from the latest release, open it, and drag to /Applications.

git clone https://github.com/mangiapanejohn-dev/QuotaLens.git
cd QuotaLens
make install      # builds and copies QuotaLens.app to /Applications

Or produce a drag-to-install disk image:

brew install create-dmg
make dmg           # writes build/QuotaLens.dmg

1. In a terminal, run claude setup-token for the account you want to track and copy the token.
2. Open QuotaLens → gear icon → Sources → Add Claude account, give it a name (e.g. Pro, Max 5x) and paste the token.

Codex needs no setup — it reads ~/.codex/sessions automatically. When a token expires, the card turns red; use replace token to paste a fresh one.

The statistics window reflects only the sources you've configured — no Claude account means no Claude data.

Everything runs locally. The only network call is the Claude probe — a minimal, throttled request used solely to read the rate-limit headers. Tokens are stored in UserDefaults on your machine. Nothing is sent anywhere else.

make run        # build, bundle, and launch QuotaLens.app
make install    # build + copy to /Applications
make dmg        # drag-to-install DMG (needs create-dmg)
make icon       # regenerate AppIcon.icns from Resources/AppIconSource.png
make test       # run the unit tests

The official Claude / Codex marks shown on source cards are pulled from your locally installed Claude.app / Codex.app at build time (make logos) and are not redistributed in this repo; without those apps the UI falls back to SF Symbols.

• Gemini / OpenAI source support
• Menu-bar color thresholds (green → yellow → red)
• Weekly usage summary notifications
• iCloud sync across Macs

Have an idea? Open an issue — PRs welcome.

1. Fork the repo and create a branch: git checkout -b feat/your-idea
2. Make your changes and run make test
3. Open a pull request with a clear description

Please keep PRs focused — one feature or fix per PR. See CONTRIBUTING.md if it exists, otherwise just open an issue first for larger changes.

MIT. The Claude and Codex names and logos are trademarks of their respective owners and are used here only to identify the tools being monitored.

用 Claude 用到一半突然被限速，却不知道剩多少额度？
QuotaLens 解决这个问题 —— 一个 macOS 菜单栏表盘，实时显示你的 Claude 和 Codex 额度，在耗尽之前就能看到。

QuotaLens 常驻菜单栏,显示一个圆环 + 当前最高占用的百分比。点开是一个面板,每个来源一张卡:权威的 5 小时 / 7 天额度、当前会话、24 小时时间线。另有独立的统计窗口,按任意时间范围拆解 token、成本、缓存。

并排追踪两个工具:

• Claude —— 每个账号一张卡,各自用自己的 claude setup-token 探测。
• Codex —— 直接读本机 ~/.codex/sessions,不联网。

	Claude	Codex
实时 5h / 7d 额度	✓  官方探测	✓  官方(本地文件)
多账号	✓  每账号一个 token	单一(本地登录)
token / 成本历史	✓  CLI 账号	✓
联网	极小探测、限频	不联网

• 多 Claude 账号 —— 每个粘一个 token,各成一张卡,整个面板最多 4 个来源。
• 权威额度 —— Claude 读真实的 anthropic-ratelimit-unified-* 响应头;Codex 读本地 rollout 文件里的官方 rate_limits。
• token 过期提醒 —— 过期时卡片标红并发系统通知提醒重新粘贴。
• 统计窗口 —— token / 成本 / 缓存 + 丝滑的多序列趋势图。可选 今天 / 3天 / 7天 / 30天 / 全部 或自定义区间;短范围按小时绘制;hover 看每个点的明细。
• 开机自启 —— 可选,基于 SMAppService。

环境要求: macOS 13+。从源码构建需要 Xcode 16+（Swift 6 工具链）。

brew tap mangiapanejohn-dev/tap
brew install --cask quotalens

从 最新 Release 下载 QuotaLens.dmg,打开后拖入 /Applications。

git clone https://github.com/mangiapanejohn-dev/QuotaLens.git
cd QuotaLens
make install      # 构建并把 QuotaLens.app 拷到 /Applications

1. 终端里对目标账号运行 claude setup-token,复制 token。
2. 打开 QuotaLens → 齿轮图标 → Sources → Add Claude account,起个名字并粘贴 token。

Codex 无需配置 —— 自动读 ~/.codex/sessions。token 过期时卡片标红,在该账号上用 replace token 粘一个新的即可。

一切都在本地运行。唯一的联网是 Claude 探测 —— 一个极小、限频的请求,仅用于读取额度响应头。token 本地存于 UserDefaults,不向任何其它地方发送。

• 支持 Gemini / OpenAI 来源
• 菜单栏颜色阈值（绿 → 黄 → 红）
• 每周用量摘要通知
• iCloud 多 Mac 同步

有想法？提个 Issue —— 欢迎 PR。

MIT。Claude、Codex 名称及 logo 为各自所有者的商标,此处仅用于标识被监控的工具。