如何优雅的在Windows上查看Codex额度状态

项目仓库和下载入口项目仓库https://github.com/naipi11/codex-barbar当前版本 v1.0.30https://github.com/naipi11/codex-barbar/releases/tag/v1.0.30Codex Desktop 官方下载https://chatgpt.com/zh-Hans-CN/download/Codex CLI 官方文档https://developers.openai.com/codex/cliWindows 安装包备用下载百度网盘https://pan.baidu.com/s/1lh4-8PL3JJb0f4SdgCY0eg?pwd76pf百度网盘提取码76pf在 Windows 上使用 Codex 时编码、额度和重置时间往往分散在不同窗口里。我做了一个本地状态组件codex-barbar把这些信息放到托盘面板、任务栏状态条和桌面悬浮球中。当前发布版是v1.0.30本文按这个版本记录安装和基本使用。一、v1.0.30 有哪些变化1. 用量与费用视图更完整设置里的 Usage Spend 页面现在可以查看今天、最近 7 天、最近 30 天、最近 365 天和当前每周范围除了总量和按模型统计还增加了每日趋势与费用热力图。这里的费用是根据本地记录和价格目录做的估算不是 OpenAI 账单没有价格的模型不会被硬算进总金额。2. 通知改成可选功能Notifications 默认关闭需要时再开启。可以分别设置剩余额度提醒、每周重置、刷新失败/恢复、更新提示并选择声音和安全测试通知。通知会按账号和事件去重避免重复弹窗。3. 账户和窗口体验调整账户页支持管理已保存的 Codex 账号并可以给当前账号设置 PNG 头像不超过 1 MiB。设置窗口改用 Windows 原生标题栏最小化、最大化和关闭按钮更容易找到。4. 状态表面更稳悬浮球可以移动到显示器的完整区域浏览器视频进入全屏时会按规则隐藏或恢复状态表面普通桌面、资源管理器和开始菜单不会被误判为全屏。任务栏状态、托盘面板和悬浮球仍然可以分别开关。二、适用环境Windows 11 x6423H2 或更新版本。已安装 Codex Desktop 或 Codex CLI并完成登录。CLI 兼容性记录目前以 Codex CLI 0.146.0 为基线其他版本建议先做一次刷新验证。三、安装 CodexCodex Desktop打开上面的官方客户端下载页选择 Windows 版本安装并完成登录。组件读取的是本机 Codex 状态Desktop 用户如果看不到数据可以先确认本机 CLI 状态是否正常。Codex CLI第一次使用 CLI 的读者打开官方 Codex CLI 文档在安装区域选择 Windows 选项。安装完成后重新打开 PowerShell 或 Windows Terminal检查命令codex--version codex login如果已经登录第二条命令会根据当前状态给出提示。四、安装 codex-barbar从当前版本发布页或上面的备用下载地址获取 Windows 安装包codex-barbar_1.0.30_x64-setup.exe按当前用户安装不需要管理员权限。codex-barbar_1.0.30_x64-portable.zip解压后直接运行。启动后组件会常驻系统托盘。点击托盘图标即可打开状态面板。五、第一次启动打开“设置 → 通用”可以按需要开启登录时启动、任务栏状态条和悬浮球也可以调整透明度、主题、语言与刷新间隔。新安装默认开启登录时启动和悬浮球任务栏状态默认关闭。默认每 5 分钟刷新一次也可以手动刷新。刷新失败时界面会保留最近一次成功的状态并显示错误提示。悬浮球颜色表示额度区间绿色为 67%–100%黄色为 34%–66%红色为 0%–33%顺时针转速表示运行状态空闲 1×、思考 2×、Fast 3×。六、数据边界应用数据保存在%LOCALAPPDATA%\\codex-barbar。当前 CLI 配置只读凭据由 Windows 当前用户的 DPAPI 保护。用量与费用页面读取本机记录并做估算不代表官方账单。项目不收集遥测更新检查由用户在界面中手动触发。额度读取依赖 Codex 的本机接口Codex 版本变化后可能需要同步适配。七、常见问题1. 找不到 CodexCLI 用户运行codex --version。如果系统提示找不到命令请先完成 Codex CLI 安装或在设置中检查可执行文件路径。Desktop 用户先确认桌面应用已启动并完成登录。2. 用量热力图没有数据先在 Codex 中运行过几次任务再回到设置里的 Usage Spend 手动刷新。本地没有可解析记录时热力图会保持空白。3. 通知没有弹出进入 Notifications先开启通知总开关再选择需要的提醒类型。该功能默认关闭。4. 数据没有更新先确认网络和 Codex 进程正常再手动刷新如果仍无数据检查本机 Codex 版本是否在兼容范围内。