一个立在桌面上的claude模型小硬件：**实时显示 Codex / Claude / 中转站还剩多少额度**。

写代码前瞄一眼，就知道这个 5 小时窗口还能不能放开用、余额还剩几块钱。

开源地址：[https://github.com/0990/esp32-ai-usage](https://github.com/0990/esp32-ai-usage)

## 它这样工作

Codex / Claude 订阅：显示 5 小时和 1 周窗口的剩余百分比、恢复时间：

中转站（API key 计费,支持sub2api和new-api）：显示已用金额和剩余余额：

## 亮点

- **屏幕支撑杆可拨动调节**：屏幕角度随手一拨就换，想立就立、想躺就躺；

  杆子里藏了颗波珠螺丝，拨动时**嘎嗒嘎嗒**的段落感，闲下来还能当解压玩具。

- **一根 USB 线搞定**：既供电又传数据，小硬件本身不联网、不存任何账号信息。

- **不消耗额度**：电脑端程序读的是本机已登录的 Codex / Claude 凭据，

  调用的是客户端内部同款「用量查询」接口——只查询、不跑模型。

- **材料便宜好买**：核心就是一块 ESP32-C3 和一块 0.91 寸 OLED，动手部分只需焊 4 根线。

## 动手做一个（三步）

1. **备料** —— 清单和购买链接，见组装指南：材料表.pdf

2. **组装** —— 焊线、装拨动杆、装壳，跟着图走，见组装指南： 硬件安装.pdf

3. **装软件** —— 给 ESP32 刷一次固件 + 电脑上运行 `esp32-ai-usage.exe`，见组装指南：软件使用.pdf

装好后把它插上电脑 USB，电脑端程序会自动找到它并开始显示。

## 工作原理（一句话版）

```

电脑端程序（读本机已登录的 Codex/Claude 凭据，调用官方用量接口）

        │  USB 串口，每 4 秒发一屏

        ▼

ESP32-C3 ──I2C──> OLED 小屏（只负责显示，不联网）

```