你正做到一半的大重构,想先确认还有没有余量。打开终端,输入 /usage,面板出现了。问题是它给出好几行很像的内容,带小时数、百分比和重置日期,很少有人能说清到底哪一行决定现在开工还是等窗口刷新。
本文讲清 /usage 到底读的是什么、每一行是什么意思、为什么它的数字和 /cost 对不上,以及为什么以 headless 方式运行 CLI 时这个命令什么都不打印。
/usage 命令做什么?
它打开设置面板的 Usage 标签页,按每个限额窗口一行展示套餐用量。它不统计当前会话,而是向服务器查询,返回每个窗口已经用掉的百分比、窗口时长(小时)以及该窗口重置的时间。
/usage 的路径:打开、读窗口、确认何时归零。如何打开面板并读懂每一行?
在正常的 CLI 会话中输入命令。如果存在多个限额窗口,输出会按分组重复成多个区块。
/usage
输出形如下面这段,数字来自你自己的账户:
Pro
24h: 38% utilizado
Renova em 16/11/2026, 09:00:00
168h: 12% utilizado
Renova em 21/11/2026, 14:30:00
每两行是一个窗口:第一行给出小时数和已用百分比,第二行给出该窗口归零的时间。面板打开期间每 10 秒自动重新查询一次,所以可以把它放在 tmux 的一个窗格里,任务进行中随时瞄一眼。
需要注意:当前版本里这个面板的文案是写死的葡萄牙语,不随终端语言变化。所以在中文环境下同样会看到 utilizado 和 Renova em。真正要读的是后面的数值。
| 看到的内容 | 含义 |
|---|---|
24h: 38% utilizado | 24 小时窗口,该窗口限额已用 38% |
Renova em ... | 本地时间下百分比回到零的时刻 |
A janela começa no próximo uso. | 没有排定重置:下次使用时才开始计时 |
Sem limite de janela. | 该分组会显示,但没有按窗口的限额 |
按 Esc 关闭。它没有参数:命令不接受 /usage --json,也没有窗口参数。想要面板,只有这一种方式。
为什么 /usage 和 /cost 的数字不同?
因为它们量的不是同一件事。/cost 统计当前会话消耗了什么,包含费用、API 时长、实际时长以及按模型的 token。/usage 显示套餐在当前窗口已经花掉的部分,包括你在其他会话、其他项目、另一台机器上跑的所有内容。
实际表现:新建会话里 /cost 是零,而 /usage 可能已经 80%。如果你的问题是“现在还能不能再塞一点工作”,看 /usage;如果是“这次任务花了多少”,看 /cost。/cost 的教程见 如何用 /cost 查看会话时长与费用。
面板里的每种提示是什么意思?
当状态不正常时,面板会替换状态行。一共有四种提示,每种对应不同的处理方式。
| 面板提示 | 发生了什么 | 怎么处理 |
|---|---|---|
Não foi possível consultar o saldo. Tente novamente. | 服务器查询失败或超时 | 检查 /login 和网络,按 Esc 退出后重新打开 |
Uso pausado até a confirmação das solicitações anteriores. | 账户在等待此前请求完成结算 | 这不是限额用尽:等结算完成后再打开面板 |
Limite de uso atingido. Aguarde a renovação. | 该窗口百分比达到 100% | 先看该窗口的重置时间,再决定是否继续 |
Carregando consumo… | 还在等第一次响应 | 如果一直停在这里,就是第一种情况 |
和示例输出一样,这些提示是葡萄牙语原文。保留原文是为了让你在终端里能直接对上,右侧一列就是判断依据。
headless 模式的坑。/usage 是一个打开界面的命令,不是文本命令。以 headless 方式运行 CLI 时,命令存在,但什么都不会打印:面板永远不会被绘制,输出是空的。如果需要在脚本或代理中拿到这个数,请直接查询 API,而不是调用 /usage 再读 stdout。
这个数字从哪来?
来自 /api/me/usage-windows 接口,用你当前会话的 token 认证。每次尝试 10 秒超时,最多重试三次,遇到 408、429、500、502、503、504 时会遵循 Retry-After,总时限 35 秒。这就是为什么面板有时会在 Carregando consumo… 停几秒,而不是第一次失败就报错。
如果你的账户处于免费 token 期间,面板会额外显示一个区块:还剩多少免费 token、已从总量中消耗多少(输入加输出,没有有效期),以及在仍有请求等待确认时的提示。没有这个区块时,面板会指向 dashboard 查看明细。
这里能看到按模型的用量吗?
不能。/usage 是按窗口统计,不按模型。想看哪些模型拉高了会话消耗,用 /cost,它给出按模型的 token 和缓存拆分。想看什么占满了上下文,用 /context。
快速问答
/usage 会算我在另一台机器上跑的吗? 会。百分比属于套餐,不属于机器,另一台 VPS 或另一个项目的会话都进同一个窗口。
需要重启 CLI 才会更新吗? 不需要。面板打开期间每 10 秒重新查询。
关掉终端后百分比会归零吗? 不会。窗口在服务器上,按面板显示的时间重置。
下次开始重构之前,打开 CLI,运行 /usage,看最短的那个窗口。如果已经接近顶部,五秒就能做出决定。如果你还没在用 Verboo Code,可以从 verboo.ai 开始,第一天就运行同一个命令。



