Referência de erros

​

Encontre seu erro

​

Tentativas automáticas

• A partir da v2.1.199, uma falha de validação de certificado TLS, como um proxy que inspeciona TLS, um pacote NODE_EXTRA_CA_CERTS ausente ou um certificado expirado, falha na primeira tentativa para que a correção apareça imediatamente em vez de após o orçamento de tentativa completo. Consulte Erros de certificado SSL. Condições TLS transitórias, como um tempo limite de handshake, ainda são repetidas.
• A partir da v2.1.199, um erro de servidor que chega depois que Claude já transmitiu saída visível mantém a resposta parcial e anexa um aviso de resposta incompleta em vez de tentar novamente, já que re-executar a solicitação poderia executar as mesmas chamadas de ferramentas duas vezes. Versões anteriores descartavam a saída parcial e relatavam o turno como um erro.
• Uma resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado falha na primeira tentativa, porque o gateway ou proxy reescrevendo a resposta reescreveria a tentativa da mesma forma. Requer Claude Code v2.1.208 ou posterior.

​

Erros do servidor

​

API Error: 500 Internal server error

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

• Verifique status.claude.com ou a página de status do provedor nomeada na mensagem para incidentes ativos
• Aguarde um minuto e envie sua mensagem novamente. Sua mensagem original ainda está na conversa, então para um prompt longo você pode digitar try again em vez de colar tudo novamente.
• Se o erro persistir sem nenhum incidente postado, execute /feedback para que Anthropic possa investigar com os detalhes da sua solicitação. Consulte Report an error se /feedback não estiver disponível no seu ambiente.

​

API Error: Repeated 529 Overloaded errors

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

• Verifique status.claude.com ou a página de status do provedor nomeada na mensagem 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. 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

Request timed out

• 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 Automatic retries
• Se os tempos limite forem frequentes e sua rede estiver saudável, consulte Network and connection errors abaixo

​

The response above may be incomplete

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection closed mid-response. The response above may be incomplete.
API Error: Response stalled mid-stream. The response above may be incomplete.

• Server error mid-response: um erro de servidor sobrecarregado ou 5xx no meio do stream. Esta variante requer Claude Code v2.1.199 ou posterior; antes disso, esse caso descartava a saída parcial e relatava toda a vez como um erro.
• Connection closed mid-response: a conexão foi interrompida.
• Response stalled mid-stream: o stream parou de enviar dados.

• Leia a resposta que foi transmitida. Nada foi perdido, mas as frases finais ou chamadas de ferramenta podem estar faltando.
• Responda com continue para que Claude continue de onde parou
• Se o mesmo erro aparecer antes de qualquer saída visível, Claude Code tenta novamente a solicitação em vez de finalizá-la. Consulte Automatic retries.

​

Auto mode cannot determine the safety of an action

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.

• 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 à auto mode eligibility; você não precisa alterar as configurações

Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

• 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

Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details

• Isso não é uma decisão sobre sua ação. O conteúdo já em sua conversa acionou um filtro de segurança na API quando o auto mode enviou a conversa para o classificador
• Tentar novamente não ajudará; o mesmo conteúdo da conversa acionará o filtro novamente
• Mude para um permission mode diferente para que você possa aprovar a ação quando solicitado, ou inicie uma conversa nova sem o conteúdo que acionou

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

• 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

​

Agent terminated early due to an API error

Agent terminated early due to an API error: <error detail>

• Corresponda o detalhe do erro após os dois pontos à sua própria seção nesta página, como Usage limits ou Server errors, e siga as etapas dessa seção
• Depois que o erro subjacente for resolvido, peça a Claude para tentar novamente a tarefa ou resume the subagent

​

Limites de uso

​

Você atingiu seu limite de sessão

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

• Aguarde o horário de reset mostrado no erro
• Para o limite de Opus, execute /model e mude para outro modelo para continuar trabalhando
• Execute /usage para ver seus limites de plano e quando eles são resetados
• 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 base mais altos, consulte claude.com/pricing

​

Créditos de uso necessários para contexto de 1M

API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

• Execute /model e selecione a variante sem o sufixo [1m] para voltar à janela de contexto padrão
• Execute /usage-credits para ativar a cobrança medida para a variante 1M em Pro e Max, ou para solicitá-la ao seu administrador em Team e Enterprise
• Se o erro persistir após /model, uma ID de modelo 1M pode estar definida em outro lugar. Consulte There’s an issue with the selected model para os locais de configuração a verificar em ordem de prioridade.
• Para remover variantes 1M do seletor de modelo completamente, defina CLAUDE_CODE_DISABLE_1M_CONTEXT=1

​

O servidor está limitando temporariamente as solicitações

API Error: Server is temporarily limiting requests (not your usage limit)

• Aguarde um pouco e tente novamente
• Verifique status.claude.com se persistir

​

Solicitação rejeitada (429)

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

• Execute /status e confirme que a credencial ativa é a que você espera. Um ANTHROPIC_API_KEY deslocado em seu ambiente pode rotear solicitações através de uma chave de nível baixo em vez de sua assinatura.
• Verifique seu console de provedor para os limites ativos e solicite um nível mais alto se necessário
• Para chaves de API do Anthropic, consulte a rate limits reference para saber como os níveis funcionam e como definir limites por workspace
• Reduza a concorrência: diminua 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

Credit balance is too low

• Adicione créditos em platform.claude.com/settings/billing, e considere ativar o auto-reload lá para que o saldo seja recarregado antes de chegar a 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

​

Não conectado

Not logged in · Please run /login

• 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á definida e exportada no shell onde você iniciou claude
• Para CI ou automação onde login interativo não é possível, configure um script apiKeyHelper que busque uma chave na inicialização
• Consulte Precedência de autenticação para entender qual credencial Claude Code usa quando várias estão presentes

​

Não foi possível resolver o método de autenticação

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

• Atualize para v2.1.174 ou posterior se isso aparecer em uma sessão em segundo plano ou em nuvem e suas credenciais já estiverem configuradas
• Confirme que ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN ou suas credenciais do provedor de nuvem estão definidas no ambiente que inicia o worker, não apenas no seu shell interativo
• Para o Agent SDK, consulte configuração de autenticação
• Execute /status em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida

​

Chave de API inválida

Invalid API key · Fix external API key

• 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 Claude Code está realmente usando

​

Seu script apiKeyHelper está falhando

Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

• Execute o comando configurado em apiKeyHelper diretamente no seu shell para reproduzir a falha
• Se o comando relatar uma sessão expirada, autentique-se novamente com seu provedor de credenciais, por exemplo, fazendo login novamente em seu SSO ou cofre de segredos
• Corrija o comando para que ele imprima a chave em stdout e saia com código 0. Consulte girar credenciais com apiKeyHelper para uma configuração funcionando.
• Execute /status para confirmar que apiKeyHelper é a fonte de credencial ativa. Cada vez que o comando falha, seu código de saída e saída de erro aparecem em um painel Cloud authentication no terminal.

​

Esta organização foi desabilitada

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.

• Desdefina ANTHROPIC_API_KEY no shell atual e remova-a do seu perfil de shell, depois reinicie 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 é aquela vinculada ao seu /login. Entre em contato com o suporte ou faça login com uma conta diferente.

​

Sua organização desabilitou a autenticação por chave de API

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

• Se a mensagem mencionar ANTHROPIC_API_KEY, desdefina-a no shell atual e remova-a do seu perfil de shell ou arquivo .env, depois reinicie claude
• Se a mensagem mencionar apiKeyHelper, remova a configuração apiKeyHelper do seu settings.json
• Execute /login para fazer login com sua conta claude.ai
• Execute /status depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API
• Se você precisar de autenticação por chave de API para automação, peça ao administrador da sua organização para reabilitá-la no Console

​

Sua organização desabilitou o acesso à assinatura Claude

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

• Peça ao seu administrador para habilitar o acesso ao Claude Code para sua organização
• Autentique-se com uma chave de API do Console em vez de sua assinatura. Consulte Autenticação do Claude Console para configuração.
• Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com suporte da Anthropic

​

Rotinas são desabilitadas pela política da sua organização

Routines are disabled by your organization's policy.

• Peça a um Proprietário em sua organização para habilitar o botão Routines em claude.ai/admin-settings/claude-code
• Para trabalho agendado único que não requer rotinas no nível da organização, consulte tarefas agendadas

​

Remote Control requer a API Anthropic

Remote Control is only available when using Claude via api.anthropic.com.

• Desdefina ANTHROPIC_BASE_URL e reinicie a sessão, ou inicie Remote Control de uma sessão que se comunique com a API Anthropic diretamente
• Para esta e as outras mensagens de inicialização do Remote Control, consulte Solucionar problemas do Remote Control

​

Token OAuth revogado ou expirado

OAuth token revoked · Please run /login
OAuth token has expired · Please run /login
API Error: 401 ... authentication_error

• Execute /login para fazer login novamente
• Se o erro retornar na mesma sessão após autenticar novamente, 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 Solução de problemas
• Para outras falhas, incluindo 403 Forbidden e problemas de navegador OAuth, consulte Login e autenticação

​

Login expirado

Login expired · Please run /login

Failed to authenticate: OAuth session expired and could not be refreshed

• Execute /login para fazer login novamente. Tentar novamente sem fazer login mostra a mesma mensagem em cada solicitação.
• Em modo não interativo, execute claude no mesmo ambiente, conclua /login, depois execute novamente seu comando. Para automação que não consegue fazer login interativamente, autentique-se com ANTHROPIC_API_KEY ou gere um token de longa duração com claude setup-token.
• Se fazer login continuar falhando, consulte Login e autenticação

​

Requisito de escopo OAuth

OAuth token does not meet scope requirement: user:profile

• Execute /login para obter um novo token com os escopos atuais. Você não precisa fazer logout primeiro.

​

Credenciais AWS expiradas ou inválidas

AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

• Execute o comando awsAuthRefresh nomeado na mensagem, como aws sso login --profile myprofile, em outro terminal e conclua o login do navegador, depois tente novamente
• Em uma sessão interativa, execute /login, escolha plataforma de terceiros, depois selecione Claude Platform on AWS · refresh credentials em Usando plataformas de terceiros para executar o mesmo comando sem reiniciar Claude Code. Consulte Configurar credenciais AWS
• Se o erro se repetir após o comando de atualização ter sucesso, confirme que a identidade é válida fora do Claude Code com aws sts get-caller-identity no mesmo shell e perfil

​

Falha na autenticação AWS

AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

• Execute o comando awsAuthRefresh nomeado na mensagem, ou aws sso login, caso uma credencial expirada seja a causa
• Se suas credenciais estão atuais, confirme que as permissões IAM em Configuração IAM estão anexadas à identidade que você está usando e que o modelo selecionado está habilitado para sua conta e região
• Execute aws sts get-caller-identity para confirmar qual identidade suas solicitações usam; um AWS_PROFILE obsoleto ou perfil padrão é uma causa comum de incompatibilidade de permissão

​

Resolução de credencial da cadeia padrão AWS expirou

API Error: AWS default-chain credential resolve timed out

• Execute aws sts get-caller-identity no mesmo shell com o mesmo AWS_PROFILE. Se também travar, corrija o perfil; um comando credential_process que solicita interativamente é uma causa comum.
• Conclua a etapa de login antes de iniciar Claude Code, por exemplo aws sso login --profile myprofile, para que a cadeia seja resolvida do cache SSO local em vez de aguardar um fluxo de navegador
• Se sua cadeia executa um login interativo que legitimamente precisa de mais de 60 segundos, como SSO com MFA através de um wrapper como aws-vault, aumente o limite em milissegundos com CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

​

Erros de rede e conexão

​

Não é possível conectar à API

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

• Confirme que você pode alcançar o host da API a partir 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 Claude Code e consulte Configuração de rede
• Se você rotear através de um gateway LLM ou relay, defina ANTHROPIC_BASE_URL para seu endereço. Consulte Conectar Claude Code a um gateway LLM para configuração.
• Certifique-se de que seu firewall permite os hosts listados em Requisitos de acesso à rede
• Falhas intermitentes são retentadas automaticamente; falhas persistentes apontam para um problema de rede local

• No Linux e WSL, verifique /etc/resolv.conf para um nameserver inacessível. WSL em particular pode herdar um resolver 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 similares podem interceptar tráfego de saída. Saia deles e tente novamente para descartar isso.

​

Resposta de streaming do Bedrock tem um content-type inesperado

Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

• Configure o gateway para passar o corpo da resposta InvokeModelWithResponseStream e seu cabeçalho Content-Type sem modificações. Um intermediário que re-emite o stream como server-sent events é uma causa comum.
• Se o gateway reescrever apenas o cabeçalho e passar o corpo binário intacto, defina CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 para pular a verificação até que o gateway seja corrigido. Consulte Erros de streaming atrás de um gateway ou proxy.

​

Erros de certificado SSL

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

SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

• Exporte o pacote CA da sua organização e aponte Claude Code para ele com NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
• Consulte Configuração de rede para instruções de configuração completa
• Não defina NODE_TLS_REJECT_UNAUTHORIZED=0, que desabilita a validação de certificado inteiramente

​

Host não permitido em uma sessão em nuvem

HTTP 403
x-deny-reason: host_not_allowed

• 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, depois 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 quiser acesso irrestrito.
• Clique em Save changes. A próxima execução usa a lista de permissões atualizada.

​

Não foi possível reconectar à sua sessão de Remote Control

Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

• Execute /remote-control para tentar novamente a conexão
• Inicie Claude Code sem --resume para criar uma nova sessão de Remote Control
• Para outras mensagens de inicialização do Remote Control, consulte Troubleshoot Remote Control

​

Erros de solicitação

​

Prompt é muito longo

Prompt is too long

• 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
• Suagentes 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 suagentes.
• Auto-compact está ativado por padrão e normalmente previne esse erro. Se você definiu DISABLE_AUTO_COMPACT, reabilite-o ou execute /compact manualmente antes da janela ficar cheia.

​

Erro durante compactação: Conversa muito longa

Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

• 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.

​

Solicitação muito grande

Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

• Pressione Esc duas vezes e volte passado o turno que adicionou o conteúdo superdimensionado
• Referencie arquivos grandes por caminho em vez de colar seu conteúdo, para que Claude possa lê-los em pedaços
• Para imagens, veja Image was too large abaixo

​

Imagem era muito grande

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

• 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

​

Não foi possível redimensionar a imagem

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

• Se a mensagem pedir para você converter a imagem, converta-a para PNG, JPEG, GIF ou WebP e anexe-a novamente. Claude Code pode verificar dimensões para esses formatos sem o processador de imagem.
• Se a mensagem relatar um limite de dimensão ou tamanho, redimensione ou recomprima a imagem abaixo desse limite antes de anexar.

​

Erros de PDF

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.

• Para PDFs superdimensionados, 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

​

Entradas extras não são permitidas

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

• Configure seu gateway para encaminhar o cabeçalho anthropic-beta. Veja feature pass-through para o que os gateways devem encaminhar.
• Como alternativa, defina CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 antes de iniciar. Isso desabilita recursos que exigem o cabeçalho beta para que as solicitações tenham sucesso através de um gateway que não pode encaminhá-lo.

​

Há um problema com o modelo selecionado

There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.

• CLI interativo: execute /model para escolher entre modelos disponíveis para sua conta.
• Modo não interativo (-p): passe --model com um alias ou ID válido, ou defina ANTHROPIC_MODEL. O texto de erro mostra Run --model nesta superfície.
• Agent SDK: o texto de erro omite a dica porque o modelo é definido programaticamente. Defina model em Options em TypeScript ou ClaudeAgentOptions(model=...) em Python, e trate o erro estruturado model_not_found para exibir sua própria tentativa ou seletor de modelo.
• Use um alias como sonnet ou opus em vez de um ID versionado completo. Os aliases resolvem para um padrão mantido para que não fiquem obsoletos. Veja Model configuration.
• Se o modelo errado continuar voltando na CLI, 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 para o padrão da sua conta.
• Claude Code relata um login claude.ai expirado como Login expired, não como este erro. Antes de v2.1.206, um login expirado que não podia mais ser atualizado falhava em cada modelo com este erro; execute /login se você vir isso em uma versão mais antiga.
• Para implantações do Agent Platform do Google Cloud, veja Troubleshooting do Agent Platform do Google Cloud.

​

Modelo não é um ID de modelo reconhecido

Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

• Execute /model sem argumento para abrir o seletor e escolher entre os modelos disponíveis para sua conta, depois passe o alias ou ID mostrado lá
• Se você usou um alias que uma versão mais recente do Claude Code suporta, execute claude update. Um ID completo que começa com claude- passa nesta verificação mesmo quando o modelo é mais recente que sua versão do Claude Code, então atualizar não é necessário para esses.
• Um modelo salvo antes de v2.1.200 não é reparado por esta verificação. Se um valor obsoleto continuar voltando, remova-o dos locais listados em Há um problema com o modelo selecionado.
• A verificação é executada apenas na API Anthropic. No Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry, Claude Platform on AWS e atrás de um LLM gateway ou um ANTHROPIC_BASE_URL customizado, seu provedor ou gateway define os nomes dos modelos, então Claude Code aceita qualquer string e a passa.

​

Claude Opus não está disponível com o plano Claude Pro

Claude Opus is not available with the Claude Pro plan · Select a different model in /model

• 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ê se conectou, então atualizar na web não entra em vigor em uma sessão existente até que você se autentique novamente.
• Veja claude.com/pricing para quais modelos cada plano inclui

​

Modelo é restringido pelas configurações da sua organização

Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

• Execute /model para escolher entre os modelos que sua organização permite. Modelos restritos estão ocultos do seletor.
• Se o modelo restringido foi definido em --model, ANTHROPIC_MODEL ou o campo model de um arquivo de configurações, remova ou atualize esse valor para que o aviso não recorra em cada inicialização
• Se você precisa de acesso ao modelo restringido, peça ao administrador da sua organização para habilitá-lo. Veja Organization model restrictions.

​

thinking.type.enabled não é suportado para este modelo

API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

• Execute claude update e reinicie Claude Code. Opus 4.7 precisa de v2.1.111 ou posterior. Opus 4.8 precisa de v2.1.154 ou posterior. Sonnet 5 precisa de v2.1.197 ou posterior
• Se você não conseguir atualizar, execute /model e selecione Opus 4.6 ou Sonnet 4.6 em vez disso
• Se você encontrar isso no Agent SDK, atualize o pacote SDK em vez disso. Opus 4.8 precisa do TypeScript SDK v0.3.154 ou posterior e do Python SDK v0.2.88 ou posterior. Sonnet 5 precisa do TypeScript SDK v0.3.197 ou posterior

​

Orçamento de pensamento excede limite de saída

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

• Diminua MAX_THINKING_TOKENS, ou aumente CLAUDE_CODE_MAX_OUTPUT_TOKENS acima do orçamento de pensamento
• Veja Extended thinking para como o orçamento interage com o comprimento de saída

​

Incompatibilidade de bloco de uso de ferramenta ou pensamento

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

• Se você está usando Opus 4.7 ou Opus 4.8, execute claude update primeiro. Versões anteriores a v2.1.156 podem acionar esse erro durante o uso normal de ferramentas, e /rewind não o limpa.
• Execute /rewind, ou pressione Esc duas vezes, para voltar a um checkpoint antes do turno corrompido e continuar de lá. Veja Checkpointing para como os checkpoints são criados e restaurados.

​

Recusa de Política de Uso

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.

• 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. Veja 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 em uma nova sessão sem --continue. As verificações de política variam por modelo, então mudar para um modelo diferente com --model também pode resolver a recusa em alguns casos.

​

Medidas de segurança sinalizaram um tópico de cibersegurança

API Error: Opus 4.8 has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.

If you were not engaging in a cybersecurity topic, please send feedback via /feedback.

• Em Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry, uma sinalização de cibersegurança produz a mensagem de Recusa de Política de Uso em vez disso.
• Modo não interativo omite a sentença /feedback.

• Se seu trabalho exigir este conteúdo, solicite acesso através do Cyber Verification Program
• Se sua solicitação não era sobre um tópico de cibersegurança, execute /feedback para relatar o falso positivo
• Para continuar trabalhando na mesma sessão, pressione Esc duas vezes ou execute /rewind para voltar a um checkpoint antes do turno que acionou a sinalização, depois tome uma abordagem diferente. Veja Checkpointing.

​

Erros de instalação

​

A instalação foi interrompida antes de ser concluída

Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

• Interrompa outros processos para liberar memória e execute novamente o instalador
• Adicione espaço de swap ou mude para uma instância maior. Consulte Instalação interrompida em servidores Linux com pouca memória para os comandos de arquivo de swap.

​

A conexão foi interrompida durante o download da atualização

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

• Execute claude update novamente. Em uma rede caso contrário saudável, o download geralmente é bem-sucedido na próxima execução. Para a mensagem de tempo limite, execute-a novamente de uma rede mais rápida ou menos limitada.
• Se sua rede exigir um proxy, defina HTTPS_PROXY antes de executar o instalador ou claude update. Consulte Verificar conectividade de rede.
• Se um proxy corporativo continuar fechando a transferência, peça à sua equipe de rede para permitir o download completo de downloads.claude.ai. Consulte Requisitos de acesso à rede.
• Execute claude doctor do seu shell para diagnósticos de instalação

​

Erros de linha de comando

​

Conflito entre —bg e —print

--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.

• Remova -p ou --print. --bg recebe o prompt como seu argumento posicional, então claude --bg "<task>" é o comando completo. Veja Dispatch new agents from your shell.
• Para executar o prompt não interativamente e imprimir o resultado em vez de criar uma sessão em background, remova --bg e execute claude -p "<task>"

​

O valor de —json-schema não é um JSON Schema válido

Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

• Corrija a parte do schema que o diagnóstico nomeia, depois execute o comando novamente
• Se o diagnóstico for schema too large, reduza o aninhamento do schema e a reutilização de $ref
• Veja Get structured output para um schema e comando funcionando

​

Não foi possível importar um servidor do Claude Desktop

Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

• Renomeie o servidor em claude_desktop_config.json para usar apenas letras, números, hífens e sublinhados, depois execute claude mcp add-from-claude-desktop novamente
• Adicione esse servidor diretamente com claude mcp add ou claude mcp add-json sob um nome válido. Veja Import MCP servers from Claude Desktop.

​

Ferramenta de prompt de permissão MCP não encontrada

Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

• Verifique se o servidor inicia e permanece conectado: execute claude mcp list no mesmo diretório e confirme se o servidor está listado como conectado
• Confirme se o nome da ferramenta corresponde ao nome mcp__<server>__<tool> que o servidor expõe
• Se o servidor precisar de mais de 30 segundos para iniciar, aumente MCP_TIMEOUT

​

Erros de plugin

​

Marketplace registrado de uma fonte não confiável

Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

• Execute claude plugin marketplace remove <name>, depois adicione o marketplace novamente do repositório oficial github.com/anthropics
• Se você publicar um marketplace de terceiros que usou o nome antes de ele ficar reservado, renomeie-o e peça aos usuários para adicioná-lo novamente de sua fonte
• Consulte a lista de nomes reservados em Marketplace schema

​

Plugin command references user_config in a shell command

Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}

Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.

headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).

• Para um hook, adicione um array args para que ele seja executado em exec form, onde cada ${user_config.KEY} se torna um argumento sem shell no meio. Ou remova a referência e leia a variável de ambiente $CLAUDE_PLUGIN_OPTION_<KEY> dentro do script
• Para um monitor, remova a referência e faça o script do monitor ler o valor de um arquivo de configuração
• Para um headersHelper, mova ${user_config.KEY} para o campo headers do servidor, que não é analisado por shell, ou leia o valor dentro do script helper

​

Erros de ferramenta

​

Agent seria gerado com zero ferramentas

Agent 'code-reviewer' seria gerado com zero ferramentas — recusando. Sua lista de ferramentas foi resolvida para nada: não reconhecido [Grpe]. Corrija o frontmatter de ferramentas do agente ou passe um subagent_type diferente.

• Corrija cada entrada que o erro nomeia contra as ferramentas disponíveis para subagentes
• Remova entradas para ferramentas que a sessão não possui, como ferramentas MCP de um servidor que não está conectado
• Para dar ao subagente todas as ferramentas que o pai tem, delete o campo tools em vez de listar ferramentas

​

Arquivo é coberto por uma regra de negação Read

Arquivo é coberto por uma regra de negação Read em suas configurações de permissão e não pode ser editado.

• Se Claude deve ser capaz de editar o arquivo, remova ou restrinja a regra de negação Read em /permissions ou em configurações
• Se o arquivo deve permanecer intocado, mantenha a regra e adicione uma regra de negação Edit para o mesmo caminho para que as ferramentas Write e NotebookEdit também sejam bloqueadas

​

Erros de sessão em background

​

Comandos recusados em uma sessão em background

Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.

• Use o formulário que a mensagem nomeia, como /mcp reconnect <server>, /mcp enable ou /mcp disable
• Para fluxos de entrada e autorização, execute o comando a partir de uma sessão claude regular em um terminal

​

Erros do launcher CLAUDE_CODE_PROCESS_WRAPPER

CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file

• Defina a variável para o caminho absoluto de um executável que termina chamando exec "$@". Veja o contrato do launcher para o contrato completo
• Verifique /status, que mostra o comando de inicialização resolvido em sua entrada Self-exec e avisa quando o serviço em background em execução não corresponde a ele, ou execute claude daemon status a partir de um shell
• Após corrigir o valor no bloco env de settings, reinicie o serviço em background com claude daemon stop --any para que o próximo dispatch inicie um envolvido

​

Avisos de configuração

​

Workspace não foi confiável

Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

• Execute claude no diretório e aceite o diálogo de confiança. O diálogo aparece mesmo quando um diretório pai já é confiável, lista as regras sendo retidas e permite que você recuse e continue trabalhando sem elas. Antes da v2.1.200, nenhum diálogo aparecia nessa situação, então essa etapa não podia ser concluída lá.
• No modo não interativo com -p nenhum diálogo é mostrado. Defina a entrada hasTrustDialogAccepted em ~/.claude.json usando a chave projects exata que a mensagem imprime.
• Se a mensagem nomear .claude/settings.local.json e você iniciou Claude Code fora de um repositório git ou no seu diretório inicial, atualize para v2.1.200 ou posterior. As versões 2.1.196 a 2.1.199 trataram seu próprio .claude/settings.local.json como fornecido pelo repositório nesses workspaces. Na v2.1.207 e posterior, atualizar não é suficiente fora de um repositório git se você não confiou na pasta: determinar que uma pasta não está dentro de um repositório executa git, e Claude Code executa essa verificação apenas depois que você aceita o diálogo de confiança, então use a primeira etapa. Seu diretório inicial e qualquer outro diretório inicial de configuração estão isentos e não esperam pelo diálogo. Veja Regras de permissão do projeto e confiança do workspace.

​

As respostas parecem ter qualidade inferior ao usual

• Um --fallback-model configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição
• Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível
• Fallback automático de modelo no Fable 5 move a sessão para o modelo Opus padrão e mostra um aviso na transcrição

• Seleção de modelo: execute /model para confirmar que você está no modelo que espera. Uma escolha anterior de /model ou uma variável de ambiente ANTHROPIC_MODEL pode colocá-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 aumentá-lo para depuração difícil ou trabalho de design. Os padrões variam por modelo, então verifique antes de assumir que você está abaixo do máximo. Veja Ajustar nível de esforço para padrões por modelo e o atalho ultrathink.
• Pressão de contexto: execute /context para ver o quão cheio está a janela. Se estiver próximo da capacidade, execute /compact em um ponto natural ou /clear para começar do zero. Veja Explorar a janela de contexto para 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. A verificação /doctor sinaliza arquivos de memória superdimensionados e extensões não utilizadas, e /context mostra o uso de tokens de ferramentas MCP. Antes da v2.1.205, /doctor abria uma tela de diagnósticos que sinalizava arquivos de memória superdimensionados e definições de subagente.

​

Relatar um erro

• Servidor MCP falhou ao conectar ou autenticar: MCP
• Script de hook falhou ou bloqueou uma ferramenta: Debug hooks
• Permissão negada ou erros do sistema de arquivos durante a instalação: Solucionar problemas de instalação e login

• Execute /feedback dentro do Claude Code para enviar a transcrição e uma descrição para a Anthropic. O comando também oferece abrir um problema do GitHub pré-preenchido. O envio para a Anthropic requer autenticação. No Amazon Bedrock, na plataforma de agentes do Google Cloud, no Microsoft Foundry e em outros provedores terceirizados, ou quando nenhuma credencial da Anthropic está configurada, /feedback salva um arquivo local que você pode enviar para seu representante de conta da Anthropic.
• Execute claude doctor do seu shell para um diagnóstico somente leitura da sua instalação, ou execute o checkup /doctor dentro do Claude Code para encontrar e corrigir problemas de configuração
• Verifique status.claude.com para incidentes ativos
• Pesquise problemas existentes no GitHub