Codex Usage Float

一个适用于 Windows 的 Codex 用量悬浮窗。它会读取本机 Codex 登录信息，显示当前 1 周限额的剩余百分比与重置时间。

功能

• 显示 Codex 1 周限额
• 每 60 秒自动刷新，双击悬浮窗可立即刷新
• 始终置顶、圆角白底和可调透明度
• 自动记住窗口位置，可锁定避免误拖动
• 支持系统托盘、隐藏和完全退出
• Esc 隐藏到托盘，不会退出程序
• 单实例运行，重复启动不会出现多个窗口
• 网络失败时保留上一次成功读取的数据
• 支持 Windows 高 DPI 缩放

环境要求

• Windows 10 或 Windows 11
• Python 3.10 或更高版本
• 已经使用过 Codex，并存在 %USERPROFILE%\.codex\auth.json

安装

git clone https://github.com/1359096297/codex-usage-float.git
cd codex-usage-float
python -m pip install -r requirements.txt

启动

推荐使用无控制台窗口的启动脚本：

powershell -ExecutionPolicy Bypass -File .\Run-CodexUsageFloat.ps1

也可以直接运行：

python .\codex_usage_float.py

操作

• 拖动悬浮窗：移动位置
• 双击悬浮窗：立即刷新
• 右击悬浮窗：显示操作菜单
• 左击托盘图标：显示或隐藏悬浮窗
• 右击托盘图标：刷新、锁定位置、设置透明度或退出
• 按 Esc：隐藏到托盘

透明度支持 70% / 80% / 85% / 90% / 92% / 95% / 100%，选择后会自动保存。

数据与隐私

程序从 %USERPROFILE%\.codex\auth.json 读取现有的 Codex 访问令牌和账号 ID，只向 https://chatgpt.com/backend-api/wham/usage 请求用量数据。这些凭证不会写入项目目录，也不会发送到其他服务。

该接口不是公开承诺稳定的 API，未来可能发生变化。本项目与 OpenAI 无官方关联。

完整说明见 docs/使用说明.md。