Codex Token Watcher

在 VS Code 中查看 Codex 的 Token 消耗、5 小时和周额度，以及重置卡的到期情况。

快速开始

1. 在 VS Code 扩展市场搜索并安装 Codex Token Watcher。安装后如果状态栏没有出现入口，请重新加载窗口。
2. 在当前工作区使用 Codex，点击状态栏中的 Token 信息，即可打开详情页。
3. 在详情页右上角的 设置 中选择状态栏显示项，或调整重置卡提醒。

功能介绍

Token 用量和趋势

• 当前 Thread：查看会话总消耗，以及每次提问对应的模型、思考程度、Fast 状态和 Token 用量。同一轮内连续提交的提问会分别列出，用量按整轮显示。附带文件或 IDE 上下文时，尽量显示实际提问；提问只在附件中时显示“提问内容在附件中”。
• 今日总消耗：查看当天的总用量和每小时趋势。
• 趋势：按月查看每日用量，在“总量”中查看已记录的会话消耗和各月趋势。鼠标停在图表数据点上可查看具体数值。

Token 数值使用 K、M、B、T 单位；缓存输入已包含在输入中，推理输出已包含在输出中，无需重复相加。统计按扩展运行环境的本地时区计算。

每日用量热力图

额度卡片下方的热力图按年展示每日 Token 用量，最早可查看 2023 年，颜色按当年最高日用量分为四档；鼠标停在日期方格上可查看用量；可在详情页设置中选择用量颜色或恢复默认。尚未到来的日期排列在左侧，没有记录不一定代表当天没有使用。

额度和重置卡

详情页显示 5 小时额度和周额度的剩余比例和重置倒计时，以及 我的重置卡 的可用张数和到期时间；没有有效额度记录时显示“—”。账户未返回重置卡到期详情时，页面会提示。插件只读取账户信息，不会自动使用重置卡。

插件启动时读取账户信息；最近 5 分钟有本地会话额度记录时暂停账户轮询，连续 5 分钟没有新记录后，每 5 分钟读取一次账户额度和重置卡。点击 刷新 可立即读取账户信息；之后产生的更新的会话额度也可更新显示。

读取失败时会保留上次重置卡数据并提示错误，同时每隔 10 秒自动重试，最多重试 18 次，且仅在首次失败后的 3 分钟内发起重试。请求耗时可能使实际次数少于 18 次；达到上限后可手动刷新。若启动提醒已开启，但账户响应暂未提供重置卡详情，插件会继续按正常账户读取间隔尝试。

重置卡提醒

默认在到期前 3 天开始提醒，每张卡每天最多提醒 1 次。打开详情页的 设置，可调整提前天数（1–365 天）、每日提醒次数（1–1440 次），也可开启每次启动 VS Code 时提醒；该选项默认关闭。每日多次提醒的间隔至少为 24 小时除以每日次数，已有弹窗未处理时不会重复弹出。

选择 不再提示 后，弹窗中列出的卡不会再提醒；新获得的卡仍会提醒。可在设置中选择 恢复已关闭的提醒。选择 稍后提醒 或关闭弹窗后，将按设置继续提醒。未提供到期时间的卡无法触发到期提醒，提醒也需要 VS Code 运行、插件启用且账户信息读取成功。

状态栏和会话

在详情页选择 设置 → 设置状态栏显示，可多选本轮消耗、会话消耗、5h 额度和周额度。默认显示本轮和会话消耗；全部取消时仍保留详情入口。

默认跟随当前工作区最近有人提问的 Codex 会话，自动任务的心跳不会占据对话列表，但其 Token 仍计入总量。点击 选择会话 可固定会话，点击 跟随最新 恢复自动跟随。自动跟随依据本地会话记录，并不一定与 Codex 面板中当前选中的会话一致。

设置

在 VS Code 设置中搜索 Codex Token Watcher：

读取账户额度和重置卡需要在相同 Codex 数据目录中登录 ChatGPT。账户读取失败或未返回相应额度时，插件会使用本机会话中最近的额度记录。

数据保存和远程环境

插件读取运行环境中的 Codex 会话文件，并将已读取的 Token 用量和记录时间保存到 Codex 数据目录下的 .codex-token-watcher-trends，用于今日和趋势统计。该目录不保存提问、回答或项目路径；会话文件删除后，已保存的统计仍会保留，但当前 Thread 明细需要原会话文件。安装前已删除的会话无法补回。

SSH 等远程窗口读取并保存远程主机上的数据；Windows 本地窗口使用 Windows 本机的数据。没有找到会话时，请先在当前工作区使用 Codex，并检查 codexTokenMonitor.codexHome 是否指向正确目录。

更新记录

各版本的功能和修复见 更新日志。