Limite do Claude atingido: o que fazer agora

Qual limite do Claude você atingiu

Uma mensagem de limite atingido do Claude nomeia a janela de tempo pela qual você está aguardando, e essa janela determina o que você pode fazer em seguida. Nos planos Pro e Max, os limites de sessão e os limites semanais gerais abrangem todos os modelos simultaneamente, portanto, alternar entre modelos não restaura o seu acesso. O limite semanal geral do Ultra também abrange todos os modelos de uma vez. Um limite que nomeia um modelo específico é a exceção: altere os modelos e você continuará trabalhando enquanto apenas aquele modelo permanece bloqueado. A Anthropic também recomenda que usuários de contas Enterprise que atingirem um limite de uso tentem um modelo mais leve com /model.

O Claude Code exibe a janela e o seu tempo de reinicialização na mesma linha:

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

A janela de sessão é um período móvel de cinco horas. As janelas semanais reiniciam em um horário fixo a cada semana, atribuído à sua conta, de modo que o dia e a hora permanecem os mesmos de uma semana para a outra. Um plano Pro possui a janela de sessão de cinco horas mais um limite semanal que se aplica a todos os modelos. Um plano Max adiciona um segundo limite semanal que se aplica a uma família de modelos específica. O Ultra também possui um limite semanal geral e um limite semanal separado para o Fable, mas contas Ultra verificadas não possuem limite de cinco horas. Contas ainda não verificadas possuem um limite temporário até que a Anthropic as verifique automaticamente. Os tetos de uso em si estão em detalhamento completo dos limites de uso do Claude. Esta página começa onde aquela termina.

Aqui está a parte que confunde as pessoas. Onde um limite de sessão se aplica, cada solicitação conta contra a janela de sessão e a janela semanal ao mesmo tempo, portanto, uma tarde de uso intenso pode esgotar a cota semanal enquanto a janela de cinco horas ainda possui espaço. Verifique o horário de reinicialização antes de planejar o restante do seu dia. Uma reinicialização às 15:45 é uma pausa para o café. Uma reinicialização na segunda-feira à meia-noite não é.

Verifique o medidor antes de supor

No claude.ai, abra Settings e depois Usage. As barras de progresso mostram quanto da janela de sessão de cinco horas e de cada janela semanal você consumiu, permitindo identificar qual delas está vazia em vez de supor. Contas Ultra verificadas não possuem a barra Current session.

No Claude Code, execute /usage. Ele exibe as mesmas barras de plano, além de um detalhamento de para onde o uso recente foi direcionado, atribuído a skills, subagentes, plugins e servidores MCP (model context protocol) individuais como uma porcentagem do total. Pressione d para as últimas 24 horas e w para os últimos 7 dias. Ele também sinaliza qualquer padrão que represente 10% ou mais do uso recente, sendo os dois que você verá com mais frequência o contexto longo e as falhas de cache (cache misses).

Duas ressalvas. O detalhamento é calculado a partir do histórico de sessão armazenado nessa máquina, portanto, o trabalho realizado em outro laptop ou no claude.ai não aparece nele, mesmo que tenha consumido a mesma franquia, porque Claude Code e seus chats no claude.ai compartilham a mesma janela de assinatura. O valor em dólares no bloco Session no topo é uma estimativa destinada a usuários de API (application programming interface). O Claude Code precifica isso pelas taxas de tabela padrão, a menos que um administrador tenha definido uma tabela modelPricing nas configurações gerenciadas da sua organização; nesse caso, ele utiliza essas taxas contratadas e a linha Total cost exibe at your organization's configured rates. De qualquer forma, esse não é o valor da sua fatura quando você está em uma assinatura.

Mudar para um modelo menor ajuda?

Sim, quando a mensagem indica um modelo, e a Anthropic também recomenda testá-lo para utilizadores com licenças Enterprise que atingem o limite de utilização. Após You've hit your Opus limit, execute /model, selecione Sonnet ou Haiku, e a sessão continuará com todo o contexto preservado. Nos planos Pro, Max e Ultra, após You've hit your session limit ou You've hit your weekly limit, /model não restaura a quota partilhada. Quando apenas o Opus está bloqueado, o que significa o esgotamento da quota semanal do Opus explica quando o Opus volta a ficar disponível e se créditos de utilização ou uma mudança para o plano Max permitem o acesso mais cedo.

A mudança é muito mais vantajosa antes de atingir o limite do que depois. O Sonnet processa a maioria das tarefas de programação a uma fração do custo do Opus, por isso manter o Opus como predefinição é um dos dois hábitos responsáveis pela maioria das surpresas com o consumo de limites. O outro é uma sessão que nunca é limpa. Delegue edições mecânicas e triagem de logs ao Haiku, e reserve o Opus para decisões de design nas quais esteja genuinamente bloqueado. Escolher entre Opus, Sonnet e Haiku detalha onde cada um justifica o seu preço.

Deixe de pagar pelo contexto que já não utiliza

O Claude Code envia a conversa completa em cada pedido. Sempre que o Claude utiliza uma ferramenta, envia outro pedido com esse conjunto de resultados da ferramenta. O prompt caching faz com que o histórico seja lido novamente à tarifa de cache, em vez da tarifa de entrada completa. Isto reduz o custo, mas não o elimina. Por isso, uma pergunta de uma linha numa sessão que está aberta desde a manhã continua a consumir utilização correspondente à conversa inteira.

/context
/clear
/compact Focus on the failing tests and the files we changed

/clear não tem custo, porque elimina o contexto em vez de o ler. /compact precisa de ler a conversa que resume. Por isso, compactar um contexto muito grande é, por si só, um pedido grande. Use /clear quando mudar para trabalho não relacionado e use /compact apenas quando estiver a meio de uma tarefa e precisar de preservar o contexto. Execute /rename antes de limpar a sessão, para poder encontrá-la novamente com /resume.

A duração do cache é mais importante do que a maioria das pessoas espera. Numa subscrição, enquanto estiver dentro da utilização incluída no seu plano, o cache da conversa principal permanece durante uma hora. Os subagents e a maioria dos outros pedidos em segundo plano obtêm cinco minutos, mesmo numa subscrição. A conversa principal passa para cinco minutos quando começa a consumir créditos de utilização. Cinco minutos também é o valor predefinido para uma API key. As definições promptCacheTtl e subagentPromptCacheTtl substituem esses valores predefinidos se quiser uma duração diferente. A primeira mensagem depois de uma pausa longa não encontra o cache. Assim, todo o contexto é processado novamente e escrito de novo no cache. Às tarifas padrão da API, uma escrita no cache custa mais do que uma entrada normal: 1.25 vezes o preço base de entrada para um cache de cinco minutos e 2 vezes para um cache de uma hora. É por isso que a utilização aumenta frequentemente sem uma causa visível. Quando o prompt caching compensa explica os cálculos.

Existem mais três controlos no mesmo local. /mcp apresenta os servidores configurados, para poder desativar os que esta tarefa não precisa. Um CLAUDE.md longo é carregado no início da sessão, seja ou não necessário para o trabalho. Por isso, mova as instruções especializadas para skills, que só são carregadas quando invocadas. O extended thinking é faturado como output tokens, que são a parte mais cara. Reduza-o com /effort, desative-o em /config num modelo que o permita ou defina MAX_THINKING_TOKENS=8000 num modelo com um orçamento fixo de thinking. O Claude Code não pode desativar o thinking no Opus 5.5, Sonnet 5.5, Haiku 5.5 ou nos modelos Fable. Nesses modelos, /effort é o controlo relevante. Esta é uma regra do Claude Code, não do modelo. Na API, o Haiku 5.5 aceita o thinking desativado com high de effort ou inferior, e o Sonnet 5.5 pode reduzir o thinking inicial com a definição between_tools. O Opus 5.5 e os modelos Fable recusam o thinking desativado em qualquer contexto.

Divida a tarefa para que caiba numa única janela

Pressione Shift+Tab para alternar para o modo de plano antes de uma alteração grande. O Claude explora a base de código e propõe uma abordagem para a sua aprovação; uma direção errada detetada nesta fase custa um plano em vez de duas horas de edições e retrabalho.

Delegue operações ruidosas a subagentes. Executar uma suite de testes ou ler um log de 10.000 linhas dentro de um subagente mantém o output bruto no contexto desse subagente, e apenas o resumo retorna à sua conversa principal.

Pressione Escape no momento em que o Claude seguir uma direção errada. /rewind restaura tanto a conversa quanto o código para um ponto de controlo anterior, para que não gaste recursos a desfazer um trabalho que nunca quis.

Deve comprar créditos de utilização ou usar a API?

Os créditos de utilização permitem que uma conta Pro, Max ou Ultra continue a funcionar após atingir o limite do plano, sendo cobrados às taxas padrão da API. Ative-os em Settings e depois em Usage no claude.ai com um método de pagamento associado, e adicione fundos, pois os créditos são pré-pagos e só cobrem a utilização após a compra. Também pode executar /usage-credits no Claude Code, o que abre as suas definições de faturação no browser. Os créditos aplicam-se às conversas no Claude e à utilização do terminal no Claude Code, e o limite máximo é um teto de gastos mensal que define em Adjust limit, ou que pode remover com Set to unlimited. O comando requer um login de subscrição, pelo que não está disponível quando se autentica com uma API key. No plano gratuito, os créditos não são oferecidos, por isso o primeiro passo é o Pro a $20 por mês, e o que o Pro adiciona e onde os seus limites o impedem detalha até onde isso o leva. Se estiver a carregar créditos quase todas as semanas, um plafond maior é geralmente a opção mais económica. A diferença entre o Max de $100 e o Ultra de $200 reside principalmente no plafond: o Max oferece 5x a utilização do Pro a cada cinco horas e a cada semana, enquanto o Ultra oferece 10x a utilização do Pro a cada semana, sem limite de cinco horas para contas verificadas. Ambos são preços web mensais, com preços variáveis em dispositivos móveis, e ambos os planos oferecem apenas faturação mensal. Incluem também diferentes créditos mensais para a Claude Platform API, $100 no Max e $200 no Ultra, que não aumentam os seus limites no Claude ou no Claude Code. Se paga com um cartão brasileiro, os preços de Pro, Max, Ultra e da API convertidos em reais, já com o IOF de 3,5% mostram quanto cada uma destas opções pesa realmente na sua fatura.

A outra via é uma API key simples da Claude Console, faturada por token sem qualquer sessão ou janela semanal. Uma armadilha comum: uma ANTHROPIC_API_KEY perdida no seu ambiente pode sobrepor-se à sua subscrição. Numa sessão interativa, o Claude Code pergunta uma vez se pretende usar a chave e memoriza a sua resposta, pelo que um "sim" rápido de há meses é fácil de esquecer, e o interruptor Use custom API key em /config reverte essa configuração. Numa execução -p não interativa, o sistema não pergunta nada e usa a chave sempre que esta estiver definida. Descobrirá através da fatura, ou disto:

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

Esse 429 é o limite de taxa (rate limit) da chave, não do seu plano. Execute /status e confirme se a credencial ativa é a que pretendia usar. Quando um login e uma API key estão ambos configurados, /status assinala a que não está em uso.

Quanto custa uma tarde na API?

O exemplo calculado abaixo corresponde a uma tarde de programação com agentes: 200,000 tokens de entrada sem cache, 1.8 milhões de leituras da cache e 150,000 tokens de saída. Os preços são as tarifas públicas da Anthropic em outubro de 2026. Todas essas tarifas são indicadas por milhão de tokens. Se essa unidade ainda parecer abstrata, o valor real de um milhão de tokens converte-a numa quantidade de texto lido e escrito que consegue visualizar.

[
  {
    "label": "Opus 5",
    "input_usd_per_mtok": 5,
    "cache_read_usd_per_mtok": 0.5,
    "output_usd_per_mtok": 25,
    "afternoon_usd": 5.65
  },
  {
    "label": "Sonnet 5",
    "input_usd_per_mtok": 2,
    "cache_read_usd_per_mtok": 0.2,
    "output_usd_per_mtok": 10,
    "afternoon_usd": 2.26
  },
  {
    "label": "Haiku 4.5",
    "input_usd_per_mtok": 1,
    "cache_read_usd_per_mtok": 0.1,
    "output_usd_per_mtok": 5,
    "afternoon_usd": 1.13
  }
]

A mesma tarde custa $5.65 no Opus 5 e $1.13 no Haiku 4.5. A saída é o que mais pesa no total: a $25 por milhão de tokens no Opus 5, contra $5 no Haiku 4.5, os 150,000 tokens escritos pelo Claude custam mais do que os 2 milhões de tokens lidos. É por isso que reduzir o orçamento de raciocínio poupa mais do que reduzir os ficheiros. Se a questão for qual fornecedor pagar, e não qual modelo executar, três tarefas com custos calculados nas APIs Claude e ChatGPT mostram qual das faturas fica mais baixa em cada caso.

Uma data passou sem alteração. O Sonnet 5 foi lançado a $2 e $10 por milhão de tokens de entrada e de saída, com preços introdutórios anunciados até 31 de agosto de 2026. O aumento para $3 e $15 estava previsto para 1 de setembro de 2026. A Anthropic cancelou esse aumento e tornou $2 e $10 nos preços padrão. Por isso, a mesma tarde continua a custar $2.26 no Sonnet 5.

Os modelos mais recentes reduzem novamente o custo da mesma tarde. O Opus 5.5, lançado em 22 de setembro de 2026, tem preços de $4 para a entrada e $20 para a saída. As leituras da cache custam 5% da tarifa de entrada, o que coloca o custo da tarde em $4.16. O Sonnet 5.5 mantém as tarifas de $2 e $10, mas reduz para metade o preço das leituras da cache, para $0.10, ficando em $2.08. O Haiku 5.5 começa em $0.10 e $0.50 e cobra cinco vezes esse valor em qualquer pedido cujo prompt ultrapasse 100,000 tokens. Por isso, o custo total depende do tamanho do contexto.

Para dar uma noção da escala, a documentação da própria Anthropic indica um gasto médio do Claude Code próximo de $13 por programador e por dia ativo em implementações empresariais, e inferior a $30 por dia ativo para 90% dos utilizadores, em outubro de 2026. A cobrança por token não é automaticamente mais barata do que uma subscrição. É vantajosa quando a carga é irregular, porque os dias sem utilização não têm custo, e é menos vantajosa quando trabalha todos os dias. A API comparada com uma subscrição, usando números reais mostra o ponto de equilíbrio.

Executar tarefas longas num VPS durante a noite

Algumas tarefas não exigem a sua supervisão: uma grande refatoração, uma migração de teste ou uma revisão de documentação. Estas tarefas também não precisam da sua janela de subscrição. Coloque-as num VPS (servidor privado virtual) com uma API key e elas serão cobradas por token, enquanto o limite do seu plano permanece intacto para o trabalho interativo de amanhã. Uma sessão na cloud executa o Claude Code nos servidores da Anthropic por padrão, sem que precise de gerir um servidor, mas partilha os limites do seu plano. Por isso, o que os créditos de sessão na cloud cobrem e quando terminam determina se isso realmente mantém a tarefa fora da sua janela.

Instale o Claude Code numa máquina Ubuntu e confirme se funciona:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

O claude --version deve imprimir uma string de versão, como 2.1.211 (Claude Code). Um command not found aqui significa que o ~/.local/bin ainda não está no seu PATH; abra um novo shell e tente novamente. Esse mesmo instalador é o que executaria num desktop Linux, onde a CLI funciona ao lado da aplicação desktop beta e dos plugins do editor.

Coloque a chave num ficheiro em vez de a deixar no histórico do seu shell. Crie o ~/.claude-env num editor com uma linha, export ANTHROPIC_API_KEY=sk-ant-your-key-here, depois restrinja as permissões e carregue-a:

chmod 600 ~/.claude-env
. ~/.claude-env
printenv ANTHROPIC_API_KEY | cut -c1-10

Essa última linha imprime os primeiros dez caracteres, o que é suficiente para confirmar que a variável está definida sem exibir a chave completa no ecrã.

Agora, inicie a tarefa dentro do tmux para que ela sobreviva ao fecho do seu portátil:

tmux new -s overnight
claude --bare -p "Convert every test under ./tests from unittest to pytest, run the suite, and fix what fails" \
  --allowedTools "Read,Edit,Bash" \
  --append-system-prompt-file ./CLAUDE.md \
  --output-format json > ~/overnight.json

Desconecte-se com Ctrl-b seguido de d e feche a ligação. Reconecte-se mais tarde com tmux attach -t overnight. Claude Code numa sessão tmux num VPS cobre a gestão de sessões na íntegra.

O --bare é importante aqui. Ele ignora a descoberta automática de hooks, skills, plugins e do CLAUDE.md, e nunca lê credenciais OAuth, pelo que a execução utiliza apenas a API key. É isso que mantém a tarefa fora da sua subscrição. Também significa que as regras do projeto são ignoradas, razão pela qual o --append-system-prompt-file as fornece deliberadamente. Uma execução com -p utiliza um ANTHROPIC_API_KEY definido sem pedir confirmação; a diferença nota-se quando a chave falha ao carregar: sem --bare, a execução recorre ao login da sua subscrição, enquanto com ele, a execução falha na autenticação e deixa o seu plano intacto.

De manhã, leia o resultado e o custo a partir do JSON:

jq -r '.result' ~/overnight.json
jq -r '.total_cost_usd' ~/overnight.json

O Claude Code termina com código 0 em caso de sucesso e diferente de zero quando a execução falha, pelo que um script wrapper pode ramificar-se com base no estado de saída e enviar-lhe um e-mail em caso de falha. Defina um limite de gastos para o workspace na Claude Console antes de o deixar a correr: um agente num ciclo de repetição às 3 da manhã é uma forma real de gastar dinheiro real. Controlo de custos para agentes que deixa a correr detalha os limites que vale a pena definir primeiro.

Um bónus se estiver nos planos Max, Ultra ou Team. Esses planos incluem agora créditos mensais de API para a Claude Platform: $100 por mês no Max, $200 no Ultra e, no Team, $20 por licença Standard e $100 por licença Premium, agrupados e limitados a $500. O Claude Code interativo não está coberto, mas uma execução claude -p que inicie manualmente com uma API key da sua organização ligada na Console está, pelo que esta tarefa pode consumir esses créditos. Os créditos não utilizados expiram no final de cada ciclo de faturação e, uma vez gastos, os pedidos de API da organização param até que os créditos do mês seguinte cheguem, a menos que a conta também possua créditos comprados. Se a tarefa tiver de terminar, mantenha alguns créditos comprados na Console como reserva, ou ela parará com Credit balance is too low.

Dê à tarefa o seu próprio utilizador sem privilégios e a sua própria branch de git. Um agente a editar um repositório sem supervisão fará ocasionalmente algo que você teria impedido, e uma branch torna isso um git checkout em vez de um incidente. Executar um agente de programação em segurança num VPS cobre o isolamento.

Para trabalho em massa que não é de todo interativo, como classificar milhares de registos, a Batch API processa pedidos de forma assíncrona com um desconto de 50% tanto nos tokens de entrada como nos de saída. A maioria dos lotes termina dentro de uma hora, mas o processamento pode demorar até 24 horas.

O que não restaura o seu acesso

Além de fazer um upgrade, duas coisas devolvem a sua cota: o tempo e um reset de limite, caso a Anthropic tenha disponibilizado um para si. Os resets de limite são distribuídos ocasionalmente para planos elegíveis, e utilizar um deles restaura imediatamente o seu limite de sessão de cinco horas ou o seu limite semanal, dependendo da oferta. Não é necessário esperar até atingir o limite para o utilizar. Procure por "Reset for free" na secção "Resets" dentro de "Settings" e depois em "Usage" na web ou no Claude Desktop, ou na própria mensagem de limite. O botão não aparece no Claude Code no terminal, mas o reset ainda se aplica lá, pois os limites são partilhados.

Iniciar uma nova conversa não restaura a sua cota. A utilização é contabilizada na sua conta, não na conversa. Iniciar uma nova conversa torna cada mensagem subsequente mais barata, pois uma conversa nova não carrega histórico para ser reprocessado, por isso ainda vale a pena fazê-lo. É uma redução de custos, não um reset.

Apagar conversas antigas não reembolsa nada. Esses tokens foram gastos quando foram processados.

Nos planos Pro, Max e Ultra, mudar de modelo após uma sessão ou após atingir o limite geral de mensagens semanais não restaura a cota partilhada. Uma mensagem que especifica um modelo responde a /model, e utilizadores com licenças Enterprise também podem tentar um modelo mais leve após atingirem um limite de utilização.

Tentar novamente em loop não faz nada além de manter o seu terminal ocupado. O tempo de reset indicado na mensagem é a resposta real, e /usage mostrará o mesmo relógio sem o erro. Numa subscrição, o Claude Code 2.1.234 ou posterior pode aguardar na sessão aberta e continuar a tarefa interrompida logo após o reset, para que não precise de ficar a monitorizar.

Fazer um upgrade é a única ação que aumenta o teto de utilização; portanto, se as barras de limite permanecerem inalteradas após o pagamento, analise os motivos pelos quais um novo plano pode manter os limites antigos antes de assumir que a cota está com problemas.

FAQ

Quanto tempo falta para o meu limite do Claude ser reiniciado?

A mensagem informa-o. Os limites de sessão funcionam numa janela móvel de cinco horas e a mensagem apresenta uma hora, como resets 3:45pm. Os limites semanais são reiniciados a uma hora fixa todas as semanas, atribuída à sua conta, e a mensagem apresenta o dia, como resets Mon 12:00am. Para ver as barras e os tempos de reinício aplicáveis ao seu plano antes de atingir qualquer limite, execute /usage no Claude Code ou abra Settings e depois Usage em claude.ai. Contas Ultra verificadas não têm limite de sessão de cinco horas. Se a Anthropic tiver efetuado um reinício de limite na sua conta, essa mesma página apresenta um botão Reset for free que repõe a janela para o estado completo imediatamente.

Mudar para o Sonnet permite-me voltar a trabalhar?

Sim, quando a mensagem menciona um modelo, e a Anthropic também recomenda experimentar um modelo mais leve para utilizadores com licenças Enterprise que atingem um limite de utilização. Após You've hit your Opus limit, execute /model, escolha um modelo diferente e a sessão continua com o seu contexto intacto. Nos planos Pro, Max e Ultra, após You've hit your session limit ou You've hit your weekly limit, mudar de modelo não restaura a quota partilhada. Mudar para um modelo mais barato antes de atingir o limite é o que efetivamente prolonga a janela.

Iniciar uma nova conversa reinicia o meu limite de utilização?

Não. A utilização é contabilizada na sua conta, portanto, uma nova conversa inicia-se com a mesma quota esgotada. Torna cada mensagem seguinte mais barata, porque uma nova conversa não transporta histórico para o Claude voltar a ler. /clear no Claude Code faz o mesmo e não tem custo, enquanto /compact tem de ler a conversa que resume, pelo que compactar uma sessão muito grande é, por si só, um pedido dispendioso.

A API é mais barata do que atualizar o meu plano?

Depende da regularidade da sua utilização. A tarde de trabalho nesta página custa $2.26 no Sonnet 5 e $1.13 no Haiku 4.5, de acordo com as tabelas de preços de outubro de 2026. Uma subscrição é uma taxa fixa por uma quota limitada, por isso compensa quando trabalha na maioria dos dias. A faturação por token compensa quando a sua carga é irregular, porque os dias de pouca atividade não lhe custam nada.

Posso manter um trabalho a correr enquanto espero pelo reinício?

Sim, se o retirar da sua subscrição. Execute-o num VPS com ANTHROPIC_API_KEY definido no ambiente e a faturação será feita por token em vez de consumir a janela do seu plano, pelo que os dois nunca competem. claude --bare -p dentro do tmux sobrevive ao fecho do seu portátil, e --output-format json escreve um campo total_cost_usd que pode verificar de manhã com jq.