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) |
81| `Failed to authenticate: OAuth token revoked` | [Authentication](#oauth-token-revoked-or-expired) |
82| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentication](#oauth-token-revoked-or-expired) |
79| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |83| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |
80| `Login expired · Please run /login` | [Authentication](#login-expired) |84| `Login expired · Please run /login` | [Authentication](#login-expired) |
81| `Failed to start OAuth callback server` | [Authentication](#failed-to-start-oauth-callback-server) |85| `Failed to start OAuth callback server` | [Authentication](#failed-to-start-oauth-callback-server) |
186| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |190| `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) |191| `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) |192| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |
193| `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) |194| `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) |195| `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) |196| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
203| `Could not read Claude Code config` | [Command-line errors](#could-not-read-claude-code-config) |208| `Could not read Claude Code config` | [Command-line errors](#could-not-read-claude-code-config) |
204| `Could not import <server>: <reason>` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |209| `Could not import <server>: <reason>` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |
205| `Cannot add MCP server to scope: managed` | [Command-line errors](#cannot-add-mcp-server-to-the-managed-scope) |210| `Cannot add MCP server to scope: managed` | [Command-line errors](#cannot-add-mcp-server-to-the-managed-scope) |
211| `Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide` | [Command-line errors](#cannot-add-mcp-server-when-managed-settings-allow-only-plugin-servers) |
206| `is Anthropic-hosted and doesn't support local OAuth` | [Command-line errors](#anthropic-hosted-and-doesnt-support-local-oauth) |212| `is Anthropic-hosted and doesn't support local OAuth` | [Command-line errors](#anthropic-hosted-and-doesnt-support-local-oauth) |
207| `Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes` | [Command-line errors](#cant-read-mcp-json) |213| `Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes` | [Command-line errors](#cant-read-mcp-json) |
208| `MCP server "<name>" was not saved to` / `was not removed from` | [Command-line errors](#mcp-server-was-not-saved-or-removed) |214| `MCP server "<name>" was not saved to` / `was not removed from` | [Command-line errors](#mcp-server-was-not-saved-or-removed) |
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) |218| `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) |219| `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) |220| `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) |221| `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) |222| ``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) |223| `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) |224| `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) |252| `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) |253| `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) |254| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin errors](#marketplace-name-is-another-spelling-of-a-reserved-name) |
255| `Marketplace "<name>" is added but ignored` | [Plugin troubleshooting](/docs/pt/plugins/troubleshooting#marketplace-is-added-but-ignored) |
256| `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) |257| `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) |258| `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) |259| `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) |260| `Plugin archive integrity check failed` | [Plugin errors](#plugin-archive-integrity-check-failed) |
261| `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) |262| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |
254| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |263| `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) |264| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
359 368
360Claude Code tenta novamente estas falhas:369Claude Code tenta novamente estas falhas:
361 370
362* Erros de servidor, respostas sobrecarregadas e timeouts de solicitação que chegam antes de qualquer parte da resposta do Claude ter sido transmitida.371* Erros de servidor, respostas sobrecarregadas e timeouts de requisição que chegam antes de qualquer parte da resposta do Claude ter sido transmitida.
363* Conexões perdidas. Quando uma conexão cai no meio de uma solicitação antes de Claude ter completado qualquer parte de sua resposta, incluindo seu thinking, Claude Code reemite a solicitação com o mesmo backoff e a rodada continua, mesmo que algum texto já tivesse começado a ser transmitido. Quando cai depois que Claude terminou de pensar mas antes de ter iniciado qualquer texto ou chamada de ferramenta, Claude Code em vez disso reemite a solicitação até duas vezes em rápida sucessão, e encerra a rodada com `Connection lost before a response was produced` se a conexão continuar caindo nesse ponto.372* Um erro de servidor ou resposta sobrecarregada que chega depois que Claude terminou de pensar, mas antes de ter iniciado qualquer texto ou chamada de ferramenta. Claude Code tenta novamente um erro de servidor nesse ponto até duas vezes. Antes da v2.1.284, Claude Code encerrava o turno com o erro nesse ponto.
364* Uma conexão que Claude Code detecta foi quebrada pelo seu computador entrando em modo de suspensão no meio de uma solicitação. Claude Code a conta como uma conexão perdida sob as regras acima; uma vez que o rótulo de tentativa nomeia a razão específica, ele lê `Connection lost while your computer was asleep`, e se a rodada terminar depois que Claude terminou de pensar mas antes de qualquer texto ou chamada de ferramenta, a mensagem lê `Your computer went to sleep before a response was produced`.373* Conexões perdidas. Quando uma conexão cai no meio de uma requisição antes de Claude ter completado qualquer parte de sua resposta, incluindo seu pensamento, Claude Code reemite a requisição com o mesmo backoff e o turno continua, mesmo que algum texto já tivesse começado a ser transmitido. Quando cai depois que Claude terminou de pensar mas antes de ter iniciado qualquer texto ou chamada de ferramenta, Claude Code em vez disso reemite a requisição até duas vezes em rápida sucessão, e encerra o turno com `Connection lost before a response was produced` se a conexão continuar caindo nesse ponto.
365* Um fluxo de resposta travado, quando os cabeçalhos de resposta chegaram mas nenhuma parte da resposta do Claude chegou, ou quando Claude terminou de pensar mas não iniciou qualquer texto ou chamada de ferramenta: Claude Code aborta a conexão travada e reemite a solicitação no máximo uma vez, fora do orçamento de 10 tentativas acima. Se a resposta travar uma segunda vez depois que Claude terminou de pensar mas antes de qualquer texto ou chamada de ferramenta, Claude Code encerra a rodada com `The response stalled before a response was produced`.374* Uma conexão que Claude Code detecta que foi quebrada pelo seu computador entrando em modo de suspensão no meio de uma requisição. Claude Code a conta como uma conexão perdida sob as regras acima; uma vez que o rótulo de nova tentativa nomeia a razão específica, ele exibe `Connection lost while your computer was asleep`, e se o turno terminar depois que Claude terminou de pensar mas antes de qualquer texto ou chamada de ferramenta, a mensagem exibe `Your computer went to sleep before a response was produced`.
366* Uma solicitação de streaming que a API nunca responde com cabeçalhos de resposta, em uma conexão onde o [prazo de primeiro byte é executado](/docs/pt/network-config#streaming-idle-watchdogs): Claude Code a aborta no prazo e a reenvia no máximo uma vez por solicitação de modelo, dentro do orçamento de tentativas, depois encerra a rodada com [No response from API](#no-response-from-api) se essa tentativa também ficar sem resposta. Em outras conexões, a solicitação aguarda `API_TIMEOUT_MS`. Quando você define `CLAUDE_CODE_RETRY_WATCHDOG`, o limite de uma tentativa não se aplica.375* Um fluxo de resposta travado, quando os cabeçalhos de resposta chegaram mas nenhuma parte da resposta do Claude chegou, ou quando Claude terminou de pensar mas não iniciou qualquer texto ou chamada de ferramenta: Claude Code aborta a conexão travada e reemite a requisição no máximo uma vez, fora do orçamento de 10 tentativas acima. Se a resposta travar uma segunda vez depois que Claude terminou de pensar mas antes de qualquer texto ou chamada de ferramenta, Claude Code encerra o turno com `The response stalled before a response was produced`.
376* Uma requisição de streaming que a API nunca responde com cabeçalhos de resposta, em uma conexão onde o [prazo de primeiro byte é executado](/docs/pt/network-config#streaming-idle-watchdogs): Claude Code a aborta no prazo e a reenvia no máximo uma vez por requisição de modelo, dentro do orçamento de tentativas, depois encerra o turno com [No response from API](#no-response-from-api) se essa tentativa também ficar sem resposta. Em outras conexões, a requisição aguarda `API_TIMEOUT_MS`. Quando você define `CLAUDE_CODE_RETRY_WATCHDOG`, o limite de uma nova tentativa não se aplica.
367* Throttles 429 temporários, mas não o `429` de limite de gastos de um gateway, que não é um throttle; veja [Spend limit reached](#spend-limit-reached).377* Throttles 429 temporários, mas não o `429` de limite de gastos de um gateway, que não é um throttle; veja [Spend limit reached](#spend-limit-reached).
368 * Quando você está conectado com uma assinatura claude.ai, isso inclui throttles 429 que não carregam os cabeçalhos de cota do seu plano. Antes da v2.1.199, Claude Code tentava novamente esses throttles apenas para assinatura de chave de API e Enterprise.378 * Quando você está conectado com uma assinatura claude.ai, isso inclui throttles 429 que não carregam os cabeçalhos de cota do seu plano. Antes da v2.1.199, Claude Code tentava novamente esses throttles apenas para logins com chave de API e Enterprise.
369* Uma solicitação rejeitada porque a entrada mais `max_tokens` excede o limite de contexto. Reenviar sem alterações falharia da mesma forma, então Claude Code tenta novamente com um `max_tokens` reduzido, e para de tentar novamente e compacta em dois casos:379* Uma requisição rejeitada porque a entrada mais `max_tokens` excede o limite de contexto. Reenviá-la sem alterações falharia da mesma forma, então Claude Code tenta novamente com um `max_tokens` reduzido, e para de tentar novamente e compacta em dois casos:
370 * Quando nenhuma redução pode caber, por exemplo quando a conversa em si quase preenche a janela de contexto.380 * Quando nenhuma redução pode caber, por exemplo quando a conversa em si quase preenche a janela de contexto.
371 * Quando uma tentativa não pode encolher `max_tokens` ainda mais. Antes da v2.1.218, Claude Code poderia reenviar uma solicitação reduzida que ainda não cabia, como quando o orçamento de thinking estendido excedia o contexto restante, até o orçamento de tentativas se esgotar.381 * Quando uma nova tentativa não pode encolher `max_tokens` ainda mais. Antes da v2.1.218, Claude Code poderia reenviar uma requisição reduzida que ainda não cabia, como quando o orçamento de pensamento estendido excedia o contexto restante, até o orçamento de tentativas se esgotar.
372* Uma credencial expirada ou ausente do Google Cloud na [Plataforma de Agentes do Google Cloud](/docs/pt/google-vertex-ai), ou credenciais AWS que falham ao carregar em sua máquina. Claude Code descarta suas credenciais em cache e tenta novamente até duas vezes, depois relata o erro para que você possa se autenticar novamente imediatamente, conforme descrito em [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). Antes da v2.1.228, Claude Code tentava novamente uma credencial do Google Cloud falhando através do orçamento de tentativas completo antes de mostrar o erro.382* Uma credencial expirada ou ausente do Google Cloud na [Plataforma de Agentes do Google Cloud](/docs/pt/google-vertex-ai), ou credenciais AWS que falham ao carregar em sua máquina. Claude Code descarta suas credenciais em cache e tenta novamente até duas vezes, depois relata o erro para que você possa se autenticar novamente imediatamente, conforme descrito em [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). Antes da v2.1.228, Claude Code tentava novamente uma credencial do Google Cloud com falha através do orçamento de tentativas completo antes de mostrar o erro.
373* Um `401` ou `403` da API Anthropic, diretamente ou através de um [gateway LLM](/docs/pt/llm-gateway), enquanto um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) fornece a credencial. Claude Code executa novamente o script e tenta novamente com sua saída fresca, dentro do orçamento de tentativas completo. Quando o script em si falha na re-execução, Claude Code mostra [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing) em vez disso.383* Um `401` ou `403` da API Anthropic, diretamente ou através de um [gateway de LLM](/docs/pt/llm-gateway), enquanto um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) fornece a credencial. Claude Code executa novamente o script e tenta novamente com sua saída nova, dentro do orçamento de tentativas completo. Quando o script em si falha na nova execução, Claude Code mostra [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing) em vez disso.
374 384
375Antes da v2.1.227, `Connection lost before a response was produced` lia `Connection closed while thinking, before producing a response` e `The response stalled before a response was produced` lia `Response stalled while thinking, before producing a response`.385Antes da v2.1.227, `Connection lost before a response was produced` era exibido como `Connection closed while thinking, before producing a response` e `The response stalled before a response was produced` era exibido como `Response stalled while thinking, before producing a response`.
376 386
377Claude Code não tenta novamente estas falhas:387Claude Code não tenta novamente estas falhas:
378 388
379* Uma falha de validação de certificado TLS, como um proxy inspecionando TLS, um pacote `NODE_EXTRA_CA_CERTS` ausente, ou um certificado expirado. Claude Code relata o erro na primeira tentativa, para que você possa corrigir a configuração do certificado imediatamente; veja [SSL certificate errors](#ssl-certificate-errors). Claude Code ainda tenta novamente condições TLS transitórias como um timeout de handshake. Antes da v2.1.199, Claude Code tentava novamente falhas de certificado através do orçamento de tentativas completo antes de mostrar o erro.389* Uma falha de validação de certificado TLS, como um proxy inspecionando TLS, um pacote `NODE_EXTRA_CA_CERTS` ausente, ou um certificado expirado. Claude Code relata o erro na primeira tentativa, para que você possa corrigir a configuração do certificado imediatamente; veja [SSL certificate errors](#ssl-certificate-errors). Claude Code ainda tenta novamente condições TLS transitórias como um timeout de handshake. Antes da v2.1.199, Claude Code tentava novamente falhas de certificado através do orçamento de tentativas completo antes de mostrar o erro.
380* Um erro de servidor, conexão perdida, ou fluxo travado que chega depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou iniciou um depois de terminar seu thinking, mas antes de terminar a resposta. Claude Code não executa novamente a solicitação, porque isso poderia executar as mesmas chamadas de ferramenta duas vezes. Ele mantém o que Claude completou, executa qualquer chamada de ferramenta que Claude terminou, e continua a rodada a partir de seus resultados. Para o que você vê em uma sessão interativa e em uma não-interativa, leia [The response above may be incomplete](#the-response-above-may-be-incomplete). Antes da v2.1.199, Claude Code descartava a saída parcial e relatava toda a rodada como um erro quando um erro de servidor chegava no meio do fluxo.390* Um erro de servidor, conexão perdida, ou fluxo travado que chega depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou iniciou um depois de terminar seu pensamento, mas antes de terminar a resposta. Claude Code não executa novamente a requisição, porque isso poderia executar as mesmas chamadas de ferramenta duas vezes. Ele mantém o que Claude completou, executa qualquer chamada de ferramenta que Claude terminou, e continua o turno a partir de seus resultados. Para o que você vê em uma sessão interativa e em uma não interativa, leia [The response above may be incomplete](#the-response-above-may-be-incomplete). Antes da v2.1.199, Claude Code descartava a saída parcial e relatava todo o turno como um erro quando um erro de servidor chegava no meio do fluxo.
381* Uma falha que chega depois que Claude terminou a resposta: nada precisa ser tentado novamente, então Claude Code mantém a resposta completa e encerra a rodada normalmente.391* Uma falha que chega depois que Claude terminou a resposta: nada precisa ser tentado novamente, então Claude Code mantém a resposta completa e encerra o turno normalmente.
382* Uma [resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado](#bedrock-streaming-response-has-an-unexpected-content-type), porque o gateway ou proxy reescrevendo a resposta reescreveria a tentativa da mesma forma. Requer Claude Code v2.1.208 ou posterior.392* Uma [resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado](#bedrock-streaming-response-has-an-unexpected-content-type), porque o gateway ou proxy que reescreve a resposta reescreveria a nova tentativa da mesma forma. Requer Claude Code v2.1.208 ou posterior.
383* Uma tentativa não-streaming de uma solicitação de streaming falhada que recebe um status de sucesso mas [nenhuma mensagem de API Claude no corpo](#api-returned-an-empty-or-malformed-response). Claude Code encerra a rodada com esse erro.393* Uma nova tentativa sem streaming de uma requisição de streaming com falha que recebe um status de sucesso mas [nenhuma mensagem da API Claude no corpo](#api-returned-an-empty-or-malformed-response). Claude Code encerra o turno com esse erro.
384* Uma solicitação que a verificação de política da sua organização negou, que aparece como uma linha `API Error:` carregando a mensagem de negação. Os administradores da sua organização configuraram a verificação com [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks), um recurso Claude Enterprise, e a mensagem termina com as instruções que eles configuraram, ou por padrão diz para você entrar em contato com eles. Claude Code não reenvia a solicitação negada para o mesmo modelo ou para um [modelo de fallback](/docs/pt/model-config#fallback-model-chains), porque a negação é sobre o conteúdo da solicitação em vez do modelo. Antes da v2.1.239, Claude Code poderia reenviar uma solicitação negada, sem streaming ou em um modelo de fallback configurado, antes de mostrar a negação.394* Uma requisição que a verificação de política da sua organização negou, que aparece como uma linha `API Error:` carregando a mensagem de negação. Os administradores da sua organização configuram a verificação com [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks), um recurso do Claude Enterprise, e a mensagem termina com as instruções que eles configuraram, ou por padrão diz para você entrar em contato com eles. Claude Code não reenvia a requisição negada para o mesmo modelo ou para um [modelo de fallback](/docs/pt/model-config#fallback-model-chains), porque a negação é sobre o conteúdo da requisição e não sobre o modelo. Antes da v2.1.239, Claude Code poderia reenviar uma requisição negada, sem streaming ou em um modelo de fallback configurado, antes de mostrar a negação.
385 395
386<h3 id="what-you-see-while-claude-code-retries-or-waits">396<h3 id="what-you-see-while-claude-code-retries-or-waits">
387 O que você vê enquanto Claude Code tenta novamente ou aguarda397 O que você vê enquanto Claude Code tenta novamente ou aguarda
388</h3>398</h3>
389 399
390Ao tentar novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y` após um rótulo de erro. O rótulo nomeia a razão específica da primeira tentativa para falhas que você pode agir imediatamente: a rede está inativa, um handshake TLS falhou, ou você atingiu um limite de taxa. Para outros erros, ele lê `API error` no início. A partir da v2.1.198, ele muda para a razão específica da terceira tentativa, ou na tentativa final quando `CLAUDE_CODE_MAX_RETRIES` permite menos de três; versões anteriores mudam apenas na tentativa final.400Ao tentar novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y` após um rótulo de erro. O rótulo nomeia a razão específica desde a primeira tentativa para falhas sobre as quais você pode agir imediatamente: a rede está inativa, um handshake TLS falhou, ou você atingiu um rate limit. Para outros erros, ele exibe `API error` no início. A partir da v2.1.198, ele muda para a razão específica a partir da terceira tentativa, ou na tentativa final quando `CLAUDE_CODE_MAX_RETRIES` permite menos de três; versões anteriores mudam apenas na tentativa final.
391 401
392A partir da v2.1.198, a dica de spinner usual é suprimida durante tentativas. Uma vez que a razão do erro é revelada, se a falha é uma sobrecarga 529, a linha abaixo da contagem regressiva também nomeia onde verificar o status do serviço: `status.claude.com` na API Anthropic, ou o host do provedor ou gateway nomeado na mensagem em outras configurações.402A partir da v2.1.198, a dica usual do spinner é suprimida durante novas tentativas. Uma vez que a razão do erro é revelada, se a falha for uma sobrecarga 529, a linha abaixo da contagem regressiva também nomeia onde verificar o status do serviço: `status.claude.com` na API Anthropic, ou o host do provedor ou gateway nomeado na mensagem em outras configurações.
393 403
394Se nenhum dado chegar no fluxo de resposta por 20 segundos enquanto uma solicitação ainda está pendente, o spinner mostra `Waiting for API response · will retry in … · check your network` antes de qualquer tentativa ter começado. A solicitação ainda não falhou: a contagem regressiva é executada até o ponto onde Claude Code aborta a conexão travada. Após o aborto, o que você vê depende de quão longe a resposta tinha chegado:404Se nenhum dado chegar no fluxo de resposta por 20 segundos enquanto uma requisição ainda está pendente, o spinner mostra `Waiting for API response · will retry in … · check your network` antes de qualquer nova tentativa ter começado. A requisição ainda não falhou: a contagem regressiva vai até o ponto em que Claude Code aborta a conexão travada. Após o aborto, o que você vê depende de até onde a resposta tinha chegado:
395 405
396* Antes de Claude ter completado um bloco de texto ou uma chamada de ferramenta, ou iniciado um depois de terminar seu thinking, Claude Code tenta novamente a solicitação ou encerra a rodada com um erro. [Automatic retries](#automatic-retries) diz quais travamentos ele tenta novamente e quantas vezes.406* Antes de Claude ter completado um bloco de texto ou uma chamada de ferramenta, ou iniciado um depois de terminar seu pensamento, Claude Code tenta novamente a requisição ou encerra o turno com um erro. [Automatic retries](#automatic-retries) diz quais travamentos ele tenta novamente e quantas vezes.
397* Depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou iniciou um depois de terminar seu thinking, mas antes de Claude ter terminado a resposta, Claude Code mantém o que Claude completou, continua a rodada a partir de qualquer chamada de ferramenta que Claude terminou, e mostra [The response above may be incomplete](#the-response-above-may-be-incomplete). Em uma sessão não-interativa, e para a resposta de um subagenteemqualquer sessão, Claude Code pode primeiro solicitar ao Claude para continuar a resposta; essa entrada diz quando faz isso e quando você ainda vê o aviso lá.407* Depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou iniciou um depois de terminar seu pensamento, mas antes de Claude ter terminado a resposta, Claude Code mantém o que Claude completou, continua o turno a partir de qualquer chamada de ferramenta que Claude terminou, e mostra [The response above may be incomplete](#the-response-above-may-be-incomplete). Em uma sessão não interativa, e para a resposta de um subagente em qualquer sessão, Claude Code pode primeiro pedir ao Claude que continue a resposta; essa entrada diz quando faz isso e quando você ainda vê o aviso lá.
398* Depois que Claude terminou a resposta, Claude Code encerra a rodada normalmente.408* Depois que Claude terminou a resposta, Claude Code encerra o turno normalmente.
399 409
400O banner se limpa automaticamente uma vez que os dados retomam ou uma tentativa é bem-sucedida. Se reaparecer em cada tentativa, trate-o como um [problema de rede](#unable-to-connect-to-api). Antes da v2.1.185, o banner aparecia após 10 segundos com redação diferente.410O banner desaparece automaticamente assim que os dados são retomados ou uma nova tentativa é bem-sucedida. Se reaparecer em cada tentativa, trate-o como um [problema de rede](#unable-to-connect-to-api). Antes da v2.1.185, o banner aparecia após 10 segundos com redação diferente.
401 411
402Enquanto Claude está consultando o [advisor](/docs/pt/advisor), o banner aparece após 90 segundos sem dados em vez de 20, porque uma revisão longa do advisor pode não enviar nada por bem mais de 20 segundos. Antes da v2.1.214, o limite de 20 segundos se aplicava durante chamadas de advisor também, então o banner aparecia durante revisões de advisor mesmo quando nada estava errado.412Enquanto Claude está consultando o [advisor](/docs/pt/advisor), o banner aparece após 90 segundos sem dados em vez de 20, porque uma revisão longa do advisor pode não enviar nada por bem mais de 20 segundos. Antes da v2.1.214, o limite de 20 segundos se aplicava também durante chamadas ao advisor, então o banner aparecia durante revisões do advisor mesmo quando nada estava errado.
403 413
404<h3 id="tune-retry-behavior">414<h3 id="tune-retry-behavior">
405 Ajustar comportamento de tentativa415 Ajustar o comportamento de novas tentativas
406</h3>416</h3>
407 417
408Você pode ajustar o comportamento de tentativa com estas variáveis de ambiente:418Você pode ajustar o comportamento de novas tentativas com estas variáveis de ambiente:
409 419
410| Variável | Padrão | Efeito |420| Variável | Padrão | Efeito |
411| :- | :- | :- |421| :- | :- | :- |
412| [`CLAUDE_CODE_MAX_RETRIES`](/docs/pt/env-vars) | 10 | Número de tentativas de tentativa. Limitado a 15 a partir da v2.1.186; a partir da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Reduza-o para superficializar falhas mais rapidamente em scripts. |422| [`CLAUDE_CODE_MAX_RETRIES`](/docs/pt/env-vars) | 10 | Número de novas tentativas. Limitado a 15 a partir da v2.1.186; a partir da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Reduza-o para expor falhas mais rapidamente em scripts. |
413| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/pt/env-vars) | não definido | Defina como `1` em sessões não-supervisionadas como trabalhos de CI para tentar novamente `429` e `529` erros de capacidade indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. Claude Code falha imediatamente quando uma solicitação de velocidade padrão recebe um `429` que relata um limite de gastos ou créditos de uso esgotados, mesmo um de um [limite de gastos de gateway](#spend-limit-reached) que redefine em um cronograma. Antes da v2.1.239, o watchdog tentava novamente esses indefinidamente. Para solicitações de modo rápido, veja [Handle rate limits](/docs/pt/fast-mode#handle-rate-limits). Na v2.1.199 ou posterior, também aumenta a contagem de tentativas padrão para outros erros transitórios, como erros de servidor, timeouts e conexões perdidas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. |423| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/pt/env-vars) | não definido | Defina como `1` em sessões não supervisionadas, como jobs de CI, para tentar novamente erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. Claude Code falha imediatamente quando uma requisição de velocidade padrão recebe um `429` que relata um limite de gastos ou créditos de uso esgotados, mesmo um de um [limite de gastos de gateway](#spend-limit-reached) que é redefinido em um cronograma. Antes da v2.1.239, o watchdog tentava novamente esses erros indefinidamente. Para requisições no modo rápido, veja [Handle rate limits](/docs/pt/fast-mode#handle-rate-limits). Na v2.1.199 ou posterior, também aumenta a contagem padrão de novas tentativas para outros erros transitórios, como erros de servidor, timeouts e conexões perdidas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. |
414| [`API_TIMEOUT_MS`](/docs/pt/env-vars) | 600000 | Timeout por solicitação em milissegundos. Aumente-o para redes lentas ou proxies. Também limita quanto tempo Claude Code aguarda cabeçalhos de resposta, descrito em [No response from API](#no-response-from-api). |424| [`API_TIMEOUT_MS`](/docs/pt/env-vars) | 600000 | Timeout por requisição em milissegundos. Aumente-o para redes lentas ou proxies. Também limita quanto tempo Claude Code aguarda os cabeçalhos de resposta, conforme descrito em [No response from API](#no-response-from-api). |
415| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/pt/env-vars) | não definido | Prazo em milissegundos para o primeiro byte de resposta de uma solicitação de streaming. Requer Claude Code v2.1.242 ou posterior. Para como Claude Code escolhe o prazo quando isso não está definido, veja [No response from API](#no-response-from-api). |425| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/pt/env-vars) | não definido | Prazo em milissegundos para o primeiro byte de resposta de uma requisição de streaming. Requer Claude Code v2.1.242 ou posterior. Para saber como Claude Code escolhe o prazo quando esta variável não está definida, veja [No response from API](#no-response-from-api). |
416 426
417<h2 id="server-errors">427<h2 id="server-errors">
418 Erros do servidor428 Erros do servidor
486 No response from API496 No response from API
487</h3>497</h3>
488 498
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).499Claude 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 500
491```text theme={null}501```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.502API 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```503```
494 504
495Claude Code define o tempo de espera para cabeçalhos de resposta da primeira tentativa e a espera da tentativa novamente separadamente:505Claude Code define o tempo de espera para cabeçalhos de resposta da primeira tentativa e a espera da nova tentativa separadamente:
496 506
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.507* **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.508* **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 509
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.510Nenhuma 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 511
503 513
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.514* 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).515* 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.516* 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.517* 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 518
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.519Antes 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 520
511<h3 id="the-response-above-may-be-incomplete">521<h3 id="the-response-above-may-be-incomplete">
512 The response above may be incomplete522 The response above may be incomplete
541 551
542* Anteriormente na resposta, Claude Code ou tenta novamente a falha ou termina o turno com um erro diferente. Veja [Automatic retries](#automatic-retries).552* 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.553* 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.554* 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.555* 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 556
547**O que fazer:**557**O que fazer:**
636The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.646The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.
637```647```
638 648
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.649O 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 650
641Após dez respostas seguidas sem veredicto, auto mode interrompe o turno:651Após dez respostas seguidas sem veredicto, auto mode interrompe o turno:
642 652
663 Agent terminated early due to an API error673 Agent terminated early due to an API error
664</h3>674</h3>
665 675
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.676A 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 677
668```text theme={null}678```text theme={null}
669Agent terminated early due to an API error: <error detail>679Agent 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ção684* 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)685* 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 686
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).687Quando 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 688
679<h2 id="usage-limits">689<h2 id="usage-limits">
680 Limites de uso690 Limites de uso
697 707
698Claude Code bloqueia outras solicitações até o horário de reset mostrado na mensagem. Os limites de sessão e semanal são compartilhados entre todos os modelos, portanto, trocar de modelo não restaura o acesso. Os limites de Opus e Sonnet se aplicam apenas a solicitações para essa família de modelos, portanto, trocar para um modelo fora da família com `/model` mantém você trabalhando.708Claude Code bloqueia outras solicitações até o horário de reset mostrado na mensagem. Os limites de sessão e semanal são compartilhados entre todos os modelos, portanto, trocar de modelo não restaura o acesso. Os limites de Opus e Sonnet se aplicam apenas a solicitações para essa família de modelos, portanto, trocar para um modelo fora da família com `/model` mantém você trabalhando.
699 709
700Em uma sessão interativa conectada com uma assinatura claude.ai, Claude Code também pode aguardar na sessão aberta e continuar a tarefa interrompida logo após o reset. Enquanto aguarda, uma linha na parte inferior da sessão lê `Usage limit reached · continuing automatically at 3:45pm · esc to cancel`. Pressione `Esc` em um prompt vazio para cancelar a espera. Veja [Wait for a usage limit to reset](/docs/pt/interactive-mode#wait-for-a-usage-limit-to-reset) para o que você vê, como iniciar ou cancelar uma espera e como desativar a continuação automática. Antes da v2.1.234, Claude Code não oferecia essa espera.710Em uma sessão interativa conectada com uma assinatura claude.ai, Claude Code também pode aguardar na sessão aberta e continuar a tarefa interrompida logo após o reset. Veja [Wait for a usage limit to reset](/docs/pt/interactive-mode#wait-for-a-usage-limit-to-reset) para o que você vê, como iniciar ou cancelar uma espera e como desativar a continuação automática. Antes da v2.1.234, Claude Code não oferecia essa espera.
701 711
702O uso é contado contra as permissões de sessão e semanal ao mesmo tempo. Uma única rajada de atividade pesada, como um grande fanout de fluxo de trabalho, pode esgotar a permissão semanal antes da janela de sessão ser resetada.712O uso é contado contra as permissões de sessão e semanal ao mesmo tempo. Uma única rajada de atividade pesada, como um grande fanout de fluxo de trabalho, pode esgotar a permissão semanal antes da janela de sessão ser resetada.
703 713
885 Erros de autenticação895 Erros de autenticação
886</h2>896</h2>
887 897
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.898Esses 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 899
890<h3 id="not-logged-in">900<h3 id="not-logged-in">
891 Não conectado901 Not logged in
892</h3>902</h3>
893 903
894Nenhuma credencial válida está disponível para esta sessão.904Nenhuma credencial válida está disponível para esta sessão.
897Not logged in · Please run /login907Not logged in · Please run /login
898```908```
899 909
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.910Em 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ê faz login novamente pelo aplicativo.
911
912Se você fizer login 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.
913
914Antes da v2.1.286 no macOS, a sessão podia continuar mostrando a mensagem depois que você fazia login em outra janela. Nessas versões, reinicie a sessão que mostra a mensagem.
901 915
902**O que fazer:**916**O que fazer:**
903 917
904* Execute `/login` para se autenticar com sua assinatura Claude ou conta Console918* 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`919* 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ção920* Para CI ou automação em que o login interativo não é possível, configure um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) que obtenha 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 presentes921* 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 922
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.923Se 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 924
911<h3 id="could-not-resolve-authentication-method">925<h3 id="could-not-resolve-authentication-method">
912 Não foi possível resolver o método de autenticação926 Could not resolve authentication method
913</h3>927</h3>
914 928
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.929A 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 [Not logged in](#not-logged-in) e gravam esta string apenas no log de depuração, então, se você a encontrou lá, siga aquela entrada.
916 930
917```text theme={null}931```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 omitted932Could 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```933```
920 934
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.935Nas 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 assumida também podia. Atualize para se recuperar.
922 936
923**O que fazer:**937**O que fazer:**
924 938
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 configuradas939* 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 interativo940* 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)941* 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 é resolvida942* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida
929 943
930<h3 id="invalid-api-key">944<h3 id="invalid-api-key">
931 Chave de API inválida945 Invalid API key
932</h3>946</h3>
933 947
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.948A 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 949
936```text theme={null}950```text theme={null}
937Invalid API key · Fix external API key951Invalid API key · Fix external API key
938```952```
939 953
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.954Quando 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 os cabeçalhos HTTP não conseguem transportar e interrompeu a requisição antes de enviá-la. Consulte [Invalid request header value](#invalid-request-header-value) para saber como ler a descrição e corrigir o valor.
941 955
942**O que fazer:**956**O que fazer:**
943 957
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)958* Verifique se há 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.959* 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 assinatura960* 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 stdout961* 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 usando962* Execute `/status` para confirmar qual fonte de credencial o Claude Code está realmente usando
949 963
950<h3 id="your-apikeyhelper-script-is-failing">964<h3 id="your-apikeyhelper-script-is-failing">
951 Seu script apiKeyHelper está falhando965 Your apiKeyHelper script is failing
952</h3>966</h3>
953 967
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:968O Claude Code executou o comando na 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 destes casos aconteceu:
955 969
956* O comando saiu com um erro ou expirou970* O comando terminou com um erro ou atingiu o timeout
957* O comando não imprimiu nada em stdout971* 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.972* O comando imprimiu algo além da chave, como um banner de login ou uma linha de log. O painel mostra `returned output that cannot be used as an API key` e informa o que está errado, sem repetir a saída. Antes da v2.1.227, o Claude Code enviava o que quer que o comando imprimisse, após remover os espaços em branco ao redor.
959 973
960```text theme={null}974```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 output975Your 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```976```
963 977
964Em [modo não interativo](/docs/pt/headless), stderr também carrega o motivo específico, prefixado com `apiKeyHelper failed:`.978No [modo não interativo](/docs/pt/headless), o stderr também traz o motivo específico, prefixado com `apiKeyHelper failed:`.
965 979
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.980O Claude Code executa o script novamente e tenta a requisição novamente até mais duas vezes antes de mostrar esta mensagem, então 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 então relatava um erro de autenticação `401` genérico em vez da falha do script.
967 981
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.982Executar `/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 983
970**O que fazer:**984**O que fazer:**
971 985
972* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha986* Execute diretamente no seu shell o comando configurado em `apiKeyHelper` 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 segredos987* Se o comando relatar uma sessão expirada, autentique-se novamente com seu provedor de credenciais, por exemplo, fazendo login novamente no seu SSO ou cofre de segredos
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.988* 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.989* 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`.990* 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 991
978<h3 id="invalid-request-header-value">992<h3 id="invalid-request-header-value">
979 Valor de cabeçalho de solicitação inválido993 Invalid request header value
980</h3>994</h3>
981 995
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.996Um valor que o Claude Code estava prestes a enviar como cabeçalho de requisição contém um caractere que os cabeçalhos HTTP não conseguem 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 informa 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 997
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.998O Claude Code executa esta verificação quando envia requisições à 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 999
986```text theme={null}1000```text theme={null}
987Invalid auth token · Fix external auth token1001Invalid auth token · Fix external auth token
989Invalid request header from the environment · Fix the environment variable1003Invalid request header from the environment · Fix the environment variable
990```1004```
991 1005
992A primeira parte da mensagem depende de onde o valor ruim veio:1006A primeira parte da mensagem depende de onde veio o valor inválido:
993 1007
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)1008* `Invalid auth token`: um bearer token 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.1009* `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 pela contagem qual par `Name: Value` está com problema, como `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, sem repetir o nome ou o valor, já que você escolheu ambos.
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.1010* `Invalid request header from the environment`: um valor que o Claude Code copia para um cabeçalho de requisição a partir de outra variável de ambiente, como `CLAUDE_AGENT_SDK_CLIENT_APP`. A descrição informa a variável a corrigir.
997 1011
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).1012O Claude Code relata uma `ANTHROPIC_API_KEY` inválida detectada por esta verificação como [Invalid API key](#invalid-api-key), com a mesma descrição ao final. Já uma credencial salva do `/login` inválida é relatada como [Not logged in](#not-logged-in); execute `/login` para salvar uma nova. A saída de um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) nunca chega a esta verificação: o Claude Code a valida quando o script é executado, e uma saída que um cabeçalho HTTP não consegue transportar falha com [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing).
999 1013
1000Após o segundo `·`, a mensagem descreve o problema, como neste exemplo completo:1014Após o segundo `·`, a mensagem descreve o problema, como neste exemplo completo:
1001 1015
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).1017Invalid 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```1018```
1005 1019
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`.1020As 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 ele é um caractere invisível ou tipográfico bem 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 1021
1008**O que fazer:**1022**O que fazer:**
1009 1023
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 novamente1024* Defina novamente a variável ou configuração que a mensagem indica, redigitando os caracteres ao redor da posição informada em vez de colar da mesma fonte novamente
1011* Para `ANTHROPIC_CUSTOM_HEADERS`, mantenha um par `Name: Value` por linha e reescreva o par que a mensagem conta1025* 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á ativa1026* Execute `/status` para confirmar qual fonte de credencial está ativa
1013 1027
1014<h3 id="this-organization-has-been-disabled">1028<h3 id="this-organization-has-been-disabled">
1015 Esta organização foi desabilitada1029 This organization has been disabled
1016</h3>1030</h3>
1017 1031
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.1032O 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 1033
1020```text theme={null}1034```text theme={null}
1021Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead1035Your 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.1037API Error: 400 ... This organization has been disabled.
1024```1038```
1025 1039
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.1040A 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 1041
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.1042As variáveis de ambiente têm precedência sobre o `/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 1043
1030**O que fazer:**1044**O que fazer:**
1031 1045
1032* Desdefina `ANTHROPIC_API_KEY` no shell atual e remova-a do seu perfil de shell, depois reinicie `claude`1046* Remova a definição de `ANTHROPIC_API_KEY` no shell atual e remova-a do perfil do seu shell, depois inicie o `claude` novamente
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.1047* 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 assinatura1048* Execute `/status` em seguida 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.1049* Se nenhuma variável de ambiente estiver definida e o erro persistir, entre em contato com o suporte ou faça login com uma conta diferente.
1036 1050
1037<h3 id="your-organization-has-disabled-api-key-authentication">1051<h3 id="your-organization-has-disabled-api-key-authentication">
1038 Sua organização desabilitou a autenticação por chave de API1052 Your organization has disabled API key authentication
1039</h3>1053</h3>
1040 1054
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:1055Esta 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 conforme a origem da chave:
1042 1056
1043```text theme={null}1057```text theme={null}
1044Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account1058Your 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 account1062Your organization has disabled API key authentication · Sign in again with your claude.ai account
1049```1063```
1050 1064
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.1065A última forma aparece em uma sessão executada pelo aplicativo Claude Desktop, como a aba Code ou o Cowork, onde você faz login novamente pelo aplicativo.
1052 1066
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).1067As variáveis de ambiente e o `apiKeyHelper` têm precedência sobre o `/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 1068
1055**O que fazer:**1069**O que fazer:**
1056 1070
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`1071* Se a mensagem mencionar `ANTHROPIC_API_KEY`, remova sua definição no shell atual e remova-a do perfil do seu shell ou do arquivo `.env`, depois inicie o `claude` novamente
1058* Se a mensagem nomear `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) do seu `settings.json`1072* Se a mensagem mencionar `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.ai1073* Execute `/login` para fazer login com sua conta claude.ai
1060* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API1074* Execute `/status` em seguida para confirmar que a credencial ativa é sua assinatura e não 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 Console1075* 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 1076
1063<h3 id="your-organization-has-disabled-claude-subscription-access">1077<h3 id="your-organization-has-disabled-claude-subscription-access">
1064 Sua organização desabilitou o acesso à assinatura Claude1078 Your organization has disabled Claude subscription access
1065</h3>1079</h3>
1066 1080
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.1081Sua organização Claude não permite fazer login no Claude Code com um login de assinatura. Executar `/login` novamente com a mesma conta retorna o mesmo erro.
1068 1082
1069```text theme={null}1083```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 access1084Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
1071```1085```
1072 1086
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.1087Esta é uma configuração da organização no lado do servidor, então não pode ser sobrescrita por configurações locais, variáveis de ambiente ou flags da CLI.
1074 1088
1075O Agent SDK e o modo não interativo `-p` apresentam isso como o código de erro `oauth_org_not_allowed`.1089O Agent SDK e o modo não interativo `-p` apresentam isso como o código de erro `oauth_org_not_allowed`.
1076 1090
1077**O que fazer:**1091**O que fazer:**
1078 1092
1079* Peça ao seu administrador para habilitar o acesso ao Claude Code para sua organização1093* 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.1094* 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)1095* Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com o [suporte da Anthropic](https://support.claude.com)
1082 1096
1083<h3 id="routines-are-disabled-by-your-organizations-policy">1097<h3 id="routines-are-disabled-by-your-organizations-policy">
1084 Rotinas são desabilitadas pela política da sua organização1098 Routines are disabled by your organization's policy
1085</h3>1099</h3>
1086 1100
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.1101Um Owner na 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 1102
1089```text theme={null}1103```text theme={null}
1090Routines are disabled by your organization's policy.1104Routines are disabled by your organization's policy.
1091```1105```
1092 1106
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.1107Esta é uma configuração no lado do servidor, então não pode ser sobrescrita por configurações locais, variáveis de ambiente ou flags da CLI.
1094 1108
1095**O que fazer:**1109**O que fazer:**
1096 1110
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)1111* 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)1112* Para trabalhos agendados pontuais que não exigem rotinas no nível da organização, consulte [tarefas agendadas](/docs/pt/scheduled-tasks)
1099 1113
1100<h3 id="remote-control-requires-the-anthropic-api">1114<h3 id="remote-control-requires-the-anthropic-api">
1101 Remote Control requer a API Anthropic1115 Remote Control requires the Anthropic API
1102</h3>1116</h3>
1103 1117
1104A sessão não está falando com a API Anthropic diretamente, portanto, [Remote Control](/docs/pt/remote-control) requer.1118A sessão não está se comunicando diretamente com a Anthropic API, o que o [Remote Control](/docs/pt/remote-control) exige.
1105 1119
1106```text theme={null}1120```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.1121Remote 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```1122```
1109 1123
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:1124Uma 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 menciona:
1111 1125
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)1126* 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 Control1127* [`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ê faz login 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`1128* `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-la1129* Um login de [gateway de nuvem](/docs/pt/claude-apps-gateway) corporativo feito pelo `/login`, que não oferece suporte ao Remote Control e não tem variável para remover
1116 1130
1117**O que fazer:**1131**O que fazer:**
1118 1132
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 diretamente1133* Remova a definição da variável que a mensagem menciona, como `CLAUDE_CODE_USE_BEDROCK` ou `ANTHROPIC_BASE_URL`, e reinicie a sessão, ou inicie o Remote Control a partir de uma sessão que se comunica diretamente com a Anthropic API
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ão1134* 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)1135* 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 1136
1123<h3 id="remote-control-couldnt-refresh-your-login">1137<h3 id="remote-control-couldnt-refresh-your-login">
1124 Remote Control não conseguiu atualizar seu login1138 Remote Control couldn't refresh your login
1125</h3>1139</h3>
1126 1140
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.1141O Claude Code executa 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ê faça login novamente. Qualquer uma das falhas pode acontecer enquanto o Claude Code ainda está se conectando ou mais tarde, quando ele renova as credenciais.
1128 1142
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`.1143Quando o Claude Code pede ao serviço de login que atualize seu login salvo e não obtém resposta, ele mantém o Remote Control em execução e tenta a atualização novamente enquanto a credencial atual da conexão ainda é válida. Uma atualizaçã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 1144
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:1145Quando 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 1146
1133```text theme={null}1147```text theme={null}
1134Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control1148Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
1140Remote Control disconnected — Signed out of Claude — run /login, then /remote-control1154Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
1141```1155```
1142 1156
1143Claude Code nomeia a causa no meio da mensagem:1157O Claude Code indica a causa no meio da mensagem:
1144 1158
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 revogado1159* `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ção1160* `OAuth token unavailable`: o Claude Code não tinha nenhum token de login salvo quando a credencial da conexão precisou ser renovada
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 novo1161* `OAuth token refresh failed`: o claude.ai rejeitou seu token de login salvo enquanto o Claude Code estava se reconectando, e a atualização do token não produziu um novo
1148* `JWT refresh failed: no OAuth token`: Claude Code não encontrou nenhum token de login salvo para renovar1162* `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ão1163* `Signed out of Claude`: você fez logout nesta máquina, por exemplo, executando `/logout` em outro terminal, então o Claude Code não tem mais nenhum login salvo para renovar a conexão
1150 1164
1151**O que fazer:**1165**O que fazer:**
1152 1166
1153* Execute `/login` para se conectar novamente1167* Execute `/login` para fazer login 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.1168* Execute `/remote-control` para reconectar a sessão. Mensagens que terminam com `run /login to restore Remote Control` não precisam desta etapa: o Claude Code se reconecta sozinho assim que você faz login.
1155 1169
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.1170Antes 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 1171
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.1172Antes 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 atualização de login ficava sem resposta.
1159 1173
1160<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1174<h3 id="remote-control-stopped-because-the-signed-in-account-changed">
1161 Remote Control parou porque a conta conectada mudou1175 Remote Control stopped because the signed-in account changed
1162</h3>1176</h3>
1163 1177
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.1178O Claude Code mostra esta linha durante uma sessão do [Remote Control](/docs/pt/remote-control) quando você faz login 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 1179
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.1180Uma sessão do Remote Control que você iniciou enquanto estava conectado pelo `/login` pertence à conta e à organização claude.ai que estavam conectadas naquele momento.
1167 1181
1168```text theme={null}1182```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-control1183Remote 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```1184```
1171 1185
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.1186O Claude Code interrompe a sessão do Remote Control assim que o claude.ai confirma que a conta ou a organização mudou. Sua sessão local continua em execução sem o Remote Control.
1173 1187
1174**O que fazer:**1188**O que fazer:**
1175 1189
1176* Execute `/remote-control` para iniciar uma nova sessão Remote Control sob a conta ou organização atual1190* 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`.1191* Para voltar, execute `/login` e faça login novamente na conta ou organização anterior. Depois execute `/remote-control`.
1178 1192
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.1193Antes da v2.1.234, o Claude Code não percebia quando você trocava 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 1194
1181<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">1195<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 contas1196 Remote Control stopped because the app running the session signed out or switched accounts
1183</h3>1197</h3>
1184 1198
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:1199Quando o aplicativo Claude para desktop ou uma IDE hospeda sua sessão, o Claude Code obtém o token de login desse aplicativo em vez do `/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 1200
1187```text theme={null}1201```text theme={null}
1188Remote Control stopped — the app running this session is now signed in to a different Claude account1202Remote 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 on1203Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
1190```1204```
1191 1205
1192Sua sessão local continua em execução sem Remote Control.1206Sua sessão local continua em execução sem o Remote Control.
1193 1207
1194**O que fazer:**1208**O que fazer:**
1195 1209
1196* Se o aplicativo está desconectado, conecte-se a ele novamente e depois ative Remote Control novamente no aplicativo1210* Se o aplicativo estiver desconectado, faça login 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.1211* 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 1212
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.1213Antes da v2.1.238, o Claude Code enviava ao aplicativo as mensagens `run /login` listadas em [Remote Control couldn't refresh your login](#remote-control-couldnt-refresh-your-login) em ambos os casos.
1200 1214
1201<h3 id="oauth-token-revoked-or-expired">1215<h3 id="oauth-token-revoked-or-expired">
1202 Token OAuth revogado ou expirado1216 OAuth token revoked or expired
1203</h3>1217</h3>
1204 1218
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.1219Seu login salvo não é mais válido. Um token revogado significa que você fez logout em todos os lugares ou que um administrador removeu o acesso; um token expirado significa que a atualização automática falhou no meio da sessão.
1206 1220
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.1221Ambas 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 atualização com falha, você vê [Login expired](#login-expired) em vez disso. 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 1222
1209```text theme={null}1223```text theme={null}
1210OAuth token revoked · Please run /login1224OAuth token revoked · Please run /login
1211Please run /login · API Error: 401 OAuth token has expired ...1225Please run /login · API Error: 401 OAuth token has expired ...
1212```1226```
1213 1227
1228No [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), as mensagens são as seguintes, e o código de erro estruturado é `authentication_failed`:
1229
1230```text theme={null}
1231Failed to authenticate: OAuth token revoked. Please log in again or contact your administrator.
1232Failed to authenticate. API Error: 401 OAuth token has expired ...
1233```
1234
1235Antes da v2.1.287, no modo não interativo e no Agent SDK, a mensagem de token revogado dizia `Your account does not have access to Claude. Please login again or contact your administrator.`
1236
1214**O que fazer:**1237**O que fazer:**
1215 1238
1216* Execute `/login` para se conectar novamente1239* Execute `/login` no prompt do Claude Code para fazer login 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.1240* Se o seu comando `-p` ou programa do Agent SDK usa um login salvo, execute `claude` no mesmo ambiente, conclua o `/login` e então execute o comando ou programa novamente. Para automação que não pode fazer login interativamente, autentique-se com [`ANTHROPIC_API_KEY`](/docs/pt/env-vars) ou [gere um token de longa duração com `claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token).
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)1241* Se você se autentica com a variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`, o Claude Code continua enviando o valor que você definiu depois que uma requisição falha com 401, em vez de passar para o token de um login armazenado. [`/status`](/docs/pt/commands) mostra essa credencial como uma linha `Auth token` com o valor `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 falhava novamente com erros 401 quando esse token expirava.
1219* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, veja [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)1242* 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)
1243* 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 1244
1221<h3 id="api-error-401-invalid-authentication-credentials">1245<h3 id="api-error-401-invalid-authentication-credentials">
1222 API Error: 401 Credenciais de autenticação inválidas1246 API Error: 401 Invalid authentication credentials
1223</h3>1247</h3>
1224 1248
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.1249A API reconheceu o formato da sua credencial, mas rejeitou a conta ou a 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, então 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 delas está ativa.
1226 1250
1227```text theme={null}1251```text theme={null}
1228Please run /login · API Error: 401 Invalid authentication credentials1252Please run /login · API Error: 401 Invalid authentication credentials
1230 1254
1231**O que fazer:**1255**O que fazer:**
1232 1256
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`.1257* 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 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.1258* 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.1259* Se a mesma mensagem voltar para a mesma conta de login, a conta ou a organização não está mais ativa. Verifique a conta e a organização que `/status` informa e peça ao administrador da sua organização que restaure o acesso.
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.1260* 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 e não da Anthropic, e o `/login` não a altera. Em vez disso, corrija a credencial que seu gateway espera.
1237 1261
1238<h3 id="login-expired">1262<h3 id="login-expired">
1239 Login expirado1263 Login expired
1240</h3>1264</h3>
1241 1265
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.1266O Claude Code tentou renovar seu login claude.ai salvo e o serviço OAuth rejeitou o refresh token 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 o `/login` pode criar novas credenciais.
1243 1267
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.1268Antes da v2.1.206, o Claude Code enviava a requisição ao modelo mesmo assim, com qualquer credencial que restasse no ambiente, e então todos os modelos falhavam com [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) ou um 401 em vez de um prompt para fazer login.
1245 1269
1246```text theme={null}1270```text theme={null}
1247Login expired · Please run /login1271Login expired · Please run /login
1248```1272```
1249 1273
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`:1274No [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 1275
1252```text theme={null}1276```text theme={null}
1253Failed to authenticate: OAuth session expired and could not be refreshed1277Failed to authenticate: OAuth session expired and could not be refreshed
1254```1278```
1255 1279
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).1280Este não é o mesmo estado que [OAuth token revoked or expired](#oauth-token-revoked-or-expired). Aquelas mensagens relatam uma rejeição retornada pela API. O próprio Claude Code produz `Login expired` para um login que ele já não conseguiu renovar, então nenhuma requisição é enviada. Quando a renovação falha porque a própria conta está suspensa, e não porque o login está desatualizado, o Claude Code mostra [Your account is on hold](#your-account-is-on-hold) em vez disso.
1257 1281
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.1282Sessõ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 1283
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.1284Você pode verificar esse estado antes que uma requisição falhe: [`/status`](/docs/pt/commands) mostra uma linha `Login` com o valor `Expired — log in again`, além da organização e do e-mail salvos 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á tivesse existido, porque a credencial apagada não deixava nada para relatar.
1261 1285
1262**O que fazer:**1286**O que fazer:**
1263 1287
1264* Execute `/login` para se conectar novamente. Tentar novamente sem se conectar mostra a mesma mensagem em cada solicitação.1288* Execute `/login` para fazer login novamente. Tentar novamente sem fazer login 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).1289* Se você fizer login com sua conta claude.ai em outra janela do Claude Code, consulte [Not logged in](#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)1290* No modo não interativo, execute `claude` no mesmo ambiente, conclua o `/login` e então execute seu comando novamente. Para automação que não pode fazer login interativamente, autentique-se com `ANTHROPIC_API_KEY` ou [gere um token de longa duração com `claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token).
1291* Se o login continuar falhando, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
1267 1292
1268<h3 id="could-not-refresh-your-login">1293<h3 id="could-not-refresh-your-login">
1269 Não foi possível atualizar seu login porque outro processo Claude Code está atualizando-o1294 Could not refresh your login because another Claude Code process is refreshing it
1270</h3>1295</h3>
1271 1296
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:1297Esta 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 detinha o bloqueio compartilhado de atualização, ou terminou e o deixou para trás, e a atualização não progrediu enquanto esta sessão esperava. O Claude Code interrompe a requisição antes de enviá-la:
1273 1298
1274```text theme={null}1299```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 /login1300Could 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```1301```
1277 1302
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`:1303No [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 1304
1280```text theme={null}1305```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 again1306Failed 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```1307```
1283 1308
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.1309Sessõ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 1310
1286**O que fazer:**1311**O que fazer:**
1287 1312
1288* Tente novamente em um minuto. Se outro processo completar a atualização primeiro, essa sessão usa o login renovado.1313* Tente novamente em um minuto. Se outro processo concluir a atualizaçã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.1314* Se a mensagem continuar voltando, feche as 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.1315* Se ela voltar sem nenhum outro processo do Claude Code em execução, execute `/login`. Fazer login novamente não espera pelo bloqueio de atualização.
1291 1316
1292<h3 id="couldnt-save-your-login">1317<h3 id="couldnt-save-your-login">
1293 Não foi possível salvar seu login1318 Couldn't save your login
1294</h3>1319</h3>
1295 1320
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.1321Você fez login 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, durante a suspensão ou inatividade, depois que o Claude Code já leu ou salvou credenciais nele durante a mesma sessão.
1297 1322
1298```text theme={null}1323```text theme={null}
1299Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.1324Couldn'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.1325Couldn't save your login. Try logging in again.
1301```1326```
1302 1327
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.1328A 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 1329
1305**O que fazer:**1330**O que fazer:**
1306 1331
1307* No macOS, desbloqueie o keychain de login e execute `/login` novamente1332* No macOS, desbloqueie o keychain de login e então execute `/login` novamente
1308* Em outras plataformas, execute `/login` novamente1333* 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 credenciais1334* 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 1335
1311<h3 id="failed-to-start-oauth-callback-server">1336<h3 id="failed-to-start-oauth-callback-server">
1312 Falha ao iniciar servidor de callback OAuth1337 Failed to start OAuth callback server
1313</h3>1338</h3>
1314 1339
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:1340Quando `/login`, `claude auth login` ou `claude setup-token` faz seu login pelo navegador, o Claude Code abre uma porta de escuta em `127.0.0.1` para que seu navegador possa devolver o resultado do login a ele. Esta mensagem significa que o Claude Code não conseguiu abrir essa porta, e o login é interrompido antes que uma janela do navegador ou uma URL de login apareça:
1316 1341
1317```text theme={null}1342```text theme={null}
1318Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1343Failed to start OAuth callback server: Failed to start server. Is port 0 in use?
1319```1344```
1320 1345
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.1346Se sua mensagem termina 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 1347
1323**O que fazer:**1348**O que fazer:**
1324 1349
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.1350* Para fazer login 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 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.1351* Para usar o login pelo navegador nesta máquina, o Claude Code precisa conseguir escutar em `127.0.0.1`. Se ele for executado dentro de um sandbox, verifique se a política do sandbox permite escutar em portas locais e então execute `/login` novamente. Se ele deveria conseguir e ainda assim falhar, execute `/feedback` para que o relatório inclua os detalhes do seu ambiente.
1327 1352
1328<h3 id="claude-login-not-accepted">1353<h3 id="claude-login-not-accepted">
1329 Claude login não aceito1354 Claude login not accepted
1330</h3>1355</h3>
1331 1356
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.1357Você 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 1358
1334A primeira parte da linha é o próprio motivo do servidor quando fornece um. Caso contrário, a linha lê:1359A primeira parte da linha é o próprio motivo do servidor, quando ele informa um. Caso contrário, a linha diz:
1335 1360
1336```text theme={null}1361```text theme={null}
1337Claude login not accepted · Run /login, then try again1362Claude login not accepted · Run /login, then try again
1339 1364
1340**O que fazer:**1365**O que fazer:**
1341 1366
1342* Execute `/login`, complete a conexão e inicie a sessão novamente1367* Execute `/login`, conclua o login e então inicie a sessão novamente
1343 1368
1344<h3 id="artifacts-need-a-claude-ai-login">1369<h3 id="artifacts-need-a-claude-ai-login">
1345 Artefatos precisam de um login claude.ai1370 Artifacts need a claude.ai login
1346</h3>1371</h3>
1347 1372
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.1373O Claude Code recusou a publicação ou leitura de um [artefato](/docs/pt/artifacts) porque a sessão não tem um login claude.ai que possa usar para artefatos.
1349 1374
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ê:1375Todas as formas da mensagem começam com as mesmas palavras, seguidas de uma solução que depende de como sua sessão se autentica. Sem nenhuma credencial concorrente, ela diz:
1351 1376
1352```text theme={null}1377```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.1378Artifacts 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:**1381**O que fazer:**
1357 1382
1358* Execute `/login` e selecione **Claude account with subscription**. A opção **Anthropic Console account** não fornece credenciais claude.ai.1383* 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`1384* Quando a mensagem mencionar uma credencial que tem precedência, como `ANTHROPIC_API_KEY`, uma configuração `apiKeyHelper` ou uma chave do Console salva por um `/login` anterior, remova-a da forma que a mensagem indica e então execute `/login`
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ão1385* Quando a mensagem disser que esta sessão remota se autentica pela máquina que a iniciou, faça login no claude.ai nessa máquina e então reconecte a sessão
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.ai1386* Quando a mensagem disser que a credencial é injetada pelo ambiente host da sessão, você não pode alterá-la nessa sessão; inicie uma sessão que esteja conectada ao claude.ai
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ção1387* Consulte [Disponibilidade](/docs/pt/artifacts#availability) para os outros requisitos dos artefatos, como plano, provedor de modelo e política da organização
1363 1388
1364<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1389<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">
1365 A política do administrador requer um login do gateway de nuvem1390 Administrator policy requires a Cloud gateway sign-in
1366</h3>1391</h3>
1367 1392
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:1393As [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 passa a aceitar apenas o login do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway). Você vê uma de duas mensagens:
1369 1394
1370```text theme={null}1395```text theme={null}
1371Not signed in to the Cloud gateway — run /login.1396Not signed in to the Cloud gateway — run /login.
1372```1397```
1373 1398
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.1399As requisições ao modelo falham com esta mensagem quando a sessão não tem um login no gateway, por exemplo, porque você não executou `/login` desde que a política chegou à máquina.
1375 1400
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:1401Se a máquina também tiver uma credencial emitida pela Anthropic e as configurações gerenciadas definirem `forceLoginMethod` ou `forceLoginOrgUUID`, o Claude Code é encerrado 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.
1402
1403A mensagem de inicialização indica a credencial com a qual a sessão está configurada, onde ela está definida e a etapa que a remove. Por exemplo, com uma variável `ANTHROPIC_API_KEY` definida no seu shell, ela diz:
1377 1404
1378```text theme={null}1405```text theme={null}
1379Administrator policy requires a Cloud gateway sign-in on this machine; the1406Administrator policy requires a Cloud gateway sign-in on this machine, but this session is configured with an API key from ANTHROPIC_API_KEY, which a gateway machine does not accept.
1380Anthropic-issued credential configured here (ANTHROPIC_API_KEY,1407
1381ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.1408To continue: unset ANTHROPIC_API_KEY (or run in a shell without it), then run claude and sign in with /login.
1382```1409```
1383 1410
1384**O que fazer:**1411**O que fazer:**
1385 1412
1386* Execute `/login` e complete a conexão na tela **Cloud gateway**1413* Para `Not signed in to the Cloud gateway`, 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`1414* Para a mensagem de inicialização, remova a credencial seguindo as etapas no final da mensagem
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 gerenciadas1415* Se você acredita que a máquina não deveria exigir o gateway, peça ao administrador que a gerencia que remova `forceLoginMethod` e `forceLoginGatewayUrl` das configurações gerenciadas dela
1389 1416
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.1417Antes da v2.1.284, a mensagem de inicialização listava as credenciais possíveis em vez de indicar a configurada. Ela começava com `Administrator policy requires a Cloud gateway sign-in on this machine; the Anthropic-issued credential configured here (ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.` Se você vir esse texto e não conseguir saber qual credencial remover, atualize para a v2.1.284 ou posterior e inicie o `claude` novamente.
1391 1418
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á.1419Na 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.
1420
1421Antes da v2.1.261, em máquinas que definem `forceLoginMethod` como `"gateway"`, o Claude Code usava um login salvo remanescente em vez de falhar as requisições ao 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.
1393 1422
1394<h3 id="your-account-is-on-hold">1423<h3 id="your-account-is-on-hold">
1395 Sua conta está em espera1424 Your account is on hold
1396</h3>1425</h3>
1397 1426
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:1427A 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 1428
1400```text theme={null}1429```text theme={null}
1401Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1430Your 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/restricted1431Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
1403```1432```
1404 1433
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.1434Fazer login 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 conseguem remover uma suspensão.
1406 1435
1407**O que fazer:**1436**O que fazer:**
1408 1437
1409* Abra o link na mensagem para visualizar os detalhes da espera ou apelá-la1438* 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`1439* 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 1440
1412<h3 id="anthropic-profile-login-expired">1441<h3 id="anthropic-profile-login-expired">
1413 Login de perfil Anthropic expirado1442 Anthropic profile login expired
1414</h3>1443</h3>
1415 1444
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.1445O 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 atualizaçã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 1446
1418```text theme={null}1447```text theme={null}
1419Anthropic profile login expired · Re-authenticate your Anthropic profile1448Anthropic 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 profile1449Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
1421```1450```
1422 1451
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.1452Isso 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ê [fez login 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 bearer token como `ANTHROPIC_AUTH_TOKEN` ou um provedor de terceiros nunca veem esta mensagem.
1424 1453
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:1454Em 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 faça login 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, o `/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 1455
1427* Quando você define `ANTHROPIC_PROFILE` explicitamente, a mensagem termina com `Re-authenticate your Anthropic profile`.1456* 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.1457* Quando o Claude Code descobriu o perfil no 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` também neste caso.
1429 1458
1430**O que fazer:**1459**O que fazer:**
1431 1460
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 criou1461* Faça login no perfil novamente e então tente novamente: 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 nova1462* Se um administrador provisionou a credencial do perfil, peça a ele que emita uma nova
1434* Execute `/status` para confirmar a fonte de credencial ativa e o nome do perfil1463* 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`1464* Para deixar de usar o perfil, remova a definição de `ANTHROPIC_PROFILE` se você a definiu e então autentique-se de outra forma, como `/login` ou `ANTHROPIC_API_KEY`
1436 1465
1437<h3 id="oauth-scope-requirement">1466<h3 id="oauth-scope-requirement">
1438 Requisito de escopo OAuth1467 OAuth scope requirement
1439</h3>1468</h3>
1440 1469
1441O token armazenado é anterior a um escopo de permissão que um recurso mais novo precisa:1470O token armazenado é anterior a um escopo de permissão de que um recurso mais recente precisa:
1442 1471
1443```text theme={null}1472```text theme={null}
1444OAuth token does not meet scope requirement: user:profile1473OAuth token does not meet scope requirement: user:profile
1446 1475
1447**O que fazer:**1476**O que fazer:**
1448 1477
1449* Execute `/login` para obter um novo token com os escopos atuais. Você não precisa fazer logout primeiro.1478* Execute `/login` para obter um novo token com os escopos atuais. Você não precisa fazer logout antes.
1450 1479
1451<h3 id="claude-ai-rejected-the-session-token">1480<h3 id="claude-ai-rejected-the-session-token">
1452 claude.ai rejeitou o token da sessão1481 claude.ai rejected the session token
1453</h3>1482</h3>
1454 1483
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ê:1484Uma 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 no Claude Code. O token rejeitado é o seu login, e não a autorização própria do conector no claude.ai, então autorizar o conector novamente não resolve. Em `/mcp`, o conector aparece como `session token rejected` e sua visualização de detalhes diz:
1456 1485
1457```text theme={null}1486```text theme={null}
1458claude.ai rejected the session token. Run /login, then reconnect.1487claude.ai rejected the session token. Run /login, then reconnect.
1460 1489
1461**O que fazer:**1490**O que fazer:**
1462 1491
1463* Execute `/login` para se conectar novamente1492* Execute `/login` para fazer login 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.1493* Reconecte o conector pelo `/mcp` ou execute `/mcp reconnect <server>`. Reconectar antes de fazer login novamente deixa o conector no mesmo estado. A opção **Reconnect** do painel `/mcp` informa `your claude.ai session token was rejected`; a forma digitada `/mcp reconnect <server>` informa uma reconexão bem-sucedida mesmo que o token ainda seja rejeitado.
1465 1494
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.1495Antes da v2.1.222, o Claude Code marcava o conector como precisando de autenticação, o que direcionava você ao fluxo de autorização do conector, embora concluí-lo não resolvesse o estado.
1467 1496
1468<h3 id="mcp-server-needs-you-to-sign-in-again">1497<h3 id="mcp-server-needs-you-to-sign-in-again">
1469 Servidor MCP precisa que você se conecte novamente1498 MCP server needs you to sign in again
1470</h3>1499</h3>
1471 1500
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).1501Um [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 o `/mcp` marca o servidor como [precisando de autenticação](/docs/pt/mcp#authenticate-with-remote-mcp-servers).
1473 1502
1474Para um servidor que você se conecta a partir de Claude Code, incluindo um conector claude.ai, a conexão expirou ou foi revogada:1503Para um servidor no qual você faz login a partir do Claude Code, incluindo um conector do claude.ai, o login expirou ou foi revogado:
1475 1504
1476```text theme={null}1505```text theme={null}
1477MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1506MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)
1478```1507```
1479 1508
1480Execute `/mcp`, selecione o servidor e conecte-se novamente a partir de seu menu.1509Execute `/mcp`, selecione o servidor e faça login novamente pelo menu dele.
1481 1510
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:1511Para 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 de novo uma vez antes de mostrar isto:
1483 1512
1484```text theme={null}1513```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)1514MCP 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```1515```
1487 1516
1488Verifique se o helper retorna uma credencial que o servidor aceita, depois reconecte de `/mcp`, que executa o helper novamente.1517Verifique se o helper retorna uma credencial que o servidor aceita e então reconecte pelo `/mcp`, que executa o helper novamente.
1489 1518
1490Para um servidor com um cabeçalho `Authorization` estático em sua configuração:1519Para um servidor com um cabeçalho `Authorization` estático na sua configuração:
1491 1520
1492```text theme={null}1521```text theme={null}
1493MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)1522MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
1494```1523```
1495 1524
1496Atualize o valor do cabeçalho onde o servidor está configurado, depois reconecte de `/mcp`.1525Atualize o valor do cabeçalho onde o servidor está configurado e então reconecte pelo `/mcp`.
1497 1526
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)`.1527Antes 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 1528
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:1529Um 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 indica esse escopo:
1501 1530
1502```text theme={null}1531```text theme={null}
1503MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate1532MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate
1504```1533```
1505 1534
1506Execute `/mcp`, selecione o servidor e autentique-se novamente a partir de seu menu.1535Execute `/mcp`, selecione o servidor e autentique-se novamente pelo menu dele.
1507 1536
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.1537Quando 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), o Claude Code solicita o escopo que o servidor indicou. 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 1538
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.1539Antes 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 1540
1512<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">1541<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álida1542 MCP server URL is missing or not a valid URL
1514</h3>1543</h3>
1515 1544
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:1545O Claude Code se recusou a iniciar um login OAuth para um servidor MCP remoto porque a `url` configurada do servidor não é analisada 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 1546
1518```text theme={null}1547```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.1548Couldn'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 1550
1522**O que fazer:**1551**O que fazer:**
1523 1552
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.1553* 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) indica, e então execute o login novamente.
1525 1554
1526<h3 id="issuer-mismatch-in-authorization-response">1555<h3 id="issuer-mismatch-in-authorization-response">
1527 Incompatibilidade de emissor na resposta de autorização1556 Issuer mismatch in authorization response
1528</h3>1557</h3>
1529 1558
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:1559Durante 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 indica 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 no navegador:
1531 1560
1532```text theme={null}1561```text theme={null}
1533Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1562Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
1534```1563```
1535 1564
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.1565`expected` é o emissor dos metadados OAuth do servidor, e `received` é o valor de `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`, caso em que o Claude Code faz o login falhar.
1537 1566
1538**O que fazer:**1567**O que fazer:**
1539 1568
1540* Tente a conexão novamente de `/mcp`1569* Tente o login novamente pelo `/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 metadados1570* Se o erro se repetir, relate-o ao operador do servidor. A correção é no lado do servidor: o servidor de autorização deve retornar no parâmetro `iss` o mesmo emissor que anuncia em seus metadados
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 servidor1571* 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 esta verificação. Isso remove uma proteção contra ataques de mix-up, então prefira a correção no lado do servidor
1543 1572
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`.1573Antes 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 1574
1546<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">1575<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">
1547 Recusando enviar credenciais para endpoint de token não-https1576 Refusing to send credentials to non-https token endpoint
1548</h3>1577</h3>
1549 1578
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.1579No [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 desses, então o Claude Code parou antes de enviar a requisição. Isso acontece após o login no navegador, então a etapa do navegador é bem-sucedida primeiro, e novamente sempre que o Claude Code atualiza o token do servidor.
1551 1580
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:1581Em sua forma completa, a mensagem vem do MCP SDK e cita o endpoint de token que ele recusou. No log de depuração, ela vem após `Error during auth completion:` para um login ou `Token refresh failed:` para uma atualização. No seu shell, `claude mcp login <name>` a imprime após `Couldn't complete authentication for "<name>":`, e em uma sessão, o `/mcp` a mostra no menu do servidor:
1553 1582
1554```text theme={null}1583```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).1584Refusing 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```1585```
1557 1586
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`.1587O Claude Code trata uma URL de servidor que tenha uma query string ou um segmento de caminho longo e de aparência aleatória como possivelmente secreta. Para esse tipo de 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 o mesmo formato ali. A mensagem ocultada só pode ser este erro quando o endpoint de token do servidor é `http://` simples em um endereço diferente de `localhost`, `127.0.0.1` ou `::1`.
1559 1588
1560**O que fazer:**1589**O que fazer:**
1561 1590
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://`1591* 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 HTTPS1592* 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 esta regra e envia a requisição de token por HTTP simples. Essa escolha dura até você sair e se aplica a todos os servidores. O runtime v1 também ignora a [verificação do emissor](#issuer-mismatch-in-authorization-response), então prefira servir o endpoint por HTTPS
1564 1593
1565<h3 id="aws-credentials-expired-or-invalid">1594<h3 id="aws-credentials-expired-or-invalid">
1566 Credenciais AWS expiradas ou inválidas1595 AWS credentials expired or invalid
1567</h3>1596</h3>
1568 1597
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.1598Seu token de sessão da AWS expirou ou foi rejeitado. Esta mensagem aparece em um 401 da [Claude Platform na 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 1599
1571A dica de ação no meio varia com sua configuração. A parte estável é o `AWS credentials expired or invalid` inicial:1600A dica de ação no meio varia conforme sua configuração. A parte estável é o início `AWS credentials expired or invalid`:
1572 1601
1573```text theme={null}1602```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 ...1603AWS 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```1604```
1576 1605
1577Antes da v2.1.273, essa mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.1606Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.
1578 1607
1579**O que fazer:**1608**O que fazer:**
1580 1609
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 administrador1610* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
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 proxy1611* Se [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) estiver definido, execute em outro terminal o comando indicado na mensagem, como `aws sso login --profile myprofile`, e conclua o login no navegador, depois tente novamente. Caso contrário, atualize você mesmo a credencial da AWS que usa: seu login SSO, chaves de acesso, chave de API ou token de proxy
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)1612* Com `awsAuthRefresh` definido em uma sessão interativa, você pode, em vez disso, executar `/login`, escolher **3rd-party platform** e então selecionar **Claude Platform on AWS · refresh credentials** em **Using 3rd-party platforms** para executar o mesmo comando sem reiniciar o Claude Code. Consulte [Configurar credenciais da AWS](/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 perfil1613* Se o erro se repetir depois que o comando de atualização for bem-sucedido, confirme que a identidade é válida fora do Claude Code com `aws sts get-caller-identity` no mesmo shell e perfil
1585 1614
1586<h3 id="aws-authentication-failed">1615<h3 id="aws-authentication-failed">
1587 Falha na autenticação AWS1616 AWS authentication failed
1588</h3>1617</h3>
1589 1618
1590Seu provedor AWS retornou um 403, ou [Amazon Bedrock](/docs/pt/amazon-bedrock) retornou um 401.1619Seu provedor AWS retornou um 403, ou o [Amazon Bedrock](/docs/pt/amazon-bedrock) retornou um 401.
1591 1620
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.1621O Amazon Bedrock relata um token de segurança expirado como 403, mas um 403 também é como ele relata uma negação de autorização, como uma `AccessDeniedException` causada pela falta de uma permissão do IAM. O Claude Code não consegue distinguir essas duas causas.
1593 1622
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.1623Um 401 do Amazon Bedrock também cai aqui em vez de em [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), porque o Amazon Bedrock não relata um token expirado como 401. Um 401 desse endpoint normalmente vem de algo mais no caminho da requisição, como um proxy corporativo.
1595 1624
1596Uma atualização de credencial corrige um token expirado e não consegue corrigir as outras causas, portanto, a mensagem oferece ambas:1625Uma atualização de credencial corrige um token expirado, mas não consegue corrigir as outras causas, então a mensagem oferece ambas:
1597 1626
1598```text theme={null}1627```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 ...1628AWS 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```1629```
1601 1630
1602A dica de ação no meio varia com sua configuração. A parte estável é o `AWS authentication failed` inicial.1631A dica de ação no meio varia conforme sua configuração. A parte estável é o início `AWS authentication failed`.
1603 1632
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.1633Quando o 403 é a resposta do Amazon Bedrock de que você não tem acesso ao modelo com o ID de modelo especificado, a dica, em vez disso, diz para você habilitar o modelo para sua conta e região no console do Amazon Bedrock.
1605 1634
1606Antes da v2.1.273, essa mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.1635Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.
1607 1636
1608**O que fazer:**1637**O que fazer:**
1609 1638
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 administrador1639* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
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 proxy1640* Atualize suas credenciais da AWS caso uma credencial expirada seja a causa: execute o comando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) indicado na mensagem, quando houver um definido, ou atualize 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ão1641* Se suas credenciais estiverem atualizadas, confirme que as permissões do 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 usam1642* Execute `aws sts get-caller-identity` para confirmar qual identidade suas requisições usam
1614 1643
1615<h3 id="google-cloud-credentials-expired-or-invalid">1644<h3 id="google-cloud-credentials-expired-or-invalid">
1616 Credenciais do Google Cloud expiradas ou inválidas1645 Google Cloud credentials expired or invalid
1617</h3>1646</h3>
1618 1647
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.1648Suas 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 1649
1621A dica de ação no meio varia com sua configuração. A parte estável é o `Google Cloud credentials expired or invalid` inicial:1650A dica de ação no meio varia conforme sua configuração. A parte estável é o início `Google Cloud credentials expired or invalid`:
1622 1651
1623```text theme={null}1652```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 ...1653Google 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 1655
1627**O que fazer:**1656**O que fazer:**
1628 1657
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 administrador1658* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
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 novamente1659* Se você se autentica com application default credentials, execute o comando [`gcpAuthRefresh`](/docs/pt/google-vertex-ai#advanced-credential-configuration) indicado 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 novamente1660* Se você faz o roteamento por um [gateway de LLM](/docs/pt/llm-gateway) com `CLAUDE_CODE_SKIP_VERTEX_AUTH` definida, atualize o token do gateway em `ANTHROPIC_AUTH_TOKEN` ou `ANTHROPIC_CUSTOM_HEADERS` e então tente novamente
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)1661* Se você se autentica com um arquivo de chave de conta de serviço, confirme que `GOOGLE_APPLICATION_CREDENTIALS` aponta para uma chave válida. Consulte [Configurar credenciais do GCP](/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 shell1662* Se o erro se repetir após uma atualização, confirme que a identidade funciona fora do Claude Code com `gcloud auth application-default print-access-token` no mesmo shell
1634 1663
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.1664Antes da v2.1.273, um 401 do Agent Platform mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar as credenciais do Google Cloud.
1636 1665
1637<h3 id="google-cloud-authentication-failed">1666<h3 id="google-cloud-authentication-failed">
1638 Falha na autenticação do Google Cloud1667 Google Cloud authentication failed
1639</h3>1668</h3>
1640 1669
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.1670A [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) retornou um 403, que ela usa para negações de autorização em vez de credenciais expiradas. Geralmente, a identidade com a qual você se autentica não tem uma permissão de IAM, ou o modelo não está habilitado para o seu projeto.
1642 1671
1643A dica de ação no meio varia com sua configuração. A parte estável é o `Google Cloud authentication failed` inicial:1672A dica de ação no meio varia de acordo com a sua configuração. A parte estável é o `Google Cloud authentication failed` inicial:
1644 1673
1645```text theme={null}1674```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 ...1675Google 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 1677
1649**O que fazer:**1678**O que fazer:**
1650 1679
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 administrador1680* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com o seu administrador
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 autentica1681* Confirme se as funções em [Configuração de IAM](/docs/pt/google-vertex-ai#iam-configuration) foram concedidas à 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)1682* Confirme se o modelo está habilitado para o seu projeto. Consulte [Solicitar acesso ao modelo](/docs/pt/google-vertex-ai#2-request-model-access)
1654 1683
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.1684Antes da v2.1.273, um 403 da Agent Platform exibia a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar as credenciais do Google Cloud.
1656 1685
1657<h3 id="microsoft-foundry-authentication-failed">1686<h3 id="microsoft-foundry-authentication-failed">
1658 Falha na autenticação do Microsoft Foundry1687 Microsoft Foundry authentication failed
1659</h3>1688</h3>
1660 1689
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:1690O [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 `Microsoft Foundry authentication failed` inicial:
1662 1691
1663```text theme={null}1692```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 ...1693Microsoft 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 1695
1667**O que fazer:**1696**O que fazer:**
1668 1697
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 administrador1698* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com o seu administrador
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 novamente1699* 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)1700* Se a credencial estiver atualizada, confirme se a identidade tem acesso ao recurso do Foundry. Consulte [Configuração do Azure RBAC](/docs/pt/microsoft-foundry#azure-rbac-configuration)
1672 1701
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.1702Antes 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 as credenciais do Azure.
1674 1703
1675<h3 id="could-not-load-aws-or-google-cloud-credentials">1704<h3 id="could-not-load-aws-or-google-cloud-credentials">
1676 Não foi possível carregar credenciais AWS ou Google Cloud1705 Could not load AWS or Google Cloud credentials
1677</h3>1706</h3>
1678 1707
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`:1708O 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, então 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 de 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 1709
1681```text theme={null}1710```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.1711API 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.1712API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
1684```1713```
1685 1714
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`.1715No [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 1716
1688**O que fazer:**1717**O que fazer:**
1689 1718
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 Code1719* Execute o comando de login do seu provedor, como `aws sso login --profile myprofile` ou `gcloud auth application-default login`, e depois tente novamente. [Credenciais do Bedrock, Agent Platform ou Foundry não carregando](/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)1720* Se o detalhe indicar `AWS default-chain credential resolve timed out`, a cadeia travou em vez de falhar, então siga [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out)
1692 1721
1693<h3 id="aws-default-chain-credential-resolve-timed-out">1722<h3 id="aws-default-chain-credential-resolve-timed-out">
1694 Resolução de credencial de cadeia padrão AWS expirou1723 AWS default-chain credential resolve timed out
1695</h3>1724</h3>
1696 1725
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.1726A cadeia de provedores de credenciais padrão da AWS não produziu credenciais em 60 segundos, então o Claude Code interrompeu a resolução e falhou a requisição. Esse timeout é uma das causas de [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). A falha é 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 1727
1699```text theme={null}1728```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.1729API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
1701```1730```
1702 1731
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.1732As causas comuns são um comando `credential_process` no seu perfil da AWS que aguarda uma entrada que não pode receber, e um contêiner ou VM cujo serviço de metadados da instância (IMDS) nunca responde à sondagem da cadeia.
1704 1733
1705Antes da v2.1.267, a mensagem lia `API Error: AWS default-chain credential resolve timed out`.1734Antes 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.1735Antes da v2.1.207, uma cadeia travada deixava a requisição aguardando indefinidamente em vez de falhar.
1707 1736
1708**O que fazer:**1737**O que fazer:**
1709 1738
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.1739* 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 navegador1740* 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)1741* 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 1742
1714<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1743<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">
1715 Verificação de configuração Bedrock expirou esperando por AWS1744 Bedrock setup verification timed out waiting for AWS
1716</h3>1745</h3>
1717 1746
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:1747Uma 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 falha a etapa de verificação:
1719 1748
1720```text theme={null}1749```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.1750Timed 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```1751```
1723 1752
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).1753O 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 1754
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.1755As causas comuns são uma rede ou proxy que trava as requisições à AWS, incluindo a atualização do token de 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 1756
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:1757Uma única requisição travada à AWS também pode falhar por seu próprio timeout por requisição, que exibe uma mensagem mais curta na mesma etapa:
1729 1758
1730```text theme={null}1759```text theme={null}
1731A request to AWS timed out. Check your network and proxy settings, then try again.1760A request to AWS timed out. Check your network and proxy settings, then try again.
1732```1761```
1733 1762
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.1763Quando os mesmos timeouts ocorrem na etapa de fixação do modelo, o assistente marca um modelo como `unreachable` em vez de exibir qualquer uma das mensagens.
1735 1764
1736**O que fazer:**1765**O que fazer:**
1737 1766
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.1767* 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`1768* 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)1769* 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 1770
1742<h3 id="cloud-gateway-session-expired">1771<h3 id="cloud-gateway-session-expired">
1743 Sessão de gateway de nuvem expirada1772 Cloud gateway session expired
1744</h3>1773</h3>
1745 1774
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:1775Você 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 1776
1748```text theme={null}1777```text theme={null}
1749Cloud gateway session expired — run /login to reconnect.1778Cloud gateway session expired — run /login to reconnect.
1750```1779```
1751 1780
1752A mesma linha pode aparecer no meio da sessão quando a credencial de gateway expira e Claude Code não consegue renová-la.1781A 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 1782
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:1783Em 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 encerra com esta mensagem quando o gateway não aceita mais a sessão:
1755 1784
1756```text theme={null}1785```text theme={null}
1757Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1786Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
1759 1788
1760**O que fazer:**1789**O que fazer:**
1761 1790
1762* Execute `/login` na sessão e complete a conexão do navegador1791* 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 comando1792* Para uma inicialização não interativa, inicie o `claude` no mesmo ambiente, execute `/login` e depois execute seu comando novamente
1764 1793
1765<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1794<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">
1766 Conexão expirou enquanto esperava você continuar1795 Sign-in timed out while waiting for you to continue
1767</h3>1796</h3>
1768 1797
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:1798Durante um login em um [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 1799
1771```text theme={null}1800```text theme={null}
1772Sign-in timed out while waiting for you to continue. Try again.1801Sign-in timed out while waiting for you to continue. Try again.
1774 1803
1775**O que fazer:**1804**O que fazer:**
1776 1805
1777* Execute `/login` novamente e confirme a conta antes da conexão expirar1806* Execute `/login` novamente e confirme a conta antes que o login expire
1778 1807
1779<h3 id="gateway-refused-the-request">1808<h3 id="gateway-refused-the-request">
1780 Gateway recusou a solicitação1809 Gateway refused the request
1781</h3>1810</h3>
1782 1811
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:1812Você fez login 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 seu gateway:
1784 1813
1785```text theme={null}1814```text theme={null}
1786Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1815Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
1788 1817
1789**O que fazer:**1818**O que fazer:**
1790 1819
1791* Peça ao seu administrador de gateway para procurar a solicitação. A cauda `API Error:` carrega a recusa que o gateway retornou1820* Peça ao administrador do seu gateway que investigue a requisição. O final `API Error:` traz 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)1821* 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 o motivo, e a negação de autorização de um upstream é repassada conforme [Mensagens de erro do upstream](/docs/pt/claude-apps-gateway-config#upstream-error-messages)
1793 1822
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.1823Antes 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 1824
1796<h2 id="network-and-connection-errors">1825<h2 id="network-and-connection-errors">
1797 Erros de rede e conexão1826 Erros de rede e conexão
2317API Error: 400 ... Extra inputs are not permitted ... context_management2346API Error: 400 ... Extra inputs are not permitted ... context_management
2318```2347```
2319 2348
2320Claude Code envia campos apenas de beta como `context_management` e `effort` junto com um cabeçalho `anthropic-beta` que os habilita. Quando um gateway encaminha o corpo mas remove o cabeçalho, a API vê campos que não reconhece.2349Claude Code envia campos apenas de beta como `context_management` junto com um cabeçalho `anthropic-beta` que os habilita. Quando um gateway encaminha o corpo mas remove o cabeçalho, a API vê campos que não reconhece.
2321 2350
2322**O que fazer:**2351**O que fazer:**
2323 2352
2852 Erros de linha de comando2881 Erros de linha de comando
2853</h2>2882</h2>
2854 2883
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.2884Estes 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 2885
2857<h3 id="conflict-between-bg-and-print">2886<h3 id="conflict-between-bg-and-print">
2858 Conflito entre `--bg` e `--print`2887 Conflito entre `--bg` e `--print`
2859</h3>2888</h3>
2860 2889
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.2890Esta 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 2891
2863```text theme={null}2892```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>'`.2893--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 2895
2867**O que fazer:**2896**O que fazer:**
2868 2897
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).2898* Remova `-p` ou `--print`. `--bg` recebe o prompt como seu argumento posicional, então `claude --bg "<task>"` é o comando completo. Consulte [Despachar 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>"`2899* 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>"`
2900
2901<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">
2902 Conflito entre uma flag de system prompt e sua forma de arquivo
2903</h3>
2904
2905Você passou [`--append-subagent-system-prompt`](/docs/pt/cli-reference#cli-flags) junto com `--append-subagent-system-prompt-file` em uma mesma invocação de `claude`, então `claude` sai com código 1 em vez de iniciar a sessão:
2906
2907```text theme={null}
2908Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
2909```
2910
2911Antes 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 [combinar](/docs/pt/cli-reference#system-prompt-flags). Nessas versões, a mensagem nomeia o par que você combinou.
2912
2913**O que fazer:**
2914
2915* 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 ambas as flags
2871 2916
2872<h3 id="invalid-agents-configuration">2917<h3 id="invalid-agents-configuration">
2873 Configuração inválida de `--agents`2918 Configuração de `--agents` inválida
2874</h3>2919</h3>
2875 2920
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.2921O 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 2922
2878```text theme={null}2923```text theme={null}
2879Error: Invalid --agents configuration:2924Error: Invalid --agents configuration:
2880<what failed>2925<what failed>
2881```2926```
2882 2927
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:2928O que segue a 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 2929
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 JSON29301. Quando o valor começa com `{` mas não é analisado como JSON, ou o conteúdo de um arquivo `--agents` não é analisado, o Claude Code imprime uma linha `invalid JSON:` com a mensagem do próprio parser 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 problema29312. 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 '-'`29323. Quando o nome de um agente começa com `-`, o Claude Code imprime `<name>: agent names must not start with '-'`
2888 2933
2889Quando há mais de 20 linhas de problema, Claude Code imprime as primeiras 20 e substitui o resto por `…and N more`.2934Quando há mais de 20 linhas de problema, o Claude Code imprime as primeiras 20 e substitui o restante por `…and N more`.
2890 2935
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:2936Com `--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 2937
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.2938* **`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.2939* **`Error: --agents file not found: <path>`**: não existe arquivo nesse caminho. Um valor que não começa com `{` e não é JSON válido é lido como caminho, então JSON inline que seu shell corrompeu também pode falhar dessa forma. Verifique o caminho ou as aspas e execute o comando novamente.
2895 2940
2896**O que fazer:**2941**O que fazer:**
2897 2942
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).2943* Corrija cada problema que a mensagem lista e execute o comando novamente. Consulte [os campos que um subagente definido pela CLI aceita](/docs/pt/sub-agents#choose-the-subagent-scope).
2899 2944
2900<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">2945<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`2946 Sessões na nuvem não podem ser criadas a partir de uma sessão `--restricted`
2902</h3>2947</h3>
2903 2948
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:2949Quando 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 2950
2906```text theme={null}2951```text theme={null}
2907Cloud sessions cannot be created from a --restricted session: they would not enforce it.2952Cloud sessions cannot be created from a --restricted session: they would not enforce it.
2910**O que fazer:**2955**O que fazer:**
2911 2956
2912* Execute a tarefa localmente na sessão restrita2957* 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í2958* 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 2959
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.2960Antes 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 2961
2917<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">2962<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">
2918 Sessões em nuvem estão desabilitadas pela política da sua organização2963 Sessões na nuvem estão desativadas pela política da sua organização
2919</h3>2964</h3>
2920 2965
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:2966A 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 2967
2923```text theme={null}2968```text theme={null}
2924Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.2969Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
2925```2970```
2926 2971
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.2972A 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 2973
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.2974Esta é 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 2975
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.2976Se 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 2977
2933**O que fazer:**2978**O que fazer:**
2934 2979
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)2980* 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 administrador 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 novamente2981* 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 2982
2938<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2983<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
2939 O valor `--json-schema` não é um JSON Schema válido2984 O valor de `--json-schema` não é um JSON Schema válido
2940</h3>2985</h3>
2941 2986
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.2987O 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 saída não estruturada sem erro, e qualquer esquema que usasse a palavra-chave `format` era tratado como inválido.
2943 2988
2944```text theme={null}2989```text theme={null}
2945Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values2990Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
2946```2991```
2947 2992
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.2993O 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 o aplica.
2949 2994
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`.2995O 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 JSON válido que não é um objeto com `Error: --json-schema must be a JSON object`.
2951 2996
2952**O que fazer:**2997**O que fazer:**
2953 2998
2954* Corrija a parte do esquema que o diagnóstico nomeia, depois execute o comando novamente2999* 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 comando3000* Consulte [Obter saída estruturada](/docs/pt/headless#get-structured-output) para ver um esquema e um comando funcionais
2956 3001
2957<h3 id="settings-file-exceeds-the-2mib-limit">3002<h3 id="settings-file-exceeds-the-2mib-limit">
2958 Arquivo de configurações excede o limite de 2MiB3003 Arquivo de configurações excede o limite de 2MiB
2959</h3>3004</h3>
2960 3005
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.3006O 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 3007
2963```text theme={null}3008```text theme={null}
2964Error: Settings file exceeds the 2MiB limit: /path/to/settings.json3009Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
2965```3010```
2966 3011
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`.3012O 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 3013
2969**O que fazer:**3014**O que fazer:**
2970 3015
2971* Aponte `--settings` para um arquivo JSON de configurações regular com menos de 2 MiB. Veja [Settings](/docs/pt/settings) para o formato.3016* Aponte `--settings` para um arquivo de configurações JSON regular com menos de 2 MiB. Consulte [Configurações](/docs/pt/settings) para ver o formato.
2972 3017
2973<h3 id="the-current-directory-no-longer-exists">3018<h3 id="the-current-directory-no-longer-exists">
2974 O diretório atual não existe mais3019 O diretório atual não existe mais
2975</h3>3020</h3>
2976 3021
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.3022Você 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 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 uma pilha `ENOENT ... uv_cwd` bruta no stderr em vez desta mensagem.
2978 3023
2979```text theme={null}3024```text theme={null}
2980The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3025The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
2983 3028
2984A causa e a correção são as mesmas para ambas as formas.3029A causa e a correção são as mesmas para ambas as formas.
2985 3030
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.`3031Quando 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 3032
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`.3033No 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 3034
2990**O que fazer:**3035**O que fazer:**
2991 3036
2992* Mude para um diretório que existe, como seu diretório inicial ou de projeto, depois execute `claude` novamente3037* 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` novamente3038* 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 terminal3039* Para `EPERM` no macOS, feche 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 3040
2996<h3 id="temp-directory-refused-or-cannot-be-created">3041<h3 id="temp-directory-refused-or-cannot-be-created">
2997 Diretório temporário recusado ou não pode ser criado3042 Diretório temporário recusado ou não pode ser criado
2998</h3>3043</h3>
2999 3044
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:3045No macOS e no Linux, o Claude Code cria um diretório temporário privado na inicialização, `claude-<uid>`, dentro do diretório temporário do sistema ou do valor que sobrescreve esse local em [`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 3046
3002```text wrap theme={null}3047```text wrap theme={null}
3003ENOSPC: no space left on device, mkdir '/tmp/claude-501'3048ENOSPC: no space left on device, mkdir '/tmp/claude-501'
3012**O que fazer:**3057**O que fazer:**
3013 3058
3014* Para `ENOSPC`, libere espaço em disco no volume que contém o diretório temporário3059* 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ê-la3060* 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 aquele usuário pode removê-la
3016* Para `is not readable`, execute `chmod 0700` no diretório nomeado, ou remova-o e inicie novamente3061* 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 sozinho3062* 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 intacto
3018 3063
3019<h3 id="directory-couldnt-be-resolved-to-a-real-location">3064<h3 id="directory-couldnt-be-resolved-to-a-real-location">
3020 Diretório não pôde ser resolvido para um local real3065 Não foi possível resolver o diretório para uma localização real
3021</h3>3066</h3>
3022 3067
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.3068Você 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 sua localização real.
3024 3069
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:3070Você já tem acesso a 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 a localização real do diretório, com quaisquer links simbólicos resolvidos, está dentro do diretório de trabalho. Quando o Claude Code não consegue resolver essa localização, ele não carrega nada e mostra esta mensagem:
3026 3071
3027```text theme={null}3072```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.3073packages/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 3075
3031**O que fazer:**3076**O que fazer:**
3032 3077
3033* Verifique se o caminho nomeia um diretório real dentro do diretório de trabalho, depois execute `/add-dir` novamente3078* 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 carregado3079* A mensagem não altera seu acesso a arquivos; ela apenas informa que o conteúdo `.claude/` do diretório não foi carregado
3035 3080
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.3081Antes 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 deliberadamente não resolve caminhos; o diretório estava correto e tentar novamente não ajudava.
3037 3082
3038<h3 id="workspace-not-trusted-when-starting-remote-control">3083<h3 id="workspace-not-trusted-when-starting-remote-control">
3039 Workspace não confiável ao iniciar Remote Control3084 Workspace não confiável ao iniciar o Remote Control
3040</h3>3085</h3>
3041 3086
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:3087Você iniciou o modo servidor do [Remote Control](/docs/pt/remote-control) com `claude remote-control` ou seu alias `claude rc` em um diretório no qual 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 encadeada por pipe. O comando sai com código 1:
3043 3088
3044```text theme={null}3089```text theme={null}
3045Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3090Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
3046```3091```
3047 3092
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.3093Duas 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 3094
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á.3095No 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 pode satisfazer esta verificação. Antes da v2.1.214, o diretório pessoal mostrava a mensagem acima, cujo conselho não pode funcionar ali.
3051 3096
3052```text theme={null}3097```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).3098Error: 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 3102
3058**O que fazer:**3103**O que fazer:**
3059 3104
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 novamente3105* Confie no diretório a partir de um terminal primeiro: 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á3106* No seu diretório pessoal, mude para um diretório de projeto e inicie o Remote Control ali
3062 3107
3063Antes da v2.1.284, o comando nunca perguntava, mesmo em um terminal.3108Antes da v2.1.284, o comando nunca perguntava, mesmo em um terminal.
3064 3109
3065<h3 id="not-carried-over-to-the-sessions-remote-control-starts">3110<h3 id="not-carried-over-to-the-sessions-remote-control-starts">
3066 Não levado para as sessões que Remote Control inicia3111 Não transferido para as sessões que o Remote Control inicia
3067</h3>3112</h3>
3068 3113
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:3114Você iniciou o [Remote Control](/docs/pt/remote-control) com uma flag global de `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 3115
3071```text theme={null}3116```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`).3117Error: `--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```3118```
3074 3119
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.3120O 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 3121
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.3122O Claude Code também se recusa a 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 nesta mensagem até que uma versão posterior a marque como inofensiva.
3078 3123
3079**O que fazer:**3124**O que fazer:**
3080 3125
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 lista3126* 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 lista
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 inicia3127* 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 3128
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.3129Antes 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 3130
3086<h3 id="claude-import-is-not-yet-available-in-this-build">3131<h3 id="claude-import-is-not-yet-available-in-this-build">
3087 claude import ainda não está disponível nesta compilação3132 claude import ainda não está disponível neste build
3088</h3>3133</h3>
3089 3134
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.3135Você 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 3136
3092```text theme={null}3137```text theme={null}
3093`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3138`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
3094```3139```
3095 3140
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:3141O 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 3142
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ê.3143* 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.3144* Você usa o Claude Code por meio do Amazon Bedrock, do Agent Platform do Google Cloud, do Microsoft Foundry ou do Claude Platform na 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.3145* 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 3146
3102**O que fazer:**3147**O que fazer:**
3103 3148
3104* Em uma instalação nova, inicie `claude`, aguarde o carregamento da sessão, saia e execute `claude import` novamente3149* 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.3150* 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 3151
3107<h3 id="could-not-read-claude-code-config">3152<h3 id="could-not-read-claude-code-config">
3108 Não foi possível ler a configuração do Claude Code3153 Não foi possível ler a configuração do Claude Code
3109</h3>3154</h3>
3110 3155
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.3156Você 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 3157
3113```text theme={null}3158```text theme={null}
3114Could not read Claude Code config — run `claude` with no arguments to recover it.3159Could not read Claude Code config — run `claude` with no arguments to recover it.
3116 3161
3117**O que fazer:**3162**O que fazer:**
3118 3163
3119* Execute `claude` sem argumentos. Claude Code detecta o arquivo inválido e oferece redefini-lo. Depois execute `claude import` novamente.3164* Execute `claude` sem argumentos. O Claude Code detecta o arquivo inválido e oferece redefini-lo. Depois, 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` novamente3165* Para manter edições manuais que você fez, corrija a sintaxe JSON em `~/.claude.json` em um editor e execute `claude import` novamente
3121 3166
3122<h3 id="could-not-import-a-server-from-claude-desktop">3167<h3 id="could-not-import-a-server-from-claude-desktop">
3123 Não foi possível importar um servidor do Claude Desktop3168 Não foi possível importar um servidor do Claude Desktop
3124</h3>3169</h3>
3125 3170
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.3171O 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 3172
3128```text theme={null}3173```text theme={null}
3129Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3174Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
3130```3175```
3131 3176
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.3177O 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 servidores, como espaços e pontos, que `claude mcp` restringe a letras, números, hifens 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 3178
3134**O que fazer:**3179**O que fazer:**
3135 3180
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` novamente3181* Renomeie o servidor em `claude_desktop_config.json` para usar apenas letras, números, hifens 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).3182* Adicione esse servidor diretamente com `claude mcp add` ou `claude mcp add-json` com um nome válido. Consulte [Importar servidores MCP do Claude Desktop](/docs/pt/mcp#import-mcp-servers-from-claude-desktop).
3138 3183
3139<h3 id="cannot-add-mcp-server-to-the-managed-scope">3184<h3 id="cannot-add-mcp-server-to-the-managed-scope">
3140 Não é possível adicionar servidor MCP ao escopo gerenciado3185 Não é possível adicionar um servidor MCP ao escopo gerenciado
3141</h3>3186</h3>
3142 3187
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.3188Você 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ê apenas das configurações gerenciadas, então o comando não pode gravar um servidor nesse escopo.
3144 3189
3145```text theme={null}3190```text theme={null}
3146Cannot add MCP server to scope: managed3191Cannot add MCP server to scope: managed
3148 3193
3149**O que fazer:**3194**O que fazer:**
3150 3195
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)3196* 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ê implanta3197* 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
3198
3199<h3 id="cannot-add-mcp-server-when-managed-settings-allow-only-plugin-servers">
3200 Não é possível adicionar um servidor MCP quando as configurações gerenciadas permitem apenas servidores de plugins
3201</h3>
3202
3203Você executou `claude mcp add` ou `claude mcp add-json` enquanto as configurações gerenciadas da sua organização definem [`strictPluginOnlyCustomization`](/docs/pt/settings-reference#strictpluginonlycustomization) como `true` ou como uma lista que inclui `mcp`. Com essa configuração, o Claude Code não carrega servidores MCP de `~/.claude.json` ou `.mcp.json`, então o comando sai com código 1 em vez de salvar um servidor que nunca seria carregado:
3204
3205```text theme={null}
3206Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.
3207```
3208
3209`claude mcp add-from-claude-desktop` informa cada servidor que você seleciona como não importado, com esta mensagem como motivo. [`/import`](/docs/pt/commands#all-commands) informa esta mensagem para cada servidor MCP que tenta adicionar e ainda importa os outros itens que encontrou.
3210
3211Antes da v2.1.284, esses comandos salvavam o servidor e informavam sucesso, e o servidor nunca era carregado.
3212
3213**O que fazer:**
3214
3215* Instale um [plugin](/docs/pt/plugins/install) que forneça o servidor
3216* Peça ao seu administrador para distribuir o servidor em um [plugin](/docs/pt/plugins/org), ou para fornecê-lo por meio de [`managedMcpServers`](/docs/pt/settings-reference#managedmcpservers) se for um servidor HTTP ou SSE remoto
3153 3217
3154<h3 id="cant-read-mcp-json">3218<h3 id="cant-read-mcp-json">
3155 Não é possível ler .mcp.json3219 Não é possível ler .mcp.json
3156</h3>3220</h3>
3157 3221
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.3222Um 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 3223
3160```text theme={null}3224```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.3225Can'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```3226```
3163 3227
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.3228Antes da v2.1.257, um FIFO em `.mcp.json` deixava o comando esperando para sempre sem 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 3229
3166**O que fazer:**3230**O que fazer:**
3167 3231
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.3232* 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 3233
3170<h3 id="mcp-server-was-not-saved-or-removed">3234<h3 id="mcp-server-was-not-saved-or-removed">
3171 Servidor MCP não foi salvo ou removido3235 O servidor MCP não foi salvo ou removido
3172</h3>3236</h3>
3173 3237
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.3238Você 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 da sua linha de sucesso.
3175 3239
3176```text theme={null}3240```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.3241MCP 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```3242```
3179 3243
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)`.3244Apó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 3245
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.3246Antes da v2.1.283, `claude mcp add`, `claude mcp add-json` e `claude mcp remove` informavam sucesso mesmo quando a alteração não chegava ao arquivo.
3183 3247
3184**O que fazer:**3248**O que fazer:**
3185 3249
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.3250* 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 3251
3188<h3 id="mcp-server-may-not-have-been-saved-or-removed">3252<h3 id="mcp-server-may-not-have-been-saved-or-removed">
3189 Servidor MCP pode não ter sido salvo ou removido3253 O servidor MCP pode não ter sido salvo ou removido
3190</h3>3254</h3>
3191 3255
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.3256Você 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 3257
3194```text theme={null}3258```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.3259MCP 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```3260```
3197 3261
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`.3262Apó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 3263
3200Antes da v2.1.283, os comandos relatavam sucesso mesmo quando a mudança não conseguia ser confirmada.3264Antes da v2.1.283, os comandos informavam sucesso mesmo quando a alteração não podia ser confirmada.
3201 3265
3202**O que fazer:**3266**O que fazer:**
3203 3267
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.3268* 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.3269* 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 3270
3207<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">3271<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">
3208 Servidor é hospedado pela Anthropic e não suporta OAuth local3272 O servidor é hospedado pela Anthropic e não suporta OAuth local
3209</h3>3273</h3>
3210 3274
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).3275Você 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 no painel `/mcp` quanto em `claude mcp login`, porque [o login deles funciona apenas por meio do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai).
3212 3276
3213```text theme={null}3277```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.3278"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```3279```
3216 3280
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:**3281**O que fazer:**
3220 3282
3221* Remova sua entrada com `claude mcp remove <name>`, para que não possa ocultar o conector claude.ai na mesma URL3283* 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.ai3284* 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. Uma vez conectado, [o conector aparece no 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 do claude.ai
3223 3285
3224<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">3286<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">
3225 Servidor rejeitou o cabeçalho Authorization cunhado pelo headersHelper configurado3287 O servidor rejeitou o cabeçalho Authorization gerado pelo headersHelper configurado
3226</h3>3288</h3>
3227 3289
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:3290Um 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 informa 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 3291
3230```text theme={null}3292```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.3293Server 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```3294```
3233 3295
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.3296O 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 tokens, pode ter sucesso com uma credencial nova.
3235 3297
3236**O que fazer:**3298**O que fazer:**
3237 3299
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 aceita3300* Execute o comando `headersHelper` você mesmo 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 credenciais 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**3301* Depois de corrigir o helper ou a origem da credencial, selecione o servidor em `/mcp` e escolha **Reconnect**
3240 3302
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.3303Antes da v2.1.248, o Claude Code executava a descoberta 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 informar a credencial rejeitada.
3242 3304
3243<h3 id="mcp-permission-prompt-tool-not-found">3305<h3 id="mcp-permission-prompt-tool-not-found">
3244 Ferramenta de prompt de permissão MCP não encontrada3306 Ferramenta de prompt de permissão MCP não encontrada
3245</h3>3307</h3>
3246 3308
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.3309A 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 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 esperava o servidor terminar de se conectar, então um servidor saudável, mas lento para iniciar, também produzia este erro.
3248 3310
3249```text theme={null}3311```text theme={null}
3250Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3312Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
3251```3313```
3252 3314
3253A lista após `Available MCP tools:` nomeia as ferramentas MCP que estavam conectadas quando a espera terminou.3315A lista após `Available MCP tools:` nomeia as ferramentas MCP que estavam conectadas.
3254 3316
3255**O que fazer:**3317**O que fazer:**
3256 3318
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 conectado3319* Verifique se o servidor inicia e permanece conectado: execute `claude mcp list` no mesmo diretório e confirme que o servidor aparece como conectado
3258* Confirme se o nome da ferramenta corresponde ao nome `mcp__<server>__<tool>` que o servidor expõe3320* 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)3321* Se o servidor precisar de mais de 30 segundos para iniciar, aumente [`MCP_TIMEOUT`](/docs/pt/env-vars)
3260 3322
3261<h3 id="oauth-callback-port-is-already-in-use">3323<h3 id="oauth-callback-port-is-already-in-use">
3262 Porta de callback OAuth já está em uso3324 A porta de callback OAuth já está em uso
3263</h3>3325</h3>
3264 3326
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.3327Quando 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 uma delas o Claude Code escolhe uma porta disponível.
3266 3328
3267```text theme={null}3329```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.3330OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
3269```3331```
3270 3332
3271No Windows, o comando sugerido é `netstat -ano | findstr :<port>` em vez disso.3333No Windows, o comando sugerido é `netstat -ano | findstr :<port>`.
3272 3334
3273**O que fazer:**3335**O que fazer:**
3274 3336
3275* Execute o comando da mensagem para encontrar o processo que mantém a porta e pare-o ou aguarde que termine3337* Execute o comando da mensagem para encontrar o processo que está ocupando a porta, e encerre-o ou aguarde sua conclusão
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ê usar3338* Se outro programa precisar dessa porta permanentemente, registre uma URI de redirecionamento diferente no servidor e defina a porta dela com `MCP_OAUTH_CALLBACK_PORT` ou `--callback-port`, o que você usar
3277* Depois inicie o sign-in novamente, por exemplo selecionando o servidor em `/mcp`3339* Em seguida, inicie o login novamente, por exemplo selecionando o servidor em `/mcp`
3278 3340
3279<h3 id="no-available-ports-for-oauth-redirect">3341<h3 id="no-available-ports-for-oauth-redirect">
3280 Nenhuma porta disponível para redirecionamento OAuth3342 Nenhuma porta disponível para o redirecionamento OAuth
3281</h3>3343</h3>
3282 3344
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.3345Quando 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 que ele escute em `127.0.0.1`, por exemplo um software de segurança ou uma política de sandbox que nega listeners locais.
3284 3346
3285```text theme={null}3347```text theme={null}
3286No available ports for OAuth redirect3348No available ports for OAuth redirect
3287```3349```
3288 3350
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.3351Antes 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 cobrem as portas entre as quais o Claude Code escolhe.
3290 3352
3291**O que fazer:**3353**O que fazer:**
3292 3354
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 local3355* 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`3356* Em seguida, inicie o login novamente, por exemplo selecionando o servidor em `/mcp`
3295 3357
3296<h3 id="security-review-fails-without-origin-head">3358<h3 id="security-review-fails-without-origin-head">
3297 /security-review falha sem origin/HEAD3359 /security-review falha sem origin/HEAD
3298</h3>3360</h3>
3299 3361
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.3362[`/security-review`](/docs/pt/commands#all-commands) constrói seu contexto de revisão calculando 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 3363
3302```text theme={null}3364```text theme={null}
3303Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3365Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
3306'git <command> [<revision>...] -- [<file>...]'3368'git <command> [<revision>...] -- [<file>...]'
3307```3369```
3308 3370
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:3371A mensagem pode citar `git log` ou um `git diff` diferente. O Git cria `origin/HEAD` apenas quando o remoto anuncia um branch padrão e seu refspec de fetch o cobre, o que acontece com um `git clone` completo de um remoto com commits. A ref está ausente nestas configurações:
3310 3372
3311* Um checkout de branch único ou CI, que busca um refspec muito estreito3373* Um checkout de branch único ou de CI, que busca um refspec restrito demais
3312* Um remote cujo HEAD do lado do servidor aponta para um branch que ninguém fez push3374* 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 buscou3375* Um repositório sem remoto `origin`, ou um do qual você nunca fez fetch
3314 3376
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:3377O 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 strings irmãs são disparadas antes mesmo de o comando ser executado:
3316 3378
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`3379* `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)3380* ``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 3381
3320**O que fazer:**3382**O que fazer:**
3321 3383
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.3384* 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>` existir. 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`, e então 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.3385* 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, por estar vazio ou porque seu HEAD aponta para um branch que ninguém enviou; nomeie o branch explicitamente nesse caso. Ele falha com `error: Not a valid ref` quando seu clone não busca esse branch; amplie o refspec como acima primeiro.
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.3386* 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 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 enviar, então `/security-review` vê um diff vazio até que o branch divirja dele.
3325 3387
3326<h3 id="input-must-be-provided-when-using-print">3388<h3 id="input-must-be-provided-when-using-print">
3327 Entrada deve ser fornecida ao usar `--print`3389 É necessário fornecer uma entrada ao usar `--print`
3328</h3>3390</h3>
3329 3391
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.3392O `claude` sem argumentos precisa que o stdout seja um terminal para iniciar a UI 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 de `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 encadeado no stdin produz o mesmo erro em qualquer lugar.
3331 3393
3332```text theme={null}3394```text theme={null}
3333Error: Input must be provided either through stdin or as a prompt argument when using --print3395Error: Input must be provided either through stdin or as a prompt argument when using --print
3335 3397
3336**O que fazer:**3398**O que fazer:**
3337 3399
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ída3400* 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`3401* Para uso pontual, passe o prompt: `claude -p "your question"`, ou encadeie-o com `echo "your question" | claude -p`
3340 3402
3341<h3 id="input-contained-only-whitespace">3403<h3 id="input-contained-only-whitespace">
3342 Entrada continha apenas espaço em branco3404 A entrada continha apenas espaços em branco
3343</h3>3405</h3>
3344 3406
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:3407No [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 3408
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`3409* **Argumento de prompt ou stdin encadeado 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.`3410* **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 3411
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.3412Antes da v2.1.229, o Claude Code enviava a mensagem composta apenas de espaços em branco para a API, que rejeitava a requisição com um erro 400.
3351 3413
3352**O que fazer:**3414**O que fazer:**
3353 3415
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.3416* Inclua texto visível no prompt. Se um script constrói 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 3417
3356<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">3418<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">
3357 entrada stream-json levou mais de 256M caracteres sem quebra de linha3419 A entrada stream-json trouxe mais de 256M caracteres sem quebra de linha
3358</h3>3420</h3>
3359 3421
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.3422Seu 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 3423
3362```text theme={null}3424```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.3425Error: 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```3426```
3365 3427
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.3428Uma entrada tão longa sem quebra de linha geralmente significa que o produtor nem sequer é um produtor stream-json, como um arquivo binário ou uma saída de log em texto simples encadeada por engano. Uma única mensagem acima do limite falha na mesma verificação.
3367 3429
3368**O que fazer:**3430**O que fazer:**
3369 3431
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 linha3432* Verifique o que está sendo encadeado 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ão3433* Para enviar texto simples, remova `--input-format stream-json`; `claude -p` lê um prompt em texto simples do stdin por padrão
3372 3434
3373<h3 id="unknown-command">3435<h3 id="unknown-command">
3374 Comando desconhecido3436 Comando desconhecido
3375</h3>3437</h3>
3376 3438
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:3439Em uma sessão de terminal interativa, você enviou um nome `/` que não corresponde a nenhum comando nesta sessão, então o Claude Code informa o nome em vez de executar algo:
3378 3440
3379```text theme={null}3441```text theme={null}
3380Unknown command: /hepl. Did you mean /help?3442Unknown command: /hepl. Did you mean /help?
3381```3443```
3382 3444
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:3445O 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 3446
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 enviar3447* 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)3448* 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 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) mostram 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ão3449* 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 3450
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:3451O Claude Code responde a um nome `/` sem correspondência dessa forma apenas 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 de comandos que o Claude pode executar na sessão. Essas sessões incluem:
3390 3452
3391* execuções `-p`3453* Execuções com `-p`
3392* aplicações [Agent SDK](/docs/pt/agent-sdk/overview)3454* Aplicativos do [Agent SDK](/docs/pt/agent-sdk/overview)
3393* A aba Code do [aplicativo Desktop](/docs/pt/desktop)3455* A aba Code do [aplicativo Desktop](/docs/pt/desktop)
3394* O painel de chat da [extensão VS Code](/docs/pt/vs-code)3456* 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)3457* [Sessões na nuvem](/docs/pt/claude-code-on-the-web) e [rotinas](/docs/pt/routines)
3396 3458
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`.3459Para 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, apenas 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 3460
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`.3461O 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 3462
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.3463Antes 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 3464
3403**O que fazer:**3465**O que fazer:**
3404 3466
3405* Execute o nome sugerido, ou digite `/` seguido de parte do nome para ver o que está disponível nessa sessão3467* 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 nomeia3468* Se o Claude Code informar um comando documentado como desconhecido, verifique a linha dele na [referência de comandos](/docs/pt/commands) para ver o requisito que ela nomeia
3407 3469
3408<h3 id="diff-is-too-large-for-ultrareview">3470<h3 id="diff-is-too-large-for-ultrareview">
3409 Diff é muito grande para ultrareview3471 O diff é grande demais para o ultrareview
3410</h3>3472</h3>
3411 3473
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.3474O diff entre seu branch e o branch base, incluindo alterações não commitadas e preparadas (staged), 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 contribuem com mais linhas alteradas. Antes da v2.1.216, a mensagem mostrava apenas as estatísticas brutas do diff.
3413 3475
3414```text theme={null}3476```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.3477Diff 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```3478```
3417 3479
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.3480Revisar 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 3481
3420**O que fazer:**3482**O que fazer:**
3421 3483
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 branch3484* Passe um branch base mais próximo do seu trabalho, como `/code-review ultra develop`, para que a revisão cubra 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.3485* 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 um branch próprio.
3424 3486
3425<h3 id="could-not-find-merge-base-with-the-base-branch">3487<h3 id="could-not-find-merge-base-with-the-base-branch">
3426 Não foi possível encontrar merge-base com o branch base3488 Não foi possível encontrar o merge-base com o branch base
3427</h3>3489</h3>
3428 3490
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.3491`/code-review ultra` e o subcomando `claude ultrareview` revisam o diff entre seu branch e um branch base, o que requer 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 consegue 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 de forma alguma, quando o Claude Code não consegue verificar se seu clone está completo, ou no raro repositório onde o diff da árvore inteira não é possível, como com o formato de objeto SHA-256.
3430 3492
3431```text theme={null}3493```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.3494Could 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```3495```
3434 3496
3435A dica após a primeira sentença depende do que Claude Code observou:3497A dica após a primeira frase depende do que o Claude Code observou:
3436 3498
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 acima3499* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar sua 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>`)``3500* **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`.3501* **Você passou um branch base que não estava no seu clone**: o Claude Code o buscou 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` em vez disso. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para todo branch base buscado, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.
3440 3502
3441**O que fazer:**3503**O que fazer:**
3442 3504
3443* Se outro branch é seu base real, passe-o explicitamente: `/code-review ultra <branch>`3505* 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 novamente3506* Se seu clone puder não ter o histórico completo, execute `git fetch --unshallow origin` e execute a revisão novamente
3445 3507
3446<h3 id="your-checkout-has-no-branches">3508<h3 id="your-checkout-has-no-branches">
3447 Seu checkout não tem branches3509 Seu checkout não tem branches
3448</h3>3510</h3>
3449 3511
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.3512Um checkout pode ter commits, mas nenhum branch: se você executar `git init` seguido de `git fetch <url>` e `git checkout FETCH_HEAD`, obterá um HEAD desanexado sem refs. O Claude Code empacota seu repositório como um bundle git 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 3513
3452```text theme={null}3514```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.3515Your 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```3516```
3455 3517
3456Antes da v2.1.221, Claude Code tentava revisar cada arquivo rastreado nesse checkout, e o carregamento falhava.3518Antes da v2.1.221, o Claude Code tentava revisar todos os arquivos rastreados neste checkout, e o envio falhava.
3457 3519
3458**O que fazer:**3520**O que fazer:**
3459 3521
3460* Crie um branch em seu commit atual com `git checkout -b <name>`, depois execute a revisão novamente3522* Crie um branch no seu commit atual com `git checkout -b <name>` e execute a revisão novamente
3461 3523
3462<h3 id="no-github-account-is-connected-to-your-claude-account">3524<h3 id="no-github-account-is-connected-to-your-claude-account">
3463 Nenhuma conta GitHub está conectada à sua conta Claude3525 Nenhuma conta do GitHub está conectada à sua conta Claude
3464</h3>3526</h3>
3465 3527
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.3528Você 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 3529
3468```text theme={null}3530```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).3531Ultrareview 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```3532```
3471 3533
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.3534Quando [`/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 3535
3474**O que fazer:**3536**O que fazer:**
3475 3537
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)3538* Execute `/web-setup` para conectar seu login da CLI do GitHub à 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 conectar3539* Execute a revisão novamente um minuto após conectar
3478 3540
3479Antes da v2.1.248, Claude Code não verificava isso antes do lançamento.3541Antes da v2.1.248, o Claude Code não verificava isso antes da inicialização.
3480 3542
3481<h3 id="your-connected-github-account-cant-see-the-repository">3543<h3 id="your-connected-github-account-cant-see-the-repository">
3482 Sua conta GitHub conectada não consegue ver o repositório3544 Sua conta do GitHub conectada não consegue ver o repositório
3483</h3>3545</h3>
3484 3546
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.3547Você 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 3548
3487```text theme={null}3549```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.3550Your 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```3551```
3490 3552
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.3553Quando [`/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 3554
3493**O que fazer:**3555**O que fazer:**
3494 3556
3495* Se seu CLI `gh` local consegue ler o repositório, execute `/web-setup` para conectar esse login à sua conta Claude3557* 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ça3558* Execute a revisão novamente após a alteração
3497 3559
3498Antes da v2.1.248, Claude Code não verificava isso antes do lançamento.3560Antes da v2.1.248, o Claude Code não verificava isso antes da inicialização.
3499 3561
3500<h3 id="the-github-app-preflight-failed-transiently">3562<h3 id="the-github-app-preflight-failed-transiently">
3501 A verificação prévia do GitHub App falhou transitoriamente3563 A verificação prévia do GitHub App falhou de forma transitória
3502</h3>3564</h3>
3503 3565
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:3566Você 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 envio, ele verificou se o serviço na nuvem consegue clonar o repositório 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 3567
3506```text theme={null}3568```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 instead3569Could 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 3571
3510**O que fazer:**3572**O que fazer:**
3511 3573
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çamento3574* Execute o comando novamente após um momento. Quando a verificação do GitHub for aprovada, o Claude Code pode iniciar a sessão a partir de um clone do GitHub, então o envio com falha 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 disso3575* Se as novas tentativas continuarem falhando, o início da mensagem nomeia o que impediu o envio. 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 3576
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.3577Antes 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 de forma transitória, e um conselho de configuração não resolve uma falha transitória.
3516 3578
3517<h3 id="the-repository-upload-cant-follow-a-git-setting">3579<h3 id="the-repository-upload-cant-follow-a-git-setting">
3518 O upload do repositório não consegue seguir uma configuração git3580 O envio do repositório não consegue seguir uma configuração do git
3519</h3>3581</h3>
3520 3582
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:3583Você iniciou uma [sessão na nuvem que envia 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 envio não consegue seguir uma das configurações do git que decidem quais regras de atributos se aplicam aos seus arquivos. Se o envio prosseguisse e deixasse de aplicar 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 envio, e nada é enviado:
3522 3584
3523```text theme={null}3585```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.3586Not 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```3587```
3526 3588
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.3589A 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 3590
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.3591A 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 3592
3531**O que fazer:**3593**O que fazer:**
3532 3594
3533* Aplique a correção na sentença final da mensagem3595* Aplique a correção indicada na frase final da mensagem
3534 3596
3535<h3 id="github-isnt-connected-to-your-claude-account">3597<h3 id="github-isnt-connected-to-your-claude-account">
3536 GitHub não está conectado à sua conta Claude3598 O GitHub não está conectado à sua conta Claude
3537</h3>3599</h3>
3538 3600
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:3601Você 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 3602
3541```text theme={null}3603```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-github3604GitHub 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
3546 3608
3547**O que fazer:**3609**O que fazer:**
3548 3610
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.3611* Execute `/web-setup` para conectar seu login da CLI do GitHub à 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 saber como as duas diferem.
3550* Execute o comando novamente um minuto após conectar3612* Execute o comando novamente um minuto após conectar
3551 3613
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.3614Antes da v2.1.268, o Claude Code informava isso como uma falha temporária da verificação do Claude GitHub App e sugeria tentar novamente ou instalar o aplicativo; nenhuma das duas opções conecta uma conta do GitHub.
3553 3615
3554<h3 id="single-sign-on-authorization-needed">3616<h3 id="single-sign-on-authorization-needed">
3555 Autorização de single sign-on necessária3617 Autorização de single sign-on necessária
3556</h3>3618</h3>
3557 3619
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:3620Você executou [`/install-github-app`](/docs/pt/github-actions#quick-setup) e escolheu um repositório cuja organização exige SAML single sign-on. Antes da configuração, o Claude Code verifica seu acesso ao repositório com a CLI do GitHub, 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 3621
3560```text theme={null}3622```text theme={null}
3561Single sign-on authorization needed3623Single sign-on authorization needed
3564 3626
3565**O que fazer:**3627**O que fazer:**
3566 3628
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-on3629* Autorize novamente seu login da CLI do GitHub 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ção3630* 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` novamente3631* Execute `/install-github-app` novamente
3570 3632
3571Antes da v2.1.273, Claude Code mostrava o aviso `Admin permissions required` para essa condição em vez disso.3633Antes da v2.1.273, o Claude Code mostrava o aviso `Admin permissions required` para essa condição.
3572 3634
3573<h3 id="failed-to-resume-the-conversation">3635<h3 id="failed-to-resume-the-conversation">
3574 Falha ao retomar a conversa3636 Falha ao retomar a conversa
3575</h3>3637</h3>
3576 3638
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:3639O 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 3640
3579```text theme={null}3641```text theme={null}
3580Failed to resume the conversation.3642Failed to resume the conversation.
3581Run claude --resume <session-id> to retry, or claude to start a new session.3643Run claude --resume <session-id> to retry, or claude to start a new session.
3582```3644```
3583 3645
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.3646O Claude Code sai com código 1 após mostrar a mensagem. O seletor `/resume` dentro de uma sessão em execução informa `Failed to resume conversation` na conversa, e sua sessão atual continua em execução. Antes da v2.1.216, uma retomada com falha pelo seletor `claude --resume` ficava indefinidamente no indicador `Resuming conversation…` em vez de mostrar esta mensagem.
3585 3647
3586**O que fazer:**3648**O que fazer:**
3587 3649
3588* Execute `claude --resume <session-id>` com o ID da sessão da mensagem para tentar novamente3650* Execute `claude --resume <session-id>` com o ID de 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.3651* Em uma versão anterior à v2.1.285, se a nova tentativa falhar da mesma forma, execute `claude update` e retome novamente. Essas versões falham ao retomar 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ão3652* Se a nova tentativa falhar novamente, execute `claude` para iniciar uma nova sessão
3591 3653
3592<h3 id="no-conversation-found-with-the-session-id">3654<h3 id="no-conversation-found-with-the-session-id">
3593 Nenhuma conversa encontrada com o ID da sessão3655 No conversation found with the session ID
3594</h3>3656</h3>
3595 3657
3596Você passou um ID de sessão para `claude --resume <session-id>` e nenhuma transcrição salva correspondeu:3658Você passou um ID de sessão para `claude --resume <session-id>` e nenhuma transcrição salva correspondeu a ele:
3597 3659
3598```text theme={null}3660```text theme={null}
3599No conversation found with session ID: <session-id>3661No conversation found with session ID: <session-id>
3600```3662```
3601 3663
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.3664O Claude Code sai com código 1 após mostrar a mensagem. O Claude Code [pesquisa primeiro o projeto atual e depois todos os outros projetos nesta máquina](/docs/pt/sessions#resume-a-session) em busca do ID. Antes da v2.1.223, a busca parava no diretório do projeto atual e em seus worktrees do git, então retome a partir do diretório em que a sessão trabalhou por último.
3603 3665
3604Causas comuns:3666Causas comuns:
3605 3667
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)3668* **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)3669* **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 de 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 executada3670* **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 arbitrariamente3671* **Cópias duplicadas**: se você copiou um diretório de projeto em `~/.claude/projects` de modo que duas transcrições tenham o mesmo ID, o Claude Code informa esta mensagem em vez de retomar uma das cópias arbitrariamente
3610 3672
3611**O que fazer:**3673**O que fazer:**
3612 3674
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ão3675* 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 nesta máquina e, em seguida, 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 imprimiu3676* 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 3677
3616<h3 id="windows-reported-an-error-ebadf">3678<h3 id="windows-reported-an-error-ebadf">
3617 Windows relatou um erro (EBADF) quando Claude Code leu o arquivo de transcrição desta sessão3679 Windows reported an error (EBADF) when Claude Code read this session's transcript file
3618</h3>3680</h3>
3619 3681
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:3682Você retomou uma sessão no Windows, o [arquivo de transcrição](/docs/pt/sessions#where-transcripts-are-stored) salvo abriu normalmente e a leitura dele falhou em seguida 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 3683
3622```text theme={null}3684```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.3685Windows 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```3686```
3625 3687
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.3688A 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) sai com código 1 após mostrá-la. Após `/resume` dentro de uma sessão, sua sessão atual continua em execução.
3627 3689
3628**O que fazer:**3690**O que fazer:**
3629 3691
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) nomeia3692* Exclua a pasta que contém suas transcrições de sessão 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 que [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars) indicar
3631* Se você não conseguir adicionar uma exclusão, adicione Claude Code às aplicações permitidas desse software em vez disso3693* Se você não puder adicionar uma exclusão, adicione o Claude Code aos aplicativos permitidos desse software
3632* Retome a sessão novamente3694* Retome a sessão novamente
3633 3695
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`.3696Antes da v2.1.282, a falha ocorria sem explicação: `claude --resume <session-id>` terminava em `Failed to resume session <session-id>`, e uma execução com `-p` imprimia apenas o texto do erro de sistema, como `Failed to resume session: EBADF: bad file descriptor, read`.
3635 3697
3636<h3 id="cannot-switch-renderers-in-this-session">3698<h3 id="cannot-switch-renderers-in-this-session">
3637 Não é possível alternar renderizadores nesta sessão3699 Cannot switch renderers in this session
3638</h3>3700</h3>
3639 3701
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:3702Quando 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 3703
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` novamente3704* `Cannot switch renderers while work is running in the background`: você tem 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 elas3705* `Cannot switch renderers in this session`: a sessão tem restrições que o Claude Code não consegue passar para o processo reiniciado. Antes da v2.1.234, o Claude Code reiniciava mesmo assim e a sessão relançada era executada sem elas
3644 3706
3645Na mensagem de restrições, a parte entre parênteses nomeia as restrições que Claude Code encontrou:3707Na mensagem de restrições, a parte entre parênteses indica as restrições que o Claude Code encontrou:
3646 3708
3647```text theme={null}3709```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.3710Cannot 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 3712
3651Cada motivo que a mensagem pode mostrar entre parênteses:3713Cada motivo que a mensagem pode mostrar entre parênteses:
3652 3714
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)3715* `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 disso3716* `permission rules set for this session only`: uma [atualização de permissão](/docs/pt/hooks#permission-update-entries) de um hook ou 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 solicita confirmação novamente
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 pergunta3717* `ask-before-running rules with no command-line form`: uma atualização de permissão de um hook ou 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 valor3718* `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 transportar seu texto como o mesmo valor
3657 3719
3658**O que fazer:**3720**O que fazer:**
3659 3721
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á3722* 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 3723
3662<h3 id="couldnt-open-claude-desktop">3724<h3 id="couldnt-open-claude-desktop">
3663 Não foi possível abrir Claude Desktop3725 Couldn't open Claude Desktop
3664</h3>3726</h3>
3665 3727
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.3728Você 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 do sistema que o Claude Code usa para abrir o Claude Desktop falhou. Após `/desktop`, a sessão permanece no terminal; `claude --desktop` imprime a mensagem sem o prefixo `Error:` e sai com status 1.
3667 3729
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`:3730O 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 3731
3670```text theme={null}3732```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.3733Error: 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 3735
3674**O que fazer:**3736**O que fazer:**
3675 3737
3676* Abra Claude Desktop você mesmo, depois execute `/desktop` ou `claude --desktop` novamente3738* 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 debug3739* 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, em seguida, verifique o log de depuração
3678 3740
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.3741Antes 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 3742
3681<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3743<h3 id="terminal-setup-left-your-zed-keymap-unchanged">
3682 /terminal-setup deixou seu mapa de teclas Zed inalterado3744 /terminal-setup left your Zed keymap unchanged
3683</h3>3745</h3>
3684 3746
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.3747Você 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 3748
3687Cada mensagem nomeia o caminho para seu mapa de teclas e termina com o bloco de atalho de teclado para adicionar você mesmo:3749Cada mensagem indica o caminho para o seu keymap e termina com o bloco de atalho de teclado para você adicionar manualmente:
3688 3750
3689```text theme={null}3751```text theme={null}
3690Couldn't update your Zed keymap, so it was left unchanged.3752Couldn't update your Zed keymap, so it was left unchanged.
3692{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }3754{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
3693```3755```
3694 3756
3695A primeira linha da mensagem nomeia a causa:3757A primeira linha da mensagem indica a causa:
3696 3758
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 arquivo3759* `Couldn't read your Zed keymap, so it was left unchanged.`: o Claude Code não conseguiu ler o arquivo, por exemplo devido a 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 permitidas3760* `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 nada3761* `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 isso3762* `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 3763
3702**O que fazer:**3764**O que fazer:**
3703 3765
3704* Copie o bloco da mensagem para o array de nível superior em seu `keymap.json` no caminho que a mensagem nomeia3766* Copie o bloco da mensagem para o array de nível superior no 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` novamente3767* 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, em seguida, execute `/terminal-setup` novamente
3706 3768
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).3769Antes 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, informando o atalho como 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 3770
3709<h3 id="skill-usage-reports-are-not-available-on-this-connection">3771<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ão3772 Skill usage reports are not available on this connection
3711</h3>3773</h3>
3712 3774
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:3775Você executou [`/skill-doctor`](/docs/pt/skills#find-unused-skills) via [Remote Control](/docs/pt/remote-control), a partir do seu telefone ou navegador. O Claude Code não envia o relatório de uso de skills via Remote Control e responde com esta mensagem:
3714 3776
3715```text theme={null}3777```text theme={null}
3716Skill usage reports are not available on this connection.3778Skill usage reports are not available on this connection.
3718 3780
3719**O que fazer:**3781**O que fazer:**
3720 3782
3721* Execute `/skill-doctor` no terminal na máquina onde a sessão está em execução, ou execute `claude -p "/skill-doctor"` lá3783* Execute `/skill-doctor` no terminal da máquina em que a sessão está sendo executada, ou execute `claude -p "/skill-doctor"` ali
3722 3784
3723<h3 id="custom-output-styles-cant-be-selected-over-remote-control">3785<h3 id="custom-output-styles-cant-be-selected-over-remote-control">
3724 Estilos de saída personalizados não podem ser selecionados sobre Remote Control3786 Custom output styles can't be selected over Remote Control
3725</h3>3787</h3>
3726 3788
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:3789Você executou [`/output-style`](/docs/pt/output-styles#change-your-output-style) a partir do aplicativo móvel ou da 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. Um nome de [estilo personalizado](/docs/pt/output-styles#create-a-custom-output-style) recebe a mesma resposta que um nome que não existe:
3728 3790
3729```text theme={null}3791```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.3792Custom 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:**3795**O que fazer:**
3734 3796
3735* Escolha um estilo integrado, por exemplo `/output-style concise`3797* 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 um3798* 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 3799
3738<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">3800<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 carrega3801 Output styles are saved to local settings which this session doesn't load
3740</h3>3802</h3>
3741 3803
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:3804Você 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) omite `"local"` e uma sessão da CLI iniciada com um valor de [`--setting-sources`](/docs/pt/cli-reference#cli-flags) que omite `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 se recusa em vez de gravar uma configuração que não teria efeito:
3743 3805
3744```text theme={null}3806```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.3807Output 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 3809
3748**O que fazer:**3810**O que fazer:**
3749 3811
3750* Adicione `local` às fontes de configuração da sessão e alterne novamente3812* 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)3813* Defina a chave [`outputStyle`](/docs/pt/settings-reference#outputstyle) em um arquivo de configurações que a sessão carregue, 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 3814
3753<h2 id="plugin-errors">3815<h2 id="plugin-errors">
3754 Erros de plugin3816 Erros de plugin
4514**O que fazer:**4576**O que fazer:**
4515 4577
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.4578* 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 link4579* 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 4580
4519<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">4581<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 rede4582 Write ou command bloqueado porque o caminho nomeia um local de rede
4583```4645```
4584 4646
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`.4647* **`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.4648* **`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 4649
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.4650Claude 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 4651
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:4681Você 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 4682
4621```text theme={null}4683```text theme={null}
4622kept 7c5dcf5d — its worktree is still at "/home/you/project/.claude/worktrees/fix-login"4684kept 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.4685 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@0123456789abcdef0123456789abcdef4686 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
4625```4687```
4626 4688
4631**O que fazer:**4693**O que fazer:**
4632 4694
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 novamente4695* 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 atualizado4696* 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 novamente4697* 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 4698
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.4699Antes 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>.4785This 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```4786```
4725 4787
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.4788O 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 4789
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.4790Claude 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 4791
4773 4835
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.4836* 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 novamente4837* 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ção4838* 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.4839* 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 4840
4779<h3 id="eacces-when-starting-a-background-session">4841<h3 id="eacces-when-starting-a-background-session">
4829 Diretório de trabalho não existe mais ao iniciar uma sessão em background4891 Diretório de trabalho não existe mais ao iniciar uma sessão em background
4830</h3>4892</h3>
4831 4893
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:4894O 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 4895
4834```text theme={null}4896```text theme={null}
4835Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4897Couldn'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.4922* **`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.4923* **`<path> could not be resolved on disk`**: Claude Code não conseguiu encontrar o diretório da sessão no disco.
4862 4924
4925Antes 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.
4926
4863**O que fazer:**4927**O que fazer:**
4864 4928
4865* Execute `claude` no diretório que a mensagem nomeia e aceite o diálogo de confiança, depois execute o comando novamente4929* Execute `claude` no diretório que a mensagem nomeia e aceite o diálogo de confiança, depois execute o comando novamente
