Source: https://aiprimetech.io/pt/claude-code/errors/api-error-500/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › [Erros](/pt/claude-code/errors/) › Erro 500 de API

[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

# "Erro de API: 500" no Claude Code: o que significa e o que realmente resolve

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} é uma falha na resposta do modelo no lado da API. É o erro mais relatado na história do Claude Code — uma busca por "Erro de API: 500" no rastreador de issues de anthropics/claude-code retorna 881 issues, e novas continuam sendo abertas toda semana. Quase nunca é culpa sua; quase sempre é possível resolver em menos de um minuto.

## TLDR
- 500 = a API falhou internamente. Sua chave, seu prompt e sua configuração estão corretos.
- Verifique status.claude.com primeiro — durante incidentes, centenas de pessoas encontram esse erro ao mesmo tempo.
- Retome com claude -c; se ocorrer novamente, /model para outro nível de modelo (erros 500 costumam ser específicos de um modelo).
- Um erro 500 no momento em que o contexto atinge 0% significa que a compactação falhou: /compact ou /clear, depois continue.

## As mensagens exatas 

```
API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}}
API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"},"request_id":null}
[Bug] Anthropic API Error: 500 Internal Server Error
```

As três correspondem à mesma falha. As duas primeiras são exibidas pela CLI; a terceira é o título dos relatórios de bug gerados automaticamente que o Claude Code envia por meio de /bug, motivo pelo qual o rastreador tem centenas de relatórios idênticos — os mais recentes deste lote foram enviados em [setembro de 16](https://github.com/anthropics/claude-code/issues/94876) e [22 de setembro de 2026](https://github.com/anthropics/claude-code/issues/95950), sendo que o último relata erros 500 e 529 juntos. 

## Por que isso acontece 
- Incidente no provedor. De longe, a causa mais comum. Quando a Anthropic sofre uma indisponibilidade parcial, todos os usuários de um modelo veem erros 500 ao mesmo tempo — a onda de janeiro de 2026 em [#9066](https://github.com/anthropics/claude-code/issues/9066) recebeu uma resposta da equipe da Anthropic com um único link: a página de status.
- Um modelo com desempenho degradado, os outros funcionando normalmente. Os erros 500 frequentemente afetam apenas um modelo. Em [#3127](https://github.com/anthropics/claude-code/issues/3127) a solução mais votada foi simplesmente mudar do Opus para o Sonnet; a mesma sessão passou a funcionar.
- Contexto esgotado, falha na compactação. O relato original #3127 encontrou o 500 "quando o contexto restante está exatamente em 0% e o Claude Code não conseguiu compactá-lo automaticamente". Uma solicitação grande demais pode aparecer como um 500 em vez do mais claro Prompt is too long 400.
- Um formato específico de solicitação que o backend não consegue processar. Mais raro; [#91801](https://github.com/anthropics/claude-code/issues/91801) erros 500 reproduzidos e associados a determinados prefixos de prompt. Se uma mensagem sempre gera um erro 500 e outras não, altere essa mensagem. 

## Correções, na ordem em que devem ser tentadas 
- 1. Consulte status.claude.com. Se houver um incidente, nada do seu lado ajudará — aguarde a resolução.
- 2. Retome, não reinicie: claude -c continua a última sessão; a interação inacabada é tentada novamente.
- 3. Troque o nível do modelo para a tarefa atual: /model → Sonnet se você estava usando Opus/Fable, ou o contrário. A capacidade e as falhas variam por modelo.
- 4. Se o indicador de contexto estava perto de 0%: /compact (ou /clear e forneça novamente as instruções), depois continue. Mudar para uma (1M) variante do modelo também funciona.
- 5. Atualize: claude update. Vários bugs relacionados a 500 foram corrigidos no cliente ao longo do tempo.
- 6. Ainda falha em uma mensagem específica? Reformule ou divida a mensagem — um 500 causado pelo formato da solicitação é determinístico. 

```
claude -c              # resume the session
/model claude-sonnet-5 # inside the session: another tier
/compact               # if the context was exhausted
claude update          # latest CLI
```

## 500 vs 529 vs 429 
- 500 — o servidor falhou. Tente novamente, troque de modelo e verifique o status.
- 529 — o servidor está funcionando, mas no limite da capacidade (overloaded_error). Consulte o [guia sobre sobrecarga](/pt/claude-code/errors/overloaded-529/).
- 429 — *você* excedeu um limite. Consulte [limites de taxa](/pt/claude-code/rate-limits/).
- 400 — a própria solicitação foi rejeitada. Consulte [Erro de API 400](/pt/claude-code/errors/api-error-400/). 

## Por que os gateways recebem menos desses erros 

Um 500 de uma conta do provedor upstream só é um ponto único de falha se você tiver apenas uma conta upstream. Este gateway reúne várias contas e redireciona a solicitação para outra quando uma retorna 500 ou 529, de modo que a maioria dos erros 500 transitórios nunca chega ao seu terminal. Um incidente real que afete todo o provedor ainda chega — ninguém consegue contornar a indisponibilidade do modelo. Configure o Claude Code para usá-lo com ANTHROPIC_BASE_URL=https://aiprimetech.io e uma chave do gateway.

## 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

O que significa o erro de API 500 do Claude Code?

A API do Claude falhou internamente ao responder ({"type":"api_error","message":"Internal server error"}). É um erro do servidor, não um problema com sua chave ou configuração.Como corrigir o erro de API: 500 no Claude Code?

Verifique status.claude.com, retome com claude -c, troque o nível do modelo com /model e use /compact se o contexto estava quase cheio. Atualize com claude update se o problema persistir.Por que continuo recebendo erros 500 do Claude?

Geralmente, há um incidente em andamento no provedor upstream ou um modelo com desempenho degradado. Se apenas uma mensagem causa o erro todas as vezes, o problema é a própria solicitação — reformule-a ou divida-a.O Claude está fora do ar quando recebo o erro 500?

Muitas vezes, sim — pelo menos um modelo está. Tanto a página de status quanto o rastreador de problemas do GitHub registram atividade em poucos minutos durante um incidente.

## 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

[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[Erro "Sobrecarregado" no Claude (erro 529 de API): o que significa e o que fazer](/pt/claude-code/errors/overloaded-529/)[Erro 400 da API do Claude Code: prompt longo demais, concorrência no uso de ferramentas e os demais](/pt/claude-code/errors/api-error-400/)[Erros de OAuth no Claude Code: tempo limite de 15000ms excedido e código de status 500](/pt/claude-code/errors/oauth-error/)["O processo do Claude Code foi encerrado com o código 1": como encontrar o erro real e corrigi-lo](/pt/claude-code/errors/process-exited-code-1/)["O prompt é longo demais", "A entrada é longa demais para o modelo solicitado" e "Limite de contexto atingido" no Claude: o que preenche a janela e como liberar espaço](/pt/claude-code/errors/prompt-too-long/)[Limite de uso do Claude atingido: limites de sessão, semanais e do Opus, "limites especificados de uso da API", "o saldo de créditos é insuficiente" — e o que fazer](/pt/claude-code/errors/usage-limit-reached/)[Erros 401 e 403 no Claude Code: credenciais de autenticação inválidas, chave de API inválida, "Você não está conectado", host_not_allowed](/pt/claude-code/errors/auth-401-403/)[Erros de conexão no Claude Code: ECONNRESET, conexão perdida durante a resposta, "Aguardando resposta da API", "Não foi possível conectar à API", erros de certificado SSL](/pt/claude-code/errors/connection-lost/)[O Claude Code trava, fica preso ou para de responder: como descobrir onde travou e sair dessa situação](/pt/claude-code/errors/claude-code-hangs/)[Claude.ai não funciona: "Algo deu errado", restrições de capacidade, "limite de 5 horas atingido", "erro ao fazer login" e os demais](/pt/claude-code/errors/claude-ai-not-working/)