WINDOWS · CODEX 辅助工具

Codex 悬浮条指南：用量、上下文与更新助手怎么用

CodexUsageOverlay 是面向 Windows Codex 桌面应用的用量与更新助手。它跟随 Codex 窗口展示常用的账户额度、重置时间、Token 与任务状态，并提供本机上下文信息和桌面版更新入口。

作者：拾玖Blues · 更新：2026-10-14 · 根据公开 README 与安装说明整理

把哪些信息放到窗口旁

主用量条用于查看套餐、短周期和周用量窗口、重置时间、可用重置券、累计 Token 与任务状态。设置面板提供位置、字体、主题与刷新间隔选择；可从悬浮条打开 Codex 桌面版 MSIX 更新助手。

本机上下文信息条用于查看当前匹配会话的上下文占用、累计 Token、缓存命中率与输入输出明细。原生分析入口则展示产品、模型、使用端以及技能和插件调用等分析数据。不同区域的数据口径不同，需要分别理解。

这是公开的非官方辅助工具，与 OpenAI 无隶属或背书关系。界面预览里的演示数字不代表你的账户，实际用量以本机 Codex 返回的数据为准。

账户数据不可读时，先核对 Codex 本身的登录状态和 CLI 是否可用；自定义 CLI 路径可通过 CODEX_CLI_PATH 指向真实程序。不要把认证文件、令牌或本机会话上传到公开问题描述中。

选择当前发布包。打开最新公开 Release ↗，核对版本、安装包名称和同版本校验文件。仓库早期说明中的固定下载地址可能对应旧版本。
先校验再运行。在 PowerShell 用 Get-FileHash -Algorithm SHA256 计算已下载安装包的哈希，与校验文件中同名文件逐字核对；不一致时停止。
按安装器完成当前用户安装。公开安装说明给出的目标位于当前用户本地应用目录，创建桌面与启动快捷方式。覆盖更新后仍应核对程序与设置。
打开并聚焦 Codex。Codex 未打开、最小化或失焦时，悬浮信息隐藏可能是正常行为。聚焦实际对话窗口后，查看用量条是否出现；首次使用指引可完成或跳过。
按需调整设置。单击齿轮展开面板，查看版本与显示位置。外观修改可预览，保存与取消分别决定是否保留；顶部“分析”和“上下文”按钮默认隐藏，可在设置中开启。

仓库提供只读诊断入口 CodexUsageOverlay.exe --snapshot，可用来检查窗口识别与数据来源。核对时只报告必要状态与错误，避免公开邮箱、套餐额度或账户 Token 明细。安装进程存在只是第一步，还要核对实际窗口与数据读取。

三类数据的用途与核对点
显示区域	用于判断什么	怎样核对
账户用量条	额度窗口、剩余比例、重置时间及账户状态	和 Codex 本机返回的窗口信息核对。登录异常或字段不完整时，工具可能保留上一次成功结果，应检查状态与更新时间。
本机会话上下文	上下文占用、输入／缓存／输出与累计 Token	仅按当前标题唯一匹配本机会话；同名歧义不猜测。超过 15 分钟的记录标为“上次记录”，未匹配时显示等待提示。
原生分析	产品／模型用量、轮次、技能与插件调用	7 天和 30 天按 UTC 截止昨天；缺失日期不补零，保留返回单位，不能把百分比或轮次解释为 Token。

上下文占用不是账户额度或计费数据。累计输入已经包含缓存，不能再把缓存重复相加；缺少累计字段时显示“—”，不据此推算费用、速度或轮次。窄分栏或安全空间不足时，信息条可能缩成单行或暂不显示，以避免遮挡。

账户额度通过 Codex CLI 本地 app-server 接口读取；任务与上下文来自本机会话的事件、token_count 数字和时间。公开说明区分这些来源，不把所有显示当作实时账户计费。
原生分析会读取 CODEX_HOME/auth.json 中现有登录态，在内存中用于固定的 ChatGPT 分析接口请求；不刷新或改写共享登录文件，不上传本地对话。该客户端内部接口并非稳定公开 SDK，变化或不可用时会显示错误。
Tibo 重置预告来自公开的非官方状态源，不保证每个账户同时到账。预告或旧缓存都不能替代你自己的 Codex 额度返回值。
窗口识别、页面布局和登录状态会影响显示。处理故障应记录实际窗口状态、数据来源与错误，不能以截图示例或启动成功替代真实数据核对。
项目使用 AGPL v3.0；分发或修改时请阅读仓库许可证与第三方来源说明。本文没有替读者安装、读取账户或完成桌面 GUI 验收。