Quota Lens — Development skill for Claude Code
A translucent Windows widget for monitoring Claude Code and Codex subscription quotas.
How to install Quota Lens
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open Torbjorn-Zhang/quota-lens and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Quota Lens does
A translucent Windows widget for monitoring Claude Code and Codex subscription quotas.
Alternatives in Development
- Quosparr — 🐦 Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets 288 ★
- Opencode Antigravity Quota — OpenCode plugin to monitor Antigravity API/Gemini Cli quotas across multiple accounts 131 ★
- Applemusic MCP — Apple Music MCP server: playlists, library, catalog, playback and the Up Next queue, on macOS, Windows and Lin 118 ★
README
Quota Lens
[English](README.en.md) | 简体中文
[](https://github.com/Torbjorn-Zhang/quota-lens/actions/workflows/ci.yml) [](https://github.com/Torbjorn-Zhang/quota-lens/releases) [](LICENSE)
Quota Lens 是一个轻量的额度小工具,用于实时查看 **Claude Code** 与 **Codex** 的订阅额度、重置时间和剩余比例。Windows 上是透明桌面小组件(可贴边成侧栏),macOS 上是菜单栏应用。

[!IMPORTANT] 本项目是非官方社区工具,与 Anthropic 或 OpenAI 无隶属或背书关系。额度接口并非稳定的公共 API,上游变化可能导致功能暂时失效。
功能
- 同时显示 Codex 与 Claude Code 的 5 小时、7 天等额度窗口;Codex 短周期额度恢复后会在下次刷新自动重新显示
- 自动识别并显示 Fable 等模型家族的独立周额度(Fable 5 与 Fable 5.1 共用同一份 Fable 周额度);接口返回多个模型家族时逐行显示,未返回时自动隐藏
- 识别 Claude Pro、Max 5× 与 Max 20× 方案;点击刷新会立即更新 Claude 方案与额度
- 显示订阅方案、重置倒计时、附加 credits 与模型专项周额度
- Codex 每 60 秒刷新;Claude 最快每 3 分钟刷新
- Claude 遇到 HTTP 429 时自动按 5/10/20/30 分钟退避,并保留上次成功数据
- 可从托盘关闭低额度提醒;开启时会合并同时出现的提醒,同一重置周期只提醒一次
- 透明悬浮窗、置顶、拖动、托盘常驻和透明度调节
- 贴边侧栏:拖到屏幕左/右边缘后收成一条竖条,用同心圆和重置时间展示全部额度,鼠标停上去弹出完整面板,移开自动收回
- 一键关闭所有显示器,同时阻止系统自动睡眠;鼠标或键盘即可唤醒屏幕
- 可选随 Windows 登录自动启动
- macOS 菜单栏版:菜单栏图标用两组迷你同心圆显示 Codex 与 Claude 额度,点一下即弹出同款深色面板,逐项显示剩余百分比和实时重置倒计时
- 不保存 OAuth token,不记录请求或凭据日志
系统要求
- Windows 10 或 Windows 11(x64),或 macOS 11 及以上(Apple Silicon 或 Intel)
- 已使用 ChatGPT 账号登录 Codex
- 已使用 Claude 订阅账号登录 Claude Code,或已登录 Claude Desktop(Windows 上为 Microsoft Store 版)
API key、Bedrock、Vertex 等按量计费账号通常没有相同的订阅额度百分比,因此不在支持范围内。
安装
Windows
- 从 Releases 下载最新的
QuotaLens-*-win-x64.zip。 - 解压到一个固定目录。
- 双击
QuotaLens.exe。 - 如需开机启动,在托盘菜单中启用“开机启动”。
当前版本未进行商业代码签名,Windows SmartScreen 可能首次显示提示。请只从本仓库的 Releases 下载,或自行从源码构建。
macOS
**一键安装**:打开“终端”,粘贴运行:
curl -fsSL https://raw.githubusercontent.com/Torbjorn-Zhang/quota-lens/main/install-mac.sh | bash
脚本自动识别 Apple Sili
Related Skills
QuotaDock
Windows desktop widget that monitors Claude, OpenAI Codex, and Google Antigravity (Gemini) usage limits, quota
Agent Usage
A local desktop widget for Codex and Claude Code usage, subscription limits, and resets. Linux and Windows.
Agent Quota Tracker
⚡ Local CLI monitor, autonomous watchdog, and live dashboard tracking 5-hour rolling rate limits, weekly quota
Orbit Lan
Personal Windows dashboard for Codex and Claude agents, files, quotas and command logs on iPhone and iPad.
Fluxion Bus
Local-first MCP gateway for delegating scoped tasks across Codex, Claude Code, and Antigravity, plus quota mon
Asale
Desktop client for the Asale token-sharing network: sell idle Claude, ChatGPT/Codex, Gemini, Kimi and Grok sub
Related Agents
Iced Upgrade Reviewer
Review code changes for Iced 0.14 API compliance. Use proactively when editing widget/subscription/Task/Elemen
Kimi Worker
Forward a coding, diagnosis, or review task to Kimi K3 (Moonshot) through the local kimi-worker.sh runtime. Us
GPT 5.6 Luna
General-purpose agent that runs on GPT-5.6-Luna (routed through the shunt gateway to the ChatGPT/Codex subscri