Estourei o limite do Opus no Claude Code: o que acontece e como continuar trabalhando

Fala aí, beleza?

Você estava no meio de um refactor, o Claude Code respondendo redondo, e do nada aparece aquela linha curta avisando que a cota acabou

O trabalho para na hora e vem a dúvida: preciso assinar um plano mais caro AGORA ou dá pra continuar?

Depende de qual limite estourou, e essa diferença muda tudo

Esse post é pra quem foi surpreendido no meio da tarefa: primeiro a gente entende o que aconteceu, depois o que fazer nos próximos dois minutos pra voltar a codar 🙂

Qual limite estourou: leia a mensagem antes de agir

O sintoma é sempre parecido: o Claude Code bloqueia a próxima requisição e mostra uma linha com o horário de renovação

Só que a causa muda, e é aí que a maioria reage errado (normalmente saindo pra procurar botão de upgrade)

A documentação de erros do Claude Code descreve três limites distintos, cada um com seu próprio horário de reset: limite de sessão, limite semanal e limite específico do Opus

As mensagens são específicas por tipo, então dá pra identificar batendo o olho:

Antes de qualquer coisa, olha o horário de reset que a própria mensagem te entrega

Às vezes falta pouco e a melhor decisão é ir tomar um café, não trocar de plano 😀

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Estourou só o Opus: como continuar na mesma sessão

Esse é o cenário mais tranquilo dos três

O sintoma: as requisições ao Opus travam, mas a sessão em si continua viva

A causa: o limite do Opus vale só pra requisições ao Opus, ele é isolado das outras cotas

Ou seja, trocar de modelo mantém o trabalho rodando

1. Com a sessão aberta, chame a troca de modelo:

/model

O erro comum aqui é fechar o terminal e começar tudo de novo achando que precisa reiniciar

Não precisa: a troca no meio da sessão preserva o histórico da conversa, então o contexto do que você estava fazendo continua ali

2. Escolha um alias que não seja Opus

Os aliases disponíveis no Claude Code incluem best, fable, sonnet, opus, haiku, sonnet[1m], opus[1m] e opusplan

Pra seguir uma execução que já estava planejada, sonnet costuma dar conta do recado

3. Pra prevenir o próximo bloqueio, considere o opusplan

Esse alias usa Opus pro raciocínio e pra arquitetura no plan mode, e troca automaticamente pro Sonnet na hora da execução

É o arranjo que gasta o modelo caro onde ele realmente faz diferença

E se liga nisso: quando um modelo está sob alta carga, o próprio Claude Code sugere usar /model pra mudar pra outro

Ou seja, não é gambiarra, é o caminho que a ferramenta indica

Estourou a sessão ou o limite semanal: trocar de modelo não resolve

Aqui muda o jogo

O sintoma: você troca pra Sonnet, troca pra Haiku, e o bloqueio continua igual

A causa é simples: os limites de sessão e semanal são compartilhados entre todos os modelos

Quando é um desses que estoura, o Claude Code bloqueia novas requisições até o horário de reset exibido, não importa qual modelo você escolher

Tem mais um detalhe que pega gente desprevenida: o uso debita das duas cotas ao mesmo tempo

Então uma rajada pesada pode esgotar a semanal antes da janela de sessão renovar

E o pool é único: Claude na web, no desktop, no mobile e no Claude Code saem da mesma cota

Se você usa Claude Code dentro da IDE (VS Code, Cursor e IDEs JetBrains estão entre as suportadas no Pro e no Max), esse uso conta no mesmo limite compartilhado

Aquele papo de "mas eu quase não usei o Claude Code hoje" às vezes esconde uma tarde inteira de conversa no navegador, haha

E dá pra continuar sem esperar?

Existe uma saída oficial: os créditos de uso (extra usage)

Eles permitem que assinantes de planos pagos Pro, Max 5x e Max 20x continuem usando o Claude depois de atingir o limite incluído, passando pra cobrança por consumo nas tarifas padrão da API

Como habilitar:

1. Cadastre uma forma de pagamento (é obrigatório antes de habilitar e comprar os créditos)
2. Vá em Settings > Usage, na versão web do Claude, e habilite os créditos

O erro comum deste passo: tentar fazer isso pelo celular

Quem assinou pelos apps móveis só consegue habilitar na web, então não perca tempo caçando o botão no app

3. Confira que a mensagem de limite mudou de tom

Com créditos habilitados, ela deixa de ser bloqueio e vira continuidade: informa o horário de reset da janela de 5 horas e completa com continuing with usage credits

Pra não virar surpresa na fatura, o recurso oferece teto mensal de gasto, recarga automática por limiar de saldo e alertas de aproximação do limite

E dá pra desabilitar quando quiser, no mesmo Settings > Usage

O limite chega de surpresa: como enxergar quanto ainda sobra

O sintoma que mais irrita é esse: a cota acaba no meio de uma tarefa longa, sem você ter noção de que estava perto

A causa é falta de visibilidade, e isso tem solução dentro da própria ferramenta

1. Rode /usage pra ver o consumo atual

/usage

As teclas d e w alternam entre as últimas 24 horas e os últimos 7 dias

Nos planos Pro, Max, Team e Enterprise, ele detalha o que contou contra os limites do plano por skill, subagente, plugin e servidor MCP

Tome cuidado com um ponto: os números são aproximados e calculados a partir do histórico local da máquina

É termômetro, não extrato de banco

2. Use /status pra monitorar a alocação restante dentro do Claude Code

3. Pra ver barra de progresso, abra Settings > Usage no Claude, na web, na seção "Plan usage limits"

Em planos Pro, Max, Team ou Enterprise por assento aparecem as barras da sessão de 5 horas e do limite semanal

4. Deixe o consumo fixo na tela com a status line

A status line do Claude Code pode exibir o uso da assinatura Claude.ai através do objeto rate_limits, que traz as janelas five_hour e seven_day

Cada janela tem used_percentage (0 a 100) e resets_at (epoch Unix)

E você não precisa escrever o script na mão: o /statusline gera uma status line a partir de instrução em linguagem natural

/statusline

Agora a parte de gastar menos

A documentação oficial recomenda três caminhos pra reduzir consumo:

• baixar a concorrência de ferramentas com a variável de ambiente CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY
• evitar muitos subagentes rodando em paralelo
• trocar pra um modelo menor com /model em execuções scriptadas de alto volume

Se você roda script em cima do Claude Code, esses três juntos mudam bastante o ritmo da queima de cota

Onde vale gastar Opus e onde Sonnet ou Haiku dão conta

Aqui está a raiz do problema, sinceramente

O Opus custa várias vezes mais por turno que o Sonnet, e o Sonnet mais que o Haiku

Então gastar Opus em trabalho rotineiro é a forma mais rápida de esvaziar a cota

Pensa assim: o Opus é o cara que você chama pra desenhar a solução

Depois que o desenho está feito, quem toca a obra pode ser o Sonnet sem drama

E o que você tem à mão depende do plano: o Free inclui Haiku e Sonnet, enquanto Pro e Max adicionam Opus, Fable e mais folga de uso

Os planos Max entregam 5x ou 20x o uso do Pro por sessão de 5 horas, com limite semanal aplicado sobre todos os modelos

Se a sua dúvida é mais ampla e vai além de destravar agora, vale ver quanto de Opus cada plano entrega antes de mexer na assinatura

O que eu vi na prática ao trocar Opus por Sonnet no dia a dia

No vídeo abaixo eu testo exatamente esse arranjo: Opus no planejamento, Sonnet na execução

Abri o Claude Code já iniciado, chamei a troca de modelo e escolhi a opção de plano com Opus

A própria interface anuncia a divisão: planejamento fica com o Opus, qualquer outra coisa fica com o Sonnet

Pra não testar no vazio, montei um projeto real do zero: um app de resenhas de livros, com cadastro de resenha, cards mostrando capa, título, autor e nota, e botão de curtir com contador salvo

Entrei no modo de planejamento por atalho de teclado, escrevi o prompt inicial e respondi as perguntas de escopo (stack, banco, idioma) antes de liberar a execução

Confirmei na tela que a etapa de planejamento estava mesmo rodando no Opus

E aí veio a parte massa: ao sair do modo de planejamento, a execução passou sozinha pro Sonnet, sem eu trocar o modelo à mão

Um detalhe de bastidor: em testes anteriores o assistente me entregou o plano direto, e nessa vez ele fez uma pergunta final antes de seguir

Ou seja, não é 100% previsível de uma execução pra outra

A criação inicial do projeto demorou bastante, quase meia hora até ficar pronto na minha máquina

Mas eu atribuo isso ao arranque do projeto, não ao modelo que estava executando

Quando fui conferir, ainda apareciam duas tarefas pendentes

Abri o app e tomei um erro do Next, pedi a correção pelo próprio chat

Aqui apareceu o ponto fraco: precisei intervir e sugerir o caminho da solução pro Sonnet destravar, em vez de ele resolver sozinho

Esse tipo de teimosia é justamente onde o Claude ainda escorrega e vale conhecer antes de confiar cego

No fim deu certo: publiquei uma resenha, cliquei em curtir, vi o contador subir e os dados persistirem no navegador

Minha leitura honesta: gostei da ideia e do conceito, porque ele ataca a dor real de consumir a sessão rápido

Mas ainda não está no ponto ideal

Senti falta de um modelo mais barato pras tarefas triviais, tipo reiniciar o servidor: acabei digitando o comando eu mesmo

E tem um efeito colateral pra pensar: o Sonnet insistindo num erro pode consumir tanto token quanto o Opus gastaria resolvendo de uma vez só

No dia a dia de quem usa, a diferença de qualidade entre os dois aparece, e o Opus se sai melhor

Hoje o arranjo ainda é manual e simplista, e a minha esperança é que a escolha de modelo fique automática no futuro…

O que mudou nos limites do Claude Code em 2026

Se você tem a sensação de que a cota está diferente da que você conhecia, tem motivo

A Anthropic dobrou os limites de 5 horas do Claude Code pros planos Pro, Max, Team e Enterprise por assento, e removeu a redução de limite em horário de pico pras contas Pro e Max

Essas mudanças entraram em vigor a partir de 6 de maio de 2026

Do outro lado da conta está o modelo

O Claude Opus 5 é o Opus mais recente da linha, lançado em 24 de julho de 2026, com janela de contexto de 1M tokens, até 128k tokens de saída e thinking ligado por padrão

Na API ele custa US$ 5 por milhão de tokens de entrada e US$ 25 por milhão de saída

Juntando as peças: contexto gigante, saída longa e thinking ligado significam turno pesado

É por isso que o modelo mais caro esvazia a cota mais rápido que os outros, não é impressão sua

Próximo passo depois de destravar

Recapitulando a sequência, na ordem em que ela resolve:

1. Leia a mensagem e identifique qual dos três limites apareceu
2. Se foi o do Opus, rode /model e siga na mesma sessão com outro modelo
3. Se foi sessão ou semanal, trocar de modelo não resolve: espere o reset exibido ou avalie os créditos de uso em Settings > Usage, na web
4. Adote /usage e uma status line com rate_limits pra não ser pego de novo

O passo concreto pra hoje é configurar o opusplan e o monitoramento ANTES da próxima tarefa longa

Assim o modelo caro entra onde ele decide o desenho, e a execução segue sem estourar sua janela no meio do caminho

Bora testar aí e ver quanto a sua sessão dura desse jeito? =)

até o próximo post!