Limites de uso do Claude Code explicados: sessões, semanas e soluções
O que a janela de sessão de 5 horas e o limite semanal realmente medem, de onde vem o “Limit reached ∙ resets” e as soluções que mantêm você programando quando qualquer um dos relógios se esgota.
Resumão
- Pro e Max medem o Claude Code de dois jeitos ao mesmo tempo: um limite de sessão numa janela rolante de 5 horas e, por cima, um limite semanal — ambos compartilhados com seus chats do claude.ai.
- Nada é contado em mensagens. Conversas mais longas, arquivos anexados, o modelo escolhido e seu nível de effort movem o ponteiro mais rápido.
- Rode /status para o uso restante e /context para ver o que uma sessão novinha já custa antes de você digitar uma palavra.
- Quando o muro chegar: leia o horário de reinício, enxugue servidores MCP e skills, baixe o effort, use /compact ou /clear, ou recorra a usage credits — ou a um endpoint de API mais barato.
Claude Usage Limits Explained — Why You Hit Them So Fast
Canal: Couture Code1:40
Stop Hitting Claude Code Usage Limits
Canal: AI RoundTable17:24
DeepSeek v4 Pro on Claude Code - Full Setup Tutorial
Canal: Prince does AI8:08
How do usage and length limits work? — official support article
Página oficial: support.claude.com
Manage costs effectively — official documentation
Página oficial: code.claude.com/docs
Os fatos desta página foram conferidos com o artigo de suporte da Anthropic e a documentação do Claude Code; quando um vídeo e uma página oficial divergem, vale a página oficial. Os números do limite semanal mudam com o tempo — o artigo de suporte linkado acima traz sempre os valores atuais.
As capturas de tela são frames dos vídeos do YouTube acima, usados com atribuição e linkados ao timestamp original em cada passo.
Limites de uso do Claude Code, passo a passo
O que o limite de sessão realmente mede
- 1
Aceite que não existe número fixo de mensagens
Claude Pro e Max não prometem “N mensagens por dia”. Seu plano compra um orçamento de uso gasto turno a turno, e ele escoa num ritmo diferente a cada dia. As páginas de suporte da Anthropic e os canais da comunidade concordam: quanto tempo o orçamento dura depende do que você envia, não de um contador. Quando isso enfia na cabeça, todas as outras soluções desta página se encaixam sozinhas.
O limite é real — mas não há cota universal de mensagens.Ver em 0:01 - 2
Veja o que move o ponteiro
Cinco fatores decidem a velocidade com que uma sessão queima orçamento: o tamanho de cada mensagem, os arquivos que você anexa, quão longa a conversa ficou, qual modelo e recursos você usa e o nível de effort escolhido. Chats longos com arquivos grandes no modelo mais pesado e effort alto podem esvaziar uma janela em poucos turnos; prompts curtos e focados num modelo leve mal mexem o ponteiro.
Tamanho de mensagem, arquivos e conversa alimentam o mesmo anel de orçamento.Ver em 0:17 - 3
Conheça os dois relógios: 5 horas e 7 dias
A documentação oficial descreve uma cota que se reinicia numa janela rolante de cinco horas e numa janela semanal. O relógio de sessão começa com sua primeira mensagem e se restaura por inteiro cinco horas depois; o teto semanal acumula entre sessões e reinicia uma vez por semana. Bater em qualquer um dos dois pausa o Claude Code até aquela janela se renovar.
Uma barra de 5 horas quase gasta sobre uma barra semanal pela metade.Ver em 0:30 - 4
Diferencie muro de uso de contexto cheio
Limite de uso e limite de contexto são tetos diferentes. Uso é o orçamento do seu plano: se repõe pelo relógio. Contexto é a janela do modelo: só esvazia com /compact ou /clear. Por isso uma sessão pode morrer com o contexto cheio enquanto sobra uso — ou bater no muro de uso com folga na janela. A solução é outra em cada caso.
Uso restante no plano vs. chat cheio na janela.Ver em 1:16
O limite semanal e o ritmo de reinício
- 5
Lembre: toda superfície bebe do mesmo poço
Seu limite de uso é compartilhado entre claude.ai, o app desktop e o Claude Code. Uma tarde longa de chat na web encolhe em silêncio o orçamento que sua sessão de código noturna herda — e vice-versa. Se os limites chegam mais cedo do que o esperado, olhe primeiro o que você fez fora do terminal.
Web, desktop e Claude Code ligados ao mesmo anel compartilhado.Ver em 0:44 - 6
Descubra seu horário atribuído de reinício semanal
O limite semanal não reinicia para todo mundo à meia-noite. Sua conta recebe um dia e um horário fixos, e eles ficam lá semana após semana — o suporte chama de seu dia e hora de sempre. Confira em Settings → Usage no claude.ai e planeje os builds pesados logo depois do seu reinício pessoal, não nas horas anteriores.
O reinício semanal está preso à sua conta, não ao calendário.Ver em 0:31 - 7
Leia o muro quando bater nele
Quando a cota seca, o Claude Code mostra uma mensagem da família “Limit reached ∙ resets <hora>” — a documentação oficial cita variantes como “You've hit your session limit” e “You've hit your weekly limit”, cada uma com o momento em que o acesso volta. Da v2.1.234 em diante você também pode deixar o Claude Code esperar e continuar sozinho (autoContinueAtUsageLimit). Não martele retries; o relógio repõe o orçamento, não a sorte.
A cota inclusa acabou — o mostrador para na marca vermelha.Ver em 1:03
Aproveitar cada cota até o fim
- 8
Compacte em vez de capotar
/compact resume a conversa e segue com uma fração dos tokens, e o Claude Code também autocompacta ao se aproximar da borda da janela. Rode /compact de propósito em cada marco — logo depois de uma suíte de testes verde, por exemplo — para o resumo guardar o que importa e largar o ruído de que você não precisa mais.
O capítulo /compact: resumir e continuar trabalhando.Ver em 3:34 - 9
Conheça os dois números do auto-compact
Desmontagens comunitárias da documentação e do código trouxeram à tona dois valores: cerca de 95% como ponto de compactação documentado e uma trava em torno de 83% que limita silenciosamente qualquer ajuste — dá para baixar o gatilho, não para subir além. Conclusão prática: trate o último quinto da sua janela como pista de decolagem e compacte de propósito antes que a ferramenta faça isso por você.
95% documentado vs. trava de 83% — não é contradição.Ver em 11:43 - 10
Baixe o effort no trabalho de rotina
O nível de effort faz parte oficialmente da conta de uso: effort mais alto gasta mais tokens por tarefa e chega aos limites mais rápido. Reserve o esforço de raciocínio profundo para os problemas cabeludos e rode edições, consultas e formatação de rotina num ajuste mais baixo — o orçamento dura visivelmente mais, sem penhasco de qualidade no trabalho simples.
Effort mais baixo, orçamento efetivo mais longo.Ver em 1:31 - 11
Cair para um endpoint mais barato
O Claude Code é um harness em volta de qualquer API compatível com Anthropic. Aponte ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN para outro provedor — DeepSeek, OpenRouter, uma conta Console — e mapeie os slots de modelo com a família de variáveis ANTHROPIC_MODEL. Nosso guia «Usar DeepSeek no Claude Code» mostra o setup completo; é o mesmo truque deste walkthrough para continuar programando enquanto a cota do plano se recupera.
Variáveis de ambiente redirecionando o Claude Code ao endpoint da DeepSeek.Ver em 1:32
Limite de sessão vs. limite semanal vs. a janela de 5 horas
A maior parte da confusão vem de três tetos que dividem o mesmo vocabulário. Aqui estão lado a lado, mais os dois sósias que não são limite de uso em absoluto.
- 1Limite de sessão — o orçamento de um sprint de trabalho. Vive numa janela rolante de 5 horas que começa na sua primeira mensagem e se repõe sozinha; não existe comando de reinício para ela.
- 2Limite semanal — o teto na escala de semanas. Roda por cima das sessões, reinicia no dia e horário atribuídos à sua conta, e nenhum comando os muda.
- 3“Limit reached ∙ resets <hora>” — a interface diz qual muro você bateu e quando ele cai. Não há comando de reinício de sessão; o horário mostrado na mensagem é o próprio mecanismo.
- 4Limite de contexto — não é limite de uso. Janela cheia é problema de tamanho de uma conversa só: /compact ou /clear resolve na hora e não gasta cota.
- 5Limites por modelo — estourar a cota do Opus muitas vezes se contorna com /model; mas os poços de sessão e de semana são compartilhados entre modelos, e trocar não os reabastece.
Mais uma armadilha: trocar de superfície não troca de poço. Chats do claude.ai, sessões do desktop e Claude Code bebem da mesma cota — “vou só perguntar no app web” gasta o mesmo orçamento.
“Limit reached ∙ resets” — primeiros socorros e uma dieta mais leve
A mensagem do muro não é erro, é agenda. Percorra esta lista e a maioria dos dias de limite volta a ser dia de trabalho.
- 1Leia o horário de reinício e se afaste. Martelar retries não adianta; da v2.1.234 em diante dá para definir autoContinueAtUsageLimit e deixar o Claude Code retomar sozinho quando a janela se renovar.
- 2Confira qual muro você bateu de verdade. Se o /context mostra a janela quase cheia com uso sobrando, é problema de contexto — /compact ou /clear te devolve ao trabalho na hora.
- 3Corte a queima fixa. Desconecte os servidores MCP de que não precisa nesta sessão, enxugue skills e CLAUDE.md e baixe o effort — os tokens de base são cobrados antes de você digitar uma palavra.
- 4Precisa terminar hoje mesmo? Ative usage credits, suba de plano ou aponte o harness para um endpoint mais barato pela tarde — cada opção mantém a sessão viva enquanto a cota do plano se recupera.
- 5Se os números parecem errados, verifique antes de culpar um bug: abra Settings → Usage no claude.ai, reinicie a sessão e compare com o /status. Persistindo, reporte com /bug — bugs reais de limite existem, mas a maioria dos limites “estranhos” é queima de contexto fantasiada.
Um hábito vale mais que qualquer resgate: sessões novas entre tarefas sem relação, plan antes de builds grandes e leituras pesadas nos subagents. Os guias relacionados abaixo — redução de tokens, auto compact, plan mode — detalham cada hábito.