Limite semanal do Claude Code explicado: reset, planos e o que o consome

O que é o limite semanal do Claude Code?

Os planos pagos têm duas cotas. A Central de Ajuda diz que eles têm “a session limit that resets every five hours” e “weekly limits that reset once every week” (limites de uso e de tamanho). Para Pro e Max, a página do Claude Code descreve um limite de sessão de cinco horas e um limite semanal, compartilhados entre o Claude e o Claude Code (Using Claude Code with your Pro or Max plan).

Os dois valem ao mesmo tempo. A referência de erros da Anthropic diz que o uso conta contra a cota de sessão e a semanal simultaneamente, e que uma rajada de atividade pesada, como um fanout grande de workflow, pode esgotar a cota semanal antes de a janela de sessão resetar (erros de limite de uso).

Como o limite semanal reseta?

A Central de Ajuda diz que os limites semanais “reset once every week” e que a página Usage mostra quando o seu reseta (boas práticas de limite de uso). A mesma página não diz quando a sessão de cinco horas começa nem como o reset semanal é agendado além do que a página Usage exibe. As mensagens de erro do Claude Code trazem o horário. A referência mostra mensagens no formato You've hit your weekly limit · resets Mon 12:00am, que é um exemplo do formato, não uma promessa de que o seu reset cai na segunda (erros).

Ao bater um limite, o Claude Code bloqueia novas requisições até o horário de reset da mensagem. Trocar de modelo com /model não resolve no limite de sessão nem no semanal, porque os dois valem para todos os modelos. Numa sessão interativa com assinatura do claude.ai, o Claude Code pode esperar e continuar a tarefa interrompida depois do reset (v2.1.234 ou mais nova), e /usage-credits gerencia uso extra no Pro e no Max.

Como Pro e Max se diferenciam no limite semanal?

A Anthropic diz que os planos “have different usage allowances, with paid plans offering higher limits” e que o uso também depende do tamanho da conversa, dos recursos, do modelo e do esforço (Central de Ajuda). A página de Pro e Max cita Max 5x e Max 20x, mas não dá quantidade de mensagens nem cota de tokens (Central de Ajuda).

Por isso não existe tabela honesta do tipo “Pro = N, Max 5x = M” para publicar. Quem imprime uma está estimando ou repetindo um anúncio antigo. Se o número importa, leia a sua página Usage e o seu /usage.

Como ver meu uso semanal?

• Settings > Usage no claude.ai: barras de progresso do limite de sessão e do semanal, com o tempo restante (Central de Ajuda).
• /usage no Claude Code: em Pro, Max, Team e Enterprise mostra as barras do plano e um detalhamento do uso recente por skills, subagentes, plugins e servidores MCP, alternável entre as últimas 24 horas e 7 dias. É calculado do histórico local desta máquina, então outros dispositivos e o claude.ai não entram (costs).
• Status line: adicione os campos rate_limits a uma status line personalizada para acompanhar a cota continuamente (docs da status line).
• Avisos: o Claude Code pode avisar antes de a janela acabar, com uma mensagem como “You've used 85% of your session limit” (erros).

Um detalhe: a página de Pro e Max da Central de Ajuda aponta o comando /status para acompanhar, enquanto a documentação do Claude Code aponta /usage. Teste os dois na sua versão.

O que drena o limite semanal mais rápido?

A documentação de custos lista por que uma sessão longa gasta mais do plano do que a sua atividade sugere (por que o uso cresce). Os que mais pesam num agente de código:

• Contexto longo relido a cada turno. O Claude Code envia a conversa inteira em toda requisição, e cada chamada de ferramenta envia outra. Uma pergunta de uma linha no fim de uma sessão de um dia inteiro ainda consome o histórico todo.
• Cache frio. A primeira mensagem depois de uma pausa maior que a vida do cache reprocessa o contexto completo.
• Subagentes. Cada subagente faz as próprias requisições além da conversa principal, e um subagente que herda um modelo caro gasta na tarifa dele. Trocar para o Opus também vale para os subagentes que herdam o modelo da sessão.
• Saída verbosa de ferramentas. Execução de testes, logs de build e dumps de arquivo entram no contexto e são relidos em toda requisição seguinte.
• Gatilhos ociosos. Tarefas agendadas e mensagens entre sessões disparam com a sessão parada e reenviam o contexto inteiro a cada vez.

Num plano pago, o /usage recomenda uma mudança para qualquer comportamento responsável por 10% ou mais do seu uso recente.

Como fazer o limite semanal durar mais?

Comece pela maior fatia do /usage, mude uma coisa e olhe de novo. As alavancas, na ordem da documentação de custos (reduzir o uso de tokens):

• /clear entre tarefas sem relação, e compactar nas pausas naturais.
• Ajustar o modelo ao trabalho e baixar o esforço nas tarefas simples.
• Manter saída verbosa fora do contexto principal: delegar ou filtrar. O nosso guia sobre saída longa de teste cobre o filtro.
• Escolher um modelo menor para subagentes de trabalho simples. Veja qual modelo cada subagente usa.
• Evitar trocar de modelo no meio da tarefa: cada modelo tem o próprio cache de prompt.

Para o diagnóstico completo, leia O limite de uso do Claude Code acaba rápido.

O que o Downshift mediu, e o que não?

O Downshift é um hook que roteia cada subagente para um modelo do tamanho certo e enxuga a saída verbosa de comandos. Os números dele são tokens por tarefa e bytes, não janelas de assinatura. Ninguém mediu quantas horas ou dias isso soma a um limite semanal, nós inclusive.

• Roteamento: bateria de quatro braços, 2026-10-21, tarefas mecânicas delegadas, 46 execuções, um operador: cerca de 24% menos tokens por tarefa aceita (16% por execução; intervalo de 95% de +2,1% a +46,7%). Página de evidência.
• Compactação: fixtures sintéticos, 2026-10-21: 82,3% menos bytes nos 26 de 248 arquivos que compactam, 23,7% nos 248. Bytes, não tokens de LLM.

O intervalo é largo e a amostra é pequena. Leia como direção, não como promessa sobre o seu limite.

Guias relacionados

• O limite de uso do Claude Code acaba rápido: de onde vem o consumo
• Qual modelo cada subagente usa no Claude Code
• Saída de teste gastando tokens no Claude Code: como cortar
• Claude Code weekly limit explained: reset, plans and what drains itEnglish
• Instalar o Downshift: hooks no Claude Code, Codex e Cursor

Fontes

1. Central de Ajuda da Anthropicoficial
   support.claude.com: How do usage and length limits work
   limites de sessão e semanal, uso compartilhado, sem números (lido em 2026-10-24)
2. Central de Ajuda da Anthropicoficial
   support.claude.com: Using Claude Code with your Pro or Max plan
   limites do Pro e do Max, sem números, /status (lido em 2026-10-24)
3. Central de Ajuda da Anthropicoficial
   support.claude.com: Usage limit best practices
   Settings > Usage, reset semanal na página Usage (lido em 2026-10-24)
4. Docs da Anthropicoficial
   code.claude.com/docs/en/costs
   detalhamento do /usage, por que o uso cresce, reduzir tokens (lido em 2026-10-24)
5. Docs da Anthropicoficial
   code.claude.com/docs/en/errors
   mensagens de limite, valem para todos os modelos, sessão e semanal juntas (lido em 2026-10-24)
6. Repositório do Downshiftmedido
   docs/evidence/four-arm-mechanical-2026-10-21.md
   46 execuções, um operador; tokens por tarefa, não janelas de assinatura