8 8
9Esta página lista 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 estar erradas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install).9Esta página lista 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 estar erradas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install).
10 10
11Exceto pelos [erros de Wrapper e IDE](#wrapper-and-ide-errors), que o programa de inicialização imprime em vez do próprio Claude Code, esses erros e comandos de recuperação se aplicam em toda a CLI, no [aplicativo Desktop](/docs/pt/desktop) e [sessões em nuvem](/docs/pt/claude-code-on-the-web), já que todos os três envolvem o mesmo CLI do Claude Code. Para outros problemas específicos da superfície, consulte a seção de solução de problemas na página dessa superfície.11Exceto pelos [erros de Wrapper e IDE](#wrapper-and-ide-errors), que o programa de inicialização imprime em vez do próprio Claude Code, esses erros e comandos de recuperação se aplicam em toda a CLI, no [aplicativo Desktop](/docs/pt/desktop) e [sessões na nuvem](/docs/pt/claude-code-on-the-web), já que todos os três envolvem o mesmo CLI do Claude Code. Para outros 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 de 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/en/api/errors).14 O Claude Code chama a API Claude para respostas de 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/en/api/errors).
75| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |75| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
76| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |76| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
77| `Couldn't verify your organization's policy for remote control` | [Troubleshoot Remote Control](/docs/pt/remote-control#couldnt-verify-your-organizations-policy-for-remote-control) |77| `Couldn't verify your organization's policy for remote control` | [Troubleshoot Remote Control](/docs/pt/remote-control#couldnt-verify-your-organizations-policy-for-remote-control) |
78| `Remote Control is disabled by your organization's policy` | [Troubleshoot Remote Control](/docs/pt/remote-control#remote-control-is-disabled-by-your-organizations-policy) |
79| `Remote Control was turned off by your organization's policy` | [Troubleshoot Remote Control](/docs/pt/remote-control#remote-control-was-turned-off-by-your-organizations-policy) |
78| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |80| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |
79| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |81| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |
80| `Login expired · Please run /login` | [Authentication](#login-expired) |82| `Login expired · Please run /login` | [Authentication](#login-expired) |
186| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |188| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
187| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |189| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
188| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |190| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |
191| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Command-line errors](#conflict-between-a-system-prompt-flag-and-its-file-form) |
189| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |192| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
190| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |193| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
191| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |194| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
212| `OAuth callback port <port> is already in use — another process may be holding it` | [Command-line errors](#oauth-callback-port-is-already-in-use) |215| `OAuth callback port <port> is already in use — another process may be holding it` | [Command-line errors](#oauth-callback-port-is-already-in-use) |
213| `No available ports for OAuth redirect` | [Command-line errors](#no-available-ports-for-oauth-redirect) |216| `No available ports for OAuth redirect` | [Command-line errors](#no-available-ports-for-oauth-redirect) |
214| `Shell command failed for pattern "..."`, de `/security-review` ou qualquer skill que injete contexto dinâmico | [Command-line errors](#security-review-fails-without-origin-head) |217| `Shell command failed for pattern "..."`, de `/security-review` ou qualquer skill que injete contexto dinâmico | [Command-line errors](#security-review-fails-without-origin-head) |
215| `Shell command permission check failed for pattern "..."`, de um skill que injete contexto dinâmico | [Command-line errors](#security-review-fails-without-origin-head) |218| `Shell command permission check failed for pattern "..."`, de uma skill que injete contexto dinâmico | [Command-line errors](#security-review-fails-without-origin-head) |
216| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Command-line errors](#security-review-fails-without-origin-head) |219| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Command-line errors](#security-review-fails-without-origin-head) |
217| `Input must be provided either through stdin or as a prompt argument when using --print` | [Command-line errors](#input-must-be-provided-when-using-print) |220| `Input must be provided either through stdin or as a prompt argument when using --print` | [Command-line errors](#input-must-be-provided-when-using-print) |
218| `Error: Input contained only whitespace` | [Command-line errors](#input-contained-only-whitespace) |221| `Error: Input contained only whitespace` | [Command-line errors](#input-contained-only-whitespace) |
246| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin errors](#claude-code-refuses-the-marketplace-name) |249| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin errors](#claude-code-refuses-the-marketplace-name) |
247| `Marketplace "<name>" is already added from a different source` | [Plugin errors](#marketplace-is-already-added-from-a-different-source) |250| `Marketplace "<name>" is already added from a different source` | [Plugin errors](#marketplace-is-already-added-from-a-different-source) |
248| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin errors](#marketplace-name-is-another-spelling-of-a-reserved-name) |251| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin errors](#marketplace-name-is-another-spelling-of-a-reserved-name) |
252| `Marketplace "<name>" is added but ignored` | [Plugin troubleshooting](/docs/pt/plugins/troubleshooting#marketplace-is-added-but-ignored) |
253| `Marketplace "<name>" is registered but was refused (see the debug log)` | [Plugin troubleshooting](/docs/pt/plugins/troubleshooting#marketplace-is-added-but-ignored) |
249| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |254| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |
250| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |255| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |
251| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |256| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |
252| `Plugin archive integrity check failed` | [Plugin errors](#plugin-archive-integrity-check-failed) |257| `Plugin archive integrity check failed` | [Plugin errors](#plugin-archive-integrity-check-failed) |
258| `An npm plugin source must name a registry package` | [Plugin troubleshooting](/docs/pt/plugins/troubleshooting#an-npm-plugin-source-must-name-a-registry-package) |
253| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |259| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |
254| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |260| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |
255| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |261| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
486 No response from API492 No response from API
487</h3>493</h3>
488 494
489Claude Code enviou uma solicitação de streaming e a API não retornou cabeçalhos de resposta dentro do prazo para o primeiro byte, então Claude Code abortou a solicitação em vez de aguardar o tempo limite de solicitação completo `API_TIMEOUT_MS`, 10 minutos por padrão. Claude Code envia a solicitação novamente no máximo uma vez, se o [retry budget](#tune-retry-behavior) permitir. Quando a tentativa novamente fica sem resposta, o turno termina com esta mensagem, que mostra quanto tempo cada tentativa aguardou. Quando você define [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/pt/env-vars), o limite de uma tentativa não se aplica e Claude Code tenta novamente sob o orçamento descrito em [Tune retry behavior](#tune-retry-behavior).495Claude Code enviou uma solicitação de streaming e a API não retornou cabeçalhos de resposta dentro do prazo para o primeiro byte, então Claude Code abortou a solicitação em vez de aguardar o tempo limite de solicitação completo `API_TIMEOUT_MS`, 10 minutos por padrão. Claude Code envia a solicitação novamente no máximo uma vez, se o [retry budget](#tune-retry-behavior) permitir. Quando a nova tentativa também fica sem resposta, o turno termina com esta mensagem, que mostra quanto tempo cada tentativa aguardou. Quando você define [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/pt/env-vars), o limite de uma tentativa não se aplica e Claude Code tenta novamente sob o orçamento descrito em [Tune retry behavior](#tune-retry-behavior).
490 496
491```text theme={null}497```text theme={null}
492API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.498API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.
493```499```
494 500
495Claude Code define o tempo de espera para cabeçalhos de resposta da primeira tentativa e a espera da tentativa novamente separadamente:501Claude Code define o tempo de espera para cabeçalhos de resposta da primeira tentativa e a espera da nova tentativa separadamente:
496 502
497* **Primeira tentativa**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/pt/env-vars) quando você o define como 1 ou mais, limitado entre 10 segundos e 30 minutos. Caso contrário, Claude Code usa o tempo limite do watchdog de nível de byte listado em [Streaming idle watchdogs](/docs/pt/network-config#streaming-idle-watchdogs), então as variáveis que alteram esse tempo limite alteram essa espera também. De qualquer forma, Claude Code adiciona um segundo para cada 32KB do corpo da solicitação.503* **Primeira tentativa**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/pt/env-vars) quando você o define como 1 ou mais, limitado entre 10 segundos e 30 minutos. Caso contrário, Claude Code usa o tempo limite do watchdog de nível de byte listado em [Streaming idle watchdogs](/docs/pt/network-config#streaming-idle-watchdogs), então as variáveis que alteram esse tempo limite alteram essa espera também. De qualquer forma, Claude Code adiciona um segundo para cada 32KB do corpo da solicitação.
498* **Tentativa novamente**: um segundo a menos que `API_TIMEOUT_MS`, pouco menos de 10 minutos por padrão, para que a tentativa novamente possa durar mais que um proxy ou gateway que mantém a resposta até que a geração seja concluída. No Amazon Bedrock, a tentativa novamente usa o mesmo prazo que a primeira tentativa, e a mensagem mostra uma duração em vez de duas.504* **Nova tentativa**: um segundo a menos que `API_TIMEOUT_MS`, pouco menos de 10 minutos por padrão, para que a nova tentativa possa durar mais que um proxy ou gateway que mantém a resposta até que a geração seja concluída. No Amazon Bedrock, a nova tentativa usa o mesmo prazo que a primeira tentativa, e a mensagem mostra uma duração em vez de duas.
499 505
500Nenhuma espera excede um segundo a menos que um `API_TIMEOUT_MS` positivo, e um `API_TIMEOUT_MS` positivo inferior a 11 segundos desativa o prazo. O watchdog de nível de byte começa apenas depois que os cabeçalhos de resposta chegam, então uma resposta que para de enviar bytes depois disso segue as [regras de fluxo interrompido](#automatic-retries) em vez deste prazo.506Nenhuma espera excede um segundo a menos que um `API_TIMEOUT_MS` positivo, e um `API_TIMEOUT_MS` positivo inferior a 11 segundos desativa o prazo. O watchdog de nível de byte começa apenas depois que os cabeçalhos de resposta chegam, então uma resposta que para de enviar bytes depois disso segue as [regras de fluxo interrompido](#automatic-retries) em vez deste prazo.
501 507
503 509
504* Envie sua mensagem novamente. Sua mensagem original ainda está na conversa, então para um prompt longo você pode digitar `try again` em vez de colar tudo novamente.510* Envie sua mensagem novamente. Sua mensagem original ainda está na conversa, então para um prompt longo você pode digitar `try again` em vez de colar tudo novamente.
505* Se se repetir, trate como um [problema de rede ou proxy](#unable-to-connect-to-api).511* Se se repetir, trate como um [problema de rede ou proxy](#unable-to-connect-to-api).
506* Se um proxy ou gateway em sua rede mantém respostas até que sejam concluídas, aumente `API_TIMEOUT_MS` para que a tentativa novamente aguarde mais. No Amazon Bedrock, aumente `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` também.512* Se um proxy ou gateway em sua rede mantém respostas até que sejam concluídas, aumente `API_TIMEOUT_MS` para que a nova tentativa aguarde mais. No Amazon Bedrock, aumente `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` também.
507* Se a primeira tentativa continuar expirando e a tentativa novamente tiver sucesso, aumente `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` para que a primeira tentativa também aguarde o tempo suficiente.513* Se a primeira tentativa continuar expirando e a nova tentativa tiver sucesso, aumente `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` para que a primeira tentativa também aguarde o tempo suficiente.
508 514
509Antes da v2.1.242, Claude Code aguardava o tempo limite de solicitação completo `API_TIMEOUT_MS`, 10 minutos por padrão, antes de falhar em uma solicitação de streaming sem resposta. Antes da v2.1.261, a tentativa novamente aguardava o mesmo prazo que a primeira tentativa e a mensagem não mostrava durações.515Antes da v2.1.242, Claude Code aguardava o tempo limite de solicitação completo `API_TIMEOUT_MS`, 10 minutos por padrão, antes de falhar em uma solicitação de streaming sem resposta. Antes da v2.1.261, a nova tentativa aguardava o mesmo prazo que a primeira tentativa e a mensagem não mostrava durações.
510 516
511<h3 id="the-response-above-may-be-incomplete">517<h3 id="the-response-above-may-be-incomplete">
512 The response above may be incomplete518 The response above may be incomplete
541 547
542* Anteriormente na resposta, Claude Code ou tenta novamente a falha ou termina o turno com um erro diferente. Veja [Automatic retries](#automatic-retries).548* Anteriormente na resposta, Claude Code ou tenta novamente a falha ou termina o turno com um erro diferente. Veja [Automatic retries](#automatic-retries).
543* Quando uma dessas falhas chega depois que Claude terminou a resposta, Claude Code mantém a resposta completa e termina o turno normalmente, sem este aviso. Antes da v2.1.222, Claude Code mostrava este aviso quando a conexão era interrompida ou travava após a resposta terminar, e relatava o turno como um erro mesmo que a resposta fosse completa.549* Quando uma dessas falhas chega depois que Claude terminou a resposta, Claude Code mantém a resposta completa e termina o turno normalmente, sem este aviso. Antes da v2.1.222, Claude Code mostrava este aviso quando a conexão era interrompida ou travava após a resposta terminar, e relatava o turno como um erro mesmo que a resposta fosse completa.
544* Em uma [sessão não interativa](/docs/pt/headless), como uma execução `-p`, uma execução do [Agent SDK](/docs/pt/agent-sdk/overview) ou uma [sessão em nuvem](/docs/pt/claude-code-on-the-web), você não precisa enviar `continue` você mesmo quando a resposta cortada está na conversa principal e contém texto mas nenhuma chamada de ferramenta: Claude Code mantém a saída parcial e solicita a Claude continuar de onde parou, até três vezes seguidas. Você vê este aviso para tal resposta apenas uma vez que Claude Code tenha usado essas continuações. Antes da v2.1.246, Claude Code terminava um turno não interativo com este aviso na primeira interrupção.550* Em uma [sessão não interativa](/docs/pt/headless), como uma execução `-p`, uma execução do [Agent SDK](/docs/pt/agent-sdk/overview) ou uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), você não precisa enviar `continue` você mesmo quando a resposta cortada está na conversa principal e contém texto mas nenhuma chamada de ferramenta: Claude Code mantém a saída parcial e solicita a Claude continuar de onde parou, até três vezes seguidas. Você vê este aviso para tal resposta apenas uma vez que Claude Code tenha usado essas continuações. Antes da v2.1.246, Claude Code terminava um turno não interativo com este aviso na primeira interrupção.
545* Em um [subagent](/docs/pt/sub-agents#api-errors-in-subagents), seja a sessão interativa ou não: quando sua resposta cortada contém texto mas nenhuma chamada de ferramenta, Claude Code solicita ao subagent continuar. O aviso se torna a última mensagem do subagent apenas uma vez que essas continuações sejam usadas. Antes da v2.1.257, um subagent mostrava este aviso na primeira interrupção.551* Em um [subagent](/docs/pt/sub-agents#api-errors-in-subagents), seja a sessão interativa ou não: quando sua resposta cortada contém texto mas nenhuma chamada de ferramenta, Claude Code solicita ao subagent continuar. O aviso se torna a última mensagem do subagent apenas uma vez que essas continuações sejam usadas. Antes da v2.1.257, um subagent mostrava este aviso na primeira interrupção.
546 552
547**O que fazer:**553**O que fazer:**
636The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.642The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.
637```643```
638 644
639O resto da mensagem diz a Claude se uma tentativa pode ajudar. Antes de algumas dessas negações, Claude Code aguarda para que a próxima tentativa de Claude não siga imediatamente. Durante a espera em uma sessão interativa, o spinner mostra `Auto mode check unavailable` com uma contagem regressiva, e pressionar `Esc` interrompe o turno.645O resto da mensagem diz a Claude se uma nova tentativa pode ajudar. Antes de algumas dessas negações, Claude Code aguarda para que a próxima tentativa de Claude não siga imediatamente. Durante a espera em uma sessão interativa, o spinner mostra `Auto mode check unavailable` com uma contagem regressiva, e pressionar `Esc` interrompe o turno.
640 646
641Após dez respostas seguidas sem veredicto, auto mode interrompe o turno:647Após dez respostas seguidas sem veredicto, auto mode interrompe o turno:
642 648
663 Agent terminated early due to an API error669 Agent terminated early due to an API error
664</h3>670</h3>
665 671
666A 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 a Claude como se fosse o resultado do subagent.672A solicitação de API de um [subagent](/docs/pt/sub-agents) falhou terminalmente, por exemplo porque um limite de uso foi atingido ou as novas 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 a Claude como se fosse o resultado do subagent.
667 673
668```text theme={null}674```text theme={null}
669Agent terminated early due to an API error: <error detail>675Agent terminated early due to an API error: <error detail>
674* 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ção680* 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
675* Uma vez que o erro subjacente seja resolvido, peça a Claude para tentar novamente a tarefa ou [retomar o subagent](/docs/pt/sub-agents#resume-subagents)681* Uma vez que o erro subjacente seja resolvido, peça a Claude para tentar novamente a tarefa ou [retomar o subagent](/docs/pt/sub-agents#resume-subagents)
676 682
677Quando uma taxa limite, 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 essa forma retornava um resultado parcial vazio. Veja [API errors in subagents](/docs/pt/sub-agents#api-errors-in-subagents).683Quando um rate limit, 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 essa forma retornava um resultado parcial vazio. Veja [API errors in subagents](/docs/pt/sub-agents#api-errors-in-subagents).
678 684
679<h2 id="usage-limits">685<h2 id="usage-limits">
680 Limites de uso686 Limites de uso
885 Erros de autenticação891 Erros de autenticação
886</h2>892</h2>
887 893
888Esses erros significam que Claude Code não consegue provar sua identidade para a API. Execute `/status` a qualquer momento para ver qual credencial está ativa no momento.894Esses erros significam que o Claude Code não consegue provar à API quem você é. Execute `/status` a qualquer momento para ver qual credencial está ativa no momento.
889 895
890<h3 id="not-logged-in">896<h3 id="not-logged-in">
891 Não conectado897 Não conectado
897Not logged in · Please run /login903Not logged in · Please run /login
898```904```
899 905
900Em uma sessão que o aplicativo Claude Desktop executa, como a aba Code ou Cowork, a mensagem lê `Authentication required · Sign in again to continue`, e você se conecta novamente a partir do aplicativo.906Em uma sessão executada pelo aplicativo Claude Desktop, como a aba Code ou o Cowork, a mensagem diz `Authentication required · Sign in again to continue`, e você entra novamente pelo aplicativo.
907
908Se você entrar com sua conta claude.ai em outra janela do Claude Code que usa o mesmo [diretório de configuração](/docs/pt/claude-directory), uma sessão interativa que mostra esta mensagem passa a usar esse login por conta própria. Você não precisa reiniciá-la.
909
910Antes da v2.1.286 no macOS, a sessão podia continuar mostrando a mensagem depois que você entrava por outra janela. Nessas versões, reinicie a sessão que mostra a mensagem.
901 911
902**O que fazer:**912**O que fazer:**
903 913
904* Execute `/login` para se autenticar com sua assinatura Claude ou conta Console914* Execute `/login` para se autenticar com sua assinatura Claude ou conta do Console
905* 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`915* Se você esperava que uma variável de ambiente o autenticasse, confirme que `ANTHROPIC_API_KEY` está definida e exportada no shell onde você iniciou o `claude`
906* Para CI ou automação onde o login interativo não é possível, configure um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) que busque uma chave na inicialização916* Para CI ou automação em que o login interativo não é possível, configure um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) que busque uma chave na inicialização
907* Veja [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) para entender qual credencial Claude Code usa quando várias estão presentes917* Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) para entender qual credencial o Claude Code usa quando várias estão presentes
908 918
909Se você for solicitado a fazer login repetidamente, veja [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para verificações de relógio do sistema e etapas de recuperação de armazenamento de credenciais do macOS.919Se for solicitado que você faça login repetidamente, consulte [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para verificações do relógio do sistema e etapas de recuperação do armazenamento de credenciais do macOS.
910 920
911<h3 id="could-not-resolve-authentication-method">921<h3 id="could-not-resolve-authentication-method">
912 Não foi possível resolver o método de autenticação922 Não foi possível resolver o método de autenticação
913</h3>923</h3>
914 924
915A sessão chegou ao cliente da API sem nenhuma credencial. [Sessões em segundo plano](/docs/pt/agent-view) e sessões em nuvem mostram essa mensagem quando o worker inicia sem uma credencial. Execuções interativas, `-p` e Agent SDK relatam a mesma condição que [Não conectado](#not-logged-in) e escrevem essa string apenas no log de depuração, portanto, se você a encontrou lá, siga essa entrada.925A sessão chegou ao cliente da API sem nenhuma credencial. [Sessões em segundo plano](/docs/pt/agent-view) e sessões na nuvem mostram esta mensagem quando o worker é iniciado sem uma credencial. Execuções interativas, com `-p` e do Agent SDK relatam a mesma condição como [Não conectado](#not-logged-in) e gravam esta string apenas no seu log de depuração, portanto, se você a encontrou lá, siga aquela entrada.
916 926
917```text theme={null}927```text theme={null}
918Could 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 omitted928Could 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
919```929```
920 930
921Nas versões atuais, o erro significa que nenhuma credencial estava disponível para o processo worker. Antes da v2.1.174, uma sessão em segundo plano atribuída a um worker pré-inicializado ocioso poderia falhar dessa forma mesmo quando credenciais válidas foram configuradas. Antes da v2.1.176, uma sessão em nuvem que ficou ociosa antes de ser reivindicada também poderia. Atualize para recuperar.931Nas versões atuais, o erro significa que nenhuma credencial estava disponível para o processo do worker. Antes da v2.1.174, uma sessão em segundo plano atribuída a um worker pré-inicializado ocioso podia falhar dessa forma mesmo quando credenciais válidas estavam configuradas. Antes da v2.1.176, uma sessão na nuvem que ficava ociosa antes de ser reivindicada também podia. Atualize para se recuperar.
922 932
923**O que fazer:**933**O que fazer:**
924 934
925* Atualize para v2.1.176 ou posterior se isso aparecer em uma sessão em segundo plano ou nuvem e suas credenciais já estiverem configuradas935* Atualize para a v2.1.176 ou posterior se isso aparecer em uma sessão em segundo plano ou na nuvem e suas credenciais já estiverem configuradas
926* 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 interativo936* Confirme que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou as credenciais do seu provedor de nuvem estão definidas no ambiente que inicia o worker, e não apenas no seu shell interativo
927* Para o Agent SDK, veja [configuração de autenticação no guia de início rápido](/docs/pt/agent-sdk/quickstart#setup)937* Para o Agent SDK, consulte [configuração de autenticação no início rápido](/docs/pt/agent-sdk/quickstart#setup)
928* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida938* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida
929 939
930<h3 id="invalid-api-key">940<h3 id="invalid-api-key">
931 Chave de API inválida941 Chave de API inválida
932</h3>942</h3>
933 943
934A variável de ambiente `ANTHROPIC_API_KEY` ou o script `apiKeyHelper` retornou uma chave que a API rejeitou, ou Claude Code bloqueou uma chave de `ANTHROPIC_API_KEY` antes de enviá-la.944A variável de ambiente `ANTHROPIC_API_KEY` ou o script `apiKeyHelper` retornou uma chave que a API rejeitou, ou o Claude Code bloqueou uma chave de `ANTHROPIC_API_KEY` antes de enviá-la.
935 945
936```text theme={null}946```text theme={null}
937Invalid API key · Fix external API key947Invalid API key · Fix external API key
938```948```
939 949
940Quando a mensagem continua após `Fix external API key` com uma descrição como `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, a API nunca viu a chave. Claude Code encontrou um caractere que os cabeçalhos HTTP não conseguem carregar e parou a solicitação antes de enviá-la. Veja [Valor de cabeçalho de solicitação inválido](#invalid-request-header-value) para saber como ler a descrição e corrigir o valor.950Quando a mensagem continua após `Fix external API key` com uma descrição como `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, a API nunca viu a chave. O Claude Code encontrou um caractere que cabeçalhos HTTP não podem transportar e interrompeu a requisição antes de enviá-la. Consulte [Valor de cabeçalho de requisição inválido](#invalid-request-header-value) para saber como ler a descrição e corrigir o valor.
941 951
942**O que fazer:**952**O que fazer:**
943 953
944* Verifique se há erros de digitação e confirme que a chave não foi revogada no [Console](https://platform.claude.com/settings/keys)954* Verifique erros de digitação e confirme que a chave não foi revogada no [Console](https://platform.claude.com/settings/keys)
945* No mesmo shell, execute `env | grep ANTHROPIC`, ou no PowerShell `Get-ChildItem Env:ANTHROPIC*`. 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.955* No mesmo shell, execute `env | grep ANTHROPIC` ou, no PowerShell, `Get-ChildItem Env:ANTHROPIC*`. Ferramentas como direnv, plugins de shell dotenv e terminais de IDE podem carregar uma chave desatualizada de um arquivo `.env` no seu projeto sem que você a defina explicitamente.
946* Desdefina `ANTHROPIC_API_KEY` e execute `/login` para usar autenticação de assinatura956* Remova a definição de `ANTHROPIC_API_KEY` e execute `/login` para usar a autenticação por assinatura
947* Se a chave vem de um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper), execute o script diretamente para confirmar que ele imprime uma chave válida em stdout957* Se a chave vier de um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper), execute o script diretamente para confirmar que ele imprime uma chave válida no stdout
948* Execute `/status` para confirmar qual fonte de credencial Claude Code está realmente usando958* Execute `/status` para confirmar qual fonte de credencial o Claude Code está realmente usando
949 959
950<h3 id="your-apikeyhelper-script-is-failing">960<h3 id="your-apikeyhelper-script-is-failing">
951 Seu script apiKeyHelper está falhando961 Seu script apiKeyHelper está falhando
952</h3>962</h3>
953 963
954Claude Code executou o comando em sua configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) e não obteve uma chave de volta. Sem uma, a solicitação chega à API com uma credencial de espaço reservado, e a API a rejeita com `401`. O painel `Authentication` no terminal mostra qual desses aconteceu:964O Claude Code executou o comando da sua configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) e não recebeu uma chave de volta. Sem ela, a requisição chega à API com uma credencial provisória, e a API a rejeita com `401`. O painel `Authentication` no terminal mostra qual destas situações aconteceu:
955 965
956* O comando saiu com um erro ou expirou966* O comando terminou com um erro ou atingiu o timeout
957* O comando não imprimiu nada em stdout967* O comando não imprimiu nada no stdout
958* O comando imprimiu algo além da chave, como um banner de login ou uma linha de log. O painel mostra `returned output that cannot be used as an API key` e diz o que está errado, sem repetir a saída. Antes da v2.1.227, Claude Code enviava o que o comando imprimia, após aparar espaços em branco ao redor.968* O comando imprimiu algo além da chave, como um banner de login ou uma linha de log. O painel mostra `returned output that cannot be used as an API key` e diz o que está errado, sem repetir a saída. Antes da v2.1.227, o Claude Code enviava o que quer que o comando imprimisse, após remover os espaços em branco ao redor.
959 969
960```text theme={null}970```text theme={null}
961Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output971Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
962```972```
963 973
964Em [modo não interativo](/docs/pt/headless), stderr também carrega o motivo específico, prefixado com `apiKeyHelper failed:`.974No [modo não interativo](/docs/pt/headless), o stderr também traz o motivo específico, prefixado com `apiKeyHelper failed:`.
965 975
966Claude Code executa novamente o script e tenta a solicitação até mais duas vezes antes de mostrar essa 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 genérico `401` em vez da falha do script.976O Claude Code executa o script novamente e tenta a requisição novamente até mais duas vezes antes de mostrar esta mensagem, portanto a falha aparece em até três tentativas. Antes da v2.1.208, o Claude Code gastava todo o [orçamento de novas tentativas](#automatic-retries) reenviando a requisição com a credencial provisória e depois relatava um erro genérico de autenticação `401` em vez da falha do script.
967 977
968Executar `/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.978Executar `/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.
969 979
970**O que fazer:**980**O que fazer:**
971 981
972* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha982* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha
973* Se o comando relatar uma sessão expirada, reautentique-se com seu provedor de credenciais, por exemplo, conectando-se novamente ao seu SSO ou cofre de segredos983* Se o comando relatar uma sessão expirada, autentique-se novamente com seu provedor de credenciais, por exemplo entrando novamente no seu SSO ou cofre de segredos
974* Corrija o comando para que ele imprima apenas a chave em stdout, como um único token de ASCII imprimível até 16.384 caracteres, e saia com código 0. Veja [girar credenciais com apiKeyHelper](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para uma configuração funcional.984* Corrija o comando para que ele imprima apenas a chave no stdout, como um único token de ASCII imprimível de até 16.384 caracteres, e termine com código de saída 0. Consulte [rotacionar credenciais com apiKeyHelper](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para uma configuração funcional.
975* Execute `/status` para ver a falha e confirmar que `apiKeyHelper` é a fonte de credencial ativa. A linha `apiKeyHelper` mostra `Failing` com o detalhe da última falha, como o código de saída e a saída de erro do comando, e desaparece após a próxima execução bem-sucedida. Antes da v2.1.274, `/status` mostrava apenas a fonte de credencial, não a falha.985* Execute `/status` para ver a falha e confirmar que `apiKeyHelper` é a fonte de credencial ativa. A linha `apiKeyHelper` mostra `Failing` com o detalhe da última falha, como o código de saída e a saída de erro do comando, e desaparece após a próxima execução bem-sucedida. Antes da v2.1.274, `/status` mostrava apenas a fonte de credencial, não a falha.
976* Cada vez que o comando falha, seu código de saída e saída de erro também aparecem em um painel `Authentication` no terminal. Antes da v2.1.212, o painel era intitulado `Cloud authentication`.986* Cada vez que o comando falha, seu código de saída e sua saída de erro também aparecem em um painel `Authentication` no terminal. Antes da v2.1.212, o painel se chamava `Cloud authentication`.
977 987
978<h3 id="invalid-request-header-value">988<h3 id="invalid-request-header-value">
979 Valor de cabeçalho de solicitação inválido989 Valor de cabeçalho de requisição inválido
980</h3>990</h3>
981 991
982Um valor que Claude Code estava prestes a enviar como cabeçalho de solicitação contém um caractere que os cabeçalhos HTTP não conseguem carregar: uma quebra de linha, um byte NUL ou um caractere acima de `U+00FF`, como uma aspas curva ou um espaço de largura zero. Claude Code para a solicitação antes de qualquer coisa ser enviada e nomeia a variável ou configuração a ser corrigida. A causa usual é uma credencial colada de um documento ou chat que carregava um caractere invisível ou uma quebra de linha perdida.992Um valor que o Claude Code estava prestes a enviar como cabeçalho de requisição contém um caractere que cabeçalhos HTTP não podem transportar: uma quebra de linha, um byte NUL ou um caractere acima de `U+00FF`, como uma aspa curva ou um espaço de largura zero. O Claude Code interrompe a requisição antes que qualquer coisa seja enviada e nomeia a variável ou configuração a corrigir. A causa usual é uma credencial colada de um documento ou chat que trazia um caractere invisível ou uma quebra de linha perdida.
983 993
984Claude Code executa essa verificação quando envia solicitações para a API Claude diretamente ou através de um [gateway LLM](/docs/pt/llm-gateway). Em um provedor de nuvem de terceiros como [Amazon Bedrock](/docs/pt/amazon-bedrock), Claude Code não a executa antes de enviar.994O Claude Code executa essa verificação quando envia requisições para a Claude API diretamente ou por meio de um [gateway de LLM](/docs/pt/llm-gateway). Em um provedor de nuvem de terceiros, como o [Amazon Bedrock](/docs/pt/amazon-bedrock), o Claude Code não a executa antes de enviar.
985 995
986```text theme={null}996```text theme={null}
987Invalid auth token · Fix external auth token997Invalid auth token · Fix external auth token
989Invalid request header from the environment · Fix the environment variable999Invalid request header from the environment · Fix the environment variable
990```1000```
991 1001
992A primeira parte da mensagem depende de onde o valor ruim veio:1002A primeira parte da mensagem depende de onde veio o valor incorreto:
993 1003
994* `Invalid auth token`: um token de portador de [`ANTHROPIC_AUTH_TOKEN`](/docs/pt/env-vars) ou [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars)1004* `Invalid auth token`: um token bearer de [`ANTHROPIC_AUTH_TOKEN`](/docs/pt/env-vars) ou [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars)
995* `Invalid ANTHROPIC_CUSTOM_HEADERS`: um nome ou valor de cabeçalho que você definiu em [`ANTHROPIC_CUSTOM_HEADERS`](/docs/pt/env-vars). A descrição conta qual par `Name: Value` é culpado, como `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, sem repetir o nome ou valor, já que você escolheu ambos.1005* `Invalid ANTHROPIC_CUSTOM_HEADERS`: um nome ou valor de cabeçalho que você definiu em [`ANTHROPIC_CUSTOM_HEADERS`](/docs/pt/env-vars). A descrição indica qual par `Name: Value` está com problema, como `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, sem repetir o nome ou o valor, já que você escolheu ambos.
996* `Invalid request header from the environment`: um valor que Claude Code copia em um cabeçalho de solicitação de outra variável de ambiente, como `CLAUDE_AGENT_SDK_CLIENT_APP`. A descrição nomeia a variável a ser corrigida.1006* `Invalid request header from the environment`: um valor que o Claude Code copia para um cabeçalho de requisição a partir de outra variável de ambiente, como `CLAUDE_AGENT_SDK_CLIENT_APP`. A descrição nomeia a variável a corrigir.
997 1007
998Claude Code relata um `ANTHROPIC_API_KEY` ruim capturado por essa verificação como [Chave de API inválida](#invalid-api-key), com a mesma descrição final. Ele relata uma credencial `/login` salva ruim como [Não conectado](#not-logged-in) em vez disso; execute `/login` para salvar uma nova. A saída de um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) nunca chega a essa verificação: Claude Code a valida quando o script é executado, e a saída que um cabeçalho HTTP não consegue carregar falha com [Seu script apiKeyHelper está falhando](#your-apikeyhelper-script-is-failing).1008O Claude Code relata uma `ANTHROPIC_API_KEY` incorreta detectada por essa verificação como [Chave de API inválida](#invalid-api-key), com a mesma descrição ao final. Ele relata uma credencial `/login` salva incorreta como [Não conectado](#not-logged-in); execute `/login` para salvar uma nova. A saída de um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) nunca chega a essa verificação: o Claude Code a valida quando o script é executado, e uma saída que um cabeçalho HTTP não pode transportar falha com [Seu script apiKeyHelper está falhando](#your-apikeyhelper-script-is-failing).
999 1009
1000Após o segundo `·`, a mensagem descreve o problema, como neste exemplo completo:1010Após o segundo `·`, a mensagem descreve o problema, como neste exemplo completo:
1001 1011
1003Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).1013Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).
1004```1014```
1005 1015
1006As posições contam caracteres começando em um. A descrição é construída a partir de frases fixas e contagens de caracteres, portanto, nunca inclui o valor em si. Ela nomeia o caractere ofensivo apenas quando é um caractere invisível ou tipográfico bem conhecido, como uma marca de ordem de byte, um espaço de largura zero ou uma aspas curva, e relata qualquer outra coisa como `a non-ASCII character`.1016As posições contam caracteres a partir de um. A descrição é construída a partir de frases fixas e contagens de caracteres, então nunca inclui o próprio valor. Ela nomeia o caractere problemático apenas quando é um caractere invisível ou tipográfico conhecido, como uma marca de ordem de bytes, um espaço de largura zero ou uma aspa curva, e relata qualquer outro como `a non-ASCII character`.
1007 1017
1008**O que fazer:**1018**O que fazer:**
1009 1019
1010* Redefina a variável ou configuração que a mensagem nomeia, digitando novamente os caracteres ao redor da posição relatada em vez de colar da mesma fonte novamente1020* Redefina a variável ou configuração que a mensagem nomeia, digitando novamente os caracteres ao redor da posição relatada em vez de colar da mesma fonte outra vez
1011* Para `ANTHROPIC_CUSTOM_HEADERS`, mantenha um par `Name: Value` por linha e reescreva o par que a mensagem conta1021* Para `ANTHROPIC_CUSTOM_HEADERS`, mantenha um par `Name: Value` por linha e reescreva o par que a mensagem indica
1012* Execute `/status` para confirmar qual fonte de credencial está ativa1022* Execute `/status` para confirmar qual fonte de credencial está ativa
1013 1023
1014<h3 id="this-organization-has-been-disabled">1024<h3 id="this-organization-has-been-disabled">
1015 Esta organização foi desabilitada1025 Esta organização foi desativada
1016</h3>1026</h3>
1017 1027
1018Claude Code está usando um `ANTHROPIC_API_KEY` obsoleto de uma organização Console desabilitada. Quando você tem um login de assinatura salvo, a chave o substitui.1028O Claude Code está usando uma `ANTHROPIC_API_KEY` desatualizada de uma organização do Console desativada. Quando você tem um login de assinatura salvo, a chave o sobrescreve.
1019 1029
1020```text theme={null}1030```text theme={null}
1021Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead1031Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
1023API Error: 400 ... This organization has been disabled.1033API Error: 400 ... This organization has been disabled.
1024```1034```
1025 1035
1026A dica após o `·` depende de suas credenciais salvas: a primeira forma aparece quando um `/login` armazenado pode assumir depois que você desdefine a chave, e a segunda quando a chave é sua única credencial.1036A dica após o `·` depende das suas credenciais salvas: a primeira forma aparece quando um `/login` armazenado pode assumir depois que você remove a definição da chave, e a segunda quando a chave é sua única credencial.
1027 1037
1028As variáveis de ambiente têm precedência sobre `/login`, portanto, uma chave exportada no seu perfil de shell ou carregada de um arquivo `.env` é usada mesmo quando você tem uma assinatura Pro ou Max funcionando. Em modo não interativo (`-p`), a chave é sempre usada quando presente.1038Variáveis de ambiente têm precedência sobre `/login`, então uma chave exportada no perfil do seu shell ou carregada de um arquivo `.env` é usada mesmo quando você tem uma assinatura Pro ou Max funcionando. No modo não interativo (`-p`), a chave é sempre usada quando presente.
1029 1039
1030**O que fazer:**1040**O que fazer:**
1031 1041
1032* Desdefina `ANTHROPIC_API_KEY` no shell atual e remova-a do seu perfil de shell, depois reinicie `claude`1042* Remova a definição de `ANTHROPIC_API_KEY` no shell atual e remova-a do perfil do seu shell, depois reinicie o `claude`
1033* Se a mensagem disser `Update or unset`, você não tem um login salvo para recorrer. Desdefina a chave e execute `/login`, ou substitua a chave por uma de uma organização Console ativa.1043* Se a mensagem disser `Update or unset`, você não tem um login salvo para usar como alternativa. Remova a definição da chave e execute `/login`, ou substitua a chave por uma de uma organização do Console ativa.
1034* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura1044* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura
1035* Se nenhuma variável de ambiente estiver definida e o erro persistir, entre em contato com o suporte ou conecte-se com uma conta diferente.1045* Se nenhuma variável de ambiente estiver definida e o erro persistir, entre em contato com o suporte ou entre com uma conta diferente.
1036 1046
1037<h3 id="your-organization-has-disabled-api-key-authentication">1047<h3 id="your-organization-has-disabled-api-key-authentication">
1038 Sua organização desabilitou a autenticação por chave de API1048 Sua organização desativou a autenticação por chave de API
1039</h3>1049</h3>
1040 1050
1041Esta mensagem requer Claude Code v2.1.169 ou posterior. O administrador da organização Console desabilitou a autenticação por chave de API, portanto, a API rejeita a chave que Claude Code está enviando. A dica de recuperação após o `·` varia de acordo com onde a chave veio:1051Esta mensagem requer o Claude Code v2.1.169 ou posterior. O administrador da sua organização do Console desativou a autenticação por chave de API, então a API rejeita a chave que o Claude Code está enviando. A dica de recuperação após o `·` varia de acordo com a origem da chave:
1042 1052
1043```text theme={null}1053```text theme={null}
1044Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account1054Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
1048Your organization has disabled API key authentication · Sign in again with your claude.ai account1058Your organization has disabled API key authentication · Sign in again with your claude.ai account
1049```1059```
1050 1060
1051A última forma aparece em uma sessão que o aplicativo Claude Desktop executa, como a aba Code ou Cowork, onde você se conecta novamente a partir do aplicativo.1061A última forma aparece em uma sessão executada pelo aplicativo Claude Desktop, como a aba Code ou o Cowork, onde você entra novamente pelo aplicativo.
1052 1062
1053As variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, portanto, executar `/login` sozinho não ajuda enquanto qualquer um ainda estiver fornecendo uma chave. Veja [Precedência de autenticação](/docs/pt/authentication#authentication-precedence).1063Variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, então executar apenas `/login` não ajuda enquanto qualquer um deles ainda estiver fornecendo uma chave. Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence).
1054 1064
1055**O que fazer:**1065**O que fazer:**
1056 1066
1057* Se a mensagem nomear `ANTHROPIC_API_KEY`, desdefina-a no shell atual e remova-a do seu perfil de shell ou arquivo `.env`, depois reinicie `claude`1067* Se a mensagem nomear `ANTHROPIC_API_KEY`, remova sua definição no shell atual e remova-a do perfil do seu shell ou do arquivo `.env`, depois reinicie o `claude`
1058* Se a mensagem nomear `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) do seu `settings.json`1068* Se a mensagem nomear `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) do seu `settings.json`
1059* Execute `/login` para se conectar com sua conta claude.ai1069* Execute `/login` para entrar com sua conta claude.ai
1060* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API1070* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API
1061* 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 Console1071* Se você precisar de autenticação por chave de API para automação, peça ao administrador da sua organização que a reative no Console
1062 1072
1063<h3 id="your-organization-has-disabled-claude-subscription-access">1073<h3 id="your-organization-has-disabled-claude-subscription-access">
1064 Sua organização desabilitou o acesso à assinatura Claude1074 Sua organização desativou o acesso por assinatura Claude
1065</h3>1075</h3>
1066 1076
1067Sua organização Claude não permite conectar-se ao Claude Code com um login de assinatura. Executar `/login` novamente com a mesma conta retorna o mesmo erro.1077Sua organização Claude não permite entrar no Claude Code com um login de assinatura. Executar `/login` novamente com a mesma conta retorna o mesmo erro.
1068 1078
1069```text theme={null}1079```text theme={null}
1070Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access1080Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
1071```1081```
1072 1082
1073Esta é uma configuração de organização do lado do servidor, portanto, não pode ser substituída por configurações locais, variáveis de ambiente ou sinalizadores CLI.1083Esta é uma configuração de organização do lado do servidor, então não pode ser sobrescrita por configurações locais, variáveis de ambiente ou flags da CLI.
1074 1084
1075O Agent SDK e o modo não interativo `-p` apresentam isso como o código de erro `oauth_org_not_allowed`.1085O Agent SDK e o modo não interativo `-p` expõem isso como o código de erro `oauth_org_not_allowed`.
1076 1086
1077**O que fazer:**1087**O que fazer:**
1078 1088
1079* Peça ao seu administrador para habilitar o acesso ao Claude Code para sua organização1089* Peça ao seu administrador que habilite o acesso ao Claude Code para sua organização
1080* Autentique-se com uma chave de API Console em vez de sua assinatura. Veja [Autenticação do Claude Console](/docs/pt/authentication#claude-console-authentication) para configuração.1090* Autentique-se com uma chave de API do Console em vez da sua assinatura. Consulte [Autenticação do Claude Console](/docs/pt/authentication#claude-console-authentication) para a configuração.
1081* Se você é o administrador e não vê uma opção para habilitar o acesso, entre em contato com [suporte da Anthropic](https://support.claude.com)1091* Se você é o administrador e não vê uma opção para habilitar o acesso, entre em contato com o [suporte da Anthropic](https://support.claude.com)
1082 1092
1083<h3 id="routines-are-disabled-by-your-organizations-policy">1093<h3 id="routines-are-disabled-by-your-organizations-policy">
1084 Rotinas são desabilitadas pela política da sua organização1094 As rotinas estão desativadas pela política da sua organização
1085</h3>1095</h3>
1086 1096
1087Um 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, por exemplo, a partir da interface [Rotinas](/docs/pt/routines) em claude.ai/code. No Claude Code v2.1.227 ou posterior, a mesma configuração também [oculta `/schedule`](/docs/pt/routines#troubleshooting) no CLI.1097Um Owner da sua organização Team ou Enterprise desativou as rotinas no nível da organização. O erro aparece quando você tenta criar ou executar uma rotina, por exemplo pela interface de [Rotinas](/docs/pt/routines) em claude.ai/code. No Claude Code v2.1.227 ou posterior, a mesma configuração também [oculta `/schedule`](/docs/pt/routines#troubleshooting) na CLI.
1088 1098
1089```text theme={null}1099```text theme={null}
1090Routines are disabled by your organization's policy.1100Routines are disabled by your organization's policy.
1091```1101```
1092 1102
1093Esta é uma configuração do lado do servidor, portanto, não pode ser substituída por configurações locais, variáveis de ambiente ou sinalizadores CLI.1103Esta é uma configuração do lado do servidor, então não pode ser sobrescrita por configurações locais, variáveis de ambiente ou flags da CLI.
1094 1104
1095**O que fazer:**1105**O que fazer:**
1096 1106
1097* 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)1107* Peça a um Owner da sua organização que ative a opção **Routines** em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
1098* Para trabalho agendado único que não requer rotinas no nível da organização, veja [tarefas agendadas](/docs/pt/scheduled-tasks)1108* Para trabalhos agendados pontuais que não exigem rotinas no nível da organização, consulte [tarefas agendadas](/docs/pt/scheduled-tasks)
1099 1109
1100<h3 id="remote-control-requires-the-anthropic-api">1110<h3 id="remote-control-requires-the-anthropic-api">
1101 Remote Control requer a API Anthropic1111 O Remote Control requer a Anthropic API
1102</h3>1112</h3>
1103 1113
1104A sessão não está falando com a API Anthropic diretamente, portanto, [Remote Control](/docs/pt/remote-control) requer.1114A sessão não está se comunicando diretamente com a Anthropic API, o que o [Remote Control](/docs/pt/remote-control) requer.
1105 1115
1106```text theme={null}1116```text theme={null}
1107Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.1117Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.
1108```1118```
1109 1119
1110Uma segunda frase explica o que roteirizou a sessão para longe da API Anthropic; antes da v2.1.219, a mensagem era apenas a primeira frase. Dependendo da causa, a mensagem nomeia:1120Uma segunda frase explica o que desviou a sessão da Anthropic API; antes da v2.1.219, a mensagem era apenas a primeira frase. Dependendo da causa, a mensagem nomeia:
1111 1121
1112* Uma variável de provedor `CLAUDE_CODE_USE_*`, como `CLAUDE_CODE_USE_BEDROCK` para [Amazon Bedrock](/docs/pt/amazon-bedrock) ou `CLAUDE_CODE_USE_VERTEX` para [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai)1122* Uma variável de provedor `CLAUDE_CODE_USE_*`, como `CLAUDE_CODE_USE_BEDROCK` para o [Amazon Bedrock](/docs/pt/amazon-bedrock) ou `CLAUDE_CODE_USE_VERTEX` para o [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai)
1113* [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) apontando para um host diferente de `api.anthropic.com`, como um [gateway LLM](/docs/pt/llm-gateway) ou proxy, mesmo quando você se conecta com claude.ai; antes da v2.1.196, uma URL base personalizada não bloqueava Remote Control1123* [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) apontando para um host diferente de `api.anthropic.com`, como um [gateway de LLM](/docs/pt/llm-gateway) ou proxy, mesmo quando você entra com claude.ai; antes da v2.1.196, uma URL base personalizada não bloqueava o Remote Control
1114* `ANTHROPIC_UNIX_SOCKET` definido, portanto, a sessão envia suas solicitações através de um soquete local em vez de para `api.anthropic.com`1124* `ANTHROPIC_UNIX_SOCKET` definida, de modo que a sessão envia suas requisições por um socket local em vez de para `api.anthropic.com`
1115* Um login de [gateway de nuvem](/docs/pt/claude-apps-gateway) corporativo feito através de `/login`, que não suporta Remote Control e não tem variável para desdefini-la1125* Um login de [gateway de nuvem](/docs/pt/claude-apps-gateway) empresarial feito por meio de `/login`, que não oferece suporte ao Remote Control e não tem nenhuma variável para remover
1116 1126
1117**O que fazer:**1127**O que fazer:**
1118 1128
1119* Desdefina a variável que a mensagem nomeia, como `CLAUDE_CODE_USE_BEDROCK` ou `ANTHROPIC_BASE_URL`, e reinicie a sessão, ou inicie Remote Control a partir de uma sessão que fala com a API Anthropic diretamente1129* Remova a definição da variável que a mensagem nomeia, como `CLAUDE_CODE_USE_BEDROCK` ou `ANTHROPIC_BASE_URL`, e reinicie a sessão, ou inicie o Remote Control a partir de uma sessão que se comunica diretamente com a Anthropic API
1120* Se a variável não estiver definida no seu shell, verifique a chave `env` em seus [arquivos de configuração](/docs/pt/settings#where-settings-live), que aplica variáveis de ambiente a cada sessão1130* Se a variável não estiver definida no seu shell, verifique a chave `env` nos seus [arquivos de configuração](/docs/pt/settings#where-settings-live), que aplica variáveis de ambiente a todas as sessões
1121* Para esta e as outras mensagens de inicialização do Remote Control, veja [Solucionar problemas do Remote Control](/docs/pt/remote-control#troubleshooting)1131* Para esta e as outras mensagens de inicialização do Remote Control, consulte [Solução de problemas do Remote Control](/docs/pt/remote-control#troubleshooting)
1122 1132
1123<h3 id="remote-control-couldnt-refresh-your-login">1133<h3 id="remote-control-couldnt-refresh-your-login">
1124 Remote Control não conseguiu atualizar seu login1134 O Remote Control não conseguiu renovar seu login
1125</h3>1135</h3>
1126 1136
1127Claude Code executa uma conexão [Remote Control](/docs/pt/remote-control) ao vivo em credenciais de curta duração que obtém e renova usando seu login claude.ai salvo. Quando claude.ai para de aceitar esse login, ou Claude Code não tem mais nenhum login salvo, Claude Code para Remote Control e precisa que você se conecte novamente. Qualquer falha pode acontecer enquanto Claude Code ainda está se conectando ou depois, quando renova as credenciais.1137O Claude Code mantém uma conexão ativa do [Remote Control](/docs/pt/remote-control) com credenciais de curta duração que ele obtém e renova usando seu login claude.ai salvo. Quando o claude.ai deixa de aceitar esse login, ou o Claude Code não tem mais nenhum login salvo, o Claude Code interrompe o Remote Control e precisa que você entre novamente. Qualquer uma das falhas pode acontecer enquanto o Claude Code ainda está se conectando ou mais tarde, quando ele renova as credenciais.
1128 1138
1129Quando Claude Code pede ao serviço de login para atualizar seu login salvo e não obtém resposta, ele mantém Remote Control em execução e tenta a atualização novamente enquanto a credencial atual da conexão ainda é válida. Uma atualização não obtém resposta quando Claude Code não consegue alcançar o serviço de login, a solicitação expira ou o serviço falha sem rejeitar seu login. Se o serviço de login ainda não estiver respondendo quando essa credencial expirar, Claude Code para Remote Control e relata `OAuth token refresh failed`.1139Quando o Claude Code pede ao serviço de login que renove seu login salvo e não recebe resposta, ele mantém o Remote Control em execução e tenta a renovação novamente enquanto a credencial atual da conexão ainda é válida. Uma renovação fica sem resposta quando o Claude Code não consegue alcançar o serviço de login, a requisição atinge o timeout ou o serviço falha sem rejeitar seu login. Se o serviço de login ainda não estiver respondendo quando essa credencial expirar, o Claude Code interrompe o Remote Control e relata `OAuth token refresh failed`.
1130 1140
1131Quando Claude Code para Remote Control, ele mostra o motivo em um aviso e em uma linha de transcrição que começa com `Remote Control disconnected`. Sua sessão local continua em execução sem Remote Control. Esta seção cobre essas linhas:1141Quando o Claude Code interrompe o Remote Control, ele mostra o motivo em um aviso e em uma linha da transcrição que começa com `Remote Control disconnected`. Sua sessão local continua em execução sem o Remote Control. Esta seção aborda estas linhas:
1132 1142
1133```text theme={null}1143```text theme={null}
1134Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control1144Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
1140Remote Control disconnected — Signed out of Claude — run /login, then /remote-control1150Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
1141```1151```
1142 1152
1143Claude Code nomeia a causa no meio da mensagem:1153O Claude Code nomeia a causa no meio da mensagem:
1144 1154
1145* `Claude.ai login expired` e `Claude.ai login was rejected`: claude.ai não aceita mais seu token de login salvo, porque expirou ou foi revogado1155* `Claude.ai login expired` e `Claude.ai login was rejected`: o claude.ai não aceita mais seu token de login salvo, porque ele expirou ou foi revogado
1146* `OAuth token unavailable`: Claude Code não tinha nenhum token de login salvo quando a credencial da conexão venceu para renovação1156* `OAuth token unavailable`: o Claude Code não tinha nenhum token de login salvo quando chegou a hora de renovar a credencial da conexão
1147* `OAuth token refresh failed`: claude.ai rejeitou seu token de login salvo enquanto Claude Code estava se reconectando, e atualizar o token não produziu um novo1157* `OAuth token refresh failed`: o claude.ai rejeitou seu token de login salvo enquanto o Claude Code estava se reconectando, e a renovação do token não produziu um novo
1148* `JWT refresh failed: no OAuth token`: Claude Code não encontrou nenhum token de login salvo para renovar1158* `JWT refresh failed: no OAuth token`: o Claude Code não encontrou nenhum token de login salvo para renovar
1149* `Signed out of Claude`: você se desconectou nesta máquina, por exemplo, executando `/logout` em outro terminal, portanto, Claude Code não tem nenhum login salvo para renovar a conexão1159* `Signed out of Claude`: você saiu nesta máquina, por exemplo executando `/logout` em outro terminal, então o Claude Code não tem mais nenhum login salvo para renovar a conexão
1150 1160
1151**O que fazer:**1161**O que fazer:**
1152 1162
1153* Execute `/login` para se conectar novamente1163* Execute `/login` para entrar novamente
1154* Execute `/remote-control` para reconectar a sessão. Mensagens terminando `run /login to restore Remote Control` não precisam desta etapa: Claude Code se reconecta automaticamente depois que você se conecta.1164* Execute `/remote-control` para reconectar a sessão. Mensagens que terminam com `run /login to restore Remote Control` não precisam desta etapa: o Claude Code se reconecta por conta própria assim que você entra.
1155 1165
1156Antes da v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` lia `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, e `JWT refresh failed: no OAuth token — run /login` lia `no OAuth token available for recovery (code <N>)`. As mensagens `Claude.ai login expired`, `Claude.ai login was rejected` e `OAuth token unavailable` foram adicionadas na v2.1.225.1166Antes da v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` dizia `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, e `JWT refresh failed: no OAuth token — run /login` dizia `no OAuth token available for recovery (code <N>)`. As mensagens `Claude.ai login expired`, `Claude.ai login was rejected` e `OAuth token unavailable` foram adicionadas na v2.1.225.
1157 1167
1158Antes da v2.1.238, Claude Code relatava os casos que agora dizem `Signed out of Claude` como `JWT refresh failed: no OAuth token — run /login`, e parava Remote Control com `Claude.ai login expired — run /login to restore Remote Control` assim que uma atualização de login não obtinha resposta.1168Antes da v2.1.238, o Claude Code relatava os casos que agora dizem `Signed out of Claude` como `JWT refresh failed: no OAuth token — run /login`, e interrompia o Remote Control com `Claude.ai login expired — run /login to restore Remote Control` assim que uma renovação de login ficava sem resposta.
1159 1169
1160<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1170<h3 id="remote-control-stopped-because-the-signed-in-account-changed">
1161 Remote Control parou porque a conta conectada mudou1171 O Remote Control foi interrompido porque a conta conectada mudou
1162</h3>1172</h3>
1163 1173
1164Claude Code mostra essa linha durante uma sessão [Remote Control](/docs/pt/remote-control) quando você se conecta a uma conta claude.ai ou organização diferente nesta máquina. Você fez a mudança fora da sessão Claude Code, por exemplo, executando `/login` em outro terminal.1174O Claude Code mostra esta linha durante uma sessão do [Remote Control](/docs/pt/remote-control) quando você entra em uma conta ou organização claude.ai diferente nesta máquina. Você fez a troca fora da sessão do Claude Code, por exemplo executando `/login` em outro terminal.
1165 1175
1166Uma sessão Remote Control que você iniciou enquanto estava conectado através de `/login` pertence à conta claude.ai e organização que estavam conectadas no momento.1176Uma sessão do Remote Control que você iniciou enquanto estava conectado por meio de `/login` pertence à conta e à organização claude.ai que estavam conectadas naquele momento.
1167 1177
1168```text theme={null}1178```text theme={null}
1169Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control1179Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control
1170```1180```
1171 1181
1172Claude Code para a sessão Remote Control assim que claude.ai confirma que a conta ou organização mudou. Sua sessão local continua em execução sem Remote Control.1182O Claude Code interrompe a sessão do Remote Control assim que o claude.ai confirma que a conta ou organização mudou. Sua sessão local continua em execução sem o Remote Control.
1173 1183
1174**O que fazer:**1184**O que fazer:**
1175 1185
1176* Execute `/remote-control` para iniciar uma nova sessão Remote Control sob a conta ou organização atual1186* Execute `/remote-control` para iniciar uma nova sessão do Remote Control na conta ou organização atual
1177* Para voltar, execute `/login` e conecte-se à conta ou organização anterior novamente. Depois execute `/remote-control`.1187* Para voltar, execute `/login` e entre novamente na conta ou organização anterior. Em seguida, execute `/remote-control`.
1178 1188
1179Antes da v2.1.234, Claude Code não notava quando você mudava para uma conta ou organização diferente fora da sessão Claude Code. Claude Code mantinha a sessão Remote Control conectada até que uma solicitação posterior ao servidor Remote Control falhasse com `Remote Control server rejected the request (HTTP 404)`. Essa falha poderia vir horas após a mudança.1189Antes da v2.1.234, o Claude Code não percebia quando você mudava para uma conta ou organização diferente fora da sessão do Claude Code. O Claude Code mantinha a sessão do Remote Control conectada até que uma requisição posterior ao servidor do Remote Control falhasse com `Remote Control server rejected the request (HTTP 404)`. Essa falha podia ocorrer horas após a troca.
1180 1190
1181<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">1191<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">
1182 Remote Control parou porque o aplicativo que executa a sessão se desconectou ou mudou de contas1192 O Remote Control foi interrompido porque o aplicativo que executa a sessão saiu ou trocou de conta
1183</h3>1193</h3>
1184 1194
1185Quando o aplicativo Claude desktop ou um IDE hospeda sua sessão, Claude Code obtém seu token de login desse aplicativo em vez de `/login`. Quando claude.ai rejeita esse token, Claude Code pede ao aplicativo um novo. Se o aplicativo responder que está desconectado ou que agora está conectado a uma conta Claude diferente, Claude Code encerra a sessão [Remote Control](/docs/pt/remote-control) e envia ao aplicativo uma dessas linhas:1195Quando o aplicativo Claude desktop ou uma IDE hospeda sua sessão, o Claude Code obtém seu token de login desse aplicativo em vez de `/login`. Quando o claude.ai rejeita esse token, o Claude Code pede um novo ao aplicativo. Se o aplicativo responder que está desconectado, ou que agora está conectado a uma conta Claude diferente, o Claude Code encerra a sessão do [Remote Control](/docs/pt/remote-control) e envia ao aplicativo uma destas linhas:
1186 1196
1187```text theme={null}1197```text theme={null}
1188Remote Control stopped — the app running this session is now signed in to a different Claude account1198Remote Control stopped — the app running this session is now signed in to a different Claude account
1189Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on1199Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
1190```1200```
1191 1201
1192Sua sessão local continua em execução sem Remote Control.1202Sua sessão local continua em execução sem o Remote Control.
1193 1203
1194**O que fazer:**1204**O que fazer:**
1195 1205
1196* Se o aplicativo está desconectado, conecte-se a ele novamente e depois ative Remote Control novamente no aplicativo1206* Se o aplicativo estiver desconectado, entre nele novamente e depois reative o Remote Control no aplicativo
1197* Se o aplicativo mudou de contas, Claude Code não consegue continuar a sessão encerrada sob a nova conta. Inicie uma nova sessão Remote Control sob essa conta.1207* Se o aplicativo trocou de conta, o Claude Code não pode continuar a sessão encerrada na nova conta. Inicie uma nova sessão do Remote Control nessa conta.
1198 1208
1199Antes da v2.1.238, Claude Code enviava ao aplicativo as mensagens `run /login` listadas em [Remote Control não conseguiu atualizar seu login](#remote-control-couldnt-refresh-your-login) em ambos os casos.1209Antes da v2.1.238, o Claude Code enviava ao aplicativo as mensagens `run /login` listadas em [O Remote Control não conseguiu renovar seu login](#remote-control-couldnt-refresh-your-login) em ambos os casos.
1200 1210
1201<h3 id="oauth-token-revoked-or-expired">1211<h3 id="oauth-token-revoked-or-expired">
1202 Token OAuth revogado ou expirado1212 Token OAuth revogado ou expirado
1203</h3>1213</h3>
1204 1214
1205Seu login salvo não é mais válido. Um token revogado significa que você se desconectou em todos os lugares ou um administrador removeu o acesso; um token expirado significa que a atualização automática falhou no meio da sessão.1215Seu login salvo não é mais válido. Um token revogado significa que você saiu de todos os lugares ou que um administrador removeu o acesso; um token expirado significa que a renovação automática falhou no meio da sessão.
1206 1216
1207Ambas as mensagens relatam uma rejeição que a API retornou para uma solicitação que Claude Code enviou. Quando o login salvo já foi limpo após uma atualização falhada, você vê [Login expirado](#login-expired). Se você se autenticar com um token de longa duração em [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars), você vê as mesmas mensagens quando esse token expira ou é revogado.1217Ambas as mensagens relatam uma rejeição que a API retornou para uma requisição enviada pelo Claude Code. Quando o login salvo já foi apagado após uma renovação com falha, você vê [Login expirado](#login-expired). Se você se autentica com um token de longa duração em [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars), você vê as mesmas mensagens quando esse token expira ou é revogado.
1208 1218
1209```text theme={null}1219```text theme={null}
1210OAuth token revoked · Please run /login1220OAuth token revoked · Please run /login
1213 1223
1214**O que fazer:**1224**O que fazer:**
1215 1225
1216* Execute `/login` para se conectar novamente1226* Execute `/login` para entrar novamente
1217* Se você se autenticar com a variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code continua enviando o valor que você definiu após uma solicitação falhar com um 401, em vez de mudar para o token de um login salvo. [`/status`](/docs/pt/commands) mostra essa credencial como uma linha `Auth token` lendo `CLAUDE_CODE_OAUTH_TOKEN`. Gere um token novo com [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token) e reinicie com ele, ou desdefina a variável e execute `/login`. Antes da v2.1.225, Claude Code poderia substituir o valor da variável no meio da sessão pelo token de acesso de curta duração de um login salvo, e a sessão falhava com erros 401 novamente depois que esse token expirava.1227* Se você se autentica com a variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`, o Claude Code continua enviando o valor que você definiu depois que uma requisição falha com um 401, em vez de mudar para o token de um login armazenado. O [`/status`](/docs/pt/commands) mostra essa credencial como uma linha `Auth token` com `CLAUDE_CODE_OAUTH_TOKEN`. Gere um novo token com [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token) e reinicie com ele, ou remova a definição da variável e execute `/login`. Antes da v2.1.225, o Claude Code podia substituir o valor da variável no meio da sessão pelo token de acesso de curta duração de um login armazenado, e a sessão voltava a falhar com erros 401 assim que esse token expirava.
1218* Para prompts repetidos para fazer login entre inicializações, veja as verificações de relógio do sistema e etapas de recuperação de armazenamento de credenciais do macOS em [Solução de problemas](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired)1228* Para solicitações repetidas de login entre inicializações, consulte as verificações do relógio do sistema e as etapas de recuperação do armazenamento de credenciais do macOS em [Solução de problemas](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired)
1219* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, veja [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)1229* Para outras falhas, incluindo `403 Forbidden` e problemas de OAuth no navegador, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
1220 1230
1221<h3 id="api-error-401-invalid-authentication-credentials">1231<h3 id="api-error-401-invalid-authentication-credentials">
1222 API Error: 401 Credenciais de autenticação inválidas1232 API Error: 401 Invalid authentication credentials
1223</h3>1233</h3>
1224 1234
1225A API reconheceu o formato de sua credencial, mas rejeitou a conta ou organização por trás dela. Anthropic retorna essa mensagem quando uma credencial foi revogada recentemente, quando uma organização foi desabilitada ou removeu seu acesso, ou quando a conta em si foi desativada, portanto, um token expirado não é a causa. A credencial pode ser seu login salvo ou um `ANTHROPIC_API_KEY` aprovado, e a correção difere, portanto, comece executando `/status` para ver qual está ativa.1235A API reconheceu o formato da sua credencial, mas rejeitou a conta ou organização por trás dela. A Anthropic retorna esta mensagem quando uma credencial foi revogada recentemente, quando uma organização foi desativada ou removeu seu acesso, ou quando a própria conta foi desativada; portanto, um token expirado não é a causa. A credencial pode ser seu login salvo ou uma `ANTHROPIC_API_KEY` aprovada, e a correção é diferente, então comece executando `/status` para ver qual está ativa.
1226 1236
1227```text theme={null}1237```text theme={null}
1228Please run /login · API Error: 401 Invalid authentication credentials1238Please run /login · API Error: 401 Invalid authentication credentials
1230 1240
1231**O que fazer:**1241**O que fazer:**
1232 1242
1233* Se `/status` mostrar uma linha `API key` que não está marcada como não em uso, um [`ANTHROPIC_API_KEY`](/docs/pt/authentication#authentication-precedence) aprovado é a credencial ativa e tem precedência sobre seu login, portanto, `/login` não a substitui. Gire a chave no Claude Console, ou volte para sua assinatura executando `unset ANTHROPIC_API_KEY`, ou no PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.1243* Se `/status` mostrar uma linha `API key` que não esteja marcada como não utilizada, uma [`ANTHROPIC_API_KEY`](/docs/pt/authentication#authentication-precedence) aprovada é a credencial ativa e tem precedência sobre seu login, então `/login` não a substitui. Rotacione a chave no Claude Console, ou volte para sua assinatura executando `unset ANTHROPIC_API_KEY` ou, no PowerShell, `Remove-Item Env:ANTHROPIC_API_KEY`.
1234* Se `/status` mostrar apenas seu login, execute `/login` uma vez. Se a credencial foi revogada, um novo login a substitui.1244* Se `/status` mostrar apenas seu login, execute `/login` uma vez. Se a credencial foi revogada, um novo login a substitui.
1235* Se a mesma mensagem retornar para a mesma conta de login, a conta ou organização não está mais ativa. Verifique a conta e organização que `/status` relata e peça ao administrador da sua organização para restaurar o acesso.1245* Se a mesma mensagem voltar para a mesma conta de login, a conta ou organização não está mais ativa. Verifique a conta e a organização que `/status` informa e peça ao administrador da sua organização que restaure o acesso.
1236* Se [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) aponta para um [gateway LLM](/docs/pt/llm-gateway), o texto após `401` é a mensagem do seu gateway em vez de Anthropic, e `/login` não a altera. Corrija a credencial que seu gateway espera.1246* Se [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) apontar para um [gateway de LLM](/docs/pt/llm-gateway), o texto após `401` é a mensagem do seu gateway, não da Anthropic, e `/login` não a altera. Corrija a credencial que seu gateway espera.
1237 1247
1238<h3 id="login-expired">1248<h3 id="login-expired">
1239 Login expirado1249 Login expirado
1240</h3>1250</h3>
1241 1251
1242Claude Code tentou renovar seu login claude.ai salvo e o serviço OAuth rejeitou o token de atualização armazenado, portanto, Claude Code limpou as credenciais salvas. Depois disso, cada solicitação de modelo para localmente com essa mensagem antes de chegar à API, porque apenas `/login` pode criar novas credenciais.1252O Claude Code tentou renovar seu login claude.ai salvo e o serviço OAuth rejeitou o token de renovação armazenado, então o Claude Code apagou as credenciais salvas. Depois disso, cada requisição ao modelo é interrompida localmente com esta mensagem antes de chegar à API, porque apenas `/login` pode criar novas credenciais.
1243 1253
1244Antes da v2.1.206, Claude Code enviava a solicitação de modelo de qualquer forma com qualquer credencial que permanecesse no ambiente, e cada modelo 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 se conectar.1254Antes da v2.1.206, o Claude Code enviava a requisição ao modelo mesmo assim com qualquer credencial que restasse no ambiente, e todos os modelos falhavam com [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model) ou um 401 em vez de um prompt para entrar.
1245 1255
1246```text theme={null}1256```text theme={null}
1247Login expired · Please run /login1257Login expired · Please run /login
1248```1258```
1249 1259
1250Em [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), a mensagem lê como segue, e o código de erro estruturado é `authentication_failed`:1260No [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), a mensagem é a seguinte, e o código de erro estruturado é `authentication_failed`:
1251 1261
1252```text theme={null}1262```text theme={null}
1253Failed to authenticate: OAuth session expired and could not be refreshed1263Failed to authenticate: OAuth session expired and could not be refreshed
1254```1264```
1255 1265
1256Este não é o mesmo estado que [Token OAuth revogado ou expirado](#oauth-token-revoked-or-expired). Essas mensagens relatam uma rejeição 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. Quando a renovação falha porque a conta em si está suspensa em vez do login estar obsoleto, Claude Code mostra [Sua conta está em espera](#your-account-is-on-hold).1266Este não é o mesmo estado que [Token OAuth revogado ou expirado](#oauth-token-revoked-or-expired). Aquelas mensagens relatam uma rejeição que a API retornou. O próprio Claude Code produz `Login expired` para um login que ele já não conseguiu renovar, então não envia nenhuma requisição. Quando a renovação falha porque a própria conta está suspensa, e não porque o login está desatualizado, o Claude Code mostra [Sua conta está suspensa](#your-account-is-on-hold).
1257 1267
1258Sessõ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 essa mensagem.1268Sessõ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.
1259 1269
1260Você pode verificar esse estado antes de uma solicitação falhar: [`/status`](/docs/pt/commands) mostra uma linha `Login` lendo `Expired — log in again`, mais a organização e email que tem salvo para o login expirado. A linha aparece apenas quando o login salvo é sua credencial ativa e não pode mais ser atualizado. Sessões autenticadas de outra forma não mostram a linha, mesmo que um login expirado permaneça salvo. Antes da v2.1.210, `/status` não dava nenhuma indicação nesse estado de que um login já havia existido, porque a credencial limpa deixou nada para relatar.1270Você pode verificar esse estado antes que uma requisição falhe: o [`/status`](/docs/pt/commands) mostra uma linha `Login` com `Expired — log in again`, além da organização e do e-mail que ele salvou para o login expirado. A linha aparece apenas quando o login salvo é sua credencial ativa e não pode mais ser renovado. Sessões autenticadas de outra forma não mostram a linha, mesmo que um login expirado continue salvo. Antes da v2.1.210, `/status` não dava nenhuma indicação nesse estado de que um login já tivesse existido, porque a credencial apagada não deixava nada para relatar.
1261 1271
1262**O que fazer:**1272**O que fazer:**
1263 1273
1264* Execute `/login` para se conectar novamente. Tentar novamente sem se conectar mostra a mesma mensagem em cada solicitação.1274* Execute `/login` para entrar novamente. Tentar novamente sem entrar mostra a mesma mensagem em todas as requisições.
1265* Em modo não interativo, execute `claude` no mesmo ambiente, complete `/login`, depois reexecute seu comando. Para automação que não consegue se conectar 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).1275* Se você entrar com sua conta claude.ai em outra janela do Claude Code, consulte [Não conectado](#not-logged-in) para saber quando esta sessão passa a usar esse login por conta própria.
1266* Se a conexão continuar falhando, veja [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)1276* No modo não interativo, execute `claude` no mesmo ambiente, conclua o `/login` e depois execute seu comando novamente. Para automação que não pode entrar de forma interativa, 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).
1277* Se entrar continuar falhando, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
1267 1278
1268<h3 id="could-not-refresh-your-login">1279<h3 id="could-not-refresh-your-login">
1269 Não foi possível atualizar seu login porque outro processo Claude Code está atualizando-o1280 Não foi possível renovar seu login porque outro processo do Claude Code está renovando-o
1270</h3>1281</h3>
1271 1282
1272Esta mensagem não significa que seu login foi rejeitado. Seu login claude.ai salvo havia expirado e precisava ser renovado. Outro processo Claude Code na mesma máquina mantinha o bloqueio de atualização compartilhado, ou saiu e deixou-o para trás, e a atualização não fez progresso enquanto essa sessão esperava. Claude Code para a solicitação antes de enviá-la:1283Esta mensagem não significa que seu login foi rejeitado. Seu login claude.ai salvo havia expirado e precisava ser renovado. Outro processo do Claude Code na mesma máquina mantinha o bloqueio compartilhado de renovação, ou terminou e o deixou para trás, e a renovação não avançou enquanto esta sessão esperava. O Claude Code interrompe a requisição antes de enviá-la:
1273 1284
1274```text theme={null}1285```text theme={null}
1275Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login1286Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login
1276```1287```
1277 1288
1278Em [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), a mensagem lê como segue, e o código de erro estruturado é `server_error`:1289No [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), a mensagem é a seguinte, e o código de erro estruturado é `server_error`:
1279 1290
1280```text theme={null}1291```text theme={null}
1281Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again1292Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again
1282```1293```
1283 1294
1284Sessõ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 essa mensagem.1295Sessõ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.
1285 1296
1286**O que fazer:**1297**O que fazer:**
1287 1298
1288* Tente novamente em um minuto. Se outro processo completar a atualização primeiro, essa sessão usa o login renovado.1299* Tente novamente em um minuto. Se outro processo concluir a renovação primeiro, esta sessão usa o login renovado.
1289* Se a mensagem continuar retornando, feche outras janelas e processos Claude Code, depois tente novamente.1300* Se a mensagem continuar voltando, feche outras janelas e processos do Claude Code e tente novamente.
1290* Se retornar sem nenhum outro processo Claude Code em execução, execute `/login`. Conectar-se novamente não espera no bloqueio de atualização.1301* Se ela voltar sem nenhum outro processo do Claude Code em execução, execute `/login`. Entrar novamente não espera pelo bloqueio de renovação.
1291 1302
1292<h3 id="couldnt-save-your-login">1303<h3 id="couldnt-save-your-login">
1293 Não foi possível salvar seu login1304 Não foi possível salvar seu login
1294</h3>1305</h3>
1295 1306
1296Você se conectou com claude.ai, mas Claude Code não conseguiu salvar o login em seu armazenamento de credenciais, portanto, o login não foi concluído. No macOS, isso pode acontecer quando o keychain de login é bloqueado, por exemplo, no sono ou ociosidade, depois que Claude Code já leu ou salvou credenciais nele durante a mesma sessão.1307Você entrou com claude.ai, mas o Claude Code não conseguiu salvar o login no seu armazenamento de credenciais, então o login não foi concluído. No macOS, isso pode acontecer quando o keychain de login é bloqueado, por exemplo ao entrar em repouso ou ficar ocioso, depois que o Claude Code já leu ou salvou credenciais nele durante a mesma sessão.
1297 1308
1298```text theme={null}1309```text theme={null}
1299Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.1310Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
1300Couldn't save your login. Try logging in again.1311Couldn't save your login. Try logging in again.
1301```1312```
1302 1313
1303A primeira forma aparece no macOS e a segunda em todos os outros lugares. Uma falha transitória de armazenamento de credenciais, como um tempo limite ou um armazenamento ilegível, produz a mesma mensagem.1314A primeira forma aparece no macOS e a segunda em todos os outros lugares. Uma falha transitória do armazenamento de credenciais, como um timeout ou um armazenamento ilegível, produz a mesma mensagem.
1304 1315
1305**O que fazer:**1316**O que fazer:**
1306 1317
1307* No macOS, desbloqueie o keychain de login e execute `/login` novamente1318* No macOS, desbloqueie o keychain de login e execute `/login` novamente
1308* Em outras plataformas, execute `/login` novamente1319* Em outras plataformas, execute `/login` novamente
1309* Se o login ainda não for salvo, veja [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para o comando de desbloqueio de keychain e outras etapas de recuperação de armazenamento de credenciais1320* Se o login ainda não for salvo, consulte [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para o comando de desbloqueio do keychain e outras etapas de recuperação do armazenamento de credenciais
1310 1321
1311<h3 id="failed-to-start-oauth-callback-server">1322<h3 id="failed-to-start-oauth-callback-server">
1312 Falha ao iniciar servidor de callback OAuth1323 Falha ao iniciar o servidor de callback OAuth
1313</h3>1324</h3>
1314 1325
1315Quando `/login`, `claude auth login` ou `claude setup-token` o conecta através do navegador, Claude Code abre uma porta de escuta em `127.0.0.1` para que seu navegador possa retornar o resultado da conexão a ele. Esta mensagem significa que Claude Code não conseguiu abrir essa porta, e a conexão para antes de uma janela do navegador ou URL de login aparecer:1326Quando `/login`, `claude auth login` ou `claude setup-token` faz você entrar pelo navegador, o Claude Code abre uma porta de escuta em `127.0.0.1` para que seu navegador possa retornar a ele o resultado do login. Esta mensagem significa que o Claude Code não conseguiu abrir essa porta, e o login é interrompido antes que uma janela do navegador ou URL de login apareça:
1316 1327
1317```text theme={null}1328```text theme={null}
1318Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1329Failed to start OAuth callback server: Failed to start server. Is port 0 in use?
1319```1330```
1320 1331
1321Se sua mensagem terminar com `Is port 0 in use?`, a tentativa de escutar no endereço de loopback IPv4 `127.0.0.1` falhou completamente. Como a falha acontece antes de uma URL de login existir, o fluxo `Paste code here if prompted` não está disponível como solução alternativa.1332Se sua mensagem terminar com `Is port 0 in use?`, a tentativa de escutar no endereço de loopback IPv4 `127.0.0.1` falhou completamente. Como a falha acontece antes que exista uma URL de login, o fluxo `Paste code here if prompted` não está disponível como solução alternativa.
1322 1333
1323**O que fazer:**1334**O que fazer:**
1324 1335
1325* Para se conectar agora sem o ouvinte local: se você usar uma assinatura claude.ai, execute [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token) em uma máquina onde a conexão funciona e defina o token que ele imprime como `CLAUDE_CODE_OAUTH_TOKEN` nesta máquina. Caso contrário, defina `ANTHROPIC_API_KEY` para uma chave do [Claude Console](https://platform.claude.com/settings/keys). [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) explica como Claude Code escolhe entre credenciais.1336* Para entrar imediatamente sem o listener local: se você usa uma assinatura claude.ai, execute [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token) em uma máquina onde o login funciona e defina o token que ele imprime como `CLAUDE_CODE_OAUTH_TOKEN` nesta máquina. Caso contrário, defina `ANTHROPIC_API_KEY` com uma chave do [Claude Console](https://platform.claude.com/settings/keys). [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) explica como o Claude Code escolhe entre as credenciais.
1326* Para usar a conexão do navegador nesta máquina, Claude Code deve ser capaz de escutar em `127.0.0.1`. Se ele é executado dentro de uma sandbox, verifique se a política da sandbox permite escutar em portas locais, depois execute `/login` novamente. Se deveria ser capaz e ainda falha, execute `/feedback` para que o relatório inclua detalhes do seu ambiente.1337* Para usar o login pelo navegador nesta máquina, o Claude Code precisa conseguir escutar em `127.0.0.1`. Se ele for executado dentro de um sandbox, verifique se a política do sandbox permite escutar em portas locais e depois execute `/login` novamente. Se ele deveria conseguir e ainda assim falhar, execute `/feedback` para que o relatório inclua os detalhes do seu ambiente.
1327 1338
1328<h3 id="claude-login-not-accepted">1339<h3 id="claude-login-not-accepted">
1329 Claude login não aceito1340 Login Claude não aceito
1330</h3>1341</h3>
1331 1342
1332Você tentou iniciar uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) e o servidor recusou criá-la com um 401: não aceitou o login Claude que esta máquina enviou, geralmente porque o login expirou ou foi revogado.1343Você tentou iniciar uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), e o servidor se recusou a criá-la com um 401: ele não aceitou o login Claude que esta máquina enviou, geralmente porque o login expirou ou foi revogado.
1333 1344
1334A primeira parte da linha é o próprio motivo do servidor quando fornece um. Caso contrário, a linha lê:1345A primeira parte da linha é o próprio motivo do servidor, quando ele fornece um. Caso contrário, a linha diz:
1335 1346
1336```text theme={null}1347```text theme={null}
1337Claude login not accepted · Run /login, then try again1348Claude login not accepted · Run /login, then try again
1339 1350
1340**O que fazer:**1351**O que fazer:**
1341 1352
1342* Execute `/login`, complete a conexão e inicie a sessão novamente1353* Execute `/login`, conclua o login e depois inicie a sessão novamente
1343 1354
1344<h3 id="artifacts-need-a-claude-ai-login">1355<h3 id="artifacts-need-a-claude-ai-login">
1345 Artefatos precisam de um login claude.ai1356 Artefatos precisam de um login claude.ai
1346</h3>1357</h3>
1347 1358
1348Claude Code recusou uma publicação ou leitura de [artefato](/docs/pt/artifacts) porque a sessão não tem nenhum login claude.ai que possa usar para artefatos.1359O Claude Code recusou uma publicação ou leitura de [artefato](/docs/pt/artifacts) porque a sessão não tem nenhum login claude.ai que possa usar para artefatos.
1349 1360
1350Cada forma da mensagem começa com as mesmas palavras, seguidas por um remédio que depende de como sua sessão se autentica. Sem credencial concorrente, lê:1361Todas as formas da mensagem começam com as mesmas palavras, seguidas por uma solução que depende de como sua sessão se autentica. Sem nenhuma credencial concorrente, ela diz:
1351 1362
1352```text theme={null}1363```text theme={null}
1353Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.1364Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.
1356**O que fazer:**1367**O que fazer:**
1357 1368
1358* Execute `/login` e selecione **Claude account with subscription**. A opção **Anthropic Console account** não fornece credenciais claude.ai.1369* Execute `/login` e selecione **Claude account with subscription**. A opção **Anthropic Console account** não fornece credenciais claude.ai.
1359* Quando a mensagem nomeia uma credencial que tem precedência, como `ANTHROPIC_API_KEY`, uma configuração `apiKeyHelper` ou uma chave Console salva por um `/login` anterior, remova-a da forma que a mensagem diz, depois execute `/login`1370* Quando a mensagem nomear uma credencial que tem precedência, como `ANTHROPIC_API_KEY`, uma configuração `apiKeyHelper` ou uma chave do Console salva por um `/login` anterior, remova-a da forma que a mensagem indica e depois execute `/login`
1360* Quando a mensagem diz que essa sessão remota se autentica através da máquina que a iniciou, conecte-se a claude.ai nessa máquina e depois reconecte a sessão1371* Quando a mensagem disser que esta sessão remota se autentica por meio da máquina que a iniciou, entre no claude.ai nessa máquina e depois reconecte a sessão
1361* Quando a mensagem diz que a credencial é injetada pelo ambiente host da sessão, você não consegue alterá-la nessa sessão; inicie uma sessão que está conectada a claude.ai1372* Quando a mensagem disser que a credencial é injetada pelo ambiente host da sessão, você não pode alterá-la nessa sessão; inicie uma sessão conectada ao claude.ai
1362* Veja [Disponibilidade](/docs/pt/artifacts#availability) para os outros requisitos que artefatos têm, como plano, provedor de modelo e política de organização1373* Consulte [Disponibilidade](/docs/pt/artifacts#availability) para os outros requisitos dos artefatos, como plano, provedor do modelo e política da organização
1363 1374
1364<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1375<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">
1365 A política do administrador requer um login do gateway de nuvem1376 A política do administrador requer um login no Cloud gateway
1366</h3>1377</h3>
1367 1378
1368As [configurações gerenciadas](/docs/pt/managed-settings) de um administrador nesta máquina definem [`forceLoginMethod`](/docs/pt/settings-reference#forceloginmethod) como `"gateway"` ou definem [`forceLoginGatewayUrl`](/docs/pt/settings-reference#forcelogingatewayurl). A menos que você selecione um provedor de nuvem através de uma variável como `CLAUDE_CODE_USE_BEDROCK`, Claude Code então aceita apenas o login do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway). Você vê uma de duas mensagens:1379As [configurações gerenciadas](/docs/pt/managed-settings) de um administrador nesta máquina definem [`forceLoginMethod`](/docs/pt/settings-reference#forceloginmethod) como `"gateway"` ou definem [`forceLoginGatewayUrl`](/docs/pt/settings-reference#forcelogingatewayurl). A menos que você selecione um provedor de nuvem por meio de uma variável como `CLAUDE_CODE_USE_BEDROCK`, o Claude Code então aceita apenas o login do [Claude apps gateway](/docs/pt/claude-apps-gateway). Você vê uma de duas mensagens:
1369 1380
1370```text theme={null}1381```text theme={null}
1371Not signed in to the Cloud gateway — run /login.1382Not signed in to the Cloud gateway — run /login.
1372```1383```
1373 1384
1374As solicitações de modelo falham com essa mensagem quando a sessão não tem nenhum login de gateway, por exemplo, porque você não executou `/login` desde que a política chegou à máquina.1385As requisições ao modelo falham com esta mensagem quando a sessão não tem login no gateway, por exemplo porque você não executou `/login` desde que a política chegou à máquina.
1375 1386
1376Se a máquina também contiver uma credencial emitida pela Anthropic e as configurações gerenciadas definirem `forceLoginMethod` ou `forceLoginOrgUUID`, Claude Code sai na inicialização. Essa credencial pode ser uma variável `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN`, uma configuração `apiKeyHelper` ou uma chave de API salva por um login Console anterior. A mensagem começa:1387Se a máquina também tiver uma credencial emitida pela Anthropic e as configurações gerenciadas definirem `forceLoginMethod` ou `forceLoginOrgUUID`, o Claude Code termina na inicialização. Essa credencial pode ser uma variável `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN`, uma configuração `apiKeyHelper` ou uma chave de API salva por um login anterior no Claude Console. A mensagem começa com:
1377 1388
1378```text theme={null}1389```text theme={null}
1379Administrator policy requires a Cloud gateway sign-in on this machine; the1390Administrator policy requires a Cloud gateway sign-in on this machine; the
1383 1394
1384**O que fazer:**1395**O que fazer:**
1385 1396
1386* Execute `/login` e complete a conexão na tela **Cloud gateway**1397* Execute `/login` e conclua o login na tela **Cloud gateway**
1387* Para a mensagem de inicialização, remova a configuração `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` que você configurou. Para remover uma chave de API Console salva, execute `claude auth logout`, que também remove um login claude.ai salvo. Se você selecionar um provedor de nuvem com `CLAUDE_CODE_USE_*`, a sessão então inicia sem conexão. Caso contrário, inicie `claude` e execute `/login`1398* Para a mensagem de inicialização, remova a configuração `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` que você configurou. Para remover uma chave de API do Console salva, execute `claude auth logout`, que também remove um login claude.ai salvo. Se você selecionar um provedor de nuvem com `CLAUDE_CODE_USE_*`, a sessão então inicia sem login. Caso contrário, inicie o `claude` e execute `/login`
1388* Se você acredita que a máquina não deveria exigir o gateway, peça ao administrador que a gerencia para remover `forceLoginMethod` e `forceLoginGatewayUrl` de suas configurações gerenciadas1399* Se você acredita que a máquina não deveria exigir o gateway, peça ao administrador que a gerencia para remover `forceLoginMethod` e `forceLoginGatewayUrl` de suas configurações gerenciadas
1389 1400
1390Na v2.1.265, uma regressão também mostrou a primeira mensagem em algumas configurações de gateway LLM e proxy que se autenticam com uma chave de API, `apiKeyHelper` ou cabeçalhos personalizados, mesmo sem nenhum requisito de administrador na máquina. Atualize para v2.1.266 ou posterior. Você não precisa alterar sua configuração.1401Na v2.1.265, uma regressão também mostrava a primeira mensagem em algumas configurações de gateway de LLM e proxy que se autenticam com uma chave de API, `apiKeyHelper` ou cabeçalhos personalizados, mesmo sem nenhum requisito de administrador na máquina. Atualize para a v2.1.266 ou posterior. Você não precisa alterar sua configuração.
1391 1402
1392Antes da v2.1.261, em máquinas que definem `forceLoginMethod` como `"gateway"`, Claude Code usava um login salvo restante em vez de falhar solicitações de modelo, e relatava uma credencial de ambiente configurada com `This machine's managed settings require a first-party login` em vez da mensagem de inicialização. Antes da v2.1.265, uma máquina cujas configurações gerenciadas definem apenas `forceLoginGatewayUrl` não exigia o login de gateway, e Claude Code usava uma credencial restante lá.1403Antes da v2.1.261, em máquinas que definiam `forceLoginMethod` como `"gateway"`, o Claude Code usava um login salvo remanescente em vez de fazer as requisições ao modelo falharem, e relatava uma credencial de ambiente configurada com `This machine's managed settings require a first-party login` em vez da mensagem de inicialização. Antes da v2.1.265, uma máquina cujas configurações gerenciadas definiam apenas `forceLoginGatewayUrl` não exigia o login no gateway, e o Claude Code usava uma credencial remanescente ali.
1393 1404
1394<h3 id="your-account-is-on-hold">1405<h3 id="your-account-is-on-hold">
1395 Sua conta está em espera1406 Sua conta está suspensa
1396</h3>1407</h3>
1397 1408
1398A conta Claude por trás do seu login foi suspensa. Claude Code mostra a primeira mensagem quando tenta renovar seu login salvo e aprende sobre a espera, e a segunda quando uma conexão que você completa no navegador a relata:1409A conta Claude por trás do seu login foi suspensa. O Claude Code mostra a primeira mensagem quando tenta renovar seu login salvo e descobre a suspensão, e a segunda quando um login que você conclui no navegador a informa:
1399 1410
1400```text theme={null}1411```text theme={null}
1401Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1412Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
1402Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted1413Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
1403```1414```
1404 1415
1405Conectar-se novamente com a mesma conta não limpa a mensagem, porque a espera está na conta em vez do login. Em [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), o código de erro estruturado é `account_on_hold`. Antes da v2.1.235, Claude Code relatava uma conta em espera como [Login expirado · Please run /login](#login-expired), cujas etapas de recuperação não conseguem limpar uma espera.1416Entrar novamente com a mesma conta não elimina a mensagem, porque a suspensão está na conta, e não no login. No [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), o código de erro estruturado é `account_on_hold`. Antes da v2.1.235, o Claude Code relatava uma conta suspensa como [Login expired · Please run /login](#login-expired), cujas etapas de recuperação não podem eliminar uma suspensão.
1406 1417
1407**O que fazer:**1418**O que fazer:**
1408 1419
1409* Abra o link na mensagem para visualizar os detalhes da espera ou apelá-la1420* Abra o link na mensagem para ver os detalhes da suspensão ou contestá-la
1410* Se você tiver outra conta Claude ou uma chave de API que não seja afetada pela espera, você pode continuar trabalhando enquanto a espera é resolvida: execute `/login` com essa conta ou defina a chave com `ANTHROPIC_API_KEY`1421* Se você tiver outra conta Claude ou uma chave de API que não seja afetada pela suspensão, pode continuar trabalhando enquanto a suspensão é resolvida: execute `/login` com essa conta ou defina a chave com `ANTHROPIC_API_KEY`
1411 1422
1412<h3 id="anthropic-profile-login-expired">1423<h3 id="anthropic-profile-login-expired">
1413 Login de perfil Anthropic expirado1424 Login do perfil Anthropic expirado
1414</h3>1425</h3>
1415 1426
1416Claude Code está se autenticando através de um perfil de credencial Anthropic cuja credencial de login salva expirou, e o perfil não contém nenhuma credencial de atualização que Claude Code possa usar para renová-la. Claude Code para cada solicitação localmente sem tentar novamente, porque uma tentativa novamente leria a mesma credencial expirada.1427O Claude Code está se autenticando por meio de um perfil de credenciais da Anthropic cuja credencial de login salva expirou, e o perfil não contém nenhuma credencial de renovação que o Claude Code possa usar para renová-la. O Claude Code interrompe cada requisição localmente sem tentar novamente, porque uma nova tentativa leria a mesma credencial expirada.
1417 1428
1418```text theme={null}1429```text theme={null}
1419Anthropic profile login expired · Re-authenticate your Anthropic profile1430Anthropic profile login expired · Re-authenticate your Anthropic profile
1420Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1431Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
1421```1432```
1422 1433
1423Isso aparece apenas quando a credencial ativa vem de um perfil de credencial Anthropic, um que você seleciona com a variável de ambiente `ANTHROPIC_PROFILE`, que Claude Code descobre como o perfil ativo em seu diretório de configuração Anthropic, ou que Claude Code escreveu quando você [se conectou sem uma chave de API](/docs/pt/authentication#sign-in-without-an-api-key). Sessões que se autenticam com uma chave de API, um token de portador como `ANTHROPIC_AUTH_TOKEN` ou um provedor de terceiros nunca veem essa mensagem.1434Isso aparece apenas quando a credencial ativa vem de um perfil de credenciais da Anthropic: um que você seleciona com a variável de ambiente `ANTHROPIC_PROFILE`, que o Claude Code descobre como o perfil ativo no seu diretório de configuração da Anthropic, ou que o Claude Code gravou quando você [entrou sem uma chave de API](/docs/pt/authentication#sign-in-without-an-api-key). Sessões que se autenticam com uma chave de API, um token bearer como `ANTHROPIC_AUTH_TOKEN` ou um provedor de terceiros nunca veem esta mensagem.
1424 1435
1425Em uma máquina que [oferece a conexão sem chave](/docs/pt/authentication#sign-in-without-an-api-key), execute `/login`, escolha a conta Anthropic Console e conecte-se novamente para renovar um perfil que a conexão Console sem chave ou o `ant auth login` do CLI da Plataforma Claude escreveu. Claude Code substitui a credencial expirada nesse perfil. Para um perfil de federação ou um que outra ferramenta criou, `/login` não renova a credencial. Qual forma você vê depende se você selecionou o perfil ou Claude Code o descobriu:1436Em uma máquina que [oferece o login sem chave](/docs/pt/authentication#sign-in-without-an-api-key), execute `/login`, escolha a conta do Anthropic Console e entre novamente para renovar um perfil que o login sem chave do Console ou o `ant auth login` da CLI da Claude Platform gravou. O Claude Code substitui a credencial expirada nesse perfil. Para um perfil de federação ou um criado por outra ferramenta, `/login` não renova a credencial. A forma que você vê depende de você ter selecionado o perfil ou de o Claude Code tê-lo descoberto:
1426 1437
1427* Quando você define `ANTHROPIC_PROFILE` explicitamente, a mensagem termina com `Re-authenticate your Anthropic profile`.1438* Quando você define `ANTHROPIC_PROFILE` explicitamente, a mensagem termina com `Re-authenticate your Anthropic profile`.
1428* Quando Claude Code descobriu o perfil do seu diretório de configuração, a mensagem oferece `/login`, porque Claude Code dá precedência a um `/login` funcional sobre o perfil descoberto e então se autentica com sua conta claude.ai ou Console. Antes da v2.1.234, Claude Code mostrava o formulário `Re-authenticate your Anthropic profile` neste caso também.1439* Quando o Claude Code descobriu o perfil a partir do seu diretório de configuração, a mensagem oferece `/login`, porque o Claude Code dá a um `/login` funcional precedência sobre o perfil descoberto e então se autentica com sua conta claude.ai ou do Console. Antes da v2.1.234, o Claude Code mostrava a forma `Re-authenticate your Anthropic profile` nesse caso também.
1429 1440
1430**O que fazer:**1441**O que fazer:**
1431 1442
1432* Conecte-se ao perfil novamente e tente novamente: em uma máquina que [oferece a conexão sem chave](/docs/pt/authentication#sign-in-without-an-api-key), execute `/login` e escolha a conta Anthropic Console para um perfil que a conexão Console sem chave ou o `ant auth login` do CLI da Plataforma Claude escreveu; para outros perfis, use a ferramenta que os criou1443* Entre no perfil novamente e tente outra vez: em uma máquina que [oferece o login sem chave](/docs/pt/authentication#sign-in-without-an-api-key), execute `/login` e escolha a conta do Anthropic Console para um perfil que o login sem chave do Console ou o `ant auth login` da CLI da Claude Platform gravou; para outros perfis, use a ferramenta que os criou
1433* Se um administrador provisionou a credencial do perfil, peça a ele para emitir uma nova1444* Se um administrador provisionou a credencial do perfil, peça que ele emita uma nova
1434* Execute `/status` para confirmar a fonte de credencial ativa e o nome do perfil1445* Execute `/status` para confirmar a fonte de credencial ativa e o nome do perfil
1435* Para parar de usar o perfil, desdefina `ANTHROPIC_PROFILE` se você o definiu, depois autentique-se de outra forma, como `/login` ou `ANTHROPIC_API_KEY`1446* Para parar de usar o perfil, remova a definição de `ANTHROPIC_PROFILE` se você a definiu e depois autentique-se de outra forma, como `/login` ou `ANTHROPIC_API_KEY`
1436 1447
1437<h3 id="oauth-scope-requirement">1448<h3 id="oauth-scope-requirement">
1438 Requisito de escopo OAuth1449 Requisito de escopo OAuth
1439</h3>1450</h3>
1440 1451
1441O token armazenado é anterior a um escopo de permissão que um recurso mais novo precisa:1452O token armazenado é anterior a um escopo de permissão de que um recurso mais recente precisa:
1442 1453
1443```text theme={null}1454```text theme={null}
1444OAuth token does not meet scope requirement: user:profile1455OAuth token does not meet scope requirement: user:profile
1446 1457
1447**O que fazer:**1458**O que fazer:**
1448 1459
1449* Execute `/login` para obter um novo token com os escopos atuais. Você não precisa fazer logout primeiro.1460* Execute `/login` para obter um novo token com os escopos atuais. Você não precisa fazer logout antes.
1450 1461
1451<h3 id="claude-ai-rejected-the-session-token">1462<h3 id="claude-ai-rejected-the-session-token">
1452 claude.ai rejeitou o token da sessão1463 O claude.ai rejeitou o token de sessão
1453</h3>1464</h3>
1454 1465
1455Uma solicitação de [conector claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) falhou porque claude.ai rejeitou o token do seu login Claude Code. O token rejeitado é seu login, não a autorização própria do conector em claude.ai, portanto, autorizar o conector novamente não o resolve. Em `/mcp`, o conector mostra como `session token rejected` e sua visualização de detalhes lê:1466Uma requisição de um [conector do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) falhou porque o claude.ai rejeitou o token do seu login do Claude Code. O token rejeitado é o seu login, não a autorização própria do conector no claude.ai, portanto autorizar o conector novamente não resolve o problema. Em `/mcp`, o conector aparece como `session token rejected` e sua visualização de detalhes diz:
1456 1467
1457```text theme={null}1468```text theme={null}
1458claude.ai rejected the session token. Run /login, then reconnect.1469claude.ai rejected the session token. Run /login, then reconnect.
1460 1471
1461**O que fazer:**1472**O que fazer:**
1462 1473
1463* Execute `/login` para se conectar novamente1474* Execute `/login` para entrar novamente
1464* Reconecte o conector de `/mcp` ou execute `/mcp reconnect <server>`. Reconectar antes de se conectar novamente deixa o conector no mesmo estado. A opção **Reconnect** do painel `/mcp` relata `your claude.ai session token was rejected`; o formulário digitado `/mcp reconnect <server>` relata uma reconexão bem-sucedida mesmo que o token ainda seja rejeitado.1475* Reconecte o conector a partir de `/mcp`, ou execute `/mcp reconnect <server>`. Reconectar antes de entrar novamente deixa o conector no mesmo estado. A opção **Reconnect** do painel `/mcp` relata `your claude.ai session token was rejected`; a forma digitada `/mcp reconnect <server>` relata uma reconexão bem-sucedida mesmo que o token ainda seja rejeitado.
1465 1476
1466Antes da v2.1.222, Claude Code marcava o conector como precisando de autenticação, o que apontava você para o fluxo de autorização do conector mesmo que completá-lo não resolvesse o estado.1477Antes da v2.1.222, o Claude Code marcava o conector como precisando de autenticação, o que direcionava você para o fluxo de autorização do conector, embora concluí-lo não resolvesse o estado.
1467 1478
1468<h3 id="mcp-server-needs-you-to-sign-in-again">1479<h3 id="mcp-server-needs-you-to-sign-in-again">
1469 Servidor MCP precisa que você se conecte novamente1480 O servidor MCP precisa que você entre novamente
1470</h3>1481</h3>
1471 1482
1472Um [servidor MCP](/docs/pt/mcp) remoto rejeitou a credencial em uma chamada de ferramenta no meio da sessão, geralmente porque uma conexão ou token expirou ou porque o token carece de uma permissão que a ferramenta precisa. A chamada de ferramenta falha e `/mcp` marca o servidor como [precisando de autenticação](/docs/pt/mcp#authenticate-with-remote-mcp-servers).1483Um [servidor MCP](/docs/pt/mcp) remoto rejeitou a credencial em uma chamada de ferramenta no meio da sessão, geralmente porque um login ou token expirou ou porque o token não tem uma permissão de que a ferramenta precisa. A chamada de ferramenta falha, e `/mcp` marca o servidor como [precisando de autenticação](/docs/pt/mcp#authenticate-with-remote-mcp-servers).
1473 1484
1474Para um servidor que você se conecta a partir de Claude Code, incluindo um conector claude.ai, a conexão expirou ou foi revogada:1485Para um servidor no qual você entra a partir do Claude Code, incluindo um conector do claude.ai, o login expirou ou foi revogado:
1475 1486
1476```text theme={null}1487```text theme={null}
1477MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1488MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)
1478```1489```
1479 1490
1480Execute `/mcp`, selecione o servidor e conecte-se novamente a partir de seu menu.1491Execute `/mcp`, selecione o servidor e entre novamente a partir do menu dele.
1481 1492
1482Para um servidor configurado com um script [`headersHelper`](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication), Claude Code já reexecutou o helper e tentou novamente a chamada uma vez antes de mostrar isso:1493Para um servidor configurado com um script [`headersHelper`](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication), o Claude Code já executou o helper novamente e tentou a chamada novamente uma vez antes de mostrar isto:
1483 1494
1484```text theme={null}1495```text theme={null}
1485MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)1496MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)
1486```1497```
1487 1498
1488Verifique se o helper retorna uma credencial que o servidor aceita, depois reconecte de `/mcp`, que executa o helper novamente.1499Verifique se o helper retorna uma credencial que o servidor aceita e depois reconecte a partir de `/mcp`, que executa o helper novamente.
1489 1500
1490Para um servidor com um cabeçalho `Authorization` estático em sua configuração:1501Para um servidor com um cabeçalho `Authorization` estático em sua configuração:
1491 1502
1493MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)1504MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
1494```1505```
1495 1506
1496Atualize o valor do cabeçalho onde o servidor está configurado, depois reconecte de `/mcp`.1507Atualize o valor do cabeçalho onde o servidor está configurado e depois reconecte a partir de `/mcp`.
1497 1508
1498Antes da v2.1.273, a conexão expirada, `headersHelper` e os casos de cabeçalho `Authorization` todos mostravam `MCP server "<name>" requires re-authorization (token expired)`.1509Antes da v2.1.273, os casos de login expirado, `headersHelper` e cabeçalho `Authorization` mostravam todos `MCP server "<name>" requires re-authorization (token expired)`.
1499 1510
1500Um servidor também pode recusar uma chamada de ferramenta com HTTP 403 `insufficient_scope` para pedir que você autorize um escopo, às vezes um que seu token já lista. A mensagem nomeia esse escopo:1511Um servidor também pode recusar uma chamada de ferramenta com HTTP 403 `insufficient_scope` para pedir que você autorize um escopo, às vezes um que seu token já lista. A mensagem nomeia esse escopo:
1501 1512
1503MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate1514MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate
1504```1515```
1505 1516
1506Execute `/mcp`, selecione o servidor e autentique-se novamente a partir de seu menu.1517Execute `/mcp`, selecione o servidor e autentique-se novamente a partir do menu dele.
1507 1518
1508Quando a configuração do servidor não define [`oauth.scopes`](/docs/pt/mcp#restrict-oauth-scopes) nem [`authServerMetadataUrl`](/docs/pt/mcp#override-oauth-metadata-discovery), Claude Code solicita o escopo que o servidor nomeou. Com qualquer configuração, Claude Code solicita os escopos dessa configuração. Se você fixou `oauth.scopes`, adicione o escopo ausente a essa lista antes de se autenticar novamente.1519Quando a configuração do servidor não define nem [`oauth.scopes`](/docs/pt/mcp#restrict-oauth-scopes) nem [`authServerMetadataUrl`](/docs/pt/mcp#override-oauth-metadata-discovery), o Claude Code solicita o escopo que o servidor nomeou. Com qualquer uma dessas configurações, o Claude Code solicita os escopos dessa configuração. Se você fixou `oauth.scopes`, adicione o escopo ausente a essa lista antes de se autenticar novamente.
1509 1520
1510Antes da v2.1.274, este caso mostrava a mensagem `needs you to sign in again`, e antes da v2.1.273 mostrava `requires re-authorization (token expired)` como os outros casos.1521Antes da v2.1.274, este caso mostrava a mensagem `needs you to sign in again`, e antes da v2.1.273 mostrava `requires re-authorization (token expired)` como os outros casos.
1511 1522
1512<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">1523<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">
1513 URL do servidor MCP está faltando ou não é uma URL válida1524 A URL do servidor MCP está ausente ou não é uma URL válida
1514</h3>1525</h3>
1515 1526
1516Claude Code recusou iniciar um login OAuth para um servidor MCP remoto porque a `url` configurada do servidor não é analisada como uma URL. A menos que Claude Code tenha um problema de configuração mais específico para relatar para o servidor, executar [`claude mcp login <name>`](/docs/pt/mcp#authenticate-from-the-command-line) no seu shell imprime a recusa como:1527O Claude Code se recusou a iniciar um login OAuth para um servidor MCP remoto porque a `url` configurada do servidor não é interpretada como uma URL. A menos que o Claude Code tenha um problema de configuração mais específico a relatar para o servidor, executar [`claude mcp login <name>`](/docs/pt/mcp#authenticate-from-the-command-line) no seu shell imprime a recusa como:
1517 1528
1518```text theme={null}1529```text theme={null}
1519Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.1530Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.
1521 1532
1522**O que fazer:**1533**O que fazer:**
1523 1534
1524* Defina a entrada `url` para o endpoint real do servidor onde o servidor está configurado, ou defina a variável de ambiente que sua referência [`${VAR}`](/docs/pt/mcp#environment-variable-expansion-in-mcp-json) nomeia, depois execute a conexão novamente.1535* Defina a `url` da entrada como o endpoint real do servidor onde o servidor está configurado, ou defina a variável de ambiente que sua [referência `${VAR}`](/docs/pt/mcp#environment-variable-expansion-in-mcp-json) nomeia, e depois execute o login novamente.
1525 1536
1526<h3 id="issuer-mismatch-in-authorization-response">1537<h3 id="issuer-mismatch-in-authorization-response">
1527 Incompatibilidade de emissor na resposta de autorização1538 Incompatibilidade de emissor na resposta de autorização
1528</h3>1539</h3>
1529 1540
1530Durante um [login OAuth MCP](/docs/pt/mcp#authenticate-with-remote-mcp-servers), o servidor de autorização redirecionou de volta para Claude Code com um parâmetro `iss` que não nomeia o emissor que Claude Code esperava dos metadados OAuth do servidor. Um emissor errado nesta etapa é como um ataque de mistura de servidor de autorização se parece, portanto, Claude Code falha a conexão em vez de trocar o código de autorização. Claude Code mostra o erro no menu do servidor `/mcp` após a conexão do navegador:1541Durante um [login OAuth do MCP](/docs/pt/mcp#authenticate-with-remote-mcp-servers), o servidor de autorização redirecionou de volta para o Claude Code com um parâmetro `iss` que não nomeia o emissor que o Claude Code esperava com base nos metadados OAuth do servidor. Um emissor incorreto nesta etapa é a aparência de um ataque de confusão de servidor de autorização (mix-up), então o Claude Code faz o login falhar em vez de trocar o código de autorização. O Claude Code mostra o erro no menu do servidor em `/mcp` após o login pelo navegador:
1531 1542
1532```text theme={null}1543```text theme={null}
1533Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1544Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
1534```1545```
1535 1546
1536`expected` é o emissor dos metadados OAuth do servidor, e `received` é o valor `iss` que o redirecionamento carregava. Uma conexão cujo redirecionamento não carrega nenhum parâmetro `iss` passa na verificação, a menos que os metadados do servidor definam `authorization_response_iss_parameter_supported`, nesse caso Claude Code falha a conexão.1547`expected` é o emissor dos metadados OAuth do servidor, e `received` é o valor `iss` que o redirecionamento trouxe. Um login cujo redirecionamento não traz nenhum parâmetro `iss` passa na verificação, a menos que os metadados do servidor definam `authorization_response_iss_parameter_supported`; nesse caso, o Claude Code faz o login falhar.
1537 1548
1538**O que fazer:**1549**O que fazer:**
1539 1550
1540* Tente a conexão novamente de `/mcp`1551* Tente o login novamente a partir de `/mcp`
1541* Se o erro se repetir, relate-o ao operador do servidor. A correção é do lado do servidor: o servidor de autorização deve retornar o mesmo emissor no parâmetro `iss` que ele anuncia em seus metadados1552* Se o erro se repetir, relate-o ao operador do servidor. A correção é do lado do servidor: o servidor de autorização deve retornar no parâmetro `iss` o mesmo emissor que anuncia em seus metadados
1542* Para conectar enquanto o servidor está sendo corrigido, inicie Claude Code com [`MCP_SDK_GENERATION=v1`](/docs/pt/env-vars), cujo [runtime](/docs/pt/mcp#mcp-client-runtimes) não executa essa verificação. Isso remove uma proteção contra ataques de mistura, portanto, prefira a correção do lado do servidor1553* Para se conectar enquanto o servidor está sendo corrigido, inicie o Claude Code com [`MCP_SDK_GENERATION=v1`](/docs/pt/env-vars), cujo [runtime](/docs/pt/mcp#mcp-client-runtimes) não executa essa verificação. Isso remove uma proteção contra ataques de mix-up, então prefira a correção do lado do servidor
1543 1554
1544Antes da v2.1.232, Claude Code usava o runtime v2 apenas em um lançamento gradual ou quando você definia `MCP_SDK_GENERATION=v2`.1555Antes da v2.1.232, o Claude Code usava o runtime v2 apenas em uma implantação gradual ou quando você definia `MCP_SDK_GENERATION=v2`.
1545 1556
1546<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">1557<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">
1547 Recusando enviar credenciais para endpoint de token não-https1558 Recusa em enviar credenciais para endpoint de token não https
1548</h3>1559</h3>
1549 1560
1550No [runtime v2](/docs/pt/mcp#mcp-client-runtimes), Claude Code envia uma solicitação de token [OAuth MCP](/docs/pt/mcp#authenticate-with-remote-mcp-servers) apenas para um endpoint de token servido sobre HTTPS ou em `localhost`, `127.0.0.1` ou `::1`. Esta mensagem significa que o endpoint de token do servidor não é nenhum desses, portanto, Claude Code parou antes de enviar a solicitação. Isso acontece após a conexão do navegador, portanto, a etapa do navegador tem sucesso primeiro, e novamente sempre que Claude Code atualiza o token do servidor.1561No [runtime v2](/docs/pt/mcp#mcp-client-runtimes), o Claude Code envia uma requisição de token do [OAuth do MCP](/docs/pt/mcp#authenticate-with-remote-mcp-servers) apenas para um endpoint de token servido por HTTPS ou em `localhost`, `127.0.0.1` ou `::1`. Esta mensagem significa que o endpoint de token do servidor não é nenhum deles, então o Claude Code parou antes de enviar a requisição. Isso acontece após o login pelo navegador, então a etapa do navegador é bem-sucedida primeiro, e novamente sempre que o Claude Code renova o token do servidor.
1551 1562
1552Em sua forma completa, a mensagem vem do SDK MCP e cita o endpoint de token que recusou. No log de depuração, segue `Error during auth completion:` para uma conexão ou `Token refresh failed:` para uma atualização. No seu shell, `claude mcp login <name>` o imprime após `Couldn't complete authentication for "<name>":`, e em uma sessão, `/mcp` o mostra sob o menu do servidor:1563Em sua forma completa, a mensagem vem do MCP SDK e cita o endpoint de token que ele recusou. No log de depuração, ela aparece após `Error during auth completion:` para um login ou `Token refresh failed:` para uma renovação. No seu shell, `claude mcp login <name>` a imprime após `Couldn't complete authentication for "<name>":`, e em uma sessão, `/mcp` a mostra no menu do servidor:
1553 1564
1554```text theme={null}1565```text theme={null}
1555Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).1566Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).
1556```1567```
1557 1568
1558Claude Code trata uma URL de servidor que tem uma string de consulta ou um segmento de caminho longo e aleatório como possivelmente secreto. Para tal servidor, ele redige os erros de conexão que o SDK MCP levanta antes de mostrá-los ou registrá-los. Este erro então lê como um nome curto que pode mudar entre versões, como `io`, seguido por `from the MCP SDK for` e a URL do servidor redigida. Outros erros do SDK MCP assumem a mesma forma lá. A mensagem redigida pode ser este erro apenas quando o endpoint de token do servidor é `http://` simples em um endereço diferente de `localhost`, `127.0.0.1` ou `::1`.1569O Claude Code trata uma URL de servidor que tem uma query string ou um segmento de caminho longo com aparência aleatória como possivelmente secreta. Para esse servidor, ele oculta os erros de login que o MCP SDK gera antes de mostrá-los ou registrá-los em log. Esse erro então aparece como um nome curto que pode mudar entre versões, como `io`, seguido de `from the MCP SDK for` e a URL do servidor ocultada. Outros erros do MCP SDK assumem a mesma forma nesse caso. A mensagem ocultada pode ser este erro apenas quando o endpoint de token do servidor é `http://` simples em um endereço diferente de `localhost`, `127.0.0.1` ou `::1`.
1559 1570
1560**O que fazer:**1571**O que fazer:**
1561 1572
1562* Sirva esse endpoint de token sobre HTTPS, por exemplo, colocando o servidor atrás de um proxy reverso ou túnel que termina TLS e configurando o servidor para anunciar o endereço `https://`1573* Sirva esse endpoint de token por HTTPS, por exemplo colocando o servidor atrás de um proxy reverso ou túnel que termine o TLS e configurando o servidor para anunciar o endereço `https://`
1563* Para conectar sem alterar o servidor, inicie Claude Code com [`MCP_SDK_GENERATION=v1`](/docs/pt/env-vars), cujo [runtime](/docs/pt/mcp#mcp-client-runtimes) não aplica essa regra e envia a solicitação de token sobre HTTP simples. Essa escolha dura até você sair e se aplica a cada servidor. O runtime v1 também pula a [verificação de emissor](#issuer-mismatch-in-authorization-response), portanto, prefira servir o endpoint sobre HTTPS1574* Para se conectar sem alterar o servidor, inicie o Claude Code com [`MCP_SDK_GENERATION=v1`](/docs/pt/env-vars), cujo [runtime](/docs/pt/mcp#mcp-client-runtimes) não aplica essa regra e envia a requisição de token por HTTP simples. Essa escolha dura até você sair e se aplica a todos os servidores. O runtime v1 também ignora a [verificação do emissor](#issuer-mismatch-in-authorization-response), então prefira servir o endpoint por HTTPS
1564 1575
1565<h3 id="aws-credentials-expired-or-invalid">1576<h3 id="aws-credentials-expired-or-invalid">
1566 Credenciais AWS expiradas ou inválidas1577 Credenciais AWS expiradas ou inválidas
1567</h3>1578</h3>
1568 1579
1569Seu token de sessão AWS expirou ou foi rejeitado. Esta mensagem 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.1580Seu token de sessão AWS expirou ou foi rejeitado. Esta mensagem aparece em um 401 da [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.
1570 1581
1571A dica de ação no meio varia com sua configuração. A parte estável é o `AWS credentials expired or invalid` inicial:1582A dica de ação no meio varia de acordo com sua configuração. A parte estável é o início `AWS credentials expired or invalid`:
1572 1583
1573```text theme={null}1584```text theme={null}
1574AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...1585AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
1575```1586```
1576 1587
1577Antes da v2.1.273, essa mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.1588Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.
1578 1589
1579**O que fazer:**1590**O que fazer:**
1580 1591
1581* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador1592* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é o dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
1582* Se [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) estiver definido, execute o comando nomeado na mensagem, como `aws sso login --profile myprofile`, em outro terminal e complete a conexão do navegador, depois tente novamente. Caso contrário, atualize a credencial AWS que você usa: sua conexão SSO, chaves de acesso, chave de API ou token de proxy1593* Se [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) estiver definido, execute o comando nomeado na mensagem, como `aws sso login --profile myprofile`, em outro terminal e conclua o login pelo navegador, depois tente novamente. Caso contrário, renove você mesmo a credencial AWS que usa: seu login SSO, chaves de acesso, chave de API ou token de proxy
1583* Com `awsAuthRefresh` definido em uma sessão interativa, você pode executar `/login`, escolher **3rd-party platform**, depois selecionar **Claude Platform on AWS · refresh credentials** em **Using 3rd-party platforms** para executar o mesmo comando sem reiniciar Claude Code. Veja [Configurar credenciais AWS](/docs/pt/claude-platform-on-aws#1-configure-aws-credentials)1594* Com `awsAuthRefresh` definido em uma sessão interativa, você pode, em vez disso, executar `/login`, escolher **3rd-party platform** e depois selecionar **Claude Platform on AWS · refresh credentials** em **Using 3rd-party platforms** para executar o mesmo comando sem reiniciar o Claude Code. Consulte [Configurar credenciais AWS](/docs/pt/claude-platform-on-aws#1-configure-aws-credentials)
1584* Se o erro se repetir após o comando de atualização ter sucesso, confirme que a identidade é válida fora de Claude Code com `aws sts get-caller-identity` no mesmo shell e perfil1595* Se o erro se repetir depois que o comando de renovação for bem-sucedido, confirme que a identidade é válida fora do Claude Code com `aws sts get-caller-identity` no mesmo shell e perfil
1585 1596
1586<h3 id="aws-authentication-failed">1597<h3 id="aws-authentication-failed">
1587 Falha na autenticação AWS1598 Falha na autenticação AWS
1588</h3>1599</h3>
1589 1600
1590Seu provedor AWS retornou um 403, ou [Amazon Bedrock](/docs/pt/amazon-bedrock) retornou um 401.1601Seu provedor AWS retornou um 403, ou o [Amazon Bedrock](/docs/pt/amazon-bedrock) retornou um 401.
1591 1602
1592Amazon 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. Claude Code não consegue distinguir essas duas causas.1603O 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 uma `AccessDeniedException` devido a uma permissão IAM ausente. O Claude Code não consegue distinguir essas duas causas.
1593 1604
1594Um 401 de Amazon Bedrock também chega aqui em vez de em [Credenciais AWS expiradas ou inválidas](#aws-credentials-expired-or-invalid), porque Amazon Bedrock não relata um token expirado como um 401. Um 401 desse endpoint geralmente vem de algo mais no caminho da solicitação, como um proxy corporativo.1605Um 401 do Amazon Bedrock também cai aqui em vez de em [Credenciais AWS expiradas ou inválidas](#aws-credentials-expired-or-invalid), porque o Amazon Bedrock não relata um token expirado como um 401. Um 401 desse endpoint normalmente vem de outra coisa no caminho da requisição, como um proxy corporativo.
1595 1606
1596Uma atualização de credencial corrige um token expirado e não consegue corrigir as outras causas, portanto, a mensagem oferece ambas:1607Uma renovação de credencial corrige um token expirado e não pode corrigir as outras causas, então a mensagem oferece ambas:
1597 1608
1598```text theme={null}1609```text theme={null}
1599AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...1610AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
1600```1611```
1601 1612
1602A dica de ação no meio varia com sua configuração. A parte estável é o `AWS authentication failed` inicial.1613A dica de ação no meio varia de acordo com sua configuração. A parte estável é o início `AWS authentication failed`.
1603 1614
1604Quando o 403 é a resposta de Amazon Bedrock de que você não tem acesso ao modelo com a ID de modelo especificada, a dica em vez disso diz que você habilite o modelo para sua conta e região no console Amazon Bedrock.1615Quando o 403 é a resposta do Amazon Bedrock de que você não tem acesso ao modelo com o ID de modelo especificado, a dica diz para habilitar o modelo para sua conta e região no console do Amazon Bedrock.
1605 1616
1606Antes da v2.1.273, essa mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.1617Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.
1607 1618
1608**O que fazer:**1619**O que fazer:**
1609 1620
1610* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador1621* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é o dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
1611* Atualize suas credenciais AWS em caso de uma credencial expirada ser a causa: execute o comando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) nomeado na mensagem quando um estiver definido, ou atualize sua conexão SSO, chaves de acesso, chave de API ou token de proxy1622* Renove suas credenciais AWS caso uma credencial expirada seja a causa: execute o comando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) nomeado na mensagem quando houver um definido, ou renove você mesmo seu login SSO, chaves de acesso, chave de API ou token de proxy
1612* Se suas credenciais estão atuais, confirme 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ão1623* Se suas credenciais estiverem atualizadas, confirme que as permissões IAM em [Configuração do 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
1613* Execute `aws sts get-caller-identity` para confirmar qual identidade suas solicitações usam1624* Execute `aws sts get-caller-identity` para confirmar qual identidade suas requisições usam
1614 1625
1615<h3 id="google-cloud-credentials-expired-or-invalid">1626<h3 id="google-cloud-credentials-expired-or-invalid">
1616 Credenciais do Google Cloud expiradas ou inválidas1627 Credenciais do Google Cloud expiradas ou inválidas
1617</h3>1628</h3>
1618 1629
1619Suas credenciais do Google Cloud para [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) expiraram ou foram rejeitadas: a solicitação retornou um 401, que é como Agent Platform relata expiração de credencial.1630Suas credenciais do Google Cloud para o [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) expiraram ou foram rejeitadas: a requisição retornou um 401, que é como o Agent Platform relata a expiração de credenciais.
1620 1631
1621A dica de ação no meio varia com sua configuração. A parte estável é o `Google Cloud credentials expired or invalid` inicial:1632A dica de ação no meio varia de acordo com sua configuração. A parte estável é o início `Google Cloud credentials expired or invalid`:
1622 1633
1623```text theme={null}1634```text theme={null}
1624Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...1635Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...
1626 1637
1627**O que fazer:**1638**O que fazer:**
1628 1639
1629* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador1640* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é o dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
1630* Se você se autenticar com credenciais padrão de aplicativo, execute o comando [`gcpAuthRefresh`](/docs/pt/google-vertex-ai#advanced-credential-configuration) nomeado na mensagem, ou `gcloud auth application-default login`, e complete a conexão, depois tente novamente1641* Se você se autentica com application default credentials, execute o comando [`gcpAuthRefresh`](/docs/pt/google-vertex-ai#advanced-credential-configuration) nomeado na mensagem, ou `gcloud auth application-default login`, e conclua o login, depois tente novamente
1631* Se você rotear através de um [gateway LLM](/docs/pt/llm-gateway) com `CLAUDE_CODE_SKIP_VERTEX_AUTH` definido, atualize o token de gateway em `ANTHROPIC_AUTH_TOKEN` ou `ANTHROPIC_CUSTOM_HEADERS`, depois tente novamente1642* Se você roteia por um [gateway de LLM](/docs/pt/llm-gateway) com `CLAUDE_CODE_SKIP_VERTEX_AUTH` definida, renove o token do gateway em `ANTHROPIC_AUTH_TOKEN` ou `ANTHROPIC_CUSTOM_HEADERS` e depois tente novamente
1632* Se você se autenticar com um arquivo de chave de conta de serviço, confirme que `GOOGLE_APPLICATION_CREDENTIALS` aponta para uma chave válida. Veja [Configurar credenciais GCP](/docs/pt/google-vertex-ai#3-configure-gcp-credentials)1643* Se você se autentica com um arquivo de chave de conta de serviço, confirme que `GOOGLE_APPLICATION_CREDENTIALS` aponta para uma chave válida. Consulte [Configurar credenciais GCP](/docs/pt/google-vertex-ai#3-configure-gcp-credentials)
1633* Se o erro se repetir após uma atualização, confirme que a identidade funciona fora de Claude Code com `gcloud auth application-default print-access-token` no mesmo shell1644* Se o erro se repetir após uma renovação, confirme que a identidade funciona fora do Claude Code com `gcloud auth application-default print-access-token` no mesmo shell
1634 1645
1635Antes da v2.1.273, um 401 de Agent Platform mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar credenciais do Google Cloud.1646Antes da v2.1.273, um 401 do Agent Platform mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não pode renovar credenciais do Google Cloud.
1636 1647
1637<h3 id="google-cloud-authentication-failed">1648<h3 id="google-cloud-authentication-failed">
1638 Falha na autenticação do Google Cloud1649 Falha na autenticação do Google Cloud
1639</h3>1650</h3>
1640 1651
1641[Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) retornou um 403, que usa para negações de autorização em vez de credenciais expiradas. Geralmente, a identidade com a qual você se autentica está faltando uma permissão IAM ou o modelo não está habilitado para seu projeto.1652O [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) retornou um 403, que ele usa para negações de autorização, e não para credenciais expiradas. Geralmente, a identidade com a qual você se autentica não tem uma permissão IAM, ou o modelo não está habilitado para seu projeto.
1642 1653
1643A dica de ação no meio varia com sua configuração. A parte estável é o `Google Cloud authentication failed` inicial:1654A dica de ação no meio varia de acordo com sua configuração. A parte estável é o início `Google Cloud authentication failed`:
1644 1655
1645```text theme={null}1656```text theme={null}
1646Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...1657Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...
1648 1659
1649**O que fazer:**1660**O que fazer:**
1650 1661
1651* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador1662* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é o dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
1652* Confirme que as funções em [Configuração IAM](/docs/pt/google-vertex-ai#iam-configuration) são concedidas à identidade com a qual você se autentica1663* Confirme que os papéis em [Configuração do IAM](/docs/pt/google-vertex-ai#iam-configuration) estão concedidos à identidade com a qual você se autentica
1653* Confirme que o modelo está habilitado para seu projeto. Veja [Solicitar acesso ao modelo](/docs/pt/google-vertex-ai#2-request-model-access)1664* Confirme que o modelo está habilitado para seu projeto. Consulte [Solicitar acesso ao modelo](/docs/pt/google-vertex-ai#2-request-model-access)
1654 1665
1655Antes da v2.1.273, um 403 de Agent Platform mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar credenciais do Google Cloud.1666Antes da v2.1.273, um 403 do Agent Platform mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não pode renovar credenciais do Google Cloud.
1656 1667
1657<h3 id="microsoft-foundry-authentication-failed">1668<h3 id="microsoft-foundry-authentication-failed">
1658 Falha na autenticação do Microsoft Foundry1669 Falha na autenticação do Microsoft Foundry
1659</h3>1670</h3>
1660 1671
1661[Microsoft Foundry](/docs/pt/microsoft-foundry) retornou um 401 ou 403: a credencial Azure na solicitação foi rejeitada, ou a identidade por trás dela não tem acesso ao recurso Foundry. `/login` não consegue cunhar credenciais Azure. A dica de ação no meio varia com sua configuração. A parte estável é o `Microsoft Foundry authentication failed` inicial:1672O [Microsoft Foundry](/docs/pt/microsoft-foundry) retornou um 401 ou 403: a credencial do Azure na requisição foi rejeitada, ou a identidade por trás dela não tem acesso ao recurso do Foundry. O `/login` não consegue gerar credenciais do Azure. A dica de ação no meio varia de acordo com a sua configuração. A parte estável é o início `Microsoft Foundry authentication failed`:
1662 1673
1663```text theme={null}1674```text theme={null}
1664Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...1675Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...
1666 1677
1667**O que fazer:**1678**O que fazer:**
1668 1679
1669* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador1680* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é o dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com o seu administrador
1670* Atualize a credencial que você configurou em [Configurar credenciais Azure](/docs/pt/microsoft-foundry#2-configure-azure-credentials): gire `ANTHROPIC_FOUNDRY_API_KEY`, cunhe um novo `ANTHROPIC_FOUNDRY_AUTH_TOKEN` ou execute `az login` para que a cadeia de credencial padrão do Microsoft Entra possa se conectar novamente1681* Atualize a credencial que você configurou em [Configurar credenciais do Azure](/docs/pt/microsoft-foundry#2-configure-azure-credentials): faça a rotação de `ANTHROPIC_FOUNDRY_API_KEY`, gere um novo `ANTHROPIC_FOUNDRY_AUTH_TOKEN` ou execute `az login` para que a cadeia de credenciais padrão do Microsoft Entra possa fazer login novamente
1671* Se a credencial está atual, confirme que a identidade tem acesso ao recurso Foundry. Veja [Configuração RBAC do Azure](/docs/pt/microsoft-foundry#azure-rbac-configuration)1682* Se a credencial estiver atualizada, confirme que a identidade tem acesso ao recurso do Foundry. Consulte [Configuração de RBAC do Azure](/docs/pt/microsoft-foundry#azure-rbac-configuration)
1672 1683
1673Antes da v2.1.273, um 401 ou 403 de Microsoft Foundry mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar credenciais Azure.1684Antes da v2.1.273, um 401 ou 403 do Microsoft Foundry exibia a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar credenciais do Azure.
1674 1685
1675<h3 id="could-not-load-aws-or-google-cloud-credentials">1686<h3 id="could-not-load-aws-or-google-cloud-credentials">
1676 Não foi possível carregar credenciais AWS ou Google Cloud1687 Não foi possível carregar as credenciais da AWS ou do Google Cloud
1677</h3>1688</h3>
1678 1689
1679Claude Code não conseguiu obter credenciais utilizáveis da cadeia de provedor de credenciais AWS ou de suas credenciais padrão de aplicativo Google na máquina em que é executado, portanto, nenhuma solicitação chegou ao seu provedor de nuvem. Claude Code limpa suas credenciais em cache e tenta novamente duas vezes antes de mostrar essa mensagem. O detalhe após o `·` nomeia a causa específica, como uma sessão SSO expirada, credenciais padrão ausentes relatadas como `Could not load the default credentials` ou uma conexão revogada relatada como `invalid_grant`:1690O Claude Code não conseguiu obter credenciais utilizáveis da cadeia de provedores de credenciais da AWS ou das suas credenciais padrão de aplicativo do Google na máquina em que é executado, portanto nenhuma requisição chegou ao seu provedor de nuvem. O Claude Code limpa suas credenciais em cache e tenta novamente duas vezes antes de exibir esta mensagem. O detalhe após o `·` indica a causa específica, como uma sessão SSO expirada, credenciais padrão de aplicativo ausentes relatadas como `Could not load the default credentials`, ou um login revogado relatado como `invalid_grant`:
1680 1691
1681```text theme={null}1692```text theme={null}
1682API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.1693API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
1683API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.1694API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
1684```1695```
1685 1696
1686Em [modo não interativo](/docs/pt/headless) com `-p` e no [Agent SDK](/docs/pt/agent-sdk/overview), o código de erro estruturado é `cloud_credential_error`. Antes da v2.1.267, a mensagem mostrava apenas o texto de detalhe após `API Error:`, e o código estruturado era `server_error` ou `unknown`.1697No [modo não interativo](/docs/pt/headless) com `-p` e no [Agent SDK](/docs/pt/agent-sdk/overview), o código de erro estruturado é `cloud_credential_error`. Antes da v2.1.267, a mensagem exibia apenas o texto de detalhe após `API Error:`, e o código estruturado era `server_error` ou `unknown`.
1687 1698
1688**O que fazer:**1699**O que fazer:**
1689 1700
1690* Execute o comando de conexão do seu provedor, como `aws sso login --profile myprofile` ou `gcloud auth application-default login`, depois tente novamente. [Credenciais Bedrock, Agent Platform ou Foundry não carregando](/docs/pt/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) mostra como confirmar as credenciais fora de Claude Code1701* Execute o comando de login do seu provedor, como `aws sso login --profile myprofile` ou `gcloud auth application-default login`, e tente novamente. [Credenciais do Bedrock, Agent Platform ou Foundry não carregam](/docs/pt/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) mostra como confirmar as credenciais fora do Claude Code
1691* Se o detalhe lê `AWS default-chain credential resolve timed out`, a cadeia travou em vez de falhar, portanto, siga [Resolução de credencial de cadeia padrão AWS expirou](#aws-default-chain-credential-resolve-timed-out)1702* Se o detalhe indicar `AWS default-chain credential resolve timed out`, a cadeia travou em vez de falhar, então siga [A resolução de credenciais da cadeia padrão da AWS atingiu o timeout](#aws-default-chain-credential-resolve-timed-out)
1692 1703
1693<h3 id="aws-default-chain-credential-resolve-timed-out">1704<h3 id="aws-default-chain-credential-resolve-timed-out">
1694 Resolução de credencial de cadeia padrão AWS expirou1705 A resolução de credenciais da cadeia padrão da AWS atingiu o timeout
1695</h3>1706</h3>
1696 1707
1697A cadeia de 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. Este tempo limite é uma causa de [Não foi possível carregar credenciais AWS ou Google Cloud](#could-not-load-aws-or-google-cloud-credentials). 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 credencial](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout) e tenta novamente antes desse erro aparecer, portanto, no momento em que você o vê, a cadeia travou em tentativas repetidas.1708A cadeia padrão de provedores de credenciais da AWS não produziu credenciais em 60 segundos, então o Claude Code interrompeu a resolução e fez a requisição falhar. Esse timeout é uma das causas de [Não foi possível carregar as credenciais da AWS ou do Google Cloud](#could-not-load-aws-or-google-cloud-credentials). A falha está na resolução local de credenciais: a requisição nunca chegou ao [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). O Claude Code limpa seu [cache de credenciais](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout) e tenta novamente antes que esse erro apareça, então, quando você o vê, a cadeia já travou em tentativas repetidas.
1698 1709
1699```text theme={null}1710```text theme={null}
1700API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.1711API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
1701```1712```
1702 1713
1703As causas comuns são um comando `credential_process` em seu perfil AWS que espera por 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.1714As causas comuns são um comando `credential_process` no seu perfil da AWS que aguarda uma entrada que não consegue receber, e um contêiner ou VM cujo serviço de metadados da instância (IMDS) nunca responde à sondagem da cadeia.
1704 1715
1705Antes da v2.1.267, a mensagem lia `API Error: AWS default-chain credential resolve timed out`.1716Antes da v2.1.267, a mensagem era `API Error: AWS default-chain credential resolve timed out`.
1706Antes da v2.1.207, uma cadeia travada deixava a solicitação esperando indefinidamente em vez de falhar.1717Antes da v2.1.207, uma cadeia travada deixava a requisição aguardando indefinidamente em vez de falhar.
1707 1718
1708**O que fazer:**1719**O que fazer:**
1709 1720
1710* 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.1721* Execute `aws sts get-caller-identity` no mesmo shell com o mesmo `AWS_PROFILE`. Se ele também travar, corrija o perfil; um comando `credential_process` que solicita entrada interativamente é uma causa comum.
1711* Complete a etapa de conexão 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 esperar por um fluxo de navegador1722* Conclua a etapa de login antes de iniciar o Claude Code, por exemplo `aws sso login --profile myprofile`
1712* Se sua cadeia executa uma conexão interativa 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)1723* Se a sua cadeia executa um login interativo que legitimamente precisa de mais de 60 segundos, como SSO com MFA por meio de um wrapper como `aws-vault`, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars)
1713 1724
1714<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1725<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">
1715 Verificação de configuração Bedrock expirou esperando por AWS1726 A verificação da configuração do Bedrock atingiu o timeout aguardando a AWS
1716</h3>1727</h3>
1717 1728
1718Uma chamada para AWS durante o [assistente de configuração Bedrock](/docs/pt/amazon-bedrock#sign-in-with-bedrock), como a busca de credencial ou a verificação de identidade, não terminou dentro do limite de 60 segundos. O assistente para de esperar e falha a etapa de verificação:1729Uma chamada à AWS durante a verificação de credenciais do [assistente de configuração do Bedrock](/docs/pt/amazon-bedrock#sign-in-with-bedrock), como a busca de credenciais ou a verificação de identidade, não terminou dentro do limite de 60 segundos. O assistente para de aguardar e faz a etapa de verificação falhar:
1719 1730
1720```text theme={null}1731```text theme={null}
1721Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.1732Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.
1722```1733```
1723 1734
1724O número reflete seu limite: 60 segundos por padrão, ou o valor que você define em [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars).1735O número reflete o seu limite: 60 segundos por padrão, ou o valor que você definiu em [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars).
1725 1736
1726As causas comuns são uma rede ou proxy que trava solicitações para AWS, incluindo a atualização de token SSO, e um helper de credencial ainda esperando por entrada que você não consegue ver. Aumente o limite apenas quando o helper legitimamente precisa de mais tempo.1737As causas comuns são uma rede ou proxy que trava requisições à AWS, incluindo a atualização do token SSO, e um auxiliar de credenciais ainda aguardando uma entrada que você não consegue ver. Aumente o limite apenas quando o auxiliar legitimamente precisar de mais tempo.
1727 1738
1728Uma única solicitação travada para AWS também pode falhar em seu próprio tempo limite por solicitação, que mostra uma mensagem mais curta na mesma etapa:1739Uma única requisição travada à AWS também pode falhar por seu próprio timeout por requisição, o que exibe uma mensagem mais curta na mesma etapa:
1729 1740
1730```text theme={null}1741```text theme={null}
1731A request to AWS timed out. Check your network and proxy settings, then try again.1742A request to AWS timed out. Check your network and proxy settings, then try again.
1732```1743```
1733 1744
1734Quando os mesmos tempos limite ocorrem na etapa de fixação de modelo, o assistente marca um modelo como `unreachable` em vez de mostrar qualquer mensagem.1745Quando os mesmos timeouts ocorrem na etapa de fixação de modelo, o assistente marca um modelo como `unreachable` em vez de exibir qualquer uma das mensagens.
1735 1746
1736**O que fazer:**1747**O que fazer:**
1737 1748
1738* Execute `aws sts get-caller-identity` no mesmo shell. Se também travar, o travamento está fora de Claude Code, em sua rede, seu proxy ou o helper de credencial em seu perfil AWS; corrija isso primeiro.1749* Execute `aws sts get-caller-identity` no mesmo shell. Se ele também travar, o travamento está fora do Claude Code, na sua rede, no seu proxy ou no auxiliar de credenciais do seu perfil da AWS; corrija isso primeiro.
1739* Complete qualquer conexão interativa antes de abrir o assistente, por exemplo `aws sso login --profile myprofile`1750* Conclua qualquer login interativo antes de abrir o assistente, por exemplo `aws sso login --profile myprofile`
1740* Se um helper de credencial em seu perfil AWS legitimamente precisa de mais de 60 segundos para solicitá-lo, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars)1751* Se um auxiliar de credenciais no seu perfil da AWS legitimamente precisar de mais de 60 segundos para solicitar sua entrada, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars)
1741 1752
1742<h3 id="cloud-gateway-session-expired">1753<h3 id="cloud-gateway-session-expired">
1743 Sessão de gateway de nuvem expirada1754 Sessão do gateway de nuvem expirada
1744</h3>1755</h3>
1745 1756
1746Você se conectou através de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) e a sessão de gateway salva nesta máquina expirou e não conseguiu ser renovada, ou o gateway não a aceita mais, por exemplo, após o [segredo JWT do gateway ser substituído](/docs/pt/claude-apps-gateway-deploy#jwt-secret-rotation). Se você vir essa linha quando inicia `claude` interativamente, a sessão abriu desconectada do gateway:1757Você fez login por meio de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), e a sessão do gateway salva nesta máquina expirou e não pôde ser renovada, ou o gateway não a aceita mais, por exemplo, depois que o [segredo JWT do gateway é substituído](/docs/pt/claude-apps-gateway-deploy#jwt-secret-rotation). Se você vir esta linha ao iniciar o `claude` interativamente, a sessão foi aberta sem login no gateway:
1747 1758
1748```text theme={null}1759```text theme={null}
1749Cloud gateway session expired — run /login to reconnect.1760Cloud gateway session expired — run /login to reconnect.
1750```1761```
1751 1762
1752A mesma linha pode aparecer no meio da sessão quando a credencial de gateway expira e Claude Code não consegue renová-la.1763A mesma linha pode aparecer no meio da sessão quando a credencial do gateway expira e o Claude Code não consegue renová-la.
1753 1764
1754Em uma execução [não interativa](/docs/pt/headless), uma sessão em segundo plano ou outra sessão desatendida, ou um subcomando `claude` diferente de `claude auth`, Claude Code sai com essa mensagem em vez disso quando o gateway não aceita mais a sessão:1765Em uma execução [não interativa](/docs/pt/headless), em uma sessão em segundo plano ou outra sessão não supervisionada, ou em um subcomando do `claude` diferente de `claude auth`, o Claude Code sai com esta mensagem quando o gateway não aceita mais a sessão:
1755 1766
1756```text theme={null}1767```text theme={null}
1757Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1768Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
1759 1770
1760**O que fazer:**1771**O que fazer:**
1761 1772
1762* Execute `/login` na sessão e complete a conexão do navegador1773* Execute `/login` na sessão e conclua o login no navegador
1763* Para um lançamento não interativo, inicie `claude` no mesmo ambiente, execute `/login`, depois reexecute seu comando1774* Para uma inicialização não interativa, inicie o `claude` no mesmo ambiente, execute `/login` e, em seguida, execute seu comando novamente
1764 1775
1765<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1776<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">
1766 Conexão expirou enquanto esperava você continuar1777 O login atingiu o timeout enquanto aguardava você continuar
1767</h3>1778</h3>
1768 1779
1769Durante uma conexão [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), o gateway nomeou a conta que se conectou, e Claude Code pediu que você a confirmasse antes de salvar a credencial. Você deixou a confirmação aberta após a expiração da própria conexão, e o gateway não emitiu nenhum token de atualização que pudesse renová-la, portanto, Claude Code não armazenou nada quando você continuou:1780Durante um login no [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), o gateway informou a conta que fez login, e o Claude Code pediu que você a confirmasse antes de salvar a credencial. Você deixou a confirmação aberta além da expiração do próprio login, e o gateway não emitiu nenhum refresh token que pudesse renová-lo, então o Claude Code não armazenou nada quando você continuou:
1770 1781
1771```text theme={null}1782```text theme={null}
1772Sign-in timed out while waiting for you to continue. Try again.1783Sign-in timed out while waiting for you to continue. Try again.
1774 1785
1775**O que fazer:**1786**O que fazer:**
1776 1787
1777* Execute `/login` novamente e confirme a conta antes da conexão expirar1788* Execute `/login` novamente e confirme a conta antes que o login expire
1778 1789
1779<h3 id="gateway-refused-the-request">1790<h3 id="gateway-refused-the-request">
1780 Gateway recusou a solicitação1791 O gateway recusou a requisição
1781</h3>1792</h3>
1782 1793
1783Você está conectado através de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) e uma solicitação retornou um 403: o gateway, ou o upstream por trás dele, recusou. Conectar-se novamente não altera uma recusa, portanto, a mensagem aponta para seu administrador de gateway:1794Você está conectado por meio de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), e uma requisição retornou um 403: o gateway, ou o upstream por trás dele, a recusou. Fazer login novamente não altera uma recusa, então a mensagem direciona você ao administrador do gateway:
1784 1795
1785```text theme={null}1796```text theme={null}
1786Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1797Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
1788 1799
1789**O que fazer:**1800**O que fazer:**
1790 1801
1791* Peça ao seu administrador de gateway para procurar a solicitação. A cauda `API Error:` carrega a recusa que o gateway retornou1802* Peça ao administrador do seu gateway para investigar a requisição. O trecho final `API Error:` contém a recusa que o gateway retornou
1792* Para administradores: uma [regra de controle de acesso](/docs/pt/claude-apps-gateway-config#http-tuning) no gateway retorna um 403 que o [log de auditoria](/docs/pt/claude-apps-gateway-deploy#logs) registra com seu motivo, e uma negação de autorização de um upstream passa através por [Mensagens de erro de Upstream](/docs/pt/claude-apps-gateway-config#upstream-error-messages)1803* Para administradores: uma [regra de controle de acesso](/docs/pt/claude-apps-gateway-config#http-tuning) no gateway retorna um 403 que o [log de auditoria](/docs/pt/claude-apps-gateway-deploy#logs) registra com seu motivo, e uma negação de autorização do upstream é repassada conforme [Mensagens de erro do upstream](/docs/pt/claude-apps-gateway-config#upstream-error-messages)
1793 1804
1794Antes da v2.1.273, um 403 em uma sessão de gateway mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, e conectar-se novamente não limpava a recusa.1805Antes da v2.1.273, um 403 em uma sessão de gateway exibia a mensagem genérica `Please run /login` ou `Failed to authenticate`, e fazer login novamente não eliminava a recusa.
1795 1806
1796<h2 id="network-and-connection-errors">1807<h2 id="network-and-connection-errors">
1797 Erros de rede e conexão1808 Erros de rede e conexão
2852 Erros de linha de comando2863 Erros de linha de comando
2853</h2>2864</h2>
2854 2865
2855Esses erros vêm do comando `claude` e seus subcomandos, de um nome de comando que você envia no prompt e de comandos como `/security-review` que reúnem contexto executando comandos shell antes de seu prompt ser executado. Eles também vêm de `/tui`, que relança a CLI.2866Esses erros vêm da linha de comando `claude` e de seus subcomandos, de um nome de comando que você envia no prompt e de comandos como `/security-review` que reúnem contexto executando comandos de shell antes que seu prompt seja executado. Eles também vêm de `/tui`, que reinicia a CLI.
2856 2867
2857<h3 id="conflict-between-bg-and-print">2868<h3 id="conflict-between-bg-and-print">
2858 Conflito entre `--bg` e `--print`2869 Conflito entre `--bg` e `--print`
2859</h3>2870</h3>
2860 2871
2861Esta 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 trabalho em background que nunca poderia ser anexado.2872Esta mensagem requer o 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 segundo plano](/docs/pt/agent-view#from-your-shell) à qual você se conecta depois com `claude agents`, enquanto `--print` é executado de forma [não interativa](/docs/pt/headless) e nunca inicia a sessão interativa à qual `claude agents` se conecta. Antes da v2.1.198, essa combinação criava silenciosamente um job em segundo plano ao qual nunca era possível se conectar.
2862 2873
2863```text theme={null}2874```text theme={null}
2864--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>'`.2875--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>'`.
2866 2877
2867**O que fazer:**2878**O que fazer:**
2868 2879
2869* Remova `-p` ou `--print`. `--bg` toma 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).2880* Remova `-p` ou `--print`. `--bg` recebe o prompt como seu argumento posicional, então `claude --bg "<task>"` é o comando completo. Consulte [Enviar novos agentes a partir do seu shell](/docs/pt/agent-view#from-your-shell).
2870* 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>"`2881* Para executar o prompt de forma não interativa e imprimir o resultado em vez de criar uma sessão em segundo plano, remova `--bg` e execute `claude -p "<task>"`
2882
2883<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">
2884 Conflito entre uma flag de system prompt e sua forma de arquivo
2885</h3>
2886
2887Você passou [`--append-subagent-system-prompt`](/docs/pt/cli-reference#cli-flags) junto com `--append-subagent-system-prompt-file` em uma única invocação de `claude`, então `claude` sai com código 1 em vez de iniciar a sessão:
2888
2889```text theme={null}
2890Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
2891```
2892
2893Antes da v2.1.283, `claude` saía da mesma forma quando você passava `--system-prompt` com `--system-prompt-file`, ou `--append-system-prompt` com `--append-system-prompt-file`, porque esses pares entravam em conflito em vez de se [combinarem](/docs/pt/cli-reference#system-prompt-flags). Nessas versões, a mensagem nomeia o par que você combinou.
2894
2895**O que fazer:**
2896
2897* Mantenha uma forma da flag e remova a outra. Para combinar um arquivo de prompt fixo com texto específico de cada execução, mescle o texto no arquivo antes de iniciar, em vez de passar as duas flags
2871 2898
2872<h3 id="invalid-agents-configuration">2899<h3 id="invalid-agents-configuration">
2873 Configuração inválida de `--agents`2900 Configuração de `--agents` inválida
2874</h3>2901</h3>
2875 2902
2876O valor que você passou para `--agents` é inválido, então `claude` sai com código 1 em vez de iniciar a sessão. Quando você passa `--safe-mode` ou define [`CLAUDE_CODE_SAFE_MODE`](/docs/pt/env-vars#variables), Claude Code ignora `--agents` completamente. Com `--resume` ou `--continue`, um valor JSON inline não é verificado e a sessão inicia; um valor lido de um arquivo é verificado a cada lançamento. Antes da v2.1.242, Claude Code iniciava a sessão mesmo assim.2903O valor que você passou para `--agents` é inválido, então `claude` sai com código 1 em vez de iniciar a sessão. Quando você passa `--safe-mode` ou define [`CLAUDE_CODE_SAFE_MODE`](/docs/pt/env-vars#variables), o Claude Code ignora `--agents` completamente. Com `--resume` ou `--continue`, um valor JSON inline não é verificado e a sessão é iniciada; um valor lido de um arquivo é verificado a cada inicialização. Antes da v2.1.242, o Claude Code iniciava a sessão mesmo assim.
2877 2904
2878```text theme={null}2905```text theme={null}
2879Error: Invalid --agents configuration:2906Error: Invalid --agents configuration:
2880<what failed>2907<what failed>
2881```2908```
2882 2909
2883O que segue a primeira linha depende de como o valor falhou. Claude Code executa essas verificações em ordem e para na primeira que falha. Se seu valor tiver dois tipos de problema, você verá o segundo apenas depois de corrigir o primeiro:2910O que vem depois da primeira linha depende de como o valor falhou. O Claude Code executa estas verificações em ordem e para na primeira que falhar. Se o seu valor tiver dois tipos de problema, você verá o segundo somente depois de corrigir o primeiro:
2884 2911
28851. Quando o valor começa com `{` mas não é analisado como JSON, ou o conteúdo de um arquivo `--agents` não é analisado, Claude Code imprime uma linha `invalid JSON:` com a mensagem do próprio analisador JSON29121. Quando o valor começa com `{` mas não é analisado como JSON, ou o conteúdo de um arquivo de `--agents` não é analisado, o Claude Code imprime uma linha `invalid JSON:` contendo a própria mensagem do analisador JSON
28862. Quando é analisado mas uma definição de agente não corresponde ao esquema para [subagentes definidos por CLI](/docs/pt/sub-agents#choose-the-subagent-scope), Claude Code imprime uma linha por problema29132. Quando é analisado, mas uma definição de agente não corresponde ao esquema de [subagentes definidos pela CLI](/docs/pt/sub-agents#choose-the-subagent-scope), o Claude Code imprime uma linha por problema
28873. Quando um nome de agente começa com `-`, Claude Code imprime `<name>: agent names must not start with '-'`29143. Quando um nome de agente começa com `-`, o Claude Code imprime `<name>: agent names must not start with '-'`
2888 2915
2889Quando há mais de 20 linhas de problema, Claude Code imprime as primeiras 20 e substitui o resto por `…and N more`.2916Quando há mais de 20 linhas de problemas, o Claude Code imprime as primeiras 20 e substitui o restante por `…and N more`.
2890 2917
2891Com `--print`, `--agents` também aceita [o caminho para um arquivo JSON](/docs/pt/sub-agents#choose-the-subagent-scope) no lugar do objeto inline. Antes da v2.1.281, `--agents` aceitava apenas JSON inline e tratava um caminho de arquivo como JSON inválido. O formulário de arquivo tem recusas próprias, impressas no lugar dessa mensagem, incluindo estas:2918Com `--print`, `--agents` também aceita [o caminho para um arquivo JSON](/docs/pt/sub-agents#choose-the-subagent-scope) no lugar do objeto inline. Antes da v2.1.281, `--agents` aceitava apenas JSON inline e tratava um caminho de arquivo como JSON inválido. A forma de arquivo tem suas próprias recusas, impressas no lugar desta mensagem, incluindo estas:
2892 2919
2893* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code leu o valor como um caminho de arquivo em uma sessão interativa. Passe as definições como JSON inline, ou adicione `-p` para lê-las de um arquivo.2920* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: o Claude Code leu o valor como um caminho de arquivo em uma sessão interativa. Passe as definições como JSON inline ou adicione `-p` para lê-las de um arquivo.
2894* **`Error: --agents file not found: <path>`**: nenhum arquivo existe naquele caminho. Um valor que não começa com `{` e não é JSON válido é lido como um caminho, então JSON inline que seu shell danificou pode falhar dessa forma também. Verifique o caminho ou as aspas e execute o comando novamente.2921* **`Error: --agents file not found: <path>`**: não existe nenhum arquivo nesse caminho. Um valor que não começa com `{` e não é JSON válido é lido como um caminho, então um JSON inline que seu shell corrompeu também pode falhar dessa forma. Verifique o caminho ou as aspas e execute o comando novamente.
2895 2922
2896**O que fazer:**2923**O que fazer:**
2897 2924
2898* Corrija cada problema que a mensagem lista, depois execute o comando novamente. Veja [os campos que um subagente definido por CLI toma](/docs/pt/sub-agents#choose-the-subagent-scope).2925* Corrija cada problema listado na mensagem e execute o comando novamente. Consulte [os campos que um subagente definido pela CLI aceita](/docs/pt/sub-agents#choose-the-subagent-scope).
2899 2926
2900<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">2927<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">
2901 Sessões em nuvem não podem ser criadas a partir de uma sessão `--restricted`2928 Sessões na nuvem não podem ser criadas a partir de uma sessão `--restricted`
2902</h3>2929</h3>
2903 2930
2904Quando você inicia uma sessão com [`--restricted`](/docs/pt/cli-reference#cli-flags), Claude Code recusa criar [sessões em nuvem](/docs/pt/claude-code-on-the-web#from-terminal-to-cloud) a partir dela, porque a nova sessão seria executada fora do processo restrito e não aplicaria o modo restrito. Claude Code recusa no cliente, antes de contatar o servidor, então nenhuma sessão em nuvem é criada:2931Quando você inicia uma sessão com [`--restricted`](/docs/pt/cli-reference#cli-flags), o Claude Code se recusa a criar [sessões na nuvem](/docs/pt/claude-code-on-the-web#from-terminal-to-cloud) a partir dela, porque a nova sessão seria executada fora do processo restrito e não aplicaria o modo restrito. O Claude Code recusa no cliente, antes de contatar o servidor, então nenhuma sessão na nuvem é criada:
2905 2932
2906```text theme={null}2933```text theme={null}
2907Cloud sessions cannot be created from a --restricted session: they would not enforce it.2934Cloud sessions cannot be created from a --restricted session: they would not enforce it.
2910**O que fazer:**2937**O que fazer:**
2911 2938
2912* Execute a tarefa localmente na sessão restrita2939* Execute a tarefa localmente na sessão restrita
2913* Se você controlar como a sessão foi iniciada, inicie uma nova sessão `claude` sem `--restricted` e crie a sessão em nuvem a partir daí2940* Se você controla como a sessão foi iniciada, inicie uma nova sessão `claude` sem `--restricted` e crie a sessão na nuvem a partir dela
2914 2941
2915Antes da v2.1.248, Claude Code não tinha a flag `--restricted`; versões anteriores rejeitam a flag em si com um erro de opção desconhecida.2942Antes da v2.1.248, o Claude Code não tinha a flag `--restricted`; versões anteriores rejeitam a própria flag com um erro de opção desconhecida.
2916 2943
2917<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">2944<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">
2918 Sessões em nuvem estão desabilitadas pela política da sua organização2945 Sessões na nuvem estão desativadas pela política da sua organização
2919</h3>2946</h3>
2920 2947
2921A política `allow_remote_sessions` da sua organização está desativada, então [sessões em nuvem](/docs/pt/claude-code-on-the-web) e os comandos que as usam não estão disponíveis:2948A política `allow_remote_sessions` da sua organização está desativada, então as [sessões na nuvem](/docs/pt/claude-code-on-the-web) e os comandos que as utilizam não estão disponíveis:
2922 2949
2923```text theme={null}2950```text theme={null}
2924Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.2951Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
2925```2952```
2926 2953
2927A mensagem aparece quando você [cria uma sessão em nuvem a partir do terminal](/docs/pt/claude-code-on-the-web#from-terminal-to-cloud) e quando você envia um comando que precisa de sessões em nuvem, como `/teleport`, `/remote-env` ou `/web-setup`. Antes da v2.1.268, enviar um desses comandos retornava [`Unknown command`](#unknown-command) em vez disso.2954A mensagem aparece quando você [cria uma sessão na nuvem a partir do terminal](/docs/pt/claude-code-on-the-web#from-terminal-to-cloud) e quando você envia um comando que precisa de sessões na nuvem, como `/teleport`, `/remote-env` ou `/web-setup`. Antes da v2.1.268, enviar um desses comandos retornava [`Unknown command`](#unknown-command) em vez disso.
2928 2955
2929Esta é uma política de organização do lado do servidor, então não pode ser substituída por configurações locais, variáveis de ambiente ou flags de CLI.2956Esta é uma política de organização do lado do servidor, então não pode ser sobrescrita por configurações locais, variáveis de ambiente ou flags da CLI.
2930 2957
2931Se Claude Code ainda não carregou a política da sua organização ou não conseguir buscá-la, esses comandos respondem `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.` em vez disso.2958Se o Claude Code ainda não carregou a política da sua organização ou não consegue obtê-la, esses comandos respondem `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.` em vez disso.
2932 2959
2933**O que fazer:**2960**O que fazer:**
2934 2961
2935* Peça a um [Owner](/docs/pt/server-managed-settings#access-control) em sua organização para habilitar sessões em nuvem nas configurações de administrador do Claude Code em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)2962* Peça a um [Owner](/docs/pt/server-managed-settings#access-control) da sua organização para ativar as sessões na nuvem nas configurações de administração do Claude Code em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
2936* Se a mensagem disser que não conseguiu verificar a política, verifique sua conexão de rede, depois reinicie Claude Code e tente novamente2963* Se a mensagem disser que não foi possível verificar a política, verifique sua conexão de rede, reinicie o Claude Code e tente novamente
2937 2964
2938<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2965<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
2939 O valor `--json-schema` não é um JSON Schema válido2966 O valor de `--json-schema` não é um JSON Schema válido
2940</h3>2967</h3>
2941 2968
2942O esquema que você passou para [`--json-schema`](/docs/pt/cli-reference#cli-flags) em [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 esquema inválido produzia saída não estruturada sem erro, e qualquer esquema que usasse a palavra-chave `format` era tratado como inválido.2969O esquema 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 de JSON Schema, então `claude` sai com código 1 em vez de executar o prompt. Antes da v2.1.205, um esquema inválido produzia uma saída não estruturada sem erro, e qualquer esquema que usasse a palavra-chave `format` era tratado como inválido.
2943 2970
2944```text theme={null}2971```text theme={null}
2945Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values2972Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
2946```2973```
2947 2974
2948O texto após o segundo dois-pontos é o diagnóstico do validador e nomeia a palavra-chave ou localização que falhou. Esquemas que usam a palavra-chave `format`, como `"format": "email"`, são válidos: Claude Code aceita `format` como uma anotação e não a aplica.2975O texto após os segundos dois-pontos é o diagnóstico do validador e nomeia a palavra-chave ou o local que falhou. Esquemas que usam a palavra-chave `format`, como `"format": "email"`, são válidos: o Claude Code aceita `format` como uma anotação e não a aplica.
2949 2976
2950Claude Code executa duas verificações antes da compilação do esquema: rejeita um valor que não é JSON analisável com `Error: --json-schema is not valid JSON`, e JSON válido que não é um objeto com `Error: --json-schema must be a JSON object`.2977O Claude Code executa duas verificações antes da compilação do esquema: rejeita um valor que não é JSON analisável com `Error: --json-schema is not valid JSON`, e um JSON válido que não é um objeto com `Error: --json-schema must be a JSON object`.
2951 2978
2952**O que fazer:**2979**O que fazer:**
2953 2980
2954* Corrija a parte do esquema que o diagnóstico nomeia, depois execute o comando novamente2981* Corrija a parte do esquema que o diagnóstico nomeia e execute o comando novamente
2955* Veja [Get structured output](/docs/pt/headless#get-structured-output) para um esquema funcionando e comando2982* Consulte [Obter saída estruturada](/docs/pt/headless#get-structured-output) para ver um esquema e um comando que funcionam
2956 2983
2957<h3 id="settings-file-exceeds-the-2mib-limit">2984<h3 id="settings-file-exceeds-the-2mib-limit">
2958 Arquivo de configurações excede o limite de 2MiB2985 O arquivo de configurações excede o limite de 2MiB
2959</h3>2986</h3>
2960 2987
2961O arquivo que você passou para [`--settings`](/docs/pt/cli-reference#cli-flags) é maior que 2 MiB, então `claude` sai com código 1 na inicialização em vez de carregá-lo. Antes da v2.1.214, Claude Code lia o arquivo sem verificação de tamanho, e um arquivo de vários gigabytes ou um arquivo de dispositivo como `/dev/zero` crescia em memória sem limite.2988O arquivo que você passou para [`--settings`](/docs/pt/cli-reference#cli-flags) é maior que 2 MiB, então `claude` sai com código 1 na inicialização em vez de carregá-lo. Antes da v2.1.214, o Claude Code lia o arquivo sem verificação de tamanho, e um arquivo de vários gigabytes ou um arquivo de dispositivo como `/dev/zero` fazia a memória crescer sem limite.
2962 2989
2963```text theme={null}2990```text theme={null}
2964Error: Settings file exceeds the 2MiB limit: /path/to/settings.json2991Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
2965```2992```
2966 2993
2967Claude Code rejeita um caminho `--settings` que não é um arquivo regular da mesma forma: um dispositivo, FIFO ou socket relata `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` seguido do caminho, e um diretório relata um motivo `EISDIR`.2994O Claude Code rejeita da mesma forma um caminho de `--settings` que não seja um arquivo regular: um dispositivo, FIFO ou socket reporta `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` seguido do caminho, e um diretório reporta um motivo `EISDIR`.
2968 2995
2969**O que fazer:**2996**O que fazer:**
2970 2997
2971* Aponte `--settings` para um arquivo JSON de configurações regular com menos de 2 MiB. Veja [Settings](/docs/pt/settings) para o formato.2998* Aponte `--settings` para um arquivo JSON de configurações regular com menos de 2 MiB. Consulte [Configurações](/docs/pt/settings) para ver o formato.
2972 2999
2973<h3 id="the-current-directory-no-longer-exists">3000<h3 id="the-current-directory-no-longer-exists">
2974 O diretório atual não existe mais3001 O diretório atual não existe mais
2975</h3>3002</h3>
2976 3003
2977Você iniciou `claude` a partir de um diretório que foi deletado ou movido depois que seu shell entrou nele, por exemplo um worktree ou diretório temporário que outro shell removeu. Claude Code não consegue ler seu diretório de trabalho, então sai com código 1 antes de iniciar a sessão, em modo interativo e [não interativo](/docs/pt/headless) igualmente. Antes da v2.1.239, Claude Code travava com fonte de bundle minificada e um `ENOENT ... uv_cwd` bruto no stderr em vez dessa mensagem.3004Você iniciou `claude` a partir de um diretório que foi excluído ou movido depois que seu shell entrou nele, por exemplo um worktree ou um diretório temporário que outro shell removeu. O Claude Code não consegue ler seu diretório de trabalho, então sai com código 1 antes de iniciar a sessão, tanto no modo interativo quanto no [não interativo](/docs/pt/headless). Antes da v2.1.239, o Claude Code travava exibindo o código-fonte minificado do bundle e um stack `ENOENT ... uv_cwd` bruto no stderr em vez desta mensagem.
2978 3005
2979```text theme={null}3006```text theme={null}
2980The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3007The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
2981error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.3008error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.
2982```3009```
2983 3010
2984A causa e a correção são as mesmas para ambas as formas.3011A causa e a correção são as mesmas para as duas formas.
2985 3012
2986Quando Claude Code não consegue ler o diretório de trabalho por um motivo diferente, como uma mudança de permissões, a mensagem nomeia o código de erro em vez disso: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`3013Quando o Claude Code não consegue ler o diretório de trabalho por outro motivo, como uma alteração de permissões, a mensagem nomeia o código de erro em vez disso: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`
2987 3014
2988No macOS, `EPERM` para um diretório em `~/Desktop`, `~/Documents`, `~/Downloads` ou iCloud Drive geralmente significa que macOS está bloqueando seu aplicativo de terminal dessa pasta. Outros comandos que leem essa pasta falham da mesma forma: `ls` lá relata `Operation not permitted`, mesmo com `sudo`.3015No macOS, `EPERM` para um diretório em `~/Desktop`, `~/Documents`, `~/Downloads` ou iCloud Drive geralmente significa que o macOS está bloqueando o acesso do seu aplicativo de terminal a essa pasta. Outros comandos que leem essa pasta falham da mesma forma: `ls` ali reporta `Operation not permitted`, mesmo com `sudo`.
2989 3016
2990**O que fazer:**3017**O que fazer:**
2991 3018
2992* Mude para um diretório que existe, como seu diretório inicial ou de projeto, depois execute `claude` novamente3019* Mude para um diretório que exista, como seu diretório pessoal ou de projeto, e execute `claude` novamente
2993* Se o diretório foi recriado no mesmo caminho, seu shell ainda mantém o deletado. Execute `cd "$PWD"` ou saia e re-entre no diretório, depois execute `claude` novamente3020* Se o diretório foi recriado no mesmo caminho, seu shell ainda mantém o diretório excluído. Execute `cd "$PWD"` ou saia e entre novamente no diretório, e então execute `claude` novamente
2994* Para `EPERM` no macOS, saia do seu aplicativo de terminal com Cmd+Q, abra-o novamente, retorne a essa pasta e execute `claude`. Se `ls` nessa pasta ainda falhar, abra **System Settings > Privacy & Security > Files and Folders**, ative a pasta para seu aplicativo de terminal, depois reabra o terminal3021* Para `EPERM` no macOS, encerre seu aplicativo de terminal com Cmd+Q, abra-o novamente, volte para essa pasta e execute `claude`. Se `ls` nessa pasta ainda falhar, abra **Ajustes do Sistema > Privacidade e Segurança > Arquivos e Pastas**, ative a pasta para seu aplicativo de terminal e reabra o terminal
2995 3022
2996<h3 id="temp-directory-refused-or-cannot-be-created">3023<h3 id="temp-directory-refused-or-cannot-be-created">
2997 Diretório temporário recusado ou não pode ser criado3024 Diretório temporário recusado ou não pode ser criado
2998</h3>3025</h3>
2999 3026
3000No macOS e Linux, Claude Code cria um diretório temporário privado na inicialização, `claude-<uid>` sob o diretório temporário do sistema ou a substituição [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars). Quando o diretório não pode ser criado, ou uma entrada já naquele caminho falha nas verificações de segurança, Claude Code imprime a falha no stderr e sai com código 1 em vez de iniciar a sessão:3027No macOS e no Linux, o Claude Code cria um diretório temporário privado na inicialização, `claude-<uid>`, no diretório temporário do sistema ou no diretório que sobrescreve esse local por meio de [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars). Quando o diretório não pode ser criado, ou uma entrada já existente nesse caminho falha nas verificações de segurança, o Claude Code imprime a falha no stderr e sai com código 1 em vez de iniciar a sessão:
3001 3028
3002```text wrap theme={null}3029```text wrap theme={null}
3003ENOSPC: no space left on device, mkdir '/tmp/claude-501'3030ENOSPC: no space left on device, mkdir '/tmp/claude-501'
3012**O que fazer:**3039**O que fazer:**
3013 3040
3014* Para `ENOSPC`, libere espaço em disco no volume que contém o diretório temporário3041* Para `ENOSPC`, libere espaço em disco no volume que contém o diretório temporário
3015* Para as formas `Refusing to use it`, remova a entrada nomeada em si, não o que um link aponta, e inicie Claude Code novamente; para a forma `owned by uid`, apenas um administrador ou esse usuário pode removê-la3042* Para as formas `Refusing to use it`, remova a própria entrada nomeada, não aquilo para o qual um link aponta, e inicie o Claude Code novamente; para a forma `owned by uid`, somente um administrador ou esse usuário pode removê-la
3016* Para `is not readable`, execute `chmod 0700` no diretório nomeado, ou remova-o e inicie novamente3043* Para `is not readable`, execute `chmod 0700` no diretório nomeado, ou remova-o e inicie novamente
3017* Em qualquer um desses casos, defina [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars) para um diretório que você controla e inicie Claude Code novamente, deixando o caminho recusado sozinho3044* Em qualquer um desses casos, defina [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars) para um diretório que você controla e inicie o Claude Code novamente, deixando o caminho recusado como está
3018 3045
3019<h3 id="directory-couldnt-be-resolved-to-a-real-location">3046<h3 id="directory-couldnt-be-resolved-to-a-real-location">
3020 Diretório não pôde ser resolvido para um local real3047 O diretório não pôde ser resolvido para um local real
3021</h3>3048</h3>
3022 3049
3023Você executou `/add-dir` para um subdiretório do seu diretório de trabalho, e Claude Code não conseguiu resolver o diretório para seu local real.3050Você executou `/add-dir` para um subdiretório do seu diretório de trabalho, e o Claude Code não conseguiu resolver o diretório para seu local real.
3024 3051
3025Você já tem acesso a arquivo para um subdiretório do diretório de trabalho, então `/add-dir` apenas carrega suas skills, comandos e agentes. Antes de carregá-los, Claude Code verifica que o local real do diretório, com quaisquer symlinks resolvidos, está dentro do diretório de trabalho. Quando Claude Code não consegue resolver esse local, não carrega nada e mostra essa mensagem:3052Você já tem acesso aos arquivos de um subdiretório do diretório de trabalho, então `/add-dir` apenas carrega suas skills, comandos e agentes. Antes de carregá-los, o Claude Code verifica se o local real do diretório, com todos os links simbólicos resolvidos, está dentro do diretório de trabalho. Quando o Claude Code não consegue resolver esse local, ele não carrega nada e mostra esta mensagem:
3026 3053
3027```text theme={null}3054```text theme={null}
3028packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.3055packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.
3030 3057
3031**O que fazer:**3058**O que fazer:**
3032 3059
3033* Verifique se o caminho nomeia um diretório real dentro do diretório de trabalho, depois execute `/add-dir` novamente3060* Verifique se o caminho nomeia um diretório real dentro do diretório de trabalho e execute `/add-dir` novamente
3034* A mensagem não muda seu acesso a arquivo; ela apenas relata que o conteúdo `.claude/` do diretório não foi carregado3061* A mensagem não altera seu acesso aos arquivos; ela apenas informa que o conteúdo `.claude/` do diretório não foi carregado
3035 3062
3036Antes da v2.1.261, essa mensagem também aparecia para cada `/add-dir <subdirectory>` quando o diretório de trabalho estava em um automount `/net/<host>`, onde Claude Code recusa resolver caminhos por design; o diretório estava bem e tentar novamente não poderia ajudar.3063Antes da v2.1.261, esta mensagem também aparecia para todo `/add-dir <subdirectory>` quando o diretório de trabalho estava em um automount `/net/<host>`, onde o Claude Code se recusa a resolver caminhos por design; o diretório estava correto e tentar novamente não ajudava.
3037 3064
3038<h3 id="workspace-not-trusted-when-starting-remote-control">3065<h3 id="workspace-not-trusted-when-starting-remote-control">
3039 Workspace não confiável ao iniciar Remote Control3066 Workspace não confiável ao iniciar o Remote Control
3040</h3>3067</h3>
3041 3068
3042Você iniciou o modo servidor [Remote Control](/docs/pt/remote-control) com `claude remote-control` ou seu alias `claude rc` em um diretório que você não confiou, e o comando não conseguiu perguntar se você confiaria nele. Por exemplo, a entrada padrão ou saída padrão do comando não é um terminal porque uma delas é redirecionada ou canalizada. O comando sai com código 1:3069Você iniciou o modo servidor do [Remote Control](/docs/pt/remote-control) com `claude remote-control` ou seu alias `claude rc` em um diretório em que você não confiou, e o comando não pôde perguntar se você confia nele. Por exemplo, a entrada padrão ou a saída padrão do comando não é um terminal porque uma delas está redirecionada ou em um pipe. O comando sai com código 1:
3043 3070
3044```text theme={null}3071```text theme={null}
3045Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3072Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
3046```3073```
3047 3074
3048Duas variantes que também começam com `Error: Workspace not trusted.` aparecem em um terminal também muito pequeno para mostrar o que confiar no diretório ativa, ou um que não relatou seu tamanho. Amplie a janela ou mude para uma janela de terminal normal, depois execute `claude rc` novamente.3075Duas variantes que também começam com `Error: Workspace not trusted.` aparecem em um terminal pequeno demais para mostrar o que confiar no diretório ativa, ou em um que não informou seu tamanho. Aumente a janela ou mude para uma janela de terminal normal e execute `claude rc` novamente.
3049 3076
3050Em seu diretório inicial a mensagem é diferente, porque o diálogo de confiança do workspace nunca salva confiança para o diretório inicial, então aceitá-lo lá não pode satisfazer essa verificação. Antes da v2.1.214, o diretório inicial mostrava a mensagem acima, cujo conselho não pode ter sucesso lá.3077No seu diretório pessoal, a mensagem é diferente, porque a caixa de diálogo de confiança do workspace nunca salva a confiança para o diretório pessoal, então aceitá-la ali não satisfaz esta verificação. Antes da v2.1.214, o diretório pessoal mostrava a mensagem acima, cujo conselho não pode funcionar ali.
3051 3078
3052```text theme={null}3079```text theme={null}
3053Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).3080Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).
3057 3084
3058**O que fazer:**3085**O que fazer:**
3059 3086
3060* Confie no diretório a partir de um terminal primeiro: execute `claude rc` lá e responda `y`, ou execute `claude` lá e aceite o [diálogo de confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust), depois execute seu comando original novamente3087* Primeiro, confie no diretório a partir de um terminal: execute `claude rc` ali e responda `y`, ou execute `claude` ali e aceite a [caixa de diálogo de confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust), e então execute seu comando original novamente
3061* Em seu diretório inicial, mude para um diretório de projeto e inicie Remote Control lá3088* No seu diretório pessoal, mude para um diretório de projeto e inicie o Remote Control ali
3062 3089
3063Antes da v2.1.284, o comando nunca perguntava, mesmo em um terminal.3090Antes da v2.1.284, o comando nunca perguntava, nem mesmo em um terminal.
3064 3091
3065<h3 id="not-carried-over-to-the-sessions-remote-control-starts">3092<h3 id="not-carried-over-to-the-sessions-remote-control-starts">
3066 Não levado para as sessões que Remote Control inicia3093 Não é repassada para as sessões que o Remote Control inicia
3067</h3>3094</h3>
3068 3095
3069Você iniciou [Remote Control](/docs/pt/remote-control) com uma flag global `claude` antes do verbo `remote-control`, uma que restringiria ou configuraria as sessões que Remote Control inicia, como `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` ou `--mcp-config`. Uma flag colocada antes do verbo nunca chega a essas sessões. Claude Code recusa iniciar em vez disso, nomeando a flag:3096Você iniciou o [Remote Control](/docs/pt/remote-control) com uma flag global do `claude` antes do verbo `remote-control`, uma que restringiria ou configuraria as sessões que o Remote Control inicia, como `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` ou `--mcp-config`. Uma flag colocada antes do verbo nunca chega a essas sessões. Em vez disso, o Claude Code se recusa a iniciar, nomeando a flag:
3070 3097
3071```text theme={null}3098```text theme={null}
3072Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3099Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).
3073```3100```
3074 3101
3075Claude Code não recusa flags globais que são inofensivas de descartar, como `--verbose`, `--model` ou um `--session-id` ou `--plugin-dir` injetado por wrapper: ele as ignora e Remote Control inicia.3102O Claude Code não recusa flags globais que são inofensivas de descartar, como `--verbose`, `--model`, ou um `--session-id` ou `--plugin-dir` injetado por um wrapper: ele as ignora e o Remote Control é iniciado.
3076 3103
3077Claude Code também recusa iniciar para uma flag global que ainda não reconhece como inofensiva, então uma flag adicionada em uma versão mais recente pode aparecer nessa mensagem até uma versão posterior marcá-la como inofensiva.3104O Claude Code também se recusa a iniciar para uma flag global que ele ainda não reconhece como inofensiva, então uma flag adicionada em uma versão mais recente pode aparecer nesta mensagem até que uma versão posterior a marque como inofensiva.
3078 3105
3079**O que fazer:**3106**O que fazer:**
3080 3107
3081* Remova a flag de antes do verbo e passe [as opções próprias do Remote Control](/docs/pt/remote-control#start-a-remote-control-session) depois dele; `claude remote-control --help` as lista3108* Remova a flag de antes do verbo e passe as [opções próprias do Remote Control](/docs/pt/remote-control#start-a-remote-control-session) depois dele; `claude remote-control --help` lista essas opções
3082* Quando a flag recusada é `--permission-mode`, execute `claude remote-control --permission-mode <mode>` para definir o modo de permissão para as sessões que Remote Control inicia3109* Quando a flag recusada for `--permission-mode`, execute `claude remote-control --permission-mode <mode>` para definir o modo de permissão das sessões que o Remote Control inicia
3083 3110
3084Antes da v2.1.248, `claude remote-control` não aceitava suas próprias flags quando uma flag global vinha primeiro, e o comando falhava com um erro de opção desconhecida.3111Antes da v2.1.248, `claude remote-control` não aceitava suas próprias flags quando uma flag global vinha primeiro, e o comando falhava com um erro `unknown option`.
3085 3112
3086<h3 id="claude-import-is-not-yet-available-in-this-build">3113<h3 id="claude-import-is-not-yet-available-in-this-build">
3087 claude import ainda não está disponível nesta compilação3114 claude import ainda não está disponível neste build
3088</h3>3115</h3>
3089 3116
3090Você executou [`claude import`](/docs/pt/cli-reference#cli-commands), e Claude Code encontrou o fluxo de importação desativado, então o comando sai com código 1 em vez de iniciar a importação. Antes da v2.1.222, uma compilação com o fluxo de importação desativado tratava `import` como um prompt e iniciava uma sessão interativa em vez de imprimir essa mensagem.3117Você executou [`claude import`](/docs/pt/cli-reference#cli-commands), e o Claude Code encontrou o fluxo de importação desativado, então o comando sai com código 1 em vez de iniciar a importação. Antes da v2.1.222, um build com o fluxo de importação desativado tratava `import` como um prompt e iniciava uma sessão interativa em vez de imprimir esta mensagem.
3091 3118
3092```text theme={null}3119```text theme={null}
3093`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3120`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
3094```3121```
3095 3122
3096Claude Code ativa `claude import` através de uma flag de recurso que busca da Anthropic e armazena em cache no disco. Essa mensagem significa que o valor em cache está desativado. A causa geralmente é uma das seguintes:3123O Claude Code ativa `claude import` por meio de uma feature flag que ele obtém da Anthropic e armazena em cache no disco. Esta mensagem significa que o valor em cache está desativado. A causa geralmente é uma das seguintes:
3097 3124
3098* Você não iniciou uma sessão desde a instalação, então Claude Code ainda não buscou a flag. O primeiro `claude import` pode imprimir isso mesmo quando o recurso está disponível para você.3125* Você não iniciou uma sessão desde a instalação, então o Claude Code ainda não obteve a flag. O primeiro `claude import` pode imprimir isto mesmo quando o recurso está disponível para você.
3099* Você usa Claude Code através do Amazon Bedrock, da Agent Platform do Google Cloud, do Microsoft Foundry ou do Claude Platform na AWS, ou através de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway#availability-and-limitations). Claude Code não busca flags de recurso nessas sessões, então `claude import` permanece indisponível.3126* Você usa o Claude Code por meio do Amazon Bedrock, do Agent Platform do Google Cloud, do Microsoft Foundry ou do Claude Platform on AWS, ou por meio de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway#availability-and-limitations). O Claude Code não obtém feature flags nessas sessões, então `claude import` permanece indisponível.
3100* Você definiu `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` ou [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars), que desativam a busca de flags de recurso, então `claude import` permanece indisponível.3127* Você definiu `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` ou [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars), que desativam a obtenção de feature flags, então `claude import` permanece indisponível.
3101 3128
3102**O que fazer:**3129**O que fazer:**
3103 3130
3104* Em uma instalação nova, inicie `claude`, aguarde o carregamento da sessão, saia e execute `claude import` novamente3131* Em uma instalação nova, inicie `claude`, aguarde a sessão carregar, saia e execute `claude import` novamente
3105* Onde a busca de flags de recurso permanece desativada, configure você mesmo: adicione servidores MCP com [`claude mcp add`](/docs/pt/mcp#installing-mcp-servers) e crie os [arquivos `CLAUDE.md`](/docs/pt/memory#how-claude-md-files-load), [skills e comandos](/docs/pt/skills#where-skills-live) e [subagentes](/docs/pt/sub-agents#choose-the-subagent-scope) que você quer levar. A mensagem também nomeia `~/.claude/settings.json`. Da configuração que `claude import` leva, esse arquivo contém apenas o [modo de permissão](/docs/pt/settings-reference#permission-settings); Claude Code não lê servidores MCP dele.3132* Onde a obtenção de feature flags permanece desativada, faça a configuração você mesmo: adicione servidores MCP com [`claude mcp add`](/docs/pt/mcp#installing-mcp-servers) e crie os [arquivos `CLAUDE.md`](/docs/pt/memory#how-claude-md-files-load), as [skills e comandos](/docs/pt/skills#where-skills-live) e os [subagentes](/docs/pt/sub-agents#choose-the-subagent-scope) que você deseja transferir. A mensagem também nomeia `~/.claude/settings.json`. Da configuração que `claude import` transfere, esse arquivo contém apenas o [modo de permissão](/docs/pt/settings-reference#permission-settings); o Claude Code não lê servidores MCP dele.
3106 3133
3107<h3 id="could-not-read-claude-code-config">3134<h3 id="could-not-read-claude-code-config">
3108 Não foi possível ler a configuração do Claude Code3135 Não foi possível ler a configuração do Claude Code
3109</h3>3136</h3>
3110 3137
3111Você executou [`claude import`](/docs/pt/cli-reference#cli-commands) enquanto Claude Code não conseguia analisar `~/.claude.json`, o arquivo onde armazena seu login e estado por projeto. O subcomando lê esse arquivo para verificar disponibilidade mas não mostra o diálogo de recuperação que a sessão interativa mostra, então sai com código 1. Antes da v2.1.222, `claude import` com um arquivo de configuração ilegível iniciava uma sessão interativa, cujo diálogo de recuperação tratava o arquivo.3138Você executou [`claude import`](/docs/pt/cli-reference#cli-commands) enquanto o Claude Code não conseguia analisar `~/.claude.json`, o arquivo onde ele armazena seu login e o estado de cada projeto. O subcomando lê esse arquivo para verificar a disponibilidade, mas não mostra a caixa de diálogo de recuperação que a sessão interativa mostra, então sai com código 1. Antes da v2.1.222, `claude import` com um arquivo de configuração ilegível iniciava uma sessão interativa, cuja caixa de diálogo de recuperação tratava o arquivo.
3112 3139
3113```text theme={null}3140```text theme={null}
3114Could not read Claude Code config — run `claude` with no arguments to recover it.3141Could not read Claude Code config — run `claude` with no arguments to recover it.
3116 3143
3117**O que fazer:**3144**O que fazer:**
3118 3145
3119* Execute `claude` sem argumentos. Claude Code detecta o arquivo inválido e oferece redefini-lo. Depois execute `claude import` novamente.3146* Execute `claude` sem argumentos. O Claude Code detecta o arquivo inválido e oferece redefini-lo. Em seguida, execute `claude import` novamente.
3120* Para manter edições manuais que você fez, corrija a sintaxe JSON em `~/.claude.json` em um editor em vez disso, depois execute `claude import` novamente3147* Para manter edições manuais que você fez, corrija a sintaxe JSON em `~/.claude.json` em um editor e execute `claude import` novamente
3121 3148
3122<h3 id="could-not-import-a-server-from-claude-desktop">3149<h3 id="could-not-import-a-server-from-claude-desktop">
3123 Não foi possível importar um servidor do Claude Desktop3150 Não foi possível importar um servidor do Claude Desktop
3124</h3>3151</h3>
3125 3152
3126Claude Code não conseguiu adicionar um dos servidores que você selecionou em `claude mcp add-from-claude-desktop`. O comando ainda importa os outros servidores selecionados e imprime uma linha por servidor que não conseguiu adicionar. Antes da v2.1.205, o primeiro servidor que falhou parou a importação.3153O Claude Code não conseguiu adicionar um dos servidores que você selecionou em `claude mcp add-from-claude-desktop`. O comando ainda importa os outros servidores selecionados e imprime uma linha por servidor que não conseguiu adicionar. Antes da v2.1.205, o primeiro servidor que falhava interrompia a importação.
3127 3154
3128```text theme={null}3155```text theme={null}
3129Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3156Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
3130```3157```
3131 3158
3132O texto após o nome do servidor é o motivo. O mais comum é a verificação de nome: Claude Desktop permite caracteres em nomes de servidor, como espaços e períodos, que `claude mcp` restringe a letras, números, hífens e underscores. 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.3159O texto após o nome do servidor é o motivo. O mais comum é a verificação de nome: o Claude Desktop permite caracteres em nomes de servidor, 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 de MCP](/docs/pt/managed-mcp) da sua organização.
3133 3160
3134**O que fazer:**3161**O que fazer:**
3135 3162
3136* Renomeie o servidor em `claude_desktop_config.json` para usar apenas letras, números, hífens e underscores, depois execute `claude mcp add-from-claude-desktop` novamente3163* Renomeie o servidor em `claude_desktop_config.json` para usar apenas letras, números, hífens e sublinhados e execute `claude mcp add-from-claude-desktop` novamente
3137* 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).3164* Adicione esse servidor diretamente com `claude mcp add` ou `claude mcp add-json` sob um nome válido. Consulte [Importar servidores MCP do Claude Desktop](/docs/pt/mcp#import-mcp-servers-from-claude-desktop).
3138 3165
3139<h3 id="cannot-add-mcp-server-to-the-managed-scope">3166<h3 id="cannot-add-mcp-server-to-the-managed-scope">
3140 Não é possível adicionar servidor MCP ao escopo gerenciado3167 Não é possível adicionar o servidor MCP ao escopo managed
3141</h3>3168</h3>
3142 3169
3143Você executou `claude mcp add` ou `claude mcp add-json` com `--scope managed`. Esse escopo contém os servidores que sua organização fornece através da configuração gerenciada [`managedMcpServers`](/docs/pt/settings-reference#managedmcpservers). Claude Code os lê apenas de configurações gerenciadas, então o comando não consegue escrever um servidor nesse escopo.3170Você executou `claude mcp add` ou `claude mcp add-json` com `--scope managed`. Esse escopo contém os servidores que sua organização fornece por meio da configuração gerenciada [`managedMcpServers`](/docs/pt/settings-reference#managedmcpservers). O Claude Code os lê somente das configurações gerenciadas, então o comando não pode gravar um servidor nesse escopo.
3144 3171
3145```text theme={null}3172```text theme={null}
3146Cannot add MCP server to scope: managed3173Cannot add MCP server to scope: managed
3148 3175
3149**O que fazer:**3176**O que fazer:**
3150 3177
3151* Adicione o servidor a um escopo que você pode escrever: `local`, `user` ou `project`. Sem `--scope`, o comando usa `local`. Veja [MCP installation scopes](/docs/pt/mcp#mcp-installation-scopes)3178* Adicione o servidor a um escopo no qual você pode gravar: `local`, `user` ou `project`. Sem `--scope`, o comando usa `local`. Consulte [Escopos de instalação de MCP](/docs/pt/mcp#mcp-installation-scopes)
3152* Para fornecer o servidor a cada usuário em sua organização, adicione-o a [`managedMcpServers`](/docs/pt/settings-reference#managedmcpservers) nas configurações gerenciadas que você implanta3179* Para fornecer o servidor a todos os usuários da sua organização, adicione-o a [`managedMcpServers`](/docs/pt/settings-reference#managedmcpservers) nas configurações gerenciadas que você implanta
3153 3180
3154<h3 id="cant-read-mcp-json">3181<h3 id="cant-read-mcp-json">
3155 Não é possível ler .mcp.json3182 Não é possível ler .mcp.json
3156</h3>3183</h3>
3157 3184
3158Um comando que lê o [`.mcp.json`](/docs/pt/mcp#project-scope) do projeto, como `claude mcp add` ou `claude mcp add-json` com `--scope project`, ou `claude mcp remove`, descobriu que o arquivo em seu diretório atual não é um arquivo regular ou é maior que 2 MiB, então sai com esse erro em vez de ler o arquivo.3185Um comando que lê o [`.mcp.json`](/docs/pt/mcp#project-scope) do projeto, como `claude mcp add` ou `claude mcp add-json` com `--scope project`, ou `claude mcp remove`, descobriu que o arquivo no seu diretório atual não é um arquivo regular ou é maior que 2 MiB, então sai com este erro em vez de ler o arquivo.
3159 3186
3160```text theme={null}3187```text theme={null}
3161Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.3188Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.
3162```3189```
3163 3190
3164Antes da v2.1.257, um FIFO em `.mcp.json` deixava o comando esperando para sempre sem saída, e um symlink para um arquivo de dispositivo como `/dev/zero` crescia em memória até o processo ser morto.3191Antes da v2.1.257, um FIFO em `.mcp.json` deixava o comando esperando para sempre sem nenhuma saída, e um link simbólico para um arquivo de dispositivo como `/dev/zero` fazia a memória crescer até o processo ser encerrado.
3165 3192
3166**O que fazer:**3193**O que fazer:**
3167 3194
3168* Verifique o que está em `.mcp.json` em seu diretório atual. Substitua-o por um arquivo JSON ordinário no [formato de escopo de projeto](/docs/pt/mcp#project-scope), ou delete-o, depois execute o comando novamente.3195* Verifique o que está em `.mcp.json` no seu diretório atual. Substitua-o por um arquivo JSON comum no [formato de escopo de projeto](/docs/pt/mcp#project-scope), ou exclua-o, e execute o comando novamente.
3169 3196
3170<h3 id="mcp-server-was-not-saved-or-removed">3197<h3 id="mcp-server-was-not-saved-or-removed">
3171 Servidor MCP não foi salvo ou removido3198 O servidor MCP não foi salvo ou removido
3172</h3>3199</h3>
3173 3200
3174Você executou `claude mcp add`, `claude mcp add-json` ou `claude mcp remove` para um servidor no escopo `user` ou `local` [scope](/docs/pt/mcp#mcp-installation-scopes). Ambos os escopos são armazenados em `~/.claude.json`, e a mudança não está naquele arquivo quando Claude Code o lê novamente após escrever. O comando sai com esse erro em vez de sua linha de sucesso.3201Você executou `claude mcp add`, `claude mcp add-json` ou `claude mcp remove` para um servidor no [escopo](/docs/pt/mcp#mcp-installation-scopes) `user` ou `local`. Ambos os escopos são armazenados em `~/.claude.json`, e a alteração não está nesse arquivo quando o Claude Code o lê de volta após a gravação. O comando sai com este erro em vez de sua linha de sucesso.
3175 3202
3176```text theme={null}3203```text theme={null}
3177MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.3204MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.
3178```3205```
3179 3206
3180Após uma remoção, a mensagem lê `was not removed from` e termina com `then remove the server again`. Para um servidor de escopo `local`, o caminho é seguido pelo diretório do projeto ao qual a entrada pertence, como `(local scope for /path/to/project)`.3207Após uma remoção, a mensagem diz `was not removed from` e termina com `then remove the server again`. Para um servidor de escopo `local`, o caminho é seguido pelo diretório do projeto ao qual a entrada pertence, como `(local scope for /path/to/project)`.
3181 3208
3182Antes da v2.1.283, `claude mcp add`, `claude mcp add-json` e `claude mcp remove` relatavam sucesso mesmo quando a mudança não chegava ao arquivo.3209Antes da v2.1.283, `claude mcp add`, `claude mcp add-json` e `claude mcp remove` reportavam sucesso mesmo quando a alteração não chegava ao arquivo.
3183 3210
3184**O que fazer:**3211**O que fazer:**
3185 3212
3186* Torne o arquivo que a mensagem nomeia gravável, ou execute o comando fora do sandbox, depois execute o mesmo comando de adição ou remoção novamente.3213* Torne gravável o arquivo que a mensagem nomeia, ou execute o comando fora do sandbox, e então execute o mesmo comando de adição ou remoção novamente.
3187 3214
3188<h3 id="mcp-server-may-not-have-been-saved-or-removed">3215<h3 id="mcp-server-may-not-have-been-saved-or-removed">
3189 Servidor MCP pode não ter sido salvo ou removido3216 O servidor MCP pode não ter sido salvo ou removido
3190</h3>3217</h3>
3191 3218
3192Você executou `claude mcp add`, `claude mcp add-json` ou `claude mcp remove` para um servidor no escopo `user` ou `local` [scope](/docs/pt/mcp#mcp-installation-scopes), e Claude Code não conseguiu ler `~/.claude.json` novamente para confirmar a mudança. A mudança pode ou não estar no disco. O texto entre parênteses é o erro dessa leitura.3219Você executou `claude mcp add`, `claude mcp add-json` ou `claude mcp remove` para um servidor no [escopo](/docs/pt/mcp#mcp-installation-scopes) `user` ou `local`, e o Claude Code não conseguiu ler `~/.claude.json` de volta para confirmar a alteração. A alteração pode ou não estar no disco. O texto entre parênteses é o erro dessa leitura.
3193 3220
3194```text theme={null}3221```text theme={null}
3195MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.3222MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.
3196```3223```
3197 3224
3198Após uma remoção, a mensagem lê `may not have been removed` e termina com `then remove the server again if it is still listed`.3225Após uma remoção, a mensagem diz `may not have been removed` e termina com `then remove the server again if it is still listed`.
3199 3226
3200Antes da v2.1.283, os comandos relatavam sucesso mesmo quando a mudança não conseguia ser confirmada.3227Antes da v2.1.283, os comandos reportavam sucesso mesmo quando a alteração não podia ser confirmada.
3201 3228
3202**O que fazer:**3229**O que fazer:**
3203 3230
3204* Execute `claude mcp get <name>` para verificar se a mudança está no disco. Para um servidor de escopo `local`, execute-o a partir do diretório do projeto ao qual o servidor pertence, já que o escopo local é por projeto.3231* Execute `claude mcp get <name>` para verificar se a alteração está no disco. Para um servidor de escopo `local`, execute-o a partir do diretório do projeto ao qual o servidor pertence, já que o escopo local é por projeto.
3205* Se o servidor está faltando após uma adição, ou ainda listado após uma remoção, execute o mesmo comando de adição ou remoção novamente.3232* Se o servidor estiver ausente após uma adição, ou ainda listado após uma remoção, execute o mesmo comando de adição ou remoção novamente.
3206 3233
3207<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">3234<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">
3208 Servidor é hospedado pela Anthropic e não suporta OAuth local3235 O servidor é hospedado pela Anthropic e não oferece suporte a OAuth local
3209</h3>3236</h3>
3210 3237
3211Você iniciou um sign-in para um servidor MCP cuja URL aponta para um host de conector hospedado pela Anthropic que autentica através de um provedor de identidade de terceiros. Esses hosts incluem `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` e `gcal.mcp.claude.com`. Claude Code recusa iniciar seu fluxo OAuth local para esses hosts tanto do painel `/mcp` quanto de `claude mcp login`, porque [seu sign-in funciona apenas através de claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai).3238Você iniciou um login para um servidor MCP cuja URL aponta para um host de conector hospedado pela Anthropic que autentica por meio de um provedor de identidade de terceiros. Esses hosts incluem `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` e `gcal.mcp.claude.com`. O Claude Code se recusa a iniciar seu fluxo OAuth local para esses hosts tanto a partir do painel `/mcp` quanto de `claude mcp login`, porque [o login deles funciona somente por meio do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai).
3212 3239
3213```text theme={null}3240```text theme={null}
3214"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.3241"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.
3215```3242```
3216 3243
3217Claude Code corresponde a esses hosts por URL, então a mensagem aparece quando um servidor que você adicionou com `claude mcp add` ou em `.mcp.json` aponta para um deles.
3218
3219**O que fazer:**3244**O que fazer:**
3220 3245
3221* Remova sua entrada com `claude mcp remove <name>`, para que não possa ocultar o conector claude.ai na mesma URL3246* Remova sua entrada com `claude mcp remove <name>`, para que ela não oculte o conector do claude.ai na mesma URL
3222* Depois de removê-la, conecte o serviço em [claude.ai/customize/connectors](https://claude.ai/customize/connectors), enquanto conectado à conta que você usa em Claude Code. Uma vez conectado, [o conector aparece em Claude Code automaticamente](/docs/pt/mcp#use-mcp-servers-from-claude-ai) se seu método de autenticação ativo for um login de assinatura claude.ai3247* Depois de removê-la, conecte o serviço em [claude.ai/customize/connectors](https://claude.ai/customize/connectors), com login na conta que você usa no Claude Code. Depois de conectado, [o conector aparece no Claude Code automaticamente](/docs/pt/mcp#use-mcp-servers-from-claude-ai) se o seu método de autenticação ativo for um login com assinatura do claude.ai
3223 3248
3224<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">3249<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">
3225 Servidor rejeitou o cabeçalho Authorization cunhado pelo headersHelper configurado3250 O servidor rejeitou o cabeçalho Authorization gerado pelo headersHelper configurado
3226</h3>3251</h3>
3227 3252
3228Um servidor MCP cujo [`headersHelper`](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication) fornece o cabeçalho `Authorization` respondeu a conexão com HTTP 401 ou 403, então Claude Code relata a conexão como falha. Porque o helper fornece o cabeçalho `Authorization`, Claude Code [não volta para OAuth](/docs/pt/mcp#authenticate-with-remote-mcp-servers) para o servidor:3253Um servidor MCP cujo [`headersHelper`](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication) fornece o cabeçalho `Authorization` respondeu à conexão com HTTP 401 ou 403, então o Claude Code reporta a conexão como falha. Como o helper fornece o cabeçalho `Authorization`, o Claude Code [não recorre ao OAuth](/docs/pt/mcp#authenticate-with-remote-mcp-servers) para o servidor:
3229 3254
3230```text theme={null}3255```text theme={null}
3231Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.3256Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.
3232```3257```
3233 3258
3234Claude Code re-executa o helper em cada tentativa de conexão, então uma tentativa novamente após uma rejeição transitória, como uma corrida de rotação de token, pode ter sucesso com uma credencial nova.3259O Claude Code executa o helper novamente a cada tentativa de conexão, então uma nova tentativa após uma rejeição transitória, como uma condição de corrida na rotação de token, pode ter sucesso com uma credencial nova.
3235 3260
3236**O que fazer:**3261**O que fazer:**
3237 3262
3238* Execute o comando `headersHelper` você mesmo da forma que Claude Code o executa: do [diretório onde Claude Code o executa](/docs/pt/mcp#where-the-helper-runs), com as [variáveis de ambiente que Claude Code define para ele](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication), e sem as [variáveis de credencial que Claude Code remove](/docs/pt/mcp#which-variables-a-helper-can-read) para um servidor de um `.mcp.json` de projeto, um plugin ou um arquivo de agente de projeto. Verifique se ele imprime um valor `Authorization` que o endpoint do servidor aceita3263* Execute você mesmo o comando `headersHelper` da forma como o Claude Code o executa: a partir do [diretório em que o Claude Code o executa](/docs/pt/mcp#where-the-helper-runs), com as [variáveis de ambiente que o Claude Code define para ele](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication) e sem as [variáveis de credencial que o Claude Code remove](/docs/pt/mcp#which-variables-a-helper-can-read) para um servidor de um `.mcp.json` de projeto, de um plugin ou de um arquivo de agente de projeto. Verifique se ele imprime um valor de `Authorization` que o endpoint do servidor aceita
3239* Depois de corrigir o helper ou sua fonte de credencial, selecione o servidor em `/mcp` e escolha **Reconnect**3264* Depois de corrigir o helper ou sua fonte de credenciais, selecione o servidor em `/mcp` e escolha **Reconnect**
3240 3265
3241Antes da v2.1.248, Claude Code executava descoberta OAuth para um servidor cujo helper fornecia o cabeçalho `Authorization`. Essa descoberta poderia falhar com `Incompatible auth server: does not support dynamic client registration` em vez de relatar a credencial rejeitada.3266Antes da v2.1.248, o Claude Code executava a descoberta de OAuth para um servidor cujo helper fornecia o cabeçalho `Authorization`. Essa descoberta podia falhar com `Incompatible auth server: does not support dynamic client registration` em vez de reportar a credencial rejeitada.
3242 3267
3243<h3 id="mcp-permission-prompt-tool-not-found">3268<h3 id="mcp-permission-prompt-tool-not-found">
3244 Ferramenta de prompt de permissão MCP não encontrada3269 Ferramenta de prompt de permissão MCP não encontrada
3245</h3>3270</h3>
3246 3271
3247A 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 inicia lentamente mas saudável produzia esse erro também.3272A 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 precisou pela primeira vez 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. O Claude Code ainda envia seu prompt: a execução [não interativa](/docs/pt/headless) sai com este erro, e código de saída 1, na primeira chamada de ferramenta, então não produz nenhuma resposta mesmo que a requisição tenha sido feita. Antes do primeiro prompt, o Claude Code aguarda até o timeout 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 saudável, mas lento para iniciar, também produzia este erro.
3248 3273
3249```text theme={null}3274```text theme={null}
3250Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3275Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
3251```3276```
3252 3277
3253A lista após `Available MCP tools:` nomeia as ferramentas MCP que estavam conectadas quando a espera terminou.3278A lista após `Available MCP tools:` nomeia as ferramentas MCP que estavam conectadas.
3254 3279
3255**O que fazer:**3280**O que fazer:**
3256 3281
3257* Verifique se o servidor inicia e permanece conectado: execute `claude mcp list` no mesmo diretório e confirme se o servidor está listado como conectado3282* Verifique se o servidor inicia e permanece conectado: execute `claude mcp list` no mesmo diretório e confirme que o servidor está listado como conectado
3258* Confirme se o nome da ferramenta corresponde ao nome `mcp__<server>__<tool>` que o servidor expõe3283* Confirme que o nome da ferramenta corresponde ao nome `mcp__<server>__<tool>` que o servidor expõe
3259* Se o servidor precisa de mais de 30 segundos para iniciar, aumente [`MCP_TIMEOUT`](/docs/pt/env-vars)3284* Se o servidor precisar de mais de 30 segundos para iniciar, aumente [`MCP_TIMEOUT`](/docs/pt/env-vars)
3260 3285
3261<h3 id="oauth-callback-port-is-already-in-use">3286<h3 id="oauth-callback-port-is-already-in-use">
3262 Porta de callback OAuth já está em uso3287 A porta de callback do OAuth já está em uso
3263</h3>3288</h3>
3264 3289
3265Quando você faz sign-in em um servidor MCP remoto com OAuth, Claude Code inicia um listener local para receber o callback de sign-in. Se a porta que esse listener precisa está sendo mantida por outro processo, o sign-in falha com essa mensagem. Isso acontece principalmente com uma [porta de callback fixa](/docs/pt/mcp#use-a-fixed-oauth-callback-port) definida através da variável [`MCP_OAUTH_CALLBACK_PORT`](/docs/pt/env-vars) ou `--callback-port`, já que sem uma Claude Code escolhe uma porta disponível.3290Quando você faz login em um servidor MCP remoto com OAuth, o Claude Code inicia um listener local para receber o callback do login. Se a porta de que esse listener precisa estiver ocupada por outro processo, o login falha com esta mensagem. Isso acontece principalmente com uma [porta de callback fixa](/docs/pt/mcp#use-a-fixed-oauth-callback-port) definida por meio da variável [`MCP_OAUTH_CALLBACK_PORT`](/docs/pt/env-vars) ou de `--callback-port`, já que, sem ela, o Claude Code escolhe uma porta disponível.
3266 3291
3267```text theme={null}3292```text theme={null}
3268OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3293OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
3269```3294```
3270 3295
3271No Windows, o comando sugerido é `netstat -ano | findstr :<port>` em vez disso.3296No Windows, o comando sugerido é `netstat -ano | findstr :<port>`.
3272 3297
3273**O que fazer:**3298**O que fazer:**
3274 3299
3275* Execute o comando da mensagem para encontrar o processo que mantém a porta e pare-o ou aguarde que termine3300* Execute o comando da mensagem para encontrar o processo que está ocupando a porta e interrompa-o ou aguarde até que termine
3276* Se outro programa precisa dessa porta permanentemente, registre um URI de redirecionamento diferente com o servidor e defina sua porta com `MCP_OAUTH_CALLBACK_PORT` ou `--callback-port`, o que você usar3301* Se outro programa precisar dessa porta permanentemente, registre um URI de redirecionamento diferente no servidor e defina sua porta com `MCP_OAUTH_CALLBACK_PORT` ou `--callback-port`, o que você estiver usando
3277* Depois inicie o sign-in novamente, por exemplo selecionando o servidor em `/mcp`3302* Em seguida, inicie o login novamente, por exemplo selecionando o servidor em `/mcp`
3278 3303
3279<h3 id="no-available-ports-for-oauth-redirect">3304<h3 id="no-available-ports-for-oauth-redirect">
3280 Nenhuma porta disponível para redirecionamento OAuth3305 Nenhuma porta disponível para o redirecionamento do OAuth
3281</h3>3306</h3>
3282 3307
3283Quando você faz sign-in em um servidor MCP remoto com [OAuth](/docs/pt/mcp#authenticate-with-remote-mcp-servers), Claude Code inicia um listener local para receber o callback de sign-in. O sign-in falha com essa mensagem quando Claude Code não consegue vincular uma porta local para isso. Algo na máquina está impedindo que ele ouça em `127.0.0.1`, por exemplo software de segurança ou uma política de sandbox que nega listeners locais.3308Quando você faz login em um servidor MCP remoto com [OAuth](/docs/pt/mcp#authenticate-with-remote-mcp-servers), o Claude Code inicia um listener local para receber o callback do login. O login falha com esta mensagem quando o Claude Code não consegue vincular uma porta local para ele. Algo na máquina está impedindo-o de escutar em `127.0.0.1`, por exemplo um software de segurança ou uma política de sandbox que nega listeners locais.
3284 3309
3285```text theme={null}3310```text theme={null}
3286No available ports for OAuth redirect3311No available ports for OAuth redirect
3287```3312```
3288 3313
3289Antes da v2.1.268, Claude Code não voltava para uma porta atribuída pelo sistema operacional, então a mensagem também aparecia quando apenas suas portas auto-escolhidas não podiam ser vinculadas. Isso pode acontecer em hosts Windows onde Hyper-V reserva intervalos de porta que cobrem as portas que Claude Code escolhe.3314Antes da v2.1.268, o Claude Code não recorria a uma porta atribuída pelo sistema operacional, então a mensagem também aparecia quando apenas as portas escolhidas por ele não podiam ser vinculadas. Isso pode acontecer em hosts Windows onde o Hyper-V reserva intervalos de portas que abrangem as portas entre as quais o Claude Code escolhe.
3290 3315
3291**O que fazer:**3316**O que fazer:**
3292 3317
3293* Verifique se software de segurança ou uma política de sandbox bloqueia processos de ouvirem em `127.0.0.1` e permita que Claude Code vincule uma porta local3318* Verifique se um software de segurança ou uma política de sandbox impede processos de escutar em `127.0.0.1` e permita que o Claude Code vincule uma porta local
3294* Depois inicie o sign-in novamente, por exemplo selecionando o servidor em `/mcp`3319* Em seguida, inicie o login novamente, por exemplo selecionando o servidor em `/mcp`
3295 3320
3296<h3 id="security-review-fails-without-origin-head">3321<h3 id="security-review-fails-without-origin-head">
3297 /security-review falha sem origin/HEAD3322 /security-review falha sem origin/HEAD
3298</h3>3323</h3>
3299 3324
3300[`/security-review`](/docs/pt/commands#all-commands) constrói seu contexto de revisão fazendo diff de seu branch contra `origin/HEAD`, a ref local que registra qual branch é o padrão em seu remote `origin`. Quando essa ref não existe, os comandos git que reúnem o diff falham e a revisão para antes de começar.3325[`/security-review`](/docs/pt/commands#all-commands) cria seu contexto de revisão gerando o diff do seu branch em relação a `origin/HEAD`, a ref local que registra qual branch é o padrão no seu remoto `origin`. Quando essa ref não existe, os comandos git que reúnem o diff falham e a revisão para antes de começar.
3301 3326
3302```text theme={null}3327```text theme={null}
3303Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3328Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
3306'git <command> [<revision>...] -- [<file>...]'3331'git <command> [<revision>...] -- [<file>...]'
3307```3332```
3308 3333
3309A mensagem pode citar `git log` ou um `git diff` diferente em vez disso. Git cria `origin/HEAD` apenas quando o remote anuncia um branch padrão e seu refspec de busca o cobre, o que um `git clone` completo de um remote com commits faz. A ref está faltando nessas configurações:3334A mensagem pode citar `git log` ou um `git diff` diferente. O Git cria `origin/HEAD` somente quando o remoto anuncia um branch padrão e seu refspec de fetch o abrange, o que acontece com um `git clone` completo de um remoto com commits. A ref está ausente nestas configurações:
3310 3335
3311* Um checkout de branch único ou CI, que busca um refspec muito estreito3336* Um checkout de branch único ou de CI, que faz fetch com um refspec restrito demais
3312* Um remote cujo HEAD do lado do servidor aponta para um branch que ninguém fez push3337* Um remoto cujo HEAD do lado do servidor aponta para um branch que ninguém enviou
3313* Um repositório sem remote `origin`, ou um que você nunca buscou3338* Um repositório sem remoto `origin`, ou um do qual você nunca fez fetch
3314 3339
3315Claude Code mostra o mesmo erro para qualquer skill que [injeta contexto dinâmico](/docs/pt/skills#when-an-injected-command-fails), e um comando injetado que falha aborta a invocação dessa skill. Duas strings irmãs disparam antes do comando ser executado:3340O Claude Code mostra o mesmo erro para qualquer skill que [injeta contexto dinâmico](/docs/pt/skills#when-an-injected-command-fails), e um comando injetado que falha aborta a invocação dessa skill. Duas mensagens irmãs são disparadas antes mesmo de o comando ser executado:
3316 3341
3317* `Shell command permission check failed for pattern "..."`: a verificação de permissão do comando não o permitiu. [Permission checks on injected commands](/docs/pt/skills#permission-checks-on-injected-commands) cobre quais resultados abortam em cada modo de permissão e como pré-aprovar um comando com `allowed-tools`3342* `Shell command permission check failed for pattern "..."`: a verificação de permissão do comando não o permitiu. [Verificações de permissão em comandos injetados](/docs/pt/skills#permission-checks-on-injected-commands) explica quais resultados abortam em cada modo de permissão e como pré-aprovar um comando com `allowed-tools`
3318* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: o frontmatter da skill exige bash em uma máquina sem ele. Instale Git para Windows ou mude o frontmatter para `shell: powershell`. Veja [How injected commands run](/docs/pt/skills#how-injected-commands-run)3343* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: o frontmatter da skill exige bash em uma máquina que não o tem. Instale o Git for Windows ou altere o frontmatter para `shell: powershell`. Consulte [Como os comandos injetados são executados](/docs/pt/skills#how-injected-commands-run)
3319 3344
3320**O que fazer:**3345**O que fazer:**
3321 3346
3322* Crie a ref nomeando o branch padrão do seu remote: `git remote set-head origin <default-branch>`. Isso funciona sempre que a ref de rastreamento local `origin/<default-branch>` existe. Se não existir, como em clones de branch único, busque o branch primeiro: execute `git remote set-branches --add origin <branch>`, depois `git fetch origin`, depois execute novamente o comando set-head. Execute `/security-review` novamente.3347* Crie a ref nomeando o branch padrão do seu remoto: `git remote set-head origin <default-branch>`. Isso funciona sempre que a ref de rastreamento local `origin/<default-branch>` existe. Se não existir, como em clones de branch único, faça primeiro o fetch do branch: execute `git remote set-branches --add origin <branch>`, depois `git fetch origin` e, em seguida, execute novamente o comando set-head. Execute `/security-review` novamente.
3323* Se você preferir não nomear o branch, execute `git fetch origin` e depois `git remote set-head origin --auto`, que pergunta ao remote qual branch é seu padrão. Falha com `error: Cannot determine remote HEAD` quando o remote não anuncia um branch padrão, porque está vazio ou seu HEAD aponta para um branch que ninguém fez push; nomeie o branch explicitamente em vez disso. Falha com `error: Not a valid ref` quando seu clone não busca esse branch; amplie o refspec como acima primeiro.3348* Se preferir não nomear o branch, execute `git fetch origin` e depois `git remote set-head origin --auto`, que pergunta ao remoto qual branch é o padrão. Ele falha com `error: Cannot determine remote HEAD` quando o remoto não anuncia nenhum branch padrão, porque está vazio ou seu HEAD aponta para um branch que ninguém enviou; nesse caso, nomeie o branch explicitamente. Ele falha com `error: Not a valid ref` quando seu clone não faz fetch desse branch; amplie primeiro o refspec como descrito acima.
3324* Se o repositório não tem remote, adicione um com `git remote add origin <url>` e busque antes de criar a ref. Se o remote está vazio, faça push de seu branch primeiro com `git push -u origin HEAD` e nomeie esse branch no comando set-head; `origin/HEAD` então aponta para o branch que você acabou de fazer push, então `/security-review` vê um diff vazio até o branch divergir dele.3349* Se o repositório não tiver remoto, adicione um com `git remote add origin <url>` e faça fetch antes de criar a ref. Se o remoto estiver vazio, envie primeiro seu branch com `git push -u origin HEAD` e nomeie esse branch no comando set-head; `origin/HEAD` então aponta para o branch que você acabou de enviar, então `/security-review` vê um diff vazio até que o branch divirja dele.
3325 3350
3326<h3 id="input-must-be-provided-when-using-print">3351<h3 id="input-must-be-provided-when-using-print">
3327 Entrada deve ser fornecida ao usar `--print`3352 É necessário fornecer entrada ao usar `--print`
3328</h3>3353</h3>
3329 3354
3330`claude` simples precisa que stdout seja um terminal para iniciar a UI interativa. Quando stdout é redirecionado, ou o console não é um terminal real, como PowerShell ISE e alguns painéis de saída de IDE, `claude` executa [não interativamente](/docs/pt/headless) em vez disso. Esse é o mesmo modo que `claude -p`, que requer um prompt, então a mensagem nomeia `--print` mesmo quando você não passou a flag. Passar `-p`/`--print` sem prompt e nada canalizado em stdin produz o mesmo erro em qualquer lugar.3355O `claude` sem argumentos precisa que o stdout seja um terminal para iniciar a interface interativa. Quando o stdout está redirecionado, ou o console não é um terminal real, como o PowerShell ISE e alguns painéis de saída de IDE, `claude` é executado de forma [não interativa](/docs/pt/headless). Esse é o mesmo modo que `claude -p`, que exige um prompt, então a mensagem nomeia `--print` mesmo quando você não passou a flag. Passar `-p`/`--print` sem prompt e sem nada enviado por pipe no stdin produz o mesmo erro em qualquer lugar.
3331 3356
3332```text theme={null}3357```text theme={null}
3333Error: Input must be provided either through stdin or as a prompt argument when using --print3358Error: Input must be provided either through stdin or as a prompt argument when using --print
3335 3360
3336**O que fazer:**3361**O que fazer:**
3337 3362
3338* Para uso interativo, execute `claude` em um terminal real: Windows Terminal ou o console PowerShell em vez de ISE, e o terminal integrado do seu IDE em vez de um painel de saída3363* Para uso interativo, execute `claude` em um terminal real: o Windows Terminal ou o console do PowerShell em vez do ISE, e o terminal integrado da sua IDE em vez de um painel de saída
3339* Para uso único, passe o prompt: `claude -p "your question"`, ou canalize-o com `echo "your question" | claude -p`3364* Para uso pontual, passe o prompt: `claude -p "your question"`, ou envie-o por pipe com `echo "your question" | claude -p`
3340 3365
3341<h3 id="input-contained-only-whitespace">3366<h3 id="input-contained-only-whitespace">
3342 Entrada continha apenas espaço em branco3367 A entrada continha apenas espaços em branco
3343</h3>3368</h3>
3344 3369
3345Em [modo não interativo](/docs/pt/headless), Claude Code recusa um prompt feito inteiramente de espaços, abas ou quebras de linha em vez de enviá-lo, porque a API rejeita mensagens sem texto visível. Qual mensagem você vê depende de onde o prompt em branco veio:3370No [modo não interativo](/docs/pt/headless), o Claude Code recusa um prompt composto inteiramente de espaços, tabulações ou quebras de linha em vez de enviá-lo, porque a API rejeita mensagens sem texto visível. A mensagem que você vê depende de onde veio o prompt em branco:
3346 3371
3347* **Argumento de prompt ou stdin canalizado para `claude -p`**: `claude` sai com `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`3372* **Argumento de prompt ou stdin via pipe para `claude -p`**: `claude` sai com `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`
3348* **Mensagem enviada para uma sessão `--input-format stream-json` ou [Agent SDK](/docs/pt/agent-sdk/overview) em execução**: Claude Code termina a volta sem chamar o modelo e a sessão permanece utilizável. A recusa chega como uma mensagem informativa e como o texto de resultado da volta: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`3373* **Mensagem enviada a uma sessão `--input-format stream-json` ou do [Agent SDK](/docs/pt/agent-sdk/overview) em execução**: o Claude Code encerra o turno sem chamar o modelo e a sessão continua utilizável. A recusa chega como uma mensagem informativa e como o texto de resultado do turno: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`
3349 3374
3350Antes da v2.1.229, Claude Code enviava a mensagem apenas com espaço em branco para a API, que rejeitava a solicitação com um erro 400.3375Antes da v2.1.229, o Claude Code enviava a mensagem contendo apenas espaços em branco para a API, que rejeitava a requisição com um erro 400.
3351 3376
3352**O que fazer:**3377**O que fazer:**
3353 3378
3354* Inclua texto visível no prompt. Se um script constrói o prompt a partir de uma variável ou arquivo, verifique se a fonte não está vazia antes de chamar Claude Code.3379* Inclua texto visível no prompt. Se um script cria o prompt a partir de uma variável ou arquivo, verifique se a origem não está vazia antes de chamar o Claude Code.
3355 3380
3356<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">3381<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">
3357 entrada stream-json levou mais de 256M caracteres sem quebra de linha3382 A entrada stream-json transportou mais de 256M caracteres sem quebra de linha
3358</h3>3383</h3>
3359 3384
3360Seu programa enviou mais de 268.435.456 caracteres em stdin sem uma quebra de linha para uma execução `claude -p --input-format stream-json`, então Claude Code imprime esse erro no stderr e sai com código 1 em vez de armazenar mais entrada. A mensagem declara esse orçamento como `256M`. Antes da v2.1.257, Claude Code armazenava tal entrada sem limite, crescendo em memória até o processo travar ou ser morto.3385Seu programa enviou mais de 268.435.456 caracteres no stdin sem uma quebra de linha para uma execução `claude -p --input-format stream-json`, então o Claude Code imprime este erro no stderr e sai com código 1 em vez de armazenar mais entrada em buffer. A mensagem expressa esse limite como `256M`. Antes da v2.1.257, o Claude Code armazenava essa entrada em buffer sem limite, fazendo a memória crescer até o processo travar ou ser encerrado.
3361 3386
3362```text theme={null}3387```text theme={null}
3363Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.3388Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.
3364```3389```
3365 3390
3366Entrada tão longa sem uma quebra de linha geralmente significa que o produtor não é um produtor stream-json, como um arquivo binário ou saída de log simples canalizada por acidente. Uma única mensagem acima do orçamento falha na mesma verificação.3391Uma entrada tão longa sem quebra de linha geralmente significa que o produtor não é um produtor de stream-json, como um arquivo binário ou uma saída de log simples enviada por pipe por engano. Uma única mensagem acima do limite falha na mesma verificação.
3367 3392
3368**O que fazer:**3393**O que fazer:**
3369 3394
3370* Verifique o que está canalizado para stdin. Com [`--input-format stream-json`](/docs/pt/cli-reference#cli-flags), cada mensagem deve ser uma linha JSON terminada por quebra de linha3395* Verifique o que está sendo enviado por pipe para o stdin. Com [`--input-format stream-json`](/docs/pt/cli-reference#cli-flags), cada mensagem deve ser uma linha JSON terminada por quebra de linha
3371* Para enviar texto simples em vez disso, remova `--input-format stream-json`; `claude -p` lê um prompt de texto simples de stdin por padrão3396* Para enviar texto simples, remova `--input-format stream-json`; `claude -p` lê um prompt de texto simples do stdin por padrão
3372 3397
3373<h3 id="unknown-command">3398<h3 id="unknown-command">
3374 Comando desconhecido3399 Comando desconhecido
3375</h3>3400</h3>
3376 3401
3377Em uma sessão de terminal interativa, você enviou um nome `/` que não corresponde a nenhum comando nessa sessão, então Claude Code relata o nome em vez de executar qualquer coisa:3402Em uma sessão de terminal interativa, você enviou um nome com `/` que não corresponde a nenhum comando nesta sessão, então o Claude Code reporta o nome em vez de executar algo:
3378 3403
3379```text theme={null}3404```text theme={null}
3380Unknown command: /hepl. Did you mean /help?3405Unknown command: /hepl. Did you mean /help?
3381```3406```
3382 3407
3383Claude Code sugere o nome de comando ou alias mais próximo que o menu lista nessa sessão. Quando nada está próximo, a mensagem termina após o nome. A causa geralmente é uma das seguintes:3408O Claude Code sugere o nome de comando ou alias mais próximo que o menu lista nesta sessão. Quando nada é próximo, a mensagem termina após o nome. A causa geralmente é uma das seguintes:
3384 3409
3385* Um erro de digitação, como `/hepl` para `/help`. [How the command menu matches what you type](/docs/pt/commands#how-the-command-menu-matches-what-you-type) cobre escolher uma correspondência próxima antes de enviar3410* Um erro de digitação, como `/hepl` em vez de `/help`. [Como o menu de comandos corresponde ao que você digita](/docs/pt/commands#how-the-command-menu-matches-what-you-type) explica como escolher uma correspondência próxima antes de enviar
3386* Um comando que existe mas não está disponível nessa sessão porque um requisito não é atendido, como sua plataforma, plano ou método de autenticação. As entradas de solução de problemas para [`/web-setup`](/docs/pt/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) e [`/schedule`](/docs/pt/routines#schedule-returns-unknown-command) percorrem dois casos comuns. Alguns comandos respondem com sua própria mensagem quando a política da sua organização os desabilita, como [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)3411* Um comando que existe, mas não está disponível nesta sessão porque um requisito não foi atendido, como sua plataforma, plano ou método de autenticação. As entradas de solução de problemas de [`/web-setup`](/docs/pt/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) e [`/schedule`](/docs/pt/routines#schedule-returns-unknown-command) detalham dois casos comuns. Alguns comandos respondem com sua própria mensagem quando a política da sua organização os desativa, como [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)
3387* Um comando de um [plugin](/docs/pt/plugins/overview) ou [servidor MCP](/docs/pt/mcp#use-mcp-prompts-as-commands) que não está instalado ou conectado nessa sessão3412* Um comando de um [plugin](/docs/pt/plugins/overview) ou [servidor MCP](/docs/pt/mcp#use-mcp-prompts-as-commands) que não está instalado ou conectado nesta sessão
3388 3413
3389Claude Code responde a um nome `/` não correspondido dessa forma apenas em uma sessão de terminal interativa. Em todas as outras sessões, ele envia o prompt para Claude como uma mensagem normal em vez disso, com uma nota de que o comando não foi executado e uma lista de comandos que Claude pode executar na sessão. Essas sessões incluem:3414O Claude Code responde dessa forma a um nome com `/` sem correspondência somente em uma sessão de terminal interativa. Em todas as outras sessões, ele envia o prompt ao Claude como uma mensagem normal, com uma nota de que o comando não foi executado e uma lista dos comandos que o Claude pode executar na sessão. Essas sessões incluem:
3390 3415
3391* execuções `-p`3416* Execuções com `-p`
3392* aplicações [Agent SDK](/docs/pt/agent-sdk/overview)3417* Aplicações do [Agent SDK](/docs/pt/agent-sdk/overview)
3393* A aba Code do [aplicativo Desktop](/docs/pt/desktop)3418* A aba Code do [aplicativo Desktop](/docs/pt/desktop)
3394* O painel de chat da [extensão VS Code](/docs/pt/vs-code)3419* O painel de chat da [extensão do VS Code](/docs/pt/vs-code)
3395* [Sessões em nuvem](/docs/pt/claude-code-on-the-web) e [rotinas](/docs/pt/routines)3420* [Sessões na nuvem](/docs/pt/claude-code-on-the-web) e [rotinas](/docs/pt/routines)
3396 3421
3397Para um comando integrado que não consegue executar em uma dessas sessões, Claude Code ainda responde que o comando não está disponível em vez de enviá-lo para Claude. Antes da v2.1.274, apenas sessões em nuvem e rotinas enviavam um nome não correspondido para Claude. Antes da v2.1.273, elas também respondiam `Unknown command`.3422Para um comando integrado que não pode ser executado em uma dessas sessões, o Claude Code ainda responde que o comando não está disponível em vez de enviá-lo ao Claude. Antes da v2.1.274, somente sessões na nuvem e rotinas enviavam um nome sem correspondência ao Claude. Antes da v2.1.273, elas também respondiam `Unknown command`.
3398 3423
3399Claude Code não trata cada prompt que começa com `/` como um comando. Ele envia o prompt para Claude como uma mensagem normal quando a primeira palavra após o `/` começa com pontuação, como o `/--` que abre um comentário de doc Lean, ou é um caminho como `/var/log/syslog`.3424O Claude Code não trata todo prompt que começa com `/` como um comando. Ele envia o prompt ao Claude como uma mensagem normal quando a primeira palavra após a `/` começa com pontuação, como o `/--` que abre um comentário de documentação do Lean, ou é um caminho como `/var/log/syslog`.
3400 3425
3401Antes da v2.1.236, se você pressionasse `Enter` enquanto o menu de comando listava uma correspondência próxima para o nome que você digitou, Claude Code executava essa correspondência, então um erro de digitação como `/hepl` executava `/help` em vez de produzir essa mensagem.3426Antes da v2.1.236, se você pressionasse `Enter` enquanto o menu de comandos listava uma correspondência próxima para o nome digitado, o Claude Code executava essa correspondência, então um erro de digitação como `/hepl` executava `/help` em vez de produzir esta mensagem.
3402 3427
3403**O que fazer:**3428**O que fazer:**
3404 3429
3405* Execute o nome sugerido, ou digite `/` seguido de parte do nome para ver o que está disponível nessa sessão3430* Execute o nome sugerido, ou digite `/` seguido de parte do nome para ver o que está disponível nesta sessão
3406* Se Claude Code relata um comando documentado como desconhecido, verifique sua linha na [referência de comandos](/docs/pt/commands) para o requisito que nomeia3431* Se o Claude Code reportar um comando documentado como desconhecido, verifique sua linha na [referência de comandos](/docs/pt/commands) para ver o requisito que ela nomeia
3407 3432
3408<h3 id="diff-is-too-large-for-ultrareview">3433<h3 id="diff-is-too-large-for-ultrareview">
3409 Diff é muito grande para ultrareview3434 O diff é grande demais para o ultrareview
3410</h3>3435</h3>
3411 3436
3412O diff entre seu branch e o branch base, incluindo mudanças não confirmadas e preparadas, excede os limites de tamanho para um [ultrareview](/docs/pt/ultrareview), então `/code-review ultra` e o subcomando `claude ultrareview` recusam a revisão antes da sessão em nuvem iniciar. Uma revisão recusada não usa uma execução gratuita e não cobra créditos de uso. A mensagem nomeia os limites em vigor, o tamanho do seu diff e os arquivos que contribuem com a maioria das linhas alteradas. Antes da v2.1.216, a mensagem mostrava apenas as estatísticas de diff bruto.3437O diff entre seu branch e o branch base, incluindo alterações sem commit e preparadas, excede os limites de tamanho de um [ultrareview](/docs/pt/ultrareview), então `/code-review ultra` e o subcomando `claude ultrareview` recusam a revisão antes que a sessão na nuvem seja iniciada. Uma revisão recusada não consome uma execução gratuita e não cobra créditos de uso. A mensagem nomeia os limites em vigor, o tamanho do seu diff e os arquivos que mais contribuem com linhas alteradas. Antes da v2.1.216, a mensagem mostrava apenas as estatísticas brutas do diff.
3413 3438
3414```text theme={null}3439```text theme={null}
3415Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.3440Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.
3416```3441```
3417 3442
3418Revisar um pull request aplica os mesmos limites; essa forma da mensagem começa `PR #<N> is too large for ultrareview` e nomeia as contagens de arquivo e linha do PR.3443Revisar um pull request aplica os mesmos limites; essa forma da mensagem começa com `PR #<N> is too large for ultrareview` e nomeia as contagens de arquivos e linhas do PR.
3419 3444
3420**O que fazer:**3445**O que fazer:**
3421 3446
3422* Passe um branch base mais próximo do seu trabalho, como `/code-review ultra develop`, para que a revisão cubra apenas o diff contra esse branch3447* Passe um branch base mais próximo do seu trabalho, como `/code-review ultra develop`, para que a revisão abranja apenas o diff em relação a esse branch
3423* Divida a mudança em branches menores e revise cada uma. Os arquivos que a mensagem nomeia contribuem com a maioria das linhas alteradas, então comece movendo-os para seu próprio branch.3448* Divida a alteração em branches menores e revise cada um. Os arquivos que a mensagem nomeia contribuem com mais linhas alteradas, então comece movendo-os para seu próprio branch.
3424 3449
3425<h3 id="could-not-find-merge-base-with-the-base-branch">3450<h3 id="could-not-find-merge-base-with-the-base-branch">
3426 Não foi possível encontrar merge-base com o branch base3451 Não foi possível encontrar a merge-base com o branch base
3427</h3>3452</h3>
3428 3453
3429`/code-review ultra` e o subcomando `claude ultrareview` revisam o diff entre seu branch e um branch base, o que precisa de um commit que os dois compartilham. Quando `git merge-base` não encontra nenhum, Claude Code recusa a revisão antes da sessão em nuvem iniciar. Em um clone que Claude Code consegue verificar que é completo, com pelo menos um branch, ele volta para [revisar cada arquivo rastreado](/docs/pt/ultrareview#diff-limits-and-fallbacks) em vez de recusar. Você vê essa recusa quando o branch base não consegue ser encontrado, quando Claude Code não consegue verificar que seu clone é completo, ou no raro repositório onde o diff de árvore inteira não é possível, como o formato de objeto SHA-256.3454`/code-review ultra` e o subcomando `claude ultrareview` revisam o diff entre seu branch e um branch base, o que exige um commit que os dois compartilhem. Quando `git merge-base` não encontra nenhum, o Claude Code recusa a revisão antes que a sessão na nuvem seja iniciada. Em um clone que o Claude Code pode verificar como completo, com pelo menos um branch, ele recorre a [revisar todos os arquivos rastreados](/docs/pt/ultrareview#diff-limits-and-fallbacks) em vez de recusar. Você vê esta recusa quando o branch base não pode ser encontrado, quando o Claude Code não consegue verificar se seu clone está completo, ou no raro repositório em que o diff da árvore inteira não é possível, como com o formato de objeto SHA-256.
3430 3455
3431```text theme={null}3456```text theme={null}
3432Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.3457Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.
3433```3458```
3434 3459
3435A dica após a primeira sentença depende do que Claude Code observou:3460A dica após a primeira frase depende do que o Claude Code observou:
3436 3461
3437* **Você não passou um branch base**: Claude Code comparou contra o branch padrão do repositório e sugere passar seu base explicitamente, como no exemplo acima3462* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar seu branch base explicitamente, como no exemplo acima
3438* **Você passou um branch base que já estava em seu clone**: a dica lê ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3463* **Você passou um branch base que já estava no seu clone**: a dica diz ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``
3439* **Você passou um branch base que não estava em seu clone**: Claude Code o buscou de origin antes de comparar. A dica lê ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando Claude Code não consegue dizer se seu clone é raso, sugere `git fetch --unshallow origin` em vez disso. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para cada branch base buscado, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.3464* **Você passou um branch base que não estava no seu clone**: o Claude Code fez fetch dele a partir do origin antes de comparar. A dica diz ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando o Claude Code não consegue dizer se seu clone é shallow, ele sugere `git fetch --unshallow origin`. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para todo branch base obtido por fetch, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.
3440 3465
3441**O que fazer:**3466**O que fazer:**
3442 3467
3443* Se outro branch é seu base real, passe-o explicitamente: `/code-review ultra <branch>`3468* Se outro branch for sua base real, passe-o explicitamente: `/code-review ultra <branch>`
3444* Se seu clone pode não ter histórico completo, execute `git fetch --unshallow origin` e execute a revisão novamente3469* Se seu clone talvez não tenha o histórico completo, execute `git fetch --unshallow origin` e execute a revisão novamente
3445 3470
3446<h3 id="your-checkout-has-no-branches">3471<h3 id="your-checkout-has-no-branches">
3447 Seu checkout não tem branches3472 Seu checkout não tem branches
3448</h3>3473</h3>
3449 3474
3450Um checkout pode ter commits mas nenhum branch: se você executar `git init` seguido de `git fetch <url>` e `git checkout FETCH_HEAD`, você obtém um HEAD desanexado sem refs. Claude Code empacota seu repositório como um bundle git para carregá-lo para um [ultrareview](/docs/pt/ultrareview), e não consegue empacotar um repositório que não tem branches ou outras refs, então `/code-review ultra` e o subcomando `claude ultrareview` recusam a revisão antes da sessão em nuvem iniciar.3475Um checkout pode ter commits, mas nenhum branch: se você executar `git init` seguido de `git fetch <url>` e `git checkout FETCH_HEAD`, obtém um HEAD desanexado sem refs. O Claude Code empacota seu repositório como um git bundle para enviá-lo para um [ultrareview](/docs/pt/ultrareview), e não consegue empacotar um repositório que não tem branches nem outras refs, então `/code-review ultra` e o subcomando `claude ultrareview` recusam a revisão antes que a sessão na nuvem seja iniciada.
3451 3476
3452```text theme={null}3477```text theme={null}
3453Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.3478Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.
3454```3479```
3455 3480
3456Antes da v2.1.221, Claude Code tentava revisar cada arquivo rastreado nesse checkout, e o carregamento falhava.3481Antes da v2.1.221, o Claude Code tentava revisar todos os arquivos rastreados neste checkout, e o upload falhava.
3457 3482
3458**O que fazer:**3483**O que fazer:**
3459 3484
3460* Crie um branch em seu commit atual com `git checkout -b <name>`, depois execute a revisão novamente3485* Crie um branch no seu commit atual com `git checkout -b <name>` e execute a revisão novamente
3461 3486
3462<h3 id="no-github-account-is-connected-to-your-claude-account">3487<h3 id="no-github-account-is-connected-to-your-claude-account">
3463 Nenhuma conta GitHub está conectada à sua conta Claude3488 Nenhuma conta do GitHub está conectada à sua conta Claude
3464</h3>3489</h3>
3465 3490
3466Você executou `/code-review ultra <PR#>` ou `claude ultrareview <PR#>`, e antes de criar a sessão em nuvem Claude Code pergunta ao servidor se [a conta GitHub conectada à sua conta Claude](/docs/pt/ultrareview#review-a-pull-request) consegue alcançar o repositório do PR. Nenhuma conta está conectada, ou a conexão expirou, então o clone em nuvem falharia e Claude Code recusa o lançamento. Claude Code não gasta uma execução gratuita ou cobra créditos de uso para um lançamento recusado.3491Você executou `/code-review ultra <PR#>` ou `claude ultrareview <PR#>`, e antes de criar a sessão na nuvem o Claude Code pergunta ao servidor se [a conta do GitHub conectada à sua conta Claude](/docs/pt/ultrareview#review-a-pull-request) consegue acessar o repositório do PR. Nenhuma conta está conectada, ou a conexão expirou, então o clone na nuvem falharia e o Claude Code recusa a inicialização. O Claude Code não consome uma execução gratuita nem cobra créditos de uso por uma inicialização recusada.
3467 3492
3468```text theme={null}3493```text theme={null}
3469Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).3494Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).
3470```3495```
3471 3496
3472Quando [`/web-setup`](/docs/pt/web-quickstart#connect-from-your-terminal) não está disponível em sua sessão, a mensagem nomeia apenas o link claude.ai.3497Quando [`/web-setup`](/docs/pt/web-quickstart#connect-from-your-terminal) não está disponível na sua sessão, a mensagem nomeia apenas o link do claude.ai.
3473 3498
3474**O que fazer:**3499**O que fazer:**
3475 3500
3476* Execute `/web-setup` para conectar seu login GitHub CLI à sua conta Claude, ou conecte uma conta em [claude.ai/connect-github](https://claude.ai/connect-github)3501* Execute `/web-setup` para conectar seu login da GitHub CLI à sua conta Claude, ou conecte uma conta em [claude.ai/connect-github](https://claude.ai/connect-github)
3477* Execute a revisão novamente um minuto após conectar3502* Execute a revisão novamente um minuto após conectar
3478 3503
3479Antes da v2.1.248, Claude Code não verificava isso antes do lançamento.3504Antes da v2.1.248, o Claude Code não verificava isso antes da inicialização.
3480 3505
3481<h3 id="your-connected-github-account-cant-see-the-repository">3506<h3 id="your-connected-github-account-cant-see-the-repository">
3482 Sua conta GitHub conectada não consegue ver o repositório3507 Sua conta do GitHub conectada não consegue ver o repositório
3483</h3>3508</h3>
3484 3509
3485Você executou `/code-review ultra <PR#>` ou `claude ultrareview <PR#>`, e [a conta GitHub conectada à sua conta Claude](/docs/pt/ultrareview#review-a-pull-request) não consegue ler o repositório do PR, então o clone em nuvem falharia e Claude Code recusa o lançamento. Claude Code não gasta uma execução gratuita ou cobra créditos de uso para um lançamento recusado.3510Você executou `/code-review ultra <PR#>` ou `claude ultrareview <PR#>`, e [a conta do GitHub conectada à sua conta Claude](/docs/pt/ultrareview#review-a-pull-request) não consegue ler o repositório do PR, então o clone na nuvem falharia e o Claude Code recusa a inicialização. O Claude Code não consome uma execução gratuita nem cobra créditos de uso por uma inicialização recusada.
3486 3511
3487```text theme={null}3512```text theme={null}
3488Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.3513Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.
3489```3514```
3490 3515
3491Quando [`/web-setup`](/docs/pt/web-quickstart#connect-from-your-terminal) não está disponível em sua sessão, a mensagem nomeia apenas a instalação do app.3516Quando [`/web-setup`](/docs/pt/web-quickstart#connect-from-your-terminal) não está disponível na sua sessão, a mensagem nomeia apenas a instalação do aplicativo.
3492 3517
3493**O que fazer:**3518**O que fazer:**
3494 3519
3495* Se seu CLI `gh` local consegue ler o repositório, execute `/web-setup` para conectar esse login à sua conta Claude3520* Se sua CLI `gh` local consegue ler o repositório, execute `/web-setup` para conectar esse login à sua conta Claude
3496* Execute a revisão após a mudança3521* Execute a revisão novamente após a alteração
3497 3522
3498Antes da v2.1.248, Claude Code não verificava isso antes do lançamento.3523Antes da v2.1.248, o Claude Code não verificava isso antes da inicialização.
3499 3524
3500<h3 id="the-github-app-preflight-failed-transiently">3525<h3 id="the-github-app-preflight-failed-transiently">
3501 A verificação prévia do GitHub App falhou transitoriamente3526 A verificação prévia do GitHub App falhou temporariamente
3502</h3>3527</h3>
3503 3528
3504Você iniciou uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) a partir de um repositório local, e duas etapas falharam juntas. Claude Code não conseguiu construir ou carregar o bundle do seu repositório. Antes do carregamento, ele verificou se o serviço em nuvem consegue clonar o repositório do GitHub, e em vez de uma resposta definitiva, essa verificação terminou em um erro que uma tentativa novamente poderia limpar, como um erro de rede, um tempo limite ou um erro de servidor temporário. A mensagem completa começa com o que parou o bundle, por exemplo `Could not upload repo bundle (<error>)`, e termina com a sentença de verificação prévia:3529Você iniciou uma [sessão na nuvem](/docs/pt/claude-code-on-the-web) a partir de um repositório local, e duas etapas falharam juntas. O Claude Code não conseguiu criar ou enviar o bundle do seu repositório. Antes do upload, ele verificou se o serviço na nuvem consegue clonar o repositório a partir do GitHub e, em vez de uma resposta definitiva, essa verificação terminou em um erro que uma nova tentativa poderia resolver, como um erro de rede, um timeout ou um erro temporário do servidor. A mensagem completa começa com o que impediu o bundle, por exemplo `Could not upload repo bundle (<error>)`, e termina com a frase da verificação prévia:
3505 3530
3506```text theme={null}3531```text theme={null}
3507Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3532Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
3509 3534
3510**O que fazer:**3535**O que fazer:**
3511 3536
3512* Execute o comando novamente após um momento. Quando a verificação do GitHub passa, Claude Code consegue iniciar a sessão a partir de um clone do GitHub, então o carregamento que falhou não bloqueia mais o lançamento3537* Execute o comando novamente após um momento. Quando a verificação do GitHub passa, o Claude Code pode iniciar a sessão a partir de um clone do GitHub, então o upload que falhou não bloqueia mais a inicialização
3513* Se as tentativas novamente continuarem falhando, o início da mensagem nomeia o que parou o carregamento. Quando essa causa é algo que você consegue corrigir, corrija-a para que a sessão consegua iniciar a partir do seu repositório local em vez disso3538* Se as novas tentativas continuarem falhando, o início da mensagem nomeia o que impediu o upload. Quando essa causa for algo que você pode corrigir, corrija-a para que a sessão possa ser iniciada a partir do seu repositório local
3514 3539
3515Antes da v2.1.251, Claude Code terminava a mensagem com `Please set up GitHub on https://claude.ai/code` mesmo quando a verificação do GitHub falhou apenas transitoriamente, e o conselho de configuração não consegue limpar uma falha transitória.3540Antes da v2.1.251, o Claude Code terminava a mensagem com `Please set up GitHub on https://claude.ai/code` mesmo quando a verificação do GitHub falhava apenas temporariamente, e conselhos de configuração não podem resolver uma falha temporária.
3516 3541
3517<h3 id="the-repository-upload-cant-follow-a-git-setting">3542<h3 id="the-repository-upload-cant-follow-a-git-setting">
3518 O upload do repositório não consegue seguir uma configuração git3543 O upload do repositório não consegue seguir uma configuração do git
3519</h3>3544</h3>
3520 3545
3521Você iniciou uma [sessão em nuvem que carrega seu repositório local](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github), ou um [ultrareview](/docs/pt/ultrareview) de um branch, e o carregamento não consegue seguir uma das configurações git que decidem quais regras de atributo se aplicam aos seus arquivos. Se o carregamento tivesse continuado e perdido uma regra, um arquivo que git transforma antes de armazenar, como um que um filtro limpo criptografa, poderia chegar à nuvem como está no disco. Claude Code recusa o carregamento em vez disso, e nada é carregado:3546Você iniciou uma [sessão na nuvem que faz upload do seu repositório local](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github), ou um [ultrareview](/docs/pt/ultrareview) de um branch, e o upload não consegue seguir uma das configurações do git que decidem quais regras de atributos se aplicam aos seus arquivos. Se o upload prosseguisse e deixasse passar uma regra, um arquivo que o git transforma antes de armazená-lo, como um que um filtro clean criptografa, poderia chegar à nuvem como está no disco. Em vez disso, o Claude Code recusa o upload, e nada é enviado:
3522 3547
3523```text theme={null}3548```text theme={null}
3524Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository's .git/config or directly into your ~/.gitconfig, then retry.3549Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.
3525```3550```
3526 3551
3527A mensagem nomeia a configuração e onde está definida, e termina com a correção para o caso que você atingiu. A mesma recusa aparece para `core.attributesFile` e `attr.tree`, cada uma com sua própria correção.3552A mensagem nomeia a configuração e onde ela está definida, e termina com a correção para o caso que você encontrou. A mesma recusa aparece para `core.attributesFile` e `attr.tree`, cada uma com sua própria correção.
3528 3553
3529A mensagem pode nomear um arquivo de configuração que sua configuração git puxa através de uma diretiva `include` ou `includeIf`, mesmo quando a condição dessa diretiva não se aplica a este repositório.3554A mensagem pode nomear um arquivo de configuração que sua configuração do git inclui por meio de uma diretiva `include` ou `includeIf`, mesmo quando a condição dessa diretiva não se aplica a este repositório.
3530 3555
3531**O que fazer:**3556**O que fazer:**
3532 3557
3533* Aplique a correção na sentença final da mensagem3558* Aplique a correção indicada na frase final da mensagem
3534 3559
3535<h3 id="github-isnt-connected-to-your-claude-account">3560<h3 id="github-isnt-connected-to-your-claude-account">
3536 GitHub não está conectado à sua conta Claude3561 O GitHub não está conectado à sua conta Claude
3537</h3>3562</h3>
3538 3563
3539Você iniciou uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) a partir do seu repositório local, por exemplo com `/autofix-pr`. Nenhuma conta GitHub está conectada à sua conta Claude, ou a conexão expirou, então Claude Code recusa o lançamento:3564Você iniciou uma [sessão na nuvem](/docs/pt/claude-code-on-the-web) a partir do seu repositório local, por exemplo com `/autofix-pr`. Nenhuma conta do GitHub está conectada à sua conta Claude, ou a conexão expirou, então o Claude Code recusa a inicialização:
3540 3565
3541```text theme={null}3566```text theme={null}
3542GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github3567GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github
3543```3568```
3544 3569
3545Quando você cria uma rotina com [`/schedule`](/docs/pt/routines), a mesma mensagem aparece como uma nota de configuração que nomeia o repositório; a nota não bloqueia a criação da rotina.3570Quando você cria uma rotina com [`/schedule`](/docs/pt/routines), a mesma mensagem aparece como uma nota de configuração que nomeia o repositório; a nota não impede a criação da rotina.
3546 3571
3547**O que fazer:**3572**O que fazer:**
3548 3573
3549* Execute `/web-setup` para conectar seu login GitHub CLI à sua conta Claude, ou conecte uma conta em [claude.ai/connect-github](https://claude.ai/connect-github). Veja [GitHub authentication options](/docs/pt/claude-code-on-the-web#github-authentication-options) para como os dois diferem.3574* Execute `/web-setup` para conectar seu login da GitHub CLI à sua conta Claude, ou conecte uma conta em [claude.ai/connect-github](https://claude.ai/connect-github). Consulte [Opções de autenticação do GitHub](/docs/pt/claude-code-on-the-web#github-authentication-options) para ver como as duas diferem.
3550* Execute o comando novamente um minuto após conectar3575* Execute o comando novamente um minuto após conectar
3551 3576
3552Antes da v2.1.268, Claude Code relatava isso como uma falha temporária da verificação do Claude GitHub App e sugeria tentar novamente ou instalar o app; nenhum dos dois conecta uma conta GitHub.3577Antes da v2.1.268, o Claude Code reportava isso como uma falha temporária da verificação do Claude GitHub App e sugeria tentar novamente ou instalar o aplicativo; nenhuma das duas coisas conecta uma conta do GitHub.
3553 3578
3554<h3 id="single-sign-on-authorization-needed">3579<h3 id="single-sign-on-authorization-needed">
3555 Autorização de single sign-on necessária3580 Autorização de single sign-on necessária
3556</h3>3581</h3>
3557 3582
3558Você executou [`/install-github-app`](/docs/pt/github-actions#quick-setup) e escolheu um repositório cuja organização aplica single sign-on SAML. Antes da configuração, Claude Code verifica seu acesso ao repositório com o GitHub CLI, e GitHub recusou essa verificação porque seu token `gh` ainda não está autorizado para a organização. O assistente mostra o aviso com as etapas para autorizar:3583Você executou [`/install-github-app`](/docs/pt/github-actions#quick-setup) e escolheu um repositório cuja organização exige single sign-on SAML. Antes da configuração, o Claude Code verifica seu acesso ao repositório com a GitHub CLI, e o GitHub recusou essa verificação porque seu token `gh` ainda não está autorizado para a organização. O assistente mostra o aviso com as etapas para autorizar:
3559 3584
3560```text theme={null}3585```text theme={null}
3561Single sign-on authorization needed3586Single sign-on authorization needed
3564 3589
3565**O que fazer:**3590**O que fazer:**
3566 3591
3567* Re-autorize seu login GitHub CLI com os escopos `repo` e `workflow` executando `gh auth refresh -h github.com -s repo,workflow`, e autorize a organização quando GitHub solicitar single sign-on3592* Autorize novamente seu login da GitHub CLI com os escopos `repo` e `workflow` executando `gh auth refresh -h github.com -s repo,workflow`, e autorize a organização quando o GitHub solicitar o single sign-on
3568* Se você autentica com um token de acesso pessoal em `GH_TOKEN`, abra [github.com/settings/tokens](https://github.com/settings/tokens), selecione **Configure SSO** no token e autorize a organização3593* Se você se autentica com um token de acesso pessoal em `GH_TOKEN`, abra [github.com/settings/tokens](https://github.com/settings/tokens), selecione **Configure SSO** no token e autorize a organização
3569* Execute `/install-github-app` novamente3594* Execute `/install-github-app` novamente
3570 3595
3571Antes da v2.1.273, Claude Code mostrava o aviso `Admin permissions required` para essa condição em vez disso.3596Antes da v2.1.273, o Claude Code mostrava o aviso `Admin permissions required` para essa condição.
3572 3597
3573<h3 id="failed-to-resume-the-conversation">3598<h3 id="failed-to-resume-the-conversation">
3574 Falha ao retomar a conversa3599 Falha ao retomar a conversa
3575</h3>3600</h3>
3576 3601
3577Claude Code não conseguiu ler ou processar a transcrição salva para a sessão que você selecionou do [seletor `claude --resume`](/docs/pt/sessions#use-the-session-picker), então encerra o processo em vez de continuar em um estado parcialmente carregado. A mensagem inclui o comando para tentar novamente:3602O Claude Code não conseguiu ler ou processar a transcrição salva da sessão que você selecionou no [seletor `claude --resume`](/docs/pt/sessions#use-the-session-picker), então encerra o processo em vez de continuar em um estado parcialmente carregado. A mensagem inclui o comando para tentar novamente:
3578 3603
3579```text theme={null}3604```text theme={null}
3580Failed to resume the conversation.3605Failed to resume the conversation.
3581Run claude --resume <session-id> to retry, or claude to start a new session.3606Run claude --resume <session-id> to retry, or claude to start a new session.
3582```3607```
3583 3608
3584Claude Code sai com código 1 após mostrar a mensagem. O seletor `/resume` dentro de uma sessão em execução relata `Failed to resume conversation` na conversa em vez disso, e sua sessão atual continua em execução. Antes da v2.1.216, uma retomada que falhou do seletor `claude --resume` permanecia no spinner `Resuming conversation…` indefinidamente em vez de mostrar essa mensagem.3609O Claude Code sai com código 1 após mostrar a mensagem. O seletor `/resume` dentro de uma sessão em execução reporta `Failed to resume conversation` na conversa, e sua sessão atual continua em execução. Antes da v2.1.216, uma retomada com falha a partir do seletor `claude --resume` permanecia no indicador `Resuming conversation…` indefinidamente em vez de mostrar esta mensagem.
3585 3610
3586**O que fazer:**3611**O que fazer:**
3587 3612
3588* Execute `claude --resume <session-id>` com o ID da sessão da mensagem para tentar novamente3613* Execute `claude --resume <session-id>` com o ID da sessão da mensagem para tentar novamente
3589* Se cada tentativa novamente falhar da mesma forma, execute `claude update` e retome novamente. Versões antes da v2.1.275 falham a retomada quando a transcrição salva contém uma entrada que não conseguem ler.3614* Se todas as novas tentativas falharem da mesma forma, execute `claude update` e retome novamente. Versões anteriores à v2.1.275 falham na retomada quando a transcrição salva contém uma entrada que elas não conseguem ler.
3590* Se a tentativa novamente falhar, execute `claude` para iniciar uma nova sessão3615* Se a nova tentativa falhar novamente, execute `claude` para iniciar uma nova sessão
3591 3616
3592<h3 id="no-conversation-found-with-the-session-id">3617<h3 id="no-conversation-found-with-the-session-id">
3593 Nenhuma conversa encontrada com o ID da sessão3618 Nenhuma conversa encontrada com o ID da sessão
3594</h3>3619</h3>
3595 3620
3596Você passou um ID de sessão para `claude --resume <session-id>` e nenhuma transcrição salva correspondeu:3621Você passou um ID de sessão para `claude --resume <session-id>` e nenhuma transcrição salva correspondeu a ele:
3597 3622
3598```text theme={null}3623```text theme={null}
3599No conversation found with session ID: <session-id>3624No conversation found with session ID: <session-id>
3600```3625```
3601 3626
3602Claude Code sai com código 1 após mostrar a mensagem. Claude Code [busca o projeto atual primeiro, depois cada outro projeto nesta máquina](/docs/pt/sessions#resume-a-session) para o ID. Antes da v2.1.223, a busca parava no diretório do projeto atual e seus git worktrees, então retome do diretório onde a sessão trabalhou pela última vez.3627O Claude Code sai com código 1 após mostrar a mensagem. O Claude Code [procura o ID primeiro no projeto atual e depois em todos os outros projetos desta máquina](/docs/pt/sessions#resume-a-session). Antes da v2.1.223, a busca parava no diretório do projeto atual e em seus worktrees git, então retome a partir do diretório em que a sessão trabalhou por último.
3603 3628
3604Causas comuns:3629Causas comuns:
3605 3630
3606* **ID digitado incorretamente**: para uma execução não interativa, o ID é o campo `session_id` da saída [`--output-format json`](/docs/pt/headless#get-structured-output)3631* **ID digitado incorretamente**: para uma execução não interativa, o ID é o campo `session_id` da [saída de `--output-format json`](/docs/pt/headless#get-structured-output)
3607* **Transcrição deletada**: Claude Code remove transcrições após o [período de retenção](/docs/pt/sessions#where-transcripts-are-stored), 30 dias por padrão, seguindo as [regras de limpeza de retenção](/docs/pt/claude-directory#cleaned-up-automatically)3632* **Transcrição excluída**: o Claude Code remove transcrições após o [período de retenção](/docs/pt/sessions#where-transcripts-are-stored), 30 dias por padrão, seguindo as [regras de limpeza por retenção](/docs/pt/claude-directory#cleaned-up-automatically)
3608* **Máquina diferente**: Claude Code armazena transcrições localmente, então retome a sessão na máquina onde foi executada3633* **Máquina diferente**: o Claude Code armazena transcrições localmente, então retome a sessão na máquina em que ela foi executada
3609* **Cópias duplicadas**: se você copiou um diretório de projeto sob `~/.claude/projects` para que duas transcrições carreguem o mesmo ID, Claude Code relata essa mensagem em vez de retomar uma cópia arbitrariamente3634* **Cópias duplicadas**: se você copiou um diretório de projeto em `~/.claude/projects` de forma que duas transcrições tenham o mesmo ID, o Claude Code reporta esta mensagem em vez de retomar uma das cópias arbitrariamente
3610 3635
3611**O que fazer:**3636**O que fazer:**
3612 3637
3613* Para uma sessão interativa, abra o [seletor de sessão](/docs/pt/sessions#use-the-session-picker) com `claude --resume` e pressione `Ctrl+A` para ampliá-lo para cada projeto nesta máquina, depois selecione a sessão3638* Para uma sessão interativa, abra o [seletor de sessões](/docs/pt/sessions#use-the-session-picker) com `claude --resume` e pressione `Ctrl+A` para ampliá-lo a todos os projetos desta máquina, e então selecione a sessão
3614* Sessões criadas com `claude -p` ou o [Agent SDK](/docs/pt/agent-sdk/overview) não aparecem no seletor, então re-verifique o ID contra o `session_id` que sua execução original imprimiu3639* Sessões criadas com `claude -p` ou com o [Agent SDK](/docs/pt/agent-sdk/overview) não aparecem no seletor, então verifique novamente o ID em relação ao `session_id` que sua execução original imprimiu
3615 3640
3616<h3 id="windows-reported-an-error-ebadf">3641<h3 id="windows-reported-an-error-ebadf">
3617 Windows relatou um erro (EBADF) quando Claude Code leu o arquivo de transcrição desta sessão3642 O Windows relatou um erro (EBADF) quando o Claude Code leu o arquivo de transcrição desta sessão
3618</h3>3643</h3>
3619 3644
3620Você retomou uma sessão no Windows, seu arquivo de [transcrição](/docs/pt/sessions#where-transcripts-are-stored) salvo abriu normalmente, e a leitura dele então falhou com o erro do sistema EBADF. O erro do sistema não diz por que a leitura falhou, então a mensagem sugere causas prováveis e o que tentar:3645Você retomou uma sessão no Windows, o [arquivo de transcrição](/docs/pt/sessions#where-transcripts-are-stored) salvo dela foi aberto normalmente, e a leitura dele então falhou com o erro de sistema EBADF. O erro de sistema não diz por que a leitura falhou, então a mensagem sugere causas prováveis e o que tentar:
3621 3646
3622```text theme={null}3647```text theme={null}
3623Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.3648Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.
3624```3649```
3625 3650
3626A mensagem segue a linha de falha própria do comando, como `Failed to resume session <session-id>`. Um comando `claude --resume` ou [`claude -p`](/docs/pt/headless) sai com código 1 após mostrar. Depois de `/resume` dentro de uma sessão, sua sessão atual continua em execução.3651A mensagem vem depois da própria linha de falha do comando, como `Failed to resume session <session-id>`. Um comando `claude --resume` ou [`claude -p`](/docs/pt/headless) termina com código 1 depois de exibi-la. Depois de `/resume` dentro de uma sessão, sua sessão atual continua em execução.
3627 3652
3628**O que fazer:**3653**O que fazer:**
3629 3654
3630* Exclua a pasta que contém suas transcrições de sessão de software que escaneia ou intercepta leituras de arquivo, como ferramentas de segurança, criptografia ou gerenciamento de endpoint. As transcrições vivem sob `%USERPROFILE%\.claude\projects` por padrão, ou sob o diretório que [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars) nomeia3655* Exclua a pasta que contém as transcrições das suas sessões de softwares que verificam ou interceptam leituras de arquivos, como ferramentas de segurança, criptografia ou gerenciamento de endpoints. As transcrições ficam em `%USERPROFILE%\.claude\projects` por padrão, ou no diretório indicado por [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars)
3631* Se você não conseguir adicionar uma exclusão, adicione Claude Code às aplicações permitidas desse software em vez disso3656* Se você não puder adicionar uma exclusão, adicione o Claude Code aos aplicativos permitidos desse software
3632* Retome a sessão novamente3657* Retome a sessão novamente
3633 3658
3634Antes da v2.1.282, a falha veio sem explicação: `claude --resume <session-id>` terminou em `Failed to resume session <session-id>`, e uma execução `-p` imprimiu apenas o texto de erro do sistema, como `Failed to resume session: EBADF: bad file descriptor, read`.3659Antes da v2.1.282, a falha vinha sem explicação: `claude --resume <session-id>` terminava em `Failed to resume session <session-id>`, e uma execução `-p` exibia apenas o texto do erro de sistema, como `Failed to resume session: EBADF: bad file descriptor, read`.
3635 3660
3636<h3 id="cannot-switch-renderers-in-this-session">3661<h3 id="cannot-switch-renderers-in-this-session">
3637 Não é possível alternar renderizadores nesta sessão3662 Não é possível trocar de renderizador nesta sessão
3638</h3>3663</h3>
3639 3664
3640Quando você alterna renderizadores, Claude Code reinicia seu processo. Você executou [`/tui`](/docs/pt/fullscreen#enable-fullscreen-rendering) em uma sessão que Claude Code recusa reiniciar, então não alterna e não salva nada. Qual mensagem você vê diz a você a causa:3665Quando você troca de renderizador, o Claude Code reinicia seu processo. Você executou [`/tui`](/docs/pt/fullscreen#enable-fullscreen-rendering) em uma sessão que o Claude Code se recusa a reiniciar, então ele não troca e não salva nada. A mensagem que você vê indica a causa:
3641 3666
3642* `Cannot switch renderers while work is running in the background`: você tem trabalho em background em execução que uma reinicialização abandonaria, como um shell em background ou um subagente. Aguarde o trabalho terminar ou pare-o com [`/tasks`](/docs/pt/commands), depois execute `/tui fullscreen` ou `/tui default` novamente3667* `Cannot switch renderers while work is running in the background`: há trabalho em segundo plano em execução que uma reinicialização abandonaria, como um shell em segundo plano ou um subagente. Aguarde o trabalho terminar ou interrompa-o com [`/tasks`](/docs/pt/commands) e, em seguida, execute `/tui fullscreen` ou `/tui default` novamente
3643* `Cannot switch renderers in this session`: a sessão tem restrições que Claude Code não consegue passar para o processo reiniciado. Antes da v2.1.234, Claude Code reiniciava mesmo assim e a sessão relançada executava sem elas3668* `Cannot switch renderers in this session`: a sessão tem restrições que o Claude Code não consegue repassar ao processo reiniciado. Antes da v2.1.234, o Claude Code reiniciava mesmo assim e a sessão relançada era executada sem elas
3644 3669
3645Na mensagem de restrições, a parte entre parênteses nomeia as restrições que Claude Code encontrou:3670Na mensagem de restrições, a parte entre parênteses indica as restrições que o Claude Code encontrou:
3646 3671
3647```text theme={null}3672```text theme={null}
3648Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.3673Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.
3650 3675
3651Cada motivo que a mensagem pode mostrar entre parênteses:3676Cada motivo que a mensagem pode mostrar entre parênteses:
3652 3677
3653* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: você iniciou a sessão com uma flag que Claude Code não passa de volta para o processo reiniciado. Essas flags incluem [`--system-prompt`](/docs/pt/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, uma lista de permissão [`--tools`](/docs/pt/cli-reference#cli-flags), [`--setting-sources`](/docs/pt/cli-reference#cli-flags) e [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags)3678* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: você iniciou a sessão com uma flag que o Claude Code não repassa ao processo reiniciado. Essas flags incluem [`--system-prompt`](/docs/pt/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, uma allowlist de [`--tools`](/docs/pt/cli-reference#cli-flags), [`--setting-sources`](/docs/pt/cli-reference#cli-flags) e [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags)
3654* `permission rules set for this session only`: uma [atualização de permissão](/docs/pt/hooks#permission-update-entries) de um hook ou chamador SDK adicionou regras de negação ou pergunta com o destino `session`. Regras de permissão de escopo de sessão não disparam a recusa. Uma reinicialização as remove, e Claude Code solicita novamente em vez disso3679* `permission rules set for this session only`: uma [atualização de permissão](/docs/pt/hooks#permission-update-entries) vinda de um hook ou de um chamador do SDK adicionou regras deny ou ask com o destino `session`. Regras allow com escopo de sessão não acionam a recusa. Uma reinicialização as descarta, e o Claude Code volta a solicitar confirmação
3655* `ask-before-running rules with no command-line form`: uma atualização de permissão de um hook ou chamador SDK adicionou regras de pergunta ao lado das regras que Claude Code passa de volta como `--allowed-tools` e `--disallowed-tools`. Nenhuma flag existe para regras de pergunta3680* `ask-before-running rules with no command-line form`: uma atualização de permissão vinda de um hook ou de um chamador do SDK adicionou regras ask junto com as regras que o Claude Code repassa como `--allowed-tools` e `--disallowed-tools`. Não existe flag para regras ask
3656* `permission rules a command line cannot carry intact` e `added directories a command line cannot carry intact`: uma atualização de permissão adicionou uma regra ou caminho de diretório no meio da sessão. A linha de comando do processo reiniciado não consegue carregar seu texto como o mesmo valor3681* `permission rules a command line cannot carry intact` e `added directories a command line cannot carry intact`: uma atualização de permissão adicionou uma regra ou um caminho de diretório no meio da sessão. A linha de comando do processo reiniciado não consegue transportar o texto dela como o mesmo valor
3657 3682
3658**O que fazer:**3683**O que fazer:**
3659 3684
3660* Em uma sessão iniciada sem essas restrições, execute `/tui fullscreen`, ou `/tui default` para alternar de volta. Claude Code salva a configuração [`tui`](/docs/pt/settings-reference#tui) lá3685* Em uma sessão iniciada sem essas restrições, execute `/tui fullscreen`, ou `/tui default` para voltar. O Claude Code salva a [configuração `tui`](/docs/pt/settings-reference#tui) ali
3661 3686
3662<h3 id="couldnt-open-claude-desktop">3687<h3 id="couldnt-open-claude-desktop">
3663 Não foi possível abrir Claude Desktop3688 Não foi possível abrir o Claude Desktop
3664</h3>3689</h3>
3665 3690
3666Você executou [`/desktop`](/docs/pt/desktop#coming-from-the-cli) ou seu alias `/app` em uma sessão, ou [`claude --desktop`](/docs/pt/cli-reference#cli-flags) em seu shell, e o comando do sistema que Claude Code usa para abrir Claude Desktop falhou. Depois de `/desktop`, a sessão permanece no terminal; `claude --desktop` imprime a mensagem sem o prefixo `Error:` e sai com status 1.3691Você executou [`/desktop`](/docs/pt/desktop#coming-from-the-cli) ou seu alias `/app` em uma sessão, ou [`claude --desktop`](/docs/pt/cli-reference#cli-flags) no seu shell, e o comando de sistema que o Claude Code usa para abrir o Claude Desktop falhou. Depois de `/desktop`, a sessão permanece no terminal; `claude --desktop` exibe a mensagem sem o prefixo `Error:` e termina com status 1.
3667 3692
3668O texto entre parênteses nomeia o comando que falhou, com seu status de saída e a primeira linha de sua saída de erro quando a produziu. No macOS esse comando é `open`, como neste exemplo; no Windows é `rundll32`:3693O texto entre parênteses indica o comando que falhou, com seu status de saída e a primeira linha de sua saída de erro quando ele os produziu. No macOS, esse comando é `open`, como neste exemplo; no Windows, é `rundll32`:
3669 3694
3670```text theme={null}3695```text theme={null}
3671Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.3696Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.
3673 3698
3674**O que fazer:**3699**O que fazer:**
3675 3700
3676* Abra Claude Desktop você mesmo, depois execute `/desktop` ou `claude --desktop` novamente3701* Abra o Claude Desktop você mesmo e, em seguida, execute `/desktop` ou `claude --desktop` novamente
3677* Para ler a saída de erro completa do comando que falhou, ative o log de debug com `/debug` e execute `/desktop` novamente, ou execute `claude --desktop --debug-file <path>`, depois verifique o log de debug3702* Para ler a saída de erro completa do comando que falhou, ative o log de depuração com `/debug` e execute `/desktop` novamente, ou execute `claude --desktop --debug-file <path>`, e então verifique o log de depuração
3678 3703
3679Antes da v2.1.285, a mensagem terminava `Open Claude Desktop and run /desktop again.` Antes da v2.1.275, era `Failed to open Claude Desktop. Please try opening it manually.` e não dizia o que falhou.3704Antes da v2.1.285, a mensagem terminava com `Open Claude Desktop and run /desktop again.` Antes da v2.1.275, ela era `Failed to open Claude Desktop. Please try opening it manually.` e não dizia o que havia falhado.
3680 3705
3681<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3706<h3 id="terminal-setup-left-your-zed-keymap-unchanged">
3682 /terminal-setup deixou seu mapa de teclas Zed inalterado3707 /terminal-setup deixou seu keymap do Zed inalterado
3683</h3>3708</h3>
3684 3709
3685Você executou [`/terminal-setup`](/docs/pt/terminal-config#enter-multiline-prompts) em Zed, e Claude Code não conseguiu completar a atualização do seu `keymap.json` do Zed, então deixou o arquivo como estava.3710Você executou [`/terminal-setup`](/docs/pt/terminal-config#enter-multiline-prompts) no Zed, e o Claude Code não conseguiu concluir a atualização do seu `keymap.json` do Zed, então deixou o arquivo como estava.
3686 3711
3687Cada mensagem nomeia o caminho para seu mapa de teclas e termina com o bloco de atalho de teclado para adicionar você mesmo:3712Cada mensagem indica o caminho do seu keymap e termina com o bloco de atalho de teclado para você mesmo adicionar:
3688 3713
3689```text theme={null}3714```text theme={null}
3690Couldn't update your Zed keymap, so it was left unchanged.3715Couldn't update your Zed keymap, so it was left unchanged.
3692{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }3717{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
3693```3718```
3694 3719
3695A primeira linha da mensagem nomeia a causa:3720A primeira linha da mensagem indica a causa:
3696 3721
3697* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code não conseguiu ler o arquivo, por exemplo por causa de permissões de arquivo3722* `Couldn't read your Zed keymap, so it was left unchanged.`: o Claude Code não conseguiu ler o arquivo, por exemplo por causa de permissões de arquivo
3698* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: o arquivo leu bem mas não é analisado como um array de blocos de atalho de teclado, mesmo com comentários `//` e vírgulas finais permitidas3723* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: o arquivo foi lido corretamente, mas não é interpretado como um array de blocos de atalhos de teclado, mesmo permitindo comentários `//` e vírgulas finais
3699* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code não conseguiu copiar o arquivo para um backup `.bak` ao lado dele, então não mudou nada3724* `Couldn't back up your Zed keymap; not modifying it.`: o Claude Code não conseguiu copiar o arquivo para um backup `.bak` ao lado dele, então não alterou nada
3700* `Couldn't update your Zed keymap, so it was left unchanged.`: o resultado mesclado não verificou como um mapa de teclas válido carregando o atalho de teclado, então Claude Code o descartou em vez de escrever. Um bloco de atalho de teclado com uma chave duplicada pode causar isso3725* `Couldn't update your Zed keymap, so it was left unchanged.`: o resultado mesclado não foi verificado como um keymap válido contendo o atalho, então o Claude Code o descartou em vez de gravá-lo. Um bloco de atalho de teclado com uma chave duplicada pode causar isso
3701 3726
3702**O que fazer:**3727**O que fazer:**
3703 3728
3704* Copie o bloco da mensagem para o array de nível superior em seu `keymap.json` no caminho que a mensagem nomeia3729* Copie o bloco da mensagem para o array de nível superior do seu `keymap.json` no caminho indicado pela mensagem
3705* Para `isn't a readable list of keybindings`, corrija o erro de sintaxe, ou faça o valor de nível superior do arquivo um array, depois execute `/terminal-setup` novamente3730* Para `isn't a readable list of keybindings`, corrija o erro de sintaxe, ou faça com que o valor de nível superior do arquivo seja um array, e então execute `/terminal-setup` novamente
3706 3731
3707Antes da v2.1.247, `/terminal-setup` não conseguia analisar um mapa de teclas Zed que usava comentários `//` ou vírgulas finais, e substituía o arquivo inteiro por apenas seu próprio atalho de teclado enquanto relatava o atalho de teclado como instalado. Para restaurar um mapa de teclas que uma versão anterior substituiu, use o arquivo de backup `.bak` descrito em [Enter multiline prompts](/docs/pt/terminal-config#enter-multiline-prompts).3732Antes da v2.1.247, `/terminal-setup` não conseguia interpretar um keymap do Zed que usasse comentários `//` ou vírgulas finais, e substituía o arquivo inteiro apenas pelo seu próprio atalho enquanto informava que o atalho havia sido instalado. Para restaurar um keymap que uma versão anterior substituiu, use o arquivo de backup `.bak` descrito em [Inserir prompts de várias linhas](/docs/pt/terminal-config#enter-multiline-prompts).
3708 3733
3709<h3 id="skill-usage-reports-are-not-available-on-this-connection">3734<h3 id="skill-usage-reports-are-not-available-on-this-connection">
3710 Relatórios de uso de skill não estão disponíveis nesta conexão3735 Relatórios de uso de skills não estão disponíveis nesta conexão
3711</h3>3736</h3>
3712 3737
3713Você executou [`/skill-doctor`](/docs/pt/skills#find-unused-skills) sobre [Remote Control](/docs/pt/remote-control), do seu telefone ou navegador. Claude Code não envia o relatório de uso de skill sobre Remote Control e responde com essa mensagem em vez disso:3738Você executou [`/skill-doctor`](/docs/pt/skills#find-unused-skills) pelo [Remote Control](/docs/pt/remote-control), a partir do seu celular ou navegador. O Claude Code não envia o relatório de uso de skills pelo Remote Control e responde com esta mensagem:
3714 3739
3715```text theme={null}3740```text theme={null}
3716Skill usage reports are not available on this connection.3741Skill usage reports are not available on this connection.
3718 3743
3719**O que fazer:**3744**O que fazer:**
3720 3745
3721* Execute `/skill-doctor` no terminal na máquina onde a sessão está em execução, ou execute `claude -p "/skill-doctor"` lá3746* Execute `/skill-doctor` no terminal da máquina onde a sessão está sendo executada, ou execute `claude -p "/skill-doctor"` ali
3722 3747
3723<h3 id="custom-output-styles-cant-be-selected-over-remote-control">3748<h3 id="custom-output-styles-cant-be-selected-over-remote-control">
3724 Estilos de saída personalizados não podem ser selecionados sobre Remote Control3749 Estilos de saída personalizados não podem ser selecionados pelo Remote Control
3725</h3>3750</h3>
3726 3751
3727Você executou [`/output-style`](/docs/pt/output-styles#change-your-output-style) do aplicativo móvel ou web via [Remote Control](/docs/pt/remote-control), ou o comando chegou em uma mensagem retransmitida para a sessão. Porque tal volta pode não vir do proprietário da conta, Claude Code lista e seleciona apenas [estilos integrados](/docs/pt/output-styles#built-in-output-styles) nela, e adiciona esse aviso sempre que o comando lista os estilos ou não reconhece o nome que você deu. Um nome de [estilo personalizado](/docs/pt/output-styles#create-a-custom-output-style) obtém a mesma resposta que um nome que não existe:3752Você executou [`/output-style`](/docs/pt/output-styles#change-your-output-style) pelo aplicativo móvel ou pela web via [Remote Control](/docs/pt/remote-control), ou o comando chegou em uma mensagem retransmitida para a sessão. Como esse turno pode não vir do proprietário da conta, o Claude Code lista e seleciona apenas [estilos integrados](/docs/pt/output-styles#built-in-output-styles) nele, e adiciona este aviso sempre que o comando lista os estilos ou não reconhece o nome que você forneceu. O nome de um [estilo personalizado](/docs/pt/output-styles#create-a-custom-output-style) recebe a mesma resposta que um nome que não existe:
3728 3753
3729```text theme={null}3754```text theme={null}
3730Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.3755Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.
3733**O que fazer:**3758**O que fazer:**
3734 3759
3735* Escolha um estilo integrado, por exemplo `/output-style concise`3760* Escolha um estilo integrado, por exemplo `/output-style concise`
3736* Para usar um estilo personalizado, defina [`outputStyle`](/docs/pt/settings-reference#outputstyle) em `.claude/settings.local.json` do projeto, ou execute `/output-style <style>` no terminal da própria sessão se tiver um3761* Para usar um estilo personalizado, defina [`outputStyle`](/docs/pt/settings-reference#outputstyle) no `.claude/settings.local.json` do projeto, ou execute `/output-style <style>` no próprio terminal da sessão, se ela tiver um
3737 3762
3738<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">3763<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">
3739 Estilos de saída são salvos em configurações locais que esta sessão não carrega3764 Estilos de saída são salvos nas configurações locais, que esta sessão não carrega
3740</h3>3765</h3>
3741 3766
3742Você tentou alternar [estilos de saída](/docs/pt/output-styles) com `/output-style <style>` ou `/config outputStyle=<style>` em uma sessão cujas fontes de configuração excluem `local`. Exemplos são uma sessão [Agent SDK](/docs/pt/agent-sdk/typescript) cujo [`settingSources`](/docs/pt/agent-sdk/typescript#options) deixa de fora `"local"` e uma sessão CLI iniciada com um valor [`--setting-sources`](/docs/pt/cli-reference#cli-flags) que deixa de fora `local`. Ambos os comandos salvam o estilo em `.claude/settings.local.json`, um arquivo que tal sessão nunca lê de volta, então Claude Code recusa em vez de escrever uma configuração que não teria efeito:3767Você tentou trocar de [estilo de saída](/docs/pt/output-styles) com `/output-style <style>` ou `/config outputStyle=<style>` em uma sessão cujas fontes de configuração excluem `local`. Exemplos são uma sessão do [Agent SDK](/docs/pt/agent-sdk/typescript) cujo [`settingSources`](/docs/pt/agent-sdk/typescript#options) deixa de fora `"local"` e uma sessão da CLI iniciada com um valor de [`--setting-sources`](/docs/pt/cli-reference#cli-flags) que deixa de fora `local`. Ambos os comandos salvam o estilo em `.claude/settings.local.json`, um arquivo que essa sessão nunca lê de volta, então o Claude Code recusa em vez de gravar uma configuração que não teria efeito:
3743 3768
3744```text theme={null}3769```text theme={null}
3745Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.3770Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.
3747 3772
3748**O que fazer:**3773**O que fazer:**
3749 3774
3750* Adicione `local` às fontes de configuração da sessão e alterne novamente3775* Adicione `local` às fontes de configuração da sessão e troque novamente
3751* Defina a chave [`outputStyle`](/docs/pt/settings-reference#outputstyle) em um arquivo de configurações que a sessão carrega, como `.claude/settings.json` no projeto ou `~/.claude/settings.json`. No SDK TypeScript, defina `outputStyle` dentro do objeto `settings` inline em vez disso; veja [Activate an output style](/docs/pt/agent-sdk/modifying-system-prompts#activate-an-output-style)3776* Defina a chave [`outputStyle`](/docs/pt/settings-reference#outputstyle) em um arquivo de configurações que a sessão carrega, como `.claude/settings.json` no projeto ou `~/.claude/settings.json`. No SDK TypeScript, defina `outputStyle` dentro do objeto `settings` inline; consulte [Ativar um estilo de saída](/docs/pt/agent-sdk/modifying-system-prompts#activate-an-output-style)
3752 3777
3753<h2 id="plugin-errors">3778<h2 id="plugin-errors">
3754 Erros de plugin3779 Erros de plugin
4514**O que fazer:**4539**O que fazer:**
4515 4540
4516* Geralmente nada: a mensagem completa vai para Claude como um erro de ferramenta, e Claude tenta novamente com o caminho direto que nomeia. Para um edit de arquivo bloqueado, a visualização de conversa mostra apenas uma linha curta `Error editing file`; a mensagem completa aparece na visualização de transcrição, que você abre com `Ctrl+O`. Um comando bloqueado a imprime em sua saída de comando.4541* Geralmente nada: a mensagem completa vai para Claude como um erro de ferramenta, e Claude tenta novamente com o caminho direto que nomeia. Para um edit de arquivo bloqueado, a visualização de conversa mostra apenas uma linha curta `Error editing file`; a mensagem completa aparece na visualização de transcrição, que você abre com `Ctrl+O`. Um comando bloqueado a imprime em sua saída de comando.
4517* Se o bloqueio se repetir no mesmo arquivo, o caminho provavelmente passa por um symlink confirmado cujo alvo contém `..`, como `docs/current -> ../README.md`; peça a Claude para editar o arquivo de destino por seu caminho real em vez de através do link4542* Se o bloqueio se repetir no mesmo arquivo, o caminho provavelmente passa por um symlink incluído em um commit cujo alvo contém `..`, como `docs/current -> ../README.md`; peça a Claude para editar o arquivo de destino por seu caminho real em vez de através do link
4518 4543
4519<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">4544<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">
4520 Write ou command bloqueado porque o caminho nomeia um local de rede4545 Write ou command bloqueado porque o caminho nomeia um local de rede
4583```4608```
4584 4609
4585* **`running in another terminal`**: um terminal mantém a conversa, por exemplo um onde você a retomou com `claude --resume` ou `/resume`. A linha também mostra `Open in a terminal`.4610* **`running in another terminal`**: um terminal mantém a conversa, por exemplo um onde você a retomou com `claude --resume` ou `/resume`. A linha também mostra `Open in a terminal`.
4586* **`already open in another running Claude session`**: outro processo Claude Code não-interativo a mantém, por exemplo um processo de [sessão em background](/docs/pt/agent-view#the-supervisor-process) para a mesma conversa que ainda não saiu.4611* **`already open in another running Claude session`**: outro processo Claude Code não interativo a mantém, por exemplo um processo de [sessão em background](/docs/pt/agent-view#the-supervisor-process) para a mesma conversa que ainda não saiu.
4587 4612
4588Claude Code salva uma resposta que você digitou ao abrir a linha e a envia como o próximo prompt da sessão quando a sessão iniciar novamente.4613Claude Code salva uma resposta que você digitou ao abrir a linha e a envia como o próximo prompt da sessão quando a sessão iniciar novamente.
4589 4614
4619Você tentou deletar uma [sessão em background](/docs/pt/agent-view#what-deleting-a-session-removes) cuja worktree contém commits que Claude Code não consegue confirmar que estão salvos em outro lugar. Claude Code mantém a worktree e a linha de sessão em vez de destruir os commits sem vê-los. `claude rm` nomeia o branch e os commits não enviados, e diz como proceder:4644Você tentou deletar uma [sessão em background](/docs/pt/agent-view#what-deleting-a-session-removes) cuja worktree contém commits que Claude Code não consegue confirmar que estão salvos em outro lugar. Claude Code mantém a worktree e a linha de sessão em vez de destruir os commits sem vê-los. `claude rm` nomeia o branch e os commits não enviados, e diz como proceder:
4620 4645
4621```text theme={null}4646```text theme={null}
4622kept 7c5dcf5d — its worktree is still at "/home/you/project/.claude/worktrees/fix-login"4647kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”
4623 2 unpushed commits on "claude/fix-login": a1b2c3d "Fix login flow" and 1 more. They exist on no remote, so deleting the worktree would lose them.4648 2 unpushed commits on “claude/fix-login”: a1b2c3d “Fix login flow” and 1 more. They exist on no remote, so deleting the worktree would lose them.
4624 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef4649 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
4625```4650```
4626 4651
4631**O que fazer:**4656**O que fazer:**
4632 4657
4633* Para manter os commits, envie o branch da worktree, ou mescle-o no branch padrão verificado no seu checkout principal, depois delete a sessão novamente4658* Para manter os commits, envie o branch da worktree, ou mescle-o no branch padrão verificado no seu checkout principal, depois delete a sessão novamente
4634* Para descartar os commits, execute o comando `claude rm <id> --discard-unpushed` que a mensagem imprimiu, ou pressione `Ctrl+X` duas vezes na linha da sessão na agent view novamente. Isso remove a sessão e a worktree junto com seu branch, os commits não enviados, e quaisquer mudanças não confirmadas. Se a worktree ganhou um commit desde a recusa, Claude Code a mantém novamente e mostra o estado atualizado4659* Para descartar os commits, execute o comando `claude rm <id> --discard-unpushed` que a mensagem imprimiu, ou pressione `Ctrl+X` duas vezes na linha da sessão na agent view novamente. Isso remove a sessão e a worktree junto com seu branch, os commits não enviados, e quaisquer mudanças sem commit. Se a worktree ganhou um commit desde a recusa, Claude Code a mantém novamente e mostra o estado atualizado
4635* Quando a mensagem diz que a worktree também é registrada por outra sessão terminada, deletar novamente não a descarta: envie os commits, depois delete a sessão novamente4660* Quando a mensagem diz que a worktree também é registrada por outra sessão terminada, deletar novamente não a descarta: envie os commits, depois delete a sessão novamente
4636 4661
4637Antes da v2.1.268, `claude rm` colocava o resumo de commit na linha `kept` em si. Quando `claude rm` não conseguia resumir os commits, a linha `kept` lia `worktree has commits that are not pushed anywhere` no lugar do resumo.4662Antes da v2.1.268, `claude rm` colocava o resumo de commit na linha `kept` em si. Quando `claude rm` não conseguia resumir os commits, a linha `kept` lia `worktree has commits that are not pushed anywhere` no lugar do resumo.
4723This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.4748This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.
4724```4749```
4725 4750
4726O aviso nomeia apenas os diretórios que Claude Code procurou, e aparece na conversa retomada se você acordar uma [sessão em background](/docs/pt/agent-view), executar `/resume` ou `claude --resume`, ou retomar em [modo não-interativo](/docs/pt/headless), onde também vai para stderr. Sessões usando `--input-format stream-json` não o mostram, porque o Agent SDK fornece agentes após a inicialização.4751O aviso nomeia apenas os diretórios que Claude Code procurou, e aparece na conversa retomada se você acordar uma [sessão em background](/docs/pt/agent-view), executar `/resume` ou `claude --resume`, ou retomar em [modo não interativo](/docs/pt/headless), onde também vai para stderr. Sessões usando `--input-format stream-json` não o mostram, porque o Agent SDK fornece agentes após a inicialização.
4727 4752
4728Claude Code não salva o fallback na sessão, portanto o aviso se repete em cada retomada até você agir. O agente `claude` integrado não aciona o aviso, já que fazer fallback para o conjunto de ferramentas padrão não muda nada para ele. Antes da v2.1.216, Claude Code silenciosamente continuava como o agente padrão, e a busca cobria apenas o diretório de onde você retomava, portanto um agente com escopo de projeto era perdido em qualquer retomada de outro diretório.4753Claude Code não salva o fallback na sessão, portanto o aviso se repete em cada retomada até você agir. O agente `claude` integrado não aciona o aviso, já que fazer fallback para o conjunto de ferramentas padrão não muda nada para ele. Antes da v2.1.216, Claude Code silenciosamente continuava como o agente padrão, e a busca cobria apenas o diretório de onde você retomava, portanto um agente com escopo de projeto era perdido em qualquer retomada de outro diretório.
4729 4754
4773 4798
4774* Se a mensagem lê `Couldn't start the session`, atualize para v2.1.212 ou posterior. Em versões anteriores você também pode executar `claude daemon run` em um terminal separado primeiro, depois iniciar a sessão em background novamente. Esse comando executa o serviço em background no primeiro plano do terminal, portanto o serviço dura apenas enquanto esse terminal fica aberto.4799* Se a mensagem lê `Couldn't start the session`, atualize para v2.1.212 ou posterior. Em versões anteriores você também pode executar `claude daemon run` em um terminal separado primeiro, depois iniciar a sessão em background novamente. Esse comando executa o serviço em background no primeiro plano do terminal, portanto o serviço dura apenas enquanto esse terminal fica aberto.
4775* Se uma instalação npm estava substituindo o binário, espere por ela terminar, depois inicie a sessão em background novamente4800* Se uma instalação npm estava substituindo o binário, espere por ela terminar, depois inicie a sessão em background novamente
4776* Se o erro aparece em v2.1.212 ou posterior enquanto nenhuma instalação npm está em execução, peça ao seu administrador Windows para permitir o executável Claude Code na política de restrição4801* Se o erro aparece em v2.1.212 ou posterior enquanto nenhuma instalação npm está em execução, verifique com seu administrador Windows se uma política de restrição bloqueia o executável Claude Code
4777* Se o serviço em background para quando você fecha o terminal, Claude Code o iniciou sem PowerShell. Instale PowerShell 7, ou peça ao seu administrador para desbloquear PowerShell, para que o serviço possa sobreviver ao terminal.4802* Se o serviço em background para quando você fecha o terminal, Claude Code o iniciou sem PowerShell. Instale PowerShell 7, ou peça ao seu administrador para desbloquear PowerShell, para que o serviço possa sobreviver ao terminal.
4778 4803
4779<h3 id="eacces-when-starting-a-background-session">4804<h3 id="eacces-when-starting-a-background-session">
4829 Diretório de trabalho não existe mais ao iniciar uma sessão em background4854 Diretório de trabalho não existe mais ao iniciar uma sessão em background
4830</h3>4855</h3>
4831 4856
4832Você tentou iniciar uma [sessão em background](/docs/pt/agent-view) em um diretório que não existe mais. Claude Code não inicia a sessão, e a mensagem nomeia o diretório faltante:4857O diretório em que você iniciou uma [sessão em background](/docs/pt/agent-view) foi removido enquanto a sessão estava iniciando. Claude Code não inicia a sessão, e a mensagem nomeia o diretório faltante:
4833 4858
4834```text theme={null}4859```text theme={null}
4835Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4860Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)
4860* **`The home directory is trusted one session at a time`**: o diretório da sessão é seu diretório home. Claude Code nunca salva confiança para o diretório home, portanto aceitar o diálogo lá em uma sessão anterior não conta.4885* **`The home directory is trusted one session at a time`**: o diretório da sessão é seu diretório home. Claude Code nunca salva confiança para o diretório home, portanto aceitar o diálogo lá em uma sessão anterior não conta.
4861* **`<path> could not be resolved on disk`**: Claude Code não conseguiu encontrar o diretório da sessão no disco.4886* **`<path> could not be resolved on disk`**: Claude Code não conseguiu encontrar o diretório da sessão no disco.
4862 4887
4888Antes da v2.1.286, no Windows, essa mensagem também podia aparecer em um diretório que você já tinha confiado, se seu registro de confiança foi salvo com o caminho em uma capitalização de letras diferente. Atualize para v2.1.286 ou posterior.
4889
4863**O que fazer:**4890**O que fazer:**
4864 4891
4865* Execute `claude` no diretório que a mensagem nomeia e aceite o diálogo de confiança, depois execute o comando novamente4892* Execute `claude` no diretório que a mensagem nomeia e aceite o diálogo de confiança, depois execute o comando novamente
