自制了个桌面小摆件:一条神龙实时显示 Claude Code 的额度和状态

起因是每次想知道 Claude Code 还剩多少额度,都得敲 /usage 或者翻网页,挺烦。 干脆做了个桌面小摆件,放屏幕边上瞄一眼就行。

屏幕上是一条中国神龙,左右两根竖条分别是「 5 小时窗口」和「 7 天窗口」的剩余额度, 下面还有重置倒计时。神龙本身会根据 Claude 的状态变表情:

• 没连上 → 睡觉(冒 z ）
• 在线空闲 → 醒着,旁边浮一颗龙珠
• 正在跑任务 → 三颗龙珠绕圈转
• 有权限弹窗等你批 → 瞪大眼睛冒问号

底部还显示今日 / 累计 token 、正在运行 / 等待的会话数。

原理:PC 上跑一个小桥接程序(Go 写的,Win/Mac/Linux 都能跑）， 读本机 Claude 登录后的订阅 token ，查 /api/oauth/usage 拿额度， 通过 USB 串口推给设备；会话状态则走 Claude 桌面端官方的蓝牙 Hardware Buddy 协议 (Nordic UART + 配对加密)。

硬件是国产的 ES3N28P （ ESP32-S3 + 2.8” ILI9341 240×320 触摸屏），几十块钱。 固件 PlatformIO + Arduino + LovyanGFX ，刷进去就能用。

开源在这:https://github.com/seth-shi/claude-desktop-buddy