如何实时查看Codex账号5小时与每周用量上限？codex-auth双刷新机制深度解析
【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth
使用多个Codex账号时，最头疼的就是额度耗尽后才发现。codex-auth是一个用于切换和管理 Codex 账号的命令行工具，它内置了双刷新机制，能帮你实时查看每个账号的5 小时（5H）与每周（WEEKLY）用量上限、剩余百分比和重置时间，让"换号"这件事从被动应急变成主动调度。
一、5H 与 WEEKLY 两列：用量上限长什么样
执行最基础的列表命令，所有账号的额度状态一目了然：
codex-auth list输出表格包含ACCOUNT、PLAN、CREDITS、5H、WEEKLY、LAST ACTIVITY等列。其中5H和WEEKLY正是我们关心的两条用量上限线：
- 5H：Codex 每 5 小时滚动窗口的用量上限
- WEEKLY：每周窗口的用量上限
每个用量单元格显示剩余百分比 + 重置时间，例如82% (14:30)表示还剩余 82%，将在 14:30 重置；跨天时会自动补充日期，如45% (09:15 on 2 Mar)。这个展示逻辑由 src/tui/rate_limit.zig 中的resolveRateLimit窗口解析与格式化函数实现——它按window_minutes匹配 5 小时窗和周窗，再按终端宽度自适应裁剪显示内容。
想只看当前激活账号的最新额度，可以加--active：
codex-auth list --active💡
--active模式只刷新当前激活账号的用量，跳过其他行的 API 刷新，速度更快。
二、双刷新机制深度解析：API 模式 vs 本地模式
codex-auth 获取用量数据有两条完全独立的路径，这就是"双刷新机制"的核心：
| 特性 | API 模式（默认） | 本地模式（--skip-api） |
|---|---|---|
| 数据来源 | 直接请求 OpenAI 用量接口 | 扫描本地~/.codex/sessions/**/rollout-*.jsonl |
| 数据新鲜度 | 实时，最新额度状态 | 可能滞后数小时 |
| 额外能力 | 同步刷新团队名称 | 无远程调用，更安全 |
| 前置要求 | 系统需有curl | 无 |
| 刷新范围 | 所有存储账号 | 仅激活账号 |
1. API 模式：实时额度的主力路径
默认情况下，codex-auth 会用账号的 access token 直接发起 HTTPS 请求刷新用量与团队名称。核心端点定义在 src/api/usage.zig：
https://chatgpt.com/backend-api/wham/usage它还会批量并发请求多个账号（见同文件的fetchUsageForAuthPathsDetailedBatch），所以账号再多也能快速出结果。如果某个账号刷新失败，表格会直接在该行渲染401、403、TimedOut、MissingAuth等状态提示，方便你一眼定位问题账号。
2. 本地模式：离线也能看快照
不想让工具发起远程请求时，加上--skip-api即可：
codex-auth list --skip-api此模式下工具改为读取 Codex CLI 写入的本地会话日志（rollout 文件）中的token_count事件。需要知道的是：较新版本的 Codex 常把rate_limits写成null，本地数据可能停留在几小时前的快照——所以本地模式适合"大致够用"的场景，追求准确额度还是推荐默认 API 模式。
两种机制的完整行为说明见 README.md 的 Q&A 与 Disclaimer 部分，以及 docs/api.md。
三、实时盯盘：--live模式与刷新间隔配置
一次性看额度还不够，codex-auth提供了常驻刷新的终端界面。执行：
codex-auth list --live屏幕会保持打开并周期性重新拉取全部账号用量，5H / WEEKLY 列的数字随额度消耗实时跳动，特别适合跑长任务时挂着观察。switch、remove命令同样支持--live，可以在实时额度的状态下直接换号。
背后的实时刷新由 src/workflows/live_runtime.zig 中的SwitchLiveRuntime驱动：它在独立 IO 线程中按间隔发起后台刷新，刷新完成后通过display_generation版本号把最新数据交给渲染层，避免画面撕裂；同时用next_refresh_not_before_ms节流，防止刷新请求堆积。
刷新间隔可用config命令调整（范围 5 ~ 3600 秒），配置持久化保存在registry.json的interval_seconds字段：
codex-auth config live --interval 30默认间隔由 src/workflows/live_types.zig 中的switch_live_default_refresh_interval_ms决定。命令细节参考 docs/commands/config.md。
四、看懂表格细节：几个实用小提示
- 行号即选择器：
list输出的行号与switch、remove完全一致，看到某个账号额度告急，直接codex-auth switch 02即可切过去。 - 同邮箱多快照会分组：同一邮箱的多个账号快照会归到一个组头下，子行显示别名与账号名。
- LAST ACTIVITY：基于最近一次额度刷新时间，判断哪行数据"还新鲜"。
- 机器可读输出：用
codex-auth list --json可以拿到 JSON 格式的额度快照，方便接入自建面板，见 docs/json-api.md。 - 列宽自适应策略：表格如何压缩 5H/WEEKLY 单元格有统一规范，见 docs/table-layout.md。
五、上手三步走
- 安装工具：
npm install -g @loongphy/codex-auth - 安装 Codex CLI：
npm install -g @openai/codex（让账号添加更顺滑） - 用
codex-auth login登录并添加账号，然后codex-auth list --live实时盯住 5 小时与每周上限
从此账号额度管理不再靠猜：API 默认模式保证数据实时，--skip-api本地模式兜底离线场景，--live加自定义刷新间隔让两条上限线时刻在眼前。这就是 codex-auth 双刷新机制的完整价值。
【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
工程落地指南)