QuotaFrame.

A LITTLE SPACE FOR YOUR AI USAGE

AI 编码额度，
抬眼即见。

让 Codex 和 Claude 的用量，
在桌面上有自己的位置。

一块独立小屏，显示额度百分比与重置倒计时。
少一次窗口切换，多一点专注。

设置我的设备看看它如何工作

开源项目 · 支持 macOS 与 Windows · 蓝牙同步

QuotaFrame 总览界面设计：Codex 和 Claude 各显示短期、每周用量，以及重置倒计时。图中为演示数据。
界面设计预览 · 演示数据，非设备实拍

MADE FOR YOUR DESK

重要的信息，留在视线里。

从电脑获取用量，通过蓝牙同步到小屏。
电脑端需要持续运行，才能保持数据更新。

01 / 一眼看全

两个工具，一个总览

把 Codex 和 Claude 放在一起，看清短期和每周用量。

02 / 心里有数

知道何时恢复额度

百分比与重置倒计时同时显示，接近用量上限时更醒目。

03 / 少些打断

给工作窗口留出空间

额度信息留在独立屏幕上，不必为了查看用量反复切换窗口。

第 1 步

选择你的设备

按外观和完整型号核对。相同芯片的不同设备不能混用固件。

正在读取支持的设备…

设备图来自 M5Stack 与 微雪官方文档，屏幕内容为厂商演示。

ONE LAST CONNECTION

在电脑上连接它。

固件安装好后，完成这三件事，
让用量从电脑走到桌面。

macOS 14 或更新版本 · 仅 Apple Silicon · 需要蓝牙

  1. 准备好用量来源

    安装 CodexBar，并确认它能正常显示 Codex 或 Claude 的用量。

    还需在 CodexBar 的 Preferences → Advanced 中执行 Install CLI，并确认所用账号已登录；仅在应用中看到数字不代表 CLI 已准备好。

  2. 安装 QuotaFrame 电脑端

    在发布页下载 macos-arm64 .dmg 安装包，安装并打开 QuotaFrame Bridge。

    前往下载电脑端

  3. 添加设备，开始同步

    在电脑端添加蓝牙设备，按提示完成配对。屏幕出现用量百分比和重置倒计时，就可以开始使用了。

重新烧录过设备？先删除电脑中的旧蓝牙配对记录。完整电脑端指南

你可能还想知道

需要一直连接 USB 吗？

首次安装固件需要 USB 数据连接。用量通过蓝牙同步；日常使用仍需根据设备情况供电或充电。

电脑需要一直开着吗？

需要保持电脑端运行、蓝牙连接正常，并能从 CodexBar 或 Win-CodexBar 读取用量，屏幕才能继续更新。

已经装过固件，如何更新？

Windows 可通过 QuotaFrame Bridge 的 OTA 功能更新固件。macOS 暂未提供 OTA，请连接 USB，使用网页安装对应型号的固件；网页也可用于首次设置或恢复设备。

可以使用其他 ESP32 屏幕吗？

当前网页只提供上方设备列表中的固件。即使芯片型号相同，屏幕和引脚也可能不同，请勿混用。