Quota Lens — Development skill for Claude Code

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

1. 从 Releases 下载最新的 QuotaLens-*-win-x64.zip。
2. 解压到一个固定目录。
3. 双击 QuotaLens.exe。
4. 如需开机启动，在托盘菜单中启用“开机启动”。

当前版本未进行商业代码签名，Windows SmartScreen 可能首次显示提示。请只从本仓库的 Releases 下载，或自行从源码构建。

macOS

**一键安装**：打开“终端”，粘贴运行：

curl -fsSL https://raw.githubusercontent.com/Torbjorn-Zhang/quota-lens/main/install-mac.sh | bash

脚本自动识别 Apple Sili