Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Esta página lista os erros de tempo de execução que o Claude Code exibe e como se recuperar de cada um, além do que verificar quando as respostas parecem incorretas sem um erro. Para erros de instalação como command not found ou falhas de TLS durante a configuração, consulte Troubleshooting installation and login. Esses erros e comandos de recuperação se aplicam em toda a CLI, no aplicativo Desktop e no Claude Code na web, já que todos os três envolvem a mesma CLI do Claude Code. Para problemas específicos da superfície, consulte a seção de solução de problemas na página dessa superfície.
O Claude Code chama a API Claude para respostas do modelo, portanto, a maioria dos erros de tempo de execução mapeia para um código de erro de API subjacente. Esta página cobre o que cada erro significa dentro do Claude Code e como se recuperar. Para as definições de código de status HTTP bruto, consulte a referência de erro da plataforma Claude.

​
Encontre seu erro

Corresponda a mensagem que você vê em seu terminal a uma seção abaixo.
MensagemSeção
API Error: 500 ... Internal server errorErros de servidor
API Error: Repeated 529 Overloaded errorsErros de servidor
Request timed outErros de servidor, ou Rede se a mensagem mencionar sua conexão com a internet
<model> is temporarily unavailable, so auto mode cannot determine the safety of...Erros de servidor
Auto mode could not evaluate this action and is blocking it for safetyErros de servidor
Auto mode classifier transcript exceeded context windowErros de servidor
You've hit your session limit / You've hit your weekly limitLimites de uso
Server is temporarily limiting requestsLimites de uso
Request rejected (429)Limites de uso
Credit balance is too lowLimites de uso
Not logged in · Please run /loginAutenticação
Invalid API keyAutenticação
This organization has been disabledAutenticação
Your organization has disabled Claude subscription accessAutenticação
Routines are disabled by your organization's policyAutenticação
OAuth token revoked / OAuth token has expiredAutenticação
does not meet scope requirement user:profileAutenticação
Unable to connect to APIRede
SSL certificate verification failedRede
403 with x-deny-reason: host_not_allowed in a cloud or routine sessionRede
Prompt is too longErros de solicitação
Error during compaction: Conversation too longErros de solicitação
Request too largeErros de solicitação
Image was too largeErros de solicitação
PDF too large / PDF is password protectedErros de solicitação
Extra inputs are not permittedErros de solicitação
There's an issue with the selected modelErros de solicitação
Claude Opus is not available with the Claude Pro planErros de solicitação
thinking.type.enabled is not supported for this modelErros de solicitação
max_tokens must be greater than thinking.budget_tokensErros de solicitação
API Error: 400 due to tool use concurrency issuesErros de solicitação
Claude Code is unable to respond to this request, which appears to violate our Usage PolicyErros de solicitação
Respostas parecem de qualidade inferior ao normalQualidade de resposta

​
Tentativas automáticas

O Claude Code tenta novamente falhas transitórias antes de mostrar um erro. Erros de servidor, respostas sobrecarregadas, tempos limite de solicitação, throttles 429 temporários e conexões perdidas são todos repetidos até 10 vezes com backoff exponencial. Enquanto tenta novamente, o spinner mostra uma contagem regressiva Retrying in Ns · attempt x/y. Quando você vê um dos erros nesta página, essas tentativas já foram esgotadas. Você pode ajustar o comportamento com duas variáveis de ambiente:
VariávelPadrãoEfeito
CLAUDE_CODE_MAX_RETRIES10Número de tentativas de repetição. Reduza-o para expor falhas mais rapidamente em scripts; aumente-o para aguardar incidentes mais longos.
API_TIMEOUT_MS600000Tempo limite por solicitação em milissegundos. Aumente-o para redes lentas ou proxies.

​
Erros de servidor

Esses erros vêm da infraestrutura Anthropic em vez de sua conta ou solicitação.

​
API Error: 500 Internal server error

O Claude Code mostra o corpo da resposta bruta da API para qualquer status 5xx. O exemplo abaixo mostra uma resposta 500: 
API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} · check status.claude.com
Isso indica uma falha inesperada dentro da API. Não é causado pelo seu prompt, configurações ou conta. O que fazer:
  • Verifique status.claude.com para incidentes ativos
  • Aguarde um minuto e envie sua mensagem novamente. Sua mensagem original ainda está na conversa, portanto, para um prompt longo você pode digitar try again em vez de colar tudo novamente.
  • Se o erro persistir sem incidente postado, execute /feedback para que a Anthropic possa investigar com os detalhes da sua solicitação. Consulte Relatar um erro se /feedback não estiver disponível no seu ambiente.

​
API Error: Repeated 529 Overloaded errors

A API está temporariamente em capacidade máxima em todos os usuários. O Claude Code já tentou novamente várias vezes antes de mostrar esta mensagem: 
API Error: Repeated 529 Overloaded errors · check status.claude.com
Um 529 não é seu limite de uso e não conta contra sua cota. O que fazer:
  • Verifique status.claude.com para avisos de capacidade
  • Tente novamente em alguns minutos
  • Execute /model e mude para um modelo diferente para continuar trabalhando, já que a capacidade é rastreada por modelo. O Claude Code o solicita fazer isso quando um modelo está sob carga particularmente alta, por exemplo Opus is experiencing high load, please use /model to switch to Sonnet.

​
Request timed out

A API não respondeu antes do prazo de conexão. 
Request timed out
Isso pode acontecer durante períodos de alta carga ou quando uma resposta muito grande está sendo gerada. O tempo limite padrão de solicitação é de 10 minutos. O que fazer:
  • Tente novamente a solicitação
  • Para tarefas de longa duração, divida o trabalho em prompts menores
  • Se uma rede lenta ou proxy for a causa, aumente API_TIMEOUT_MS conforme descrito em Tentativas automáticas
  • Se os tempos limite forem frequentes e sua rede estiver saudável, consulte Erros de rede e conexão abaixo

​
Auto mode cannot determine the safety of an action

O modelo que modo automático usa para classificar ações não conseguiu produzir uma decisão, portanto, o modo automático não aprovou a ação automaticamente. A mensagem que você vê depende do motivo pelo qual o classificador falhou. Leituras, buscas e edições dentro do seu diretório de trabalho ignoram o classificador, portanto, continuam funcionando em todos esses casos. Quando o modelo classificador está sobrecarregado: 
<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.
O que fazer:
  • Tente novamente após alguns segundos; Claude vê a mesma mensagem e geralmente tenta novamente por conta própria
  • Se as tentativas continuarem falhando, continue com tarefas somente leitura e volte à ação bloqueada mais tarde
  • Isso é transitório e não relacionado à elegibilidade do modo automático; você não precisa alterar as configurações
Quando o classificador retornou uma resposta não analisável: 
Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details
O que fazer:
  • Tente novamente a ação; isso geralmente funciona na próxima tentativa
  • Execute claude --debug e repita a ação para ver a resposta do classificador subjacente no log de depuração
Quando a conversa cresceu além da janela de contexto do classificador: 
Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
Em uma sessão interativa, o modo automático volta a um prompt de permissão normal para essa ação para que você possa aprová-la ou negá-la manualmente. Em modo não interativo a execução é abortada porque a transcrição apenas cresce e tentar novamente não pode ter sucesso. O que fazer:
  • Aprove ou negue a ação no prompt que aparece
  • Execute /compact para reduzir o tamanho da conversa para que as ações subsequentes se encaixem novamente na janela do classificador

​
Limites de uso

Esses erros significam que uma cota vinculada à sua conta ou plano foi atingida. Eles são distintos dos erros de servidor, que afetam todos.

​
Você atingiu seu limite de sessão

Os planos de assinatura incluem uma permissão de uso contínua. Quando acaba, você vê uma dessas mensagens: 
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
Claude Code bloqueia solicitações adicionais até o tempo de reset mostrado na mensagem. O que fazer:
  • Aguarde o tempo de reset mostrado no erro
  • Execute /usage para ver seus limites de plano e quando eles são redefinidos
  • Execute /usage-credits para comprar uso adicional em Pro e Max, ou para solicitá-lo ao seu administrador em Team e Enterprise. Consulte usage credits for paid plans para saber como isso é cobrado.
  • Para atualizar seu plano para limites de base mais altos, consulte claude.com/pricing
Para monitorar sua permissão restante antes de atingir o limite, adicione os campos rate_limits a uma linha de status personalizada, ou no aplicativo Desktop clique no anel de uso ao lado do seletor de modelo.

​
O servidor está limitando temporariamente as solicitações

A API aplicou um throttle de curta duração que não está relacionado à sua cota de plano. 
API Error: Server is temporarily limiting requests (not your usage limit)
Isso é repetido automaticamente antes de ser mostrado. O que fazer:

​
Solicitação rejeitada (429)

Você atingiu o limite de taxa configurado para sua chave de API, projeto Amazon Bedrock ou projeto Google Vertex AI. 
API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check status.claude.com.
A frase final indica onde verificar a saúde do serviço e varia por provedor. As configurações Bedrock e Vertex AI nomeiam o status do serviço desse provedor em vez da página de status Anthropic. O que fazer:
  • Execute /status e confirme que a credencial ativa é a que você espera. Um ANTHROPIC_API_KEY perdido em seu ambiente pode rotear solicitações através de uma chave de nível inferior em vez de sua assinatura.
  • Verifique o console do seu provedor para os limites ativos e solicite um nível superior se necessário
  • Para chaves de API Anthropic, consulte a referência de limites de taxa para saber como os níveis funcionam e como definir limites por workspace
  • Reduza a concorrência: reduza CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, evite executar muitos subagentes paralelos ou mude para um modelo menor com /model para execuções de script de alto volume

​
Saldo de crédito muito baixo

Sua organização Console ficou sem créditos pré-pagos. 
Credit balance is too low
O que fazer:
  • Adicione créditos em platform.claude.com/settings/billing e considere ativar o auto-reload lá para que o saldo seja recarregado antes de atingir zero
  • Mude para autenticação de assinatura com /login se você tiver um plano Pro, Max, Team ou Enterprise
  • Defina limites de gastos por workspace no Console para evitar que um único projeto drene o saldo da organização. Consulte Manage costs effectively.

​
Erros de autenticação

Esses erros significam que o Claude Code não pode provar quem você é para a API. Execute /status a qualquer momento para ver qual credencial está ativa no momento.

​
Not logged in

Nenhuma credencial válida está disponível para esta sessão. 
Not logged in · Please run /login
O que fazer:
  • Execute /login para autenticar com sua assinatura Claude ou conta Console
  • Se você esperava que uma variável de ambiente o autenticasse, confirme que ANTHROPIC_API_KEY está definido e exportado no shell onde você iniciou claude
  • Para CI ou automação onde login interativo não é possível, configure um script apiKeyHelper que busca uma chave na inicialização
  • Consulte Authentication precedence para entender qual credencial vence quando várias estão presentes
Se você for solicitado a fazer login repetidamente, consulte Not logged in or token expired para correções de relógio do sistema e Keychain do macOS.

​
Invalid API key

A variável de ambiente ANTHROPIC_API_KEY ou script apiKeyHelper retornou uma chave que a API rejeitou. 
Invalid API key · Fix external API key
O que fazer:
  • Verifique se há erros de digitação e confirme que a chave não foi revogada no Console
  • Execute env | grep ANTHROPIC no mesmo shell. Ferramentas como direnv, plugins de shell dotenv e terminais IDE podem carregar uma chave obsoleta de um arquivo .env em seu projeto sem você defini-la explicitamente.
  • Desdefina ANTHROPIC_API_KEY e execute /login para usar autenticação de assinatura
  • Se a chave vem de um script apiKeyHelper, execute o script diretamente para confirmar que ele imprime uma chave válida em stdout
  • Execute /status para confirmar qual fonte de credencial o Claude Code está realmente usando

​
This organization has been disabled

Uma ANTHROPIC_API_KEY obsoleta de uma organização Console desabilitada está substituindo seu login de assinatura. 
Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.
As variáveis de ambiente têm precedência sobre /login, portanto, uma chave exportada no seu perfil de shell ou carregada de um arquivo .env é usada mesmo quando você tem uma assinatura Pro ou Max funcionando. No modo não interativo (-p), a chave é sempre usada quando presente. O que fazer:
  • Desdefina ANTHROPIC_API_KEY no shell atual e remova-o do seu perfil de shell, depois relance claude
  • Execute /status depois para confirmar que a credencial ativa é sua assinatura
  • Se nenhuma variável de ambiente estiver definida e o erro persistir, a organização desabilitada é a vinculada ao seu /login. Entre em contato com o suporte ou faça login com uma conta diferente.

​
Your organization has disabled Claude subscription access

Sua organização Claude não permite fazer login no Claude Code com um login de assinatura. Executar /login novamente com a mesma conta retorna o mesmo erro. 
Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
Esta é uma configuração de organização do lado do servidor, portanto não pode ser substituída por configurações locais, variáveis de ambiente ou sinalizadores CLI. O Agent SDK e o modo não interativo -p apresentam isso como o código de erro oauth_org_not_allowed. O que fazer:
  • Peça ao seu administrador para ativar o acesso do Claude Code para sua organização
  • Autentique-se com uma chave de API do Console em vez de sua assinatura. Consulte Claude Console authentication para configuração.
  • Se você é o administrador e não vê uma opção para ativar o acesso, entre em contato com o suporte da Anthropic

​
Routines are disabled by your organization’s policy

Seu administrador de Team ou Enterprise desativou rotinas no nível da organização. O erro aparece quando você tenta criar ou executar uma rotina, incluindo de /schedule e da interface de usuário Routines em claude.ai/code. 
Routines are disabled by your organization's policy.
Esta é uma configuração do lado do servidor, portanto não pode ser substituída por configurações locais, variáveis de ambiente ou sinalizadores CLI. O que fazer:

​
OAuth token revoked or expired

Seu login salvo não é mais válido. Um token revogado significa que você se desconectou em todos os lugares ou um administrador removeu o acesso; um token expirado significa que a atualização automática falhou no meio da sessão. 
OAuth token revoked · Please run /login
OAuth token has expired · Please run /login
API Error: 401 ... authentication_error
O que fazer:
  • Execute /login para fazer login novamente
  • Se o erro retornar na mesma sessão após re-autenticar, execute /logout primeiro para limpar completamente o token armazenado, depois /login
  • Para prompts repetidos de login entre inicializações, consulte as verificações de relógio do sistema e Keychain do macOS em Troubleshooting
  • Para outras falhas incluindo 403 Forbidden e problemas de navegador OAuth, consulte Login and authentication

​
OAuth scope requirement

O token armazenado é anterior a um escopo de permissão que um recurso mais novo precisa. Você vê isso com mais frequência em /usage e no indicador de uso da linha de status: 
OAuth token does not meet scope requirement: user:profile
O que fazer:
  • Execute /login para criar um novo token com os escopos atuais. Você não precisa fazer logout primeiro.

​
Erros de rede e conexão

Esses erros significam que uma solicitação de rede do Claude Code não conseguiu alcançar seu destino. Eles geralmente se originam em sua rede local, proxy ou firewall, ou na política de rede do ambiente em nuvem.

​
Unable to connect to API

A conexão TCP com a API falhou ou nunca foi concluída. 
Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings
As causas comuns incluem sem acesso à internet, uma VPN que bloqueia api.anthropic.com ou um proxy corporativo necessário que não está configurado. O que fazer:
  • Confirme que você pode alcançar o host da API do mesmo shell executando curl -I https://api.anthropic.com. No Windows PowerShell use curl.exe -I https://api.anthropic.com para que o alias Invoke-WebRequest integrado não seja usado.
  • Se você estiver atrás de um proxy corporativo, defina HTTPS_PROXY antes de iniciar o Claude Code e consulte Network configuration
  • Se você rotear através de um gateway LLM ou relay, defina ANTHROPIC_BASE_URL para seu endereço. Consulte LLM gateway configuration para configuração.
  • Certifique-se de que seu firewall permite os hosts listados em Network access requirements
  • Falhas intermitentes são repetidas automaticamente; falhas persistentes apontam para um problema de rede local
Se curl for bem-sucedido mas o Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:
  • No Linux e WSL, verifique /etc/resolv.conf para um servidor de nomes inacessível. WSL em particular pode herdar um resolvedor quebrado do host.
  • No macOS, um cliente VPN que foi desconectado ou desinstalado pode deixar uma interface de túnel ou regra de roteamento para trás. Verifique ifconfig para interfaces utun obsoletas e remova a extensão de rede da VPN em Configurações do Sistema.
  • Docker Desktop e runtimes de contêiner semelhantes podem interceptar tráfego de saída. Saia deles e tente novamente para descartar isso.

​
SSL certificate errors

Um proxy ou dispositivo de segurança em sua rede está interceptando tráfego TLS com seu próprio certificado, e o Claude Code não confia nele. 
Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected
O que fazer:
  • Exporte o pacote CA da sua organização e aponte o Claude Code para ele com NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
  • Consulte Network configuration para instruções de configuração completas
  • Não defina NODE_TLS_REJECT_UNAUTHORIZED=0, que desabilita completamente a validação de certificado

​
Host not allowed in a cloud session

Uma solicitação HTTP de saída de uma sessão em nuvem ou rotina foi bloqueada pela política de rede do ambiente. 
HTTP 403
x-deny-reason: host_not_allowed
Você também pode ver um certificado TLS que não corresponde ao certificado real do destino. O ambiente em nuvem roteia o tráfego de saída através de um proxy que aplica a política de rede, portanto um certificado incompatível significa que o proxy encerrou a conexão, não o destino. Isso não é um problema de rede do lado do cliente. As sessões em nuvem e routines são executadas dentro de um ambiente sandboxed cuja tráfego de saída é filtrado para a lista de permissões do ambiente. O ambiente Default usa acesso Trusted, que permite a lista de permissões padrão de registros de pacotes, APIs de provedores de nuvem, registros de contêiner e domínios de desenvolvimento comuns, mas bloqueia tudo o mais. O que fazer:
  • Abra a rotina para edição ou inicie uma sessão em nuvem. Selecione o ícone de nuvem mostrando o nome do seu ambiente, como Default, para abrir o seletor. Passe o mouse sobre seu ambiente e clique no ícone de configurações.
  • Na caixa de diálogo Update cloud environment, altere Network access de Trusted para Custom e adicione o domínio bloqueado a Allowed domains. Digite um domínio por linha. Marque Also include default list of common package managers para manter a lista de permissões padrão junto com seus domínios personalizados. Selecione Full em vez disso se você quiser acesso irrestrito.
  • Clique em Save changes. A próxima execução usa a lista de permissões atualizada.
Consulte Network access para níveis de acesso e a lista de permissões padrão. As sessões locais da CLI não são afetadas por essa política.

​
Erros de solicitação

Esses erros significam que a API recebeu sua solicitação mas rejeitou seu conteúdo.

​
Prompt is too long

A conversa mais arquivos anexados excedem a janela de contexto do modelo. 
Prompt is too long
O que fazer:
  • Execute /compact para resumir turnos anteriores e liberar espaço, ou /clear para começar do zero
  • Execute /context para ver um detalhamento do que está consumindo a janela: prompt do sistema, ferramentas, arquivos de memória e mensagens
  • Desabilite servidores MCP que você não está usando com /mcp disable <name> para remover suas definições de ferramentas do contexto
  • Reduza arquivos de memória CLAUDE.md grandes, ou mova instruções para regras com escopo de caminho que carregam apenas quando relevante
  • Subagentes herdam todas as definições de ferramentas MCP da sessão pai, o que pode preencher sua janela de contexto antes do primeiro turno. Desabilite servidores MCP que você não está usando antes de gerar subagentes.
  • Auto-compact está ativado por padrão e normalmente previne esse erro. Se você tiver definido DISABLE_AUTO_COMPACT, reabilite-o ou execute /compact manualmente antes da janela se encher.
Consulte Explore the context window para uma visualização interativa de como o contexto se preenche.

​
Error during compaction: Conversation too long

/compact em si falhou porque não há contexto livre suficiente para manter o resumo que produz. 
Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
Isso pode acontecer quando a janela já está cheia no momento em que auto-compact é acionado, ou quando você executa /compact depois de ver Prompt is too long. O que fazer:
  • Pressione Esc duas vezes para abrir a lista de mensagens e voltar vários turnos. Isso remove as mensagens mais recentes do contexto. Depois execute /compact novamente.
  • Se voltar não liberar espaço suficiente, execute /clear para iniciar uma sessão nova. Sua conversa anterior é preservada e pode ser reabierta com /resume.

​
Request too large

O corpo da solicitação bruta excedeu o limite de bytes da API antes da tokenização, geralmente por causa de um arquivo ou anexo grande colado. 
Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.
Este é um limite de tamanho na solicitação HTTP, separado do limite de janela de contexto. O que fazer:
  • Pressione Esc duas vezes e volte passado o turno que adicionou o conteúdo de tamanho excessivo
  • Referencie arquivos grandes por caminho em vez de colar seu conteúdo, para que Claude possa lê-los em pedaços
  • Para imagens, consulte Image was too large abaixo

​
Image was too large

Uma imagem colada ou anexada excede os limites de tamanho ou dimensão da API. 
Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size
A imagem permanece no histórico de conversa após o erro, portanto, cada mensagem subsequente falha com o mesmo erro até você removê-la. O que fazer:
  • Pressione Esc duas vezes e volte passado o turno onde a imagem foi adicionada
  • Redimensione a imagem antes de colar. A API aceita imagens de até 8000 pixels na borda mais longa para uma única imagem, ou 2000 pixels quando muitas imagens estão em contexto.
  • Faça uma captura de tela mais apertada da região relevante em vez da tela inteira

​
PDF errors

O PDF que você anexou não pôde ser processado. 
PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.
O que fazer:
  • Para PDFs de tamanho excessivo, peça ao Claude para ler um intervalo de páginas com a ferramenta Read em vez de anexar o arquivo inteiro, ou extraia texto com uma ferramenta como pdftotext e referencie o arquivo de saída por caminho
  • Para PDFs protegidos ou inválidos, remova a senha ou re-exporte o arquivo de seu aplicativo de origem, depois tente novamente

​
Extra inputs are not permitted

Um proxy ou gateway LLM entre Claude Code e a API removeu o cabeçalho de solicitação anthropic-beta, portanto, a API rejeitou campos que dependem dele. 
API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header
O Claude Code envia campos somente beta como context_management, effort e input_examples de ferramentas junto com um cabeçalho anthropic-beta que os habilita. Quando um gateway encaminha o corpo mas remove o cabeçalho, a API vê campos que não reconhece. O que fazer:
  • Configure seu gateway para encaminhar o cabeçalho anthropic-beta. Consulte LLM gateway configuration.
  • Como fallback, defina CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 antes de iniciar. Isso desabilita recursos que requerem o cabeçalho beta para que as solicitações tenham sucesso através de um gateway que não pode encaminhá-lo.

​
There’s an issue with the selected model

O nome do modelo configurado não foi reconhecido ou sua conta não tem acesso a ele. 
There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to select a different one.
O que fazer:
  • Execute /model para escolher entre modelos disponíveis para sua conta
  • Use um alias como sonnet ou opus em vez de um ID versionado completo. Aliases rastreiam a versão mais recente para que não fiquem obsoletos. Consulte Model configuration.
  • Se o modelo errado continuar voltando, um ID obsoleto está definido em algum lugar. Verifique em ordem de prioridade: a flag --model, a variável de ambiente ANTHROPIC_MODEL, depois o campo model em .claude/settings.local.json, o .claude/settings.json do seu projeto e ~/.claude/settings.json. Remova o valor obsoleto e Claude Code volta ao padrão da sua conta.
  • Para implantações Vertex AI, consulte Vertex AI troubleshooting.

​
Claude Opus is not available with the Claude Pro plan

Seu plano de assinatura ativo não inclui o modelo que você selecionou. 
Claude Opus is not available with the Claude Pro plan · Select a different model in /model
O que fazer:
  • Execute /model e selecione um modelo que seu plano inclui
  • Se você atualizou seu plano recentemente e ainda vê isso, execute /logout depois /login. O token armazenado reflete seu plano no momento em que você fez login, portanto, atualizar na web não entra em vigor em uma sessão existente até você se re-autenticar.
  • Consulte claude.com/pricing para saber quais modelos cada plano inclui

​
thinking.type.enabled is not supported for this model

Sua versão do Claude Code é mais antiga que o mínimo para Opus 4.7. A CLI enviou uma configuração de thinking que o modelo não aceita mais. 
API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
O que fazer:
  • Execute claude update para atualizar para v2.1.111 ou posterior, depois reinicie o Claude Code
  • Se você não conseguir atualizar, execute /model e selecione Opus 4.6 ou Sonnet
  • Se você atingir isso no Agent SDK, consulte SDK troubleshooting

​
Thinking budget exceeds output limit

O orçamento de thinking estendido configurado excede o comprimento máximo de resposta, portanto, não há espaço deixado para a resposta real. 
API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
O Claude Code ajusta esses valores automaticamente na API Anthropic. Você normalmente vê esse erro em Amazon Bedrock ou Google Vertex AI quando MAX_THINKING_TOKENS está definido mais alto que o limite de saída do provedor, ou quando o modo plano aumenta o orçamento de thinking. O que fazer:

​
Tool use or thinking block mismatch

O histórico de conversa chegou à API em um estado inconsistente, geralmente após uma chamada de ferramenta ser interrompida ou um turno ser editado no meio do fluxo. 
API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified
Todas as três variantes significam a mesma coisa: a sequência de blocos tool_use, tool_result e thinking no histórico não corresponde mais ao que a API espera. O que fazer:
  • Execute /rewind, ou pressione Esc duas vezes, para voltar a um checkpoint antes do turno corrompido e continuar de lá. Consulte Checkpointing para saber como os checkpoints são criados e restaurados.

​
Usage Policy refusal

A API recusou responder porque o conteúdo na conversa acionou uma verificação de Usage Policy. A mensagem inclui um ID de Solicitação que você pode citar para suporte se acreditar que a recusa está incorreta. 
API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.
A verificação avalia a conversa completa, não apenas seu prompt mais recente, portanto, enviar uma nova mensagem na mesma sessão geralmente re-aciona a mesma recusa. O mesmo se aplica após sair e reabrir a sessão com --continue ou --resume, já que a transcrição em disco ainda contém o conteúdo que acionou. O que fazer:
  • Pressione Esc duas vezes ou execute /rewind para voltar a um checkpoint antes do turno que acionou a recusa, depois reformule ou tome uma abordagem diferente. Consulte Checkpointing.
  • Se você não conseguir identificar qual turno causou, execute /clear para iniciar uma conversa nova no mesmo projeto. Sua conversa anterior é preservada em disco e permanece disponível em /resume.
  • Em modo não interativo (-p), onde rewind não está disponível, tente novamente com um prompt reformulado ou inicie uma nova sessão sem --continue.

​
As respostas parecem ter qualidade inferior ao usual

Se as respostas do Claude parecem menos capazes do que você espera, mas nenhum erro é exibido, a causa geralmente é o estado da conversa em vez do modelo em si. O Claude Code não muda silenciosamente versões de modelo. Ele pode mudar para um modelo fallback em casos específicos, como uma cota Opus sendo atingida ou um Bedrock ou Vertex AI region não tendo seu modelo; a verificação de seleção de modelo abaixo captura ambos, e Model configuration explica quando fallback se aplica. Verifique estes primeiro:
  • Seleção de modelo: execute /model para confirmar que você está no modelo que espera. Uma escolha anterior /model ou uma variável de ambiente ANTHROPIC_MODEL pode tê-lo em um modelo menor do que pretendia.
  • Nível de esforço: execute /effort para verificar o nível de raciocínio atual e aumente-o para debugging difícil ou trabalho de design. Os padrões variam por modelo, portanto, verifique antes de assumir que você está abaixo do máximo. Consulte Adjust effort level para padrões por modelo e o atalho ultrathink.
  • Pressão de contexto: execute /context para ver como a janela está cheia. Se estiver perto da capacidade, execute /compact em um ponto natural ou /clear para começar do zero. Consulte Explore the context window para saber como auto-compact afeta turnos anteriores.
  • Instruções obsoletas: arquivos CLAUDE.md grandes ou desatualizados e definições de ferramentas MCP consomem contexto e podem orientar respostas. /doctor sinaliza arquivos de memória de tamanho excessivo e definições de subagentes; /context mostra uso de token de ferramentas MCP.
Quando uma resposta dá errado, retroceder geralmente funciona melhor do que responder com correções. Pressione Esc duas vezes ou execute /rewind para voltar antes do turno ruim, depois reformule o prompt com mais especificidades. Corrigir no thread mantém a tentativa errada em contexto, o que pode ancorar respostas posteriores a ela. Consulte Checkpointing. Se a qualidade ainda parecer incorreta após verificar o acima, execute /feedback e descreva o que você esperava versus o que obteve. Feedback enviado dessa forma inclui a transcrição da conversa, que é a forma mais rápida para Anthropic diagnosticar uma regressão real. Consulte Report an error se /feedback não estiver disponível no seu ambiente.

​
Relatar um erro

Esta página cobre erros da API Claude. Para erros de outros componentes do Claude Code, consulte o guia relevante: Se um erro não estiver listado aqui ou a correção sugerida não ajudar:
  • Execute /feedback dentro do Claude Code para enviar a transcrição e uma descrição para Anthropic. O comando também oferece abrir um problema GitHub pré-preenchido. No Bedrock, Vertex AI, Foundry e outros provedores terceirizados, /feedback salva um arquivo local que você pode enviar para seu representante de conta Anthropic.
  • Execute /doctor para verificar problemas de configuração local
  • Verifique status.claude.com para incidentes ativos
  • Procure problemas existentes no GitHub