Source: https://aiprimetech.io/pt/claude-code/errors/ [Início](/pt/) › [Claude Code](/pt/claude-code/) › Erros [Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/) Última atualização: 11 de outubro de 2026 # Erros do Claude Code e como corrigi-los O Claude Code exibe erros de API com o status HTTP na mensagem, então o número já explica boa parte do problema. Veja o que cada um significa no contexto de uma sessão de agente e a solução que realmente funciona. ## TLDR - 500 / 529 — o serviço do modelo está falhando ou saturado; tente novamente com intervalos progressivos ou troque de modelo. Não há nada a corrigir na sua configuração. - 400 — geralmente, o contexto está longo demais para o modelo; use /compact ou /clear, ou mude para uma variante com contexto de 1M. - 429 — limite de requisições; os fluxos paralelos do Claude Code atingem primeiro o limite de simultaneidade. - 401 — chave incorreta para o endpoint; uma chave do console usada com uma URL de gateway, ou vice-versa. - Limite de uso / limite semanal — uma janela de assinatura, não um erro de API; ela é redefinida automaticamente, e o acesso via API não tem essa janela. ## Guias detalhados para cada erro - [Erro de API: 500 (Erro interno do servidor)](/pt/claude-code/errors/api-error-500/) — indisponibilidade, falhas específicas de modelos, compactação em 0%. - [Sobrecarga / Erro de API 529](/pt/claude-code/errors/overloaded-529/) — capacidade, novas tentativas, picos de subagentes. - [Erro de API 400](/pt/claude-code/errors/api-error-400/) — prompt longo demais, simultaneidade no uso de ferramentas e outras solicitações rejeitadas. - [Erros de OAuth](/pt/claude-code/errors/oauth-error/) — tempo limite de 15000ms excedido, código de status 500 no login. - [Processo encerrado com código 1](/pt/claude-code/errors/process-exited-code-1/) — falhas na extensão do VS Code e no aplicativo para desktop. - [Limite de requisições atingido / 429](/pt/claude-code/rate-limits/) — os três limites e como aumentá-los. - [Prompt longo demais / limite de contexto atingido](/pt/claude-code/errors/prompt-too-long/) — o que preenche a janela, falsos alarmes, falhas de compactação, limites de comprimento de claude.ai. - [Limite de uso atingido](/pt/claude-code/errors/usage-limit-reached/) — janelas de sessão, semanais e do Opus, "limites de uso da API especificados", "saldo de créditos insuficiente". - [Autenticação 401 / 403](/pt/claude-code/errors/auth-401-403/) — credenciais inválidas, chave de API inválida, "Login não realizado", host_not_allowed. - [Erros de conexão](/pt/claude-code/errors/connection-lost/) — ECONNRESET, "Aguardando resposta da API", certificados, proxies, variáveis de novas tentativas. - [Travamentos, bloqueios, falta de resposta](/pt/claude-code/errors/claude-code-hangs/) — onde está travado, teclas para sair, bugs conhecidos de travamento, memória. - [claude.ai não funciona](/pt/claude-code/errors/claude-ai-not-working/) — "Algo deu errado", restrições de capacidade, limite de 5 horas, erros de login. ## Erro de API 500 (e 529 de sobrecarga) Um 500 é uma falha no serviço upstream; 529 é o código explícito da Anthropic para "modelo no limite da capacidade". Nenhum dos dois é causado pelo seu prompt. O Claude Code tenta novamente algumas vezes por conta própria; se desistir, espere um minuto e retome com claude -c. Mudar de categoria com /model costuma funcionar imediatamente porque a capacidade é definida por modelo. Neste gateway, uma conta upstream saturada é substituída automaticamente por outra, por isso os erros 529 são mais raros aqui do que ao usar uma única conta. ## Erro de API 400 — solicitação inválida / contexto longo demais No Claude Code, um 400 quase sempre significa que a conversa, somada aos arquivos que ele leu, já não cabe na janela do modelo. /compact resume o histórico; /clear começa do zero; ou mude para uma (1M) variante do modelo. Outros erros 400: um parâmetro não compatível após uma atualização (execute claude update), ou uma imagem ou arquivo que o modelo não aceita. ## Erro de API 429 — limite de requisições / taxa excedida Aplicam-se três limites: requisições por minuto, tokens por minuto e requisições simultâneas. As sessões com agentes atingem primeiro o limite de simultaneidade — cada subagente é uma requisição paralela em streaming que ocupa uma vaga até terminar. Reduza o paralelismo, aguarde o intervalo de retry-after e, para trabalho contínuo, solicite um limite maior de simultaneidade na sua conta do gateway. ## Erro de OAuth: tempo limite de 15000ms excedido O fluxo de /login não conseguiu acessar o serviço de autenticação da Anthropic em 15 segundos. É um problema de rede, não de conta: um proxy corporativo, uma VPN que interrompe o callback ou uma região onde o endpoint de autenticação é lento. Tente novamente uma vez; se persistir, configure HTTPS_PROXY para sua rede ou dispense completamente o OAuth usando uma chave de API — com ANTHROPIC_API_KEY (e ANTHROPIC_BASE_URL para um gateway), o Claude Code nem sequer abre o fluxo de login. ## Erro de OAuth: solicitação falhou com código de status 500 O serviço de autenticação respondeu com um erro de servidor durante o login ou a renovação do token. Nada do seu lado causa isso; espere alguns minutos e execute /login novamente. Se precisar trabalhar agora, o acesso por chave de API descrito acima dispensa o OAuth, e claude setup-token em uma máquina onde o login funciona gera um token de longa duração que você pode transferir para aquela onde ele não funciona. ## Erro: processo do Claude Code encerrado com código 1 Isso é a extensão do IDE ou o aplicativo para desktop informando que a CLI iniciada por ele falhou na inicialização — o erro real está um nível abaixo. Abra um terminal e execute claude diretamente: você verá a mensagem real, que quase sempre indica uma versão do Node.js inferior a 18, um PATH danificado após uma instalação via npm, uma instalação nativa corrompida ou um settings.json com JSON inválido (uma vírgula fora de lugar em um bloco de hooks é um caso clássico). claude doctor verifica os três primeiros; um linter de JSON detecta o quarto. Reinstalar com o instalador nativo resolve a maioria dos demais problemas. ## 401 / erros de autenticação invalid x-api-key ou authentication_error significa que a chave não pertence ao endpoint. Se ANTHROPIC_BASE_URL aponta para o gateway, a chave deve ser uma chave de gateway; uma chave do console da Anthropic será recusada, e o inverso também se aplica. /status mostra qual endpoint e qual chave estão ativos. Se você usa /login e uma chave de API ao mesmo tempo, a chave tem prioridade. Loops de renovação de token, Not logged in após um login bem-sucedido e erros 403 de proxies estão na [página de 401 / 403](/pt/claude-code/errors/auth-401-403/). ## "Nenhum upstream saudável" Não é um erro de API: é o balanceador de carga à frente de um serviço informando que nenhum backend está disponível. No endpoint oficial, significa uma indisponibilidade; em um gateway, significa que todo o conjunto de upstreams está indisponível ou com o tráfego limitado. Aguarde e tente novamente; não altere sua configuração. ## Claude Code não funciona de jeito nenhum - Inicia e depois encerra silenciosamente → execute claude /doctor; geralmente é um problema de versão do Node ou de PATH. - Trava na inicialização ou durante a sessão → veja [travamentos e sessões bloqueadas](/pt/claude-code/errors/claude-code-hangs/) e [erros de conexão](/pt/claude-code/errors/connection-lost/). - command not found → veja o guia de instalação. - Ferramentas falham com erros de permissão → /permissions, ou --allowedTools em scripts. ## Cansado de lidar com esse problema? Execute o Claude Code pelo gateway da AI Prime Tech: os mesmos modelos Claude nas contas upstream do próprio gateway, duas variáveis de ambiente para fazer a mudança, e novas contas recebem $5 em crédito gratuito para a API com o código FIXIT — sem cartão. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crie uma conta com o código FIXIT](/register?promo=FIXIT) ## Perguntas frequentes Por que o Claude Code continua retornando o erro de API 500? O backend do modelo está falhando ou sobrecarregado (529 é a forma explícita). Tente novamente após uma pausa, mude de categoria com /model ou retome com claude -c. O problema não está na sua configuração.Como corrigir o erro 400 de comprimento de contexto no Claude Code? Execute /compact para resumir a sessão, /clear para reiniciar ou mude para uma variante de modelo com contexto de 1M.Por que o Claude Code diz que a chave de API é inválida? A chave não corresponde ao endpoint em ANTHROPIC_BASE_URL. A URL do gateway exige uma chave do gateway; a URL da Anthropic exige uma chave do console. ## Execute o Claude Code no gateway Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código FIXIT.[Obter uma chave de API](/register?promo=FIXIT) [Ver planos ilimitados](/pt/plans/) A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway. ## Mais guias do Claude Code [Claude Code: o guia completo](/pt/claude-code/)[Como instalar o Claude Code](/pt/claude-code/install/)[Documentação da CLI do Claude Code: comandos e flags](/pt/claude-code/cli/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[O SDK do Claude Code, agora Claude Agent SDK](/pt/claude-code/sdk/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Tutorial do Claude Code: sua primeira sessão real](/pt/claude-code/tutorial/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes](/pt/claude-code/subagents/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais](/pt/claude-code/mcp/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Claude Code no VS Code: a extensão, o uso pelo terminal e os erros](/pt/claude-code/vscode/)[Como usar o OpenRouter no Claude Code (e quando não usar)](/pt/claude-code/openrouter/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)