Resposta rápida: os limites de uso do Claude Code funcionam em duas camadas: um limite de sessão que reinicia a cada cinco horas e um limite semanal que reinicia uma vez por semana. Ambos são compartilhados com o Claude na web e com o Claude Desktop. A Anthropic não divulga uma contagem de mensagens para nenhum dos dois, pois a quantidade disponível varia conforme o modelo, o tamanho do contexto e as ferramentas utilizadas.
Esse pool compartilhado é o detalhe que a maioria das pessoas não percebe. A janela consumida em uma longa pesquisa no café da manhã é a mesma janela de que a execução do seu agente precisará às 15h.
O que consome os seus limites no Claude Code
A central de ajuda da Anthropic deixa bem claro: os planos pagos contam com um limite de sessão reiniciado a cada cinco horas e limites semanais que reiniciam uma vez por semana. Os planos Max incluem, adicionalmente, um limite semanal separado para os modelos Fable. Três interfaces consom essa mesma cota: o Claude web, o Claude Desktop e o Claude Code no terminal e na IDE. Não existe um orçamento isolado por ferramenta para proteger.
| Plano | Preço (verificado em 21/10/2026) | Claude Code |
|---|---|---|
| Gratuito | $0 | Não incluso |
| Pro | $20/mês, ou $17/mês no faturamento anual ($200 à vista) | Incluso |
| Max | A partir de $100/mês, nos níveis de 5x e 20x | Incluso |
| Team | $20/mês por usuário padrão no faturamento anual, $25 faturado mensalmente | Incluso |
Os valores foram consultados na página de preços da Anthropic e podem mudar a critério da empresa.
A janela de cinco horas na prática
O limite de sessão é reiniciado cinco horas após a abertura da janela. Como a Anthropic não especifica regras de início nem quantidades de tokens, encare isso como um orçamento contínuo (rolling budget), e não como um relógio que você consiga manipular.
Um comportamento específico parece bug, mas não é. Se você atingir o limite no meio de uma resposta, o Claude Code pode concluir o passo em andamento e exibir Usage limit reached · wrapping up. A documentação dos planos Pro e Max da Anthropic esclarece que essa conclusão consome o seu limite semanal e não abrange novas mensagens. No Pro, isso se aplica uma vez por período semanal; no Max, sempre que você atingir o limite de cinco horas. A Anthropic também destaca que o recurso está sendo liberado gradualmente, de modo que sua conta pode ainda não tê-lo. Trata-se de uma cortesia para a interação em andamento, não de um período de carência.
O teto semanal e por que ele pesa mais
O limite semanal é o que encerra de vez o dia de trabalho. As janelas de cinco horas se renovam quatro ou cinco vezes ao dia; o teto semanal, não. A Anthropic não divulga nenhuma regra de reinício além de “limites semanais que reiniciam uma vez por semana”, portanto não planeje uma refatoração pesada com base em um horário estimado por conta própria. Consulte o /usage antes de começar.
Ao atingir qualquer um dos limites, você tem três opções:
- Aguardar o reinício da contagem.
- Ativar os créditos de uso (usage credits), que migram as requisições para o modelo sob demanda (pay-as-you-go) em vez de interrompê-las.
- Transferir o trabalho para outro agente em uma assinatura que você já paga.
Por que não há uma contagem fixa de mensagens
A Anthropic não divulga uma métrica como “200 mensagens por janela” porque esse número seria pura ficção. O consumo escala com tokens, e os tokens variam de acordo com o seu modelo (o Opus custa mais por interação que o Sonnet), o seu tamanho de contexto (cada mensagem reenvia todo o histórico da conversa), as suas ferramentas (a Anthropic classifica os conectores como de “uso intensivo de tokens”) e o seu nível de esforço (tokens de pensamento contam como saída, e o orçamento padrão pode atingir dezenas de milhares por requisição).
Essa mesma lista de variáveis serve como o seu plano de ação.
9 maneiras de otimizar seus limites no Claude Code
1. Execute /usage e siga as recomendações
Nos planos Pro, Max, Team e Enterprise, o /usage detalha o consumo recente atribuído a skills, subagentes, plugins e servidores MCP individuais, fornecendo recomendações com a porcentagem de economia estimada para cada item:
25% Trim ~/code/api/CLAUDE.md · 49k tokens per request
40% Switch from max to high effort · /effort high
30% Compact before you step away · run /compact
Pressione d ou w para alternar entre 24 horas e 7 dias. Se o rodapé exibir f to fix 2 of 3, pressionar f aplica as soluções que o Claude Code consegue resolver diretamente. Como os números são extraídos do histórico da sessão local, o uso em outro computador não será considerado. Comece por aqui; é bem mais eficiente do que tentar adivinhar.
2. Limpe o contexto entre tarefas distintas
Contexto obsoleto consome tokens em cada mensagem seguinte, e não só uma vez. Passar da correção de um bug para uma nova funcionalidade mantém a conversa antiga como um peso morto que continuará sendo reenviado.
/rename auth-token-refresh-bug # label it so you can find it later
/clear # start fresh
/resume # come back to it later
Usar /rename antes de /clear é a etapa que muitos pulam e depois se arrependem.
3. Oriente a compactação sobre o que preservar
A compactação automática resume seu histórico quando você chega perto do limite de contexto e, sem instruções, tenta adivinhar o que é relevante. Direcione o processo usando /compact Focus on code samples and API usage, ou defina a regra de forma permanente no arquivo CLAUDE.md do projeto:
# Compact instructions
When you are using compact, please focus on test output and code changes
4. Ajuste o modelo à complexidade da tarefa
O Sonnet dá conta da maioria das tarefas de programação e custa menos que o Opus. Reserve o Opus para decisões críticas de arquitetura e alterne quando necessário com /model. Dois detalhes importantes: mudar para o Opus também afeta subagentes que herdam o modelo da sessão, mas você pode fixar um modelo mais econômico individualmente por subagente.
---
name: test-runner
model: haiku
---
Nosso guia de roteamento de modelos detalha qual modelo usar para cada papel, e o artigo sobre quando modelos mais baratos custam mais analisa as situações em que usar um modelo inferior pode sair pela culatra.
5. Diminua o nível de esforço de raciocínio
O pensamento estendido (extended thinking) vem habilitado por padrão porque ajuda em planejamentos complexos. Para alterações rotineiras, no entanto, são tokens queimados à toa. Reduza o nível com /effort ou desative o raciocínio em /config. Não é possível desativá-lo nos modelos Opus 5.5, Sonnet 5.5, Haiku 5.5 ou Fable. Em modelos com cota fixa, limite o uso com MAX_THINKING_TOKENS=8000; modelos de raciocínio adaptativo ignoram valores diferentes de zero.
6. Elimine o overhead de servidores MCP
As definições de ferramentas são carregadas sob demanda por padrão; apenas os nomes e as instruções do servidor entram no contexto até que uma ferramenta seja usada. Ainda assim, isso tem um custo. Use /context para verificar o que está ocupando espaço e /mcp para desativar servidores desnecessários no momento. Sempre que existir uma CLI oficial, dê preferência a ela: gh, aws e gcloud não adicionam listas de ferramentas ao contexto.
7. Transfira regras do CLAUDE.md para skills
O CLAUDE.md é carregado ao iniciar a sessão e permanece no contexto a cada mensagem, inclusive naquelas que nada têm a ver com o arquivo. Um documento de 300 linhas com checklist de PR e procedimentos de migração sobrecarrega todas as requisições. Como as skills carregam sob demanda, separe os processos especializados e mantenha o CLAUDE.md abaixo de 200 linhas.
8. Filtre saídas extensas antes que o Claude as leia
Um hook PreToolUse processa previamente os dados antes que eles entrem no contexto. Em vez de fazer o Claude ler um log de 10.000 linhas, o hook filtra por ERROR e devolve somente os trechos correspondentes, reduzindo o custo de dezenas de milhares de tokens para poucas centenas. Subagentes fazem o mesmo com execuções de testes e buscas de documentação: o ruído fica retido no contexto do subagente e apenas o resumo é repassado.
9. Planeje primeiro e elabore prompts específicos
“Melhore esta base de código” dispara uma varredura generalizada. “Adicione validação de entrada à função de login em auth.ts” exige a leitura de poucos arquivos pontuais. Para demandas maiores, pressione Shift+Tab para entrar no modo de planejamento: reprovar um plano custa uma fração do que custaria desfazer uma implementação incorreta.
Um aviso sobre escala: a documentação de custos da Anthropic aponta que equipes de agentes consom cerca de 7 vezes mais tokens do que sessões padrão quando operam no modo de planejamento, já que cada integrante mantém sua própria janela de contexto. Rodar tarefas paralelas em uma única assinatura é a forma mais rápida de atingir o seu teto semanal.
O que evitar
Criar várias contas para burlar limites, compartilhar logins e alternar credenciais violam os termos da Anthropic — e perder o acesso à conta custa muito mais do que esperar qualquer reinício de cota. As saídas legítimas são migrar para um plano superior, habilitar créditos de uso ou adquirir créditos da API no Console.
Quando mudar de plano não é a solução ideal
Observe este cenário clássico: você atinge o limite semanal na quinta-feira. Sua equipe já assina o Codex, você tem uma chave do Gemini CLI e uma máquina ociosa ao lado. Nada disso resolve, porque o trabalho está preso a um único terminal atrelado a uma única assinatura. Isso é um problema de roteamento, não de cota.
O Sharkly funciona como a camada superior para os seus agentes de programação. Você conecta um Computador (Computer), o serviço local identifica as ferramentas de agentes instaladas e as registra como Runtimes. Depois, você vincula uma Tarefa (Task) a um Agente (Agent) rodando no Runtime de sua escolha. Claude Code, Codex, Gemini CLI e OpenCode se tornam alvos de execução integrados em vez de silos isolados.
Dois limites que devem ficar transparentes:
- O Sharkly não amplia seus limites no Claude. O consumo dos modelos continua restrito às assinaturas e chaves de API configuradas em cada ferramenta. O Sharkly não comercializa tokens, o que é uma escolha deliberada de arquitetura, e não uma limitação.
- O Sharkly não substitui o Claude Code. Ele acrescenta uma camada unificada de Tarefas, Computadores, contexto e revisão em torno das ferramentas que seu time já utiliza.
A divisão do trabalho se mantém idêntica, independentemente do Runtime encarregado da Tarefa: agentes pesquisam, executam, testam e reportam; você define as prioridades, concede permissão para rodar e valida o resultado final. Uma janela esgotada transfere a execução técnica, jamais a tomada de decisão humana.
O que muda é a flexibilidade do fluxo de trabalho. Quando a janela do Claude se esgota, a Tarefa não fica travada em um terminal inativo até as 16h. Você a redireciona para um Agente em outro Runtime, enquanto execuções, bloqueios e resultados continuam sendo consolidados na mesma linha do tempo da Tarefa, conforme exemplificado no passo a passo sobre como rodar Claude Code e Codex em conjunto em uma mesma base de código.
Para ser bem direto: se você usa apenas um agente em um único repositório, essas nove táticas cobrem todas as suas necessidades. Mas se você já gerencia vários agentes espalhados por diferentes assinaturas, fazer o controle manual das janelas não escala, e o excesso de terminais é o custo invisível que você está pagando. Mais agentes também exigem mais validações, e a revisão humana se torna o gargalo assim que a execução deixa de ser o obstáculo.
Para ver isso na prática no seu próprio ambiente, conecte um Computador, configure um Agente e atribua a ele uma tarefa simples.
FAQ
O Claude Code compartilha limites com o aplicativo do Claude? Sim. O consumo no Claude na web, no Claude Desktop e no Claude Code é debitado das mesmas cotas semanais e por sessão. O uso por meio de IDEs também entra nessa conta.
Quantas mensagens posso enviar no período de cinco horas? A Anthropic não estipula uma quantidade exata. O limite varia conforme o modelo selecionado, a extensão do histórico, as ferramentas integradas e o nível de esforço configurado. Utilize o /usage em vez de trabalhar com suposições.
O que significa a mensagem “Usage limit reached · wrapping up”? Significa que o Claude Code está finalizando a etapa que já estava em andamento quando você bateu no limite de cinco horas. Essa conclusão conta para o seu limite semanal e não permite novas mensagens. No plano Pro, isso acontece uma vez por ciclo semanal; no Max, ocorre sempre que o limite de cinco horas é atingido.
Quando o limite semanal é reiniciado? A Anthropic não divulga uma regra fixa além de “limites semanais que reiniciam uma vez por semana”, referindo-se a esse intervalo como um período de uso semanal. O limite por sessão é o único detalhado com exatidão: ele reinicia a cada cinco horas. Consulte o /usage antes de iniciar tarefas extensas.
É possível continuar trabalhando após atingir um limite? Sim, habilitando os créditos de uso (usage credits), que convertem as requisições para o modelo sob demanda (pay-as-you-go). Também é possível comprar créditos de API pelo Console. Vale lembrar que os créditos mensais de API inclusos no plano Max não podem ser transferidos para o Claude Code.
Outra plataforma de agentes pode me dar mais cota no Claude? Não. Qualquer ferramenta que execute o Claude Code utilizará a sua assinatura existente. Uma camada de gerenciamento atua exclusivamente no roteamento, permitindo que a demanda seja transferida para outro agente em vez de obrigá-lo a esperar pelo próximo reinício de cota.
/compact
