6 6
7> Procure mensagens de erro de tempo de execução do Claude Code com o que cada uma significa e como corrigi-la.7> Procure mensagens de erro de tempo de execução do Claude Code com o que cada uma significa e como corrigi-la.
8 8
9Esta página lista os erros de tempo de execução que o Claude Code exibe e como se recuperar de cada um, além do que verificar quando as respostas parecem incorretas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Troubleshoot installation and login](/pt/troubleshoot-install).9Esta página lista os erros de tempo de execução que o Claude Code exibe e como se recuperar de cada um, além do que verificar quando as respostas parecem incorretas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Troubleshoot installation and login](/docs/pt/troubleshoot-install).
10 10
11Esses erros e comandos de recuperação se aplicam em toda a CLI, no [aplicativo Desktop](/pt/desktop) e no [Claude Code na web](/pt/claude-code-on-the-web), já que todos os três envolvem a mesma CLI do Claude Code. Para problemas específicos da superfície, consulte a seção de solução de problemas na página dessa superfície.11Esses erros e comandos de recuperação se aplicam em toda a CLI, no [aplicativo Desktop](/docs/pt/desktop) e no [Claude Code na web](/docs/pt/claude-code-on-the-web), já que todos os três envolvem a mesma CLI do Claude Code. Para problemas específicos da superfície, consulte a seção de solução de problemas na página dessa superfície.
12 12
13<Note>13<Note>
14 O Claude Code chama a API Claude para respostas do modelo, portanto, a maioria dos erros de tempo de execução mapeia para um código de erro de API subjacente. Esta página cobre o que cada erro significa dentro do Claude Code e como se recuperar. Para as definições de código de status HTTP bruto, consulte a [referência de erro da plataforma Claude](https://platform.claude.com/docs/pt/api/errors).14 O Claude Code chama a API Claude para respostas do modelo, portanto, a maioria dos erros de tempo de execução mapeia para um código de erro de API subjacente. Esta página cobre o que cada erro significa dentro do Claude Code e como se recuperar. Para as definições de código de status HTTP bruto, consulte a [referência de erro da plataforma Claude](https://platform.claude.com/docs/pt/api/errors).
97 Tentativas automáticas97 Tentativas automáticas
98</h2>98</h2>
99 99
100O Claude Code tenta novamente falhas transitórias antes de mostrar um erro. Erros de servidor, respostas sobrecarregadas, tempos limite de solicitação, throttles 429 temporários e conexões perdidas são todos repetidos até 10 vezes com backoff exponencial. {/* min-version: 2.1.198 */}A partir da v2.1.198, isso cobre conexões que caem no meio de uma resposta antes de qualquer saída visível ter sido transmitida: Claude Code re-emite a solicitação com o mesmo backoff e o turno continua em vez de parar com um erro de conexão. {/* min-version: 2.1.199 */}A partir da v2.1.199, throttles 429 temporários que não carregam os cabeçalhos de cota do seu plano também são repetidos quando você está conectado com uma assinatura claude.ai; versões anteriores os repetiam apenas para autenticações de chave de API e Enterprise.100O Claude Code tenta novamente falhas transitórias antes de mostrar um erro. Erros de servidor, respostas sobrecarregadas, tempos limite de solicitação, throttles 429 temporários e conexões perdidas são todos repetidos até 10 vezes com backoff exponencial. A partir da v2.1.198, isso cobre conexões que caem no meio de uma resposta antes de qualquer saída visível ter sido transmitida: Claude Code re-emite a solicitação com o mesmo backoff e o turno continua em vez de parar com um erro de conexão. A partir da v2.1.199, throttles 429 temporários que não carregam os cabeçalhos de cota do seu plano também são repetidos quando você está conectado com uma assinatura claude.ai; versões anteriores os repetiam apenas para autenticações de chave de API e Enterprise.
101 101
102Algumas classes de falha não são repetidas, porque uma tentativa não pode ter sucesso:102Algumas classes de falha não são repetidas, porque uma tentativa não pode ter sucesso:
103 103
104* {/* min-version: 2.1.199 */}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](#ssl-certificate-errors). Condições TLS transitórias, como um tempo limite de handshake, ainda são repetidas.104* 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](#ssl-certificate-errors). Condições TLS transitórias, como um tempo limite de handshake, ainda são repetidas.
105* {/* min-version: 2.1.199 */}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](#the-response-above-may-be-incomplete) 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.105* 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](#the-response-above-may-be-incomplete) 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.
106* {/* min-version: 2.1.208 */}Uma [resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado](#bedrock-streaming-response-has-an-unexpected-content-type) 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.106* Uma [resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado](#bedrock-streaming-response-has-an-unexpected-content-type) 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.
107 107
108Enquanto tenta novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y` após um rótulo de erro. O rótulo nomeia a razão específica da primeira tentativa para falhas em que você pode agir imediatamente: a rede está inativa, um handshake TLS falhou ou você atingiu um limite de taxa. Para outros erros, ele lê `API error` no início. {/* min-version: 2.1.198 */}A partir da v2.1.198, ele muda para a razão específica da terceira tentativa, ou na tentativa final quando `CLAUDE_CODE_MAX_RETRIES` permite menos de três; versões anteriores mudam apenas na tentativa final.108Enquanto tenta novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y` após um rótulo de erro. O rótulo nomeia a razão específica da primeira tentativa para falhas em que você pode agir imediatamente: a rede está inativa, um handshake TLS falhou ou você atingiu um limite de taxa. Para outros erros, ele lê `API error` no início. A partir da v2.1.198, ele muda para a razão específica da terceira tentativa, ou na tentativa final quando `CLAUDE_CODE_MAX_RETRIES` permite menos de três; versões anteriores mudam apenas na tentativa final.
109 109
110{/* min-version: 2.1.198 */}A partir da v2.1.198, a dica de spinner usual é suprimida durante tentativas. Uma vez que a razão do erro é revelada, se a falha for uma sobrecarga 529, a linha abaixo da contagem regressiva também nomeia onde verificar o status do serviço: `status.claude.com` na API Anthropic, ou o host do provedor ou gateway nomeado na mensagem em outras configurações.110A partir da v2.1.198, a dica de spinner usual é suprimida durante tentativas. Uma vez que a razão do erro é revelada, se a falha for uma sobrecarga 529, a linha abaixo da contagem regressiva também nomeia onde verificar o status do serviço: `status.claude.com` na API Anthropic, ou o host do provedor ou gateway nomeado na mensagem em outras configurações.
111 111
112{/* min-version: 2.1.185 */}Se nenhum dado chegar no fluxo de resposta por 20 segundos enquanto uma solicitação ainda está pendente, o spinner mostra `Waiting for API response · will retry in … · check your network` antes de qualquer tentativa ter começado. A solicitação ainda não falhou: a contagem regressiva é executada até o ponto em que Claude Code interrompe a conexão travada e tenta novamente, portanto o banner desaparece por conta própria assim que os dados retomam ou a tentativa é bem-sucedida. A partir da v2.1.185, o limite é de 20 segundos; versões anteriores mostram o banner após 10 segundos com uma redação diferente. Se reaparecer em cada tentativa, trate-o como um [problema de rede](#unable-to-connect-to-api).112Se nenhum dado chegar no fluxo de resposta por 20 segundos enquanto uma solicitação ainda está pendente, o spinner mostra `Waiting for API response · will retry in … · check your network` antes de qualquer tentativa ter começado. A solicitação ainda não falhou: a contagem regressiva é executada até o ponto em que Claude Code interrompe a conexão travada e tenta novamente, portanto o banner desaparece por conta própria assim que os dados retomam ou a tentativa é bem-sucedida. A partir da v2.1.185, o limite é de 20 segundos; versões anteriores mostram o banner após 10 segundos com uma redação diferente. Se reaparecer em cada tentativa, trate-o como um [problema de rede](#unable-to-connect-to-api).
113 113
114Quando você vê um dos erros nesta página, essas tentativas já foram esgotadas, a menos que pertença a uma classe que não é repetida, como uma falha de validação de certificado. Você pode ajustar o comportamento com estas variáveis de ambiente:114Quando você vê um dos erros nesta página, essas tentativas já foram esgotadas, a menos que pertença a uma classe que não é repetida, como uma falha de validação de certificado. Você pode ajustar o comportamento com estas variáveis de ambiente:
115 115
116| Variável | Padrão | Efeito |116| Variável | Padrão | Efeito |
117| :------------------------------------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |117| :------------------------------------------- | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
118| [`CLAUDE_CODE_MAX_RETRIES`](/pt/env-vars) | 10 | Número de tentativas de repetição. {/* min-version: 2.1.186 */}Limitado a 15 a partir da v2.1.186; {/* min-version: 2.1.199 */}a partir da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Reduza-o para expor falhas mais rapidamente em scripts. |118| [`CLAUDE_CODE_MAX_RETRIES`](/docs/pt/env-vars) | 10 | Número de tentativas de repetição. Limitado a 15 a partir da v2.1.186; a partir da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Reduza-o para expor falhas mais rapidamente em scripts. |
119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/pt/env-vars) | não definido | Defina como `1` em sessões autônomas, como trabalhos de CI, para repetir erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. {/* min-version: 2.1.199 */}A partir da v2.1.199, também aumenta a contagem de tentativas padrão para outros erros transitórios, como erros de servidor, tempos limite e conexões perdidas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. |119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/pt/env-vars) | não definido | Defina como `1` em sessões autônomas, como trabalhos de CI, para repetir erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. A partir da v2.1.199, também aumenta a contagem de tentativas padrão para outros erros transitórios, como erros de servidor, tempos limite e conexões perdidas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. |
120| [`API_TIMEOUT_MS`](/pt/env-vars) | 600000 | Tempo limite por solicitação em milissegundos. Aumente-o para redes lentas ou proxies. |120| [`API_TIMEOUT_MS`](/docs/pt/env-vars) | 600000 | Tempo limite por solicitação em milissegundos. Aumente-o para redes lentas ou proxies. |
121 121
122<h2 id="server-errors">122<h2 id="server-errors">
123 Erros do servidor123 Erros do servidor
196API Error: Response stalled mid-stream. The response above may be incomplete.196API Error: Response stalled mid-stream. The response above may be incomplete.
197```197```
198 198
199* {/* min-version: 2.1.199 */}`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.199* `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.
200* `Connection closed mid-response`: a conexão foi interrompida.200* `Connection closed mid-response`: a conexão foi interrompida.
201* `Response stalled mid-stream`: o stream parou de enviar dados.201* `Response stalled mid-stream`: o stream parou de enviar dados.
202 202
210 Auto mode cannot determine the safety of an action210 Auto mode cannot determine the safety of an action
211</h3>211</h3>
212 212
213O modelo que [auto mode](/pt/permission-modes#eliminate-prompts-with-auto-mode) usa para classificar ações não conseguiu produzir uma decisão, então o auto mode não aprovou a ação automaticamente. A mensagem que você vê depende de por que o classificador falhou.213O modelo que [auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) usa para classificar ações não conseguiu produzir uma decisão, então o auto mode não aprovou a ação automaticamente. A mensagem que você vê depende de por que o classificador falhou.
214 214
215Leituras, buscas e edições dentro do seu diretório de trabalho ignoram o classificador, então elas continuam funcionando em todos esses casos.215Leituras, buscas e edições dentro do seu diretório de trabalho ignoram o classificador, então elas continuam funcionando em todos esses casos.
216 216
224 224
225* Tente novamente após alguns segundos; Claude vê a mesma mensagem e geralmente tenta novamente por conta própria225* Tente novamente após alguns segundos; Claude vê a mesma mensagem e geralmente tenta novamente por conta própria
226* Se as tentativas continuarem falhando, continue com tarefas somente leitura e volte à ação bloqueada mais tarde226* Se as tentativas continuarem falhando, continue com tarefas somente leitura e volte à ação bloqueada mais tarde
227* Isso é transitório e não relacionado à [auto mode eligibility](/pt/permission-modes#eliminate-prompts-with-auto-mode); você não precisa alterar as configurações227* Isso é transitório e não relacionado à [auto mode eligibility](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode); você não precisa alterar as configurações
228 228
229Quando o classificador retornou uma resposta não analisável:229Quando o classificador retornou uma resposta não analisável:
230 230
247 247
248* 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 classificador248* 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
249* Tentar novamente não ajudará; o mesmo conteúdo da conversa acionará o filtro novamente249* Tentar novamente não ajudará; o mesmo conteúdo da conversa acionará o filtro novamente
250* Mude para um [permission mode](/pt/permission-modes) diferente para que você possa aprovar a ação quando solicitado, ou inicie uma conversa nova sem o conteúdo que acionou250* Mude para um [permission mode](/docs/pt/permission-modes) diferente para que você possa aprovar a ação quando solicitado, ou inicie uma conversa nova sem o conteúdo que acionou
251 251
252Quando a conversa cresceu além da janela de contexto do classificador:252Quando a conversa cresceu além da janela de contexto do classificador:
253 253
255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
256```256```
257 257
258Em uma sessão interativa, o auto mode volta a um prompt de permissão normal para essa ação para que você possa aprová-la ou negá-la manualmente. No [non-interactive mode](/pt/headless) a execução é abortada porque a transcrição só cresce e tentar novamente não pode ter sucesso.258Em uma sessão interativa, o auto mode volta a um prompt de permissão normal para essa ação para que você possa aprová-la ou negá-la manualmente. No [non-interactive mode](/docs/pt/headless) a execução é abortada porque a transcrição só cresce e tentar novamente não pode ter sucesso.
259 259
260**O que fazer:**260**O que fazer:**
261 261
266 Agent terminated early due to an API error266 Agent terminated early due to an API error
267</h3>267</h3>
268 268
269{/* min-version: 2.1.199 */}A solicitação de API de um [subagent](/pt/sub-agents) falhou terminalmente, por exemplo porque um limite de uso foi atingido ou as tentativas de um erro de servidor se esgotaram, então o subagent parou antes de terminar sua tarefa. Esta mensagem requer Claude Code v2.1.199 ou posterior; antes disso, o texto de erro da API era retornado para Claude como se fosse o resultado do subagent.269A solicitação de API de um [subagent](/docs/pt/sub-agents) falhou terminalmente, por exemplo porque um limite de uso foi atingido ou as tentativas de um erro de servidor se esgotaram, então o subagent parou antes de terminar sua tarefa. Esta mensagem requer Claude Code v2.1.199 ou posterior; antes disso, o texto de erro da API era retornado para Claude como se fosse o resultado do subagent.
270 270
271```text theme={null}271```text theme={null}
272Agent terminated early due to an API error: <error detail>272Agent terminated early due to an API error: <error detail>
275**O que fazer:**275**O que fazer:**
276 276
277* Corresponda o detalhe do erro após os dois pontos à sua própria seção nesta página, como [Usage limits](#usage-limits) ou [Server errors](#server-errors), e siga as etapas dessa seção277* Corresponda o detalhe do erro após os dois pontos à sua própria seção nesta página, como [Usage limits](#usage-limits) ou [Server errors](#server-errors), e siga as etapas dessa seção
278* Depois que o erro subjacente for resolvido, peça a Claude para tentar novamente a tarefa ou [resume the subagent](/pt/sub-agents#resume-subagents)278* Depois que o erro subjacente for resolvido, peça a Claude para tentar novamente a tarefa ou [resume the subagent](/docs/pt/sub-agents#resume-subagents)
279 279
280Quando uma limitação de taxa, sobrecarga ou erro de servidor interrompe um subagent em primeiro plano que já produziu saída de texto, Claude recebe essa saída parcial marcada como incompleta em vez deste erro. {/* min-version: 2.1.200 */}Um subagent cuja única saída foram chamadas de ferramenta também recebe este erro; na v2.1.199 isso retornou um resultado parcial vazio. Consulte [API errors in subagents](/pt/sub-agents#api-errors-in-subagents).280Quando uma limitação de taxa, sobrecarga ou erro de servidor interrompe um subagent em primeiro plano que já produziu saída de texto, Claude recebe essa saída parcial marcada como incompleta em vez deste erro. Um subagent cuja única saída foram chamadas de ferramenta também recebe este erro; na v2.1.199 isso retornou um resultado parcial vazio. Consulte [API errors in subagents](/docs/pt/sub-agents#api-errors-in-subagents).
281 281
282<h2 id="usage-limits">282<h2 id="usage-limits">
283 Limites de uso283 Limites de uso
309* 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](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para saber como isso é cobrado.309* 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](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para saber como isso é cobrado.
310* Para atualizar seu plano para limites base mais altos, consulte [claude.com/pricing](https://claude.com/pricing)310* Para atualizar seu plano para limites base mais altos, consulte [claude.com/pricing](https://claude.com/pricing)
311 311
312Para monitorar sua permissão restante antes de atingir o limite, adicione os campos `rate_limits` a uma [custom status line](/pt/statusline#rate-limit-usage), ou no aplicativo Desktop clique no [usage ring](/pt/desktop#check-usage) ao lado do seletor de modelo.312Para monitorar sua permissão restante antes de atingir o limite, adicione os campos `rate_limits` a uma [custom status line](/docs/pt/statusline#rate-limit-usage), ou no aplicativo Desktop clique no [usage ring](/docs/pt/desktop#check-usage) ao lado do seletor de modelo.
313 313
314<h3 id="usage-credits-required-for-1m-context">314<h3 id="usage-credits-required-for-1m-context">
315 Créditos de uso necessários para contexto de 1M315 Créditos de uso necessários para contexto de 1M
321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context
322```322```
323 323
324Esta é uma verificação de direito, não um esgotamento de cota. Ela é acionada mesmo quando suas permissões de sessão e semanais têm capacidade restante. Consulte [Extended context](/pt/model-config#extended-context) para saber quais planos incluem contexto de 1M diretamente e quais exigem créditos de uso.324Esta é uma verificação de direito, não um esgotamento de cota. Ela é acionada mesmo quando suas permissões de sessão e semanais têm capacidade restante. Consulte [Extended context](/docs/pt/model-config#extended-context) para saber quais planos incluem contexto de 1M diretamente e quais exigem créditos de uso.
325 325
326{/* min-version: 2.1.172 */}Quando esse erro aparece no meio de uma conversa porque o contexto cresceu além de 200K tokens, Claude Code compacta automaticamente a conversa de volta para o limite de contexto padrão e mantém a sessão nesse limite depois, portanto nenhuma ação é necessária. Em versões anteriores à v2.1.172, o erro se repetia em cada solicitação subsequente, incluindo `/compact`; execute `/clear` nessas versões para recuperar. As etapas abaixo se aplicam quando você selecionou explicitamente um modelo `[1m]`.326Quando esse erro aparece no meio de uma conversa porque o contexto cresceu além de 200K tokens, Claude Code compacta automaticamente a conversa de volta para o limite de contexto padrão e mantém a sessão nesse limite depois, portanto nenhuma ação é necessária. Em versões anteriores à v2.1.172, o erro se repetia em cada solicitação subsequente, incluindo `/compact`; execute `/clear` nessas versões para recuperar. As etapas abaixo se aplicam quando você selecionou explicitamente um modelo `[1m]`.
327 327
328**O que fazer:**328**O que fazer:**
329 329
330* Execute `/model` e selecione a variante sem o sufixo `[1m]` para voltar à janela de contexto padrão330* Execute `/model` e selecione a variante sem o sufixo `[1m]` para voltar à janela de contexto padrão
331* 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 Enterprise331* 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
332* 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](#theres-an-issue-with-the-selected-model) para os locais de configuração a verificar em ordem de prioridade.332* 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](#theres-an-issue-with-the-selected-model) para os locais de configuração a verificar em ordem de prioridade.
333* Para remover variantes 1M do seletor de modelo completamente, defina [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/pt/env-vars)333* Para remover variantes 1M do seletor de modelo completamente, defina [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/pt/env-vars)
334 334
335<h3 id="server-is-temporarily-limiting-requests">335<h3 id="server-is-temporarily-limiting-requests">
336 O servidor está limitando temporariamente as solicitações336 O servidor está limitando temporariamente as solicitações
342API Error: Server is temporarily limiting requests (not your usage limit)342API Error: Server is temporarily limiting requests (not your usage limit)
343```343```
344 344
345Claude Code diferencia esses dos seus limites de plano pela ausência dos cabeçalhos de cota unificados que uma resposta de limite real carrega. {/* min-version: 2.1.199 */}A partir da v2.1.199 isso é [retentado automaticamente](#automatic-retries) com backoff antes de ser mostrado, independentemente de como você se autentica. Em versões anteriores, uma sessão conectada com uma assinatura claude.ai falhou a vez na primeira ocorrência; apenas autenticações de chave de API e Enterprise a retentaram.345Claude Code diferencia esses dos seus limites de plano pela ausência dos cabeçalhos de cota unificados que uma resposta de limite real carrega. A partir da v2.1.199 isso é [retentado automaticamente](#automatic-retries) com backoff antes de ser mostrado, independentemente de como você se autentica. Em versões anteriores, uma sessão conectada com uma assinatura claude.ai falhou a vez na primeira ocorrência; apenas autenticações de chave de API e Enterprise a retentaram.
346 346
347**O que fazer:**347**O que fazer:**
348 348
366* 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.366* 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.
367* Verifique seu console de provedor para os limites ativos e solicite um nível mais alto se necessário367* Verifique seu console de provedor para os limites ativos e solicite um nível mais alto se necessário
368* Para chaves de API do Anthropic, consulte a [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) para saber como os níveis funcionam e como definir limites por workspace368* Para chaves de API do Anthropic, consulte a [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) para saber como os níveis funcionam e como definir limites por workspace
369* Reduza a concorrência: diminua [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/pt/env-vars), evite executar muitos subagentes paralelos, ou mude para um modelo menor com `/model` para execuções de script de alto volume369* Reduza a concorrência: diminua [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/pt/env-vars), evite executar muitos subagentes paralelos, ou mude para um modelo menor com `/model` para execuções de script de alto volume
370 370
371<h3 id="credit-balance-is-too-low">371<h3 id="credit-balance-is-too-low">
372 Saldo de crédito muito baixo372 Saldo de crédito muito baixo
382 382
383* Adicione créditos em [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considere ativar o auto-reload lá para que o saldo seja recarregado antes de chegar a zero383* Adicione créditos em [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considere ativar o auto-reload lá para que o saldo seja recarregado antes de chegar a zero
384* Mude para autenticação de assinatura com `/login` se você tiver um plano Pro, Max, Team ou Enterprise384* Mude para autenticação de assinatura com `/login` se você tiver um plano Pro, Max, Team ou Enterprise
385* Defina limites de gastos por workspace no Console para evitar que um único projeto drene o saldo da organização. Consulte [Manage costs effectively](/pt/costs).385* Defina limites de gastos por workspace no Console para evitar que um único projeto drene o saldo da organização. Consulte [Manage costs effectively](/docs/pt/costs).
386 386
387<h2 id="authentication-errors">387<h2 id="authentication-errors">
388 Erros de autenticação388 Erros de autenticação
404 404
405* Execute `/login` para autenticar com sua assinatura Claude ou conta Console405* Execute `/login` para autenticar com sua assinatura Claude ou conta Console
406* 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`406* 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`
407* Para CI ou automação onde login interativo não é possível, configure um script [`apiKeyHelper`](/pt/settings#available-settings) que busque uma chave na inicialização407* Para CI ou automação onde login interativo não é possível, configure um script [`apiKeyHelper`](/docs/pt/settings#available-settings) que busque uma chave na inicialização
408* Consulte [Precedência de autenticação](/pt/authentication#authentication-precedence) para entender qual credencial Claude Code usa quando várias estão presentes408* Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) para entender qual credencial Claude Code usa quando várias estão presentes
409 409
410Se você for solicitado a fazer login repetidamente, consulte [Não conectado ou token expirado](/pt/troubleshoot-install#not-logged-in-or-token-expired) para correções de relógio do sistema e Keychain do macOS.410Se você for solicitado a fazer login repetidamente, consulte [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para correções de relógio do sistema e Keychain do macOS.
411 411
412<h3 id="could-not-resolve-authentication-method">412<h3 id="could-not-resolve-authentication-method">
413 Não foi possível resolver o método de autenticação413 Não foi possível resolver o método de autenticação
414</h3>414</h3>
415 415
416A sessão chegou ao cliente da API sem nenhuma credencial. Isso aparece em [sessões em segundo plano](/pt/agent-view), sessões em nuvem e contextos do Agent SDK onde a verificação de login interativo não é executada antes da primeira solicitação.416A sessão chegou ao cliente da API sem nenhuma credencial. Isso aparece em [sessões em segundo plano](/docs/pt/agent-view), sessões em nuvem e contextos do Agent SDK onde a verificação de login interativo não é executada antes da primeira solicitação.
417 417
418```text theme={null}418```text theme={null}
419Could 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 omitted419Could 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
420```420```
421 421
422{/* min-version: 2.1.174 */}Antes da v2.1.174, uma sessão em segundo plano ou em nuvem atribuída a um worker pré-inicializado ocioso poderia falhar dessa forma mesmo quando credenciais válidas foram configuradas. Atualize para recuperar. Nas versões atuais, o erro significa que nenhuma credencial estava disponível para o processo do worker.422Antes da v2.1.174, uma sessão em segundo plano ou em nuvem atribuída a um worker pré-inicializado ocioso poderia falhar dessa forma mesmo quando credenciais válidas foram configuradas. Atualize para recuperar. Nas versões atuais, o erro significa que nenhuma credencial estava disponível para o processo do worker.
423 423
424**O que fazer:**424**O que fazer:**
425 425
426* 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 configuradas426* 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
427* 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 interativo427* 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
428* Para o Agent SDK, consulte [configuração de autenticação](/pt/agent-sdk/overview#get-started)428* Para o Agent SDK, consulte [configuração de autenticação](/docs/pt/agent-sdk/overview#get-started)
429* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida429* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida
430 430
431<h3 id="invalid-api-key">431<h3 id="invalid-api-key">
443* Verifique se há erros de digitação e confirme que a chave não foi revogada no [Console](https://platform.claude.com/settings/keys)443* Verifique se há erros de digitação e confirme que a chave não foi revogada no [Console](https://platform.claude.com/settings/keys)
444* 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.444* 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.
445* Desdefina `ANTHROPIC_API_KEY` e execute `/login` para usar autenticação de assinatura445* Desdefina `ANTHROPIC_API_KEY` e execute `/login` para usar autenticação de assinatura
446* Se a chave vem de um script [`apiKeyHelper`](/pt/settings#available-settings), execute o script diretamente para confirmar que ele imprime uma chave válida em stdout446* Se a chave vem de um script [`apiKeyHelper`](/docs/pt/settings#available-settings), execute o script diretamente para confirmar que ele imprime uma chave válida em stdout
447* Execute `/status` para confirmar qual fonte de credencial Claude Code está realmente usando447* Execute `/status` para confirmar qual fonte de credencial Claude Code está realmente usando
448 448
449<h3 id="your-apikeyhelper-script-is-failing">449<h3 id="your-apikeyhelper-script-is-failing">
450 Seu script apiKeyHelper está falhando450 Seu script apiKeyHelper está falhando
451</h3>451</h3>
452 452
453O comando configurado na configuração [`apiKeyHelper`](/pt/settings#available-settings) saiu com um erro, expirou ou não imprimiu nada em stdout. Sem uma chave do script, a solicitação chega à API com uma credencial de espaço reservado, e a API a rejeita com `401`.453O comando configurado na configuração [`apiKeyHelper`](/docs/pt/settings#available-settings) saiu com um erro, expirou ou não imprimiu nada em stdout. Sem uma chave do script, a solicitação chega à API com uma credencial de espaço reservado, e a API a rejeita com `401`.
454 454
455```text theme={null}455```text theme={null}
456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
457```457```
458 458
459Claude Code executa novamente o script e tenta novamente a solicitação até mais duas vezes antes de mostrar esta mensagem, portanto a falha aparece dentro de três tentativas. {/* min-version: 2.1.208 */}Antes da v2.1.208, Claude Code gastava o [orçamento de tentativas](#automatic-retries) completo reenviando a solicitação com a credencial de espaço reservado e depois relatava um erro de autenticação `401` genérico em vez da falha do script.459Claude Code executa novamente o script e tenta novamente a solicitação até mais duas vezes antes de mostrar esta mensagem, portanto a falha aparece dentro de três tentativas. Antes da v2.1.208, Claude Code gastava o [orçamento de tentativas](#automatic-retries) completo reenviando a solicitação com a credencial de espaço reservado e depois relatava um erro de autenticação `401` genérico em vez da falha do script.
460 460
461Executar `/login` não ajuda aqui: a saída do helper [tem precedência](/pt/authentication#authentication-precedence) sobre um login salvo enquanto a configuração estiver presente.461Executar `/login` não ajuda aqui: a saída do helper [tem precedência](/docs/pt/authentication#authentication-precedence) sobre um login salvo enquanto a configuração estiver presente.
462 462
463**O que fazer:**463**O que fazer:**
464 464
465* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha465* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha
466* 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 segredos466* 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
467* Corrija o comando para que ele imprima a chave em stdout e saia com código 0. Consulte [girar credenciais com apiKeyHelper](/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para uma configuração funcionando.467* Corrija o comando para que ele imprima a chave em stdout e saia com código 0. Consulte [girar credenciais com apiKeyHelper](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para uma configuração funcionando.
468* 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.468* 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.
469 469
470<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
500```500```
501 501
502Variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, portanto executar `/login` sozinho não ajuda enquanto qualquer um deles ainda estiver fornecendo uma chave. Consulte [Precedência de autenticação](/pt/authentication#authentication-precedence).502Variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, portanto executar `/login` sozinho não ajuda enquanto qualquer um deles ainda estiver fornecendo uma chave. Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence).
503 503
504**O que fazer:**504**O que fazer:**
505 505
506* 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`506* 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`
507* Se a mensagem mencionar `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/pt/settings#available-settings) do seu `settings.json`507* Se a mensagem mencionar `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/docs/pt/settings#available-settings) do seu `settings.json`
508* Execute `/login` para fazer login com sua conta claude.ai508* Execute `/login` para fazer login com sua conta claude.ai
509* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API509* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API
510* 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 Console510* 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
526**O que fazer:**526**O que fazer:**
527 527
528* Peça ao seu administrador para habilitar o acesso ao Claude Code para sua organização528* Peça ao seu administrador para habilitar o acesso ao Claude Code para sua organização
529* Autentique-se com uma chave de API do Console em vez de sua assinatura. Consulte [Autenticação do Claude Console](/pt/authentication#claude-console-authentication) para configuração.529* Autentique-se com uma chave de API do Console em vez de sua assinatura. Consulte [Autenticação do Claude Console](/docs/pt/authentication#claude-console-authentication) para configuração.
530* Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com [suporte da Anthropic](https://support.claude.com)530* Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com [suporte da Anthropic](https://support.claude.com)
531 531
532<h3 id="routines-are-disabled-by-your-organizations-policy">532<h3 id="routines-are-disabled-by-your-organizations-policy">
533 Rotinas são desabilitadas pela política da sua organização533 Rotinas são desabilitadas pela política da sua organização
534</h3>534</h3>
535 535
536Um Proprietário em sua organização Team ou Enterprise desabilitou rotinas no nível da organização. O erro aparece quando você tenta criar ou executar uma rotina, incluindo de `/schedule` e da interface de [Rotinas](/pt/routines) em claude.ai/code.536Um Proprietário em sua organização Team ou Enterprise desabilitou rotinas no nível da organização. O erro aparece quando você tenta criar ou executar uma rotina, incluindo de `/schedule` e da interface de [Rotinas](/docs/pt/routines) em claude.ai/code.
537 537
538```text theme={null}538```text theme={null}
539Routines are disabled by your organization's policy.539Routines are disabled by your organization's policy.
544**O que fazer:**544**O que fazer:**
545 545
546* Peça a um Proprietário em sua organização para habilitar o botão **Routines** em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)546* Peça a um Proprietário em sua organização para habilitar o botão **Routines** em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
547* Para trabalho agendado único que não requer rotinas no nível da organização, consulte [tarefas agendadas](/pt/scheduled-tasks)547* Para trabalho agendado único que não requer rotinas no nível da organização, consulte [tarefas agendadas](/docs/pt/scheduled-tasks)
548 548
549<h3 id="remote-control-requires-the-anthropic-api">549<h3 id="remote-control-requires-the-anthropic-api">
550 Remote Control requer a API Anthropic550 Remote Control requer a API Anthropic
551</h3>551</h3>
552 552
553A sessão não está se comunicando com a API Anthropic diretamente, portanto não há backend claude.ai para [Remote Control](/pt/remote-control) emparelhar.553A sessão não está se comunicando com a API Anthropic diretamente, portanto não há backend claude.ai para [Remote Control](/docs/pt/remote-control) emparelhar.
554 554
555```text theme={null}555```text theme={null}
556Remote Control is only available when using Claude via api.anthropic.com.556Remote Control is only available when using Claude via api.anthropic.com.
557```557```
558 558
559Isso aparece em Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry. {/* min-version: 2.1.196 */}A partir da v2.1.196, também aparece quando [`ANTHROPIC_BASE_URL`](/pt/env-vars) aponta para um host diferente de `api.anthropic.com`, como um [gateway LLM](/pt/llm-gateway) ou proxy, mesmo quando você faz login com claude.ai.559Isso aparece em Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry. A partir da v2.1.196, também aparece quando [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) aponta para um host diferente de `api.anthropic.com`, como um [gateway LLM](/docs/pt/llm-gateway) ou proxy, mesmo quando você faz login com claude.ai.
560 560
561**O que fazer:**561**O que fazer:**
562 562
563* Desdefina `ANTHROPIC_BASE_URL` e reinicie a sessão, ou inicie Remote Control de uma sessão que se comunique com a API Anthropic diretamente563* 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
564* Para esta e as outras mensagens de inicialização do Remote Control, consulte [Solucionar problemas do Remote Control](/pt/remote-control#troubleshooting)564* Para esta e as outras mensagens de inicialização do Remote Control, consulte [Solucionar problemas do Remote Control](/docs/pt/remote-control#troubleshooting)
565 565
566<h3 id="oauth-token-revoked-or-expired">566<h3 id="oauth-token-revoked-or-expired">
567 Token OAuth revogado ou expirado567 Token OAuth revogado ou expirado
581 581
582* Execute `/login` para fazer login novamente582* Execute `/login` para fazer login novamente
583* Se o erro retornar na mesma sessão após autenticar novamente, execute `/logout` primeiro para limpar completamente o token armazenado, depois `/login`583* Se o erro retornar na mesma sessão após autenticar novamente, execute `/logout` primeiro para limpar completamente o token armazenado, depois `/login`
584* 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](/pt/troubleshoot-install#not-logged-in-or-token-expired)584* 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](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired)
585* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, consulte [Login e autenticação](/pt/troubleshoot-install#login-and-authentication)585* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
586 586
587<h3 id="login-expired">587<h3 id="login-expired">
588 Login expirado588 Login expirado
589</h3>589</h3>
590 590
591Claude Code tentou renovar seu login salvo claude.ai ou Claude Console e o serviço OAuth rejeitou o token de atualização armazenado, portanto Claude Code limpou as credenciais salvas. Depois disso, cada solicitação para localmente antes de chegar à API, porque apenas `/login` pode criar novas credenciais. {/* min-version: 2.1.206 */}Antes da v2.1.206, Claude Code enviava a solicitação mesmo assim com qualquer credencial que permanecesse no ambiente, e cada modelo então falhava com [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model) ou um 401 em vez de um prompt para fazer login.591Claude Code tentou renovar seu login salvo claude.ai ou Claude Console e o serviço OAuth rejeitou o token de atualização armazenado, portanto Claude Code limpou as credenciais salvas. Depois disso, cada solicitação para localmente antes de chegar à API, porque apenas `/login` pode criar novas credenciais. Antes da v2.1.206, Claude Code enviava a solicitação mesmo assim com qualquer credencial que permanecesse no ambiente, e cada modelo então falhava com [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model) ou um 401 em vez de um prompt para fazer login.
592 592
593```text theme={null}593```text theme={null}
594Login expired · Please run /login594Login expired · Please run /login
595```595```
596 596
597Em [modo não interativo](/pt/headless) (`-p`) e no [Agent SDK](/pt/agent-sdk/overview), a mensagem lê da seguinte forma, e o código de erro estruturado é `authentication_failed`:597Em [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), a mensagem lê da seguinte forma, e o código de erro estruturado é `authentication_failed`:
598 598
599```text theme={null}599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed600Failed to authenticate: OAuth session expired and could not be refreshed
602 602
603Este não é o mesmo estado que [Token OAuth revogado ou expirado](#oauth-token-revoked-or-expired). Essas mensagens relatam um 401 que a API retornou. Claude Code em si produz `Login expired` para um login que já falhou em renovar, portanto não envia nenhuma solicitação.603Este não é o mesmo estado que [Token OAuth revogado ou expirado](#oauth-token-revoked-or-expired). Essas mensagens relatam um 401 que a API retornou. Claude Code em si produz `Login expired` para um login que já falhou em renovar, portanto não envia nenhuma solicitação.
604 604
605Sessões autenticadas com uma chave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](/pt/env-vars) ou um provedor de terceiros não usam o login salvo e nunca veem esta mensagem.605Sessões autenticadas com uma chave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars) ou um provedor de terceiros não usam o login salvo e nunca veem esta mensagem.
606 606
607**O que fazer:**607**O que fazer:**
608 608
609* Execute `/login` para fazer login novamente. Tentar novamente sem fazer login mostra a mesma mensagem em cada solicitação.609* Execute `/login` para fazer login novamente. Tentar novamente sem fazer login mostra a mesma mensagem em cada solicitação.
610* 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`](/pt/authentication#generate-a-long-lived-token).610* 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`](/docs/pt/authentication#generate-a-long-lived-token).
611* Se fazer login continuar falhando, consulte [Login e autenticação](/pt/troubleshoot-install#login-and-authentication)611* Se fazer login continuar falhando, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
612 612
613<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
614 Requisito de escopo OAuth614 Requisito de escopo OAuth
628 Credenciais AWS expiradas ou inválidas628 Credenciais AWS expiradas ou inválidas
629</h3>629</h3>
630 630
631{/* min-version: 2.1.198 */}Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu token de sessão AWS expirou ou foi rejeitado, e a atualização automática que Claude Code já executou não produziu uma credencial que a API aceita. Aparece em um 401 de [Claude Platform on AWS](/pt/claude-platform-on-aws) ou do [endpoint Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint), que é como esses provedores relatam um token de segurança expirado.631Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu token de sessão AWS expirou ou foi rejeitado, e a atualização automática que Claude Code já executou não produziu uma credencial que a API aceita. Aparece em um 401 de [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) ou do [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint), que é como esses provedores relatam um token de segurança expirado.
632 632
633A dica de ação no meio nomeia o comando `awsAuthRefresh` do seu arquivo de configurações, portanto varia. A parte estável é o `AWS credentials expired or invalid` inicial:633A dica de ação no meio nomeia o comando `awsAuthRefresh` do seu arquivo de configurações, portanto varia. A parte estável é o `AWS credentials expired or invalid` inicial:
634 634
641**O que fazer:**641**O que fazer:**
642 642
643* Execute o comando `awsAuthRefresh` nomeado na mensagem, como `aws sso login --profile myprofile`, em outro terminal e conclua o login do navegador, depois tente novamente643* 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
644* 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](/pt/claude-platform-on-aws#1-configure-aws-credentials)644* 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](/docs/pt/claude-platform-on-aws#1-configure-aws-credentials)
645* 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 perfil645* 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
646 646
647<h3 id="aws-authentication-failed">647<h3 id="aws-authentication-failed">
648 Falha na autenticação AWS648 Falha na autenticação AWS
649</h3>649</h3>
650 650
651{/* min-version: 2.1.198 */}Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu provedor AWS retornou um 403, ou [Amazon Bedrock](/pt/amazon-bedrock) retornou um 401.651Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu provedor AWS retornou um 403, ou [Amazon Bedrock](/docs/pt/amazon-bedrock) retornou um 401.
652 652
653Claude Code não consegue dizer qual causa você atingiu. Amazon Bedrock relata um token de segurança expirado como um 403, mas um 403 também é como ele relata uma negação de autorização, como um `AccessDeniedException` de uma permissão IAM ausente ou um modelo que não está habilitado para sua conta.653Claude Code não consegue dizer qual causa você atingiu. Amazon Bedrock relata um token de segurança expirado como um 403, mas um 403 também é como ele relata uma negação de autorização, como um `AccessDeniedException` de uma permissão IAM ausente ou um modelo que não está habilitado para sua conta.
654 654
665**O que fazer:**665**O que fazer:**
666 666
667* Execute o comando `awsAuthRefresh` nomeado na mensagem, ou `aws sso login`, caso uma credencial expirada seja a causa667* Execute o comando `awsAuthRefresh` nomeado na mensagem, ou `aws sso login`, caso uma credencial expirada seja a causa
668* Se suas credenciais estão atuais, confirme que as permissões IAM em [Configuração IAM](/pt/amazon-bedrock#iam-configuration) estão anexadas à identidade que você está usando e que o modelo selecionado está habilitado para sua conta e região668* Se suas credenciais estão atuais, confirme que as permissões IAM em [Configuração IAM](/docs/pt/amazon-bedrock#iam-configuration) estão anexadas à identidade que você está usando e que o modelo selecionado está habilitado para sua conta e região
669* 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ão669* 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
670 670
671<h3 id="aws-default-chain-credential-resolve-timed-out">671<h3 id="aws-default-chain-credential-resolve-timed-out">
672 Resolução de credencial da cadeia padrão AWS expirou672 Resolução de credencial da cadeia padrão AWS expirou
673</h3>673</h3>
674 674
675O provedor de credencial padrão AWS não produziu credenciais dentro de 60 segundos, portanto Claude Code parou a resolução e falhou a solicitação. A falha é resolução de credencial local: a solicitação nunca chegou a [Amazon Bedrock](/pt/amazon-bedrock), [Claude Platform on AWS](/pt/claude-platform-on-aws) ou ao [endpoint Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint). Claude Code limpa seu [cache de credenciais](/pt/amazon-bedrock#credential-caching-and-resolution-timeout) e tenta novamente antes desta mensagem de erro aparecer, portanto no momento em que você a vê a cadeia travou em tentativas repetidas.675O provedor de credencial padrão AWS não produziu credenciais dentro de 60 segundos, portanto Claude Code parou a resolução e falhou a solicitação. A falha é resolução de credencial local: a solicitação nunca chegou a [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) ou ao [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint). Claude Code limpa seu [cache de credenciais](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout) e tenta novamente antes desta mensagem de erro aparecer, portanto no momento em que você a vê a cadeia travou em tentativas repetidas.
676 676
677```text theme={null}677```text theme={null}
678API Error: AWS default-chain credential resolve timed out678API Error: AWS default-chain credential resolve timed out
679```679```
680 680
681As causas comuns são um comando `credential_process` no seu perfil AWS que aguarda entrada que não consegue receber, e um contêiner ou VM cujo serviço de metadados de instância (IMDS) nunca responde à sonda da cadeia. {/* min-version: 2.1.207 */}Antes da v2.1.207, uma cadeia travada deixava a solicitação aguardando indefinidamente em vez de falhar com esta mensagem.681As causas comuns são um comando `credential_process` no seu perfil AWS que aguarda entrada que não consegue receber, e um contêiner ou VM cujo serviço de metadados de instância (IMDS) nunca responde à sonda da cadeia. Antes da v2.1.207, uma cadeia travada deixava a solicitação aguardando indefinidamente em vez de falhar com esta mensagem.
682 682
683**O que fazer:**683**O que fazer:**
684 684
685* 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.685* 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.
686* 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 navegador686* 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
687* 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`](/pt/env-vars)687* 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`](/docs/pt/env-vars)
688 688
689<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
690 Erros de rede e conexão690 Erros de rede e conexão
712**O que fazer:**712**O que fazer:**
713 713
714* 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.714* 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.
715* Se você estiver atrás de um proxy corporativo, defina `HTTPS_PROXY` antes de iniciar Claude Code e consulte [Configuração de rede](/pt/network-config)715* Se você estiver atrás de um proxy corporativo, defina `HTTPS_PROXY` antes de iniciar Claude Code e consulte [Configuração de rede](/docs/pt/network-config)
716* Se você rotear através de um gateway LLM ou relay, defina [`ANTHROPIC_BASE_URL`](/pt/env-vars) para seu endereço. Consulte [Conectar Claude Code a um gateway LLM](/pt/llm-gateway-connect) para configuração.716* Se você rotear através de um gateway LLM ou relay, defina [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) para seu endereço. Consulte [Conectar Claude Code a um gateway LLM](/docs/pt/llm-gateway-connect) para configuração.
717* Certifique-se de que seu firewall permite os hosts listados em [Requisitos de acesso à rede](/pt/network-config#network-access-requirements)717* Certifique-se de que seu firewall permite os hosts listados em [Requisitos de acesso à rede](/docs/pt/network-config#network-access-requirements)
718* Falhas intermitentes são [retentadas automaticamente](#automatic-retries); falhas persistentes apontam para um problema de rede local718* Falhas intermitentes são [retentadas automaticamente](#automatic-retries); falhas persistentes apontam para um problema de rede local
719 719
720Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:720Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:
727 Resposta de streaming do Bedrock tem um content-type inesperado727 Resposta de streaming do Bedrock tem um content-type inesperado
728</h3>728</h3>
729 729
730Um gateway ou proxy entre Claude Code e [Amazon Bedrock](/pt/amazon-bedrock) está transformando o corpo da resposta de streaming ou seu cabeçalho `Content-Type`. Amazon Bedrock transmite respostas como `application/vnd.amazon.eventstream`, e Claude Code rejeita uma resposta de streaming bem-sucedida que relata um content-type diferente em vez de decodificar um corpo que não consegue ler. A solicitação não é retentada.730Um gateway ou proxy entre Claude Code e [Amazon Bedrock](/docs/pt/amazon-bedrock) está transformando o corpo da resposta de streaming ou seu cabeçalho `Content-Type`. Amazon Bedrock transmite respostas como `application/vnd.amazon.eventstream`, e Claude Code rejeita uma resposta de streaming bem-sucedida que relata um content-type diferente em vez de decodificar um corpo que não consegue ler. A solicitação não é retentada.
731 731
732```text theme={null}732```text theme={null}
733Bedrock 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.733Bedrock 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.
734```734```
735 735
736{/* min-version: 2.1.208 */}Antes da v2.1.208, a mesma configuração incorreta aparecia como `API Error: Truncated event message received` após toda a resposta ter sido armazenada em buffer.736Antes da v2.1.208, a mesma configuração incorreta aparecia como `API Error: Truncated event message received` após toda a resposta ter sido armazenada em buffer.
737 737
738**O que fazer:**738**O que fazer:**
739 739
740* 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.740* 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.
741* Se o gateway reescrever apenas o cabeçalho e passar o corpo binário intacto, defina [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/pt/env-vars) para pular a verificação até que o gateway seja corrigido. Consulte [Erros de streaming atrás de um gateway ou proxy](/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).741* Se o gateway reescrever apenas o cabeçalho e passar o corpo binário intacto, defina [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/pt/env-vars) para pular a verificação até que o gateway seja corrigido. Consulte [Erros de streaming atrás de um gateway ou proxy](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
742 742
743<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
744 Erros de certificado SSL744 Erros de certificado SSL
751Unable to connect to API: Self-signed certificate detected751Unable to connect to API: Self-signed certificate detected
752```752```
753 753
754{/* min-version: 2.1.199 */}A partir da v2.1.199, uma falha de validação de certificado não é retentada, portanto esse erro aparece na primeira tentativa em vez de após o [orçamento de retry](#automatic-retries) completo. Versões anteriores gastavam alguns minutos retentando antes de mostrá-lo. Condições TLS transitórias, como um timeout de handshake, ainda são retentadas.754A partir da v2.1.199, uma falha de validação de certificado não é retentada, portanto esse erro aparece na primeira tentativa em vez de após o [orçamento de retry](#automatic-retries) completo. Versões anteriores gastavam alguns minutos retentando antes de mostrá-lo. Condições TLS transitórias, como um timeout de handshake, ainda são retentadas.
755 755
756Durante `/login` e a verificação de conectividade de inicialização, a mesma falha é relatada com o código OpenSSL e a correção inline:756Durante `/login` e a verificação de conectividade de inicialização, a mesma falha é relatada com o código OpenSSL e a correção inline:
757 757
762**O que fazer:**762**O que fazer:**
763 763
764* Exporte o pacote CA da sua organização e aponte Claude Code para ele com `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`764* Exporte o pacote CA da sua organização e aponte Claude Code para ele com `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
765* Consulte [Configuração de rede](/pt/network-config#custom-ca-certificates) para instruções de configuração completa765* Consulte [Configuração de rede](/docs/pt/network-config#custom-ca-certificates) para instruções de configuração completa
766* Não defina `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desabilita a validação de certificado inteiramente766* Não defina `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desabilita a validação de certificado inteiramente
767 767
768<h3 id="host-not-allowed-in-a-cloud-session">768<h3 id="host-not-allowed-in-a-cloud-session">
778 778
779Você também pode ver um certificado TLS que não corresponde ao certificado real do destino. O ambiente em nuvem roteia o tráfego de saída através de um proxy que aplica a política de rede, portanto um certificado incompatível significa que o proxy encerrou a conexão, não o destino.779Você também pode ver um certificado TLS que não corresponde ao certificado real do destino. O ambiente em nuvem roteia o tráfego de saída através de um proxy que aplica a política de rede, portanto um certificado incompatível significa que o proxy encerrou a conexão, não o destino.
780 780
781Isso não é um problema de rede do lado do cliente. Sessões em nuvem e [rotinas](/pt/routines) são executadas dentro de um ambiente em sandbox cuja tráfego de saída é filtrado para a lista de permissões do ambiente. O ambiente **Default** usa acesso **Trusted**, que permite a [lista de permissões padrão](/pt/claude-code-on-the-web#default-allowed-domains) de registros de pacotes, APIs de provedores em nuvem, registros de contêiner e domínios de desenvolvimento comuns, mas bloqueia tudo o mais.781Isso não é um problema de rede do lado do cliente. Sessões em nuvem e [rotinas](/docs/pt/routines) são executadas dentro de um ambiente em sandbox cuja tráfego de saída é filtrado para a lista de permissões do ambiente. O ambiente **Default** usa acesso **Trusted**, que permite a [lista de permissões padrão](/docs/pt/claude-code-on-the-web#default-allowed-domains) de registros de pacotes, APIs de provedores em nuvem, registros de contêiner e domínios de desenvolvimento comuns, mas bloqueia tudo o mais.
782 782
783**O que fazer:**783**O que fazer:**
784 784
785* 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.785* 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.
786* 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](/pt/claude-code-on-the-web#default-allowed-domains) junto com seus domínios personalizados. Selecione **Full** em vez disso se quiser acesso irrestrito.786* 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](/docs/pt/claude-code-on-the-web#default-allowed-domains) junto com seus domínios personalizados. Selecione **Full** em vez disso se quiser acesso irrestrito.
787* Clique em **Save changes**. A próxima execução usa a lista de permissões atualizada.787* Clique em **Save changes**. A próxima execução usa a lista de permissões atualizada.
788 788
789Consulte [Network access](/pt/claude-code-on-the-web#network-access) para níveis de acesso e a lista de permissões padrão. Sessões locais de CLI não são afetadas por essa política.789Consulte [Network access](/docs/pt/claude-code-on-the-web#network-access) para níveis de acesso e a lista de permissões padrão. Sessões locais de CLI não são afetadas por essa política.
790 790
791<h3 id="couldnt-reconnect-to-your-remote-control-session">791<h3 id="couldnt-reconnect-to-your-remote-control-session">
792 Não foi possível reconectar à sua sessão de Remote Control792 Não foi possível reconectar à sua sessão de Remote Control
796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
797```797```
798 798
799Retomar com `claude --resume` ou `claude --continue` reconecta à sessão [Remote Control](/pt/remote-control) registrada nessa conversa. Esta mensagem significa que a reconexão falhou por um motivo que pode ser temporário, como uma interrupção de rede ou um erro de servidor, portanto Claude Code não pode confirmar se a sessão remota ainda existe. Sua sessão local continua funcionando sem Remote Control.799Retomar com `claude --resume` ou `claude --continue` reconecta à sessão [Remote Control](/docs/pt/remote-control) registrada nessa conversa. Esta mensagem significa que a reconexão falhou por um motivo que pode ser temporário, como uma interrupção de rede ou um erro de servidor, portanto Claude Code não pode confirmar se a sessão remota ainda existe. Sua sessão local continua funcionando sem Remote Control.
800 800
801**O que fazer:**801**O que fazer:**
802 802
803* Execute `/remote-control` para tentar novamente a conexão803* Execute `/remote-control` para tentar novamente a conexão
804* Inicie Claude Code sem `--resume` para criar uma nova sessão de Remote Control804* Inicie Claude Code sem `--resume` para criar uma nova sessão de Remote Control
805* Para outras mensagens de inicialização do Remote Control, consulte [Troubleshoot Remote Control](/pt/remote-control#troubleshooting)805* Para outras mensagens de inicialização do Remote Control, consulte [Troubleshoot Remote Control](/docs/pt/remote-control#troubleshooting)
806 806
807Você não verá esta mensagem quando o servidor confirmar que a sessão anterior não existe mais; Claude Code cria uma nova nesse caso. {/* min-version: 2.1.200 */}Antes da v2.1.200, qualquer falha de reconexão criava uma nova sessão de Remote Control, o que deixava sessões extras na lista de sessões em claude.ai/code.807Você não verá esta mensagem quando o servidor confirmar que a sessão anterior não existe mais; Claude Code cria uma nova nesse caso. Antes da v2.1.200, qualquer falha de reconexão criava uma nova sessão de Remote Control, o que deixava sessões extras na lista de sessões em claude.ai/code.
808 808
809<h2 id="request-errors">809<h2 id="request-errors">
810 Erros de solicitação810 Erros de solicitação
827* Execute `/compact` para resumir turnos anteriores e liberar espaço, ou `/clear` para começar do zero827* Execute `/compact` para resumir turnos anteriores e liberar espaço, ou `/clear` para começar do zero
828* Execute `/context` para ver um detalhamento do que está consumindo a janela: prompt do sistema, ferramentas, arquivos de memória e mensagens828* Execute `/context` para ver um detalhamento do que está consumindo a janela: prompt do sistema, ferramentas, arquivos de memória e mensagens
829* Desabilite servidores MCP que você não está usando com `/mcp disable <name>` para remover suas definições de ferramentas do contexto829* Desabilite servidores MCP que você não está usando com `/mcp disable <name>` para remover suas definições de ferramentas do contexto
830* Reduza arquivos de memória `CLAUDE.md` grandes, ou mova instruções para [regras com escopo de caminho](/pt/memory#path-specific-rules) que carregam apenas quando relevante830* Reduza arquivos de memória `CLAUDE.md` grandes, ou mova instruções para [regras com escopo de caminho](/docs/pt/memory#path-specific-rules) que carregam apenas quando relevante
831* 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.831* 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.
832* Auto-compact está ativado por padrão e normalmente previne esse erro. Se você definiu [`DISABLE_AUTO_COMPACT`](/pt/env-vars), reabilite-o ou execute `/compact` manualmente antes da janela ficar cheia.832* Auto-compact está ativado por padrão e normalmente previne esse erro. Se você definiu [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars), reabilite-o ou execute `/compact` manualmente antes da janela ficar cheia.
833 833
834Veja [Explore the context window](/pt/context-window) para uma visualização interativa de como o contexto se preenche.834Veja [Explore the context window](/docs/pt/context-window) para uma visualização interativa de como o contexto se preenche.
835 835
836<h3 id="error-during-compaction-conversation-too-long">836<h3 id="error-during-compaction-conversation-too-long">
837 Erro durante compactação: Conversa muito longa837 Erro durante compactação: Conversa muito longa
879API Error: 400 ... image dimensions exceed max allowed size879API Error: 400 ... image dimensions exceed max allowed size
880```880```
881 881
882{/* min-version: 2.1.142 */}Claude Code substitui a imagem não processável por um espaço reservado de texto e tenta novamente, para que as mensagens subsequentes tenham sucesso. Em versões anteriores a 2.1.142, uma imagem colada poderia permanecer na conversa e repetir o mesmo erro em cada mensagem subsequente. Para recuperar nessas versões, pressione Esc duas vezes e volte passado o turno onde a imagem foi adicionada.882Claude Code substitui a imagem não processável por um espaço reservado de texto e tenta novamente, para que as mensagens subsequentes tenham sucesso. Em versões anteriores a 2.1.142, uma imagem colada poderia permanecer na conversa e repetir o mesmo erro em cada mensagem subsequente. Para recuperar nessas versões, pressione Esc duas vezes e volte passado o turno onde a imagem foi adicionada.
883 883
884**O que fazer:**884**O que fazer:**
885 885
939 939
940**O que fazer:**940**O que fazer:**
941 941
942* Configure seu gateway para encaminhar o cabeçalho `anthropic-beta`. Veja [feature pass-through](/pt/llm-gateway-protocol#feature-pass-through) para o que os gateways devem encaminhar.942* Configure seu gateway para encaminhar o cabeçalho `anthropic-beta`. Veja [feature pass-through](/docs/pt/llm-gateway-protocol#feature-pass-through) para o que os gateways devem encaminhar.
943* Como alternativa, defina [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/pt/env-vars) 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.943* Como alternativa, defina [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/pt/env-vars) 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.
944 944
945<h3 id="theres-an-issue-with-the-selected-model">945<h3 id="theres-an-issue-with-the-selected-model">
946 Há um problema com o modelo selecionado946 Há um problema com o modelo selecionado
955**O que fazer:**955**O que fazer:**
956 956
957* **CLI interativo**: execute `/model` para escolher entre modelos disponíveis para sua conta.957* **CLI interativo**: execute `/model` para escolher entre modelos disponíveis para sua conta.
958* **Modo não interativo (`-p`)**: passe `--model` com um alias ou ID válido, ou defina [`ANTHROPIC_MODEL`](/pt/env-vars). O texto de erro mostra `Run --model` nesta superfície.958* **Modo não interativo (`-p`)**: passe `--model` com um alias ou ID válido, ou defina [`ANTHROPIC_MODEL`](/docs/pt/env-vars). O texto de erro mostra `Run --model` nesta superfície.
959* **Agent SDK**: o texto de erro omite a dica porque o modelo é definido programaticamente. Defina [`model` em `Options`](/pt/agent-sdk/typescript#options) em TypeScript ou [`ClaudeAgentOptions(model=...)`](/pt/agent-sdk/python#claudeagentoptions) em Python, e trate o erro estruturado `model_not_found` para exibir sua própria tentativa ou seletor de modelo.959* **Agent SDK**: o texto de erro omite a dica porque o modelo é definido programaticamente. Defina [`model` em `Options`](/docs/pt/agent-sdk/typescript#options) em TypeScript ou [`ClaudeAgentOptions(model=...)`](/docs/pt/agent-sdk/python#claudeagentoptions) em Python, e trate o erro estruturado `model_not_found` para exibir sua própria tentativa ou seletor de modelo.
960* 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](/pt/model-config).960* 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](/docs/pt/model-config).
961* Se o modelo errado continuar voltando na CLI, um ID obsoleto está definido em algum lugar. Verifique em [ordem de prioridade](/pt/model-config#setting-your-model): 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.961* Se o modelo errado continuar voltando na CLI, um ID obsoleto está definido em algum lugar. Verifique em [ordem de prioridade](/docs/pt/model-config#setting-your-model): 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.
962* {/* min-version: 2.1.206 */}Claude Code relata um login claude.ai expirado como [Login expired](#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.962* Claude Code relata um login claude.ai expirado como [Login expired](#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.
963* Para implantações do Agent Platform do Google Cloud, veja [Troubleshooting do Agent Platform do Google Cloud](/pt/google-vertex-ai#troubleshooting).963* Para implantações do Agent Platform do Google Cloud, veja [Troubleshooting do Agent Platform do Google Cloud](/docs/pt/google-vertex-ai#troubleshooting).
964 964
965<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
966 Modelo não é um ID de modelo reconhecido966 Modelo não é um ID de modelo reconhecido
974 974
975A dica à direita nomeia o alias ou ID de modelo mais próximo. Quando nada é próximo o suficiente, lê `Run /model to see available models.` em vez disso.975A dica à direita nomeia o alias ou ID de modelo mais próximo. Quando nada é próximo o suficiente, lê `Run /model to see available models.` em vez disso.
976 976
977Claude Code produz esse erro localmente no momento em que a mudança é solicitada, antes de qualquer solicitação de API ser feita. Aplica-se quando um modelo é definido através do método [Agent SDK](/pt/agent-sdk/typescript) `setModel()` ou por um aplicativo como o [Desktop app](/pt/desktop) que executa o CLI do Claude Code para você.977Claude Code produz esse erro localmente no momento em que a mudança é solicitada, antes de qualquer solicitação de API ser feita. Aplica-se quando um modelo é definido através do método [Agent SDK](/docs/pt/agent-sdk/typescript) `setModel()` ou por um aplicativo como o [Desktop app](/docs/pt/desktop) que executa o CLI do Claude Code para você.
978 978
979**O que fazer:**979**O que fazer:**
980 980
981* 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á981* 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á
982* 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.982* 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.
983* 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](#theres-an-issue-with-the-selected-model).983* 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](#theres-an-issue-with-the-selected-model).
984* A verificação é executada apenas na API Anthropic. No Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry, [Claude Platform on AWS](/pt/claude-platform-on-aws) e atrás de um [LLM gateway](/pt/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.984* A verificação é executada apenas na API Anthropic. No Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry, [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) e atrás de um [LLM gateway](/docs/pt/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.
985 985
986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">
987 Claude Opus não está disponível com o plano Claude Pro987 Claude Opus não está disponível com o plano Claude Pro
1003 Modelo é restringido pelas configurações da sua organização1003 Modelo é restringido pelas configurações da sua organização
1004</h3>1004</h3>
1005 1005
1006Seu administrador de organização desabilitou este modelo no console de administração claude.ai, ou ele é excluído por uma lista de permissões [`availableModels`](/pt/model-config#restrict-model-selection) em configurações gerenciadas. Quando o modelo restringido foi definido com `--model`, `ANTHROPIC_MODEL` ou a configuração `model`, Claude Code substitui um modelo permitido e continua. Digitar `/model <name>` para um modelo restringido é rejeitado com `Run /model to choose a different model.` e a sessão mantém seu modelo atual.1006Seu administrador de organização desabilitou este modelo no console de administração claude.ai, ou ele é excluído por uma lista de permissões [`availableModels`](/docs/pt/model-config#restrict-model-selection) em configurações gerenciadas. Quando o modelo restringido foi definido com `--model`, `ANTHROPIC_MODEL` ou a configuração `model`, Claude Code substitui um modelo permitido e continua. Digitar `/model <name>` para um modelo restringido é rejeitado com `Run /model to choose a different model.` e a sessão mantém seu modelo atual.
1007 1007
1008```text theme={null}1008```text theme={null}
1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
1010```1010```
1011 1011
1012Claude Code trata um alias de família de modelo, um de `opus`, `sonnet`, `haiku` ou `fable`, como uma solicitação para essa família em vez de sua versão mais recente. Na API Anthropic e em [Claude Platform on AWS](/pt/claude-platform-on-aws), um alias de família restringido resolve para a versão mais recente da família que sua organização e a lista de permissões `availableModels` permitem, e o aviso de substituição nomeia essa versão. Claude Code rejeita `/model <alias>` apenas quando cada versão da família é restringida. Antes de v2.1.205, um alias de família era substituído ou rejeitado com base em sua versão mais recente sozinha, mesmo quando uma versão mais antiga da mesma família era permitida.1012Claude Code trata um alias de família de modelo, um de `opus`, `sonnet`, `haiku` ou `fable`, como uma solicitação para essa família em vez de sua versão mais recente. Na API Anthropic e em [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), um alias de família restringido resolve para a versão mais recente da família que sua organização e a lista de permissões `availableModels` permitem, e o aviso de substituição nomeia essa versão. Claude Code rejeita `/model <alias>` apenas quando cada versão da família é restringida. Antes de v2.1.205, um alias de família era substituído ou rejeitado com base em sua versão mais recente sozinha, mesmo quando uma versão mais antiga da mesma família era permitida.
1013 1013
1014**O que fazer:**1014**O que fazer:**
1015 1015
1016* Execute `/model` para escolher entre os modelos que sua organização permite. Modelos restritos estão ocultos do seletor.1016* Execute `/model` para escolher entre os modelos que sua organização permite. Modelos restritos estão ocultos do seletor.
1017* 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ção1017* 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
1018* Se você precisa de acesso ao modelo restringido, peça ao administrador da sua organização para habilitá-lo. Veja [Organization model restrictions](/pt/model-config#organization-model-restrictions).1018* Se você precisa de acesso ao modelo restringido, peça ao administrador da sua organização para habilitá-lo. Veja [Organization model restrictions](/docs/pt/model-config#organization-model-restrictions).
1019 1019
1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">
1021 thinking.type.enabled não é suportado para este modelo1021 thinking.type.enabled não é suportado para este modelo
1031 1031
1032* 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 posterior1032* 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
1033* Se você não conseguir atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.6 em vez disso1033* Se você não conseguir atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.6 em vez disso
1034* {/* min-version: agent-sdk@0.3.197 */}Se você encontrar isso no [Agent SDK](/pt/agent-sdk/overview), 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 posterior1034* Se você encontrar isso no [Agent SDK](/docs/pt/agent-sdk/overview), 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
1035 1035
1036<h3 id="thinking-budget-exceeds-output-limit">1036<h3 id="thinking-budget-exceeds-output-limit">
1037 Orçamento de pensamento excede limite de saída1037 Orçamento de pensamento excede limite de saída
1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
1044```1044```
1045 1045
1046Claude Code ajusta esses valores automaticamente na API Anthropic. Você normalmente vê esse erro no Amazon Bedrock ou Agent Platform do Google Cloud quando [`MAX_THINKING_TOKENS`](/pt/env-vars) é definido mais alto que o limite de saída do provedor, ou quando o modo de plano aumenta o orçamento de pensamento.1046Claude Code ajusta esses valores automaticamente na API Anthropic. Você normalmente vê esse erro no Amazon Bedrock ou Agent Platform do Google Cloud quando [`MAX_THINKING_TOKENS`](/docs/pt/env-vars) é definido mais alto que o limite de saída do provedor, ou quando o modo de plano aumenta o orçamento de pensamento.
1047 1047
1048**O que fazer:**1048**O que fazer:**
1049 1049
1050* Diminua `MAX_THINKING_TOKENS`, ou aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/pt/env-vars) acima do orçamento de pensamento1050* Diminua `MAX_THINKING_TOKENS`, ou aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/pt/env-vars) acima do orçamento de pensamento
1051* Veja [Extended thinking](/pt/model-config#extended-thinking) para como o orçamento interage com o comprimento de saída1051* Veja [Extended thinking](/docs/pt/model-config#extended-thinking) para como o orçamento interage com o comprimento de saída
1052 1052
1053<h3 id="tool-use-or-thinking-block-mismatch">1053<h3 id="tool-use-or-thinking-block-mismatch">
1054 Incompatibilidade de bloco de uso de ferramenta ou pensamento1054 Incompatibilidade de bloco de uso de ferramenta ou pensamento
1066 1066
1067**O que fazer:**1067**O que fazer:**
1068 1068
1069* {/* max-version: 2.1.155 */}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.1069* 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.
1070* Execute `/rewind`, ou pressione Esc duas vezes, para voltar a um checkpoint antes do turno corrompido e continuar de lá. Veja [Checkpointing](/pt/checkpointing) para como os checkpoints são criados e restaurados.1070* Execute `/rewind`, ou pressione Esc duas vezes, para voltar a um checkpoint antes do turno corrompido e continuar de lá. Veja [Checkpointing](/docs/pt/checkpointing) para como os checkpoints são criados e restaurados.
1071 1071
1072<h3 id="usage-policy-refusal">1072<h3 id="usage-policy-refusal">
1073 Recusa de Política de Uso1073 Recusa de Política de Uso
1079API 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.1079API 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.
1080```1080```
1081 1081
1082A verificação avalia a conversa completa, não apenas seu prompt mais recente, então enviar uma nova mensagem na mesma sessão geralmente re-aciona a mesma recusa. O mesmo se aplica após sair e reabrir a sessão com `--continue` ou `--resume`, já que a transcrição em disco ainda contém o conteúdo acionador. Em [Amazon Bedrock](/pt/amazon-bedrock), [Agent Platform do Google Cloud](/pt/google-vertex-ai) e [Microsoft Foundry](/pt/microsoft-foundry), esta mensagem também cobre solicitações que as medidas de segurança do modelo sinalizaram como um tópico de cibersegurança. Veja [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).1082A verificação avalia a conversa completa, não apenas seu prompt mais recente, então enviar uma nova mensagem na mesma sessão geralmente re-aciona a mesma recusa. O mesmo se aplica após sair e reabrir a sessão com `--continue` ou `--resume`, já que a transcrição em disco ainda contém o conteúdo acionador. Em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) e [Microsoft Foundry](/docs/pt/microsoft-foundry), esta mensagem também cobre solicitações que as medidas de segurança do modelo sinalizaram como um tópico de cibersegurança. Veja [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).
1083 1083
1084**O que fazer:**1084**O que fazer:**
1085 1085
1086* 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](/pt/checkpointing).1086* 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](/docs/pt/checkpointing).
1087* 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`.1087* 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`.
1088* Em [modo não interativo](/pt/headless) (`-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.1088* Em [modo não interativo](/docs/pt/headless) (`-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.
1089 1089
1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">
1091 Medidas de segurança sinalizaram um tópico de cibersegurança1091 Medidas de segurança sinalizaram um tópico de cibersegurança
1103 1103
1104O que você vê depende do seu provedor e modo:1104O que você vê depende do seu provedor e modo:
1105 1105
1106* Em [Amazon Bedrock](/pt/amazon-bedrock), [Agent Platform do Google Cloud](/pt/google-vertex-ai) e [Microsoft Foundry](/pt/microsoft-foundry), uma sinalização de cibersegurança produz a mensagem de [Recusa de Política de Uso](#usage-policy-refusal) em vez disso.1106* Em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) e [Microsoft Foundry](/docs/pt/microsoft-foundry), uma sinalização de cibersegurança produz a mensagem de [Recusa de Política de Uso](#usage-policy-refusal) em vez disso.
1107* [Modo não interativo](/pt/headless) omite a sentença `/feedback`.1107* [Modo não interativo](/docs/pt/headless) omite a sentença `/feedback`.
1108 1108
1109{/* max-version: 2.1.202 */}Antes de v2.1.203, a mensagem lia `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` seguida por um link de formulário de isenção.1109Antes de v2.1.203, a mensagem lia `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` seguida por um link de formulário de isenção.
1110 1110
1111**O que fazer:**1111**O que fazer:**
1112 1112
1113* Se seu trabalho exigir este conteúdo, solicite acesso através do [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)1113* Se seu trabalho exigir este conteúdo, solicite acesso através do [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)
1114* Se sua solicitação não era sobre um tópico de cibersegurança, execute `/feedback` para relatar o falso positivo1114* Se sua solicitação não era sobre um tópico de cibersegurança, execute `/feedback` para relatar o falso positivo
1115* 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](/pt/checkpointing).1115* 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](/docs/pt/checkpointing).
1116 1116
1117<h2 id="installation-errors">1117<h2 id="installation-errors">
1118 Erros de instalação1118 Erros de instalação
1119</h2>1119</h2>
1120 1120
1121Esses erros aparecem durante a instalação ou atualização do Claude Code, a partir do [script de instalação](/pt/setup#install-claude-code), `claude install`, ou `claude update`. Para problemas de `command not found`, PATH, permissão e TLS durante a configuração, consulte [Solucionar problemas de instalação e login](/pt/troubleshoot-install).1121Esses erros aparecem durante a instalação ou atualização do Claude Code, a partir do [script de instalação](/docs/pt/setup#install-claude-code), `claude install`, ou `claude update`. Para problemas de `command not found`, PATH, permissão e TLS durante a configuração, consulte [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install).
1122 1122
1123<h3 id="installation-was-killed-before-it-could-finish">1123<h3 id="installation-was-killed-before-it-could-finish">
1124 A instalação foi interrompida antes de ser concluída1124 A instalação foi interrompida antes de ser concluída
1136**O que fazer:**1136**O que fazer:**
1137 1137
1138* Interrompa outros processos para liberar memória e execute novamente o instalador1138* Interrompa outros processos para liberar memória e execute novamente o instalador
1139* Adicione espaço de swap ou mude para uma instância maior. Consulte [Instalação interrompida em servidores Linux com pouca memória](/pt/troubleshoot-install#install-killed-on-low-memory-linux-servers) para os comandos de arquivo de swap.1139* Adicione espaço de swap ou mude para uma instância maior. Consulte [Instalação interrompida em servidores Linux com pouca memória](/docs/pt/troubleshoot-install#install-killed-on-low-memory-linux-servers) para os comandos de arquivo de swap.
1140 1140
1141<h3 id="the-connection-dropped-while-downloading-the-update">1141<h3 id="the-connection-dropped-while-downloading-the-update">
1142 A conexão foi interrompida durante o download da atualização1142 A conexão foi interrompida durante o download da atualização
1143</h3>1143</h3>
1144 1144
1145A conexão com o servidor de download foi fechada enquanto `claude install`, `claude update`, ou o [atualizador automático](/pt/setup#auto-updates) estava buscando o binário do Claude Code, e as tentativas de repetição não se recuperaram. Claude Code tenta novamente o download quando a conexão cai, a transferência trava ou o arquivo baixado falha em sua soma de verificação, até três tentativas no total. Um erro HTTP concluído, como um 404, não é repetido porque o servidor já respondeu. {/* min-version: 2.1.202 */}Antes da v2.1.202, uma única conexão interrompida falhava no download imediatamente com o erro nú `aborted` em vez de tentar novamente.1145A conexão com o servidor de download foi fechada enquanto `claude install`, `claude update`, ou o [atualizador automático](/docs/pt/setup#auto-updates) estava buscando o binário do Claude Code, e as tentativas de repetição não se recuperaram. Claude Code tenta novamente o download quando a conexão cai, a transferência trava ou o arquivo baixado falha em sua soma de verificação, até três tentativas no total. Um erro HTTP concluído, como um 404, não é repetido porque o servidor já respondeu. Antes da v2.1.202, uma única conexão interrompida falhava no download imediatamente com o erro nú `aborted` em vez de tentar novamente.
1146 1146
1147```text theme={null}1147```text theme={null}
1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
1157**O que fazer:**1157**O que fazer:**
1158 1158
1159* 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.1159* 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.
1160* Se sua rede exigir um proxy, defina `HTTPS_PROXY` antes de executar o instalador ou `claude update`. Consulte [Verificar conectividade de rede](/pt/troubleshoot-install#check-network-connectivity).1160* Se sua rede exigir um proxy, defina `HTTPS_PROXY` antes de executar o instalador ou `claude update`. Consulte [Verificar conectividade de rede](/docs/pt/troubleshoot-install#check-network-connectivity).
1161* 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](/pt/network-config#network-access-requirements).1161* 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](/docs/pt/network-config#network-access-requirements).
1162* Execute `claude doctor` do seu shell para diagnósticos de instalação1162* Execute `claude doctor` do seu shell para diagnósticos de instalação
1163 1163
1164<h2 id="command-line-errors">1164<h2 id="command-line-errors">
1171 Conflito entre --bg e --print1171 Conflito entre --bg e --print
1172</h3>1172</h3>
1173 1173
1174Esta mensagem requer Claude Code v2.1.198 ou posterior. Você combinou `--bg` com `-p` ou `--print` na mesma invocação de `claude`. `--bg` inicia uma [sessão em background](/pt/agent-view#from-your-shell) que você depois anexa com `claude agents`, enquanto `--print` executa [não interativamente](/pt/headless) e nunca inicia a sessão interativa que `claude agents` anexa. Antes da v2.1.198, essa combinação criava silenciosamente um job em background que nunca poderia ser anexado.1174Esta mensagem requer Claude Code v2.1.198 ou posterior. Você combinou `--bg` com `-p` ou `--print` na mesma invocação de `claude`. `--bg` inicia uma [sessão em background](/docs/pt/agent-view#from-your-shell) que você depois anexa com `claude agents`, enquanto `--print` executa [não interativamente](/docs/pt/headless) e nunca inicia a sessão interativa que `claude agents` anexa. Antes da v2.1.198, essa combinação criava silenciosamente um job em background que nunca poderia ser anexado.
1175 1175
1176```text theme={null}1176```text theme={null}
1177--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>'`.1177--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>'`.
1179 1179
1180**O que fazer:**1180**O que fazer:**
1181 1181
1182* 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](/pt/agent-view#from-your-shell).1182* 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](/docs/pt/agent-view#from-your-shell).
1183* 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>"`1183* 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>"`
1184 1184
1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
1186 O valor de --json-schema não é um JSON Schema válido1186 O valor de --json-schema não é um JSON Schema válido
1187</h3>1187</h3>
1188 1188
1189O schema que você passou para [`--json-schema`](/pt/cli-reference#cli-flags) no [modo não interativo](/pt/headless#get-structured-output) falhou na compilação do JSON Schema, então `claude` sai com código 1 em vez de executar o prompt. Antes da v2.1.205, um schema inválido produzia saída não estruturada sem erro, e qualquer schema que usasse a palavra-chave `format` era tratado como inválido.1189O schema que você passou para [`--json-schema`](/docs/pt/cli-reference#cli-flags) no [modo não interativo](/docs/pt/headless#get-structured-output) falhou na compilação do JSON Schema, então `claude` sai com código 1 em vez de executar o prompt. Antes da v2.1.205, um schema inválido produzia saída não estruturada sem erro, e qualquer schema que usasse a palavra-chave `format` era tratado como inválido.
1190 1190
1191```text theme={null}1191```text theme={null}
1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
1200 1200
1201* Corrija a parte do schema que o diagnóstico nomeia, depois execute o comando novamente1201* Corrija a parte do schema que o diagnóstico nomeia, depois execute o comando novamente
1202* Se o diagnóstico for `schema too large`, reduza o aninhamento do schema e a reutilização de `$ref`1202* Se o diagnóstico for `schema too large`, reduza o aninhamento do schema e a reutilização de `$ref`
1203* Veja [Get structured output](/pt/headless#get-structured-output) para um schema e comando funcionando1203* Veja [Get structured output](/docs/pt/headless#get-structured-output) para um schema e comando funcionando
1204 1204
1205<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">
1206 Não foi possível importar um servidor do Claude Desktop1206 Não foi possível importar um servidor do Claude Desktop
1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
1213```1213```
1214 1214
1215O texto após o nome do servidor é o motivo. O mais comum é a verificação de nome: Claude Desktop permite caracteres em nomes de servidores, como espaços e pontos, que `claude mcp` restringe a letras, números, hífens e sublinhados. Outros motivos incluem uma configuração de servidor que falha na validação e um servidor bloqueado pela [política MCP](/pt/managed-mcp) da sua organização.1215O texto após o nome do servidor é o motivo. O mais comum é a verificação de nome: Claude Desktop permite caracteres em nomes de servidores, como espaços e pontos, que `claude mcp` restringe a letras, números, hífens e sublinhados. Outros motivos incluem uma configuração de servidor que falha na validação e um servidor bloqueado pela [política MCP](/docs/pt/managed-mcp) da sua organização.
1216 1216
1217**O que fazer:**1217**O que fazer:**
1218 1218
1219* 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` novamente1219* 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
1220* 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](/pt/mcp#import-mcp-servers-from-claude-desktop).1220* 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](/docs/pt/mcp#import-mcp-servers-from-claude-desktop).
1221 1221
1222<h3 id="mcp-permission-prompt-tool-not-found">1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 Ferramenta de prompt de permissão MCP não encontrada1223 Ferramenta de prompt de permissão MCP não encontrada
1224</h3>1224</h3>
1225 1225
1226A ferramenta que você passou para [`--permission-prompt-tool`](/pt/cli-reference#cli-flags) não estava entre as ferramentas MCP conectadas quando a execução primeiro precisou de uma decisão de permissão, seja porque seu servidor nunca se conectou ou porque nenhum servidor conectado expõe uma ferramenta com esse nome. Claude Code ainda envia seu prompt: a execução [não interativa](/pt/headless) sai com esse erro, e código de saída 1, na primeira chamada de ferramenta que precisa de aprovação, então não produz resposta mesmo que a solicitação tenha sido feita. Antes do primeiro prompt, Claude Code aguarda até o tempo limite de conexão por servidor de 30 segundos definido por [`MCP_TIMEOUT`](/pt/env-vars) para que esse servidor se conecte. {/* min-version: 2.1.206 */}Antes da v2.1.206, a inicialização não aguardava o servidor terminar de se conectar, então um servidor que iniciava lentamente mas estava saudável também produzia esse erro.1226A ferramenta que você passou para [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) não estava entre as ferramentas MCP conectadas quando a execução primeiro precisou de uma decisão de permissão, seja porque seu servidor nunca se conectou ou porque nenhum servidor conectado expõe uma ferramenta com esse nome. Claude Code ainda envia seu prompt: a execução [não interativa](/docs/pt/headless) sai com esse erro, e código de saída 1, na primeira chamada de ferramenta que precisa de aprovação, então não produz resposta mesmo que a solicitação tenha sido feita. Antes do primeiro prompt, Claude Code aguarda até o tempo limite de conexão por servidor de 30 segundos definido por [`MCP_TIMEOUT`](/docs/pt/env-vars) para que esse servidor se conecte. Antes da v2.1.206, a inicialização não aguardava o servidor terminar de se conectar, então um servidor que iniciava lentamente mas estava saudável também produzia esse erro.
1227 1227
1228```text theme={null}1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1235 1235
1236* Verifique se o servidor inicia e permanece conectado: execute `claude mcp list` no mesmo diretório e confirme se o servidor está listado como conectado1236* 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
1237* Confirme se o nome da ferramenta corresponde ao nome `mcp__<server>__<tool>` que o servidor expõe1237* Confirme se o nome da ferramenta corresponde ao nome `mcp__<server>__<tool>` que o servidor expõe
1238* Se o servidor precisar de mais de 30 segundos para iniciar, aumente [`MCP_TIMEOUT`](/pt/env-vars)1238* Se o servidor precisar de mais de 30 segundos para iniciar, aumente [`MCP_TIMEOUT`](/docs/pt/env-vars)
1239 1239
1240<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1241 Erros de plugin1241 Erros de plugin
1242</h2>1242</h2>
1243 1243
1244Esses erros vêm da configuração de [plugin](/pt/plugins) e [marketplace](/pt/plugin-marketplaces). Para problemas de plugin que não produzem uma das mensagens nesta página, como uma URL de marketplace que não carrega ou um plugin que é instalado mas não aparece, consulte [Solução de problemas de plugin](/pt/discover-plugins#troubleshooting).1244Esses erros vêm da configuração de [plugin](/docs/pt/plugins) e [marketplace](/docs/pt/plugin-marketplaces). Para problemas de plugin que não produzem uma das mensagens nesta página, como uma URL de marketplace que não carrega ou um plugin que é instalado mas não aparece, consulte [Solução de problemas de plugin](/docs/pt/discover-plugins#troubleshooting).
1245 1245
1246<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">
1247 Marketplace registrado de uma fonte não confiável1247 Marketplace registrado de uma fonte não confiável
1248</h3>1248</h3>
1249 1249
1250O marketplace é registrado sob um nome que é [reservado para marketplaces oficiais da Anthropic](/pt/plugin-marketplaces#marketplace-schema), mas sua fonte registrada não é um repositório GitHub `anthropics`. Claude Code verifica novamente os nomes reservados toda vez que carrega ou atualiza um marketplace, portanto o marketplace e os plugins instalados a partir dele param de carregar. Antes da v2.1.205, o nome era verificado apenas quando o marketplace era adicionado, então uma entrada registrada antes de seu nome ficar reservado continuava carregando.1250O marketplace é registrado sob um nome que é [reservado para marketplaces oficiais da Anthropic](/docs/pt/plugin-marketplaces#marketplace-schema), mas sua fonte registrada não é um repositório GitHub `anthropics`. Claude Code verifica novamente os nomes reservados toda vez que carrega ou atualiza um marketplace, portanto o marketplace e os plugins instalados a partir dele param de carregar. Antes da v2.1.205, o nome era verificado apenas quando o marketplace era adicionado, então uma entrada registrada antes de seu nome ficar reservado continuava carregando.
1251 1251
1252```text theme={null}1252```text theme={null}
1253Marketplace "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.1253Marketplace "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.
1257 1257
1258* Execute `claude plugin marketplace remove <name>`, depois adicione o marketplace novamente do repositório oficial `github.com/anthropics`1258* Execute `claude plugin marketplace remove <name>`, depois adicione o marketplace novamente do repositório oficial `github.com/anthropics`
1259* 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 fonte1259* 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
1260* Consulte a lista de nomes reservados em [Marketplace schema](/pt/plugin-marketplaces#marketplace-schema)1260* Consulte a lista de nomes reservados em [Marketplace schema](/docs/pt/plugin-marketplaces#marketplace-schema)
1261 1261
1262<h3 id="plugin-command-references-user-config">1262<h3 id="plugin-command-references-user-config">
1263 Plugin command references user\_config in a shell command1263 Plugin command references user\_config in a shell command
1264</h3>1264</h3>
1265 1265
1266Um hook de plugin, [monitor](/pt/plugins-reference#monitors), ou comando MCP [`headersHelper`](/pt/mcp#use-dynamic-headers-for-custom-authentication) referencia uma [opção de plugin](/pt/plugins-reference#user-configuration) `${user_config.KEY}`, e a string substituída seria passada para um shell. Um valor configurado contendo `$(...)`, backticks ou `;` seria executado como código lá, então Claude Code recusa iniciar o componente em vez de substituir o valor. A verificação é executada no modelo de comando, então o erro aparece mesmo quando nenhum valor está configurado ainda. Antes da v2.1.207, o valor era substituído no comando shell.1266Um hook de plugin, [monitor](/docs/pt/plugins-reference#monitors), ou comando MCP [`headersHelper`](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication) referencia uma [opção de plugin](/docs/pt/plugins-reference#user-configuration) `${user_config.KEY}`, e a string substituída seria passada para um shell. Um valor configurado contendo `$(...)`, backticks ou `;` seria executado como código lá, então Claude Code recusa iniciar o componente em vez de substituir o valor. A verificação é executada no modelo de comando, então o erro aparece mesmo quando nenhum valor está configurado ainda. Antes da v2.1.207, o valor era substituído no comando shell.
1267 1267
1268A redação depende de qual superfície referenciou a opção. Um hook em forma de shell relata:1268A redação depende de qual superfície referenciou a opção. Um hook em forma de shell relata:
1269 1269
1285 1285
1286**O que fazer:**1286**O que fazer:**
1287 1287
1288* Para um hook, adicione um array `args` para que ele seja executado em [exec form](/pt/hooks#exec-form-and-shell-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 script1288* Para um hook, adicione um array `args` para que ele seja executado em [exec form](/docs/pt/hooks#exec-form-and-shell-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
1289* Para um monitor, remova a referência e faça o script do monitor ler o valor de um arquivo de configuração1289* Para um monitor, remova a referência e faça o script do monitor ler o valor de um arquivo de configuração
1290* 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 helper1290* 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
1291 1291
1299 Agent seria gerado com zero ferramentas1299 Agent seria gerado com zero ferramentas
1300</h3>1300</h3>
1301 1301
1302Nada na [lista de `tools` de um subagente](/pt/sub-agents#supported-frontmatter-fields) foi resolvido para uma ferramenta, então Claude Code recusa iniciar o subagente em vez de iniciar um que não possa agir. A mensagem agrupa as entradas pelo motivo pelo qual não foram resolvidas: não é uma ferramenta reconhecida, uma ferramenta que não está disponível para subagentes, ou reconhecida mas não corresponde a nenhuma ferramenta na sessão atual. Omitir o campo `tools` nunca dispara essa recusa. Um padrão de servidor MCP como `mcp__github__*` não é isento: quando nenhuma ferramenta conectada vem desse servidor, o lançamento é recusado com o padrão no grupo de não correspondência. Antes da v2.1.208, o subagente era lançado sem ferramentas e retornava um resultado vazio ou confuso.1302Nada na [lista de `tools` de um subagente](/docs/pt/sub-agents#supported-frontmatter-fields) foi resolvido para uma ferramenta, então Claude Code recusa iniciar o subagente em vez de iniciar um que não possa agir. A mensagem agrupa as entradas pelo motivo pelo qual não foram resolvidas: não é uma ferramenta reconhecida, uma ferramenta que não está disponível para subagentes, ou reconhecida mas não corresponde a nenhuma ferramenta na sessão atual. Omitir o campo `tools` nunca dispara essa recusa. Um padrão de servidor MCP como `mcp__github__*` não é isento: quando nenhuma ferramenta conectada vem desse servidor, o lançamento é recusado com o padrão no grupo de não correspondência. Antes da v2.1.208, o subagente era lançado sem ferramentas e retornava um resultado vazio ou confuso.
1303 1303
1304```text theme={null}1304```text theme={null}
1305Agent '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.1305Agent '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.
1307 1307
1308**O que fazer:**1308**O que fazer:**
1309 1309
1310* Corrija cada entrada que o erro nomeia contra as [ferramentas disponíveis para subagentes](/pt/sub-agents#available-tools)1310* Corrija cada entrada que o erro nomeia contra as [ferramentas disponíveis para subagentes](/docs/pt/sub-agents#available-tools)
1311* Remova entradas para ferramentas que a sessão não possui, como ferramentas MCP de um servidor que não está conectado1311* Remova entradas para ferramentas que a sessão não possui, como ferramentas MCP de um servidor que não está conectado
1312* Para dar ao subagente todas as ferramentas que o pai tem, delete o campo `tools` em vez de listar ferramentas1312* Para dar ao subagente todas as ferramentas que o pai tem, delete o campo `tools` em vez de listar ferramentas
1313 1313
1315 Arquivo é coberto por uma regra de negação Read1315 Arquivo é coberto por uma regra de negação Read
1316</h3>1316</h3>
1317 1317
1318A ferramenta Edit foi chamada em um caminho correspondido por uma [regra de negação `Read`](/pt/permissions#read-and-edit), incluindo criar um novo arquivo nesse caminho. Editar reescreve conteúdo que Claude tem que ser capaz de ler novamente, então a chamada é recusada antes de qualquer acesso ao arquivo. A regra bloqueia apenas a ferramenta Edit: Write e NotebookEdit não são cobertos por regras de negação `Read`. Antes da v2.1.208, apenas uma regra de negação `Edit` bloqueava edições, e uma regra de negação `Read` sozinha não.1318A ferramenta Edit foi chamada em um caminho correspondido por uma [regra de negação `Read`](/docs/pt/permissions#read-and-edit), incluindo criar um novo arquivo nesse caminho. Editar reescreve conteúdo que Claude tem que ser capaz de ler novamente, então a chamada é recusada antes de qualquer acesso ao arquivo. A regra bloqueia apenas a ferramenta Edit: Write e NotebookEdit não são cobertos por regras de negação `Read`. Antes da v2.1.208, apenas uma regra de negação `Edit` bloqueava edições, e uma regra de negação `Read` sozinha não.
1319 1319
1320```text theme={null}1320```text theme={null}
1321Arquivo é coberto por uma regra de negação Read em suas configurações de permissão e não pode ser editado.1321Arquivo é coberto por uma regra de negação Read em suas configurações de permissão e não pode ser editado.
1323 1323
1324**O que fazer:**1324**O que fazer:**
1325 1325
1326* Se Claude deve ser capaz de editar o arquivo, remova ou restrinja a regra de negação `Read` em `/permissions` ou em [configurações](/pt/settings#permission-settings)1326* Se Claude deve ser capaz de editar o arquivo, remova ou restrinja a regra de negação `Read` em `/permissions` ou em [configurações](/docs/pt/settings#permission-settings)
1327* 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 bloqueadas1327* 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
1328 1328
1329<h2 id="background-session-errors">1329<h2 id="background-session-errors">
1330 Erros de sessão em background1330 Erros de sessão em background
1331</h2>1331</h2>
1332 1332
1333[Sessões em background](/pt/agent-view) são executadas sem um terminal interativo próprio, portanto comandos que precisam de um se comportam de forma diferente lá. Essas mensagens aparecem na transcrição de uma sessão em background, na visualização do agente ou após anexar.1333[Sessões em background](/docs/pt/agent-view) são executadas sem um terminal interativo próprio, portanto comandos que precisam de um se comportam de forma diferente lá. Essas mensagens aparecem na transcrição de uma sessão em background, na visualização do agente ou após anexar.
1334 1334
1335<h3 id="commands-refused-in-a-background-session">1335<h3 id="commands-refused-in-a-background-session">
1336 Comandos recusados em uma sessão em background1336 Comandos recusados em uma sessão em background
1337</h3>1337</h3>
1338 1338
1339Comandos que abrem um diálogo interativo são recusados em uma sessão em background com uma mensagem nomeando um formulário que funciona lá ou dizendo para você executar o comando a partir de um terminal regular. `/install-github-app`, a lista de configurações `/mcp` e as ações de autenticação no menu do servidor MCP são todos recusados dessa forma. Antes da v2.1.208, eles abriam seu diálogo dentro da sessão em background.1339Comandos que abrem um diálogo interativo são recusados em uma sessão em background com uma mensagem nomeando um formulário que funciona lá ou dizendo para você executar o comando a partir de um terminal regular. `/install-github-app`, a lista de configurações `/mcp` e as ações de autenticação no menu do servidor MCP são todos recusados dessa forma. Antes da v2.1.208, eles abriam seu diálogo dentro da sessão em background.
1340{/* max-version: 2.1.208 */}Na v2.1.208 apenas, o seletor `/model` também foi recusado em uma sessão em background, e `/upgrade` imprimiu a URL de atualização em vez de abrir um navegador.1340Na v2.1.208 apenas, o seletor `/model` também foi recusado em uma sessão em background, e `/upgrade` imprimiu a URL de atualização em vez de abrir um navegador.
1341 1341
1342A redação nomeia o comando que foi recusado. A lista de configurações `/mcp` relata:1342A redação nomeia o comando que foi recusado. A lista de configurações `/mcp` relata:
1343 1343
1354 Erros do launcher CLAUDE\_CODE\_PROCESS\_WRAPPER1354 Erros do launcher CLAUDE\_CODE\_PROCESS\_WRAPPER
1355</h3>1355</h3>
1356 1356
1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/pt/corporate-launcher) está definido e seu valor não pode ser usado, portanto Claude Code recusa iniciar o processo afetado em vez de executá-lo sem o launcher. Problemas de configuração são relatados com uma mensagem que começa com o nome da variável e declara o motivo, por exemplo:1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/pt/corporate-launcher) está definido e seu valor não pode ser usado, portanto Claude Code recusa iniciar o processo afetado em vez de executá-lo sem o launcher. Problemas de configuração são relatados com uma mensagem que começa com o nome da variável e declara o motivo, por exemplo:
1358 1358
1359```text theme={null}1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1364 1364
1365**O que fazer:**1365**O que fazer:**
1366 1366
1367* Defina a variável para o caminho absoluto de um executável que termina chamando `exec "$@"`. Veja [o contrato do launcher](/pt/corporate-launcher#the-launcher-contract) para o contrato completo1367* Defina a variável para o caminho absoluto de um executável que termina chamando `exec "$@"`. Veja [o contrato do launcher](/docs/pt/corporate-launcher#the-launcher-contract) para o contrato completo
1368* 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 shell1368* 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
1369* Após corrigir o valor no bloco `env` de [settings](/pt/corporate-launcher#set-up-the-launcher), reinicie o serviço em background com `claude daemon stop --any` para que o próximo dispatch inicie um envolvido1369* Após corrigir o valor no bloco `env` de [settings](/docs/pt/corporate-launcher#set-up-the-launcher), reinicie o serviço em background com `claude daemon stop --any` para que o próximo dispatch inicie um envolvido
1370 1370
1371<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1372 Avisos de configuração1372 Avisos de configuração
1378 Workspace não foi confiável1378 Workspace não foi confiável
1379</h3>1379</h3>
1380 1380
1381Claude Code encontrou regras `permissions.allow` ou entradas `permissions.additionalDirectories` no arquivo `.claude/settings.json` ou `.claude/settings.local.json` do projeto e não as aplicou, porque [as regras de permissão do projeto requerem confiança do workspace](/pt/permissions#project-allow-rules-and-workspace-trust). A contagem, o nome da configuração e o arquivo nomeado na mensagem variam com sua configuração. As regras `deny` e `ask` não são afetadas.1381Claude Code encontrou regras `permissions.allow` ou entradas `permissions.additionalDirectories` no arquivo `.claude/settings.json` ou `.claude/settings.local.json` do projeto e não as aplicou, porque [as regras de permissão do projeto requerem confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust). A contagem, o nome da configuração e o arquivo nomeado na mensagem variam com sua configuração. As regras `deny` e `ask` não são afetadas.
1382 1382
1383```text theme={null}1383```text theme={null}
1384Ignoring 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.1384Ignoring 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.
1386 1386
1387**O que fazer:**1387**O que fazer:**
1388 1388
1389* Execute `claude` no diretório e aceite o diálogo de confiança. {/* min-version: 2.1.200 */}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á.1389* 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á.
1390* No [modo não interativo](/pt/headless) com `-p` nenhum diálogo é mostrado. Defina a entrada `hasTrustDialogAccepted` em `~/.claude.json` usando a chave `projects` exata que a mensagem imprime.1390* No [modo não interativo](/docs/pt/headless) com `-p` nenhum diálogo é mostrado. Defina a entrada `hasTrustDialogAccepted` em `~/.claude.json` usando a chave `projects` exata que a mensagem imprime.
1391* {/* min-version: 2.1.200 */}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. {/* min-version: 2.1.207 */}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](/pt/permissions#project-allow-rules-and-workspace-trust) estão isentos e não esperam pelo diálogo. Veja [Regras de permissão do projeto e confiança do workspace](/pt/permissions#project-allow-rules-and-workspace-trust).1391* 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](/docs/pt/permissions#project-allow-rules-and-workspace-trust) estão isentos e não esperam pelo diálogo. Veja [Regras de permissão do projeto e confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust).
1392 1392
1393<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1394 As respostas parecem ter qualidade inferior ao usual1394 As respostas parecem ter qualidade inferior ao usual
1396 1396
1397Se as respostas do Claude parecerem menos capazes do que você espera, mas nenhum erro for exibido, a causa geralmente é o estado da conversa em vez do modelo em si. Claude Code não muda silenciosamente versões de modelo. Ele pode mudar para um modelo de fallback em três casos específicos:1397Se as respostas do Claude parecerem menos capazes do que você espera, mas nenhum erro for exibido, a causa geralmente é o estado da conversa em vez do modelo em si. Claude Code não muda silenciosamente versões de modelo. Ele pode mudar para um modelo de fallback em três casos específicos:
1398 1398
1399* Um [`--fallback-model`](/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição1399* Um [`--fallback-model`](/docs/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição
1400* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível1400* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível
1401* [Fallback automático de modelo](/pt/model-config#automatic-model-fallback) no Fable 5 move a sessão para o modelo Opus padrão e mostra um aviso na transcrição1401* [Fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) no Fable 5 move a sessão para o modelo Opus padrão e mostra um aviso na transcrição
1402 1402
1403A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](/pt/model-config) explica quando cada fallback se aplica.1403A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](/docs/pt/model-config) explica quando cada fallback se aplica.
1404 1404
1405Verifique estes primeiro:1405Verifique estes primeiro:
1406 1406
1407* **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.1407* **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.
1408* **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](/pt/model-config#adjust-effort-level) para padrões por modelo e o atalho `ultrathink`.1408* **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](/docs/pt/model-config#adjust-effort-level) para padrões por modelo e o atalho `ultrathink`.
1409* **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](/pt/context-window) para como auto-compact afeta turnos anteriores.1409* **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](/docs/pt/context-window) para como auto-compact afeta turnos anteriores.
1410* **Instruções obsoletas**: arquivos `CLAUDE.md` grandes ou desatualizados e definições de ferramentas MCP consomem contexto e podem orientar respostas. {/* min-version: 2.1.205 */}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.1410* **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.
1411 1411
1412Quando uma resposta sai errada, retroceder geralmente funciona melhor do que responder com correções. Pressione Esc duas vezes ou execute `/rewind` para voltar antes do turno ruim, depois reformule o prompt com mais especificidades. Corrigir na thread mantém a tentativa errada no contexto, o que pode ancorar respostas posteriores a ela. Veja [Checkpointing](/pt/checkpointing).1412Quando uma resposta sai errada, retroceder geralmente funciona melhor do que responder com correções. Pressione Esc duas vezes ou execute `/rewind` para voltar antes do turno ruim, depois reformule o prompt com mais especificidades. Corrigir na thread mantém a tentativa errada no contexto, o que pode ancorar respostas posteriores a ela. Veja [Checkpointing](/docs/pt/checkpointing).
1413 1413
1414Se a qualidade ainda parecer inadequada após verificar o acima, execute `/feedback` e descreva o que você esperava versus o que obteve. O feedback enviado desta forma inclui a transcrição da conversa, que é a forma mais rápida para a Anthropic diagnosticar uma regressão real. Veja [Relatar um erro](#report-an-error) se `/feedback` não estiver disponível em seu ambiente.1414Se a qualidade ainda parecer inadequada após verificar o acima, execute `/feedback` e descreva o que você esperava versus o que obteve. O feedback enviado desta forma inclui a transcrição da conversa, que é a forma mais rápida para a Anthropic diagnosticar uma regressão real. Veja [Relatar um erro](#report-an-error) se `/feedback` não estiver disponível em seu ambiente.
1415 1415
1416Se Claude avisar sobre uma injeção de prompt suspeita, ou recusar uma solicitação por causa de uma injeção suspeita, e o texto que o aviso nomeia for contexto que Claude Code adiciona à conversa automaticamente em vez de conteúdo de arquivo ou web, execute `claude update` e tente novamente. Se o aviso se repetir após atualizar, [relate-o](#report-an-error) em vez de colar o conteúdo sinalizado de volta no prompt. {/* min-version: 2.1.201 */}Antes da v2.1.201, Sonnet 5 recusava algumas solicitações da mesma forma.1416Se Claude avisar sobre uma injeção de prompt suspeita, ou recusar uma solicitação por causa de uma injeção suspeita, e o texto que o aviso nomeia for contexto que Claude Code adiciona à conversa automaticamente em vez de conteúdo de arquivo ou web, execute `claude update` e tente novamente. Se o aviso se repetir após atualizar, [relate-o](#report-an-error) em vez de colar o conteúdo sinalizado de volta no prompt. Antes da v2.1.201, Sonnet 5 recusava algumas solicitações da mesma forma.
1417 1417
1418<h2 id="report-an-error">1418<h2 id="report-an-error">
1419 Relatar um erro1419 Relatar um erro
1421 1421
1422Para erros de componentes que esta página não cobre, consulte o guia relevante:1422Para erros de componentes que esta página não cobre, consulte o guia relevante:
1423 1423
1424* Servidor MCP falhou ao conectar ou autenticar: [MCP](/pt/mcp)1424* Servidor MCP falhou ao conectar ou autenticar: [MCP](/docs/pt/mcp)
1425* Script de hook falhou ou bloqueou uma ferramenta: [Debug hooks](/pt/hooks#debug-hooks)1425* Script de hook falhou ou bloqueou uma ferramenta: [Debug hooks](/docs/pt/hooks#debug-hooks)
1426* Permissão negada ou erros do sistema de arquivos durante a instalação: [Solucionar problemas de instalação e login](/pt/troubleshoot-install)1426* Permissão negada ou erros do sistema de arquivos durante a instalação: [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install)
1427 1427
1428Se um erro não estiver listado aqui ou a correção sugerida não ajudar:1428Se um erro não estiver listado aqui ou a correção sugerida não ajudar:
1429 1429
1430* 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](/pt/authentication). 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.1430* 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](/docs/pt/authentication). 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.
1431* 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ção1431* 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
1432* Verifique [status.claude.com](https://status.claude.com) para incidentes ativos1432* Verifique [status.claude.com](https://status.claude.com) para incidentes ativos
1433* Pesquise [problemas existentes](https://github.com/anthropics/claude-code/issues) no GitHub1433* Pesquise [problemas existentes](https://github.com/anthropics/claude-code/issues) no GitHub