# Bateu o limite de uso do Claude Code? O que fazer

URL: https://agentvera.dev/pt/blog/claude-code-usage-limits/ · Publicado: 2026-10-04

Quando o limite de uso do Claude Code chega no meio da tarefa: acompanhe o uso restante, reduza o contexto e monte cadeias de contas dentro dos termos do provedor.

**Resumo:**

- O uso por assinatura do Claude Code e do Codex é limitado em janelas de 5 horas e semanais, e todos os agentes na mesma conta consomem o mesmo limite.
- Um contexto menor, /compact em conversas longas e tarefas focadas fazem o limite durar mais; o contexto base é relido a cada turno.
- Onde os termos do provedor permitem várias contas, uma cadeia de contas do AgentVera passa os agentes para a próxima conta quando resta 3% ou menos de um limite, por padrão.

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](/pt/blog/claude-code-token-usage/).

### 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](/pt/features/notifications-and-approvals/), o aviso de limite também chega ao seu celular. O [app do AgentVera para celular](/pt/blog/claude-code-mobile-app/) 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](/pt/features/account-switching/) do AgentVera evita que o trabalho trave quando um limite acaba.

### Como funciona

1. Adicione suas contas em Settings → Accounts. Cada conta ganha sua própria pasta de configuração (`CLAUDE_CONFIG_DIR` para o Claude, `CODEX_HOME` para o Codex).
2. 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.
3. 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.
4. 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:

1. **Esperar:** pause o agente até a próxima janela. A conversa não se perde; continue quando o limite reiniciar.
2. **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.
3. **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](/pt/features/scheduled-tasks/) 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](/pt/agents/claude-code/) para mais detalhes, ou [comece no plano gratuito](/pt/).

## Perguntas frequentes

**Por que os limites de uso do Claude Code se esgotam?** O uso por assinatura é limitado dentro de janelas de tempo (por exemplo, de 5 horas e semanais). Conversas longas, contexto grande e agentes em paralelo consomem tudo mais rápido.

**Cadeias de contas são permitidas pelo meu provedor?** Isso depende dos termos do seu provedor e de como suas contas foram criadas. Use a troca de contas só como os termos do provedor em questão permitem; essa responsabilidade é sua.

**A conversa se perde quando a conta muda?** 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. Se estiver desligado, começa uma conversa nova.

**Onde vejo o uso restante?** A barra de status do AgentVera mostra o uso restante de 5 horas e semanal de cada conta; clique nela para ver os detalhes.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/