Índice
Você finalmente engrena no Claude Code e, de repente, isto te trava por completo:
Claude usage limit reached.
Your limit will reset at 3pm (America/Sao_Paulo)."Você esgotou, por enquanto, o que o seu plano atual permite." Não é um erro nem um bug: é assim que funcionam os limites de uso da assinatura Pro / Max. O frustrante é que não fica óbvio por que acabou tão rápido, quando volta ou o que dá para fazer até lá. Este artigo destrincha a estrutura do limite em duas camadas (5 horas + semanal), o que puxa o consumo, o que fazer no instante em que você bate no teto, como verificar quanto resta e a saída de emergência via API — com base em informações oficiais.
Três conclusões logo de cara. (1) O limite tem duas camadas: uma "janela rolante de 5 horas" e uma "janela semanal" (o Max também tem um teto semanal separado só para o Opus). (2) O maior consumidor é a sua escolha de modelo — o Opus queima a cota muito mais rápido do que o Sonnet. (3) Quando você não pode esperar, os movimentos limpos são "baixar para o Sonnet / enxugar o contexto / migrar para a API por uso (pay-as-you-go)." Note que o horário exibido e os valores por plano mudam conforme a versão e ao longo do tempo, então confirme sempre os números na visão oficial ao vivo (/usage ou Settings → Usage).
O limite de uso tem dois andares
— bater em apenas um deles já te trava
O Claude Code e os apps Claude (web/desktop) compartilham a mesma cota do plano.
Os números dos medidores são ilustrativos. Verifique o seu saldo real com /usage e em Settings → Usage.
1. O que essa mensagem está dizendo
Uma mensagem típica é assim (o texto varia por versão, então trate-a como um molde): "Claude usage limit reached. Your limit will reset at [horário] ([fuso horário])." O significado é simples: "Você esgotou o que o seu plano permite neste período. Ele se recupera às [horário]." O fuso horário é a sua configuração local.
O ponto-chave é que isso é por design, não um defeito. Os planos Pro / Max do Claude não são "ilimitados" — há um teto de uso por janela de tempo e por semana. E o Claude Code (CLI) e os apps Claude (web/desktop) compartilham a mesma cota do plano — a ajuda oficial afirma que "toda atividade nas duas ferramentas conta no mesmo limite de uso." Então é perfeitamente normal que "usei o chat E rodei o Claude Code, e juntos esgotaram mais rápido."
Mais uma coisa para saber: há dois tipos de teto — "5 horas" e "semanal." Se o reset at exibido estiver a poucas horas de distância, você bateu na janela de 5 horas; se estiver a dias de distância, você bateu na janela semanal. Qual delas você atinge muda tanto a sua espera quanto as suas opções. A próxima seção cobre a estrutura.
2. O limite em duas camadas — 5 horas + semanal (+ teto de Opus)
Em agosto de 2025, a Anthropic adicionou limites de uso semanais ao Pro / Max, além da janela de 5 horas já existente (motivada por usuários intensivos que rodavam a ferramenta de forma contínua). Como resultado, o limite de assinatura de hoje tem dois andares.
As duas janelas agem de forma independente
Os planos diferem por um "multiplicador" sobre a mesma estrutura: Pro < Max 5x < Max 20x.
As horas semanais exatas são revisadas ao longo do tempo. Não decore números fixos — leia os valores ao vivo em Settings → Usage.
Como guia original (agosto de 2025), a Anthropic deu estimativas aproximadas como "Pro: ~40-80 horas de Sonnet por semana" e "Max 20x: ~240-480 horas de Sonnet + ~24-40 horas de Opus por semana." No entanto, desde então a Anthropic em grande parte parou de publicar números fixos de horas, e os limites foram revisados repetidamente (mesmo em 2026, foram relatados aumentos na janela de 5 horas). Então trate aqueles números como "estimativas daquela época," e confirme sempre a sua cota atual na visão oficial de uso. Este artigo deliberadamente evita afirmar valores atuais específicos.
3. O que consome a sua cota
"Acabou mais rápido do que eu esperava" quase sempre se resume a estes quatro, ordenados por impacto.
| Fator | Por que consome a cota | O que ajuda |
|---|---|---|
| 1) Escolha de modelo (o maior) | O Opus consome muito mais do que Sonnet/Haiku. A documentação diz claramente que o Opus "usa significativamente mais cota." No Max ele ainda tem o próprio teto semanal | Use /model para rodar trabalho rotineiro no Sonnet/Haiku; reserve o Opus para problemas difíceis |
| 2) Tamanho do contexto | Cada turno reprocessa toda a conversa + arquivos anexados + definições de ferramentas + histórico. Quanto maior, mais por turno | /compact, /clear, anexar menos arquivos, CLAUDE.md menor |
| 3) Sessões longas e contínuas | Sempre ligado, loops sem fim. O teto semanal mira especificamente esse padrão | Divida o trabalho com /clear; pare loops automáticos desnecessários |
| 4) Subagentes / MCP | Disparo paralelo (fan-out) e servidores MCP adicionam definições de ferramentas e tráfego de chamadas de ferramentas | Reduza os servidores MCP ativos. O /usage mostra um detalhamento por MCP/subagente |
Em resumo, quanto mais pesado o modelo, maior o contexto, mais longa e paralela a execução, mais rápido a cota derrete. Por outro lado, baixar deliberadamente esses quatro faz o mesmo plano durar visivelmente mais. Para a otimização geral, veja otimização de custos de coding com IA, e para táticas concretas de economia de tokens, veja economia de tokens no Claude Code.
4. Cinco formas de continuar trabalhando agora
Cinco movimentos para o momento em que você bate no teto, por situação. Qual escolher depende de "você pode esperar?" e "qual janela você atingiu?"
Quando você bate no teto
/model para Sonnet/Haiku. Se só o teto de Opus se esgotou, isso costuma permitir continuar imediatamente./compact / /clear para gastar menos por turno e esticar o pouco que resta.reset at e faça outro trabalho enquanto isso.Com prazo apertado? D.
Uma janela de 5 horas volta se você esperar, então aguente com A/B/C. Se o teto semanal também acabou, D (API) ou E é a resposta realista.
Conhecer a troca para API (D) como uma "saída de emergência" é poderoso. Diferente do bloqueio por janela de tempo da assinatura, a API tem limites de throughput por minuto, mas nunca "te bloqueia por uma semana" (você paga pelo que usa). Veja O que é uma API de IA. Note que usuários Pro / Max também podem habilitar "créditos de uso" para seguir além da cota incluída a preços padrão da API (consentimento explícito necessário).
5. Como ver quanto resta
Se você consegue ver "quanto resta", dá para evitar bater no teto por completo. Três formas de verificar.
1) O /usage do Claude Code: mostra o consumo atual da janela de 5 horas e o status da janela semanal por modelo. Uma atualização de 2026 adicionou um detalhamento por skill / subagente / plugin / servidor MCP. O /status também expõe a sua alocação. 2) App web/desktop: Settings → Usage mostra o seu plano, o uso restante e a data de reset semanal. 3) Usuários de API: as páginas Usage / Limits do Console e os cabeçalhos de resposta anthropic-ratelimit-*. O /cost (para usuários com chave de API) e o /context acompanham o gasto e o tamanho do contexto.
Um hábito que compensa
Rode /usage uma vez antes de trabalho pesado para saber o seu saldo e a data de reset. Numa semana em que o seu teto semanal estiver baixo, monte tudo em torno do Sonnet desde o início para guardar folga de Opus para quando importar.
6. Limites da assinatura vs limites da API
É fácil confundir, mas os limites da assinatura (Pro/Max) e os limites da API são sistemas inteiramente diferentes. Conhecer a diferença torna a decisão de migrar rápida na hora que conta.
| Aspecto | Assinatura (Pro / Max) | API (pay-as-you-go) |
|---|---|---|
| Unidade do limite | Total por janela de tempo (5 horas + semanal) | Throughput por minuto (RPM / tokens de entrada + saída por minuto) |
| Ao atingir o limite | Bloqueado até o reset | Retorna 429; espere os segundos do retry-after e continue (sem bloqueio semanal) |
| Como elevar | Fazer upgrade de plano, comprar créditos | Tiers 1-4 são liberados automaticamente pelo gasto acumulado |
| Melhor para | Chat pessoal, coding do dia a dia | Automação que você não pode parar, grandes lotes |
O ponto: a assinatura te bloqueia por tempo, enquanto a API só limita o fluxo por minuto e não tem bloqueio semanal. Então, para trabalho com prazo que você realmente não pode parar, migrar para uma chave de API é o movimento padrão. Os detalhes de rate-limit da API (429, retry-after, tiers) merecem um texto próprio, mas tenha isto em mente como a saída de emergência realista quando a assinatura seca.
7. Checklist de prevenção
Um checklist operacional para acabar com o "esgotar quando importa".
(1) Use o Sonnet por padrão e troque para o Opus com /model apenas nas partes difíceis (preserve o teto semanal de Opus). (2) Mantenha o contexto leve com /compact / /clear frequentes. (3) Verifique o seu saldo e a data de reset com /usage antes de trabalho pesado. (4) Reduza MCP e loops automáticos desnecessários; anexe só os arquivos de que você precisa. (5) Em dias de prazo, tenha a API pay-as-you-go pronta (para não travar quando a assinatura acabar). (6) Se você está cronicamente sem cota, considere fazer upgrade do plano ou mover essa carga de trabalho para a API.
Resumo
O "Claude usage limit reached" do Claude Code não é um erro — é assim que funcionam os limites de uso da assinatura Pro/Max. O limite tem dois andares: uma "janela rolante de 5 horas" + uma "janela semanal," e o Max também tem um teto semanal separado para o Opus. Como o Claude Code e os apps Claude compartilham a mesma cota do plano, eles podem esgotar mais rápido juntos. Se o reset at estiver a horas de distância, é a janela de 5 horas; a dias de distância, é a janela semanal.
O maior consumidor é a escolha de modelo (o Opus é o maior), depois o tamanho do contexto, execuções longas e contínuas, e subagentes/MCP. Ao bater no teto: A: baixe o modelo -> B: enxugue o contexto -> C: espere o reset, e se você não pode esperar, D: migre para a API pay-as-you-go / E: mais cota ou upgrade. Veja o seu saldo com /usage e em Settings -> Usage. E como os números exatos são revisados ao longo do tempo, não os decore — confirme na visão oficial ao vivo. Relacionados: economia de tokens e custos extras, preços de Opus/Sonnet/Haiku, compilado de erros do Claude Code.
FAQ
Q. "usage limit reached" é um bug? Eu estou pagando por isso.
A. É por design, não um bug. Pro / Max não são "ilimitados" — há tetos de uso por janela de 5 horas e por semana. Mesmo como usuário pagante, depois que você excede o que aquela janela permite, fica pausado temporariamente; ele se recupera no horário do reset at exibido. Note que o Claude Code e os apps Claude compartilham a mesma cota, então usar os dois a esgota mais rápido.
Q. Quando reseta? Apareceu "reset at 3pm".
A. Esse é o horário de reset da janela de 5 horas (no seu horário local); algumas horas e ela se recupera. Se, em vez disso, aparecer "a dias de distância," você bateu na janela semanal, e você encontra a próxima data de reset semanal em Settings → Usage. Se até o teto semanal acabou, suas opções são esperar, migrar para a API pay-as-you-go ou fazer upgrade.
Q. Por que eu atinjo o limite tão rápido?
A. O maior fator é a escolha de modelo. O Opus queima a cota muito mais rápido do que o Sonnet, e no Max ele tem um teto semanal separado que esvazia primeiro. Além disso, contexto grande, execuções longas e contínuas, e uso intenso de subagentes ou MCP empurram o consumo para cima. Só baixar o trabalho rotineiro para o Sonnet com /model e enxugar o contexto com /compact já faz uma grande diferença.
Q. Como continuo agora mesmo sem esperar?
A. (1) /model para baixar para Sonnet/Haiku (funciona quando só o teto de Opus se esgotou), (2) migre para uma chave de API pay-as-you-go (sem bloqueio semanal), (3) habilite créditos de uso (continue além da cota incluída a preços padrão da API), (4) faça upgrade do seu plano (Pro para Max). Para trabalho com prazo, ter a API pay-as-you-go pronta de antemão é a jogada segura.
Q. Dá para verificar quanto resta?
A. Sim. No Claude Code, use /usage (mostra as janelas de 5 horas e semanal por modelo, além de um detalhamento por MCP/subagente) e /status. No app web/desktop, Settings → Usage mostra o seu plano, o uso restante e a data de reset semanal. Verificar uma vez antes de trabalho pesado permite evitar bater no teto.
