Referência de erros

​

Encontre seu erro

​

Tentativas automáticas

• Erros de servidor, respostas sobrecarregadas e timeouts de requisição que chegam antes de qualquer parte da resposta do Claude ter sido transmitida.
• Um erro de servidor ou resposta sobrecarregada que chega depois que Claude terminou de pensar, mas antes de ter iniciado qualquer texto ou chamada de ferramenta. Claude Code tenta novamente um erro de servidor nesse ponto até duas vezes. Antes da v2.1.284, Claude Code encerrava o turno com o erro nesse ponto.
• Conexões perdidas. Quando uma conexão cai no meio de uma requisição antes de Claude ter completado qualquer parte de sua resposta, incluindo seu pensamento, Claude Code reemite a requisição com o mesmo backoff e o turno continua, mesmo que algum texto já tivesse começado a ser transmitido. Quando cai depois que Claude terminou de pensar mas antes de ter iniciado qualquer texto ou chamada de ferramenta, Claude Code em vez disso reemite a requisição até duas vezes em rápida sucessão, e encerra o turno com Connection lost before a response was produced se a conexão continuar caindo nesse ponto.
• Uma conexão que Claude Code detecta que foi quebrada pelo seu computador entrando em modo de suspensão no meio de uma requisição. Claude Code a conta como uma conexão perdida sob as regras acima; uma vez que o rótulo de nova tentativa nomeia a razão específica, ele exibe Connection lost while your computer was asleep, e se o turno terminar depois que Claude terminou de pensar mas antes de qualquer texto ou chamada de ferramenta, a mensagem exibe Your computer went to sleep before a response was produced.
• Um fluxo de resposta travado, quando os cabeçalhos de resposta chegaram mas nenhuma parte da resposta do Claude chegou, ou quando Claude terminou de pensar mas não iniciou qualquer texto ou chamada de ferramenta: Claude Code aborta a conexão travada e transmite a requisição novamente no máximo uma vez. Se a resposta travar uma segunda vez depois que Claude terminou de pensar mas antes de qualquer texto ou chamada de ferramenta, Claude Code encerra o turno com The response stalled before a response was produced.
• Uma requisição de streaming que a API nunca responde com cabeçalhos de resposta, em uma conexão onde o prazo de primeiro byte é executado: Claude Code a aborta no prazo e a reenvia no máximo uma vez por requisição de modelo, dentro do orçamento de tentativas, depois encerra o turno com No response from API se essa tentativa também ficar sem resposta. Em outras conexões, a requisição aguarda API_TIMEOUT_MS. Quando você define CLAUDE_CODE_RETRY_WATCHDOG, o limite de uma nova tentativa não se aplica.
• Uma resposta de streaming que o filtro de conteúdo de saída da API interrompe antes de Claude ter terminado de pensar ou iniciado qualquer texto ou chamada de ferramenta. Claude Code reenvia a requisição uma vez, dentro do orçamento de tentativas, e mostra Output blocked by content filtering policy se o filtro também interromper a segunda resposta.
• Throttles 429 temporários, mas não o 429 de limite de gastos de um gateway, que não é um throttle; veja Spend limit reached.
  • Quando você está conectado com uma assinatura claude.ai, isso inclui throttles 429 que não carregam os cabeçalhos de cota do seu plano. Antes da v2.1.199, Claude Code tentava novamente esses throttles apenas para logins com chave de API e Enterprise.
• Uma requisição rejeitada porque a entrada mais max_tokens excede o limite de contexto. Reenviá-la sem alterações falharia da mesma forma, então Claude Code tenta novamente com um max_tokens reduzido, e para de tentar novamente e compacta em dois casos:
  • Quando nenhuma redução pode caber, por exemplo quando a conversa em si quase preenche a janela de contexto.
  • Quando uma nova tentativa não pode encolher max_tokens ainda mais. Antes da v2.1.218, Claude Code poderia reenviar uma requisição reduzida que ainda não cabia, como quando o orçamento de pensamento estendido excedia o contexto restante, até o orçamento de tentativas se esgotar.
• Uma credencial expirada ou ausente do Google Cloud na Plataforma de Agentes do Google Cloud, ou credenciais AWS que falham ao carregar em sua máquina. Claude Code descarta suas credenciais em cache e tenta novamente até duas vezes, depois relata o erro para que você possa se autenticar novamente imediatamente, conforme descrito em Could not load AWS or Google Cloud credentials. Antes da v2.1.228, Claude Code tentava novamente uma credencial do Google Cloud com falha através do orçamento de tentativas completo antes de mostrar o erro.
• Um 401 ou 403 da API Anthropic, diretamente ou através de um gateway de LLM, enquanto um script apiKeyHelper fornece a credencial. Claude Code executa novamente o script e tenta novamente com sua saída nova, dentro do orçamento de tentativas completo. Quando o script em si falha na nova execução, Claude Code mostra Your apiKeyHelper script is failing em vez disso.

• Uma falha de validação de certificado TLS, como um proxy inspecionando TLS, um pacote NODE_EXTRA_CA_CERTS ausente, ou um certificado expirado. Claude Code relata o erro na primeira tentativa, para que você possa corrigir a configuração do certificado imediatamente; veja SSL certificate errors. Claude Code ainda tenta novamente condições TLS transitórias como um timeout de handshake. Antes da v2.1.199, Claude Code tentava novamente falhas de certificado através do orçamento de tentativas completo antes de mostrar o erro.
• Um erro de servidor, conexão perdida, ou fluxo travado que chega depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou iniciou um depois de terminar seu pensamento, mas antes de terminar a resposta. Claude Code não executa novamente a requisição, porque isso poderia executar as mesmas chamadas de ferramenta duas vezes. Ele mantém o que Claude completou, executa qualquer chamada de ferramenta que Claude terminou, e continua o turno a partir de seus resultados. Para o que você vê em uma sessão interativa e em uma não interativa, leia The response above may be incomplete. Antes da v2.1.199, Claude Code descartava a saída parcial e relatava todo o turno como um erro quando um erro de servidor chegava no meio do fluxo.
• Uma falha que chega depois que Claude terminou a resposta: nada precisa ser tentado novamente, então Claude Code mantém a resposta completa e encerra o turno normalmente.
• Uma resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado, porque o gateway ou proxy que reescreve a resposta reescreveria a nova tentativa da mesma forma. Requer Claude Code v2.1.208 ou posterior.
• Uma nova tentativa sem streaming de uma requisição de streaming com falha que recebe um status de sucesso mas nenhuma mensagem da API Claude no corpo. Claude Code encerra o turno com esse erro.
• Uma requisição que a verificação de política da sua organização negou, que aparece como uma linha API Error: carregando a mensagem de negação. Os administradores da sua organização configuram a verificação com Inference hooks, um recurso do Claude Enterprise, e a mensagem termina com as instruções que eles configuraram, ou por padrão diz para você entrar em contato com eles. Claude Code não reenvia a requisição negada para o mesmo modelo ou para um modelo de fallback, porque a negação é sobre o conteúdo da requisição e não sobre o modelo. Antes da v2.1.239, Claude Code poderia reenviar uma requisição negada, sem streaming ou em um modelo de fallback configurado, antes de mostrar a negação.

​

O que você vê enquanto Claude Code tenta novamente ou aguarda

• Antes de Claude ter completado um bloco de texto ou uma chamada de ferramenta, ou iniciado um depois de terminar seu pensamento, Claude Code tenta novamente a requisição ou encerra o turno com um erro. Automatic retries diz quais travamentos ele tenta novamente e quantas vezes.
• Depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou iniciou um depois de terminar seu pensamento, mas antes de Claude ter terminado a resposta, Claude Code mantém o que Claude completou, continua o turno a partir de qualquer chamada de ferramenta que Claude terminou, e mostra The response above may be incomplete. Em uma sessão não interativa, e para a resposta de um subagente em qualquer sessão, Claude Code pode primeiro pedir ao Claude que continue a resposta; essa entrada diz quando faz isso e quando você ainda vê o aviso lá.
• Depois que Claude terminou a resposta, Claude Code encerra o turno normalmente.

​

Ajustar o comportamento de novas tentativas

​

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 a Anthropic possa investigar com os detalhes da sua solicitação. Veja 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. Em modelos Fable a mensagem nomeia Fable. Em uma sessão que o Claude Desktop app executa, como a aba Code ou Cowork, a mensagem lê Opus is experiencing high load. Switch to Sonnet. e você muda modelos com o seletor de modelo do app.

​

Request timed out

Request timed out

• Tente novamente a solicitação
• 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, veja Network and connection errors abaixo

​

No response from API

API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.

• Primeira tentativa: CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS quando você o define como 1 ou mais, limitado entre 10 segundos e 30 minutos. Caso contrário, Claude Code usa o tempo limite do watchdog de nível de byte listado em Streaming idle watchdogs, então as variáveis que alteram esse tempo limite alteram essa espera também. De qualquer forma, Claude Code adiciona um segundo para cada 32KB do corpo da solicitação.
• Nova tentativa: um segundo a menos que API_TIMEOUT_MS, pouco menos de 10 minutos por padrão, para que a nova tentativa possa durar mais que um proxy ou gateway que mantém a resposta até que a geração seja concluída. No Amazon Bedrock, a nova tentativa usa o mesmo prazo que a primeira tentativa, e a mensagem mostra uma duração em vez de duas.

• 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 se repetir, trate como um problema de rede ou proxy.
• Se um proxy ou gateway em sua rede mantém respostas até que sejam concluídas, aumente API_TIMEOUT_MS para que a nova tentativa aguarde mais. No Amazon Bedrock, aumente CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS também.
• Se a primeira tentativa continuar expirando e a nova tentativa tiver sucesso, aumente CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS para que a primeira tentativa também aguarde o tempo suficiente.

​

The response above may be incomplete

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.
API Error: Part of the response never arrived. The response above may be incomplete.
API Error: The response stream was malformed. The response above may be incomplete.

• Server error mid-response: um erro de servidor sobrecarregado ou 5xx no meio do fluxo. Esta variante requer Claude Code v2.1.199 ou posterior; antes disso, esse caso descartava a saída parcial e relatava todo o turno como um erro.
• Connection lost mid-response: a conexão foi interrompida. Você também vê esta variante quando um proxy ou gateway encerra o corpo da resposta de forma limpa antes da resposta ser concluída.
• Your computer went to sleep mid-response: Claude Code detectou que seu computador entrou em modo de suspensão enquanto a resposta estava sendo transmitida. Depois que seu computador acordar, Claude Code trata a conexão como quebrada e para de ler dela.
• Part of the response never arrived: um evento de fluxo foi descartado entre a API e Claude Code, então um evento posterior referenciou conteúdo que nunca chegou. Antes da v2.1.281, este caso terminou o turno com API Error: Content block not found.
• The response stream was malformed: um evento chegou para um bloco de conteúdo que já havia terminado, ou um evento chegou danificado. Um evento danificado é aquele cujos dados não são JSON válido, cujo conteúdo está faltando ou cujo conteúdo não corresponde ao tipo do evento. Antes da v2.1.284, o erro bruto do analisador, como um começando com API Error: JSON Parse error, aparecia em vez disso quando um evento com JSON inválido chegava depois que Claude havia completado seu pensamento, um bloco de texto ou uma chamada de ferramenta.
• The response stopped arriving: a conexão permaneceu aberta mas parou de entregar dados, então o watchdog de inatividade de streaming a abortou. Antes da v2.1.222, Claude Code também poderia relatar essa falha em conexões de gateway alcançadas através de ANTHROPIC_BASE_URL ou ANTHROPIC_AWS_BASE_URL enquanto os pings de keep-alive do servidor ainda estavam chegando, porque contava apenas eventos de resposta analisados lá; atualizar para a versão mais recente interrompe esses tempos limite espúrios nessas rotas. Gateways alcançados através de uma URL de base de provedor como ANTHROPIC_BEDROCK_BASE_URL não são envolvidos pelo watchdog de byte; veja Streaming idle watchdogs.

• Se Claude tivesse completado apenas seu pensamento, Claude Code reemite a solicitação. Quando os fluxos reemitidos quebram da mesma forma, o turno termina com Part of the response never arrived and no response was produced. Try again. ou The response stream was malformed and no response was produced. Try again.
• Se nada tivesse sido concluído, Claude Code reenvia a solicitação sem streaming. Se você desativou esse fallback com CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK, o turno termina com API Error: Content block not found para um evento descartado ou API Error: Content block already closed para um duplicado. Para um evento danificado com o fallback desativado, o turno termina com API Error: Stream event unreadable ou o erro bruto do analisador.

• Anteriormente na resposta, Claude Code ou tenta novamente a falha ou termina o turno com um erro diferente. Veja Automatic retries.
• Quando uma dessas falhas chega depois que Claude terminou a resposta, Claude Code mantém a resposta completa e termina o turno normalmente, sem este aviso. Antes da v2.1.222, Claude Code mostrava este aviso quando a conexão era interrompida ou travava após a resposta terminar, e relatava o turno como um erro mesmo que a resposta fosse completa.
• Em uma sessão não interativa, como uma execução -p, uma execução do Agent SDK ou uma sessão na nuvem, você não precisa enviar continue você mesmo quando a resposta cortada está na conversa principal e contém texto mas nenhuma chamada de ferramenta: Claude Code mantém a saída parcial e solicita a Claude continuar de onde parou, até três vezes seguidas. Você vê este aviso para tal resposta apenas uma vez que Claude Code tenha usado essas continuações. Antes da v2.1.246, Claude Code terminava um turno não interativo com este aviso na primeira interrupção.
• Em um subagent, seja a sessão interativa ou não: quando sua resposta cortada contém texto mas nenhuma chamada de ferramenta, Claude Code solicita ao subagent continuar. O aviso se torna a última mensagem do subagent apenas uma vez que essas continuações sejam usadas. Antes da v2.1.257, um subagent mostrava este aviso na primeira interrupção.

• Em uma sessão interativa, leia a resposta que permanece na tela: Claude Code mantém cada bloco que Claude completou antes do erro, mas descarta um bloco final interrompido quando o turno termina, então as frases ou chamadas de ferramenta finais podem estar faltando. Responda com continue para que Claude retome seu último bloco completado.
• Em modo não interativo (-p):
  • Com a saída de texto padrão, Claude Code imprime o último bloco de texto completado que ainda mantém de antes no turno, seguido por esta mensagem. Quando não mantém nenhum, Claude Code imprime apenas esta mensagem, por exemplo porque Claude Code compactou a conversa no meio do turno e limpou esse texto. Antes da v2.1.219, Claude Code imprimia apenas esta mensagem na saída de texto -p e descartava a resposta que já havia produzido.
  • Com --output-format json ou stream-json, Claude Code relata esta mensagem no campo result.
  • Para continuar o turno uma vez que a conexão esteja estável, retome a sessão e envie continue conforme descrito em Continue conversations.

​

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 a moment 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. Uma falha transitória não está relacionada à elegibilidade de auto mode; você não precisa alterar configurações
• Se as tentativas continuarem falhando, continue com tarefas somente leitura e volte à ação bloqueada mais tarde
• No Amazon Bedrock, se a mensagem retornar em cada tentativa, verifique se sua conta pode invocar o modelo que ela nomeia: para modelos padrão do Amazon Bedrock, confirme que sua política IAM permite invocá-lo; para IDs de modelo Mantle, entre em contato com sua equipe de conta AWS

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 tem sucesso na próxima tentativa
• Execute claude --debug e repita a ação para detalhes 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

• Para um subagent em segundo plano em uma execução -p sem --input-format stream-json, Claude Code retorna um resultado de erro contendo Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode
• Em todos os outros lugares, incluindo sessões interativas e a conversa principal de uma execução -p, Claude Code retorna essa negação a Claude

• 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 auto mode enviou a conversa para o classificador
• Tentar novamente não ajudará; o mesmo conteúdo de conversa acionará o filtro novamente
• Em uma sessão interativa, mude para um modo de permissão diferente para que você possa aprovar a ação quando solicitado
• Inicie uma conversa nova sem o conteúdo acionador

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

• Em uma sessão interativa, auto mode volta para um prompt de permissão normal para essa ação para que você possa aprová-la ou negá-la manualmente
• Para um subagent em segundo plano em uma execução -p não interativa sem --input-format stream-json, Claude Code retorna um resultado de erro contendo Agent aborted: auto mode classifier transcript exceeded context window in headless mode, e a execução continua
• Em outro lugar em uma execução -p sem um --permission-prompt-tool, não há prompt para voltar, então a ação não é executada e a execução continua

• Em uma sessão interativa, aprove ou negue a ação no prompt que aparece
• Em uma sessão interativa, execute /compact para reduzir o tamanho da conversa para que ações subsequentes se encaixem novamente na janela do classificador

​

The server returned no safety verdict

The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.

Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

• Em uma sessão interativa, a mensagem aparece como um aviso na transcrição e o turno termina
• Em uma execução -p não interativa, a execução termina e relata um erro de execução. Com a saída de texto padrão, a mensagem é impressa em stderr.
• Quando um subagent atingiu o limite, o subagent para antes de terminar, e Claude recebe o que produziu com uma nota de que auto mode o interrompeu

• Envie outra mensagem para que Claude tente novamente. A contagem de respostas começa do zero.
• Se a parada se repetir e suas solicitações passarem por um gateway ou proxy LLM, verifique se ele corta respostas de streaming ou as reescreve. Revisão de classificador do lado do servidor diz qual comportamento de gateway causa negações, e o guia de compatibilidade de gateway lista o que passar inalterado.
• Defina CLAUDE_CODE_AUTO_MODE_SERVER=0 antes de iniciar Claude Code para usar suas próprias solicitações de classificador. Antes da v2.1.281, Claude Code não lia a variável em uma conexão direta com a API Anthropic.
• Para aprovar as ações você mesmo, mude para fora de auto mode

​

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
• Uma vez que o erro subjacente seja resolvido, peça a Claude para tentar novamente a tarefa ou retomar o subagent

​

Limites de uso

​

You’ve hit your session limit

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
You've hit your Sonnet limit · resets 3:45pm

• Aguarde o horário de reset mostrado no erro
• Na aba Code do Desktop app, o cartão de limite de sessão oferece uma caixa de seleção Auto-continue when limits reset. O cartão de limite semanal não oferece. Quando marcada, o Desktop app tenta novamente o turno interrompido após o reset e mostra o horário da tentativa no cartão. A caixa de seleção do Desktop e a configuração Continue automatically at usage limit da CLI em /config são separadas, portanto, desative cada uma por conta própria.
• Para o limite de Opus ou Sonnet, execute /model e mude para um modelo fora dessa família para continuar trabalhando. Cada modelo tem seu próprio cache de prompt, portanto, a próxima requisição relê toda a conversa sem acertos de cache; veja Switching models
• 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. Veja usage credits for paid plans para saber como isso é cobrado.
• Para atualizar seu plano para limites base mais altos, veja claude.com/pricing

​

Usage credits required for 1M context

API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

• Execute /model e selecione a variante sem o sufixo [1m] para voltar à janela de contexto padrão
• Onde a mensagem menciona /usage-credits, execute-a para ativar a cobrança medida para a variante 1M em Pro e Max, ou para solicitar créditos de uso ao seu administrador em Team e Enterprise. Depois que os créditos de uso estiverem ativados, reinicie Claude Code ou inicie uma nova sessão, o que a mensagem disser. Até então, a sessão permanece no limite de contexto padrão.
• Se o erro persistir após /model, um ID de modelo 1M pode estar definido em outro lugar. Veja Setting your 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

​

The prompt to confirm went unanswered

Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

• Onde a sessão é executada, no terminal ou no aplicativo que a hospeda, envie outro prompt e responda o prompt de consentimento quando ele reaparecer. Para uma sessão em background, anexe-a primeiro da agents view. Reenviar de um cliente Remote Control mostra esta mensagem novamente, porque o cliente não pode exibir o prompt.
• Execute /model para mudar para um modelo que não cobra créditos de uso
• Para dar a si mesmo mais tempo, defina dialogExpiry para um valor mais longo ou "never"

​

Server is temporarily limiting requests

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

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

​

Request rejected (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 perdido em seu ambiente pode rotear requisições através de uma chave de nível inferior 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 Anthropic, veja 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

​

You’ve hit your monthly spend limit

You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

• Em Pro e Max, aumente seu limite de gastos mensais em Settings > Usage em claude.ai, ou execute /usage-credits
• Em Team e Enterprise, aumente o limite em Organization settings > Usage se você gerencia o faturamento, ou peça a um administrador. /usage-credits envia essa solicitação ao seu administrador para você
• Para o limite de um canal, peça a um proprietário da organização ou ao gerenciador do canal para aumentá-lo em claude.ai. Veja Per-channel limits na documentação Claude Tag
• Se a mensagem nomear um horário de reset para a janela do seu plano, você pode aguardar em vez disso
• Execute /usage para ver as janelas do seu plano e quando cada uma é resetada

​

Spend limit reached

spend limit reached (daily; resets 2026-08-09 00:00 UTC)

• Aguarde o horário de reset que a mensagem nomeia, ou siga as instruções do operador se a mensagem as carregar
• Peça ao seu operador de gateway para aumentar o limite se você o atingir rotineiramente

​

Credit balance is too low

Credit balance is too low

• Se você tem um plano Pro, Max, Team ou Enterprise e vê isso, execute /status e verifique a linha API key. Um ANTHROPIC_API_KEY aprovado em seu ambiente roteia requisições através dessa chave em vez de sua assinatura. Desdefina-o no shell atual e remova-o do seu perfil de shell, depois relance claude. Execute /login se você ainda não se conectou com sua assinatura.
• 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
• Defina limites de gastos por workspace no Console para evitar que um único projeto drene o saldo da organização. Veja Manage costs effectively.

​

Could not update your spend limit

Could not update your spend limit: <reason from the server>

• Se a mensagem incluir uma razão, escolha um limite que a satisfaça, como um valor menor
• Se a mensagem mostrar apenas a forma genérica, tente novamente; a falha pode ser transitória
• Se a alteração continuar falhando, faça-a a partir de suas claude.ai billing settings no navegador em vez disso

​

Erros de autenticação

​

Not logged in

Not logged in · Please run /login

• Execute /login para se autenticar com sua assinatura Claude ou conta do 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 o claude
• Para CI ou automação em que o login interativo não é possível, configure um script apiKeyHelper que obtenha uma chave na inicialização
• Consulte Precedência de autenticação para entender qual credencial o Claude Code usa quando várias estão presentes

​

Could not resolve authentication method

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 a v2.1.176 ou posterior se isso aparecer em uma sessão em segundo plano ou na nuvem e suas credenciais já estiverem configuradas
• Confirme que ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN ou as credenciais do seu provedor de nuvem estão definidas no ambiente que inicia o worker, e não apenas no seu shell interativo
• Para o Agent SDK, consulte configuração de autenticação no início rápido
• Execute /status em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida

​

Invalid API key

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
• No mesmo shell, execute env | grep ANTHROPIC, ou no PowerShell Get-ChildItem Env:ANTHROPIC*. Ferramentas como direnv, plugins de shell dotenv e terminais de IDE podem carregar uma chave desatualizada de um arquivo .env no seu projeto sem que você a defina explicitamente.
• Remova a definição de ANTHROPIC_API_KEY e execute /login para usar a autenticação por assinatura
• Se a chave vier de um script apiKeyHelper, execute o script diretamente para confirmar que ele imprime uma chave válida no stdout
• Execute /status para confirmar qual fonte de credencial o Claude Code está realmente usando

​

Your apiKeyHelper script is failing

• O comando terminou com um erro ou atingiu o timeout
• O comando não imprimiu nada no stdout
• O comando imprimiu algo além da chave, como um banner de login ou uma linha de log. O painel mostra returned output that cannot be used as an API key e informa o que está errado, sem repetir a saída. Antes da v2.1.227, o Claude Code enviava o que quer que o comando imprimisse, após remover os espaços em branco ao redor.

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 diretamente no seu shell o comando configurado em apiKeyHelper 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 no seu SSO ou cofre de segredos
• Corrija o comando para que ele imprima apenas a chave no stdout, como um único token de ASCII imprimível de até 16.384 caracteres, e termine com código de saída 0. Consulte rotacionar credenciais com apiKeyHelper para uma configuração funcional.
• Execute /status para ver a falha e confirmar que apiKeyHelper é a fonte de credencial ativa. A linha apiKeyHelper mostra Failing com o detalhe da última falha, como o código de saída e a saída de erro do comando, e desaparece após a próxima execução bem-sucedida. Antes da v2.1.274, /status mostrava apenas a fonte de credencial, não a falha.
• Cada vez que o comando falha, seu código de saída e sua saída de erro também aparecem em um painel Authentication no terminal. Antes da v2.1.212, o painel se chamava Cloud authentication.

​

Invalid request header value

Invalid auth token · Fix external auth token
Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
Invalid request header from the environment · Fix the environment variable

• Invalid auth token: um bearer token de ANTHROPIC_AUTH_TOKEN ou CLAUDE_CODE_OAUTH_TOKEN
• Invalid ANTHROPIC_CUSTOM_HEADERS: um nome ou valor de cabeçalho que você definiu em ANTHROPIC_CUSTOM_HEADERS. A descrição indica pela contagem qual par Name: Value está com problema, como distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS, sem repetir o nome ou o valor, já que você escolheu ambos.
• Invalid request header from the environment: um valor que o Claude Code copia para um cabeçalho de requisição a partir de outra variável de ambiente, como CLAUDE_AGENT_SDK_CLIENT_APP. A descrição informa a variável a corrigir.

Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).

• Defina novamente a variável ou configuração que a mensagem indica, redigitando os caracteres ao redor da posição informada em vez de colar da mesma fonte novamente
• Para ANTHROPIC_CUSTOM_HEADERS, mantenha um par Name: Value por linha e reescreva o par que a mensagem indica
• Execute /status para confirmar qual fonte de credencial está ativa

​

This organization has been disabled

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.

• Remova a definição de ANTHROPIC_API_KEY no shell atual e remova-a do perfil do seu shell, depois inicie o claude novamente
• Se a mensagem disser Update or unset, você não tem um login salvo para usar como alternativa. Remova a definição da chave e execute /login, ou substitua a chave por uma de uma organização do Console ativa.
• Execute /status em seguida para confirmar que a credencial ativa é sua assinatura
• Se nenhuma variável de ambiente estiver definida e o erro persistir, entre em contato com o suporte ou faça login com uma conta diferente.

​

Your organization has disabled API key authentication

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
Your organization has disabled API key authentication · Sign in again with your claude.ai account

• Se a mensagem mencionar ANTHROPIC_API_KEY, remova sua definição no shell atual e remova-a do perfil do seu shell ou do arquivo .env, depois inicie o claude novamente
• 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 em seguida para confirmar que a credencial ativa é sua assinatura e não 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 que a reative no Console

​

Your organization has disabled Claude subscription access

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

​

Routines are disabled by your organization’s policy

Routines are disabled by your organization's policy.

• Peça a um Owner da sua organização que ative a opção Routines em claude.ai/admin-settings/claude-code
• Para trabalhos agendados pontuais que não exigem rotinas no nível da organização, consulte tarefas agendadas

​

Remote Control requires the Anthropic API

Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.

• Uma variável de provedor CLAUDE_CODE_USE_*, como CLAUDE_CODE_USE_BEDROCK para o Amazon Bedrock ou CLAUDE_CODE_USE_VERTEX para o Agent Platform do Google Cloud
• ANTHROPIC_BASE_URL apontando para um host diferente de api.anthropic.com, como um gateway de LLM ou proxy, mesmo quando você faz login com claude.ai; antes da v2.1.196, uma URL base personalizada não bloqueava o Remote Control
• ANTHROPIC_UNIX_SOCKET definida, de modo que a sessão envia suas requisições por um socket local em vez de para api.anthropic.com
• Um login de gateway de nuvem corporativo feito pelo /login, que não oferece suporte ao Remote Control e não tem variável para remover

• Remova a definição da variável que a mensagem menciona, como CLAUDE_CODE_USE_BEDROCK ou ANTHROPIC_BASE_URL, e reinicie a sessão, ou inicie o Remote Control a partir de uma sessão que se comunica diretamente com a Anthropic API
• Se a variável não estiver definida no seu shell, verifique a chave env nos seus arquivos de configuração, que aplica variáveis de ambiente a todas as sessões
• Para esta e as outras mensagens de inicialização do Remote Control, consulte Solução de problemas do Remote Control

​

Remote Control couldn’t refresh your login

Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
Remote Control disconnected — Signed out of Claude — run /login, then /remote-control

• Claude.ai login expired e Claude.ai login was rejected: o claude.ai não aceita mais seu token de login salvo, porque ele expirou ou foi revogado
• OAuth token unavailable: o Claude Code não tinha nenhum token de login salvo quando a credencial da conexão precisou ser renovada
• OAuth token refresh failed: o claude.ai rejeitou seu token de login salvo enquanto o Claude Code estava se reconectando, e a atualização do token não produziu um novo
• JWT refresh failed: no OAuth token: o Claude Code não encontrou nenhum token de login salvo para renovar
• Signed out of Claude: você fez logout nesta máquina, por exemplo, executando /logout em outro terminal, então o Claude Code não tem mais nenhum login salvo para renovar a conexão

• Execute /login para fazer login novamente
• Execute /remote-control para reconectar a sessão. Mensagens que terminam com run /login to restore Remote Control não precisam desta etapa: o Claude Code se reconecta sozinho assim que você faz login.

​

Remote Control stopped because the signed-in account changed

Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

• Execute /remote-control para iniciar uma nova sessão do Remote Control na conta ou organização atual
• Para voltar, execute /login e faça login novamente na conta ou organização anterior. Depois execute /remote-control.

​

Remote Control stopped because the app running the session signed out or switched accounts

Remote Control stopped — the app running this session is now signed in to a different Claude account
Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on

• Se o aplicativo estiver desconectado, faça login nele novamente e depois reative o Remote Control no aplicativo
• Se o aplicativo trocou de conta, o Claude Code não pode continuar a sessão encerrada na nova conta. Inicie uma nova sessão do Remote Control nessa conta.

​

OAuth token revoked or expired

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

Failed to authenticate: OAuth token revoked. Please log in again or contact your administrator.
Failed to authenticate. API Error: 401 OAuth token has expired ...

• Execute /login no prompt do Claude Code para fazer login novamente
• Se o seu comando -p ou programa do Agent SDK usa um login salvo, execute claude no mesmo ambiente, conclua o /login e então execute o comando ou programa novamente. Para automação que não pode fazer login interativamente, autentique-se com ANTHROPIC_API_KEY ou gere um token de longa duração com claude setup-token.
• Se você se autentica com a variável de ambiente CLAUDE_CODE_OAUTH_TOKEN, o Claude Code continua enviando o valor que você definiu depois que uma requisição falha com 401, em vez de passar para o token de um login armazenado. /status mostra essa credencial como uma linha Auth token com o valor CLAUDE_CODE_OAUTH_TOKEN. Gere um novo token com claude setup-token e reinicie com ele, ou remova a definição da variável e execute /login. Antes da v2.1.225, o Claude Code podia substituir o valor da variável no meio da sessão pelo token de acesso de curta duração de um login armazenado, e a sessão falhava novamente com erros 401 quando esse token expirava.
• Para solicitações repetidas de login entre inicializações, consulte as verificações do relógio do sistema e as etapas de recuperação do armazenamento de credenciais do macOS em Solução de problemas
• Para outras falhas, incluindo 403 Forbidden e problemas de OAuth no navegador, consulte Login e autenticação

​

API Error: 401 Invalid authentication credentials

Please run /login · API Error: 401 Invalid authentication credentials

• Se /status mostrar uma linha API key que não esteja marcada como não utilizada, uma ANTHROPIC_API_KEY aprovada é a credencial ativa e tem precedência sobre seu login, então o /login não a substitui. Rotacione a chave no Claude Console, ou volte para sua assinatura executando unset ANTHROPIC_API_KEY, ou no PowerShell Remove-Item Env:ANTHROPIC_API_KEY.
• Se /status mostrar apenas seu login, execute /login uma vez. Se a credencial foi revogada, um novo login a substitui.
• Se a mesma mensagem voltar para a mesma conta de login, a conta ou a organização não está mais ativa. Verifique a conta e a organização que /status informa e peça ao administrador da sua organização que restaure o acesso.
• Se ANTHROPIC_BASE_URL apontar para um gateway de LLM, o texto após 401 é a mensagem do seu gateway e não da Anthropic, e o /login não a altera. Em vez disso, corrija a credencial que seu gateway espera.

​

Login expired

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 todas as requisições.
• Se você fizer login com sua conta claude.ai em outra janela do Claude Code, consulte Not logged in para saber quando esta sessão passa a usar esse login por conta própria.
• No modo não interativo, execute claude no mesmo ambiente, conclua o /login e então execute seu comando novamente. Para automação que não pode fazer login interativamente, autentique-se com ANTHROPIC_API_KEY ou gere um token de longa duração com claude setup-token.
• Se o login continuar falhando, consulte Login e autenticação

​

Could not refresh your login because another Claude Code process is refreshing it

Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login

Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

• Tente novamente em um minuto. Se outro processo concluir a atualização primeiro, esta sessão usa o login renovado.
• Se a mensagem continuar voltando, feche as outras janelas e processos do Claude Code e tente novamente.
• Se ela voltar sem nenhum outro processo do Claude Code em execução, execute /login. Fazer login novamente não espera pelo bloqueio de atualização.

​

Couldn’t save your login

Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
Couldn't save your login. Try logging in again.

• No macOS, desbloqueie o keychain de login e então execute /login novamente
• Em outras plataformas, execute /login novamente
• Se o login ainda não for salvo, consulte Não conectado ou token expirado para o comando de desbloqueio do keychain e outras etapas de recuperação do armazenamento de credenciais

​

Failed to start OAuth callback server

Failed to start OAuth callback server: Failed to start server. Is port 0 in use?

• Para fazer login imediatamente sem o listener local: se você usa uma assinatura claude.ai, execute claude setup-token em uma máquina onde o login funciona e defina o token que ele imprime como CLAUDE_CODE_OAUTH_TOKEN nesta máquina. Caso contrário, defina ANTHROPIC_API_KEY com uma chave do Claude Console. Precedência de autenticação explica como o Claude Code escolhe entre credenciais.
• Para usar o login pelo navegador nesta máquina, o Claude Code precisa conseguir escutar em 127.0.0.1. Se ele for executado dentro de um sandbox, verifique se a política do sandbox permite escutar em portas locais e então execute /login novamente. Se ele deveria conseguir e ainda assim falhar, execute /feedback para que o relatório inclua os detalhes do seu ambiente.

​

Claude login not accepted

Claude login not accepted · Run /login, then try again

• Execute /login, conclua o login e então inicie a sessão novamente

​

Artifacts need a claude.ai login

Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

• Execute /login e selecione Claude account with subscription. A opção Anthropic Console account não fornece credenciais claude.ai.
• Quando a mensagem mencionar uma credencial que tem precedência, como ANTHROPIC_API_KEY, uma configuração apiKeyHelper ou uma chave do Console salva por um /login anterior, remova-a da forma que a mensagem indica e então execute /login
• Quando a mensagem disser que esta sessão remota se autentica pela máquina que a iniciou, faça login no claude.ai nessa máquina e então reconecte a sessão
• Quando a mensagem disser que a credencial é injetada pelo ambiente host da sessão, você não pode alterá-la nessa sessão; inicie uma sessão que esteja conectada ao claude.ai
• Consulte Disponibilidade para os outros requisitos dos artefatos, como plano, provedor de modelo e política da organização

​

Administrator policy requires a Cloud gateway sign-in

Not signed in to the Cloud gateway — run /login.

Administrator policy requires a Cloud gateway sign-in on this machine, but this session is configured with an API key from ANTHROPIC_API_KEY, which a gateway machine does not accept.

To continue: unset ANTHROPIC_API_KEY (or run in a shell without it), then run claude and sign in with /login.

• Para Not signed in to the Cloud gateway, execute /login e conclua o login na tela Cloud gateway
• Para a mensagem de inicialização, remova a credencial seguindo as etapas no final da mensagem
• Se você acredita que a máquina não deveria exigir o gateway, peça ao administrador que a gerencia que remova forceLoginMethod e forceLoginGatewayUrl das configurações gerenciadas dela

​

Your account is on hold

Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted

• Abra o link na mensagem para ver os detalhes da suspensão ou contestá-la
• Se você tiver outra conta Claude ou uma chave de API que não seja afetada pela suspensão, pode continuar trabalhando enquanto a suspensão é resolvida: execute /login com essa conta ou defina a chave com ANTHROPIC_API_KEY

​

Anthropic profile login expired

Anthropic profile login expired · Re-authenticate your Anthropic profile
Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile

• Se a mensagem começar com Login expired, execute /login para entrar novamente
• Para renovar um perfil que o login sem chave do Console ou o ant auth login da CLI da Claude Platform gravou, execute /login em uma máquina que ofereça o login sem chave. Escolha a conta do Anthropic Console e depois Sign in with your Console account. O Claude Code substitui a credencial expirada nesse perfil
• Para renovar um perfil que outra ferramenta criou, entre novamente com essa ferramenta. Se, em vez disso, você escolher Sign in with your Console account no /login, o Claude Code deixa o perfil como está e cria uma chave de API
• Se um administrador provisionou a credencial do perfil, peça a ele que emita uma nova
• Execute /status para confirmar a fonte de credencial ativa e o nome do perfil
• Para deixar de usar o perfil, remova a definição de ANTHROPIC_PROFILE se você a definiu e então autentique-se de outra forma, como /login ou ANTHROPIC_API_KEY

• Quando o Claude Code descobriu o perfil a partir do seu diretório de configuração e o modo de autenticação dele é user_oauth, a mensagem começa com Login expired e oferece /login primeiro. O Claude Code dá a um /login funcional precedência sobre o perfil descoberto e então se autentica com sua conta claude.ai. Da v2.1.234 até a v2.1.277, essa forma dizia Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile. Antes da v2.1.234, o Claude Code também mostrava a forma Re-authenticate your Anthropic profile nesse caso.
• Quando você selecionou o perfil com ANTHROPIC_PROFILE, a mensagem começa com Anthropic profile login expired.

​

OAuth scope requirement

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

​

claude.ai rejected the session token

claude.ai rejected the session token. Run /login, then reconnect.

• Execute /login para fazer login novamente
• Reconecte o conector pelo /mcp ou execute /mcp reconnect <server>. Reconectar antes de fazer login novamente deixa o conector no mesmo estado. A opção Reconnect do painel /mcp informa your claude.ai session token was rejected; a forma digitada /mcp reconnect <server> informa uma reconexão bem-sucedida mesmo que o token ainda seja rejeitado.

​

MCP server needs you to sign in again

MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)

MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate

​

MCP server URL is missing or not a valid URL

Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.

• Defina a url da entrada como o endpoint real do servidor onde o servidor está configurado, ou defina a variável de ambiente que sua referência ${VAR} indica, e então execute o login novamente.

​

Issuer mismatch in authorization response

Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

• Tente o login novamente pelo /mcp
• Se o erro se repetir, relate-o ao operador do servidor. A correção é no lado do servidor: o servidor de autorização deve retornar no parâmetro iss o mesmo emissor que anuncia em seus metadados
• Para se conectar enquanto o servidor está sendo corrigido, inicie o Claude Code com MCP_SDK_GENERATION=v1, cujo runtime não executa esta verificação. Isso remove uma proteção contra ataques de mix-up, então prefira a correção no lado do servidor

​

Refusing to send credentials to non-https token endpoint

Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).

• Sirva esse endpoint de token por HTTPS, por exemplo, colocando o servidor atrás de um proxy reverso ou túnel que termine o TLS e configurando o servidor para anunciar o endereço https://
• Para se conectar sem alterar o servidor, inicie o Claude Code com MCP_SDK_GENERATION=v1, cujo runtime não aplica esta regra e envia a requisição de token por HTTP simples. Essa escolha dura até você sair e se aplica a todos os servidores. O runtime v1 também ignora a verificação do emissor, então prefira servir o endpoint por HTTPS

​

AWS credentials expired or invalid

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

• Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
• Se awsAuthRefresh estiver definido, execute em outro terminal o comando indicado na mensagem, como aws sso login --profile myprofile, e conclua o login no navegador, depois tente novamente. Caso contrário, atualize você mesmo a credencial da AWS que usa: seu login SSO, chaves de acesso, chave de API ou token de proxy
• Com awsAuthRefresh definido em uma sessão interativa, você pode, em vez disso, executar /login, escolher 3rd-party platform e então selecionar Claude Platform on AWS · refresh credentials em Using 3rd-party platforms para executar o mesmo comando sem reiniciar o Claude Code. Consulte Configurar credenciais da AWS
• Se o erro se repetir depois que o comando de atualização for bem-sucedido, confirme que a identidade é válida fora do Claude Code com aws sts get-caller-identity no mesmo shell e perfil

​

AWS authentication failed

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

• Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
• Atualize suas credenciais da AWS caso uma credencial expirada seja a causa: execute o comando awsAuthRefresh indicado na mensagem, quando houver um definido, ou atualize você mesmo seu login SSO, chaves de acesso, chave de API ou token de proxy
• Se suas credenciais estiverem atualizadas, confirme que as permissões do IAM em Configuração do 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 requisições usam

​

Google Cloud credentials expired or invalid

Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...

• Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
• Se você se autentica com application default credentials, execute o comando gcpAuthRefresh indicado na mensagem, ou gcloud auth application-default login, e conclua o login, depois tente novamente
• Se você faz o roteamento por um gateway de LLM com CLAUDE_CODE_SKIP_VERTEX_AUTH definida, atualize o token do gateway em ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_CUSTOM_HEADERS e então tente novamente
• Se você se autentica com um arquivo de chave de conta de serviço, confirme que GOOGLE_APPLICATION_CREDENTIALS aponta para uma chave válida. Consulte Configurar credenciais do GCP
• Se o erro se repetir após uma atualização, confirme que a identidade funciona fora do Claude Code com gcloud auth application-default print-access-token no mesmo shell

​

Google Cloud authentication failed

Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...

• Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com o seu administrador
• Confirme se as funções em Configuração de IAM foram concedidas à identidade com a qual você se autentica
• Confirme se o modelo está habilitado para o seu projeto. Consulte Solicitar acesso ao modelo

​

Microsoft Foundry authentication failed

Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...

• Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com o seu administrador
• Atualize a credencial que você configurou em Configurar credenciais do Azure: faça a rotação de ANTHROPIC_FOUNDRY_API_KEY, gere um novo ANTHROPIC_FOUNDRY_AUTH_TOKEN ou execute az login para que a cadeia de credenciais padrão do Microsoft Entra possa fazer login novamente
• Se a credencial estiver atualizada, confirme se a identidade tem acesso ao recurso do Foundry. Consulte Configuração do Azure RBAC

​

Could not load AWS or Google Cloud credentials

API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.

• Execute o comando de login do seu provedor, como aws sso login --profile myprofile ou gcloud auth application-default login, e depois tente novamente. Credenciais do Bedrock, Agent Platform ou Foundry não carregando mostra como confirmar as credenciais fora do Claude Code
• Se o detalhe indicar AWS default-chain credential resolve timed out, a cadeia travou em vez de falhar, então siga AWS default-chain credential resolve timed out

​

AWS default-chain credential resolve timed out

API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

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

​

Bedrock setup verification timed out waiting for AWS

Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

A request to AWS timed out. Check your network and proxy settings, then try again.

• Execute aws sts get-caller-identity no mesmo shell. Se ele também travar, o travamento está fora do Claude Code, na sua rede, no seu proxy ou no auxiliar de credenciais do seu perfil da AWS; corrija isso primeiro.
• Conclua qualquer login interativo antes de abrir o assistente, por exemplo aws sso login --profile myprofile
• Se um auxiliar de credenciais no seu perfil da AWS legitimamente precisar de mais de 60 segundos para solicitar sua entrada, aumente o limite em milissegundos com CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

​

Cloud gateway session expired

Cloud gateway session expired — run /login to reconnect.

Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

• Execute /login na sessão e conclua o login no navegador
• Para uma inicialização não interativa, inicie o claude no mesmo ambiente, execute /login e depois execute seu comando novamente

​

Sign-in timed out while waiting for you to continue

Sign-in timed out while waiting for you to continue. Try again.

• Execute /login novamente e confirme a conta antes que o login expire

​

Gateway refused the request

Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

• Peça ao administrador do seu gateway que investigue a requisição. O final API Error: traz a recusa que o gateway retornou
• Para administradores: uma regra de controle de acesso no gateway retorna um 403 que o log de auditoria registra com o motivo, e a negação de autorização de um upstream é repassada conforme Mensagens de erro do upstream

​

Erros de rede e conexão

​

Unable to connect to API

Unable to connect to API. Check your internet connection
Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server — check your internet or DNS (ENOTFOUND)
No internet route — check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
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 veja Network configuration
• Se você rotear através de um gateway de LLM ou relay, defina ANTHROPIC_BASE_URL para seu endereço. Veja Connect Claude Code to an LLM gateway para configuração.
• Certifique-se de que seu firewall permite os hosts listados em Network access requirements
• Falhas intermitentes são tentadas novamente de forma automática; falhas persistentes apontam para um problema de rede local

• Verifique se ANTHROPIC_BASE_URL está definido executando echo $ANTHROPIC_BASE_URL, ou echo $env:ANTHROPIC_BASE_URL no PowerShell, e procure por ele no bloco env de seus arquivos de configurações. Quando está definido, Claude Code envia requisições de modelo para esse endereço em vez de api.anthropic.com, então um valor remanescente apontando para um proxy local ou gateway que não está mais em execução produz Connection refused mesmo que curl alcance a API. Remova-o do seu perfil de shell ou configurações e inicie Claude Code a partir de um novo terminal.
• 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.

​

Unable to connect to Anthropic services

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.

• Se a mensagem nomear uma variável de proxy, verifique se seu valor aponta para o proxy correto e peça ao seu time de rede para permitir conexões HTTPS através dele para o host na mensagem. Veja Network configuration.
• Trabalhe através das verificações em Unable to connect to API. O teste curl e a orientação de firewall lá se aplicam a essa verificação também.
• Se sua rede está aberta e a falha persiste, Claude Code pode não estar disponível em seu país

​

Socket is closed

• Se você vir esse erro, atualize para v2.1.214 ou posterior com claude update, depois envie sua mensagem novamente
• Se os turnos continuarem falhando atrás do mesmo proxy após atualizar, trabalhe através de Unable to connect to API e verifique a configuração do proxy em Network configuration

​

API returned an empty or malformed response

API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.

• Uma cláusula Response: com o tipo de conteúdo, o tipo de corpo, como body is an HTML page ou empty body, seu tamanho em bytes, e se a resposta carregava um id de requisição Anthropic. Quando a resposta nomeia um servidor reconhecível, como nginx ou cloudflare, ou carrega headers intermediários, como cf-ray ou via, a cláusula lista esses também.
• Uma sentença nomeando o id da requisição de streaming com falha e a falha que acionou a nova tentativa. Quando um stream havia aberto antes da falha, também relata quantos eventos de stream chegaram e, se algum chegou, quanto tempo o stream havia ficado silencioso quando a tentativa falhou.

• Leia a cláusula Response: para ver qual sistema respondeu. Um corpo HTML, nenhum id de requisição Anthropic, ou um servidor nomeado como nginx ou cloudflare significa que algo entre Claude Code e a API respondeu em seu lugar
• Se você rotear através de um gateway de LLM, teste a rota com uma requisição direta e corrija o hop que retorna a resposta não-API
• Em uma rede com uma página de login, como Wi-Fi de convidado, complete o login em um navegador, depois tente novamente
• Se apenas a rota sem streaming através de seu gateway está quebrada, defina CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1 para desativar esse fallback, exceto quando o endpoint de streaming em si retorna 404, onde Claude Code ainda recorre ao fallback

​

Streaming response ended before any complete data was received

Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.

• Configure qualquer proxy ou gateway entre Claude Code e seu provedor de modelo para passar corpos de resposta de streaming e seus headers através sem modificação
• Em Amazon Bedrock, veja Streaming errors behind a gateway or proxy para os requisitos de header e corpo

​

Bedrock streaming response has an unexpected content-type

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 header Content-Type através sem modificação. Um intermediário que re-emite o stream como server-sent events é uma causa comum.
• Definir CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 oculta esse erro, mas Claude Code não decodifica um corpo binário sob um header reescrito, então essas requisições recorrem a um caminho sem streaming mais lento como fallback. Veja Streaming errors behind a gateway or proxy.

​

SSL certificate errors

Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config

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 bundle de CA de sua organização e aponte Claude Code para ele com NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
• Veja Network configuration para instruções de configuração completa
• Não defina NODE_TLS_REJECT_UNAUTHORIZED=0, que desabilita a validação de certificado inteiramente

​

Host not allowed in a cloud session

HTTP 403
x-deny-reason: host_not_allowed

• Abra seu ambiente para edição, ou a partir do formulário da rotina ou a partir do seletor de ambiente onde você inicia sessões na nuvem.
• No diálogo Edit 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 allowlist 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 allowlist atualizada. Para uma sessão na nuvem que já está aberta, veja quando uma mudança de acesso de rede alcança sessões existentes.

​

The proxy refused the connection

artifact content fetch failed (proxy refused the connection: HTTP 407)
artifact content fetch failed (proxy refused the connection: HTTP 403)
the proxy refused the connection to the artifact's content host (HTTP 502)

• HTTP 407: o proxy requer credenciais que não recebeu. Coloque-as na URL do proxy, como Basic authentication mostra.
• HTTP 403: o proxy recusa fazer túnel para *.frame.claudeusercontent.com. Peça a quem executa o proxy para permitir esse host, que Network access requirements lista.
• Qualquer outro status, como HTTP 502: o proxy não abriu o túnel por seu próprio motivo, como falhar ao alcançar o host. Procure o status nos logs do proxy.
• unreadable reply no lugar de um status: o que está no endereço do proxy não respondeu com uma linha de status HTTP. Verifique se o endereço é um proxy HTTP.

• Verifique o endereço e credenciais na variável de proxy, como Proxy configuration descreve, depois execute curl -x http://proxy.example.com:8080 -I https://api.anthropic.com a partir do shell em que você inicia Claude Code, usando sua própria URL de proxy. No Windows PowerShell, execute curl.exe. Se essa sonda falhar da mesma forma, corrija a configuração do proxy primeiro. Se funcionar, a recusa é específica para o host do artefato.
• Se sua rede deixa Claude Code alcançar o host do artefato diretamente, adicione .frame.claudeusercontent.com a NO_PROXY. Mantenha a entrada estreita: uma entrada .claudeusercontent.com mais ampla também contorna o proxy para bridge.claudeusercontent.com, que organizações com IP allowlisting precisam manter no proxy.

​

The cloud environments service returned an empty or unexpected response

The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.

• Tente novamente a ação. Claude Code solicita a lista novamente cada vez
• Se a mensagem continuar aparecendo, verifique status.claude.com para incidentes ativos

​

Failed to fetch session from Sessions API

Failed to fetch session from Sessions API: Failed to fetch session logs

• Execute o mesmo teleport novamente. Se falhar da mesma forma, relate o problema

​

Couldn’t reconnect to your Remote Control session

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 uma nova sessão com claude --remote-control para criar uma nova sessão Remote Control
• Para outras mensagens de inicialização do Remote Control, veja Troubleshoot Remote Control

​

Sessions ended while this machine was offline

2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.

• Quando Claude Code lista worktrees mantidos sob essa mensagem, recupere qualquer trabalho não commitado deles
• Execute claude remote-control para iniciar um ambiente novo

​

Couldn’t share the transcript

Couldn't share the transcript.

• Execute /feedback para enviar a transcrição com uma descrição do que aconteceu. Veja Report an error se /feedback não estiver disponível em seu ambiente
• Se outras requisições também estão falhando, verifique sua conexão de rede e veja Unable to connect to API

​

Couldn’t send feedback

Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

• : not signed in. Run /login, then retry.: o diálogo carrega apenas quando Claude Code encontrou credenciais Anthropic ao abrir, e nenhuma era utilizável no momento em que você enviou. Por exemplo, você fez logout nesta máquina nesse meio-tempo, ou seu login não pôde mais ser atualizado.
• Um parêntese: (server returned <status>) é o código de resposta do serviço; (request timed out) e (couldn't reach the service) são falhas de rede. Quando Claude Code não consegue nomear um motivo, o parêntese está ausente.

• Para a redação de não autenticado, execute /login e envie novamente
• Caso contrário, envie novamente; se outras requisições também estão falhando, verifique sua conexão de rede e veja Unable to connect to API
• Se continuar falhando, registre o relatório em github.com/anthropics/claude-code/issues, como a mensagem diz

​

Erros de requisição

​

Prompt é muito longo

Prompt is too long

Context limit reached · /compact or /clear to continue

Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on

Prompt is too long · automatic compaction failed: <the underlying error>

• Quando não consegue resumir nenhuma troca completa, Claude Code mantém seu prompt mais novo palavra por palavra e resume tudo antes dele.
• Nesse caso, quando a conversa não termina com seu prompt, Claude Code resume a conversa inteira.

Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.

• Execute /compact para resumir turnos anteriores e liberar espaço, ou /clear para começar do zero. Se /compact responder Not enough messages to compact., a conversa é uma troca única sem nada anterior para resumir, então o espaço é ocupado por esse prompt e o que Claude Code envia com cada requisição: execute /clear e reenvie com menos texto colado ou anexos menores, ou reduza as definições de ferramentas e arquivos de memória usando as etapas abaixo
• Execute /context para ver um detalhamento do que está consumindo a janela: system prompt, 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
• A compactação automática está ativada por padrão e normalmente previne esse erro. Se você a desativou em /config ou com DISABLE_AUTO_COMPACT, ative-a novamente. Se você mantê-la desativada, execute /compact você mesmo antes da janela se encher.

​

Contexto excede o limite de tokens

Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.

Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.

• Em uma conversa com múltiplos turnos, execute /compact para resumir turnos anteriores e liberar espaço. Para começar do zero, execute /clear
• Para mais formas de reduzir o uso, veja Prompt é muito longo

​

Requisição muito grande

Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.

• Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).: imagens ou documentos empurraram a requisição para além do limite. Claude Code tenta novamente com eles removidos.
• Request too large for the API's 32MB request limit: as mensagens sozinhas estão acima do limite, então a mensagem diz compacting cannot make it fit e Claude Code não tenta novamente. Em modo não interativo, a mensagem diz para você reduzir a entrada ou iniciar uma nova sessão.

• Se a mensagem diz compacting cannot make it fit, pressione Esc duas vezes para voltar além do turno que adicionou o conteúdo grande, ou execute /clear para começar do zero
• Caso contrário, execute /compact, que remove imagens e anexos acumulados
• Referencie arquivos grandes por caminho em vez de colar seu conteúdo, para que Claude possa lê-los em pedaços
• Para imagens, veja Imagem era muito grande 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 3000 pixels quando mais de 20 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.
Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.

• 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 a partir do cabeçalho do arquivo, sem decodificar a imagem.
• Se a mensagem relatar um limite de dimensão ou tamanho, redimensione ou recomprima a imagem abaixo desse limite antes de anexar.
• Se a mensagem nomear uma causa, como um JPEG CMYK, um WebP animado ou um arquivo possivelmente danificado, salve novamente a imagem no formato que a mensagem sugere e anexe-a novamente.

​

Request rejected as unprocessable by the model

API Error: 400 Request rejected as unprocessable by the model (too many or oversized images, or unsupported parameters)

• Se a mensagem continuar aparecendo em uma conversa com imagens ou documentos, remova-os você mesmo. Pressione Esc duas vezes para voltar antes dos turnos que os adicionaram, ou execute /clear para começar do zero.

​

Erros de PDF

PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
PDF is password protected. Try using a CLI tool to extract or convert the PDF.
The PDF file was not valid. Try converting it to text first (e.g., pdftotext).

• Para PDFs de tamanho excessivo, peça a 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 e tente novamente

pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.

​

Entradas extras não são permitidas

API Error: 400 ... Extra inputs are not permitted ... context_management

• Configure seu gateway para encaminhar o cabeçalho anthropic-beta. Veja passagem de recursos para o que os gateways devem encaminhar.
• Como fallback, defina CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 antes de iniciar. Desabilitar capacidades de pré-lançamento cobre o escopo exato.

​

Esquema de entrada de ferramenta é inválido

API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'