Índice
- 1. O que a mensagem significa — session, weekly, Opus, Sonnet
- 2. O limite em duas camadas — 5 horas + semanal (+ tetos por modelo)
- 3. O que consome a sua cota
- 4. Cinco formas de continuar trabalhando agora
- 5. Como ver quanto resta
- 6. Limites da assinatura vs limites da API
- 7. Checklist de prevenção
- Resumo
- FAQ
Você finalmente pega o ritmo no Claude Code e, de repente, isto te trava na hora:
You've hit your session limit · resets 3:45pmOu seja, você usou, por enquanto, tudo o que o seu plano atual permite. Não é um erro nem um bug: é assim que funcionam os limites de uso das assinaturas (Pro / Max e similares). A referência oficial de erros lista quatro versões, conforme a cota que acabou (os horários são exemplos):
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pmAs versões anteriores diziam Claude usage limit reached. Your limit will reset at 3pm (America/Santiago). (a seção 1 mostra como o texto mudou). O frustrante é que não fica claro qual cota você atingiu, quando ela volta nem o que dá para fazer até lá. Este artigo explica o que significam as quatro mensagens, a estrutura do limite em duas camadas (5 horas + semanal), o que impulsiona o consumo, o que fazer no momento em que você bate no teto, como verificar quanto resta e a saída de emergência pela API — com base na documentação oficial.
Três conclusões logo de cara. (1) session limit é a janela rolante de 5 horas e weekly limit é a janela semanal; as duas valem para todos os modelos, então trocar de modelo não devolve o acesso. (2) Opus limit / Sonnet limit valem só para aquela família de modelos, então trocar com /model para um modelo de outra família deixa você continuar. (3) Se você pode esperar, o Claude Code v2.1.234 ou posterior consegue retomar a tarefa automaticamente depois do reset. Se não pode, passe para os créditos de uso ou para a API por uso. Os valores por plano mudam 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 a mensagem significa — session, weekly, Opus, Sonnet
A mensagem atual tem o formato "You've hit your [X] limit · resets [horário]" ("você atingiu o seu limite de [X] · reseta às [horário]") e nomeia a cota que acabou. Segundo a documentação oficial, o Claude Code bloqueia as próximas requisições até o horário de reset exibido. O horário é o seu horário local, e os relatos no repositório oficial costumam mostrar o fuso horário entre parênteses, como em resets 4:20am (Europe/Rome).
| Mensagem | O que acabou | Trocar de modelo ajuda? | Primeiro passo |
|---|---|---|---|
You've hit your session limit | Janela rolante de 5 horas (comum a todos os modelos) | Não | Esperar o reset (retomada automática) ou usar créditos de uso |
You've hit your weekly limit | Janela semanal (comum a todos os modelos); o reset pode estar a dias | Não | Veja o reset em /usage e escolha: esperar, créditos de uso, API ou upgrade |
You've hit your Opus limit | Um teto só para a família Opus | Sim (para um modelo que não seja Opus) | /model para o Sonnet ou outro modelo |
You've hit your Sonnet limit | Um teto só para a família Sonnet | Sim (para um modelo que não seja Sonnet) | /model para um modelo fora do Sonnet |
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."
Na mesma situação aparecem mais duas linhas. As duas tratam das mesmas cotas que as quatro mensagens acima.
Usage limit reached · continuing automatically at 3:45pm · esc to cancel— o Claude Code está esperando para retomar a tarefa interrompida depois do reset (v2.1.234 ou posterior; veja a seção 4)You've used 85% of your session limit · resets 3:45pm— um aviso antes de a janela acabar
Por outro lado, as mensagens a seguir não significam que a sua cota de 5 horas ou semanal acabou, então a solução é outra.
API Error: Server is temporarily limiting requests (not your usage limit)— uma limitação breve do lado do servidor, sem relação com o seu plano. Espere um pouco e tente de novo (a partir da v2.1.199 ela é repetida automaticamente antes de aparecer)You've hit your monthly spend limit · raise it at claude.ai/settings/usage— os créditos de uso que pagam o que passa do seu plano chegaram a um limite de gasto mensal. Aumente o limite ou espere o reset da janela do plano, se a mensagem indicar um (no Team / Enterprise apareceindividual spend limit,org's monthly spend limitetc.)Usage credits required for 1M context— uma verificação de direito de uso da janela de contexto de 1M de tokens, não uma cota esgotada. Use/modelpara voltar a um modelo sem o sufixo[1m]Request rejected (429)— um limite de taxa de uma chave de API ou de um provedor de nuvem (veja a seção 6)
Como o texto mudou — "Claude usage limit reached" é a redação antiga
Colocando em ordem as mensagens que usuários colaram em relatos de bug no repositório oficial anthropics/claude-code, o texto mudou pelo menos duas vezes. O CHANGELOG tem entradas como "Usage limit notifications now easier to understand" (v2.0.51), mas não registra a troca do texto em si.
| Quando aparece nos relatos | Mensagem |
|---|---|
| 2025 | Claude usage limit reached. Your limit will reset at 3pm (America/Santiago). |
| Dez. 2025 – maio 2026 | You've hit your limit · resets 10am (Europe/Kiev) |
| Maio 2026 – hoje | You've hit your session limit · resets 1pm (Australia/Brisbane) e as demais das quatro variantes da referência oficial |
Muitos relatos de 2025 mostram também uma forma com o horário de reset como timestamp Unix, como Claude AI usage limit reached|1749470400. Se você ainda vê a redação antiga, atualizar com claude update mostra qual cota você atingiu e libera a retomada automática (condições na seção 4).
2. O limite em duas camadas — 5 horas + semanal (+ tetos por modelo)
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 o rodavam sem parar). Como resultado, o limite da assinatura hoje tem dois andares. Segundo a documentação oficial, o uso conta ao mesmo tempo contra a cota da sessão e a semanal, então uma única rajada de atividade pesada, como um grande fluxo de trabalho distribuído em paralelo, pode esgotar a cota semanal antes de a janela da sessão resetar.
A exceção é o Ultra, o plano de US$ 200 (renomeado de Max 20x em 31 de outubro de 2026). Segundo a ajuda da Anthropic "What is the Ultra plan?", contas Ultra verificadas não têm janela de 5 horas: só o limite semanal (10 vezes o do Pro) e o limite semanal do Fable. A Anthropic verifica as contas automaticamente com base no histórico da conta e de pagamentos; até a verificação terminar, vale um limite temporário de 5 horas. Se em Settings → Usage não aparece a barra "Current session", a conta está verificada e o aviso session limit não aparece. O Max de US$ 100 tem 5 vezes a cota do Pro tanto na janela de 5 horas quanto na semanal (veja "What is the Max plan?"; ambas conferidas em 31 de outubro).
As duas janelas agem de forma independente
resets Mon 12:00am, e o reset pode estar a dias. Veja o próximo reset em Settings → Usage ou em /usage./usage). Quando um acaba, a mensagem nomeia a família, como em You've hit your Opus limit, e só nesse teto trocar com /model para um modelo de outra família deixa você continuar.
Os planos diferem por um "multiplicador" sobre a mesma estrutura: Pro < Max (5 vezes) < Ultra (10 vezes por semana; sem janela de 5 horas se verificada).
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 (hoje Ultra): ~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." Algumas contas têm ainda tetos semanais separados para as famílias Opus e Sonnet | 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 "qual cota você atingiu?" (session / weekly / Opus / Sonnet na mensagem) e de "você pode esperar?". Digitar /rate-limit-options no Claude Code mostra as opções em um só menu: esperar e continuar automaticamente, adicionar créditos de uso ou fazer upgrade do plano (ele não aparece no menu de comandos, então digite por inteiro).
Quando você bate no teto
Opus limit / Sonnet limit. /model para um modelo de outra família. Os limites de sessão e semanal valem para todos os modelos, então ali não ajuda./compact / /clear para gastar menos por turno e fazer a próxima janela durar mais.resets. A partir da v2.1.234, uma sessão aberta retoma a tarefa sozinha./usage-credits, ou suba de plano com /upgrade.Limite de sessão? C. Não pode esperar? D / E.
Os limites de sessão e semanal valem para todos os modelos — trocar de modelo não os devolve. A janela da sessão volta em horas, então C; quando a semanal acaba, D ou E é a resposta realista. B serve para a próxima janela durar mais.
A opção C (esperar) ficou quase automática na v2.1.234. Em uma sessão interativa conectada com uma assinatura do claude.ai, quando um limite de uso interrompe o Claude no meio da tarefa, o Claude Code espera na sessão aberta e continua a tarefa depois do reset. Enquanto espera, uma linha na parte de baixo da sessão mostra:
Usage limit reached · continuing automatically at 3:45pm · esc to cancelNo reset, ele não reenvia a sua última mensagem; envia ao Claude uma instrução fixa para retomar a tarefa de onde parou. Os pedidos de permissão continuam aparecendo normalmente, então a tarefa pode parar em um deles enquanto você está fora. Para cancelar uma espera, pressione Esc com o prompt vazio; para desligar de vez a continuação automática, desative Continue automatically at usage limit em /config. O Claude Code não inicia a espera sozinho quando o reset está a mais de 24 horas (um limite semanal, por exemplo), então abra /rate-limit-options e escolha Wait here, then continue automatically. Na aba Code do app desktop, o cartão do limite de sessão tem a caixa Auto-continue when limits reset (o do limite semanal não tem).
Conhecer a troca para API (D) como uma "saída de emergência" é poderoso. Diferente das janelas de tempo da assinatura, a API não tem reset de 5 horas nem semanal para esperar (você paga pelo que usa; ela tem limites de throughput por minuto e um teto de gasto mensal — veja a seção 6). Veja O que é uma API de IA. No Pro / Max, ativar os créditos de uso com /usage-credits (antes /extra-usage) permite seguir além da cota incluída a preços padrão da API (ajuda oficial). No Team / Enterprise, o mesmo comando envia um pedido ao seu administrador.
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 quanto você usou de cada cota do plano e quando cada uma reseta (/cost e /stats são aliases). No Pro, Max, Team e Enterprise ele também mostra um detalhamento por skill / subagente / plugin / servidor MCP (pressione d / w para alternar entre as últimas 24 horas e 7 dias; o detalhamento é calculado a partir do histórico desta máquina, então o uso em outros dispositivos ou no claude.ai não entra). Ele não mostra, porém, qual sessão consumiu (como ver o uso por sessão). Antes de uma janela acabar, pode aparecer um aviso como You've used 85% of your session limit · resets 3:45pm, e você pode manter rate_limits (percentual de uso e horário de reset das janelas de 5 horas e 7 dias) na sua linha de status. 2) App web/desktop: Settings → Usage mostra o seu plano, o uso restante e a data de reset semanal; no app desktop, o anel de uso ao lado do seletor de modelo também mostra. 3) Usuários de API: as páginas Usage / Limits do Console e os cabeçalhos de resposta anthropic-ratelimit-*. O bloco Session do /usage mostra um custo estimado calculado a partir dos tokens. Note que o /status não mostra a sua cota; ele mostra com qual conta e credencial você está conectado (veja a seção 6).
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, mais tetos por família) | Throughput por minuto (RPM / tokens de entrada + saída por minuto) e um teto de gasto mensal por nível de uso |
| O que você vê | You've hit your session limit · resets 3:45pm e similares | Request rejected (429) e similares |
| Ao atingir o limite | Bloqueado até o reset (dá para continuar com créditos de uso) | Acima do throughput você recebe 429; espere os segundos do retry-after e continue. No teto de gasto mensal, o uso pausa até 00:00 UTC do dia 1 do mês seguinte |
| Como elevar | Upgrade de plano, créditos de uso | A sua organização sobe de nível de uso (Start, Build, Scale etc.) automaticamente conforme o histórico; também dá para pedir limites maiores |
| Melhor para | Chat pessoal, coding do dia a dia | Automação que você não pode parar, grandes lotes |
O ponto: a assinatura te para por janela de tempo, enquanto a API não tem janela de 5 horas nem semanal. Por isso, para trabalho com prazo que você realmente não pode parar, trocar para uma chave de API é o movimento padrão. Depois de trocar, rode /status para confirmar a credencial ativa. Uma ANTHROPIC_API_KEY aprovada que tenha ficado no seu ambiente faz as requisições passarem por essa chave mesmo quando você queria usar a assinatura. Ao contrário, se aparecer Credit balance is too low quando você acha que está na assinatura, é sinal de que uma chave de API do Console está em uso. Como resolver está em Your credit balance is too low to access the Anthropic API: solução. Para detalhes da API, veja a página oficial de limites de taxa.
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 You've hit your session limit · resets 3:45pm do Claude Code (a redação antiga era Claude usage limit reached) não é um erro — é assim que funcionam os limites de uso da assinatura. A mensagem nomeia a cota que acabou: session = a janela rolante de 5 horas, weekly = a janela semanal (as duas valem para todos os modelos, então trocar de modelo não ajuda) e Opus / Sonnet = um teto só daquela família. Como o Claude Code e os apps do Claude compartilham a mesma cota do plano, juntos eles podem acabar mais rápido.
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: com teto de Opus/Sonnet, A: troque de modelo; com limite de sessão, C: espere o reset (automático a partir da v2.1.234); se não puder esperar, D: API por uso / E: créditos de uso ou upgrade. B: enxugar o contexto faz a próxima janela durar mais. Veja o seu saldo com /usage e Settings → Usage. E como os números exatos são revisados com o 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. "You've hit your session limit" é um bug? Estou pagando por isso.
A. É por design, não um bug. O Pro / Max e as outras assinaturas não são "ilimitados" — há tetos de uso por janela de 5 horas (session) e por semana (weekly). Mesmo pagando, quando você passa do que aquela cota cobre, fica pausado temporariamente, e o acesso volta no horário de resets exibido. Note que o Claude Code e os apps do Claude compartilham a mesma cota, então usar os dois a esgota mais rápido.
Q. Quando reseta? Apareceu "resets 3:45pm".
A. Com um session limit, esse é o horário de reset da janela de 5 horas (seu horário local). Um weekly limit traz um dia ou data, como em resets Mon 12:00am, e pode estar a dias. Você pode ver cada reset em /usage ou em Settings → Usage. Se até a cota semanal acabou, as opções são esperar, usar créditos de uso, migrar para a API por uso ou fazer upgrade.
Q. O que muda em "Claude usage limit reached"?
A. É a redação antiga do mesmo limite de uso. Nos relatos do repositório oficial, 2025 mostra Claude usage limit reached. Your limit will reset at …, a partir de dezembro de 2025, mais ou menos, You've hit your limit · resets …, e a partir de maio de 2026, mais ou menos, a mensagem que nomeia a cota, You've hit your session limit, e suas variantes. Se você ainda vê a redação antiga, atualizar com claude update mostra qual cota você atingiu e libera a retomada automática a partir da v2.1.234.
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. Além disso, contexto grande, execuções longas e contínuas e uso pesado de subagentes ou MCP aumentam o consumo. O uso conta ao mesmo tempo contra a cota da sessão e a semanal, então trabalho pesado e contínuo, como execuções em paralelo, também pode esgotar cedo a cota semanal. 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) Com You've hit your Opus limit / Sonnet limit, troque para um modelo de outra família com /model (não ajuda com os limites de sessão e semanal), (2) ative os créditos de uso com /usage-credits (continue além da cota incluída a preços padrão da API), (3) mude para uma chave de API pay-as-you-go (sem janela de 5 horas nem semanal), (4) faça upgrade do plano com /upgrade. Para trabalho com prazo, deixar a API por uso pronta com antecedência é a jogada segura.
Q. Consigo ver quanto me resta?
A. Sim. No Claude Code, o /usage mostra quanto você usou de cada cota, quando cada uma reseta e um detalhamento por skill, subagente e servidor MCP; colocar rate_limits na linha de status deixa isso sempre à vista. No app web/desktop, Settings → Usage mostra o seu plano, o uso restante e a data de reset semanal. Conferir uma vez antes de trabalho pesado permite evitar bater no teto.
