Codex Quota Tracker

一个用于在 VS Code 中查看 Codex 实时额度的扩展。

当前版本会通过 ChatGPT 账号授权自动读取 Codex 的额度信息，并在侧边栏中以深色卡片样式展示：

• 5 小时限额
• 周限额
• 每个额度窗口的下次刷新时间
• 剩余可用额度百分比
• 横向进度条
• 最近一次同步状态与错误信息

功能特性

• 优先复用本机已有的官方 Codex CLI 登录态
• 如果本机没有可导入的登录信息，则自动拉起浏览器完成 ChatGPT 登录
• 登录成功后自动请求 ChatGPT / Codex usage 接口
• 侧边栏使用卡片式 Webview UI 展示额度信息
• 状态栏显示最近一个额度窗口距离刷新还有多久
• 支持自动后台刷新和手动刷新

工作方式

扩展会优先尝试读取本机 ~/.codex/auth.json 中已有的登录态。

如果读取不到可用 token，则会打开系统浏览器，走 ChatGPT 的 OAuth 登录流程。登录成功后：

1. token 会保存到 VS Code Secret Storage
2. 最近一次额度快照会保存到 VS Code globalState
3. 扩展会自动请求额度接口并刷新侧边栏 UI

当前 UI 说明

侧边栏弹窗展示，展示逻辑如下：

• 百分比显示的是“剩余可用额度”
• 进度条长度也表示“剩余可用额度”
• 5 小时限额 和 周限额 分别显示独立的刷新时间
• 底部展示同步状态和上次同步时间

使用方式

打开左侧活动栏中的 Codex Quota 视图后：

1. 点击 连接 ChatGPT 账号
2. 如果你本机已经登录过官方 Codex CLI，扩展会自动导入该登录态
3. 如果没有可导入的登录态，扩展会打开系统浏览器引导你登录
4. 登录完成后，扩展会自动同步额度数据
5. 之后你可以随时点击 刷新额度

可配置项

可以在 VS Code Settings 中搜索 Codex Quota Tracker，当前支持：

• codexQuotaTracker.showStatusBar 是否在状态栏显示最近一个额度窗口的倒计时
• codexQuotaTracker.autoRefreshEnabled 是否启用后台自动刷新
• codexQuotaTracker.refreshIntervalMinutes 后台自动刷新间隔，单位分钟
• codexQuotaTracker.enableDebugLogs 是否输出调试日志到 Output Channel