Os limites do Claude Code: a janela de 5 horas, o teto semanal e todos os caminhos depois do muro

Limites são dois relógios girando ao mesmo tempo

O limite de uma assinatura Claude Code não é um número, são dois: uma janela móvel de 5 horas e um teto semanal. A janela começa quando você começa e zera cinco horas depois; o teto semanal atravessa a semana inteira acumulando o que as janelas não perdoam. O pico de terça à tarde não ocupa só a janela de terça — saca do fundo da semana.

Então «acabou de reiniciar, por que estou limitado de novo» quase nunca é bug. Janela de 5 horas cheia é uma sensação; teto semanal no fundo é outra — e no segundo caso, mesmo a janela recém-esvaziada espera a semana virar. O /usage mostra diante de qual relógio você está.

• A janela de 5 horas: móvel, decide se você pode continuar agora.
• O teto semanal: cumulativo, decide quanto de semana ainda resta.
• Medem de forma independente — quem enche primeiro é quem para você.

Por que o Opus sempre queima o teto semanal primeiro

O teto semanal mede uso, e um modelo topo consome várias vezes mais por turno que um leve — contexto maior entrando, conclusões maiores saindo. O mesmo dia pesado de 8 horas drena o fundo semanal várias vezes mais rápido no Opus que no Sonnet. Daí a assimetria famosa: alguns dias de Opus no começo da semana esvaziam o teto mesmo com a quota específica do Sonnet intocada — o fundo é compartilhado, e uma cota dedicada não reabastece o tanque geral.

Não é punição a usuários pesados; é a estrutura de preço fazendo exatamente o que anuncia. Assinatura é seguro de prima fixa e uso tampado — a prima não liga para o modelo, mas o fundo tem chão. Visto assim, «trocar de modelo» e «trocar de cobrança» deixam de ser folclore e viram duas variáveis da mesma aritmética.

O que acontece de verdade no muro

O sintoma na superfície é um 429. Não é um erro, é o protocolo dizendo a verdade: quota gasta, hora de reinício nos cabeçalhos da resposta. A maioria dos clientes repassa essa hora — então a primeira jogada no muro não é trocar de ferramenta, é ler o relógio e decidir como gastar a próxima hora.

Vale dizer sem rodeios: esse muro existe no caminho da assinatura. O caminho por uso não tem janela de 5 horas nem fundo semanal; os limites dele são de outra espécie (vazão por minuto, tetos mensais por nível) que um desenvolvedor sozinho codando praticamente nunca encontra. Isso não torna o por uso melhor — troca o muro por um medidor — mas é a bifurcação onde todas as saídas abaixo se separam.

Cinco saídas, ordenadas por custo

As opções depois do muro sempre estiveram escritas; só estavam espalhadas por documentos diferentes. Reunidas e ordenadas por «tente primeiro o barato»:

1. Esperar o reinício. A janela de 5 horas vira rápido e custa zero. Para o cenário «só mais um empurrão»: estacione a tarefa e finalize quando a janela girar.
2. Compactar o contexto. /compact, ou uma sessão nova. Cada turno reenvia a conversa até ali; cortar o peso morto torna cada turno restante mais barato. Não devolve quota, mas estica a que sobrou.
3. Descer um modelo. Edição batida e grep não precisam do topo; deixar Opus só para as decisões realmente difíceis desacelera na hora a queima semanal. A saída mais subestimada: o modelo padrão da maioria superdimensiona a maioria das tarefas.
4. Subir de plano. Se sua forma é horas por dia concentradas no topo, o fundo maior é realmente mais barato por unidade — é para isso que existem níveis. Use.
5. Mudar para por uso. O muro some e o medidor começa. Serve para uso diverso, ocasional ou espalhado em ferramentas — e para quem bate no muro mais de uma vez por mês, porque tempo bloqueado também é custo.

Que forma de pessoa deve parar onde

As quatro primeiras saídas não precisam deste ensaio; quem bateu no muro uma vez aprende sozinho. O ponto que vale uma conta é entre a quarta e a quinta: subir de plano ou mudar para por uso.

A matéria-prima dessa decisão é a sua forma de uso: horas concentradas por dia, intensidade das tarefas, comportamento do cache. Coloque tudo numa calculadora de custos e sai o ponto de equilíbrio — as horas por dia em que o gasto por uso alcança o preço do plano. Abaixo da linha, por uso é mais barato; acima, o plano ganha e o muro é o prêmio de seguro que você escolheu pagar. Não há resposta universal, só a sua própria multiplicação.

Uma assimetria que vale conhecer: o preço do plano é travado, as tarifas por uso seguem a tabela. Quem escolhe o medidor deveria exigir tabela legível por máquina e extrato por requisição — senão «o medidor está girando» vira baixinho «o medidor está girando numa caixa trancada».