122| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentication](#couldnt-read-the-stored-credentials-for-mcp-server) |122| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentication](#couldnt-read-the-stored-credentials-for-mcp-server) |
123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentication](#mcp-server-url-is-missing-or-not-a-valid-url) |123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentication](#mcp-server-url-is-missing-or-not-a-valid-url) |
124| `Issuer mismatch in authorization response (RFC 9207)` | [Authentication](#issuer-mismatch-in-authorization-response) |124| `Issuer mismatch in authorization response (RFC 9207)` | [Authentication](#issuer-mismatch-in-authorization-response) |
125| `Stopped an OAuth request` | [Autenticação](#stopped-an-oauth-request) |
125| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Authentication](#refusing-to-send-credentials-to-non-https-token-endpoint) |126| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Authentication](#refusing-to-send-credentials-to-non-https-token-endpoint) |
126| `Cloud gateway session expired — run /login to reconnect.` | [Authentication](#cloud-gateway-session-expired) |127| `Cloud gateway session expired — run /login to reconnect.` | [Authentication](#cloud-gateway-session-expired) |
127| `Cloud gateway <url> no longer accepts this session` | [Authentication](#cloud-gateway-session-expired) |128| `Cloud gateway <url> no longer accepts this session` | [Authentication](#cloud-gateway-session-expired) |
153| `403` com `GitHub GraphQL is not available from Claude Code sessions` em uma sessão na nuvem | [GitHub proxy](https://code.claude.com/docs/pt/cloud-environments.md#github-proxy) |154| `403` com `GitHub GraphQL is not available from Claude Code sessions` em uma sessão na nuvem | [GitHub proxy](https://code.claude.com/docs/pt/cloud-environments.md#github-proxy) |
154| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [Network](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |155| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [Network](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |
155| `Failed to fetch session from Sessions API: Failed to fetch session logs` | [Network](#failed-to-fetch-session-from-sessions-api) |156| `Failed to fetch session from Sessions API: Failed to fetch session logs` | [Network](#failed-to-fetch-session-from-sessions-api) |
157| `Couldn't load the history of cloud session` | [Rede](#couldnt-load-the-history-of-cloud-session) |
156| `Couldn't reconnect to your Remote Control session` | [Network](#couldnt-reconnect-to-your-remote-control-session) |158| `Couldn't reconnect to your Remote Control session` | [Network](#couldnt-reconnect-to-your-remote-control-session) |
157| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Network](#sessions-ended-while-this-machine-was-offline) |159| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Network](#sessions-ended-while-this-machine-was-offline) |
158| `Couldn't share the transcript.` | [Network](#couldnt-share-the-transcript) |160| `Couldn't share the transcript.` | [Network](#couldnt-share-the-transcript) |
180| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Request errors](#pdf-errors) |182| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Request errors](#pdf-errors) |
181| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |183| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |
182| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |184| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |
185| `N tools left out` ao lado de um servidor em `/mcp` / `Claude wasn't given N tools because the Anthropic API would reject their input schemas` | [Ferramentas com esquemas de entrada inválidos](https://code.claude.com/docs/pt/mcp.md#tools-with-invalid-input-schemas) |
183| `Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128` | [Request errors](#mcp-tool-name-over-128-characters) |186| `Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128` | [Request errors](#mcp-tool-name-over-128-characters) |
184| `tools.N.custom.name: String should have at most 128 characters` | [Request errors](#mcp-tool-name-over-128-characters) |187| `tools.N.custom.name: String should have at most 128 characters` | [Request errors](#mcp-tool-name-over-128-characters) |
185| `tool_use.name: String should have at most 200 characters` | [Request errors](#tool-use-name-over-200-characters) |188| `tool_use.name: String should have at most 200 characters` | [Request errors](#tool-use-name-over-200-characters) |
251| `Ultrareview did not start` | [Command-line errors](#ultrareview-did-not-start) |254| `Ultrareview did not start` | [Command-line errors](#ultrareview-did-not-start) |
252| `Remote Control did not start: "<question>" got no answer` | [Erros de linha de comando](#remote-control-did-not-start-got-no-answer) |255| `Remote Control did not start: "<question>" got no answer` | [Erros de linha de comando](#remote-control-did-not-start-got-no-answer) |
253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Command-line errors](#not-carried-over-to-the-sessions-remote-control-starts) |256| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Command-line errors](#not-carried-over-to-the-sessions-remote-control-starts) |
257| `Remote Control did not start, because sessions would skip part or all of the --settings file` | [Erros de linha de comando](#remote-control-did-not-start-because-of-the-settings-file) |
258| `The settings file <file> has changed since Remote Control started, so this session did not start` | [Erros de linha de comando](#settings-file-changed-since-remote-control-started) |
254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Command-line errors](#sandbox-is-not-supported-by-claude-remote-control) |259| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Command-line errors](#sandbox-is-not-supported-by-claude-remote-control) |
255| `` `claude import` is not yet available in this build `` | [Command-line errors](#claude-import-is-not-yet-available-in-this-build) |260| `` `claude import` is not yet available in this build `` | [Command-line errors](#claude-import-is-not-yet-available-in-this-build) |
256| `Could not read Claude Code config` | [Command-line errors](#could-not-read-claude-code-config) |261| `Could not read Claude Code config` | [Command-line errors](#could-not-read-claude-code-config) |
268| `No available ports for OAuth redirect` | [Command-line errors](#no-available-ports-for-oauth-redirect) |273| `No available ports for OAuth redirect` | [Command-line errors](#no-available-ports-for-oauth-redirect) |
269| `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) |274| `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) |
270| `Shell command permission check failed for pattern "..."`, de uma skill que injete contexto dinâmico | [Command-line errors](#security-review-fails-without-origin-head) |275| `Shell command permission check failed for pattern "..."`, de uma skill que injete contexto dinâmico | [Command-line errors](#security-review-fails-without-origin-head) |
276| ``Couldn't run `<command>` for <name>. A file named HEAD or .git in this folder or one above it may not be yours``, de uma skill que injeta contexto dinâmico | [Verificações de permissão em comandos injetados](https://code.claude.com/docs/pt/skills.md#permission-checks-on-injected-commands) |
271| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Command-line errors](#security-review-fails-without-origin-head) |277| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Command-line errors](#security-review-fails-without-origin-head) |
272| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Command-line errors](#no-shell-command-was-run) |278| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Command-line errors](#no-shell-command-was-run) |
273| `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) |279| `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) |
425| `Workspace not trusted.` ao iniciar ou reiniciar uma sessão em background | [Background session errors](#workspace-not-trusted-when-dispatching-a-background-session) |431| `Workspace not trusted.` ao iniciar ou reiniciar uma sessão em background | [Background session errors](#workspace-not-trusted-when-dispatching-a-background-session) |
426| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Background session errors](#eacces-when-starting-a-background-session) |432| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Background session errors](#eacces-when-starting-a-background-session) |
427| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |433| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |
434| `Subprocess initialization did not complete within 60000ms` | [Erros de wrapper e IDE](#subprocess-initialization-did-not-complete-within-60000ms) |
435| `Claude Code did not finish starting` | [Erros de wrapper e IDE](#subprocess-initialization-did-not-complete-within-60000ms) |
428| `The connection to Claude Code ended before this message completed` | [Wrapper and IDE errors](#the-connection-to-claude-code-ended-before-this-message-completed) |436| `The connection to Claude Code ended before this message completed` | [Wrapper and IDE errors](#the-connection-to-claude-code-ended-before-this-message-completed) |
429| `Could not locate the Claude CLI on PATH` | [Wrapper and IDE errors](#could-not-locate-the-claude-cli-on-path) |437| `Could not locate the Claude CLI on PATH` | [Wrapper and IDE errors](#could-not-locate-the-claude-cli-on-path) |
430| `The Claude Code program for this computer, the <build> build, could not be found` | [Erros de wrapper e IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |438| `The Claude Code program for this computer, the <build> build, could not be found` | [Erros de wrapper e IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |
560| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS` | sem teto | Com `CLAUDE_CODE_RETRY_WATCHDOG` definido, o tempo máximo em milissegundos que uma requisição aguarda a redefinição do [limite de uso](#youve-hit-your-session-limit) do seu plano, como o limite da sessão ou o semanal. Quando a redefinição está mais distante do que esse teto, a requisição falha imediatamente, a menos que os créditos de uso tenham margem ou a API não tenha conseguido verificá-los. Nesses casos, ela é tentada novamente e falha se o teto for ultrapassado antes de ela ser bem-sucedida. Requer Claude Code v2.1.301 ou posterior. |568| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS` | sem teto | Com `CLAUDE_CODE_RETRY_WATCHDOG` definido, o tempo máximo em milissegundos que uma requisição aguarda a redefinição do [limite de uso](#youve-hit-your-session-limit) do seu plano, como o limite da sessão ou o semanal. Quando a redefinição está mais distante do que esse teto, a requisição falha imediatamente, a menos que os créditos de uso tenham margem ou a API não tenha conseguido verificá-los. Nesses casos, ela é tentada novamente e falha se o teto for ultrapassado antes de ela ser bem-sucedida. Requer Claude Code v2.1.301 ou posterior. |
561| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/pt/env-vars) | não definido | Intervalo mínimo em milissegundos entre verificações de se um [limite de uso](#youve-hit-your-session-limit) já foi liberado, enquanto uma requisição aguarda a redefinição desse limite com `CLAUDE_CODE_RETRY_WATCHDOG` definido. Quando uma verificação constata que o limite foi liberado, a requisição é enviada imediatamente. Informe apenas dígitos de `60000` a `10800000`. Quando não definido ou fora desse intervalo, nenhuma verificação é feita. Para saber quando Claude Code ignora essas verificações, veja a [referência de variáveis de ambiente](https://code.claude.com/docs/pt/env-vars.md). Requer Claude Code v2.1.305 ou posterior. |569| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/pt/env-vars) | não definido | Intervalo mínimo em milissegundos entre verificações de se um [limite de uso](#youve-hit-your-session-limit) já foi liberado, enquanto uma requisição aguarda a redefinição desse limite com `CLAUDE_CODE_RETRY_WATCHDOG` definido. Quando uma verificação constata que o limite foi liberado, a requisição é enviada imediatamente. Informe apenas dígitos de `60000` a `10800000`. Quando não definido ou fora desse intervalo, nenhuma verificação é feita. Para saber quando Claude Code ignora essas verificações, veja a [referência de variáveis de ambiente](https://code.claude.com/docs/pt/env-vars.md). Requer Claude Code v2.1.305 ou posterior. |
562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 500 | Atraso inicial em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 32000, para distribuir as novas tentativas por uma janela mais longa quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.292 ou posterior. |570| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 500 | Atraso inicial em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 32000, para distribuir as novas tentativas por uma janela mais longa quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.292 ou posterior. |
563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 32000 | Teto em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 64000, para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.296 ou posterior. |571| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 32000 | Teto em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 300000, para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite de capacidade. Valores acima de 64000 requerem a v2.1.323 ou posterior. Não tem efeito nos mesmos casos que `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`. Requer Claude Code v2.1.296 ou posterior. |
564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars) | 600000 | Tempo em milissegundos que cada tentativa de requisição tem para receber seus cabeçalhos de resposta. Não limita quanto tempo uma resposta de streaming dura depois disso. Aumente-o para redes lentas ou proxies. Para saber como ele limita o prazo de primeiro byte, veja [No response from API](#no-response-from-api). |572| [`API_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars) | 600000 | Tempo em milissegundos que cada tentativa de requisição tem para receber seus cabeçalhos de resposta. Não limita quanto tempo uma resposta de streaming dura depois disso. Aumente-o para redes lentas ou proxies. Para saber como ele limita o prazo de primeiro byte, veja [No response from API](#no-response-from-api). |
565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/pt/env-vars) | não definido | Limite de reenvios de uma [requisição sem streaming](#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Ao atingir o limite, a requisição falha. Uma resposta do Claude que leva mais tempo que o timeout para ser gerada atinge o timeout novamente a cada reenvio, então defina um número baixo, como `0`, para falhar mais cedo. Para o timeout de cada tentativa, veja [Quanto tempo uma tentativa sem streaming aguarda](#how-long-a-non-streaming-attempt-waits). Requer Claude Code v2.1.285 ou posterior. |573| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/pt/env-vars) | não definido | Limite de reenvios de uma [requisição sem streaming](#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Ao atingir o limite, a requisição falha. Uma resposta do Claude que leva mais tempo que o timeout para ser gerada atinge o timeout novamente a cada reenvio, então defina um número baixo, como `0`, para falhar mais cedo. Para o timeout de cada tentativa, veja [Quanto tempo uma tentativa sem streaming aguarda](#how-long-a-non-streaming-attempt-waits). Requer Claude Code v2.1.285 ou posterior. |
566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/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). |574| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/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). |
825Chamadas posteriores na mesma resposta de Claude podem ser negadas com este motivo:833Chamadas posteriores na mesma resposta de Claude podem ser negadas com este motivo:
826 834
827```text theme={null}835```text theme={null}
828another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged836another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged
829```837```
830 838
831Claude pode então emitir cada chamada negada novamente para que o servidor a revise. Se um prompt de permissão for aberto, responda a ele. Você não precisa fazer mais nada, a menos que Claude diga na resposta que o modo auto não conseguiu verificar a chamada. Nesse caso, interrompa a alteração ou aprove a chamada você mesmo, e peça a Claude para tentar a chamada novamente:839Claude pode então emitir cada chamada negada novamente para que o servidor a revise. Se um prompt de permissão for aberto, responda a ele. Você não precisa fazer mais nada, a menos que Claude diga na resposta que o modo auto não conseguiu verificar a chamada. Nesse caso, interrompa a alteração ou aprove a chamada você mesmo, e peça a Claude para tentar a chamada novamente:
978 986
979### You've hit your monthly spend limit987### You've hit your monthly spend limit
980 988
981O uso incluído do seu plano não pode cobrir esta requisição, e os [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) que de outra forma pagariam por isso atingiram um limite de gastos. Isso acontece quando uma das janelas de uso do seu plano se esgotou, ou quando a requisição é uma que apenas créditos de uso pagam, como uma requisição para um modelo que [bills to usage credits](https://code.claude.com/docs/pt/model-config.md#fable-and-usage-credits). A mensagem nomeia cujo limite o bloqueou. O texto após o `·` diz como aumentar esse limite e varia com seu plano e se você gerencia o faturamento:989O uso incluído do seu plano não pode cobrir esta requisição, e os [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) que de outra forma pagariam por isso atingiram um limite de gastos. Seu plano não pode cobrir uma requisição quando uma de suas janelas de uso se esgotou, ou quando apenas créditos de uso pagam pela requisição. Um exemplo é uma requisição para um modelo que [bills to usage credits](https://code.claude.com/docs/pt/model-config.md#fable-and-usage-credits).
990
991As palavras antes do `·` nomeiam o limite que bloqueou você, como o limite de gastos mensais da sua organização, e o texto após ele diz como aumentar esse limite. Em uma sessão na nuvem ou sob [Remote Control](https://code.claude.com/docs/pt/remote-control.md), esse texto não fornece URL, e uma mensagem sobre o seu próprio `monthly spend limit` não diz como aumentá-lo. Outras sessões mostram formas como estas:
982 992
983```text theme={null}993```text theme={null}
984You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message994You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message
1822 1832
1823Antes 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`.1833Antes 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`.
1824 1834
1835### Stopped an OAuth request
1836
1837Esta mensagem significa que o Claude Code interrompeu uma [requisição OAuth para um servidor MCP](https://code.claude.com/docs/pt/mcp.md#authenticate-with-remote-mcp-servers) porque um endpoint OAuth a redirecionou. Em ambas as formas da mensagem, o primeiro endereço é aquele que enviou o redirecionamento:
1838
1839```text theme={null}
1840Stopped an OAuth request, which can hold secrets: https://auth.example.com redirected it to https://other.example.com. Ask the owner of https://auth.example.com to remove that redirect.
1841Stopped an OAuth request: https://auth.example.com redirected it more than 5 times. Ask the owner of https://auth.example.com to fix those redirects.
1842```
1843
1844**O que fazer:**
1845
1846* Peça a quem administra o primeiro endereço, como o operador do servidor MCP, para remover ou corrigir o redirecionamento. Depois, tente novamente a partir de `/mcp`.
1847
1825### Refusing to send credentials to non-https token endpoint1848### Refusing to send credentials to non-https token endpoint
1826 1849
1827No [runtime v2](https://code.claude.com/docs/pt/mcp.md#mcp-client-runtimes), o Claude Code envia uma requisição de token do [OAuth do MCP](https://code.claude.com/docs/pt/mcp.md#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.1850No [runtime v2](https://code.claude.com/docs/pt/mcp.md#mcp-client-runtimes), o Claude Code envia uma requisição de token do [OAuth do MCP](https://code.claude.com/docs/pt/mcp.md#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.
2207 2230
2208### Host not allowed in a cloud session2231### Host not allowed in a cloud session
2209 2232
2210Uma requisição HTTP de saída de uma sessão na nuvem ou tarefa agendada na nuvem foi bloqueada pela política de rede do ambiente.2233Em uma sessão na nuvem ou tarefa agendada na nuvem, um `403` ou um erro de DNS como `ENOTFOUND` pode significar que o host requisitado não está na [allowlist do ambiente de nuvem](https://code.claude.com/docs/pt/cloud-environments.md#access-levels). Para confirmar, compare o host com essa lista. Um `403` com este header confirma o bloqueio, mas nem todo `403` de uma requisição bloqueada o contém:
2211 2234
2212```text theme={null}2235```text theme={null}
2213HTTP 4032236HTTP 403
2290 2313
2291Antes da v2.1.296, Claude Code não tentava novamente uma leitura com falha e, após uma, podia abrir a sessão com uma conversa vazia e relatar sucesso em vez de imprimir essa mensagem.2314Antes da v2.1.296, Claude Code não tentava novamente uma leitura com falha e, após uma, podia abrir a sessão com uma conversa vazia e relatar sucesso em vez de imprimir essa mensagem.
2292 2315
2316### Couldn't load the history of cloud session
2317
2318Essa mensagem significa que Claude Code encontrou a [sessão na nuvem que você pediu para trazer ao seu terminal](https://code.claude.com/docs/pt/claude-code-on-the-web.md#from-cloud-to-terminal), mas a requisição do seu histórico de conversa retornou como não encontrada:
2319
2320```text theme={null}
2321Couldn't load the history of cloud session session_01HJKLMNOPQRSTUVWXYZ. Check it at https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ?from=cli
2322```
2323
2324**O que fazer:**
2325
2326* Abra o link na mensagem para verificar a sessão no seu navegador. Se ela abrir lá e o mesmo teleport falhar dessa forma novamente, [relate o problema](#report-an-error).
2327
2293### Couldn't reconnect to your Remote Control session2328### Couldn't reconnect to your Remote Control session
2294 2329
2295```text theme={null}2330```text theme={null}
2565 2600
2566O Claude Code normalmente redimensiona imagens grandes automaticamente. Esses erros significam que a imagem não pôde ser decodificada ou redimensionada para caber nos limites da API.2601O Claude Code normalmente redimensiona imagens grandes automaticamente. Esses erros significam que a imagem não pôde ser decodificada ou redimensionada para caber nos limites da API.
2567 2602
2603O erro que você vê pode mencionar um limite de pixels diferente, como `2576x2576px` onde estes exemplos dizem `2000x2000px`.
2604
2568**O que fazer:**2605**O que fazer:**
2569 2606
2570* Se a mensagem pedir que você converta a imagem, converta-a para PNG, JPEG, GIF ou WebP e anexe-a novamente. O Claude Code consegue verificar as dimensões desses formatos pelo cabeçalho do arquivo, sem decodificar a imagem.2607* Se a mensagem pedir que você converta a imagem, converta-a para PNG, JPEG, GIF ou WebP e anexe-a novamente. O Claude Code consegue verificar as dimensões desses formatos pelo cabeçalho do arquivo, sem decodificar a imagem.
2873* **Um motivo escrito por um hook**: um hook PreModelSwitch forneceu esse motivo ao [negar a troca ou pedir confirmação](https://code.claude.com/docs/pt/hooks.md#premodelswitch-decision-control). Resolva o que ele pede, ou escolha um modelo que seus hooks permitam.2910* **Um motivo escrito por um hook**: um hook PreModelSwitch forneceu esse motivo ao [negar a troca ou pedir confirmação](https://code.claude.com/docs/pt/hooks.md#premodelswitch-decision-control). Resolva o que ele pede, ou escolha um modelo que seus hooks permitam.
2874* **`PreModelSwitch hook <name> did not respond before its timeout`**: um hook que não responde antes do seu [timeout](https://code.claude.com/docs/pt/hooks.md#timeouts) bloqueia a troca. Corrija o comando travado ou aumente o `timeout` desse hook e depois troque novamente.2911* **`PreModelSwitch hook <name> did not respond before its timeout`**: um hook que não responde antes do seu [timeout](https://code.claude.com/docs/pt/hooks.md#timeouts) bloqueia a troca. Corrija o comando travado ou aumente o `timeout` desse hook e depois troque novamente.
2875* **`confirmation required, and this session cannot ask`**: um hook respondeu `ask` sem um motivo, e uma requisição de controle não tem como mostrar o prompt de confirmação. Um comando `/model` em uma [execução `-p`](https://code.claude.com/docs/pt/headless) informa a mesma condição com `(run /model interactively to confirm)` após o motivo. Faça a troca a partir de uma sessão interativa, ou altere a decisão do hook para esse modelo.2912* **`confirmation required, and this session cannot ask`**: um hook respondeu `ask` sem um motivo, e uma requisição de controle não tem como mostrar o prompt de confirmação. Um comando `/model` em uma [execução `-p`](https://code.claude.com/docs/pt/headless) informa a mesma condição com `(run /model interactively to confirm)` após o motivo. Faça a troca a partir de uma sessão interativa, ou altere a decisão do hook para esse modelo.
2876* **`so organization-managed PreModelSwitch hooks could not be checked`**: o Claude Code não conseguiu determinar quais hooks PreModelSwitch os [plugins gerenciados](https://code.claude.com/docs/pt/settings-reference.md#enabledplugins) da sua organização fornecem, por exemplo porque um plugin gerenciado falhou ao carregar. Um desses hooks poderia bloquear a troca, então o Claude Code recusa em vez de aplicar a troca sem verificação. O início do motivo nomeia o que falhou. O Claude Code verifica novamente a cada tentativa de troca, então uma falha que já foi resolvida deixa de bloquear; se continuar falhando, execute `claude --debug` e troque novamente para capturar os detalhes, depois corrija o plugin ou peça ao seu administrador que o corrija.2913* **`so organization-managed PreModelSwitch hooks could not be checked`**: o Claude Code anterior à v2.1.323 recusa quando não consegue determinar quais hooks PreModelSwitch seus [plugins gerenciados](https://code.claude.com/docs/pt/settings-reference.md#enabledplugins) fornecem. O texto antes dessa frase menciona o que falhou. Para acabar com a recusa, atualize o Claude Code. Para também fazer os hooks de um plugin com falha funcionarem, corrija o plugin ou fale com seu administrador. Para mais detalhes, inicie `claude --debug` no seu shell e troque de modelo, depois leia o [log de depuração](https://code.claude.com/docs/pt/hooks.md#debug-hooks).
2877* **`a PreModelSwitch hook failed before answering`** ou **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: a execução do hook terminou sem um veredito, e o Claude Code não trata isso como aprovação. Execute `claude --debug` para ver o que falhou e depois troque novamente.2914* **`a PreModelSwitch hook failed before answering`** ou **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: a execução do hook terminou sem um veredito, e o Claude Code não trata isso como aprovação. Execute `claude --debug` para ver o que falhou e depois troque novamente.
2878 2915
2879Antes da v2.1.260, a recusa por plugin gerenciado dizia `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. O Claude Code tentava carregar o plugin novamente uma vez e depois recusava as trocas seguintes na sessão, mesmo quando sua organização não gerenciava nenhum plugin. Nessas versões, reinicie a sessão para executar o carregamento do plugin novamente.2916Antes da v2.1.260, a recusa por plugin gerenciado dizia `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. O Claude Code tentava carregar o plugin novamente uma vez e depois recusava as trocas seguintes na sessão, mesmo quando sua organização não gerenciava nenhum plugin. Nessas versões, reinicie a sessão para executar o carregamento do plugin novamente.
3499* **`Error: Workspace not trusted. <folder> is your home directory`**: como a confiança para seu diretório pessoal nunca é salva, executar `claude` ali primeiro não ajuda. Execute `claude ultrareview` a partir de um diretório de projeto, depois de executar `claude` ali uma vez para aceitar a caixa de diálogo de confiança, ou acrescente `--trust-workspace`.3536* **`Error: Workspace not trusted. <folder> is your home directory`**: como a confiança para seu diretório pessoal nunca é salva, executar `claude` ali primeiro não ajuda. Execute `claude ultrareview` a partir de um diretório de projeto, depois de executar `claude` ali uma vez para aceitar a caixa de diálogo de confiança, ou acrescente `--trust-workspace`.
3500* **`No answer in time.` seguido de `Error: Workspace not trusted`**: a pergunta `Trust <folder>? [y/N]` ficou sem resposta por 5 minutos. Execute `claude ultrareview` novamente e responda.3537* **`No answer in time.` seguido de `Error: Workspace not trusted`**: a pergunta `Trust <folder>? [y/N]` ficou sem resposta por 5 minutos. Execute `claude ultrareview` novamente e responda.
3501* **`Ultrareview did not start: <folder> is not trusted`**: você recusou na pergunta `Trust <folder>? [y/N]`, por exemplo respondendo `n` ou pressionando Enter. Para iniciar a revisão, execute `claude ultrareview` novamente e responda `y`.3538* **`Ultrareview did not start: <folder> is not trusted`**: você recusou na pergunta `Trust <folder>? [y/N]`, por exemplo respondendo `n` ou pressionando Enter. Para iniciar a revisão, execute `claude ultrareview` novamente e responda `y`.
3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**: algo que não é uma flag vem depois de `--trust-workspace`, como um número de PR ou `false`. Se você não confia na pasta, omita a flag. Para confiar nela nesta execução, coloque o número do PR ou o branch base antes da flag: `claude ultrareview 1234 --trust-workspace`.3539* **``Ultrareview did not start: `--trust-workspace` takes no value``**: algo que não é uma flag vem depois de `--trust-workspace`, como um número de PR ou `false`. Se você não confia na pasta, omita a flag. Para confiar nela durante esta execução, coloque o número do PR ou o branch base antes da flag: `claude ultrareview 1234 --trust-workspace`.
3503 3540
3504Antes da v2.1.309, `claude ultrareview` não aceitava `--trust-workspace`.3541Antes da v2.1.309, `claude ultrareview` não aceitava `--trust-workspace`.
3505 3542
3522Você iniciou o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) 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:3559Você iniciou o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) 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:
3523 3560
3524```text theme={null}3561```text theme={null}
3525Error: `--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`).3562Error: `--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`). Pass settings with `claude remote-control --settings <file>`.
3526```3563```
3527 3564
3528O 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 inicia.3565O 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 inicia.
3536 3573
3537Antes 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`.3574Antes 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`.
3538 3575
3576### O Remote Control não iniciou por causa do arquivo de `--settings`
3577
3578O arquivo que você passou para [`claude remote-control --settings`](https://code.claude.com/docs/pt/remote-control#start-a-remote-control-session) tem um problema:
3579
3580```text theme={null}
3581Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON
3582```
3583
3584**O que fazer:**
3585
3586* Corrija o problema que a mensagem cita e execute seu comando `claude remote-control` novamente
3587
3588### O arquivo de configurações mudou desde que o Remote Control foi iniciado
3589
3590Esta mensagem no terminal que executa `claude remote-control` significa que as sessões não serão iniciadas a partir do arquivo que você passou para [`--settings`](https://code.claude.com/docs/pt/remote-control#start-a-remote-control-session) tal como ele está agora:
3591
3592```text theme={null}
3593Session failed: Error: The settings file /path/to/settings.json has changed since Remote Control started, so this session did not start. Restart `claude remote-control` to use it as it is now.
3594```
3595
3596**O que fazer:**
3597
3598* Para usar o arquivo tal como está agora, interrompa `claude remote-control` e execute o mesmo comando novamente. Para recuperar as sessões que ele estava servindo, consulte [Resume sessions after stopping the server](https://code.claude.com/docs/pt/remote-control.md#resume-sessions-after-stopping-the-server).
3599* Para manter as configurações com as quais o Remote Control foi iniciado, restaure o conteúdo do arquivo como estava e execute o comando novamente se `claude remote-control` tiver saído
3600
3539### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3601### `--sandbox` or `--no-sandbox` is not supported by claude remote-control
3540 3602
3541Este erro significa que o comando que inicia seu servidor de [Remote Control](https://code.claude.com/docs/pt/remote-control.md) passa `--sandbox` ou `--no-sandbox` depois de `remote-control`, e `claude remote-control` não aceita nenhuma dessas flags. O servidor sai com código 1 em vez de iniciar:3603Este erro significa que o comando que inicia seu servidor de [Remote Control](https://code.claude.com/docs/pt/remote-control.md) passa `--sandbox` ou `--no-sandbox` depois de `remote-control`, e `claude remote-control` não aceita nenhuma dessas flags. O servidor sai com código 1 em vez de iniciar:
3806 3868
3807Mensagens semelhantes são disparadas antes mesmo de o comando ser executado:3869Mensagens semelhantes são disparadas antes mesmo de o comando ser executado:
3808 3870
3809* `Shell command permission check failed for pattern "..."`: a verificação de permissão do comando não o permitiu. [Permission checks on injected commands](https://code.claude.com/docs/pt/skills.md#permission-checks-on-injected-commands) explica quais resultados abortam em cada modo de permissão e como pré-aprovar um comando com `allowed-tools`3871* `Shell command permission check failed for pattern "..."`: a verificação de permissão do comando não o permitiu. Consulte [Permission checks on injected commands](https://code.claude.com/docs/pt/skills.md#permission-checks-on-injected-commands) para ver quais resultados abortam em cada modo de permissão e quando `allowed-tools` pré-aprova um comando
3810* ``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](https://code.claude.com/docs/pt/skills.md#how-injected-commands-run)3872* ``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](https://code.claude.com/docs/pt/skills.md#how-injected-commands-run)
3811 3873
3812**O que fazer:**3874**O que fazer:**
3960 4022
3961* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar seu branch base explicitamente, como no exemplo acima4023* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar seu branch base explicitamente, como no exemplo acima
3962* **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>`)``4024* **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>`)``
3963* **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 determinar se seu clone é raso (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`.4025* **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 determinar se o seu clone é raso (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`.
3964 4026
3965**O que fazer:**4027**O que fazer:**
3966 4028
4490commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory4552commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory
4491```4553```
4492 4554
4493Uma mensagem que fornece o caminho completo de um dos próprios arquivos de um plugin de marketplace, como `hooks/hooks.json`, significa que Claude Code ignorou esse arquivo. Isso acontece quando Claude Code não consegue confirmar que o arquivo está dentro do plugin ou, para um plugin em um [marketplace local](https://code.claude.com/docs/pt/plugins/loading.md#in-place-and-copied-plugins), dentro desse marketplace. A mensagem relata cada um desses arquivos sob o nome de componente mostrado:4555Uma mensagem que fornece o caminho completo de um dos próprios arquivos de um plugin de marketplace, como `hooks/hooks.json`, significa que Claude Code ignorou esse arquivo. Quando Claude Code não consegue confirmar que o arquivo está dentro do plugin ou, para um plugin em um [marketplace local](https://code.claude.com/docs/pt/plugins/loading.md#in-place-and-copied-plugins), dentro desse marketplace, ele ignora o arquivo. A mensagem relata esses arquivos sob o nome de componente mostrado:
4494 4556
4495* `hooks/hooks.json`: `hooks`4557* `hooks/hooks.json`: `hooks`
4496* `monitors/monitors.json`: `monitors`4558* `monitors/monitors.json`: `monitors`
4497* `settings.json`: `settings`
4498* `SKILL.md` na raiz do plugin: `skills`4559* `SKILL.md` na raiz do plugin: `skills`
4499 4560
4500Por exemplo, esta mensagem é para um `hooks/hooks.json` que resolve fora tanto do plugin quanto de seu marketplace local:4561Por exemplo, esta mensagem é para um `hooks/hooks.json` que resolve fora tanto do plugin quanto de seu marketplace local:
5481Você abriu uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md) que terminou enquanto o serviço em background estava desligado, e [limpeza de transcrição](https://code.claude.com/docs/pt/settings-reference.md#cleanupperioddays) desde então removeu sua conversa salva, por exemplo após a máquina estar desligada por semanas. Abrir tal linha normalmente [retoma sua conversa salva](https://code.claude.com/docs/pt/agent-view.md#sessions-show-as-failed-after-shutdown). Sem nada para retomar, Claude Code recusa em vez de re-executar o prompt original da sessão sem perguntar:5542Você abriu uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md) que terminou enquanto o serviço em background estava desligado, e [limpeza de transcrição](https://code.claude.com/docs/pt/settings-reference.md#cleanupperioddays) desde então removeu sua conversa salva, por exemplo após a máquina estar desligada por semanas. Abrir tal linha normalmente [retoma sua conversa salva](https://code.claude.com/docs/pt/agent-view.md#sessions-show-as-failed-after-shutdown). Sem nada para retomar, Claude Code recusa em vez de re-executar o prompt original da sessão sem perguntar:
5482 5543
5483```text theme={null}5544```text theme={null}
5484This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.5545This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` removes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.
5485```5546```
5486 5547
5487`claude attach <id>` imprime este texto. Na agent view, o rodapé é mais curto e termina com `ctrl+x deletes the row`.5548`claude attach <id>` imprime este texto. Na agent view, o rodapé é mais curto e termina com `ctrl+x removes the row`.
5488 5549
5489**O que fazer:**5550**O que fazer:**
5490 5551
5503 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef5564 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
5504```5565```
5505 5566
5506Quando Claude Code não consegue resumir os commits, a linha de detalhe lê `The worktree has unpushed commits` em vez disso. Na [agent view](https://code.claude.com/docs/pt/agent-view.md), a linha da sessão mostra `not deleted` com a mesma razão.5567Quando Claude Code não consegue resumir os commits, a linha de detalhe lê `The worktree has unpushed commits` em vez disso. Na [agent view](https://code.claude.com/docs/pt/agent-view.md), a linha da sessão mostra `not removed` com a mesma razão.
5507 5568
5508Commits em um remote não bloqueiam o delete. Nem commits na cópia local do branch padrão do seu remote `origin`, desde que esse branch esteja em checkout no seu checkout principal, o diretório do repositório em si em vez de um worktree.5569Commits em um remote não bloqueiam o delete. Nem commits na cópia local do branch padrão do seu remote `origin`, desde que esse branch esteja em checkout no seu checkout principal, o diretório do repositório em si em vez de um worktree.
5509 5570
5780 5841
5781Esses erros vêm do programa que iniciou o Claude Code para você, como uma extensão de IDE ou uma aplicação [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), em vez de virem do próprio Claude Code.5842Esses erros vêm do programa que iniciou o Claude Code para você, como uma extensão de IDE ou uma aplicação [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), em vez de virem do próprio Claude Code.
5782 5843
5844### Subprocess initialization did not complete within 60000ms
5845
5846Esse erro significa que um processo do Claude Code iniciado pela [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) ou por uma aplicação Agent SDK não informou a tempo que estava pronto. A extensão ou aplicação então o interrompeu. Em uma conversa no VS Code, o erro começa com `Claude Code did not finish starting`, por exemplo:
5847
5848```text theme={null}
5849Claude Code did not finish starting: it did not answer in time. The output logs ("View output logs") show how far it got. Slow plugins, MCP servers, hooks, disks or network can each cause this.
5850```
5851
5852Nos logs de saída da extensão, na sua tela de login e em uma aplicação Agent SDK, o erro aparece de forma diferente. Ele começa com `Subprocess initialization did not complete within` e o limite de tempo, e depois mostra o que o Claude Code relatou, por exemplo:
5853
5854```text theme={null}
5855Subprocess initialization did not complete within 60000ms. Claude Code did not answer the initialize request and reported no SessionStart or Setup hook running. Slow plugins, MCP servers, hooks that Claude Code does not report, disks or network can each cause this.
5856```
5857
5858**O que fazer:**
5859
5860* Para tentar novamente no VS Code, envie uma mensagem. Se o erro apareceu enquanto você fazia login, selecione o método de login novamente.
5861* Para ver até onde o Claude Code chegou, clique em **View output logs** abaixo do erro de uma conversa ou execute **Claude Code: Show Logs** na Command Palette. Inclua as entradas em torno da linha `Subprocess initialization` ao [relatar o problema](https://github.com/anthropics/claude-code/issues).
5862* Para verificar sua rede, consulte [Configuração de rede](https://code.claude.com/docs/pt/network-config.md). Se a mensagem pedir que você verifique seu login ou autenticação, consulte [Login e autenticação](https://code.claude.com/docs/pt/troubleshoot-install.md#login-and-authentication).
5863* Se a mensagem disser que hooks [SessionStart](https://code.claude.com/docs/pt/hooks.md#sessionstart) ou [Setup](https://code.claude.com/docs/pt/hooks.md#setup) não haviam terminado, [verifique quanto tempo os seus levam para executar](https://code.claude.com/docs/pt/hooks.md#debug-hooks). No VS Code, os primeiros 10 minutos em que o Claude Code relata esses hooks em execução não contam para o limite de 60 segundos. Faça um hook lento terminar mais cedo, reduza o [`timeout`](https://code.claude.com/docs/pt/hooks#common-fields) de um hook não assíncrono ou [remova o hook](https://code.claude.com/docs/pt/hooks.md#disable-or-remove-hooks).
5864* Se sua aplicação Agent SDK chama [`startup()`](https://code.claude.com/docs/pt/agent-sdk/typescript#startup), defina `initializeTimeoutMs` com um valor longo o suficiente para toda a inicialização, ou deixe-o sem definir para que até 10 minutos de tempo de hook relatado não sejam contados.
5865
5866Antes da extensão VS Code v2.1.304 e do TypeScript Agent SDK v0.3.304, todo o tempo de hooks contava para o limite. Com o limite padrão, a mensagem continha `Subprocess initialization did not complete within 60000ms — check authentication and network connectivity`. Se você vir essa mensagem, atualize a extensão ou o SDK.
5867
5783### Claude Code process exited with code N5868### Claude Code process exited with code N
5784 5869
5785O processo `claude` subjacente saiu com um código diferente de zero. O código de saída por si só não diz o que falhou: o erro real está na saída do próprio processo, que o wrapper anexa quando capturou alguma coisa e caso contrário mantém em seus logs.5870O processo `claude` subjacente saiu com um código diferente de zero. O código de saída por si só não diz o que falhou: o erro real está na saída do próprio processo, que o wrapper anexa quando capturou alguma coisa e caso contrário mantém em seus logs.
