Verboo Code: como ver quanto do seu limite já foi usado com /usage
Voltar para o Blog
Artigoverboo codetutorialhow todev toolsprodutividade

Verboo Code: como ver quanto do seu limite já foi usado com /usage

Mafra16 de novembro de 20266 min de leitura

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.

Fluxograma: /usage abre o painel, cada janela mostra horas e percentual utilizado, e a data de renovação; se aparecer aviso de saldo, conferir /login e a conexão
O caminho do /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 apareceO que significa
24h: 38% utilizadoJanela 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 painelO que está acontecendoO que fazer
Não foi possível consultar o saldo. Tente novamente.A consulta ao servidor falhou ou expirouConfira /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 anterioresNã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 respostaSe 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.

Gostou deste artigo?
Compartilhe conhecimento com sua rede.
// Leia também

Artigos relacionados