Você está no meio de um refactor grande e quer saber se ainda cabe. Abre o terminal, digita /usage e o painel aparece. O problema é que ele mostra várias linhas parecidas, com horas, percentual e uma data de renovação, e quase ninguém sabe qual delas manda na hora de decidir se começa o trabalho agora ou espera a janela virar.
Este artigo mostra o que o /usage lê, o que cada linha significa, por que o número dele não bate com o do /cost e por que o comando não imprime nada quando você roda a CLI em modo headless.
O que o comando /usage faz?
Abre o painel de configurações na aba Usage e mostra o consumo do plano, uma linha por janela de limite. Ele não mede a sessão atual: consulta o servidor e devolve o percentual já gasto em cada janela, com a duração da janela em horas e o horário em que ela renova.
/usage: abrir, ler a janela e ver quando ela zera.Como abrir o painel e ler cada linha?
Digite o comando dentro de uma sessão normal da CLI. Se você tem várias janelas de limite, a saída se repete em blocos, um por grupo.
/usage
A saída tem este formato, com os números vindos da sua conta:
Pro
24h: 38% utilizado
Renova em 16/11/2026, 09:00:00
168h: 12% utilizado
Renova em 21/11/2026, 14:30:00
Cada par de linhas é uma janela: a primeira traz duração em horas e percentual consumido, a segunda traz quando aquela janela zera. O painel reconsulta sozinho a cada 10 segundos enquanto fica aberto, então dá para deixar aberto num painel do tmux e acompanhar durante a tarefa.
| O que aparece | O que significa |
|---|---|
24h: 38% utilizado | Janela de 24 horas, 38% do limite daquela janela já gasto |
Renova em ... | Data e hora locais em que o percentual volta a zero |
A janela começa no próximo uso. | Não há renovação agendada: a contagem começa quando você voltar a usar |
Sem limite de janela. | O grupo aparece, mas não tem limite por janela |
Para fechar, Esc. Não existe flag: o comando não aceita /usage --json nem argumento de janela. Se você quer só o painel, é isso.
Por que o /usage e o /cost dão números diferentes?
Porque medem coisas diferentes. O /cost soma o que a sessão atual consumiu, com custo, duração de API, duração de parede e tokens por modelo. O /usage mostra o que o plano já gastou na janela, incluindo tudo que você rodou em outras sessões, em outros projetos e em outra máquina.
Na prática: sessão nova com /cost zerado pode conviver com /usage em 80%. Se a pergunta é "cabe mais trabalho agora?", olhe o /usage. Se a pergunta é "o que essa tarefa custou?", olhe o /cost. O tutorial do /cost está em como ver a duração e o custo da sessão com /cost.
O que cada aviso do painel significa?
O painel troca a linha de status quando o estado não é o normal. São quatro mensagens, e cada uma pede uma ação diferente.
| Mensagem no painel | O que está acontecendo | O que fazer |
|---|---|---|
Não foi possível consultar o saldo. Tente novamente. | A consulta ao servidor falhou ou expirou | Confira /login e a conexão, saia com Esc e abra de novo |
Uso pausado até a confirmação das solicitações anteriores. | A conta está aguardando o fechamento de requisições anteriores | Não é limite atingido: espere a contabilização fechar e reabra o painel |
Limite de uso atingido. Aguarde a renovação. | O percentual da janela chegou a 100% | Veja a data de renovação daquela janela antes de insistir |
Carregando consumo… | Ainda esperando a primeira resposta | Se ficar parado, é o caso da primeira linha |
A armadilha do headless. O /usage é um comando que abre interface, não um comando de texto. Rodando a CLI em modo headless, o comando existe, mas não imprime nada: o painel nunca é desenhado e a saída fica vazia. Se você precisa do número dentro de um script ou de um agente, o caminho é consultar o dado pela API, não chamar /usage e ler o stdout.
De onde vem o número?
Da rota /api/me/usage-windows, autenticada com o token da sua sessão. A consulta tem timeout de 10 segundos por tentativa, tenta até três vezes e respeita Retry-After em respostas 408, 429, 500, 502, 503 e 504, com prazo total de 35 segundos. É por isso que o painel às vezes demora alguns segundos para sair de Carregando consumo… em vez de falhar na primeira tentativa.
Se a sua conta está no período de tokens grátis, o painel acrescenta um bloco extra: quantos tokens grátis restam, quantos foram consumidos do total (entrada mais saída, sem prazo de validade) e um aviso quando há solicitações aguardando confirmação. Quando esse bloco não aparece, o painel mostra o endereço do dashboard para consulta detalhada.
Dá para ver o uso por modelo aqui?
Não. O /usage é por janela, não por modelo. Para saber quais modelos puxaram o consumo da sessão, use o /cost, que traz a quebra de tokens e cache por modelo. Para saber o que está ocupando o contexto, use o /context. São três perguntas diferentes e três painéis diferentes.
Perguntas rápidas
O /usage conta o que eu rodei em outra máquina? Conta. O percentual é do plano, não da máquina, então sessões em outra VPS ou em outro projeto entram na mesma janela.
Preciso reiniciar a CLI para o número atualizar? Não. O painel reconsulta a cada 10 segundos enquanto está aberto.
O percentual volta a zero quando eu fecho o terminal? Não. A janela é do servidor e renova na data que o painel mostra.
Antes de começar o próximo refactor, abre a CLI, roda /usage e olha a janela mais curta. Se ela estiver perto do topo, a decisão fica óbvia em cinco segundos. Se você ainda não usa a Verboo Code, dá para começar por verboo.ai e rodar o mesmo comando no primeiro dia.



