Quando o Claude Code exibir «limite atingido», comece identificando o limite: assinatura, taxa da API, limite de gastos ou problema da conta. A solução correta pode ser esperar uma redefinição, ativar créditos oficiais, reduzir as chamadas simultâneas ou corrigir uma chave. Comprar outro plano antes desse diagnóstico pode deixar o problema intacto.
Que mensagem você vê?
| Sintoma | Verificação | Ação adequada |
|---|---|---|
| Cota do plano atingida, com horário de retomada exibido | Conta do Claude e página de uso | Esperar, comparar outro plano ou os créditos de uso |
| API 429 com indicação de taxa | Mensagem, solicitações simultâneas e cabeçalho de retomada | Reduzir a velocidade e respeitar o prazo informado |
| Limite de gastos ou pagamento recusado | Saldo, limites da conta e faturamento | Corrigir o limite ou o pagamento em questão |
| API 401 ou 403 | Chave, domínio de destino e permissões | Corrigir a identificação ou a autorização |
| Conversa longa demais | Tamanho do contexto e mensagem exata | Resumir o trabalho e reduzir o contexto útil |
Os códigos abaixo descrevem a API da Anthropic. Se o Claude Code passar por outro provedor, consulte também a documentação dele: um intermediário pode apresentar suas próprias mensagens e limites.
1. Se você usa uma assinatura do Claude
Abra as configurações de uso da conta conectada. Anote a cota em questão e o horário indicado, em vez de deduzir uma duração universal a partir de uma mensagem encontrada em outro lugar. Verifique também se o Claude Code está usando a conta esperada.
A Anthropic distingue os limites de uso e de comprimento. O uso do Claude e do Claude Code pode compartilhar a mesma alocação da conta. Portanto, abrir uma nova janela ou uma nova conversa não cria uma cota adicional. Por outro lado, reduzir um contexto que ficou volumoso pode diminuir o trabalho solicitado ao modelo nas chamadas seguintes.
Para continuar após a alocação incluída, os planos pessoais elegíveis dispõem de créditos de uso oficiais. Eles são cobrados separadamente, às taxas padrão da API. Nas configurações de uso, verifique a ativação, os fundos disponíveis e o limite de gastos. É uma opção a ser comparada com esperar, mudar de plano ou usar uma conta de API separada.
2. Se a API retornar 429
Consulte o texto do erro e os limites da API. Para um limite de taxa, reduza as tarefas simultâneas e respeite o prazo retry-after quando presente. Repetir imediatamente várias execuções de agentes pode manter o mesmo bloqueio.
Um 429 também pode corresponder ao limite mensal do nível da API ou a certos limites de gastos do espaço do Claude Code. Um limite mensal pode não fornecer um prazo de retomada. Nesse caso, verifique o faturamento e o limite associado à conta; um loop de tentativas não os aumenta. A ausência de um cabeçalho, por si só, não basta para concluir: leia também a mensagem.
3. Se o problema envolver saldo ou autenticação
A referência de erros da Anthropic distingue, entre outros, 401 para autenticação, 403 para permissões e 402 para faturamento. Alguns limites de gastos também podem aparecer com o código 400. Portanto, o código HTTP sozinho não substitui os detalhes do erro.
Verifique o domínio para o qual a solicitação é enviada e a conta que criou a chave. Uma assinatura do Claude, um saldo do Console e um saldo em um provedor terceirizado não são intercambiáveis. Uma recarga em um provedor não financia automaticamente os outros. Após a correção, use uma pequena solicitação para confirmar qual conta será debitada antes de retomar uma tarefa importante.
4. Continuar com um faturamento de API separado
A documentação dos gateways esclarece que um identificador de gateway ativo substitui a identidade da assinatura na sessão. Definir apenas o endereço-base não realiza essa mudança: a conexão registrada pode continuar ativa. Portanto, configure juntos o endereço, o identificador e o modelo esperados.
O guia de preços e configuração do Claude Code explica a opção via Kunavo em francês. O catálogo exibe atualmente Claude Sonnet 4.6 a $2.10 para entrada e $10.50 para saída por milhão de tokens. O guia de preços da API Claude detalha as unidades a serem comparadas. Uma tarefa pode conter várias chamadas; seu custo também depende do contexto, do cache e das novas tentativas.
Se essa separação for adequada para você, crie sua conta do Kunavo, configure uma chave e verifique a primeira chamada no seu histórico de uso. Essa conta tem suas próprias restrições; ela não transforma o Claude Code em um serviço ilimitado.
Preparar uma solicitação de ajuda útil
Se o bloqueio persistir, mantenha as informações a seguir. Elas ajudam a distinguir um problema de configuração de um limite aplicado à conta correta, sem publicar sua chave secreta:
Interface et version de Claude Code :
Compte utilisé : abonnement / Console / fournisseur tiers
Modèle et nom de domaine de l'API :
Message exact et code HTTP éventuel :
Heure de réinitialisation affichée :
En-tête retry-after, s'il existe :
Identifiant de requête, s'il existe :Mantenha também seu trabalho local e o estado da tarefa. Depois que o acesso for restabelecido, peça ao agente para verificar os arquivos já modificados antes de recomeçar, a fim de evitar repetir etapas concluídas ou perder o contexto da sua correção.
Perguntas frequentes
O que fazer quando o Claude Code exibe «limite atingido»?
Primeiro, identifique a conta que fornece as respostas. Para uma assinatura, consulte o horário de redefinição e as opções de créditos de uso. Para uma API, leia a mensagem completa: taxa, limite de gastos, faturamento e autenticação exigem correções diferentes.
Um código 429 sempre significa que é preciso esperar?
Não. A API do Claude também usa 429 para certos limites de gastos. Um excesso de taxa pode exigir espera e menos solicitações simultâneas; um limite financeiro exige verificar os limites e o faturamento da conta. A mensagem e os cabeçalhos permitem escolher o caminho correto.
Uma nova conversa redefine minha cota?
Não. Uma nova conversa pode reduzir o contexto transmitido, mas não redefine a alocação da conta. O limite de comprimento de uma conversa e o limite de uso da sua assinatura são duas restrições distintas.
Uma chave do Kunavo remove todos os limites?
Não. Uma configuração de API com uma chave do Kunavo usa uma conta e um faturamento separados da assinatura do Claude. Ela continua sujeita ao saldo, aos limites e aos modelos disponíveis no Kunavo. Alterar apenas o endereço-base sem configurar o identificador correto não basta para mudar o faturamento.
Fontes oficiais verificadas em 17 de setembro de 2026.