Guia de campo do Claude Code em português

Limites do Claude Code: sessão, semanal e o que o /usage mostra

Na assinatura Pro ou Max, o Claude Code não cobra por pedido: ele gasta de uma cota, e a cota tem limites. Saber qual limite você bateu muda o que fazer: num deles, trocar de modelo resolve; nos outros dois, não (p. 58). Abaixo, os três limites, como ler o /usage e o que mais gasta a cota sem você ver.

Os três limites

Limite	O que é	Trocar de modelo resolve?
De sessão	A cota de uso de um período curto do plano	Não
Semanal	A cota da semana do plano	Não
Por modelo	Aviso "You've hit your Opus limit"	Sim: `/model` para outra família

O limite de sessão ou semanal da assinatura vale para todos os modelos: trocar de modelo não devolve acesso (p. 55). Só no limite por modelo, depois do aviso "You've hit your Opus limit", trocar para outra família com /model segue o trabalho (p. 58).

Na página de preços da Anthropic (claude.com/pricing, lida em 18/10/2026), o Max vem em duas faixas, com 5 ou 20 vezes o uso do Pro por sessão de 5 horas, e o Pro dá pelo menos 5 vezes o uso do Free no mesmo período. O uso do Claude Code e o do chat saem da mesma cota.

Como ler o /usage

Dentro da sessão, /usage (também /cost e /stats) junta o custo estimado da sessão, as barras de limite do plano e o que está consumindo; o apêndice B resume: "custo da sessão, limites do plano e quando renovam" (p. 141). Na assinatura, o valor em dólares é só referência; o que conta são as barras (p. 57).

Linha do /usage	Como ler
Usage by model	Entrada, saída, cache read e cache write por modelo. Leitura muito maior que gravação: cache funcionando
Prompt cache (main)	Quanto da entrada veio do cache, as falhas com a causa provável e se o cache está quente agora
Attribution	Parte do uso recente por skill, subagente, plugin e servidor MCP
Behavior flags	Comportamento que passou de 10% do uso, como contexto longo, com uma dica
Loops	As tarefas agendadas e /loop mais pesadas

As teclas d e w alternam entre 24 horas e 7 dias. Um detalhe que engana: o detalhamento vem do histórico desta máquina, então uso em outro computador ou no claude.ai não aparece nele; as barras do plano, sim, porque vêm da conta (p. 57). E a contagem ao lado do spinner (↓ 5.5k tokens) é só a saída do turno atual, sem o contexto que foi junto.

Por que a cota acaba antes do que parece

Cada pedido carrega a janela de contexto inteira (p. 49). Por isso uma sessão aberta há horas consome mais do que a atividade sugere. As causas que o guia lista (p. 58): contexto longo, que vai inteiro em cada pedido e em cada rodada de ferramentas; falhas de cache depois de pausas; tarefas agendadas e check-ins de /goal que disparam com a sessão parada; subagentes e workflows, cada um com requisições próprias; e a própria compactação, que lê tudo o que resume.

Sessão que fica o dia aberta cobra a conversa inteira em cada pergunta. Mudou de assunto: /clear, que não custa nada e não apaga a conversa anterior.
Trocar para um modelo mais barato no meio da tarefa refaz o cache inteiro naquele turno.
/compact numa sessão fria reprocessa todo o histórico: compacte antes de sair, não na volta.
Subagentes e workflows economizam janela, não cota.

Gastar menos, do maior efeito ao menor

Uma sessão por assunto: /clear ao mudar de tarefa.
Pedido específico: arquivo, função e resultado esperado.
Modo plan em tarefa grande; Esc assim que o rumo errar.
Saída volumosa em subagente ou filtrada por hook.
Modelo e esforço do tamanho da tarefa, escolhidos no começo da sessão.
Procedimento longo vira skill em vez de morar no CLAUDE.md.

A lista é a da página 57. A regra do capítulo: rode o /usage e corrija a maior linha antes de mexer na qualidade. Defeito difícil e mudança que vai para produção continuam pedindo esforço alto: corte o gasto em contexto e repetição, não no raciocínio do que importa (p. 58).

Limites do Claude Code: sessão, semanal e o que o /usage mostra

Os três limites

Como ler o /usage

Por que a cota acaba antes do que parece

Gastar menos, do maior efeito ao menor

Leia também