Os limites de uso do Claude Code costumam chegar na pior hora: o agente está no meio de uma mudança, os testes ainda não rodaram e a próxima janela está a horas de distância. Este post explica por que o limite se esgota, como fazê-lo durar mais e o que fazer para o trabalho não travar quando ele acaba.
Um aviso logo de cara: usar mais de uma conta não é tratado do mesmo jeito nos termos de todos os provedores. Aplique a seção de troca de contas abaixo só como os termos do seu provedor permitirem.
Por que os limites de uso do Claude Code se esgotam
Quando o Claude Code e o Codex rodam numa assinatura, o uso é limitado dentro de janelas de tempo, como janelas de 5 horas e semanais. As principais coisas que consomem o limite:
- Um contexto base grande: o system prompt, as definições de ferramentas, plugins e servidores MCP relidos a cada turno.
- Conversas longas: uma conversa sem compactação carrega mais tokens a cada turno.
- Agentes em paralelo: todos os agentes na mesma conta consomem o mesmo limite.
- Modelos caros e esforço alto: mais potência do que trabalhos simples precisam.
Primeiro, faça o limite durar mais
Antes de trocar de conta, o movimento mais barato é fazer o mesmo trabalho gastando menos.
Reduza o contexto
Nas nossas medições, a primeira requisição do Claude Code ficou em cerca de 34,4k tokens numa configuração padrão e 13,3k com o perfil enxuto. Como esse contexto base é relido a cada turno, a diferença se acumula em sessões longas. Detalhes em como reduzir o uso de tokens do Claude Code.
Compacte a conversa
/compact resume uma conversa longa. No AgentVera você pode definir um limite e compactar automaticamente.
Diminua a tarefa
Em vez de “reescreva o módulo inteiro”, dê tarefas mensuráveis que avançam passo a passo. Menos arquivos são lidos, menos contexto é carregado.
Corte o paralelismo desnecessário
Quatro agentes numa conta esgotam o limite quatro vezes mais rápido. Reveja quais agentes realmente precisam rodar em paralelo.
Acompanhe o uso restante
É melhor ver o limite chegando do que descobrir quando o agente dá erro. A barra de status do AgentVera mostra o uso restante de 5 horas e semanal de cada conta com mini medidores; um valor que chega a um nível crítico fica vermelho. Clique nela para ver os limites detalhados.
Os limites são lidos do serviço de uso da Anthropic para o Claude e, por conta, via codex app-server para o Codex. Vale saber: esses não são contratos de API públicos e estáveis.
Se você ativou as notificações do Telegram, o aviso de limite também chega ao seu celular. O app do AgentVera para celular envia uma notificação quando uma conta chega a 90% do limite, e sua tela Limits mostra o uso de todas as contas.
Troca automática com cadeias de contas
Se os termos do seu provedor permitem usar mais de uma conta (por exemplo, contas separadas pessoal e da empresa), a troca de contas do AgentVera evita que o trabalho trave quando um limite acaba.
Como funciona
- Adicione suas contas em Settings → Accounts. Cada conta ganha sua própria pasta de configuração (
CLAUDE_CONFIG_DIRpara o Claude,CODEX_HOMEpara o Codex). - Entre em cada conta com o comando de login da própria CLI (
claude auth login,codex login). O AgentVera não armazena senhas nem tokens. - Nas configurações de troca de contas, ative a cadeia de contas do Claude ou do Codex e defina a ordem. Uma cadeia precisa de pelo menos duas contas.
- Defina o limite de troca. Por padrão, a troca acontece quando uma conta tem 3% ou menos restante no limite de 5 horas ou semanal.
Quando o limite restante cai abaixo desse valor, ou a CLI informa um limite, os agentes daquela conta passam para a próxima conta disponível. Depois da última conta, a cadeia volta para a primeira.
O que acontece com a conversa?
Se mover a conversa para a nova conta estiver ativado, o registro da conversa é copiado para a pasta da nova conta e o agente continua de onde parou. Se estiver desligado, começa uma conversa nova.
Quando um login expirou
Se uma conta da cadeia está deslogada ou o login dela expirou, o AgentVera percebe, avisa que é preciso fazer login e passa o agente para a próxima conta que funciona. Uma troca manual também falha logo, em vez de deixar o agente parado numa tela de login.
Tabela de decisão
| Situação | Caminho sugerido |
|---|---|
| O limite se esgota de vez em quando | Reduza o contexto, use /compact |
| Esgota rápido com agentes em paralelo | Reveja o número de agentes e o tamanho das tarefas |
| Você tem várias contas que seus termos permitem | Cadeia de contas e limite de troca |
| O limite nunca é suficiente | Considere um plano maior do seu provedor |
O que acontece quando o limite acaba?
Sem uma cadeia de contas, quando o limite acaba a CLI mostra um aviso e o agente não consegue enviar novas requisições. Você tem três opções:
- Esperar: pause o agente até a próxima janela. A conversa não se perde; continue quando o limite reiniciar.
- Passar o trabalho adiante: continue com outra ferramenta. Por exemplo, passe para o Codex, por um fluxo, o trabalho que o Claude Code deixou inacabado. O histórico da conversa não passa entre ferramentas, mas o estado atual e a lista de tarefas podem passar.
- Trocar de conta: se você tem uma segunda conta que seus termos permitem e uma cadeia está configurada, a troca acontece sozinha.
Passar o trabalho adiante reduz o impacto dos limites mesmo sem cadeia de contas. Um agente que deixa anotações no quadro compartilhado dos agentes deixa um bom ponto de partida para o próximo.
Pensando em limites como equipe
Com vários desenvolvedores, limites deixam de ser um problema pessoal e viram assunto de planejamento:
- Quem faz qual trabalho em qual conta? Contas compartilhadas podem se esgotar em horários inesperados.
- Quando rodam os trabalhos longos? Mover tarefas agendadas para fora do horário de pico protege o limite durante o dia.
- Quais trabalhos podem usar um perfil mais barato? O enxuto para agentes de documentação e de testes.
As tarefas agendadas do AgentVera enviam uma mensagem a um agente num agendamento cron; se o agente estiver ocupado, escolha se ela espera, é enviada mesmo assim ou é pulada.
Equívocos comuns
- “Se eu encurtar o prompt, não vou bater no limite.” O prompt costuma ser uma parte pequena do total; o contexto base e o histórico da conversa pesam mais.
- “Trocar de conta zera a conversa.” Com a conversa sendo movida, o agente continua de onde parou.
- “O medidor de uso é sempre exato.” Os medidores leem dos serviços de uso dos provedores; essas não são APIs públicas estáveis e os valores podem mudar.
O que observar ao adicionar contas
Se você montar uma cadeia de contas, uma configuração bem feita evita surpresas depois:
- Entre em cada conta separadamente. As contas usam pastas de configuração separadas, então entrar em uma não afeta as outras.
- Escolha a ordem de propósito. Coloque na frente a conta que você mais quer usar; as outras esperam como reserva.
- Ajuste o limite de troca ao seu trabalho. Um valor muito baixo aproveita os últimos pontos percentuais, mas aumenta o risco de bater no limite no meio de um turno.
- Mantenha a conversa sendo movida. Em trabalhos longos, deixar o agente continuar sai mais barato do que explicar tudo de novo numa conversa nova.
Checklist
- Você está acompanhando o uso restante na barra de status?
- Os agentes estão rodando com mais contexto do que precisam?
- Conversas longas estão sendo compactadas?
- Se você usa uma cadeia de contas, leu os termos do seu provedor?
- Todas as contas da cadeia estão logadas?
Concluindo
A primeira solução para os limites de uso do Claude Code é fazer o mesmo trabalho gastando menos: contexto menor, conversas compactadas e tarefas focadas. Ver os limites com antecedência elimina surpresas. Onde os termos do seu provedor permitem, uma cadeia de contas deixa o agente continuar de onde parou quando um limite acaba.
O AgentVera reúne medidores de uso, perfis de contexto e cadeias de contas num só app. Veja a página do Claude Code para mais detalhes, ou comece no plano gratuito.