Quota Peek — Development skill for Claude Code

QuotaPeek / 余量

**所有大模型额度，一眼看清。**

QuotaPeek 是一个本地优先的 macOS 菜单栏与桌面悬浮工具，把 Codex（ChatGPT）、Claude、Kimi、GLM Coding Plan、Grok 的订阅余量、额度窗口与刷新时间集中在一处显示。数据全部通过官方 CLI / 接口在本机获取，不经过任何第三方服务器。

功能

• 菜单栏图标实时显示最紧张的额度状态。
• 可置顶、可跨桌面的悬浮面板，适合长时间挂在屏幕角落。
• 智能推荐：各家额度到期不结转，没用完就浪费。QuotaPeek 会给每家「头号指标」（有月额度看月，没有就看周）算一个「剩余量 × 刷新紧迫度」的分数，自动把最该优先使用的 Provider 卡片置顶，并标出「⚡ 推荐优先使用」。
• 每个卡片显示：
  • 套餐徽标，按各家真实层级分色 —— 顶级金色、高端紫、中端蓝、基础灰。
  • 数据源彩色标签 —— 官方 API（绿）、本地 RPC（蓝）、官方 CLI（紫）、本地缓存（橙）。
  • 额度窗口按月 > 周 > 5 小时等重要性排序，头号指标用更大字号、更粗进度条突出显示。
  • 进度条按已用量填充（越用越满、越红），刷新时间统一显示为「X 天 Y 小时后刷新」。
• 额度低于 10% / 20% / 25% 阈值时发送本地通知。
• 自动刷新、本地缓存、错误状态保留（接口临时失败时仍显示上一份好数据）。
• 支持登录时自动启动，可在设置中随时关闭。
• 凭证只存本机：GLM API Key 与 Grok Cookie 存 macOS 钥匙串，Kimi 网页登录态存 WKWebView 持久存储。

各家数据来源

QuotaPeek 不保存账号密码，也不把凭证或额度上传到任何服务器。

Provider	数据源	前置条件
Codex	官方 codex app-server 的 account/rateLimits/read（本地 RPC）	安装 Codex CLI 并登录
Claude	官方 Claude Code /usage（官方 CLI）	安装 Claude Code 并登录 Pro/Max 订阅
Kimi	默认走官方 Kimi CLI /usage（5 小时 / 每周）；在设置中登录 Kimi 网页账号后，改走官方会员接口（额外显示套餐名与月度总额度）	安装 Kimi CLI 并登录；网页接口需在设置中登录一次
GLM	Coding Plan /api/monitor/usage/quota/limit（官方 API）	在设置中保存 Coding Plan API Key
Grok	grok.com /rest/rate-limits（官方 API，按模型的请求次数额度）	在设置中粘贴从浏览器复制的 grok.com Cookie

关于 Grok 的数据源

Grok 没有官方 CLI，订阅额度只在 grok.com 网页可查，而 xAI 用 **Cloudflare bot 防护**会拦截 app 内嵌 WebView（且 Google 登录也拒绝内嵌 WebView）。但 Cloudflare **只拦浏览器 challenge、不拦纯 API 调用**，所以 QuotaPeek 改用 `URLSession` 直连 `/rest/rate-limits`，带你从浏览器复制的登录 Cookie（存 macOS 钥匙串）。

• Grok 按请求次数计额度，每个模型独立配额（免费层：Grok 4 每 24h 7 次、Grok 3 30 次、Grok 4 Heavy 每 2h 20 次；SuperGrok 订阅数值更高）。卡片直接显示 剩 7/7 原始次数。
• 徽标按订阅层级分色：Free（灰）/ SuperGrok（紫），查 /rest/subscriptions 判断。
• 获取 Cookie：浏览器登录 grok.com → 开发者工具（⌥⌘I）→ Network → 刷新 → 点任一 grok.com 请求 → Request Headers → 复制整段 Cookie 值粘贴到设置。Cookie 会过期，失效后卡片会提