diff --git a/pt/errors.md b/pt/errors.md
index 5a9432a4c28fa8216548f79e8ab10338d0ff11c4..556380642d62e4d0051cbf8f3bc44f3734022155 100644
--- a/pt/errors.md
+++ b/pt/errors.md
@@ -6,124 +6,377 @@
> Procure mensagens de erro de tempo de execução do Claude Code com o que cada uma significa e como corrigi-la.
-Esta página lista os erros de tempo de execução que o Claude Code exibe e como se recuperar de cada um, além do que verificar quando as respostas parecem incorretas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Troubleshoot installation and login](/docs/pt/troubleshoot-install).
+Esta 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).
-Esses erros e comandos de recuperação se aplicam em toda a CLI, no [aplicativo Desktop](/docs/pt/desktop) e no [Claude Code na web](/docs/pt/claude-code-on-the-web), já que todos os três envolvem a mesma CLI do Claude Code. Para problemas específicos da superfície, consulte a seção de solução de problemas na página dessa superfície.
+Exceto 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, ao [aplicativo Desktop](/docs/pt/desktop) e [sessões em nuvem](/docs/pt/claude-code-on-the-web), já que todos os três envolvem a mesma 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.
- O Claude Code chama a API Claude para respostas do modelo, portanto, a maioria dos erros de tempo de execução mapeia para um código de erro de API subjacente. Esta página cobre o que cada erro significa dentro do Claude Code e como se recuperar. Para as definições de código de status HTTP bruto, consulte a [referência de erro da plataforma Claude](https://platform.claude.com/docs/pt/api/errors).
+ Claude Code chama a API Claude para respostas do modelo, portanto, a maioria dos erros de tempo de execução mapeia para um código de erro de API subjacente. Esta página cobre o que cada erro significa dentro do Claude Code e como se recuperar. Para as definições de código de status HTTP bruto, consulte a [referência de erro da Plataforma Claude](https://platform.claude.com/docs/en/api/errors).
Encontre seu erro
-Corresponda a mensagem que você vê em seu terminal a uma seção abaixo.
+Corresponda a mensagem que você vê a uma seção abaixo.
| Mensagem | Seção |
-| :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |
-| `API Error: 500 Internal server error` | [Erros de servidor](#api-error-500-internal-server-error) |
-| `API Error: Repeated 529 Overloaded errors` | [Erros de servidor](#api-error-repeated-529-overloaded-errors) |
-| `Request timed out` | [Erros de servidor](#request-timed-out), ou [Rede](#unable-to-connect-to-api) se a mensagem mencionar sua conexão com a internet |
-| `Server error mid-response. The response above may be incomplete.` | [Erros de servidor](#the-response-above-may-be-incomplete) |
-| `Connection closed mid-response` / `Response stalled mid-stream` | [Erros de servidor](#the-response-above-may-be-incomplete) |
-| ` is temporarily unavailable, so auto mode cannot determine the safety of...` | [Erros de servidor](#auto-mode-cannot-determine-the-safety-of-an-action) |
-| `Auto mode could not evaluate this action and is blocking it for safety` | [Erros de servidor](#auto-mode-cannot-determine-the-safety-of-an-action) |
-| `Auto mode classifier transcript exceeded context window` | [Erros de servidor](#auto-mode-cannot-determine-the-safety-of-an-action) |
-| `Agent terminated early due to an API error` | [Erros de servidor](#agent-terminated-early-due-to-an-api-error) |
-| `You've hit your session limit` / `You've hit your weekly limit` | [Limites de uso](#youve-hit-your-session-limit) |
-| `Usage credits required for 1M context` | [Limites de uso](#usage-credits-required-for-1m-context) |
-| `Server is temporarily limiting requests` | [Limites de uso](#server-is-temporarily-limiting-requests) |
-| `Request rejected (429)` | [Limites de uso](#request-rejected-429) |
-| `Credit balance is too low` | [Limites de uso](#credit-balance-is-too-low) |
-| `Not logged in · Please run /login` | [Autenticação](#not-logged-in) |
-| `Could not resolve authentication method` | [Autenticação](#could-not-resolve-authentication-method) |
-| `Invalid API key` | [Autenticação](#invalid-api-key) |
-| `Your apiKeyHelper script is failing` | [Autenticação](#your-apikeyhelper-script-is-failing) |
-| `This organization has been disabled` | [Autenticação](#this-organization-has-been-disabled) |
-| `Your organization has disabled API key authentication` | [Autenticação](#your-organization-has-disabled-api-key-authentication) |
-| `Your organization has disabled Claude subscription access` | [Autenticação](#your-organization-has-disabled-claude-subscription-access) |
-| `Routines are disabled by your organization's policy` | [Autenticação](#routines-are-disabled-by-your-organizations-policy) |
-| `Remote Control is only available when using Claude via api.anthropic.com` | [Autenticação](#remote-control-requires-the-anthropic-api) |
-| `OAuth token revoked` / `OAuth token has expired` | [Autenticação](#oauth-token-revoked-or-expired) |
-| `Login expired · Please run /login` | [Autenticação](#login-expired) |
-| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Autenticação](#login-expired) |
-| `does not meet scope requirement user:profile` | [Autenticação](#oauth-scope-requirement) |
-| `AWS credentials expired or invalid` | [Autenticação](#aws-credentials-expired-or-invalid) |
-| `AWS authentication failed` | [Autenticação](#aws-authentication-failed) |
-| `AWS default-chain credential resolve timed out` | [Autenticação](#aws-default-chain-credential-resolve-timed-out) |
-| `Unable to connect to API` | [Rede](#unable-to-connect-to-api) |
-| `Waiting for API response · will retry in` | [Tentativas automáticas](#automatic-retries), ou [Rede](#unable-to-connect-to-api) se persistir |
-| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Rede](#bedrock-streaming-response-has-an-unexpected-content-type) |
-| `SSL certificate verification failed` | [Rede](#ssl-certificate-errors) |
-| `SSL certificate error (...)` during login or startup | [Rede](#ssl-certificate-errors) |
-| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Rede](#host-not-allowed-in-a-cloud-session) |
-| `Couldn't reconnect to your Remote Control session` | [Rede](#couldnt-reconnect-to-your-remote-control-session) |
-| `Prompt is too long` | [Erros de solicitação](#prompt-is-too-long) |
-| `Error during compaction: Conversation too long` | [Erros de solicitação](#error-during-compaction-conversation-too-long) |
-| `Request too large` | [Erros de solicitação](#request-too-large) |
-| `Image was too large` | [Erros de solicitação](#image-was-too-large) |
-| `Unable to resize image` | [Erros de solicitação](#unable-to-resize-image) |
-| `PDF too large` / `PDF is password protected` | [Erros de solicitação](#pdf-errors) |
-| `Extra inputs are not permitted` | [Erros de solicitação](#extra-inputs-are-not-permitted) |
-| `There's an issue with the selected model` | [Erros de solicitação](#theres-an-issue-with-the-selected-model) |
-| `Model ... is not a recognized model id` | [Erros de solicitação](#model-is-not-a-recognized-model-id) |
-| `Claude Opus is not available with the Claude Pro plan` | [Erros de solicitação](#claude-opus-is-not-available-with-the-claude-pro-plan) |
-| `Model ... is restricted by your organization's settings` | [Erros de solicitação](#model-is-restricted-by-your-organizations-settings) |
-| `thinking.type.enabled is not supported for this model` | [Erros de solicitação](#thinking-type-enabled-is-not-supported-for-this-model) |
-| `max_tokens must be greater than thinking.budget_tokens` | [Erros de solicitação](#thinking-budget-exceeds-output-limit) |
-| `API Error: 400 due to tool use concurrency issues` | [Erros de solicitação](#tool-use-or-thinking-block-mismatch) |
-| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Erros de solicitação](#usage-policy-refusal) |
-| ` has safety measures that flagged this message for a cybersecurity topic` | [Erros de solicitação](#safety-measures-flagged-a-cybersecurity-topic) |
-| `Installation was killed before it could finish (exit code 137)` | [Erros de instalação](#installation-was-killed-before-it-could-finish) |
-| `The connection dropped while downloading the update` | [Erros de instalação](#the-connection-dropped-while-downloading-the-update) |
-| `Download timed out: exceeded the total deadline` | [Erros de instalação](#the-connection-dropped-while-downloading-the-update) |
-| `--bg and --print conflict` | [Erros de linha de comando](#command-line-errors) |
-| `Error: --json-schema is not a valid JSON Schema` | [Erros de linha de comando](#command-line-errors) |
-| `Could not import : ` | [Erros de linha de comando](#could-not-import-a-server-from-claude-desktop) |
-| `Error: MCP tool (passed via --permission-prompt-tool) not found` | [Erros de linha de comando](#mcp-permission-prompt-tool-not-found) |
-| `Marketplace "" is registered from an untrusted source` | [Erros de plugin](#marketplace-is-registered-from-an-untrusted-source) |
-| `references ${user_config.*} in a shell-form command` | [Erros de plugin](#plugin-command-references-user-config) |
-| `Monitor "" from plugin references ${user_config.*} in its command` | [Erros de plugin](#plugin-command-references-user-config) |
-| `headersHelper for MCP server '' references ${user_config.*}` | [Erros de plugin](#plugin-command-references-user-config) |
-| `would be spawned with zero tools — refusing` | [Erros de ferramenta](#agent-would-be-spawned-with-zero-tools) |
-| `File is covered by a Read deny rule in your permission settings` | [Erros de ferramenta](#file-is-covered-by-a-read-deny-rule) |
-| `Can't open MCP settings in a background session` | [Erros de sessão em segundo plano](#commands-refused-in-a-background-session) |
-| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Erros de sessão em segundo plano](#claude_code_process_wrapper-launcher-errors) |
-| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avisos de configuração](#workspace-has-not-been-trusted) |
-| Respostas parecem de qualidade inferior ao usual | [Qualidade de resposta](#responses-seem-lower-quality-than-usual) |
+| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |
+| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |
+| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |
+| `Request timed out` | [Server errors](#request-timed-out), ou [Network](#unable-to-connect-to-api) se a mensagem mencionar sua conexão com a internet |
+| `API Error: No response from API` | [Server errors](#no-response-from-api) |
+| `Server error mid-response. The response above may be incomplete.` | [Server errors](#the-response-above-may-be-incomplete) |
+| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Server errors](#the-response-above-may-be-incomplete) |
+| `Connection closed mid-response` / `Response stalled mid-stream` | [Server errors](#the-response-above-may-be-incomplete) |
+| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Automatic retries](#automatic-retries) |
+| `Connection closed while thinking` / `Response stalled while thinking` | [Automatic retries](#automatic-retries) |
+| `Connection lost while your computer was asleep` | [Automatic retries](#automatic-retries) |
+| ` is temporarily unavailable, so auto mode cannot determine the safety of...` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
+| `Auto mode could not evaluate this action and is blocking it for safety` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
+| `Auto mode classifier transcript exceeded context window` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
+| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
+| `The server-side auto mode classifier gave no verdict` | [Server errors](#the-server-returned-no-safety-verdict) |
+| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [Server errors](#the-server-returned-no-safety-verdict) |
+| `Agent terminated early due to an API error` | [Server errors](#agent-terminated-early-due-to-an-api-error) |
+| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [Usage limits](#youve-hit-your-session-limit) |
+| `Usage credits required for 1M context` | [Usage limits](#usage-credits-required-for-1m-context) |
+| `the prompt to confirm went unanswered — nothing was sent` | [Usage limits](#the-prompt-to-confirm-went-unanswered) |
+| `Server is temporarily limiting requests` | [Usage limits](#server-is-temporarily-limiting-requests) |
+| `Request rejected (429)` | [Usage limits](#request-rejected-429) |
+| `Credit balance is too low` | [Usage limits](#credit-balance-is-too-low) |
+| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Usage limits](#youve-hit-your-monthly-spend-limit) |
+| `Could not update your spend limit` | [Usage limits](#could-not-update-your-spend-limit) |
+| `spend limit reached` / `spend limit unavailable` | [Usage limits](#spend-limit-reached) |
+| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |
+| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |
+| `Invalid API key` | [Authentication](#invalid-api-key) |
+| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |
+| `Invalid auth token · Fix external auth token` | [Authentication](#invalid-request-header-value) |
+| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [Authentication](#invalid-request-header-value) |
+| `Invalid request header from the environment · Fix the environment variable` | [Authentication](#invalid-request-header-value) |
+| `This organization has been disabled` | [Authentication](#this-organization-has-been-disabled) |
+| `Your organization has disabled API key authentication` | [Authentication](#your-organization-has-disabled-api-key-authentication) |
+| `Your organization has disabled Claude subscription access` | [Authentication](#your-organization-has-disabled-claude-subscription-access) |
+| `Routines are disabled by your organization's policy` | [Authentication](#routines-are-disabled-by-your-organizations-policy) |
+| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentication](#remote-control-requires-the-anthropic-api) |
+| `OAuth token refresh failed — run /login to re-authenticate` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `JWT refresh failed: no OAuth token — run /login` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `Claude.ai login expired` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `Claude.ai login was rejected — run /login, then /remote-control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `OAuth token unavailable — run /login to restore Remote Control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `Signed out of Claude — run /login, then /remote-control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `signed-in claude.ai account or organization changed on this machine` | [Authentication](#remote-control-stopped-because-the-signed-in-account-changed) |
+| `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) |
+| `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) |
+| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |
+| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |
+| `Login expired · Please run /login` | [Authentication](#login-expired) |
+| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |
+| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |
+| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
+| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
+| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |
+| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |
+| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |
+| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentication](#anthropic-profile-login-expired) |
+| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile` | [Authentication](#anthropic-profile-login-expired) |
+| `does not meet scope requirement user:profile` | [Authentication](#oauth-scope-requirement) |
+| `claude.ai rejected the session token` / `session token rejected` | [Authentication](#claude-ai-rejected-the-session-token) |
+| `MCP server "" needs you to sign in again (run /mcp to re-authenticate)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
+| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
+| `MCP server "" needs additional permissions (scope: "") — run /mcp to re-authenticate` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
+| `MCP server "" requires re-authorization (token expired)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
+| `Issuer mismatch in authorization response (RFC 9207)` | [Authentication](#issuer-mismatch-in-authorization-response) |
+| `Cloud gateway session expired — run /login to reconnect.` | [Authentication](#cloud-gateway-session-expired) |
+| `Cloud gateway no longer accepts this session` | [Authentication](#cloud-gateway-session-expired) |
+| `Sign-in timed out while waiting for you to continue. Try again.` | [Authentication](#sign-in-timed-out-while-waiting-for-you-to-continue) |
+| `AWS credentials expired or invalid` | [Authentication](#aws-credentials-expired-or-invalid) |
+| `AWS authentication failed` | [Authentication](#aws-authentication-failed) |
+| `Google Cloud credentials expired or invalid` | [Authentication](#google-cloud-credentials-expired-or-invalid) |
+| `Google Cloud authentication failed` | [Authentication](#google-cloud-authentication-failed) |
+| `Microsoft Foundry authentication failed` | [Authentication](#microsoft-foundry-authentication-failed) |
+| `Gateway refused the request` | [Authentication](#gateway-refused-the-request) |
+| `Could not load AWS credentials` / `Could not load Google Cloud credentials` | [Authentication](#could-not-load-aws-or-google-cloud-credentials) |
+| `AWS default-chain credential resolve timed out` | [Authentication](#aws-default-chain-credential-resolve-timed-out) |
+| `Timed out after 60s waiting for AWS` | [Authentication](#bedrock-setup-verification-timed-out-waiting-for-aws) |
+| `A request to AWS timed out. Check your network and proxy settings, then try again.` | [Authentication](#bedrock-setup-verification-timed-out-waiting-for-aws) |
+| `Could not load the default credentials` on Google Cloud's Agent Platform | [Authentication](#could-not-load-aws-or-google-cloud-credentials) |
+| `Unable to connect to API` | [Network](#unable-to-connect-to-api) |
+| `Connection refused —` / `Can't reach the API server —` / `No internet route —` / `Couldn't connect through your proxy` / `Connection dropped`, cada um com um código de erro entre parênteses | [Network](#unable-to-connect-to-api) |
+| `Unable to connect to Anthropic services` durante a configuração | [Network](#unable-to-connect-to-anthropic-services) |
+| `Socket is closed` | [Network](#socket-is-closed) |
+| `Waiting for API response · will retry in` | [Automatic retries](#automatic-retries), ou [Network](#unable-to-connect-to-api) se persistir |
+| `API returned an empty or malformed response` | [Network](#api-returned-an-empty-or-malformed-response) |
+| `Streaming response ended before any complete data was received` | [Network](#streaming-response-ended-before-any-complete-data-was-received) |
+| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Network](#bedrock-streaming-response-has-an-unexpected-content-type) |
+| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |
+| `SSL certificate error (...)` durante login ou inicialização | [Network](#ssl-certificate-errors) |
+| `unable to get local issuer certificate` | [Network](#ssl-certificate-errors) |
+| `403` com `x-deny-reason: host_not_allowed` em uma sessão de nuvem ou rotina | [Network](#host-not-allowed-in-a-cloud-session) |
+| `proxy refused the connection` | [Network](#the-proxy-refused-the-connection) |
+| `403` com `This GraphQL query is not enabled for this session` em uma sessão de nuvem | [GitHub proxy](/docs/pt/cloud-environments#github-proxy) |
+| `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) |
+| `Couldn't reconnect to your Remote Control session` | [Network](#couldnt-reconnect-to-your-remote-control-session) |
+| `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) |
+| `Couldn't share the transcript.` | [Network](#couldnt-share-the-transcript) |
+| `Prompt is too long` / `Input is too long for requested model` | [Request errors](#prompt-is-too-long) |
+| `Prompt is too long · automatic compaction failed:` | [Request errors](#prompt-is-too-long) |
+| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Request errors](#prompt-is-too-long) |
+| `Context limit reached · /compact or /clear to continue` | [Request errors](#prompt-is-too-long) |
+| `Context limit reached · /clear to continue` | [Request errors](#prompt-is-too-long) |
+| `capability_rejected: prompt_too_long` em uma sessão de gateway de aplicativos Claude | [Request errors](#prompt-is-too-long) |
+| `upstream rejected the request` / `request too large for this upstream` em uma sessão de gateway de aplicativos Claude | [Upstream error messages](/docs/pt/claude-apps-gateway-config#upstream-error-messages) |
+| `upstream rate limit exceeded` em uma sessão de gateway de aplicativos Claude | [Upstream error messages](/docs/pt/claude-apps-gateway-config#upstream-error-messages) |
+| `all upstreams failed (N attempted)` em uma sessão de gateway de aplicativos Claude | [Upstream error messages](/docs/pt/claude-apps-gateway-config#upstream-error-messages) |
+| `Claude Code may not be enabled for your organization` após um login de gateway de aplicativos Claude | [Claude apps gateway troubleshooting](/docs/pt/claude-apps-gateway-deploy#troubleshooting) |
+| `Context exceeds the ...-token limit by ... tokens` na saída `/context` | [Request errors](#context-exceeds-the-token-limit) |
+| `Error during compaction: Conversation too long` | [Request errors](#error-during-compaction-conversation-too-long) |
+| `Request too large` | [Request errors](#request-too-large) |
+| `Request too large for the API's 32MB request limit` | [Request errors](#request-too-large) |
+| `Image was too large` | [Request errors](#image-was-too-large) |
+| `Unable to resize image` | [Request errors](#unable-to-resize-image) |
+| `PDF too large` / `PDF is password protected` | [Request errors](#pdf-errors) |
+| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |
+| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |
+| `There's an issue with the selected model` | [Request errors](#theres-an-issue-with-the-selected-model) |
+| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |
+| `Model ... not found` | [Request errors](#model-not-found) |
+| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |
+| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |
+| `Claude Code ... is older than the minimum version required by your organization's policy` | [Request errors](#claude-code-does-not-support-this-model) |
+| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organizations-settings) |
+| `Model switch ... blocked by a PreModelSwitch hook` | [Request errors](#model-switch-was-blocked-by-a-premodelswitch-hook) |
+| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Request errors](#couldnt-save-it-as-your-default) |
+| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |
+| `Effort '' isn't available with thinking turned off on this model` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |
+| `effort '' is not supported when thinking is disabled` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |
+| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |
+| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |
+| `API Error: 400 orphaned tool_result in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |
+| `API Error: 400 duplicate tool_use ID in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |
+| `[Unsupported tool content removed]` | [Request errors](#unsupported-tool-content-removed) |
+| `role 'system' must precede an 'assistant' message` | [Request errors](#role-system-must-precede-an-assistant-message) |
+| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Request errors](#invalid-encrypted-content-in-search-result-block) |
+| `server_tool_use.name: Input should be` em cada turno de uma sessão retomada | [Request errors](#unsupported-tool-content-removed) |
+| ` can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |
+| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |
+| `'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
+| `Opus 5.5's safeguards flagged this session` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
+| ` has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
+| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |
+| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
+| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
+| `--bg and --print conflict` | [Command-line errors](#command-line-errors) |
+| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
+| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
+| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
+| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#command-line-errors) |
+| `Error: Invalid --agents configuration:` | [Command-line errors](#invalid-agents-configuration) |
+| `Error: Settings file exceeds the 2MiB limit` | [Command-line errors](#settings-file-exceeds-the-2mib-limit) |
+| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Command-line errors](#the-current-directory-no-longer-exists) |
+| `Temp directory ... Refusing to use it` / `ENOSPC: no space left on device, mkdir ''` | [Command-line errors](#temp-directory-refused-or-cannot-be-created) |
+| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [Command-line errors](#directory-couldnt-be-resolved-to-a-real-location) |
+| `Error: Workspace not trusted` ao iniciar Remote Control | [Command-line errors](#workspace-not-trusted-when-starting-remote-control) |
+| `` `` 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) |
+| `` `claude import` is not yet available in this build `` | [Command-line errors](#claude-import-is-not-yet-available-in-this-build) |
+| `Could not read Claude Code config` | [Command-line errors](#could-not-read-claude-code-config) |
+| `Could not import : ` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |
+| `Cannot add MCP server to scope: managed` | [Command-line errors](#cannot-add-mcp-server-to-the-managed-scope) |
+| `is Anthropic-hosted and doesn't support local OAuth` | [Command-line errors](#anthropic-hosted-and-doesnt-support-local-oauth) |
+| `Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes` | [Command-line errors](#cant-read-mcp-json) |
+| `Server rejected the Authorization header minted by the configured headersHelper` | [Command-line errors](#server-rejected-the-authorization-header-minted-by-the-configured-headershelper) |
+| `Error: MCP tool (passed via --permission-prompt-tool) not found` | [Command-line errors](#mcp-permission-prompt-tool-not-found) |
+| `OAuth callback port is already in use — another process may be holding it` | [Command-line errors](#oauth-callback-port-is-already-in-use) |
+| `No available ports for OAuth redirect` | [Command-line errors](#no-available-ports-for-oauth-redirect) |
+| `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) |
+| `Shell command permission check failed for pattern "..."`, de um skill que injete contexto dinâmico | [Command-line errors](#security-review-fails-without-origin-head) |
+| ``Skill requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Command-line errors](#security-review-fails-without-origin-head) |
+| `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) |
+| `Error: Input contained only whitespace` | [Command-line errors](#input-contained-only-whitespace) |
+| `Blank prompt — the message was only whitespace, so nothing was sent to the model.` | [Command-line errors](#input-contained-only-whitespace) |
+| `Error: stream-json input carried over 256M characters with no newline` | [Command-line errors](#stream-json-input-carried-over-256m-characters-with-no-newline) |
+| `Unknown command: /`, com ou sem uma sugestão `Did you mean` | [Command-line errors](#unknown-command) |
+| `Diff is too large for ultrareview` / `PR # is too large for ultrareview` | [Command-line errors](#diff-is-too-large-for-ultrareview) |
+| `Could not find merge-base with ` | [Command-line errors](#could-not-find-merge-base-with-the-base-branch) |
+| `Your checkout has no branches (detached HEAD only)` | [Command-line errors](#your-checkout-has-no-branches) |
+| `Ultrareview clones / in the cloud with the GitHub account connected to your Claude account, and none is connected` | [Command-line errors](#no-github-account-is-connected-to-your-claude-account) |
+| `Your connected GitHub account can't see /` | [Command-line errors](#your-connected-github-account-cant-see-the-repository) |
+| `The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead` | [Command-line errors](#the-github-app-preflight-failed-transiently) |
+| `GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud` | [Command-line errors](#github-isnt-connected-to-your-claude-account) |
+| `Single sign-on authorization needed` | [Command-line errors](#single-sign-on-authorization-needed) |
+| `Failed to resume the conversation` | [Command-line errors](#failed-to-resume-the-conversation) |
+| `No conversation found with session ID: ` | [Command-line errors](#no-conversation-found-with-the-session-id) |
+| `Cannot switch renderers in this session` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
+| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
+| `Couldn't open Claude Desktop` | [Command-line errors](#couldnt-open-claude-desktop) |
+| `Failed to open Claude Desktop. Please try opening it manually.` | [Command-line errors](#couldnt-open-claude-desktop) |
+| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |
+| `Your Zed keymap isn't a readable list of keybindings` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |
+| `Skill usage reports are not available on this connection.` | [Command-line errors](#skill-usage-reports-are-not-available-on-this-connection) |
+| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Command-line errors](#custom-output-styles-cant-be-selected-over-remote-control) |
+| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |
+| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |
+| `Marketplace "" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |
+| `Marketplace "" is already added from a different source` | [Plugin errors](#marketplace-is-already-added-from-a-different-source) |
+| `"" is another spelling of "", a reserved marketplace name` | [Plugin errors](#marketplace-name-is-another-spelling-of-a-reserved-name) |
+| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |
+| `Monitor "" from plugin references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |
+| `headersHelper for MCP server '' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |
+| `Plugin archive integrity check failed` | [Plugin errors](#plugin-archive-integrity-check-failed) |
+| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |
+| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |
+| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
+| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
+| `Failed to load marketplace configuration` | [Plugin errors](#failed-to-load-marketplace-configuration) |
+| `Marketplace configuration file is corrupted` | [Plugin errors](#failed-to-load-marketplace-configuration) |
+| `Plugin "@synced" is required by your organization and can't be disabled here` | [Plugin errors](#plugin-is-required-by-your-organization) |
+| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |
+| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |
+| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |
+| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |
+| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |
+| `Failed to write to 's inbox — nothing was sent` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
+| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
+| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |
+| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |
+| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |
+| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Tool errors](#refusing-to-send-a-cross-session-message) |
+| `Refusing to send: connected endpoint is not the expected process` / `Refusing to send: connected endpoint identity could not be read` | [Tool errors](#refusing-to-send-a-cross-session-message) |
+| `Refusing to send: connected endpoint is not owned by this user` / `Refusing to send: connected endpoint owner could not be read` | [Tool errors](#refusing-to-send-a-cross-session-message) |
+| `Refusing to send: connected endpoint is a different process with the expected pid` | [Tool errors](#refusing-to-send-a-cross-session-message) |
+| `Refusing to read : its symlink resolution changed after permission was checked ()` / `Refusing to search : its symlink resolution changed after permission was checked` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `Refusing to write : its parent-directory symlink resolution changed after permission was checked` / `Refusing to write : it is a symbolic link. Write to the link's target path instead` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `Refusing to write through symlink: ` / `Refusing to write into symlinked directory: ` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `Refusing to search : a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search : it could not be opened` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `task output swap refused (tasks dir moved or linked)` | [Tool errors](#task-output-swap-refused) |
+| `Command killed: its output file was replaced or could no longer be verified` | [Tool errors](#task-output-swap-refused) |
+| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
+| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
+| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |
+| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |
+| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Tool errors](#webfetch-cannot-fetch-localhost) |
+| `Can't open MCP settings while no terminal is attached to this background session` | [Background session errors](#commands-refused-in-a-background-session) |
+| `Can't open MCP settings in a background session` | [Background session errors](#commands-refused-in-a-background-session) |
+| `blocked because the path is spelled in a form that cannot be safely resolved` | [Background session errors](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |
+| `blocked because the path is network-shaped` | [Background session errors](#write-or-command-blocked-because-the-path-names-a-network-location) |
+| `is isolated in the worktree , but this command . Refusing to run it` | [Background session errors](#command-blocked-by-the-worktree-isolation-checks) |
+| `too complex to verify that it stays inside the worktree` | [Background session errors](#command-blocked-by-the-worktree-isolation-checks) |
+| `This session has no saved transcript` | [Background session errors](#this-session-has-no-saved-transcript) |
+| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |
+| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |
+| `This session's saved conversation is no longer on disk` | [Background session errors](#this-sessions-saved-conversation-is-no-longer-on-disk) |
+| `kept — its worktree is still at ` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
+| `kept — unpushed commits on ` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
+| `kept — worktree has commits that are not pushed anywhere` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
+| `terminal host process died — press Enter to restart` / `This session's terminal host process died` | [Background session errors](#terminal-host-process-died) |
+| `Session isn't responding` / `Press enter again to restart this session — it isn't responding` | [Background session errors](#session-isnt-responding) |
+| `Session was stopped while the respawn was in flight` | [Background session errors](#session-was-stopped-while-the-respawn-was-in-flight) |
+| `This session was running agent '', which is no longer available` | [Background session errors](#session-agent-no-longer-available) |
+| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |
+| `EUNKNOWN: unknown error, uv_spawn` | [Background session errors](#eunknown-when-starting-a-background-session) |
+| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |
+| `exited before it became reachable` | [Background session errors](#background-service-exited-before-it-became-reachable) |
+| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Background session errors](#working-directory-no-longer-exists-when-starting-a-background-session) |
+| `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) |
+| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |
+| `The connection to Claude Code ended before this message completed` | [Wrapper and IDE errors](#the-connection-to-claude-code-ended-before-this-message-completed) |
+| `Could not locate the Claude CLI on PATH` | [Wrapper and IDE errors](#could-not-locate-the-claude-cli-on-path) |
+| `Restored the code, but skipped N files` | [Rewind warnings and errors](#restored-the-code-but-skipped-files) |
+| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind warnings and errors](#no-files-were-restored) |
+| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |
+| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |
+| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |
+| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Configuration warnings](#fullscreen-failed-start-notice) |
+| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |
+| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |
+| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |
+| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |
+| `Remote managed settings failed to load ()` | [Configuration warnings](#remote-managed-settings-failed-to-load) |
+| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |
+| `MCP server is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |
+| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |
+| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |
+| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |
+| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |
+| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |
+| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |
+| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |
+| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |
+| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |
+| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |
+| `Stale sandbox mask files left by a killed session` | [Configuration warnings](#stale-sandbox-mask-files-left-by-a-killed-session) |
+| As respostas parecem ter qualidade inferior ao normal | [Response quality](#responses-seem-lower-quality-than-usual) |
Tentativas automáticas
-O Claude Code tenta novamente falhas transitórias antes de mostrar um erro. Erros de servidor, respostas sobrecarregadas, tempos limite de solicitação, throttles 429 temporários e conexões perdidas são todos repetidos até 10 vezes com backoff exponencial. A partir da v2.1.198, isso cobre conexões que caem no meio de uma resposta antes de qualquer saída visível ter sido transmitida: Claude Code re-emite a solicitação com o mesmo backoff e o turno continua em vez de parar com um erro de conexão. A partir da v2.1.199, throttles 429 temporários que não carregam os cabeçalhos de cota do seu plano também são repetidos quando você está conectado com uma assinatura claude.ai; versões anteriores os repetiam apenas para autenticações de chave de API e Enterprise.
+Claude Code tenta novamente falhas transitórias até 10 vezes com backoff exponencial antes de mostrar um erro. Nem sempre tenta novamente uma falha que chega no meio da resposta do Claude. Quando você vê um dos erros nesta página, Claude Code já fez as tentativas que se aplicam a essa falha; as listas abaixo dizem quais falhas recebem o orçamento completo, quais recebem um menor e quais não recebem nenhum.
-Algumas classes de falha não são repetidas, porque uma tentativa não pode ter sucesso:
+Claude Code tenta novamente estas falhas:
-* A partir da v2.1.199, uma falha de validação de certificado TLS, como um proxy que inspeciona TLS, um pacote `NODE_EXTRA_CA_CERTS` ausente ou um certificado expirado, falha na primeira tentativa para que a correção apareça imediatamente em vez de após o orçamento de tentativa completo. Consulte [Erros de certificado SSL](#ssl-certificate-errors). Condições TLS transitórias, como um tempo limite de handshake, ainda são repetidas.
-* A partir da v2.1.199, um erro de servidor que chega depois que Claude já transmitiu saída visível mantém a resposta parcial e anexa um [aviso de resposta incompleta](#the-response-above-may-be-incomplete) em vez de tentar novamente, já que re-executar a solicitação poderia executar as mesmas chamadas de ferramentas duas vezes. Versões anteriores descartavam a saída parcial e relatavam o turno como um erro.
-* Uma [resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado](#bedrock-streaming-response-has-an-unexpected-content-type) falha na primeira tentativa, porque o gateway ou proxy reescrevendo a resposta reescreveria a tentativa da mesma forma. Requer Claude Code v2.1.208 ou posterior.
+* Erros de servidor, respostas sobrecarregadas e timeouts de solicitação que chegam antes de qualquer parte da resposta do Claude ter sido transmitida.
+* 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.
+* 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`.
+* 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`.
+* 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.
+* 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).
+ * 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.
+* 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:
+ * Quando nenhuma redução pode caber, por exemplo quando a conversa em si quase preenche a janela de contexto.
+ * 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.
+* 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.
+* 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.
-Enquanto tenta novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y` após um rótulo de erro. O rótulo nomeia a razão específica da primeira tentativa para falhas em que você pode agir imediatamente: a rede está inativa, um handshake TLS falhou ou você atingiu um limite de taxa. Para outros erros, ele lê `API error` no início. A partir da v2.1.198, ele muda para a razão específica da terceira tentativa, ou na tentativa final quando `CLAUDE_CODE_MAX_RETRIES` permite menos de três; versões anteriores mudam apenas na tentativa final.
+Antes 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`.
-A partir da v2.1.198, a dica de spinner usual é suprimida durante tentativas. Uma vez que a razão do erro é revelada, se a falha for uma sobrecarga 529, a linha abaixo da contagem regressiva também nomeia onde verificar o status do serviço: `status.claude.com` na API Anthropic, ou o host do provedor ou gateway nomeado na mensagem em outras configurações.
+Claude Code não tenta novamente estas falhas:
-Se nenhum dado chegar no fluxo de resposta por 20 segundos enquanto uma solicitação ainda está pendente, o spinner mostra `Waiting for API response · will retry in … · check your network` antes de qualquer tentativa ter começado. A solicitação ainda não falhou: a contagem regressiva é executada até o ponto em que Claude Code interrompe a conexão travada e tenta novamente, portanto o banner desaparece por conta própria assim que os dados retomam ou a tentativa é bem-sucedida. A partir da v2.1.185, o limite é de 20 segundos; versões anteriores mostram o banner após 10 segundos com uma redação diferente. Se reaparecer em cada tentativa, trate-o como um [problema de rede](#unable-to-connect-to-api).
+* 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.
+* 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.
+* 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.
+* 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.
+* 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.
+* 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.
-Quando você vê um dos erros nesta página, essas tentativas já foram esgotadas, a menos que pertença a uma classe que não é repetida, como uma falha de validação de certificado. Você pode ajustar o comportamento com estas variáveis de ambiente:
+
+ O que você vê enquanto Claude Code tenta novamente ou aguarda
+
+
+Ao 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.
+
+A partir da v2.1.198, a dica de spinner usual é suprimida durante tentativas. Uma vez que a razão do erro é revelada, se a falha é 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.
+
+Se nenhum dado chegar no fluxo de resposta por 20 segundos enquanto uma solicitação ainda está pendente, o spinner mostra `Waiting for API response · will retry in … · check your network` antes de qualquer tentativa ter começado. A solicitação ainda não falhou: a contagem regressiva é executada até o ponto 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:
+
+* 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.
+* 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á.
+* Depois que Claude terminou a resposta, Claude Code encerra a rodada normalmente.
+
+O 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.
+
+Enquanto 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.
+
+
+ Ajustar comportamento de tentativa
+
+
+Você pode ajustar o comportamento de tentativa com estas variáveis de ambiente:
| Variável | Padrão | Efeito |
-| :------------------------------------------- | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [`CLAUDE_CODE_MAX_RETRIES`](/docs/pt/env-vars) | 10 | Número de tentativas de repetição. Limitado a 15 a partir da v2.1.186; a partir da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Reduza-o para expor falhas mais rapidamente em scripts. |
-| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/pt/env-vars) | não definido | Defina como `1` em sessões autônomas, como trabalhos de CI, para repetir erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. A partir da v2.1.199, também aumenta a contagem de tentativas padrão para outros erros transitórios, como erros de servidor, tempos limite e conexões perdidas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. |
-| [`API_TIMEOUT_MS`](/docs/pt/env-vars) | 600000 | Tempo limite por solicitação em milissegundos. Aumente-o para redes lentas ou proxies. |
+| :---------------------------------------------------- | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`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. |
+| [`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. |
+| [`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). |
+| [`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). |
Erros do servidor
-Esses erros vêm do provedor de inferência em vez de sua conta ou solicitação. Na API Anthropic, isso significa infraestrutura Anthropic. No Amazon Bedrock, na Agent Platform do Google Cloud, no Microsoft Foundry ou em um gateway personalizado, significa a infraestrutura desse provedor.
+A maioria desses erros vem do provedor de inferência: o serviço da Anthropic na API Anthropic e o serviço por trás do endpoint desse provedor no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway personalizado. [Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) e [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) também cobrem causas do seu lado, como uma conta Amazon Bedrock que não consegue invocar o modelo classificador ou um subagent que atingiu um limite de uso.
API Error: 500 Internal server error
@@ -135,7 +388,7 @@ Claude Code mostra o código de status e a mensagem de erro da API para qualquer
API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.
```
-A frase final nomeia onde verificar a saúde do serviço e varia por provedor. As configurações do Amazon Bedrock, da Agent Platform do Google Cloud e do Microsoft Foundry nomeiam a página de status desse provedor. Um `ANTHROPIC_BASE_URL` personalizado nomeia o host do gateway.
+A frase final nomeia onde verificar a saúde do serviço e varia por provedor. As configurações do Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry nomeiam a página de status desse provedor. Um `ANTHROPIC_BASE_URL` personalizado nomeia o host do gateway.
Isso indica uma falha inesperada dentro da API. Não é causado pelo seu prompt, configurações ou conta.
@@ -143,7 +396,7 @@ Isso indica uma falha inesperada dentro da API. Não é causado pelo seu prompt,
* Verifique [status.claude.com](https://status.claude.com) ou a página de status do provedor nomeada na mensagem para incidentes ativos
* Aguarde um minuto e envie sua mensagem novamente. Sua mensagem original ainda está na conversa, então para um prompt longo você pode digitar `try again` em vez de colar tudo novamente.
-* Se o erro persistir sem nenhum incidente postado, execute `/feedback` para que Anthropic possa investigar com os detalhes da sua solicitação. Consulte [Report an error](#report-an-error) se `/feedback` não estiver disponível no seu ambiente.
+* Se o erro persistir sem nenhum incidente postado, execute `/feedback` para que a Anthropic possa investigar com os detalhes da sua solicitação. Veja [Report an error](#report-an-error) se `/feedback` não estiver disponível no seu ambiente.
API Error: Repeated 529 Overloaded errors
@@ -182,49 +435,94 @@ Isso pode acontecer durante períodos de alta carga ou quando o modelo está ger
* Tente novamente a solicitação
* Para tarefas de longa duração, divida o trabalho em prompts menores
* Se uma rede lenta ou proxy for a causa, aumente `API_TIMEOUT_MS` conforme descrito em [Automatic retries](#automatic-retries)
-* Se os tempos limite forem frequentes e sua rede estiver saudável, consulte [Network and connection errors](#network-and-connection-errors) abaixo
+* Se os tempos limite forem frequentes e sua rede estiver saudável, veja [Network and connection errors](#network-and-connection-errors) abaixo
+
+
+ No response from API
+
+
+Claude 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).
+
+```text theme={null}
+API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.
+```
+
+Claude Code define o tempo de espera para cabeçalhos de resposta da primeira tentativa e a espera da tentativa novamente separadamente:
+
+* **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.
+* **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.
+
+Nenhuma 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.
+
+**O que fazer:**
+
+* Envie sua mensagem novamente. Sua mensagem original ainda está na conversa, então para um prompt longo você pode digitar `try again` em vez de colar tudo novamente.
+* Se se repetir, trate como um [problema de rede ou proxy](#unable-to-connect-to-api). Um proxy que aceita a conexão e nunca encaminha a solicitação produz este erro em cada tentativa.
+* 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.
+* 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.
+
+Antes 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.
The response above may be incomplete
-Uma resposta de streaming falhou depois que Claude já havia produzido saída visível. Reenviar a solicitação pode executar as mesmas chamadas de ferramenta duas vezes, então Claude Code mantém o que já foi transmitido e anexa este aviso em vez de descartar a vez. Qual variante você vê nomeia a causa:
+Uma solicitação de streaming falhou enquanto a resposta ainda estava em andamento, depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou havia iniciado um após terminar seu pensamento. Reenviar a solicitação pode executar as mesmas chamadas de ferramenta duas vezes, então Claude Code mantém a saída que Claude completou e anexa este aviso em vez de descartar o turno. Qual variante você vê nomeia a causa:
```text theme={null}
API Error: Server error mid-response. The response above may be incomplete.
-API Error: Connection closed mid-response. The response above may be incomplete.
-API Error: Response stalled mid-stream. The response above may be incomplete.
+API Error: Connection lost mid-response. The response above may be incomplete.
+API Error: Your computer went to sleep mid-response. The response above may be incomplete.
+API Error: The response stopped arriving. The response above may be incomplete.
```
-* `Server error mid-response`: um erro de servidor sobrecarregado ou 5xx no meio do stream. Esta variante requer Claude Code v2.1.199 ou posterior; antes disso, esse caso descartava a saída parcial e relatava toda a vez como um erro.
-* `Connection closed mid-response`: a conexão foi interrompida.
-* `Response stalled mid-stream`: o stream parou de enviar dados.
+* `Server error mid-response`: um erro de servidor sobrecarregado ou 5xx no meio do fluxo. Esta variante requer Claude Code v2.1.199 ou posterior; antes disso, esse caso descartava a saída parcial e relatava todo o turno como um erro.
+* `Connection lost mid-response`: a conexão foi interrompida.
+* `Your computer went to sleep mid-response`: Claude Code detectou que seu computador entrou em modo de suspensão enquanto a resposta estava sendo transmitida. Depois que seu computador acordar, Claude Code trata a conexão como quebrada e para de ler dela.
+* `The response stopped arriving`: a conexão permaneceu aberta mas parou de entregar dados, então o watchdog de inatividade de streaming a abortou. Antes da v2.1.222, Claude Code também poderia relatar essa falha em conexões de [gateway](/docs/pt/gateways) alcançadas através de `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL` enquanto os pings de keep-alive do servidor ainda estavam chegando, porque contava apenas eventos de resposta analisados lá; atualizar para a versão mais recente interrompe esses tempos limite espúrios nessas rotas. Gateways alcançados através de uma URL de base de provedor como `ANTHROPIC_BEDROCK_BASE_URL` não são envolvidos pelo watchdog de byte; veja [Streaming idle watchdogs](/docs/pt/network-config#streaming-idle-watchdogs).
+
+Antes da v2.1.227, `Connection lost mid-response` lia `Connection closed mid-response` e `The response stopped arriving` lia `Response stalled mid-stream`.
+
+Em quatro casos, Claude Code lida com a falha sem mostrar este aviso imediatamente:
+
+* Anteriormente na resposta, Claude Code ou tenta novamente a falha ou termina o turno com um erro diferente. Veja [Automatic retries](#automatic-retries).
+* Quando uma dessas falhas chega depois que Claude terminou a resposta, Claude Code mantém a resposta completa e termina o turno normalmente, sem este aviso. Antes da v2.1.222, Claude Code mostrava este aviso quando a conexão era interrompida ou travava após a resposta terminar, e relatava o turno como um erro mesmo que a resposta fosse completa.
+* Em uma [sessão não interativa](/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.
+* 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.
**O que fazer:**
-* Leia a resposta que foi transmitida. Nada foi perdido, mas as frases finais ou chamadas de ferramenta podem estar faltando.
-* Responda com `continue` para que Claude continue de onde parou
-* Se o mesmo erro aparecer antes de qualquer saída visível, Claude Code tenta novamente a solicitação em vez de finalizá-la. Consulte [Automatic retries](#automatic-retries).
+* Em uma sessão interativa, leia a resposta que permanece na tela: Claude Code mantém cada bloco que Claude completou antes do erro, mas descarta um bloco final interrompido quando o turno termina, então as frases ou chamadas de ferramenta finais podem estar faltando. Responda com `continue` para que Claude retome seu último bloco completado.
+* Em [modo não interativo](/docs/pt/headless) (`-p`):
+ * Com a saída de texto padrão, Claude Code imprime o último bloco de texto completado que ainda mantém de antes no turno, seguido por esta mensagem. Quando não mantém nenhum, Claude Code imprime apenas esta mensagem, por exemplo porque Claude Code compactou a conversa no meio do turno e limpou esse texto. Antes da v2.1.219, Claude Code imprimia apenas esta mensagem na saída de texto `-p` e descartava a resposta que já havia produzido.
+ * Com `--output-format json` ou `stream-json`, Claude Code relata esta mensagem no campo `result`.
+ * Para continuar o turno uma vez que a conexão esteja estável, retome a sessão e envie `continue` conforme descrito em [Continue conversations](/docs/pt/headless#continue-conversations).
Auto mode cannot determine the safety of an action
-O modelo que [auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) usa para classificar ações não conseguiu produzir uma decisão, então o auto mode não aprovou a ação automaticamente. A mensagem que você vê depende de por que o classificador falhou.
+O modelo que [auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) usa para classificar ações não conseguiu produzir uma decisão, então auto mode não aprovou a ação automaticamente. A mensagem que você vê depende de como o classificador falhou.
-Leituras, buscas e edições dentro do seu diretório de trabalho ignoram o classificador, então elas continuam funcionando em todos esses casos.
+Leituras, buscas e edições dentro do seu diretório de trabalho pulam o classificador, então continuam funcionando em todos esses casos.
-Quando o modelo classificador está sobrecarregado:
+Quando o modelo classificador está indisponível:
```text theme={null}
- is temporarily unavailable, so auto mode cannot determine the safety of right now. Wait briefly and then try this action again.
+ is temporarily unavailable, so auto mode cannot determine the safety of right now. Wait a moment and then try this action again.
```
+Quando Claude Code pode determinar a categoria de falha, ele nomeia a categoria entre parênteses após `temporarily unavailable`, por exemplo ` is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of right now`. As categorias são `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` e `(connection failed)`. Taxa limitada, sobrecarregado e erros de servidor são transitórios, e tentar novamente funciona. Se `(timed out)` ou `(connection failed)` se repetir, verifique sua conexão; veja [Unable to connect to API](#unable-to-connect-to-api). Antes da v2.1.229, a mensagem nunca nomeava uma categoria e lia `Wait briefly and then try this action again`.
+
+Quando nenhuma categoria se encaixa, a mensagem aparece sem categoria entre parênteses; mais de uma falha produz essa forma. No [Amazon Bedrock](/docs/pt/amazon-bedrock), incluindo o [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint), também aparece quando sua conta AWS não consegue invocar o modelo nomeado na mensagem, e essa falha se repete em cada tentativa até que sua conta receba acesso ao modelo.
+
**O que fazer:**
-* Tente novamente após alguns segundos; Claude vê a mesma mensagem e geralmente tenta novamente por conta própria
+* Tente novamente após alguns segundos; Claude vê a mesma mensagem e geralmente tenta novamente por conta própria. Uma falha transitória não está relacionada à [elegibilidade de auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode); você não precisa alterar configurações
* Se as tentativas continuarem falhando, continue com tarefas somente leitura e volte à ação bloqueada mais tarde
-* Isso é transitório e não relacionado à [auto mode eligibility](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode); você não precisa alterar as configurações
+* No Amazon Bedrock, se a mensagem retornar em cada tentativa, verifique se sua conta pode invocar o modelo que ela nomeia: para modelos padrão do Amazon Bedrock, confirme que sua [política IAM](/docs/pt/amazon-bedrock#iam-configuration) permite invocá-lo; para IDs de modelo Mantle, [entre em contato com sua equipe de conta AWS](/docs/pt/amazon-bedrock#mantle-endpoint-errors)
+
+Quando uma solicitação de classificador falha porque seu token OAuth expirou ou foi rotacionado por outra sessão, Claude Code atualiza o token e tenta novamente a solicitação uma vez, então uma expiração de token rotineira não aparece como esta mensagem. Antes da v2.1.216, um token expirado ou rotacionado falhava em cada solicitação de classificador, e auto mode negava cada ação verificada com esta mensagem até que o token fosse atualizado.
Quando o classificador retornou uma resposta não analisável:
@@ -234,7 +532,7 @@ Auto mode could not evaluate this action and is blocking it for safety — run w
**O que fazer:**
-* Tente novamente a ação; isso geralmente funciona na próxima tentativa
+* Tente novamente a ação; isso geralmente tem sucesso na próxima tentativa
* Execute `claude --debug` e repita a ação para ver a resposta do classificador subjacente no log de depuração
Quando uma verificação de segurança de API separada bloqueou a solicitação do classificador por causa do conteúdo anterior da conversa:
@@ -243,11 +541,19 @@ Quando uma verificação de segurança de API separada bloqueou a solicitação
Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details
```
+Claude Code nega a ação mas diz a Claude que isso não é um julgamento de que a ação é insegura, e continuar com outras tarefas em vez de tentar novamente. Essas negações não contam para [limites de pausa de auto mode](/docs/pt/permission-modes#when-auto-mode-falls-back). Em uma execução [`-p` não interativa](/docs/pt/headless), Claude Code não interrompe a execução. O que Claude recebe depende de onde solicitou a ação:
+
+* Para um [subagent em segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) em uma execução `-p` sem `--input-format stream-json`, Claude Code retorna um resultado de erro contendo `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode`
+* Em todos os outros lugares, incluindo sessões interativas e a conversa principal de uma execução `-p`, Claude Code retorna essa negação a Claude
+
+Antes da v2.1.225, Claude Code contava essas recusas para os limites de pausa e retornava a mesma mensagem de rejeição que um bloco de classificador genuíno.
+
**O que fazer:**
-* Isso não é uma decisão sobre sua ação. O conteúdo já em sua conversa acionou um filtro de segurança na API quando o auto mode enviou a conversa para o classificador
-* Tentar novamente não ajudará; o mesmo conteúdo da conversa acionará o filtro novamente
-* Mude para um [permission mode](/docs/pt/permission-modes) diferente para que você possa aprovar a ação quando solicitado, ou inicie uma conversa nova sem o conteúdo que acionou
+* Isso não é uma decisão sobre sua ação. O conteúdo já em sua conversa acionou um filtro de segurança na API quando auto mode enviou a conversa para o classificador
+* Tentar novamente não ajudará; o mesmo conteúdo de conversa acionará o filtro novamente
+* Em uma sessão interativa, mude para um [modo de permissão](/docs/pt/permission-modes) diferente para que você possa aprovar a ação quando solicitado
+* Inicie uma conversa nova sem o conteúdo acionador
Quando a conversa cresceu além da janela de contexto do classificador:
@@ -255,18 +561,55 @@ Quando a conversa cresceu além da janela de contexto do classificador:
Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
```
-Em uma sessão interativa, o auto mode volta a um prompt de permissão normal para essa ação para que você possa aprová-la ou negá-la manualmente. No [non-interactive mode](/docs/pt/headless) a execução é abortada porque a transcrição só cresce e tentar novamente não pode ter sucesso.
+O que acontece com a ação depende de onde Claude a solicitou:
+
+* Em uma sessão interativa, auto mode volta para um prompt de permissão normal para essa ação para que você possa aprová-la ou negá-la manualmente
+* Para um [subagent em segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) em uma execução [`-p` não interativa](/docs/pt/headless) sem `--input-format stream-json`, Claude Code retorna um resultado de erro contendo `Agent aborted: auto mode classifier transcript exceeded context window in headless mode`, e a execução continua
+* Em outro lugar em uma execução `-p` sem um [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags), não há prompt para voltar, então a ação não é executada e a execução continua
+
+**O que fazer:**
+
+* Em uma sessão interativa, aprove ou negue a ação no prompt que aparece
+* Em uma sessão interativa, execute `/compact` para reduzir o tamanho da conversa para que ações subsequentes se encaixem novamente na janela do classificador
+
+
+ The server returned no safety verdict
+
+
+Sob [revisão de classificador do lado do servidor](/docs/pt/permission-modes#server-side-classifier-review), auto mode nega uma ação quando o servidor não dá um veredicto para ela. A negação nomeia uma categoria entre parênteses quando Claude Code pode determinar uma, como `(timed out)`:
+
+```text theme={null}
+The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of .
+```
+
+O 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.
+
+Após dez respostas seguidas sem veredicto, auto mode interrompe o turno:
+
+```text theme={null}
+Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.
+```
+
+A mensagem de parada aparece em um lugar diferente em cada tipo de sessão:
+
+* Em uma sessão interativa, a mensagem aparece como um aviso na transcrição e o turno termina
+* Em uma execução [`-p` não interativa](/docs/pt/headless), a execução termina e relata um erro de execução. Com a saída de texto padrão, a mensagem é impressa em stderr.
+* Quando um [subagent](/docs/pt/sub-agents) atingiu o limite, o subagent para antes de terminar, e Claude recebe o que produziu com uma nota de que auto mode o interrompeu
**O que fazer:**
-* Aprove ou negue a ação no prompt que aparece
-* Execute `/compact` para reduzir o tamanho da conversa para que as ações subsequentes se encaixem novamente na janela do classificador
+* Envie outra mensagem para que Claude tente novamente. A contagem de respostas começa do zero.
+* Se a parada se repetir e suas solicitações passarem por um [gateway ou proxy LLM](/docs/pt/llm-gateway), verifique se ele corta respostas de streaming ou as reescreve. [Revisão de classificador do lado do servidor](/docs/pt/permission-modes#server-side-classifier-review) diz qual comportamento de gateway causa negações, e o [guia de compatibilidade de gateway](/docs/pt/llm-gateway-protocol#feature-pass-through) lista o que passar inalterado.
+* Defina `CLAUDE_CODE_AUTO_MODE_SERVER=0` antes de iniciar Claude Code para usar suas próprias solicitações de classificador. Antes da v2.1.281, Claude Code não lia a variável em uma conexão direta com a API Anthropic.
+* Para aprovar as ações você mesmo, [mude para fora de auto mode](/docs/pt/permission-modes#switch-permission-modes)
+
+Antes da v2.1.280, Claude Code negava cada ação de uma resposta sem veredicto imediatamente e nunca interrompia o turno.
Agent terminated early due to an API error
-A solicitação de API de um [subagent](/docs/pt/sub-agents) falhou terminalmente, por exemplo porque um limite de uso foi atingido ou as tentativas de um erro de servidor se esgotaram, então o subagent parou antes de terminar sua tarefa. Esta mensagem requer Claude Code v2.1.199 ou posterior; antes disso, o texto de erro da API era retornado para Claude como se fosse o resultado do subagent.
+A 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.
```text theme={null}
Agent terminated early due to an API error:
@@ -275,65 +618,94 @@ Agent terminated early due to an API error:
**O que fazer:**
* 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
-* Depois que o erro subjacente for resolvido, peça a Claude para tentar novamente a tarefa ou [resume the subagent](/docs/pt/sub-agents#resume-subagents)
+* 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)
-Quando uma limitação de taxa, sobrecarga ou erro de servidor interrompe um subagent em primeiro plano que já produziu saída de texto, Claude recebe essa saída parcial marcada como incompleta em vez deste erro. Um subagent cuja única saída foram chamadas de ferramenta também recebe este erro; na v2.1.199 isso retornou um resultado parcial vazio. Consulte [API errors in subagents](/docs/pt/sub-agents#api-errors-in-subagents).
+Quando 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).
Limites de uso
-Esses erros significam que uma cota vinculada à sua conta ou plano foi atingida. Eles são distintos de [erros de servidor](#server-errors), que afetam todos.
+A maioria dos erros nesta seção significa que uma cota vinculada à sua conta ou plano foi atingida. Três funcionam de forma diferente: [`Server is temporarily limiting requests`](#server-is-temporarily-limiting-requests) é um throttle do lado do servidor não relacionado à sua cota de plano, [`Usage credits required for 1M context`](#usage-credits-required-for-1m-context) é uma verificação de direito em vez de uma cota esgotada, e [`The prompt to confirm went unanswered`](#the-prompt-to-confirm-went-unanswered) significa que um prompt de consentimento de créditos de uso foi fechado sem resposta, independentemente de uma cota ter sido atingida.
- Você atingiu seu limite de sessão
+ You've hit your session limit
-Os planos de assinatura incluem uma permissão de uso contínua. Quando ela se esgota, você vê uma dessas mensagens:
+Os planos de assinatura incluem uma permissão de uso contínua. Quando ela se esgota, você vê uma destas mensagens:
```text theme={null}
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
+You've hit your Sonnet limit · resets 3:45pm
```
-Claude Code bloqueia solicitações adicionais até o horário de reset mostrado na mensagem. Os limites de sessão e semanais são compartilhados entre todos os modelos, portanto mudar de modelo não restaura o acesso. O limite de Opus se aplica apenas a solicitações de Opus, portanto mudar para outro modelo com `/model` mantém você trabalhando.
+Claude 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.
-O uso é contabilizado contra as permissões de sessão e semanais ao mesmo tempo. Uma única rajada de atividade pesada, como um grande fanout de fluxo de trabalho, pode esgotar a permissão semanal antes que a janela de sessão seja resetada.
+Em 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.
+
+O 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.
**O que fazer:**
* Aguarde o horário de reset mostrado no erro
-* Para o limite de Opus, execute `/model` e mude para outro modelo para continuar trabalhando
+* Na aba Code do [Desktop app](/docs/pt/desktop), o cartão de limite de sessão oferece uma caixa de seleção **Auto-continue when limits reset**. O cartão de limite semanal não oferece. Quando marcada, o Desktop app tenta novamente a volta interrompida após o reset e mostra o horário da tentativa no cartão. A caixa de seleção do Desktop e a configuração **Continue automatically at usage limit** da CLI em `/config` são separadas, portanto, desative cada uma por conta própria.
+* Para o limite de Opus ou Sonnet, execute `/model` e mude para um modelo fora dessa família para continuar trabalhando. Cada modelo tem seu próprio cache de prompt, portanto, a próxima solicitação relê toda a conversa sem acertos de cache; veja [Switching models](/docs/pt/prompt-caching#switching-models)
* Execute `/usage` para ver seus limites de plano e quando eles são resetados
-* Execute `/usage-credits` para comprar uso adicional em Pro e Max, ou para solicitá-lo ao seu administrador em Team e Enterprise. Consulte [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para saber como isso é cobrado.
-* Para atualizar seu plano para limites base mais altos, consulte [claude.com/pricing](https://claude.com/pricing)
+* Execute `/usage-credits` para comprar uso adicional em Pro e Max, ou para solicitá-lo ao seu administrador em Team e Enterprise. Veja [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para saber como isso é cobrado.
+* Para atualizar seu plano para limites base mais altos, veja [claude.com/pricing](https://claude.com/pricing)
-Para monitorar sua permissão restante antes de atingir o limite, adicione os campos `rate_limits` a uma [custom status line](/docs/pt/statusline#rate-limit-usage), ou no aplicativo Desktop clique no [usage ring](/docs/pt/desktop#check-usage) ao lado do seletor de modelo.
+Antes de uma janela se esgotar, Claude Code pode avisá-lo de que você usou a maior parte dela, com uma mensagem como `You've used 85% of your session limit · resets 3:45pm`. Para monitorar sua permissão restante continuamente, adicione os campos `rate_limits` a uma [custom status line](/docs/pt/statusline#rate-limit-usage), ou no Desktop app clique no [usage ring](/docs/pt/desktop#check-usage) ao lado do seletor de modelo.
- Créditos de uso necessários para contexto de 1M
+ Usage credits required for 1M context
-O modelo selecionado usa a janela de contexto estendida de 1M tokens, e seu plano inclui apenas através de créditos de uso.
+O modelo selecionado usa a janela de contexto estendido de 1M tokens, e seu plano só o inclui através de créditos de uso.
```text theme={null}
-API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context
+API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context
```
-Esta é uma verificação de direito, não um esgotamento de cota. Ela é acionada mesmo quando suas permissões de sessão e semanais têm capacidade restante. Consulte [Extended context](/docs/pt/model-config#extended-context) para saber quais planos incluem contexto de 1M diretamente e quais exigem créditos de uso.
+Esta é uma verificação de direito, não um esgotamento de cota. Ela é acionada mesmo quando suas permissões de sessão e semanal têm capacidade restante. Veja [Extended context](/docs/pt/model-config#extended-context) para saber quais planos incluem contexto de 1M diretamente e quais exigem créditos de uso. Claude Code executa essa verificação quando você escolhe o modelo com `/model`, e apenas em uma conexão direta com a API Anthropic; se você apontar `ANTHROPIC_BASE_URL` para um [LLM gateway](/docs/pt/llm-gateway), `/model` permite a seleção `[1m]` e o gateway decide se a solicitação é bem-sucedida.
-Quando esse erro aparece no meio de uma conversa porque o contexto cresceu além de 200K tokens, Claude Code compacta automaticamente a conversa de volta para o limite de contexto padrão e mantém a sessão nesse limite depois, portanto nenhuma ação é necessária. Em versões anteriores à v2.1.172, o erro se repetia em cada solicitação subsequente, incluindo `/compact`; execute `/clear` nessas versões para recuperar. As etapas abaixo se aplicam quando você selecionou explicitamente um modelo `[1m]`.
+Quando este erro aparece no meio da conversa porque o contexto cresceu além de 200K tokens, Claude Code compacta automaticamente a conversa de volta para o limite de contexto padrão e mantém a sessão nesse limite depois, portanto, nenhuma ação é necessária. Em versões anteriores à v2.1.172, o erro se repetia em cada solicitação subsequente, incluindo `/compact`; execute `/clear` nessas versões para recuperar. Os passos abaixo se aplicam quando você selecionou explicitamente um modelo `[1m]`.
**O que fazer:**
* Execute `/model` e selecione a variante sem o sufixo `[1m]` para voltar à janela de contexto padrão
-* Execute `/usage-credits` para ativar a cobrança medida para a variante 1M em Pro e Max, ou para solicitá-la ao seu administrador em Team e Enterprise
-* Se o erro persistir após `/model`, uma ID de modelo 1M pode estar definida em outro lugar. Consulte [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) para os locais de configuração a verificar em ordem de prioridade.
+* Onde a mensagem menciona `/usage-credits`, execute-a para ativar a cobrança medida para a variante 1M em Pro e Max, ou para solicitar créditos de uso ao seu administrador em Team e Enterprise. Depois que os créditos de uso estiverem ativados, reinicie Claude Code ou inicie uma nova sessão, o que a mensagem disser. Até então, a sessão permanece no limite de contexto padrão.
+* Se o erro persistir após `/model`, um ID de modelo 1M pode estar definido em outro lugar. Veja [Setting your model](/docs/pt/model-config#setting-your-model) para os locais de configuração a verificar em ordem de prioridade.
* Para remover variantes 1M do seletor de modelo completamente, defina [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/pt/env-vars)
+Antes da v2.1.268, a mensagem terminava com `run /usage-credits to turn them on, or /model to switch to standard context` e não mencionava reiniciar.
+
+
+ The prompt to confirm went unanswered
+
+
+Se sua conta exigir o [Fable usage-credits consent](/docs/pt/model-config#fable-and-usage-credits), Claude Code pede que você confirme antes de uma solicitação Fable cobrar créditos de uso. Quando ninguém responde esse prompt de consentimento em uma sessão que pode não ter ninguém em seu terminal, Claude Code fecha o prompt e encerra a volta com uma destas mensagens:
+
+```text theme={null}
+Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
+Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
+```
+
+As mensagens nomeiam o modelo Fable da sessão, portanto, em Fable 5 elas leem `continuing on Fable 5` e `Fable 5 now uses usage credits`. Antes da v2.1.257, a primeira mensagem começava `Fable 5 limit reached`.
+
+Isso acontece em sessões [Remote Control](/docs/pt/remote-control), [background sessions](/docs/pt/agent-view) e sessões de colegas de [agent team](/docs/pt/agent-teams). Claude Code mostra o prompt de consentimento apenas na visualização interativa da própria sessão: o terminal onde ela é executada, ou, para uma sessão em background, a [agents view](/docs/pt/agent-view) depois que você se conecta. Um cliente Remote Control não pode exibi-lo. Claude Code fecha o prompt no prazo [`dialogExpiry`](/docs/pt/settings-reference#dialogexpiry), cinco minutos por padrão, ou assim que um novo prompt chega enquanto ninguém digitou naquele terminal, como um prompt enviado de um cliente Remote Control. Digitar no terminal onde a sessão é executada cancela o prazo, e Claude Code aguarda sua resposta. Na visualização anexada de uma sessão em background, digitar não cancela o prazo, e um novo prompt ainda fecha o prompt de consentimento, portanto, responda antes que qualquer um deles aconteça. Claude Code não envia nada e mantém seu modelo, portanto, quando você enviar seu próximo prompt, Claude Code mostra o prompt de consentimento novamente.
+
+**O que fazer:**
+
+* No terminal onde a sessão é executada, envie outro prompt e responda o prompt de consentimento quando ele reaparecer. Para uma sessão em background, anexe-a primeiro da [agents view](/docs/pt/agent-view). Reenviar de um cliente Remote Control mostra esta mensagem novamente, porque o cliente não pode exibir o prompt.
+* Execute `/model` para mudar para um modelo que não cobra créditos de uso
+* Para dar a si mesmo mais tempo para alcançar aquele terminal, defina [`dialogExpiry`](/docs/pt/settings-reference#dialogexpiry) para um valor mais longo ou `"never"`
+
+Antes da v2.1.236, esta mensagem não aparecia: enquanto um cliente Remote Control estava conectado, Claude Code aguardava 60 segundos por uma resposta e depois continuava a volta em seu modelo padrão.
+
- O servidor está limitando temporariamente as solicitações
+ Server is temporarily limiting requests
A API aplicou um throttle de curta duração que não está relacionado à sua cota de plano.
@@ -342,37 +714,86 @@ A API aplicou um throttle de curta duração que não está relacionado à sua c
API Error: Server is temporarily limiting requests (not your usage limit)
```
-Claude Code diferencia esses dos seus limites de plano pela ausência dos cabeçalhos de cota unificados que uma resposta de limite real carrega. A partir da v2.1.199 isso é [retentado automaticamente](#automatic-retries) com backoff antes de ser mostrado, independentemente de como você se autentica. Em versões anteriores, uma sessão conectada com uma assinatura claude.ai falhou a vez na primeira ocorrência; apenas autenticações de chave de API e Enterprise a retentaram.
+Claude Code diferencia estes da sua cota de plano pela ausência dos cabeçalhos de cota unificada que uma resposta de limite real carrega. A partir da v2.1.199, isto é [retried automatically](#automatic-retries) com backoff antes de ser mostrado, independentemente de como você se autentica. Em versões anteriores, uma sessão conectada com uma assinatura claude.ai falhava na volta na primeira ocorrência; apenas as entradas de chave API e Enterprise a retentavam.
**O que fazer:**
-* Aguarde um pouco e tente novamente
+* Aguarde brevemente e tente novamente
* Verifique [status.claude.com](https://status.claude.com) se persistir
- Solicitação rejeitada (429)
+ Request rejected (429)
-Você atingiu o limite de taxa configurado para sua chave de API, projeto Amazon Bedrock ou projeto Google Cloud.
+Você atingiu o limite de taxa configurado para sua chave API, projeto Amazon Bedrock ou projeto Google Cloud.
```text theme={null}
API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.
```
-A frase final nomeia onde verificar a saúde do serviço e varia por provedor. Amazon Bedrock, Agent Platform do Google Cloud e configurações Microsoft Foundry nomeiam o status de serviço desse provedor em vez da página de status do Anthropic. Um `ANTHROPIC_BASE_URL` personalizado nomeia o host do gateway.
+A frase final nomeia onde verificar a saúde do serviço e varia por provedor. Amazon Bedrock, Agent Platform do Google Cloud e configurações Microsoft Foundry nomeiam o status do serviço daquele provedor em vez da página de status Anthropic. Um `ANTHROPIC_BASE_URL` personalizado nomeia o host do gateway.
**O que fazer:**
-* Execute `/status` e confirme que a credencial ativa é a que você espera. Um `ANTHROPIC_API_KEY` deslocado em seu ambiente pode rotear solicitações através de uma chave de nível baixo em vez de sua assinatura.
+* Execute `/status` e confirme que a credencial ativa é a que você espera. Um `ANTHROPIC_API_KEY` perdido em seu ambiente pode rotear solicitações através de uma chave de nível inferior em vez de sua assinatura.
* Verifique seu console de provedor para os limites ativos e solicite um nível mais alto se necessário
-* Para chaves de API do Anthropic, consulte a [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) para saber como os níveis funcionam e como definir limites por workspace
-* Reduza a concorrência: diminua [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/pt/env-vars), evite executar muitos subagentes paralelos, ou mude para um modelo menor com `/model` para execuções de script de alto volume
+* Para chaves API Anthropic, veja a [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) para saber como os níveis funcionam e como definir limites por workspace
+* Reduza a concorrência: diminua [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/pt/env-vars), evite executar muitos subagentos paralelos, ou mude para um modelo menor com `/model` para execuções de script de alto volume
+
+
+ You've hit your monthly spend limit
+
+
+O uso incluído do seu plano não pode cobrir esta solicitaçã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 solicitação é uma que apenas créditos de uso pagam, como uma solicitação para um modelo que [bills to usage credits](/docs/pt/model-config#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 a cobrança:
+
+```text theme={null}
+You've hit your monthly spend limit · raise it at claude.ai/settings/usage
+You've hit your individual spend limit · ask your admin for a higher limit
+You've hit your org's monthly spend limit · visit claude.ai/admin-settings/usage to raise it
+You've hit your team's shared budget · ask your admin to raise it at claude.ai/admin-settings/usage
+You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings
+```
+
+`team's shared budget` é um orçamento agrupado que um administrador atribuiu a um grupo ao qual você pertence; a mensagem não nomeia o grupo. `channel's monthly spend limit` é o orçamento do único canal Slack em que a sessão é executada, portanto, sua organização ainda pode ter orçamento fora dele.
+
+Quando uma das janelas do seu plano é o que se esgotou, a mensagem também diz quando essa janela é resetada, por exemplo `· your session limit resets 3:45pm`, e o acesso retorna então sem que ninguém aumente o limite. Em organizações com cobrança baseada em uso, a mensagem diz `usage limit` em vez de `spend limit`, como em `You've hit your individual usage limit`.
+
+Antes da v2.1.239, a mensagem não nomeava o horário de reset da janela do plano. Antes da v2.1.268, o orçamento agrupado de um grupo produzia a mensagem `individual spend limit` em vez de `team's shared budget`.
+
+Se você se conectar através de um gateway de aplicativos Claude e vir `spend limit reached` em minúsculas, esse é o limite do seu operador de gateway; veja [Spend limit reached](#spend-limit-reached).
+
+**O que fazer:**
+
+* Em Pro e Max, aumente seu limite de gastos mensais em [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai, ou execute `/usage-credits`
+* Em Team e Enterprise, aumente o limite em [**Admin settings > Usage**](https://claude.ai/admin-settings/usage) se você gerencia a cobrança, ou peça a um administrador. `/usage-credits` envia essa solicitação ao seu administrador para você
+* Para o limite de um canal, peça a um proprietário da organização ou ao gerenciador do canal para aumentá-lo em claude.ai. Veja [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) na documentação Claude Tag
+* Se a mensagem nomear um horário de reset para a janela do seu plano, você pode aguardar em vez disso
+* Execute `/usage` para ver as janelas do seu plano e quando cada uma é resetada
+
+
+ Spend limit reached
+
+
+Você se conecta através de um [Claude apps gateway](/docs/pt/claude-apps-gateway) e passou por um [spend cap](/docs/pt/claude-apps-gateway-spend-limits) que seu operador de gateway definiu. O gateway bloqueia suas solicitações até que o período nomeado seja resetado ou o operador aumente o limite. Ele marca cada resposta `429` bloqueada com `x-should-retry: false`, portanto, Claude Code mostra esta mensagem sem tentar novamente.
+
+```text theme={null}
+spend limit reached (daily; resets 2026-08-09 00:00 UTC)
+```
+
+A mensagem nomeia o período do limite e o horário de reset, e quando o operador configurou um `blocked_message`, suas instruções o seguem. Antes da v2.1.225, a mensagem lia apenas `spend limit reached`; um gateway em uma versão mais antiga ainda envia essa forma mais curta.
+
+**O que fazer:**
+
+* Aguarde o horário de reset que a mensagem nomeia, ou siga as instruções do operador se a mensagem as carregar
+* Peça ao seu operador de gateway para aumentar o limite se você o atingir rotineiramente
+
+Uma mensagem relacionada, `spend limit unavailable`, significa que o gateway não conseguiu ler seus registros de gastos e bloqueou a solicitação como precaução em vez de sobre seu limite. Geralmente se limpa por conta própria; se persistir, informe seu operador de gateway.
- Saldo de crédito muito baixo
+ Credit balance is too low
-Sua organização Console ficou sem créditos pré-pagos.
+Sua organização Console ficou sem créditos pré-pagos, ou Claude Code está enviando suas solicitações com uma chave API Console quando você pretendia usar sua assinatura.
```text theme={null}
Credit balance is too low
@@ -380,9 +801,27 @@ Credit balance is too low
**O que fazer:**
-* Adicione créditos em [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considere ativar o auto-reload lá para que o saldo seja recarregado antes de chegar a zero
-* Mude para autenticação de assinatura com `/login` se você tiver um plano Pro, Max, Team ou Enterprise
-* Defina limites de gastos por workspace no Console para evitar que um único projeto drene o saldo da organização. Consulte [Manage costs effectively](/docs/pt/costs).
+* Se você tem um plano Pro, Max, Team ou Enterprise e vê isso, execute `/status` e verifique a linha `API key`. Um `ANTHROPIC_API_KEY` aprovado em seu ambiente roteia solicitações através dessa chave em vez de sua assinatura. Desdefina-o no shell atual e remova-o do seu perfil de shell, depois relance `claude`. Execute `/login` se você ainda não se conectou com sua assinatura.
+* Adicione créditos em [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considere ativar o auto-reload lá para que o saldo seja recarregado antes de atingir zero
+* Defina limites de gastos por workspace no Console para evitar que um único projeto drene o saldo da organização. Veja [Manage costs effectively](/docs/pt/costs).
+
+
+ Could not update your spend limit
+
+
+O servidor rejeitou uma alteração de limite de gastos que você fez a partir do prompt que aparece quando você atinge seu limite de gastos.
+
+```text theme={null}
+Could not update your spend limit:
+```
+
+Quando o servidor explica a rejeição, a mensagem termina com essa razão, e tentar novamente o mesmo valor falha novamente. Quando a falha não tem razão fornecida pelo servidor, como uma conexão perdida, a mensagem lê `Could not update your spend limit. Press Enter to retry.` e tentar novamente pode ter sucesso. Antes da v2.1.216, Claude Code mostrava a forma genérica para cada falha.
+
+**O que fazer:**
+
+* Se a mensagem incluir uma razão, escolha um limite que a satisfaça, como um valor menor
+* Se a mensagem mostrar apenas a forma genérica, tente novamente; a falha pode ser transitória
+* Se a alteração continuar falhando, faça-a a partir de suas [claude.ai billing settings](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) no navegador em vez disso
Erros de autenticação
@@ -404,93 +843,142 @@ Not logged in · Please run /login
* Execute `/login` para autenticar com sua assinatura Claude ou conta Console
* Se você esperava que uma variável de ambiente o autenticasse, confirme que `ANTHROPIC_API_KEY` está definida e exportada no shell onde você iniciou `claude`
-* Para CI ou automação onde login interativo não é possível, configure um script [`apiKeyHelper`](/docs/pt/settings#available-settings) que busque uma chave na inicialização
+* Para CI ou automação onde login interativo não é possível, configure um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) que busque uma chave na inicialização
* Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) para entender qual credencial Claude Code usa quando várias estão presentes
-Se você for solicitado a fazer login repetidamente, consulte [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para correções de relógio do sistema e Keychain do macOS.
+Se você for solicitado a fazer login repetidamente, consulte [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para verificações de relógio do sistema e etapas de recuperação de armazenamento de credenciais do macOS.
Não foi possível resolver o método de autenticação
-A sessão chegou ao cliente da API sem nenhuma credencial. Isso aparece em [sessões em segundo plano](/docs/pt/agent-view), sessões em nuvem e contextos do Agent SDK onde a verificação de login interativo não é executada antes da primeira solicitação.
+A 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 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 esta string apenas no log de depuração, portanto, se você a encontrou lá, siga essa entrada.
```text theme={null}
Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
```
-Antes da v2.1.174, uma sessão em segundo plano ou em nuvem atribuída a um worker pré-inicializado ocioso poderia falhar dessa forma mesmo quando credenciais válidas foram configuradas. Atualize para recuperar. Nas versões atuais, o erro significa que nenhuma credencial estava disponível para o processo do worker.
+Nas 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 na nuvem que ficou ociosa antes de ser reivindicada também poderia. Atualize para recuperar.
**O que fazer:**
-* Atualize para v2.1.174 ou posterior se isso aparecer em uma sessão em segundo plano ou em nuvem e suas credenciais já estiverem configuradas
+* Atualize para v2.1.176 ou posterior se isso aparecer em uma sessão em segundo plano ou na nuvem e suas credenciais já estiverem configuradas
* Confirme que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou suas credenciais do provedor de nuvem estão definidas no ambiente que inicia o worker, não apenas no seu shell interativo
-* Para o Agent SDK, consulte [configuração de autenticação](/docs/pt/agent-sdk/overview#get-started)
+* Para o Agent SDK, consulte [configuração de autenticação no guia de início rápido](/docs/pt/agent-sdk/quickstart#setup)
* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida
Chave de API inválida
-A variável de ambiente `ANTHROPIC_API_KEY` ou o script `apiKeyHelper` retornou uma chave que a API rejeitou.
+A 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.
```text theme={null}
Invalid API key · Fix external API key
```
+Quando 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. Consulte [Valor de cabeçalho de solicitação inválido](#invalid-request-header-value) para saber como ler a descrição e corrigir o valor.
+
**O que fazer:**
* Verifique se há erros de digitação e confirme que a chave não foi revogada no [Console](https://platform.claude.com/settings/keys)
-* Execute `env | grep ANTHROPIC` no mesmo shell. Ferramentas como direnv, plugins de shell dotenv e terminais IDE podem carregar uma chave obsoleta de um arquivo `.env` em seu projeto sem você defini-la explicitamente.
+* 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.
* Desdefina `ANTHROPIC_API_KEY` e execute `/login` para usar autenticação de assinatura
-* Se a chave vem de um script [`apiKeyHelper`](/docs/pt/settings#available-settings), execute o script diretamente para confirmar que ele imprime uma chave válida em stdout
+* 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 stdout
* Execute `/status` para confirmar qual fonte de credencial Claude Code está realmente usando
Seu script apiKeyHelper está falhando
-O comando configurado na configuração [`apiKeyHelper`](/docs/pt/settings#available-settings) saiu com um erro, expirou ou não imprimiu nada em stdout. Sem uma chave do script, a solicitação chega à API com uma credencial de espaço reservado, e a API a rejeita com `401`.
+Claude 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 destes aconteceu:
+
+* O comando saiu com um erro ou expirou
+* O comando não imprimiu nada em stdout
+* O comando imprimiu algo além da chave, como um banner de login ou uma linha de log. O painel mostra `returned output that cannot be used as an API key` e 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.
```text theme={null}
Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
```
-Claude Code executa novamente o script e tenta novamente a solicitação até mais duas vezes antes de mostrar esta mensagem, portanto a falha aparece dentro de três tentativas. Antes da v2.1.208, Claude Code gastava o [orçamento de tentativas](#automatic-retries) completo reenviando a solicitação com a credencial de espaço reservado e depois relatava um erro de autenticação `401` genérico em vez da falha do script.
+Em [modo não interativo](/docs/pt/headless), stderr também carrega o motivo específico, prefixado com `apiKeyHelper failed:`.
+
+Claude Code executa novamente o script e tenta a solicitação até mais duas vezes antes de mostrar esta mensagem, portanto a falha aparece dentro de três tentativas. Antes da v2.1.208, Claude Code gastava o [orçamento de retry](#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.
Executar `/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.
**O que fazer:**
* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha
-* Se o comando relatar uma sessão expirada, autentique-se novamente com seu provedor de credenciais, por exemplo, fazendo login novamente em seu SSO ou cofre de segredos
-* Corrija o comando para que ele imprima a chave em stdout e saia com código 0. Consulte [girar credenciais com apiKeyHelper](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para uma configuração funcionando.
-* Execute `/status` para confirmar que `apiKeyHelper` é a fonte de credencial ativa. Cada vez que o comando falha, seu código de saída e saída de erro aparecem em um painel `Cloud authentication` no terminal.
+* Se o comando relatar uma sessão expirada, autentique-se novamente com seu provedor de credencial, por exemplo, fazendo login em seu SSO ou cofre de segredos novamente
+* 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. Consulte [girar credenciais com apiKeyHelper](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para uma configuração funcional.
+* Execute `/status` para ver a falha e confirmar que `apiKeyHelper` é a fonte de credencial ativa. A linha `apiKeyHelper` mostra `Failing` com o detalhe da última falha, como o código de saída e a saída de erro do comando, e desaparece após a próxima execução bem-sucedida. Antes da v2.1.274, `/status` mostrava apenas a fonte de credencial, não a falha.
+* Cada vez que o comando falha, seu código de saída e saída de erro também aparecem em um painel `Authentication` no terminal. Antes da v2.1.212, o painel era intitulado `Cloud authentication`.
+
+
+
+Um 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.
+
+Claude 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.
+
+```text theme={null}
+Invalid auth token · Fix external auth token
+Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
+Invalid request header from the environment · Fix the environment variable
+```
+
+A primeira parte da mensagem depende de onde o valor ruim veio:
+
+* `Invalid auth token`: um token de portador de [`ANTHROPIC_AUTH_TOKEN`](/docs/pt/env-vars) ou [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars)
+* `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` está em falta, como `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, sem repetir o nome ou valor, já que você escolheu ambos.
+* `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.
+
+Claude 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); 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).
+
+Após o segundo `·`, a mensagem descreve o problema, como neste exemplo completo:
+
+```text theme={null}
+Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).
+```
+
+As 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. Ele 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`.
+
+**O que fazer:**
+
+* 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 novamente
+* Para `ANTHROPIC_CUSTOM_HEADERS`, mantenha um par `Name: Value` por linha e reescreva o par que a mensagem conta
+* Execute `/status` para confirmar qual fonte de credencial está ativa
Esta organização foi desabilitada
-Uma `ANTHROPIC_API_KEY` obsoleta de uma organização Console desabilitada está substituindo seu login de assinatura.
+Claude 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.
```text theme={null}
-Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
+Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
+Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.
```
-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. No modo não interativo (`-p`), a chave é sempre usada quando presente.
+A 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.
+
+As 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 funcional. Em modo não interativo (`-p`), a chave é sempre usada quando presente.
**O que fazer:**
* Desdefina `ANTHROPIC_API_KEY` no shell atual e remova-a do seu perfil de shell, depois reinicie `claude`
+* Se a mensagem disser `Update or unset`, você não tem login salvo para recorrer. Desdefina a chave e execute `/login`, ou substitua a chave por uma de uma organização Console ativa.
* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura
-* Se nenhuma variável de ambiente estiver definida e o erro persistir, a organização desabilitada é aquela vinculada ao seu `/login`. Entre em contato com o suporte ou faça login com uma conta diferente.
+* Se nenhuma variável de ambiente estiver definida e o erro persistir, a organização desabilitada é a vinculada ao seu `/login`. Entre em contato com o suporte ou faça login com uma conta diferente.
Sua organização desabilitou a autenticação por chave de API
-Esta 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 dependendo de onde a chave veio:
+Esta mensagem requer Claude Code v2.1.169 ou posterior. O administrador da sua organização Console desativou 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 dependendo de onde a chave veio:
```text theme={null}
Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
@@ -499,12 +987,12 @@ Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
```
-Variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, portanto executar `/login` sozinho não ajuda enquanto qualquer um deles ainda estiver fornecendo uma chave. Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence).
+As variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, portanto executar `/login` sozinho não ajuda enquanto qualquer um deles ainda estiver fornecendo uma chave. Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence).
**O que fazer:**
-* Se a mensagem mencionar `ANTHROPIC_API_KEY`, desdefina-a no shell atual e remova-a do seu perfil de shell ou arquivo `.env`, depois reinicie `claude`
-* Se a mensagem mencionar `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/docs/pt/settings#available-settings) do seu `settings.json`
+* 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`
+* Se a mensagem nomear `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) do seu `settings.json`
* Execute `/login` para fazer login com sua conta claude.ai
* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API
* Se você precisar de autenticação por chave de API para automação, peça ao administrador da sua organização para reabilitá-la no Console
@@ -513,882 +1001,3923 @@ Variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, portan
Sua organização desabilitou o acesso à assinatura Claude
-Sua 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.
+Sua organização Claude não permite fazer login em Claude Code com um login de assinatura. Executar `/login` novamente com a mesma conta retorna o mesmo erro.
```text theme={null}
Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
```
-Esta é uma configuração de organização no lado do servidor, portanto não pode ser substituída por configurações locais, variáveis de ambiente ou sinalizadores CLI.
+Esta é 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.
O Agent SDK e o modo não interativo `-p` apresentam isso como o código de erro `oauth_org_not_allowed`.
**O que fazer:**
-* Peça ao seu administrador para habilitar o acesso ao Claude Code para sua organização
+* Peça ao seu administrador para habilitar o acesso a Claude Code para sua organização
* Autentique-se com uma chave de API do Console em vez de sua assinatura. Consulte [Autenticação do Claude Console](/docs/pt/authentication#claude-console-authentication) para configuração.
-* Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com [suporte da Anthropic](https://support.claude.com)
+* 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)
Rotinas são desabilitadas pela política da sua organização
-Um Proprietário em sua organização Team ou Enterprise desabilitou rotinas no nível da organização. O erro aparece quando você tenta criar ou executar uma rotina, incluindo de `/schedule` e da interface de [Rotinas](/docs/pt/routines) em claude.ai/code.
+Um Proprietário em sua organização Team ou Enterprise desativou rotinas no nível da organização. O erro aparece quando você tenta criar ou executar uma rotina, por exemplo, da [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) no CLI.
```text theme={null}
Routines are disabled by your organization's policy.
```
-Esta é uma configuração no lado do servidor, portanto não pode ser substituída por configurações locais, variáveis de ambiente ou sinalizadores CLI.
+Esta é 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.
**O que fazer:**
-* 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)
+* Peça a um Proprietário em sua organização para habilitar o alternador **Routines** em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
* Para trabalho agendado único que não requer rotinas no nível da organização, consulte [tarefas agendadas](/docs/pt/scheduled-tasks)
Remote Control requer a API Anthropic
-A sessão não está se comunicando com a API Anthropic diretamente, portanto não há backend claude.ai para [Remote Control](/docs/pt/remote-control) emparelhar.
+A sessão não está falando com a API Anthropic diretamente, portanto não há backend claude.ai para [Remote Control](/docs/pt/remote-control) emparelhar.
```text theme={null}
-Remote Control is only available when using Claude via api.anthropic.com.
+Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.
```
-Isso aparece em Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry. A partir da v2.1.196, também aparece quando [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) aponta para um host diferente de `api.anthropic.com`, como um [gateway LLM](/docs/pt/llm-gateway) ou proxy, mesmo quando você faz login com claude.ai.
+Uma segunda sentença explica o que roteou a sessão para longe da API Anthropic; antes da v2.1.219, a mensagem era apenas a primeira sentença. Dependendo da causa, a mensagem nomeia:
+
+* 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)
+* [`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ê faz login com claude.ai; antes da v2.1.196, uma URL base personalizada não bloqueava Remote Control
+* `ANTHROPIC_UNIX_SOCKET` definido, portanto a sessão envia suas solicitações através de um socket local em vez de para `api.anthropic.com`
+* 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-la
**O que fazer:**
-* Desdefina `ANTHROPIC_BASE_URL` e reinicie a sessão, ou inicie Remote Control de uma sessão que se comunique com a API Anthropic diretamente
+* 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 de uma sessão que fale com a API Anthropic diretamente
+* 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ão
* Para esta e as outras mensagens de inicialização do Remote Control, consulte [Solucionar problemas do Remote Control](/docs/pt/remote-control#troubleshooting)
-
- Token OAuth revogado ou expirado
+
+ Remote Control não conseguiu atualizar seu login
-Seu 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.
+Claude 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 login salvo, Claude Code para Remote Control e precisa que você faça login novamente. Qualquer falha pode acontecer enquanto Claude Code ainda está se conectando ou depois, quando renova as credenciais.
+
+Quando Claude Code pede ao serviço de login para atualizar seu login salvo e não recebe 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 recebe 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`.
-Ambas 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) em vez disso.
+Quando 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 estas linhas:
```text theme={null}
-OAuth token revoked · Please run /login
-OAuth token has expired · Please run /login
-API Error: 401 ... authentication_error
+Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
+Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
+Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
+Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
+Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
+Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
+Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
```
+Claude Code nomeia a causa no meio da mensagem:
+
+* `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 revogado
+* `OAuth token unavailable`: Claude Code não tinha token de login salvo quando a credencial da conexão venceu para renovação
+* `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 novo
+* `JWT refresh failed: no OAuth token`: Claude Code não encontrou token de login salvo para renovar
+* `Signed out of Claude`: você saiu nesta máquina, por exemplo, executando `/logout` em outro terminal, portanto Claude Code não tem login salvo para renovar a conexão
+
**O que fazer:**
* Execute `/login` para fazer login novamente
-* Se o erro retornar na mesma sessão após autenticar novamente, execute `/logout` primeiro para limpar completamente o token armazenado, depois `/login`
-* Para prompts repetidos de login entre inicializações, consulte as verificações de relógio do sistema e Keychain do macOS em [Solução de problemas](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired)
-* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
+* 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ê faz login.
-
- Login expirado
-
+Antes 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 )`. As mensagens `Claude.ai login expired`, `Claude.ai login was rejected` e `OAuth token unavailable` foram adicionadas na v2.1.225.
-Claude Code tentou renovar seu login salvo claude.ai ou Claude Console e o serviço OAuth rejeitou o token de atualização armazenado, portanto Claude Code limpou as credenciais salvas. Depois disso, cada solicitação para localmente antes de chegar à API, porque apenas `/login` pode criar novas credenciais. Antes da v2.1.206, Claude Code enviava a solicitação mesmo assim com qualquer credencial que permanecesse no ambiente, e cada modelo então falhava com [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model) ou um 401 em vez de um prompt para fazer login.
+Antes 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 recebia resposta.
-```text theme={null}
-Login expired · Please run /login
-```
+
+ Remote Control parou porque a conta conectada mudou
+
-Em [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), a mensagem lê da seguinte forma, e o código de erro estruturado é `authentication_failed`:
+Claude Code mostra esta linha durante uma sessão [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 mudança fora da sessão Claude Code, por exemplo, executando `/login` em outro terminal.
+
+Uma sessão Remote Control que você iniciou enquanto estava conectado através de `/login` pertence à conta e organização claude.ai que estavam conectadas no momento.
```text theme={null}
-Failed to authenticate: OAuth session expired and could not be refreshed
+Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control
```
-Este não é o mesmo estado que [Token OAuth revogado ou expirado](#oauth-token-revoked-or-expired). Essas mensagens relatam um 401 que a API retornou. Claude Code em si produz `Login expired` para um login que já falhou em renovar, portanto não envia nenhuma solicitação.
-
-Sessõ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.
+Claude 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.
**O que fazer:**
-* Execute `/login` para fazer login novamente. Tentar novamente sem fazer login mostra a mesma mensagem em cada solicitação.
-* Em modo não interativo, execute `claude` no mesmo ambiente, conclua `/login`, depois execute novamente seu comando. Para automação que não consegue fazer login interativamente, autentique-se com `ANTHROPIC_API_KEY` ou [gere um token de longa duração com `claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token).
-* Se fazer login continuar falhando, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
+* Execute `/remote-control` para iniciar uma nova sessão Remote Control sob a conta ou organização atual
+* Para voltar, execute `/login` e faça login na conta ou organização anterior novamente. Depois execute `/remote-control`.
-
- Requisito de escopo OAuth
+Antes 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é uma solicitação posterior ao servidor Remote Control falhar com `Remote Control server rejected the request (HTTP 404)`. Essa falha poderia vir horas após a mudança.
+
+
+ Remote Control parou porque o aplicativo que executa a sessão saiu ou mudou de contas
-O token armazenado é anterior a um escopo de permissão que um recurso mais novo precisa. Você vê isso com mais frequência de `/usage` e do indicador de uso da linha de status:
+Quando o aplicativo de desktop Claude 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 destas linhas:
```text theme={null}
-OAuth token does not meet scope requirement: user:profile
+Remote Control stopped — the app running this session is now signed in to a different Claude account
+Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
```
+Sua sessão local continua em execução sem Remote Control.
+
**O que fazer:**
-* Execute `/login` para obter um novo token com os escopos atuais. Você não precisa fazer logout primeiro.
+* Se o aplicativo estiver desconectado, faça login nele novamente e depois ative Remote Control novamente no aplicativo
+* 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.
-
- Credenciais AWS expiradas ou inválidas
+Antes 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.
+
+
+ Token OAuth revogado ou expirado
-Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu token de sessão AWS expirou ou foi rejeitado, e a atualização automática que Claude Code já executou não produziu uma credencial que a API aceita. Aparece em um 401 de [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) ou do [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint), que é como esses provedores relatam um token de segurança expirado.
+Seu login salvo não é mais válido. Um token revogado significa que você saiu 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.
-A dica de ação no meio nomeia o comando `awsAuthRefresh` do seu arquivo de configurações, portanto varia. A parte estável é o `AWS credentials expired or invalid` inicial:
+Ambas 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ê 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.
```text theme={null}
-AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
+OAuth token revoked · Please run /login
+Please run /login · API Error: 401 OAuth token has expired ...
```
-Sem `awsAuthRefresh` configurado, o mesmo 401 mostra a mensagem genérica `Please run /login` em vez disso, que não consegue atualizar credenciais AWS.
-
**O que fazer:**
-* Execute o comando `awsAuthRefresh` nomeado na mensagem, como `aws sso login --profile myprofile`, em outro terminal e conclua o login do navegador, depois tente novamente
-* Em uma sessão interativa, execute `/login`, escolha **plataforma de terceiros**, depois selecione **Claude Platform on AWS · refresh credentials** em **Usando plataformas de terceiros** para executar o mesmo comando sem reiniciar Claude Code. Consulte [Configurar credenciais AWS](/docs/pt/claude-platform-on-aws#1-configure-aws-credentials)
-* Se o erro se repetir após o comando de atualização ter sucesso, confirme que a identidade é válida fora do Claude Code com `aws sts get-caller-identity` no mesmo shell e perfil
+* Execute `/login` para fazer login novamente
+* Se o erro retornar na mesma sessão após autenticar novamente, execute `/logout` primeiro para limpar completamente o token armazenado, depois `/login`
+* Se você 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.
+* Para prompts repetidos para fazer login entre inicializações, consulte 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)
+* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
-
- Falha na autenticação AWS
+
+ API Error: 401 Credenciais de autenticação inválidas
-Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu provedor AWS retornou um 403, ou [Amazon Bedrock](/docs/pt/amazon-bedrock) retornou um 401.
-
-Claude Code não consegue dizer qual causa você atingiu. Amazon Bedrock relata um token de segurança expirado como um 403, mas um 403 também é como ele relata uma negação de autorização, como um `AccessDeniedException` de uma permissão IAM ausente ou um modelo que não está habilitado para sua conta.
-
-Um 401 do 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 normalmente vem de algo mais no caminho da solicitação, como um proxy corporativo.
-
-Uma atualização de credencial corrige um token expirado e não consegue corrigir as outras causas, portanto a mensagem oferece ambas:
+A API reconheceu o formato de sua credencial, mas rejeitou a conta ou organização por trás dela. Anthropic retorna esta 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.
```text theme={null}
-AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
+Please run /login · API Error: 401 Invalid authentication credentials
```
-A dica de ação no meio nomeia o comando `awsAuthRefresh` do seu arquivo de configurações, portanto varia. A parte estável é o `AWS authentication failed` inicial.
-
**O que fazer:**
-* Execute o comando `awsAuthRefresh` nomeado na mensagem, ou `aws sso login`, caso uma credencial expirada seja a causa
-* Se suas credenciais estão atuais, confirme que as permissões IAM em [Configuração IAM](/docs/pt/amazon-bedrock#iam-configuration) estão anexadas à identidade que você está usando e que o modelo selecionado está habilitado para sua conta e região
-* Execute `aws sts get-caller-identity` para confirmar qual identidade suas solicitações usam; um `AWS_PROFILE` obsoleto ou perfil padrão é uma causa comum de incompatibilidade de permissão
+* Se `/status` mostrar uma linha `API key` que não esteja 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`.
+* Se `/status` mostrar apenas seu login, execute `/login` uma vez. Se a credencial foi revogada, um novo login a substitui.
+* 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.
+* Se [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) apontar para um [gateway LLM](/docs/pt/llm-gateway), o texto após `401` é a mensagem do seu gateway em vez da Anthropic, e `/login` não a altera. Corrija a credencial que seu gateway espera.
-
- Resolução de credencial da cadeia padrão AWS expirou
+
+ Login expirado
-O provedor de credencial padrão AWS não produziu credenciais dentro de 60 segundos, portanto Claude Code parou a resolução e falhou a solicitação. A falha é resolução de credencial local: a solicitação nunca chegou a [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) ou ao [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint). Claude Code limpa seu [cache de credenciais](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout) e tenta novamente antes desta mensagem de erro aparecer, portanto no momento em que você a vê a cadeia travou em tentativas repetidas.
+Claude Code tentou renovar seu login claude.ai ou Claude Console 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 esta mensagem antes de chegar à API, porque apenas `/login` pode criar novas credenciais.
+
+Antes 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 fazer login.
```text theme={null}
-API Error: AWS default-chain credential resolve timed out
+Login expired · Please run /login
```
-As causas comuns são um comando `credential_process` no seu perfil AWS que aguarda entrada que não consegue receber, e um contêiner ou VM cujo serviço de metadados de instância (IMDS) nunca responde à sonda da cadeia. Antes da v2.1.207, uma cadeia travada deixava a solicitação aguardando indefinidamente em vez de falhar com esta mensagem.
+Em [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`:
-**O que fazer:**
+```text theme={null}
+Failed to authenticate: OAuth session expired and could not be refreshed
+```
-* 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.
-* Conclua a etapa de login antes de iniciar Claude Code, por exemplo `aws sso login --profile myprofile`, para que a cadeia seja resolvida do cache SSO local em vez de aguardar um fluxo de navegador
-* Se sua cadeia executa um login interativo que legitimamente precisa de mais de 60 segundos, como SSO com MFA através de um wrapper como `aws-vault`, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars)
+Este 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 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).
-
- Erros de rede e conexão
-
+Sessõ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.
-Esses erros significam que uma solicitação de rede do Claude Code falhou ao atingir seu destino, ou algo entre Claude Code e a API alterou a resposta no caminho de volta. Geralmente originam-se em sua rede local, proxy ou firewall, ou na política de rede do ambiente em nuvem.
+Você pode verificar este 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 indicação neste estado de que um login já havia existido, porque a credencial limpa deixou nada para relatar.
-
- Não é possível conectar à API
+**O que fazer:**
+
+* Execute `/login` para fazer login novamente. Tentar novamente sem fazer login mostra a mesma mensagem em cada solicitação.
+* Em modo não interativo, execute `claude` no mesmo ambiente, complete `/login`, depois execute novamente seu comando. Para automação que não consegue fazer login interativamente, autentique com `ANTHROPIC_API_KEY` ou [gere um token de longa duração com `claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token).
+* Se fazer login continuar falhando, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
+
+
+ Login Claude não aceito
-A conexão TCP com a API falhou ou nunca foi concluída.
+Você tentou iniciar uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), e o servidor recusou 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.
+
+A primeira parte da linha é o próprio motivo do servidor quando ele fornece um. Caso contrário, a linha lê:
```text theme={null}
-Unable to connect to API. Check your internet connection
-Unable to connect to API (ECONNREFUSED)
-Unable to connect to API (ECONNRESET)
-Unable to connect to API (ETIMEDOUT)
-fetch failed
-Request timed out. Check your internet connection and proxy settings
+Claude login not accepted · Run /login, then try again
```
-As causas comuns incluem falta de acesso à internet, uma VPN que bloqueia `api.anthropic.com`, ou um proxy corporativo necessário que não está configurado.
-
**O que fazer:**
-* Confirme que você pode alcançar o host da API a partir do mesmo shell executando `curl -I https://api.anthropic.com`. No Windows PowerShell, use `curl.exe -I https://api.anthropic.com` para que o alias `Invoke-WebRequest` integrado não seja usado.
-* Se você estiver atrás de um proxy corporativo, defina `HTTPS_PROXY` antes de iniciar Claude Code e consulte [Configuração de rede](/docs/pt/network-config)
-* Se você rotear através de um gateway LLM ou relay, defina [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) para seu endereço. Consulte [Conectar Claude Code a um gateway LLM](/docs/pt/llm-gateway-connect) para configuração.
-* Certifique-se de que seu firewall permite os hosts listados em [Requisitos de acesso à rede](/docs/pt/network-config#network-access-requirements)
-* Falhas intermitentes são [retentadas automaticamente](#automatic-retries); falhas persistentes apontam para um problema de rede local
-
-Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:
-
-* No Linux e WSL, verifique `/etc/resolv.conf` para um nameserver inacessível. WSL em particular pode herdar um resolver quebrado do host.
-* No macOS, um cliente VPN que foi desconectado ou desinstalado pode deixar uma interface de túnel ou regra de roteamento para trás. Verifique `ifconfig` para interfaces `utun` obsoletas e remova a extensão de rede da VPN em Configurações do Sistema.
-* Docker Desktop e runtimes de contêiner similares podem interceptar tráfego de saída. Saia deles e tente novamente para descartar isso.
+* Execute `/login`, complete o login e tente iniciar a sessão novamente
-
- Resposta de streaming do Bedrock tem um content-type inesperado
+
+ Artefatos precisam de um login claude.ai
-Um gateway ou proxy entre Claude Code e [Amazon Bedrock](/docs/pt/amazon-bedrock) está transformando o corpo da resposta de streaming ou seu cabeçalho `Content-Type`. Amazon Bedrock transmite respostas como `application/vnd.amazon.eventstream`, e Claude Code rejeita uma resposta de streaming bem-sucedida que relata um content-type diferente em vez de decodificar um corpo que não consegue ler. A solicitação não é retentada.
+Claude Code recusou uma publicação ou leitura de [artefato](/docs/pt/artifacts) porque a sessão não tem login claude.ai que possa usar para artefatos.
+
+Cada forma da mensagem começa com as mesmas palavras, seguida por um remédio que depende de como sua sessão se autentica. Sem credencial concorrente, lê:
```text theme={null}
-Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
+Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.
```
-Antes da v2.1.208, a mesma configuração incorreta aparecia como `API Error: Truncated event message received` após toda a resposta ter sido armazenada em buffer.
-
**O que fazer:**
-* Configure o gateway para passar o corpo da resposta `InvokeModelWithResponseStream` e seu cabeçalho `Content-Type` sem modificações. Um intermediário que re-emite o stream como server-sent events é uma causa comum.
-* Se o gateway reescrever apenas o cabeçalho e passar o corpo binário intacto, defina [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/pt/env-vars) para pular a verificação até que o gateway seja corrigido. Consulte [Erros de streaming atrás de um gateway ou proxy](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
+* Execute `/login` e selecione **Claude account with subscription**. A opção **Anthropic Console account** não fornece credenciais claude.ai.
+* 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`
+* Quando a mensagem diz que esta sessão remota se autentica através da máquina que a iniciou, faça login em claude.ai nessa máquina e depois reconecte a sessão
+* 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.ai
+* Consulte [Disponibilidade](/docs/pt/artifacts#availability) para os outros requisitos que artefatos têm, como plano, provedor de modelo e política de organização
-
- Erros de certificado SSL
+
+ A política do administrador requer um login do Cloud gateway
-Um proxy ou dispositivo de segurança em sua rede está interceptando tráfego TLS com seu próprio certificado, e Claude Code não confia nele.
+As [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:
```text theme={null}
-Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
-Unable to connect to API: Self-signed certificate detected
+Not signed in to the Cloud gateway — run /login.
```
-A partir da v2.1.199, uma falha de validação de certificado não é retentada, portanto esse erro aparece na primeira tentativa em vez de após o [orçamento de retry](#automatic-retries) completo. Versões anteriores gastavam alguns minutos retentando antes de mostrá-lo. Condições TLS transitórias, como um timeout de handshake, ainda são retentadas.
+Solicitações de modelo falham com esta mensagem quando a sessão não tem login de gateway, por exemplo, porque você não executou `/login` desde que a política chegou à máquina.
-Durante `/login` e a verificação de conectividade de inicialização, a mesma falha é relatada com o código OpenSSL e a correção inline:
+Se você também tiver uma credencial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` configurada e as configurações gerenciadas definirem `forceLoginMethod`, Claude Code sai na inicialização com uma mensagem que começa:
```text theme={null}
-SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.
+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.
```
**O que fazer:**
-* Exporte o pacote CA da sua organização e aponte Claude Code para ele com `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
-* Consulte [Configuração de rede](/docs/pt/network-config#custom-ca-certificates) para instruções de configuração completa
-* Não defina `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desabilita a validação de certificado inteiramente
+* Execute `/login` e complete o login na tela **Cloud gateway**
+* Para a mensagem de inicialização, remova a configuração `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` que você configurou, depois inicie `claude` e execute `/login`
+* Se você acredita que a máquina não deveria exigir o gateway, peça ao administrador que a gerencia para remover `forceLoginMethod` e `forceLoginGatewayUrl` de suas configurações gerenciadas
-
- Host não permitido em uma sessão em nuvem
+Na 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 requisito de administrador na máquina. Atualize para v2.1.266 ou posterior. Você não precisa alterar sua configuração.
+
+Antes 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á.
+
+
+ Sua conta está em espera
-Uma solicitação HTTP de saída de uma sessão em nuvem ou rotina foi bloqueada pela política de rede do ambiente.
+A 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 um login que você completa no navegador a relata:
```text theme={null}
-HTTP 403
-x-deny-reason: host_not_allowed
+Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
+Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
```
-Você também pode ver um certificado TLS que não corresponde ao certificado real do destino. O ambiente em nuvem roteia o tráfego de saída através de um proxy que aplica a política de rede, portanto um certificado incompatível significa que o proxy encerrou a conexão, não o destino.
-
-Isso não é um problema de rede do lado do cliente. Sessões em nuvem e [rotinas](/docs/pt/routines) são executadas dentro de um ambiente em sandbox cuja tráfego de saída é filtrado para a lista de permissões do ambiente. O ambiente **Default** usa acesso **Trusted**, que permite a [lista de permissões padrão](/docs/pt/claude-code-on-the-web#default-allowed-domains) de registros de pacotes, APIs de provedores em nuvem, registros de contêiner e domínios de desenvolvimento comuns, mas bloqueia tudo o mais.
+Fazer login 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.
**O que fazer:**
-* Abra a rotina para edição ou inicie uma sessão em nuvem. Selecione o ícone de nuvem mostrando o nome do seu ambiente, como **Default**, para abrir o seletor. Passe o mouse sobre seu ambiente e clique no ícone de configurações.
-* Na caixa de diálogo **Update cloud environment**, altere **Network access** de **Trusted** para **Custom**, depois adicione o domínio bloqueado a **Allowed domains**. Digite um domínio por linha. Marque **Also include default list of common package managers** para manter a [lista de permissões padrão](/docs/pt/claude-code-on-the-web#default-allowed-domains) junto com seus domínios personalizados. Selecione **Full** em vez disso se quiser acesso irrestrito.
-* Clique em **Save changes**. A próxima execução usa a lista de permissões atualizada.
+* Abra o link na mensagem para visualizar os detalhes da espera ou apelá-la
+* 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`
-Consulte [Network access](/docs/pt/claude-code-on-the-web#network-access) para níveis de acesso e a lista de permissões padrão. Sessões locais de CLI não são afetadas por essa política.
-
-
- Não foi possível reconectar à sua sessão de Remote Control
+
+ Login do perfil Anthropic expirado
+Claude 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 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.
+
```text theme={null}
-Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
+Anthropic profile login expired · Re-authenticate your Anthropic profile
+Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
```
-Retomar com `claude --resume` ou `claude --continue` reconecta à sessão [Remote Control](/docs/pt/remote-control) registrada nessa conversa. Esta mensagem significa que a reconexão falhou por um motivo que pode ser temporário, como uma interrupção de rede ou um erro de servidor, portanto Claude Code não pode confirmar se a sessão remota ainda existe. Sua sessão local continua funcionando sem Remote Control.
-
-**O que fazer:**
+Isso 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ê [fez login sem uma chave de API](/docs/pt/authentication#sign-in-without-an-api-key). Sessões que se autenticam com a opção claude.ai do `/login`, uma chave de API, um token de portador como `ANTHROPIC_AUTH_TOKEN` ou um provedor de terceiros nunca veem esta mensagem.
-* Execute `/remote-control` para tentar novamente a conexão
-* Inicie Claude Code sem `--resume` para criar uma nova sessão de Remote Control
-* Para outras mensagens de inicialização do Remote Control, consulte [Troubleshoot Remote Control](/docs/pt/remote-control#troubleshooting)
+Em uma máquina que [oferece o login sem chave](/docs/pt/authentication#sign-in-without-an-api-key), execute `/login`, escolha a conta Anthropic Console e faça login novamente para renovar um perfil que o login Console sem chave ou o `ant auth login` da 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:
-Você não verá esta mensagem quando o servidor confirmar que a sessão anterior não existe mais; Claude Code cria uma nova nesse caso. Antes da v2.1.200, qualquer falha de reconexão criava uma nova sessão de Remote Control, o que deixava sessões extras na lista de sessões em claude.ai/code.
+* Quando você define `ANTHROPIC_PROFILE` explicitamente, a mensagem termina com `Re-authenticate your Anthropic profile`.
+* 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 depois 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.
-
- Erros de solicitação
-
+**O que fazer:**
-Esses erros estão relacionados ao conteúdo da sua solicitação. A maioria retorna da API após ela rejeitar a solicitação; alguns são produzidos localmente pelo Claude Code antes de qualquer solicitação ser enviada.
+* Faça login no perfil novamente, depois 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 Anthropic Console para um perfil que o login Console sem chave ou o `ant auth login` da CLI da Plataforma Claude escreveu; para outros perfis, use a ferramenta que os criou
+* Se um administrador provisionou a credencial do perfil, peça a ele para emitir uma nova
+* Execute `/status` para confirmar a fonte de credencial ativa e o nome do perfil
+* Para parar de usar o perfil, desdefina `ANTHROPIC_PROFILE` se você o definiu, depois autentique de outra forma, como `/login` ou `ANTHROPIC_API_KEY`
-
- Prompt é muito longo
+
+ Requisito de escopo OAuth
-A conversa mais os arquivos anexados excedem a janela de contexto do modelo.
+O token armazenado é anterior a um escopo de permissão que um recurso mais novo precisa. Você vê isso com mais frequência de `/usage` e o indicador de uso da linha de status:
```text theme={null}
-Prompt is too long
+OAuth token does not meet scope requirement: user:profile
```
**O que fazer:**
-* Execute `/compact` para resumir turnos anteriores e liberar espaço, ou `/clear` para começar do zero
-* Execute `/context` para ver um detalhamento do que está consumindo a janela: prompt do sistema, ferramentas, arquivos de memória e mensagens
-* Desabilite servidores MCP que você não está usando com `/mcp disable ` para remover suas definições de ferramentas do contexto
-* Reduza arquivos de memória `CLAUDE.md` grandes, ou mova instruções para [regras com escopo de caminho](/docs/pt/memory#path-specific-rules) que carregam apenas quando relevante
-* Suagentes herdam todas as definições de ferramentas MCP da sessão pai, o que pode preencher sua janela de contexto antes do primeiro turno. Desabilite servidores MCP que você não está usando antes de gerar suagentes.
-* Auto-compact está ativado por padrão e normalmente previne esse erro. Se você definiu [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars), reabilite-o ou execute `/compact` manualmente antes da janela ficar cheia.
-
-Veja [Explore the context window](/docs/pt/context-window) para uma visualização interativa de como o contexto se preenche.
+* Execute `/login` para obter um novo token com os escopos atuais. Você não precisa fazer logout primeiro.
-
- Erro durante compactação: Conversa muito longa
+
+ claude.ai rejeitou o token da sessão
-`/compact` em si falhou porque não há contexto livre suficiente para manter o resumo que produz.
+Uma 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, geralmente um login que expirou e não conseguiu ser atualizado. 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 `connected · session token rejected` e sua visualização de detalhes lê:
```text theme={null}
-Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
+claude.ai rejected the session token. Run /login, then reconnect.
```
-Isso pode acontecer quando a janela já está cheia no momento em que auto-compact é acionado, ou quando você executa `/compact` após ver `Prompt is too long`.
-
**O que fazer:**
-* Pressione Esc duas vezes para abrir a lista de mensagens e voltar vários turnos. Isso remove as mensagens mais recentes do contexto. Depois execute `/compact` novamente.
-* Se voltar não liberar espaço suficiente, execute `/clear` para iniciar uma sessão nova. Sua conversa anterior é preservada e pode ser reabierta com `/resume`.
+* Execute `/login` para fazer login novamente
+* Reconecte o conector de `/mcp`, ou execute `/mcp reconnect `. Reconectar antes de fazer login 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 ` relata uma reconexão bem-sucedida mesmo que o token ainda seja rejeitado.
-
- Solicitação muito grande
+Antes 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.
+
+
+ Servidor MCP precisa que você faça login novamente
-O corpo da solicitação bruta excedeu o limite de bytes da API antes da tokenização, geralmente por causa de um arquivo grande colado ou anexado.
+Um [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 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).
+
+Para um servidor que você faz login de Claude Code, incluindo um conector claude.ai, o login expirou ou foi revogado:
```text theme={null}
-Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.
+MCP server "" needs you to sign in again (run /mcp to re-authenticate)
```
-Este é um limite de tamanho na solicitação HTTP, separado do [limite de janela de contexto](#prompt-is-too-long).
+Execute `/mcp`, selecione o servidor e faça login novamente de seu menu.
-**O que fazer:**
+Para um servidor configurado com um script [`headersHelper`](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication), Claude Code já executou novamente o helper e tentou novamente a chamada uma vez antes de mostrar isso:
-* Pressione Esc duas vezes e volte passado o turno que adicionou o conteúdo superdimensionado
-* Referencie arquivos grandes por caminho em vez de colar seu conteúdo, para que Claude possa lê-los em pedaços
-* Para imagens, veja [Image was too large](#image-was-too-large) abaixo
+```text theme={null}
+MCP server "" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)
+```
-
- Imagem era muito grande
-
+Verifique se o helper retorna uma credencial que o servidor aceita, depois reconecte de `/mcp`, que executa o helper novamente.
+
+Para um servidor com um cabeçalho `Authorization` estático em sua configuração:
+
+```text theme={null}
+MCP server "" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
+```
+
+Atualize o valor do cabeçalho onde o servidor está configurado, depois reconecte de `/mcp`.
+
+Antes da v2.1.273, os casos de login expirado, `headersHelper` e cabeçalho `Authorization` todos mostravam `MCP server "" requires re-authorization (token expired)`.
+
+Um 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:
+
+```text theme={null}
+MCP server "" needs additional permissions (scope: "") — run /mcp to re-authenticate
+```
+
+Execute `/mcp`, selecione o servidor e autentique novamente de seu menu.
+
+Quando 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 autenticar novamente.
+
+Antes 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.
+
+
+ Incompatibilidade de emissor na resposta de autorização
+
+
+Durante um [login OAuth do 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 no login em vez de trocar o código de autorização. Claude Code mostra o erro no menu do servidor `/mcp` após o login do navegador:
+
+```text theme={null}
+Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
+```
+
+`expected` é o emissor dos metadados OAuth do servidor, e `received` é o valor `iss` que o redirecionamento carregava. Um login cujo redirecionamento não carrega 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 no login.
+
+**O que fazer:**
+
+* Tente o login novamente de `/mcp`
+* 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 metadados
+* 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 servidor
+
+Antes da v2.1.232, Claude Code usava o runtime v2 apenas em um lançamento gradual ou quando você definia `MCP_SDK_GENERATION=v2`.
+
+
+ Credenciais AWS expiradas ou inválidas
+
+
+Seu 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.
+
+A dica de ação no meio varia com sua configuração. A parte estável é o `AWS credentials expired or invalid` inicial:
+
+```text theme={null}
+AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
+```
+
+Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.
+
+**O que fazer:**
+
+* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e os outros passos aqui não se aplicam: tente novamente ou entre em contato com seu administrador
+* 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 o login do navegador, depois tente novamente. Caso contrário, atualize a credencial AWS que você usa: seu login SSO, chaves de acesso, chave de API ou token de proxy
+* 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. Consulte [Configure AWS credentials](/docs/pt/claude-platform-on-aws#1-configure-aws-credentials)
+* 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 perfil
+
+
+ Falha na autenticação AWS
+
+
+Seu provedor AWS retornou um 403, ou [Amazon Bedrock](/docs/pt/amazon-bedrock) retornou um 401.
+
+Amazon Bedrock relata um token de segurança expirado como um 403, mas um 403 também é como ele relata uma negação de autorização, como um `AccessDeniedException` de uma permissão IAM ausente. Claude Code não consegue distinguir essas duas causas.
+
+Um 401 do 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.
+
+Uma atualização de credencial corrige um token expirado e não consegue corrigir as outras causas, portanto a mensagem oferece ambas:
+
+```text theme={null}
+AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
+```
+
+A dica de ação no meio varia com sua configuração. A parte estável é o `AWS authentication failed` inicial.
+
+Quando 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 Amazon Bedrock.
+
+Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.
+
+**O que fazer:**
+
+* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e os outros passos aqui não se aplicam: tente novamente ou entre em contato com seu administrador
+* 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 seu login SSO, chaves de acesso, chave de API ou token de proxy você mesmo
+* 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ão
+* Execute `aws sts get-caller-identity` para confirmar qual identidade suas solicitações usam; um `AWS_PROFILE` obsoleto ou perfil padrão é uma causa comum de incompatibilidade de permissão
+
+
+ Credenciais do Google Cloud expiradas ou inválidas
+
+
+Suas 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.
+
+A dica de ação no meio varia com sua configuração. A parte estável é o `Google Cloud credentials expired or invalid` inicial:
+
+```text theme={null}
+Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...
+```
+
+**O que fazer:**
+
+* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e os outros passos aqui não se aplicam: tente novamente ou entre em contato com seu administrador
+* Se você se autentica 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 o login, depois tente novamente
+* Se você roteia 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 novamente
+* Se você se autentica com um arquivo de chave de conta de serviço, confirme que `GOOGLE_APPLICATION_CREDENTIALS` aponta para uma chave válida. Consulte [Configure GCP credentials](/docs/pt/google-vertex-ai#3-configure-gcp-credentials)
+* 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 shell
+
+Antes 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 credenciais do Google Cloud.
+
+
+ Falha na autenticação do Google Cloud
+
+
+[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.
+
+A dica de ação no meio varia com sua configuração. A parte estável é o `Google Cloud authentication failed` inicial:
+
+```text theme={null}
+Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...
+```
+
+**O que fazer:**
+
+* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e os outros passos aqui não se aplicam: tente novamente ou entre em contato com seu administrador
+* Confirme as funções em [Configuração IAM](/docs/pt/google-vertex-ai#iam-configuration) são concedidas à identidade com a qual você se autentica
+* Confirme que o modelo está habilitado para seu projeto. Consulte [Request model access](/docs/pt/google-vertex-ai#2-request-model-access)
+
+Antes da v2.1.273, um 403 do Agent Platform mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar credenciais do Google Cloud.
+
+
+ Falha na autenticação do Microsoft Foundry
+
+
+[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:
+
+```text theme={null}
+Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...
+```
+
+**O que fazer:**
+
+* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e os outros passos aqui não se aplicam: tente novamente ou entre em contato com seu administrador
+* Atualize a credencial que você configurou em [Configure Azure credentials](/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 fazer login novamente
+* Se a credencial está atual, confirme que a identidade tem acesso ao recurso Foundry. Consulte [Azure RBAC configuration](/docs/pt/microsoft-foundry#azure-rbac-configuration)
+
+Antes da v2.1.273, um 401 ou 403 do Microsoft Foundry mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar credenciais Azure.
+
+
+ Não foi possível carregar credenciais AWS ou Google Cloud
+
+
+Claude 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 esta 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 um login revogado relatado como `invalid_grant`:
+
+```text theme={null}
+API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
+API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
+```
+
+Em [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`.
+
+**O que fazer:**
+
+* Execute o comando de login do seu provedor, como `aws sso login --profile myprofile` ou `gcloud auth application-default login`, 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 de Claude Code
+* 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)
+
+
+ Resolução de credencial de cadeia padrão AWS expirou
+
+
+A 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 desta mensagem de erro aparecer, portanto no momento em que você a vê a cadeia travou em tentativas repetidas.
+
+```text theme={null}
+API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
+```
+
+As causas comuns são um comando `credential_process` em seu perfil AWS que aguarda entrada que não consegue receber, e um contêiner ou VM cuja instância de serviço de metadados (IMDS) nunca responde à sonda da cadeia.
+
+Antes da v2.1.267, a mensagem lia `API Error: AWS default-chain credential resolve timed out`.
+Antes da v2.1.207, uma cadeia travada deixava a solicitação esperando indefinidamente em vez de falhar.
+
+**O que fazer:**
+
+* 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.
+* Complete a etapa de login antes de iniciar Claude Code, por exemplo `aws sso login --profile myprofile`, para que a cadeia seja resolvida do cache SSO local em vez de aguardar um fluxo de navegador
+* Se sua cadeia executa um login interativo que legitimamente precisa de mais de 60 segundos, como SSO com MFA através de um wrapper como `aws-vault`, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars)
+
+
+ Tempo limite de verificação de configuração do Bedrock aguardando AWS
+
+
+Uma chamada para AWS durante o [assistente de configuração do 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 aguardar e falha a etapa de verificação:
+
+```text theme={null}
+Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.
+```
+
+O 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).
+
+As 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 aguardando entrada que você não consegue ver. Aumente o limite apenas quando o helper legitimamente precisa de mais tempo.
+
+Uma ú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:
+
+```text theme={null}
+A request to AWS timed out. Check your network and proxy settings, then try again.
+```
+
+Quando os mesmos tempos limite ocorrem na etapa de fixação de modelo, o assistente marca um modelo como `unreachable` em vez de mostrar uma das duas mensagens.
+
+**O que fazer:**
+
+* Execute `aws sts get-caller-identity` no mesmo shell. Se também travar, a travação está fora de Claude Code, em sua rede, seu proxy ou o helper de credencial em seu perfil AWS; corrija isso primeiro.
+* Complete qualquer login interativo antes de abrir o assistente, por exemplo `aws sso login --profile myprofile`
+* 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)
+
+
+ Sessão de gateway de nuvem expirada
+
+
+Você fez login 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 a [rotação do segredo JWT](/docs/pt/claude-apps-gateway-deploy#jwt-secret-rotation) do gateway. Se você vir esta linha quando inicia `claude` interativamente, a sessão abriu desconectada do gateway:
+
+```text theme={null}
+Cloud gateway session expired — run /login to reconnect.
+```
+
+A mesma linha pode aparecer no meio da sessão quando a credencial de gateway expira e Claude Code não consegue renová-la.
+
+Em 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 esta mensagem em vez disso quando o gateway não aceita mais a sessão:
+
+```text theme={null}
+Cloud gateway no longer accepts this session. Start `claude` and sign in again with /login.
+```
+
+**O que fazer:**
+
+* Execute `/login` na sessão e complete o login do navegador
+* Para um lançamento não interativo, inicie `claude` no mesmo ambiente, execute `/login`, depois execute novamente seu comando
+
+
+ Tempo limite de login enquanto aguardava você continuar
+
+
+Durante um login do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), o gateway nomeou a conta que fez login, e Claude Code pediu que você a confirmasse antes de salvar a credencial. Você deixou a confirmação aberta após a expiração do próprio login, e o gateway não emitiu token de atualização que pudesse renová-lo, portanto Claude Code não armazenou nada quando você continuou:
+
+```text theme={null}
+Sign-in timed out while waiting for you to continue. Try again.
+```
+
+**O que fazer:**
+
+* Execute `/login` novamente e confirme a conta antes do login expirar
+
+
+ Gateway recusou a solicitação
+
+
+Você 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, a recusou. Fazer login novamente não altera uma recusa, portanto a mensagem aponta para seu administrador de gateway:
+
+```text theme={null}
+Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
+```
+
+**O que fazer:**
+
+* Peça ao seu administrador de gateway para procurar a solicitação. A cauda `API Error:` carrega a recusa que o gateway retornou
+* 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 de [Mensagens de erro de upstream](/docs/pt/claude-apps-gateway-config#upstream-error-messages)
+
+Antes 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 fazer login novamente não limpava a recusa.
+
+
+ Erros de rede e conexão
+
+
+A maioria desses erros significa que uma solicitação de rede do Claude Code falhou ao alcançar seu destino, ou algo entre Claude Code e a API alterou a resposta no caminho de volta; quando uma entrada também tem uma causa local, como uma falha na escrita de arquivo, seu corpo diz isso. Geralmente originam-se em sua rede local, proxy ou firewall, ou na política de rede do ambiente de nuvem.
+
+
+ Unable to connect to API
+
+
+A conexão TCP com a API falhou ou nunca foi concluída. Para os códigos de erro de conexão comuns, o nome da mensagem indica o tipo de falha e mantém o código entre parênteses:
+
+```text theme={null}
+Unable to connect to API. Check your internet connection
+Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
+Can't reach the API server — check your internet or DNS (ENOTFOUND)
+No internet route — check your connection or VPN (EHOSTUNREACH)
+Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
+Connection dropped (ECONNRESET)
+fetch failed
+Request timed out. Check your internet connection and proxy settings
+```
+
+Um código que Claude Code não reconhece aparece como `Unable to connect to API` seguido pelo código entre parênteses. Algumas dessas mensagens podem mostrar mais de um código: `Connection refused` pode mostrar `ConnectionRefused` ou `ECONNREFUSED`, por exemplo, e `Can't reach the API server` pode mostrar `ENOTFOUND` ou `FailedToOpenSocket`.
+
+Antes da v2.1.227, cada uma dessas mensagens codificadas lia `Unable to connect to API` seguida pelo código, por exemplo `Unable to connect to API (ECONNREFUSED)`.
+
+As causas comuns incluem sem acesso à internet, uma VPN que bloqueia `api.anthropic.com`, ou um proxy corporativo necessário que não está configurado.
+
+**O que fazer:**
+
+* Confirme que você pode alcançar o host da API a partir do mesmo shell executando `curl -I https://api.anthropic.com`. No Windows PowerShell use `curl.exe -I https://api.anthropic.com` para que o alias `Invoke-WebRequest` integrado não seja usado.
+* Se você estiver atrás de um proxy corporativo, defina `HTTPS_PROXY` antes de iniciar Claude Code e veja [Network configuration](/docs/pt/network-config)
+* Se você rotear através de um gateway LLM ou relay, defina [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) para seu endereço. Veja [Connect Claude Code to an LLM gateway](/docs/pt/llm-gateway-connect) para configuração.
+* Certifique-se de que seu firewall permite os hosts listados em [Network access requirements](/docs/pt/network-config#network-access-requirements)
+* Falhas intermitentes são [retentadas automaticamente](#automatic-retries); falhas persistentes apontam para um problema de rede local
+
+Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:
+
+* No Linux e WSL, verifique `/etc/resolv.conf` para um nameserver inacessível. WSL em particular pode herdar um resolver quebrado do host.
+* No macOS, um cliente VPN que foi desconectado ou desinstalado pode deixar uma interface de túnel ou regra de roteamento para trás. Verifique `ifconfig` para interfaces `utun` obsoletas e remova a extensão de rede da VPN em Configurações do Sistema.
+* Docker Desktop e runtimes de contêiner similares podem interceptar tráfego de saída. Saia deles e tente novamente para descartar isso.
+
+
+ Unable to connect to Anthropic services
+
+
+Durante a configuração de primeira execução, Claude Code verifica se consegue alcançar `api.anthropic.com` e `platform.claude.com` antes de mostrar a etapa de login. Quando qualquer uma das verificações falha, Claude Code imprime o motivo e sai.
+
+```text theme={null}
+Unable to connect to Anthropic services
+Failed to connect to api.anthropic.com: ECONNREFUSED
+Connection to api.anthropic.com timed out after 10 seconds
+A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.
+```
+
+Claude Code envia a verificação através da mesma [proxy configuration](/docs/pt/network-config) que as solicitações de API e dá a cada sonda 10 segundos. Quando a sonda com falha passou por um proxy, a mensagem nomeia a variável de ambiente que a configurou, como `HTTPS_PROXY`. Antes da v2.1.222, a verificação usava um transporte de proxy diferente sem timeout: atrás de uma URL de proxy com o esquema `https://`, ela poderia travar em `Checking connectivity...` indefinidamente e depois falhar mesmo que as solicitações de API através do mesmo proxy funcionem.
+
+Claude Code pula essa verificação quando um [managed settings file, MDM policy, ou policy helper](/docs/pt/managed-settings) define [`forceLoginMethod`](/docs/pt/settings-reference#forceloginmethod) como `"gateway"`, ou define [`forceLoginGatewayUrl`](/docs/pt/settings-reference#forcelogingatewayurl) sem `forceLoginMethod`. Com qualquer uma das configurações, Claude Code abre a etapa de login na tela **Cloud gateway** em vez de um método de login Anthropic. Claude Code também pula a verificação quando uma fonte de configurações gerenciadas na máquina existe mas não pode ser lida, já que essa fonte pode conter a configuração do gateway. Antes da v2.1.247, Claude Code executava a verificação sob essa configuração também, e saía com esse erro quando os endpoints da Anthropic eram inacessíveis.
+
+**O que fazer:**
+
+* Se a mensagem nomear uma variável de proxy, verifique se seu valor aponta para o proxy correto e peça ao seu time de rede para permitir conexões HTTPS através dele para o host na mensagem. Veja [Network configuration](/docs/pt/network-config).
+* Trabalhe através das verificações em [Unable to connect to API](#unable-to-connect-to-api). O teste `curl` e a orientação de firewall lá se aplicam a essa verificação também.
+* Se sua organização faz login através de um [cloud gateway](/docs/pt/claude-apps-gateway) e esse erro aparece na primeira execução, atualize para Claude Code v2.1.247 ou posterior.
+* Se sua rede está aberta e a falha persiste, Claude Code pode não estar [disponível em seu país](https://www.anthropic.com/supported-countries)
+
+
+ Socket is closed
+
+
+`Socket is closed` significa que a conexão que carregava uma resposta de streaming foi fechada enquanto a resposta ainda estava chegando. A causa mais comum é um proxy corporativo no Windows descartando um túnel estabelecido no meio da resposta.
+
+Dependendo de quão longe a resposta havia progredido, Claude Code retenta a solicitação, mantém o que Claude produziu, ou encerra o turno. Veja [Automatic retries](#automatic-retries).
+
+Antes da v2.1.214, Claude Code não retentava essa falha, e o turno parava com um erro contendo `Socket is closed`.
+
+**O que fazer:**
+
+* Se você vir esse erro, atualize para v2.1.214 ou posterior com `claude update`, depois envie sua mensagem novamente
+* Se os turnos continuarem falhando atrás do mesmo proxy após atualizar, trabalhe através de [Unable to connect to API](#unable-to-connect-to-api) e verifique a configuração do proxy em [Network configuration](/docs/pt/network-config)
+
+
+
+Claude Code mostra esse erro quando sua retentativa sem streaming de uma solicitação de streaming com falha obtém um status de sucesso HTTP mas o corpo não é uma mensagem de API Claude: comumente uma página de erro HTML ou login, um corpo vazio, ou JSON em outro formato. Um proxy, gateway, ou página de login de rede respondendo no lugar da API é a fonte usual. Claude Code não retenta a solicitação, e o turno termina com esse erro.
+
+```text theme={null}
+API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.
+```
+
+Após essa abertura, a mensagem relata o que voltou e qual solicitação falhou:
+
+* Uma cláusula `Response:` com o tipo de conteúdo, o tipo de corpo, como `body is an HTML page` ou `empty body`, seu tamanho em bytes, e se a resposta carregava um id de solicitação Anthropic. Quando a resposta nomeia um servidor reconhecível, como `nginx` ou `cloudflare`, ou carrega headers intermediários, como `cf-ray` ou `via`, a cláusula lista esses também.
+* Uma sentença nomeando o id da solicitação de streaming com falha e a falha que acionou a retentativa. Quando um stream havia aberto antes da falha, também relata quantos eventos de stream chegaram e, se algum chegou, quanto tempo o stream havia ficado silencioso quando a tentativa falhou.
+
+Antes da v2.1.234, a mensagem terminava após `intercepting the request`.
+
+Antes da v2.1.271, uma resposta que carregava uma mensagem de API válida sob um tipo de conteúdo não-JSON como `text/plain` também terminava o turno com esse erro. Alguns gateways LLM usam esse tipo de conteúdo para a resposta sem streaming.
+
+**O que fazer:**
+
+* Leia a cláusula `Response:` para ver qual sistema respondeu. Um corpo HTML, nenhum id de solicitação Anthropic, ou um servidor nomeado como `nginx` ou `cloudflare` significa que algo entre Claude Code e a API respondeu em seu lugar
+* Se você rotear através de um [LLM gateway](/docs/pt/llm-gateway-connect#troubleshoot-gateway-errors), teste a rota com uma solicitação direta e corrija o hop que retorna a resposta não-API
+* Em uma rede com uma página de login, como Wi-Fi de convidado, complete o login em um navegador, depois tente novamente
+* Se apenas a rota sem streaming através de seu gateway está quebrada, defina [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1`](/docs/pt/env-vars#variables) para que uma solicitação que falha no meio do stream vá para o caminho de retentativa normal em vez desse fallback, exceto quando o endpoint de streaming em si retorna `404`, onde Claude Code ainda faz fallback
+
+
+ Streaming response ended before any complete data was received
+
+
+Uma resposta de streaming de seu provedor de modelo foi concluída sem entregar nenhum dado utilizável, então Claude Code reenviou a solicitação sem streaming para terminar o turno. Claude Code mostra o aviso uma vez por sessão, apenas em sessões interativas. Antes da v2.1.239, Claude Code retentava silenciosamente sem streaming.
+
+```text theme={null}
+Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.
+```
+
+Claude Code envia cada solicitação afetada duas vezes: a tentativa de streaming vazia e a retentativa. A causa usual é um proxy ou gateway que consome ou transforma o corpo da resposta de streaming no caminho de volta.
+
+**O que fazer:**
+
+* Configure qualquer proxy ou gateway entre Claude Code e seu provedor de modelo para passar corpos de resposta de streaming e seus headers através sem modificação
+* Em [Amazon Bedrock](/docs/pt/amazon-bedrock), veja [Streaming errors behind a gateway or proxy](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) para os requisitos de header e corpo
+
+
+ Bedrock streaming response has an unexpected content-type
+
+
+Um gateway ou proxy entre Claude Code e [Amazon Bedrock](/docs/pt/amazon-bedrock) está transformando o corpo da resposta de streaming ou seu header `Content-Type`. Amazon Bedrock transmite respostas como `application/vnd.amazon.eventstream`. Em vez de decodificar um corpo que não consegue ler, Claude Code rejeita uma resposta de streaming bem-sucedida que relata um content-type diferente. Claude Code não retenta a solicitação.
+
+```text theme={null}
+Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
+```
+
+Antes da v2.1.208, a mesma configuração incorreta aparecia como `API Error: Truncated event message received` após todo o corpo ter sido armazenado em buffer.
+
+**O que fazer:**
+
+* Configure o gateway para passar o corpo da resposta `InvokeModelWithResponseStream` e seu header `Content-Type` através sem modificação. Um intermediário que re-emite o stream como server-sent events é uma causa comum.
+* Definir [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/pt/env-vars) oculta esse erro, mas Claude Code não decodifica um corpo binário sob um header reescrito, então essas solicitações fazem fallback para um caminho sem streaming mais lento. Veja [Streaming errors behind a gateway or proxy](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
+
+
+ SSL certificate errors
+
+
+Um proxy ou appliance de segurança em sua rede está interceptando tráfego TLS com seu próprio certificado, e Claude Code não confia nele.
+
+```text theme={null}
+Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
+Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
+```
+
+Antes da v2.1.273, ambas as mensagens terminavam em `Check your proxy or corporate SSL certificates`, sem o código OpenSSL ou a dica `NODE_EXTRA_CA_CERTS`.
+
+A partir da v2.1.199, uma falha de validação de certificado não é retentada, então esse erro aparece na primeira tentativa em vez de após o [retry budget](#automatic-retries) completo. Versões anteriores gastavam alguns minutos retentando antes de mostrá-lo. Condições TLS transitórias, como um timeout de handshake, ainda retentam.
+
+Durante `/login` e a verificação de conectividade de inicialização, a mesma falha produz uma mensagem diferente:
+
+```text theme={null}
+SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.
+```
+
+Em [Amazon Bedrock](/docs/pt/amazon-bedrock), as solicitações que Claude Code em si envia para AWS, como as chamadas de credencial de função STS e SSO, descoberta de modelo, e as verificações do assistente de configuração, dependem da mesma configuração de certificado. Veja [Certificate errors behind a TLS-inspecting proxy](/docs/pt/amazon-bedrock#certificate-errors-behind-a-tls-inspecting-proxy).
+
+**O que fazer:**
+
+* Exporte o bundle de CA de sua organização e aponte Claude Code para ele com `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
+* Veja [Network configuration](/docs/pt/network-config#custom-ca-certificates) para instruções de configuração completa
+* Não defina `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desabilita a validação de certificado inteiramente
+
+
+ Host not allowed in a cloud session
+
+
+Uma solicitação HTTP de saída de uma sessão de nuvem ou rotina foi bloqueada pela política de rede do ambiente.
+
+```text theme={null}
+HTTP 403
+x-deny-reason: host_not_allowed
+```
+
+Você também pode ver um certificado TLS que não corresponde ao certificado real do destino. Sessões de nuvem rotam tráfego de saída através de um proxy que aplica a política de rede, então um certificado incompatível significa que o proxy terminou a conexão, não o destino.
+
+Isso não é um problema de rede do lado do cliente. Sessões de nuvem e [routines](/docs/pt/routines) executam dentro de uma VM em sandbox cuja tráfego de saída através da rede da sessão é filtrado para a [allowlist do ambiente de nuvem](/docs/pt/cloud-environments); [operações GitHub](/docs/pt/cloud-environments#github-proxy) e tráfego do conector MCP usam canais separados, é por isso que podem continuar funcionando enquanto outros hosts são bloqueados. O ambiente **Default** usa acesso **Trusted**, que permite a [allowlist padrão](/docs/pt/cloud-environments#default-allowed-domains) de registros de pacotes, APIs de provedores de nuvem, registros de contêiner, e domínios de desenvolvimento comuns e bloqueia outros domínios nesse caminho.
+
+**O que fazer:**
+
+Essas etapas alteram um de seus próprios ambientes. Um [organization-shared environment](/docs/pt/cloud-environments#organization-shared-environments) abre como somente leitura no seletor, então peça a um Owner para alterar seu acesso de rede de **Trusted** para **Custom** na página **Cloud environments** em [admin settings](https://claude.ai/admin-settings).
+
+* Abra a rotina para edição, ou inicie uma sessão de nuvem. Selecione o ícone de nuvem mostrando o nome do seu ambiente, como **Default**, para abrir o seletor. Passe o mouse sobre seu ambiente e clique no ícone de configurações.
+* No diálogo **Update cloud environment**, altere **Network access** de **Trusted** para **Custom**, depois adicione o domínio bloqueado a **Allowed domains**. Digite um domínio por linha. Marque **Also include default list of common package managers** para manter a [allowlist padrão](/docs/pt/cloud-environments#default-allowed-domains) junto com seus domínios personalizados. Selecione **Full** em vez disso se você quiser acesso irrestrito.
+* Clique em **Save changes**. A próxima execução usa a allowlist atualizada.
+
+Veja [Network access](/docs/pt/cloud-environments#network-access) para níveis de acesso e a allowlist padrão. Sessões de CLI local não são afetadas por essa política.
+
+
+ The proxy refused the connection
+
+
+Você vê essa mensagem quando Claude lê um [artifact](/docs/pt/artifacts) através do proxy que você definiu em `HTTPS_PROXY` ou uma [proxy variable](/docs/pt/network-config#environment-variables) relacionada. O conteúdo do artifact vem de `*.frame.claudeusercontent.com`, então Claude Code primeiro envia ao proxy uma solicitação `CONNECT` pedindo para abrir um túnel para esse host. Quando o proxy recusa, nada alcança o host, e a mensagem carrega o status HTTP do proxy:
+
+```text theme={null}
+artifact content fetch failed (proxy refused the connection: HTTP 407)
+artifact content fetch failed (proxy refused the connection: HTTP 403)
+the proxy refused the connection to the artifact's content host (HTTP 502)
+```
+
+O status é a resposta do proxy para o `CONNECT`. O host nunca respondeu, então cada status aponta para um fix diferente:
+
+* `HTTP 407`: o proxy requer credenciais que não recebeu. Coloque-as na URL do proxy, como [Basic authentication](/docs/pt/network-config#basic-authentication) mostra.
+* `HTTP 403`: o proxy recusa fazer túnel para `*.frame.claudeusercontent.com`. Peça a quem executa o proxy para permitir esse host, que [Network access requirements](/docs/pt/network-config#network-access-requirements) lista.
+* Qualquer outro status, como `HTTP 502`: o proxy não abriu o túnel por seu próprio motivo, como falhar ao alcançar o host. Procure o status nos logs do proxy.
+* `unreadable reply` no lugar de um status: o que está no endereço do proxy não respondeu com uma linha de status HTTP. Verifique se o endereço é um proxy HTTP.
+
+**O que fazer:**
+
+* Verifique o endereço e credenciais na variável de proxy, como [Proxy configuration](/docs/pt/network-config#proxy-configuration) descreve, depois execute `curl -x http://proxy.example.com:8080 -I https://api.anthropic.com` a partir do shell em que você inicia Claude Code, usando sua própria URL de proxy. No Windows PowerShell, execute `curl.exe`. Se essa sonda falhar da mesma forma, corrija a configuração do proxy primeiro. Se funcionar, a recusa é específica para o host do artifact.
+* Se sua rede deixa Claude Code alcançar o host do artifact diretamente, adicione `.frame.claudeusercontent.com` a [`NO_PROXY`](/docs/pt/network-config#environment-variables). Mantenha a entrada estreita: uma entrada `.claudeusercontent.com` mais ampla também contorna o proxy para `bridge.claudeusercontent.com`, que organizações com [IP allowlisting](/docs/pt/network-config#organization-ip-allowlists-and-proxy-egress) precisam manter no proxy.
+
+Antes da v2.1.238, Claude Code relatava um túnel recusado como um erro de rede genérico.
+
+
+ The cloud environments service returned an empty or unexpected response
+
+
+Claude Code solicita sua lista de [cloud environments](/docs/pt/cloud-environments) em vários pontos, como quando você cria uma sessão de nuvem a partir da CLI ou executa [`/remote-env`](/docs/pt/cloud-environments#select-an-environment-from-the-cli). Quando não consegue ler a resposta do servidor, mostra uma dessas mensagens:
+
+```text theme={null}
+The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
+The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
+The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.
+```
+
+O servidor aceitou a solicitação mas respondeu com um corpo que não é a lista de ambientes: vazio, não JSON, ou JSON sem a lista. Isso geralmente acompanha uma disrupção do lado do serviço e se limpa por conta própria. Dependendo da superfície que solicitou a lista, Claude Code pode adicionar um prefixo, como `couldn't list environments:` no diálogo `/remote-env`.
+
+**O que fazer:**
+
+* Tente novamente a ação. Claude Code solicita a lista novamente cada vez
+* Se a mensagem continuar aparecendo, verifique [status.claude.com](https://status.claude.com) para incidentes ativos
+
+Antes da v2.1.236, Claude Code mostrava um TypeError JavaScript bruto em vez dessas mensagens.
+
+
+ Couldn't reconnect to your Remote Control session
+
+
+```text theme={null}
+Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
+```
+
+Retomar com `claude --resume` ou `claude --continue` reconecta à sessão [Remote Control](/docs/pt/remote-control) registrada nessa conversa. Essa mensagem significa que a reconexão falhou por um motivo que pode ser temporário, como uma interrupção de rede ou um erro de servidor, então Claude Code não consegue confirmar se a sessão remota ainda existe. Sua sessão local continua executando sem Remote Control.
+
+**O que fazer:**
+
+* Execute `/remote-control` para tentar novamente a conexão
+* Inicie uma nova sessão com `claude --remote-control` para criar uma nova sessão Remote Control
+* Para outras mensagens de inicialização do Remote Control, veja [Troubleshoot Remote Control](/docs/pt/remote-control#troubleshooting)
+
+Se o servidor relatar em vez disso que a sessão anterior se foi, você não vê essa mensagem. Claude Code inicia uma nova sessão em seu lugar ou mostra [`Previous session is unavailable — run /remote-control to start a new one`](/docs/pt/remote-control#previous-session-is-unavailable), dependendo do [registro de reconexão da conversa](/docs/pt/remote-control#resume-outcomes). De v2.1.227 através v2.1.231, Claude Code mostrou uma mensagem que começa com `Remote Control could not resume the previous session under the current login` em vez disso, e [versões anteriores se comportaram diferentemente novamente](/docs/pt/remote-control#reconnect-history).
+
+
+ Sessions ended while this machine was offline
+
+
+Claude Code mostra essa mensagem no terminal executando [`claude remote-control`](/docs/pt/remote-control#start-a-remote-control-session) depois que sua máquina estava offline tempo suficiente para que o servidor limpasse o ambiente Remote Control que sua máquina estava servindo. As sessões nesse ambiente terminaram, e você não consegue retomá-las. A contagem é o número de sessões que terminaram.
+
+```text theme={null}
+2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.
+```
+
+**O que fazer:**
+
+* Quando Claude Code lista worktrees mantidas sob essa mensagem, pegue qualquer trabalho não commitado delas
+* Execute `claude remote-control` para iniciar um ambiente fresco
+
+
+ Couldn't share the transcript
+
+
+Depois que você concorda em compartilhar sua transcrição de sessão de um prompt de pesquisa, como a [session quality survey](/docs/pt/data-usage#session-quality-surveys), Claude Code a carrega para Anthropic, ou salva um arquivo local em vez disso em provedores de terceiros, em sessões [Claude apps gateway](/docs/pt/claude-apps-gateway), e quando nenhuma credencial Anthropic está disponível. Essa mensagem significa que o compartilhamento não foi concluído.
+
+```text theme={null}
+Couldn't share the transcript.
+```
+
+O upload deve caber em um limite de 8 MiB. Em uma sessão longa, Claude Code progressivamente descarta partes do compartilhamento, as configurações de modelo da última solicitação primeiro, depois a conversa estruturada e transcrições de subagent, e mostra essa mensagem apenas quando nenhuma versão reduzida pode ser enviada ou um erro de rede ou servidor para o upload. Quando Claude Code salva um arquivo local em vez disso, a mensagem significa que não conseguiu escrever o arquivo.
+
+**O que fazer:**
+
+* Execute `/feedback` para enviar a transcrição com uma descrição do que aconteceu. Veja [Report an error](#report-an-error) se `/feedback` não estiver disponível em seu ambiente
+* Se outras solicitações também estão falhando, verifique sua conexão de rede e veja [Unable to connect to API](#unable-to-connect-to-api)
+
+
+ Erros de solicitação
+
+
+Esses erros estão relacionados ao conteúdo da sua solicitação. A maioria retorna da API depois que ela rejeita a solicitação; alguns são produzidos localmente pelo Claude Code antes de qualquer solicitação ser enviada.
+
+
+ Prompt é muito longo
+
+
+A conversa mais os arquivos anexados excedem a janela de contexto do modelo.
+
+```text theme={null}
+Prompt is too long
+```
+
+Em uma sessão interativa, Claude Code mostra esse erro como:
+
+```text theme={null}
+Context limit reached · /compact or /clear to continue
+```
+
+A linha nomeia apenas `/clear` quando [`DISABLE_COMPACT`](/docs/pt/env-vars) está definido. Formas mais longas do erro, como a forma de falha de compactação abaixo, mantêm a redação `Prompt is too long ·`. Na saída `-p` e na transcrição, o texto permanece `Prompt is too long`.
+
+Quando você desativou o auto-compact nas suas [configurações de usuário](/docs/pt/settings-reference#autocompactenabled), a linha também diz:
+
+```text theme={null}
+Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on
+```
+
+O botão **Auto-compact** em `/config` escreve `autoCompactEnabled` nas configurações de usuário. A dica aparece apenas quando uma mudança `/config` teria efeito. Por exemplo, não aparece quando [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars) ou [`DISABLE_COMPACT`](/docs/pt/env-vars) desativou o auto-compact. Também não aparece quando um escopo de precedência mais alta, como configurações de projeto ou gerenciadas, define `autoCompactEnabled` como `false`. Antes da v2.1.235, a linha não tinha dica de auto-compact.
+
+Amazon Bedrock relata essa condição como `Input is too long for requested model.`, que Claude Code trata da mesma forma. Antes da v2.1.217, Claude Code não reconhecia a redação do Bedrock, então o auto-compact nunca era acionado e `/compact` falhava com o mesmo erro.
+
+Um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway-config#upstream-error-messages) relata essa condição como `capability_rejected: prompt_too_long` quando um upstream de nuvem rejeita a solicitação na forma de erro própria do provedor. Claude Code trata o token da mesma forma que `Prompt is too long`. Antes da v2.1.228, Claude Code não reconhecia o token, então o auto-compact não era acionado.
+
+Quando a compactação automática foi executada nessa volta e falhou em um erro subjacente, como um modelo indisponível ou uma falha de autenticação, a mensagem nomeia esse erro após um separador:
+
+```text theme={null}
+Prompt is too long · automatic compaction failed:
+```
+
+Resolva o erro nomeado primeiro; `/compact` falha no mesmo erro até você fazer isso. Antes da v2.1.229, uma compactação automática falhada exibia `Prompt is too long` sem a causa.
+
+Quando a compactação automática é executada nesse erro, ela normalmente resume suas trocas mais antigas e mantém as mais novas. Como último recurso, Claude Code resume de forma diferente:
+
+* Quando não consegue resumir nenhuma troca completa, Claude Code mantém seu prompt mais novo palavra por palavra e resume tudo antes dele.
+* Nesse caso, quando a conversa não termina com seu prompt, Claude Code resume a conversa inteira.
+
+Claude Code pula essa recuperação quando o conteúdo que ele carregaria adiante não contém resposta do modelo e menos de cerca de 1.000 tokens do seu próprio texto, como uma tentativa curta enviada após uma colagem de tamanho excessivo. Execute `/clear` para começar do zero. Antes da v2.1.269, a compactação falhava sempre que não conseguia resumir uma troca completa, então uma sessão nesse estado atingia esse erro novamente a cada volta.
+
+Uma conversa de troca única não tem voltas anteriores para resumir. Quando a compactação automática teria sido executada em uma, Claude Code pula a tentativa e explica o que preenche a solicitação. Quando a API não relata contagens de tokens em seu erro, a mensagem lê:
+
+```text theme={null}
+Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.
+```
+
+Quando a API relata contagens de tokens em seu erro, Claude Code as compara com sua própria estimativa do tamanho da conversa para dizer qual é a maior parte da solicitação: o conteúdo próprio da conversa ou o prompt do sistema, definições de ferramentas e conteúdo de anexo que Claude Code envia com ela. Quando o conteúdo próprio da conversa é a maior parte da solicitação, a mensagem lê:
+
+```text theme={null}
+Prompt is too long · the request is ~ tokens (limit ) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).
+```
+
+Quando a maior parte da solicitação está fora da conversa, a mensagem lê:
+
+```text theme={null}
+Prompt is too long · the request is ~ tokens (limit ) but this conversation is only ~ tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.
+```
+
+Antes da v2.1.162, Claude Code tentava a compactação mesmo assim e exibia o `Prompt is too long` simples quando falhava.
+
+**O que fazer:**
+
+* Execute `/compact` para resumir voltas anteriores e liberar espaço, ou `/clear` para começar do zero. Se `/compact` responder `Not enough messages to compact.`, a conversa é uma troca única sem nada anterior para resumir, então o espaço é ocupado por esse prompt e o que Claude Code envia com cada solicitação: execute `/clear` e reenvie com menos texto colado ou anexos menores, ou reduza as definições de ferramentas e arquivos de memória usando as etapas abaixo
+* Execute `/context` para ver um detalhamento do que está consumindo a janela: prompt do sistema, ferramentas, arquivos de memória e mensagens
+* Desabilite servidores MCP que você não está usando com `/mcp disable ` para remover suas definições de ferramentas do contexto
+* Reduza arquivos de memória `CLAUDE.md` grandes ou mova instruções para [regras com escopo de caminho](/docs/pt/memory#path-specific-rules) que carregam apenas quando relevante
+* Suagentes herdam todas as definições de ferramentas MCP da sessão pai, que podem preencher sua janela de contexto antes da primeira volta. Desabilite servidores MCP que você não está usando antes de gerar suagentes.
+* O auto-compact está ativado por padrão e normalmente previne esse erro. Se você o desativou em `/config` ou com [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars), ative-o novamente. Se você mantê-lo desativado, execute `/compact` você mesmo antes da janela se preencher.
+
+Veja [Explore the context window](/docs/pt/context-window) para uma visualização interativa de como o contexto se preenche.
+
+
+ O contexto excede o limite de tokens
+
+
+`/context` mostra esse aviso no topo de sua saída quando a conversa cresceu além da janela de contexto do modelo. As solicitações falham com [`Prompt is too long`](#prompt-is-too-long) até você liberar espaço. Uma sessão interativa mostra esse erro como a linha `Context limit reached`.
+
+```text theme={null}
+Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.
+```
+
+Quando o limite que você excedeu é uma janela de compactação, como o limite de 200K em modelos de contexto 1M, o aviso lê diferentemente. Uma janela de compactação pode ficar abaixo da janela de contexto do modelo, então solicitações após ela ainda podem ter sucesso.
+
+```text theme={null}
+Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.
+```
+
+Ambas as formas nomeiam `/clear` em vez de `/compact` quando você definiu [`DISABLE_COMPACT`](/docs/pt/env-vars).
+
+**O que fazer:**
+
+* Em uma conversa com múltiplas voltas, execute `/compact` para resumir voltas anteriores e liberar espaço. Para começar do zero, execute `/clear`
+* Para mais formas de reduzir o uso, veja [Prompt is too long](#prompt-is-too-long)
+
+Antes da v2.1.216, `/context` mostrava uso acima de 100% sem linha de aviso explicando o que isso significava ou como se recuperar.
+
+
+ Erro durante compactação: Conversa muito longa
+
+
+`/compact` em si falhou porque não há contexto livre suficiente para manter o resumo que produz.
+
+```text theme={null}
+Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
+```
+
+Isso pode acontecer quando a janela já está cheia no momento em que o auto-compact é acionado, ou quando você executa `/compact` depois de ver [`Prompt is too long`](#prompt-is-too-long). Em uma sessão interativa, esse erro é a linha `Context limit reached`.
+
+**O que fazer:**
+
+* Pressione Esc duas vezes para abrir a lista de mensagens e voltar várias voltas. Isso remove as mensagens mais recentes do contexto. Então execute `/compact` novamente.
+* Se voltar não liberar espaço suficiente, execute `/clear` para iniciar uma sessão nova. Sua conversa anterior é preservada e pode ser reabierta com `/resume`.
+
+Essa mensagem e outras falhas `/compact` são exibidas em estilo de erro. Antes da v2.1.216, elas eram renderizadas no mesmo estilo atenuado que a saída de comando bem-sucedida, então você poderia ler uma compactação falhada como um sucesso.
+
+
+ Solicitação muito grande
+
+
+O corpo da solicitação bruta excedeu o limite de 32MB da API antes da tokenização, geralmente por causa de conteúdo colado grande, resultados de ferramentas ou anexos. Esse limite é separado da [janela de contexto](#prompt-is-too-long).
+
+```text theme={null}
+Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.
+```
+
+Quando a solicitação foi direto para a API Claude e a própria API a rejeitou, Claude Code mede a conversa e redige a mensagem se a recuperação pode funcionar. Através de um proxy, gateway ou provedor de nuvem você obtém a mensagem geral. As formas medidas:
+
+* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: imagens ou documentos empurraram a solicitação além do limite. Claude Code tenta novamente com eles removidos.
+* `Request too large for the API's 32MB request limit`: as mensagens sozinhas estão além do limite, então a mensagem diz `compacting cannot make it fit` e Claude Code não tenta novamente. Em [modo não interativo](/docs/pt/headless), a mensagem diz para você reduzir a entrada ou iniciar uma nova sessão.
+
+Antes da v2.1.212, conversas com imagens acumuladas suficientes falhavam a cada volta com `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` Antes da v2.1.229, Claude Code mostrava o conselho de anexo para cada rejeição, mesmo quando a compactação não podia ajudar.
+
+**O que fazer:**
+
+* Se a mensagem diz `compacting cannot make it fit`, pressione Esc duas vezes para voltar além da volta que adicionou o conteúdo grande, ou execute `/clear` para começar do zero
+* Caso contrário, execute `/compact`, que remove imagens e anexos acumulados
+* Referencie arquivos grandes por caminho em vez de colar seu conteúdo, para que Claude possa lê-los em pedaços
+* Para imagens, veja [Image was too large](#image-was-too-large) abaixo
+
+
+ Imagem era muito grande
+
Uma imagem colada ou anexada excede os limites de tamanho ou dimensão da API.
```text theme={null}
-Image was too large. Double press esc to go back and try again with a smaller image.
-API Error: 400 ... image dimensions exceed max allowed size
+Image was too large. Double press esc to go back and try again with a smaller image.
+API Error: 400 ... image dimensions exceed max allowed size
+```
+
+Claude Code substitui a imagem não processável por um espaço reservado de texto e tenta novamente, então mensagens subsequentes têm sucesso. Em versões antes de 2.1.142, uma imagem colada poderia permanecer na conversa e repetir o mesmo erro em cada mensagem subsequente. Para se recuperar nessas versões, pressione Esc duas vezes e volte além da volta onde a imagem foi adicionada.
+
+**O que fazer:**
+
+* Redimensione a imagem antes de colar. A API aceita imagens até 8000 pixels na borda mais longa para uma única imagem, ou 2000 pixels quando muitas imagens estão em contexto.
+* Faça uma captura de tela mais apertada da região relevante em vez da tela inteira
+
+
+ Não foi possível redimensionar a imagem
+
+
+Claude Code não conseguiu reduzir uma imagem anexada antes de enviá-la para a API.
+
+```text theme={null}
+Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
+Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
+Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
+Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
+Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
+Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
+Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.
+```
+
+Claude Code normalmente redimensiona imagens grandes automaticamente. Esses erros significam que a imagem não pôde ser decodificada ou redimensionada para caber dentro dos limites da API.
+
+**O que fazer:**
+
+* Se a mensagem pedir para você converter a imagem, converta-a para PNG, JPEG, GIF ou WebP e anexe-a novamente. Claude Code pode verificar dimensões para esses formatos a partir do cabeçalho do arquivo, sem decodificar a imagem.
+* Se a mensagem relatar um limite de dimensão ou tamanho, redimensione ou recomprima a imagem abaixo desse limite antes de anexar.
+* Se a mensagem nomear uma causa, como um JPEG CMYK, um WebP animado ou um arquivo possivelmente danificado, salve novamente a imagem no formato que a mensagem sugere e anexe-a novamente.
+
+
+ Erros de PDF
+
+
+O PDF que você anexou não pôde ser processado. As mensagens são mostradas aqui em sua forma não interativa; em uma sessão interativa, elas solicitam que você pressione esc duas vezes e tente novamente.
+
+```text theme={null}
+PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
+PDF is password protected. Try using a CLI tool to extract or convert the PDF.
+The PDF file was not valid. Try converting it to text first (e.g., pdftotext).
+```
+
+**O que fazer:**
+
+* Para PDFs de tamanho excessivo, peça a Claude para ler um intervalo de páginas com a ferramenta Read em vez de anexar o arquivo inteiro, ou extraia texto com uma ferramenta como `pdftotext` e referencie o arquivo de saída por caminho
+* Para PDFs protegidos ou inválidos, remova a senha ou re-exporte o arquivo de seu aplicativo de origem, depois tente novamente
+
+
+
+Um proxy ou gateway LLM entre Claude Code e a API removeu o cabeçalho de solicitação `anthropic-beta`, então a API rejeitou campos que dependem dele.
+
+```text theme={null}
+API Error: 400 ... Extra inputs are not permitted ... context_management
+API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header
+```
+
+Claude 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.
+
+**O que fazer:**
+
+* Configure seu gateway para encaminhar o cabeçalho `anthropic-beta`. Veja [feature pass-through](/docs/pt/llm-gateway-protocol#feature-pass-through) para o que os gateways devem encaminhar.
+* Como fallback, defina [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/pt/env-vars) antes de iniciar. [Disable pre-release capabilities](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) cobre o escopo exato.
+
+
+
+Uma ferramenta na solicitação declarou um `input_schema` que falha na validação JSON Schema da API, então a API rejeitou a solicitação inteira. O número após `tools.` é a posição da ferramenta falhada na lista de ferramentas da solicitação, não um nome que você possa procurar.
+
+```text theme={null}
+API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
+API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'
+```
+
+A primeira forma significa que o esquema não é um JSON Schema draft 2020-12 válido. A segunda significa que um nome de propriedade de nível superior não corresponde ao padrão que a mensagem cita.
+
+Claude Code [exclui ferramentas MCP cujo esquema de entrada falharia nessa validação](/docs/pt/mcp#tools-with-invalid-input-schemas) quando carrega as ferramentas de um servidor, então solicitações normalmente nunca incluem uma.
+
+Em uma [implantação onde a busca de sinalizadores está desativada](/docs/pt/env-vars#features-that-need-feature-flag-fetching), ou em uma máquina cujos sinalizadores nunca chegaram, Claude Code registra no log do servidor qual ferramenta seria rejeitada mas a envia mesmo assim, então esse erro ainda pode ocorrer.
+
+O erro também pode ocorrer para uma ferramenta cujo esquema declara um dialeto JSON Schema diferente de draft 2020-12 em `$schema`. Claude Code não verifica esses esquemas contra o meta-esquema JSON Schema, embora a verificação de nome de propriedade de nível superior ainda se aplique.
+
+Antes da v2.1.216, nenhuma implantação executava as verificações de exclusão.
+
+**O que fazer:**
+
+* Se sua versão do Claude Code é anterior à v2.1.216, execute `claude update`.
+* Remova ou [desabilite](/docs/pt/mcp#disable-a-server-without-removing-it) o servidor MCP que declara o esquema inválido. O erro nomeia a ferramenta apenas por posição. Na v2.1.216 ou posterior, verifique o log de cada servidor para uma linha nomeando uma ferramenta cujo esquema de entrada seria rejeitado. Se nenhum log nomear uma, desabilite servidores um de cada vez.
+* Se você mantém o servidor, corrija o `input_schema` da ferramenta. O esquema deve ser um JSON Schema válido, e nomes de propriedade de nível superior devem ter 1 a 64 caracteres e usar apenas letras ASCII e dígitos, `_`, `.` e `-`. Veja [Tools with invalid input schemas](/docs/pt/mcp#tools-with-invalid-input-schemas).
+
+
+ Há um problema com o modelo selecionado
+
+
+O nome do modelo configurado não foi reconhecido ou sua conta não tem acesso a ele. A partir da v2.1.160, a dica final, mostrada aqui em sua forma interativa, varia por superfície.
+
+```text theme={null}
+There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.
+```
+
+**O que fazer:**
+
+* **CLI interativa**: execute `/model` para escolher entre modelos disponíveis para sua conta.
+* **Modo não interativo (`-p`)**: passe `--model` com um alias ou ID válido, ou defina [`ANTHROPIC_MODEL`](/docs/pt/env-vars). O texto de erro mostra `Run --model` nessa superfície.
+* **Agent SDK**: o texto de erro omite a dica porque o modelo é definido programaticamente. Defina [`model` em `Options`](/docs/pt/agent-sdk/typescript#options) em TypeScript ou [`ClaudeAgentOptions(model=...)`](/docs/pt/agent-sdk/python#claudeagentoptions) em Python, e trate o erro estruturado `model_not_found` para exibir seu próprio retry ou seletor de modelo.
+* Use um alias como `sonnet` ou `opus` em vez de um ID versionado completo. Aliases resolvem para um padrão mantido para que não fiquem obsoletos. Veja [Model configuration](/docs/pt/model-config).
+* Se o modelo errado continua voltando na CLI, um ID obsoleto está definido em algum lugar. Verifique os locais onde você pode definir um modelo em [ordem de prioridade](/docs/pt/model-config#setting-your-model) e remova o valor obsoleto.
+* Um modelo recém-lançado pode estar disponível na API Anthropic antes de Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry oferecer. Se você fixou um novo ID de modelo em um desses provedores e vê esse erro, verifique o catálogo de modelos do seu provedor para disponibilidade em sua região e mantenha a versão anterior fixada até que a nova apareça lá.
+* Claude Code relata um login claude.ai expirado como [Login expired](#login-expired), não como esse erro. Antes da v2.1.206, um login expirado que não podia mais ser atualizado falhava em cada modelo com esse erro; execute `/login` se você vir isso em uma versão mais antiga.
+* Para implantações do Google Cloud's Agent Platform, veja [Google Cloud's Agent Platform troubleshooting](/docs/pt/google-vertex-ai#troubleshooting).
+
+
+ Model is not a recognized model id
+
+
+A string de modelo que você passou para uma mudança de modelo não é um alias de modelo, um ID de modelo que essa versão do Claude Code conhece, ou um ID que começa com `claude-`. As causas usuais são um erro de digitação no ID, um nome de exibição como `Sonnet 5` onde o ID `claude-sonnet-5` é esperado, ou um alias que apenas versões mais novas do Claude Code reconhecem. Claude Code rejeita a mudança imediatamente. Antes da v2.1.200, Claude Code salvava a string e falhava na próxima solicitação com [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).
+
+```text theme={null}
+Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?
+```
+
+A dica final nomeia o alias ou ID de modelo mais próximo. Quando nada é próximo o suficiente, lê `Run /model to see available models.` em vez disso.
+
+Claude Code produz esse erro localmente no momento em que a mudança é solicitada, antes de qualquer solicitação de API ser feita. Aplica-se quando um modelo é definido através do método [Agent SDK](/docs/pt/agent-sdk/typescript) `setModel()`, por um aplicativo como o [Desktop app](/docs/pt/desktop) que executa o CLI do Claude Code para você, ou quando você escolhe um modelo de um dispositivo conectado através de [Remote Control](/docs/pt/remote-control). Antes da v2.1.260, a verificação não cobria escolhas de Remote Control, então Claude Code aplicava a escolha e a próxima solicitação falhava com [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).
+
+**O que fazer:**
+
+* Execute `/model` sem argumento para abrir o seletor e escolher entre os modelos disponíveis para sua conta, depois passe o alias ou ID mostrado lá
+* Se você usou um alias que uma versão mais nova do Claude Code suporta, execute `claude update`. Um ID completo que começa com `claude-` passa nessa verificação local mesmo quando o modelo é mais novo que sua versão do Claude Code. O servidor ainda pode exigir uma versão mínima para esse modelo; veja [Claude Code does not support this model](#claude-code-does-not-support-this-model).
+* Um modelo salvo antes da v2.1.200 não é reparado por essa verificação. Se um valor obsoleto continua voltando, remova-o dos locais listados em [Setting your model](/docs/pt/model-config#setting-your-model).
+* A verificação é executada apenas na API Anthropic. Em qualquer outro provedor ou gateway, incluindo um `ANTHROPIC_BASE_URL` customizado, o provedor define os nomes de modelo, então Claude Code aceita qualquer string e a passa. Claude Code ainda pode escrever a [linha de diagnóstico de modelo não reconhecido](#unrecognized-model-id-on-a-request) no tempo de solicitação, em cada provedor.
+
+
+ Modelo não encontrado
+
+
+Você escolheu um modelo com `/model ` e Claude Code não conseguiu confirmar que um modelo com esse nome existe. Quando o nome não é um [alias de modelo](/docs/pt/model-config#model-aliases) ou outra ortografia que Claude Code aceita localmente, `/model` o verifica com uma solicitação mínima de API, e esse erro é geralmente a resposta do seu endpoint de API. Um nome que não pode ser um ID de modelo, como um contendo espaços, recebe a mesma mensagem.
+
+```text theme={null}
+Model 'claude-opus-9' not found
+```
+
+Em provedores com IDs de modelo específicos do provedor, a mensagem pode adicionar uma sugestão `Try '...' instead` que nomeia o ID do seu provedor para um modelo de fallback.
+
+**O que fazer:**
+
+* Execute `/model` sem argumento e escolha entre os modelos disponíveis para sua conta, ou use um [alias de modelo](/docs/pt/model-config#model-aliases) como `sonnet`, que resolve para um padrão mantido
+* Se você digitou um ID completo, verifique-o contra o catálogo de modelos do seu provedor. Um modelo recém-lançado pode estar disponível na API Anthropic antes de seu provedor ou região oferecer.
+* Antes da v2.1.265, `/model` também rejeitava a ortografia do alias `opusplan[1m]` com esse erro. Nessas versões, atualize Claude Code ou defina o modelo em [settings](/docs/pt/model-config#setting-your-model) ou com `--model` em vez disso.
+
+
+ Claude Opus não está disponível com o plano Claude Pro
+
+
+Seu plano de assinatura ativo não inclui o modelo que você selecionou.
+
+```text theme={null}
+Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.
+```
+
+**O que fazer:**
+
+* Execute `/model` e selecione um modelo que seu plano inclui
+* Se você atualizou seu plano recentemente e ainda vê isso, execute `/logout` depois `/login`. O token armazenado reflete seu plano no momento em que você se conectou, então atualizar em claude.ai não entra em vigor em uma sessão existente até você se autenticar novamente.
+* Veja [claude.com/pricing](https://claude.com/pricing) para quais modelos cada plano inclui
+
+
+ Claude Code não suporta este modelo
+
+
+A API recusou a solicitação com um 400 porque sua versão do Claude Code está abaixo de um mínimo necessário. Ou o modelo que você selecionou requer uma versão mais nova, que o servidor verifica por modelo, ou a política da sua organização requer uma. O 400 carrega o código de erro `claude_code_version_too_old`, e a mensagem diz qual mínimo se aplica.
+
+```text theme={null}
+API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.
+```
+
+A redação da política organizacional lê:
+
+```text theme={null}
+API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.
+```
+
+**O que fazer:**
+
+* Execute `claude update` ou atualize o aplicativo Claude desktop, depois inicie uma nova sessão
+* Para a redação por modelo, você pode continuar trabalhando na sessão atual alternando para outro modelo com `/model`
+* Para a redação da política organizacional, atualize antes de continuar
+
+
+ O modelo é restringido pelas configurações da sua organização
+
+
+Seu administrador de organização desabilitou este modelo no console de administração claude.ai, ou ele é excluído por uma lista de permissões [`availableModels`](/docs/pt/model-config#restrict-model-selection) em configurações gerenciadas. Quando o modelo restringido foi definido com `--model`, `ANTHROPIC_MODEL` ou a configuração `model`, Claude Code substitui um modelo permitido e continua. Digitar `/model ` para um modelo restringido é rejeitado com `Run /model to choose a different model.` e a sessão mantém seu modelo atual. O aviso de substituição também pode aparecer no meio da sessão após um administrador desabilitar o modelo em que uma sessão está sendo executada no console de administração claude.ai.
+
+```text theme={null}
+Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
+```
+
+Um aviso prefixado com um nome de agente, skill ou comando significa que a restrição se aplicou ao [modelo solicitado do suagente](/docs/pt/sub-agents#choose-a-model): o suagente é executado no modelo substituído e o modelo da sua sessão não é alterado. Antes da v2.1.223, Claude Code mostrava o aviso apenas para suagentes lançados com a ferramenta Agent.
+
+Claude Code trata um alias de família de modelo, um de `opus`, `sonnet`, `haiku` ou `fable`, como uma solicitação para essa família em vez de sua versão mais nova. Na API Anthropic e em [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), um alias de família restringido resolve para a versão mais nova da família que sua organização e a lista de permissões `availableModels` permitem, e o aviso de substituição nomeia essa versão. Claude Code rejeita `/model ` apenas quando cada versão da família é restringida. Antes da v2.1.205, um alias de família era substituído ou rejeitado com base apenas em sua versão mais nova, mesmo quando uma versão mais antiga da mesma família era permitida.
+
+**O que fazer:**
+
+* Execute `/model` para escolher entre os modelos que sua organização permite. Modelos restritos estão ocultos do seletor.
+* Se o modelo restringido foi definido em `--model`, `ANTHROPIC_MODEL`, o campo `model` de um arquivo de configurações ou o frontmatter `model` de um [suagente](/docs/pt/sub-agents#choose-a-model), skill ou comando, remova ou atualize esse valor para que o aviso não recorra
+* Se você precisa de acesso ao modelo restringido, peça ao administrador da sua organização para habilitá-lo. Veja [Organization model restrictions](/docs/pt/model-config#organization-model-restrictions).
+
+
+ A mudança de modelo foi bloqueada por um hook PreModelSwitch
+
+
+Um [hook PreModelSwitch](/docs/pt/hooks#premodelswitch) não aprovou a mudança de modelo que você ou um cliente solicitou, então a sessão mantém seu modelo atual. Quando a mudança veio de um host [Agent SDK](/docs/pt/agent-sdk/overview) ou [Remote Control](/docs/pt/remote-control) em vez de um comando que você digitou, a mensagem lê `Model switch blocked by a PreModelSwitch hook` sem nomear o modelo de destino.
+
+```text theme={null}
+Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.
+```
+
+A razão após os dois pontos diz o que recusou a mudança:
+
+* **Uma razão que um hook escreveu**: um hook PreModelSwitch forneceu essa razão quando [negou a mudança ou pediu confirmação](/docs/pt/hooks#premodelswitch-decision-control). Aborde o que ele pede ou escolha um modelo que seus hooks permitem.
+* **`PreModelSwitch hook did not respond before its timeout`**: um hook que não responde antes de seu [timeout](/docs/pt/hooks#timeouts) bloqueia a mudança. Corrija o comando pendurado ou aumente o `timeout` desse hook, depois mude novamente.
+* **`confirmation required, and this session cannot ask`**: um hook respondeu `ask` sem uma razão, e uma solicitação de controle não tem forma de mostrar o prompt de confirmação. Um comando `/model` em uma execução [`-p`](/docs/pt/headless) relata a mesma condição com `(run /model interactively to confirm)` após a razão. Faça a mudança de uma sessão interativa ou altere a decisão do hook para este modelo.
+* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code não conseguiu dizer quais hooks PreModelSwitch seus [plugins gerenciados](/docs/pt/settings-reference#enabledplugins) da organização entregam, por exemplo porque um plugin gerenciado falhou ao carregar. Um desses hooks pode bloquear a mudança, então Claude Code recusa em vez de aplicar a mudança desmarcada. O início da razão nomeia o que falhou. Claude Code re-verifica a cada tentativa de mudança, então uma falha que desde então foi limpa para de bloquear; se continuar falhando, execute `claude --debug` e mude novamente para capturar os detalhes, depois corrija o plugin ou peça ao seu administrador para corrigi-lo.
+* **`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 veredicto, e Claude Code não trata isso como aprovação. Execute `claude --debug` para ver o que falhou, depois mude novamente.
+
+Antes da v2.1.260, a recusa de plugin gerenciado lia `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code tentou novamente o carregamento do plugin uma vez e depois recusou mudanças posteriores na sessão, mesmo quando sua organização não gerenciava plugins. Reinicie a sessão para executar o carregamento do plugin novamente nessas versões.
+
+
+ Não foi possível salvá-lo como seu padrão
+
+
+Você escolheu um modelo para salvar como seu padrão, por exemplo com `/model ` ou `Enter` no seletor `/model`, e Claude Code não conseguiu escrever a escolha no arquivo de configurações do usuário, `~/.claude/settings.json`. A mudança em si foi aplicada, então a sessão atual é executada no modelo que você escolheu, mas seu padrão não é alterado e a próxima sessão começa no valor antigo.
+
+```text theme={null}
+Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)
+```
+
+A razão após o caminho do arquivo diz o que falhou:
+
+* **`can't be written ()`**: a escrita falhou com o código de erro do sistema operacional entre parênteses, como `EROFS` quando o arquivo, ou o arquivo para o qual ele aponta, fica em um sistema de arquivos que recusa escritas. Torne o arquivo gravável e mude novamente. Se outra ferramenta gera o arquivo, defina a chave `model` nessa ferramenta em vez disso; veja [A change you made in Claude Code is lost in new sessions](/docs/pt/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).
+* **`isn't valid JSON`**: o arquivo no disco não analisa, e Claude Code o deixa intocado em vez de sobrescrever conteúdo que não consegue ler de volta. Corrija o erro de sintaxe, depois mude novamente; veja [Fix a broken settings file](/docs/pt/settings#fix-a-broken-settings-file).
+
+Um aviso terminando `couldn't confirm it was saved as your default (~/.claude/settings.json is still being written)` significa que a escrita não havia terminado após três segundos. Continua em segundo plano, então o padrão ainda pode ser salvo; verifique qual modelo sua próxima sessão começa ou execute `/model ` novamente.
+
+Antes da v2.1.265, o aviso dizia que o modelo foi `saved as your default for new sessions` mesmo quando a escrita falhou.
+
+
+ thinking.type.enabled não é suportado para este modelo
+
+
+Sua versão do Claude Code é mais antiga que o mínimo para o modelo selecionado. O CLI enviou uma configuração de pensamento que o modelo não aceita mais.
+
+```text theme={null}
+API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
+```
+
+**O que fazer:**
+
+* Execute `claude update` e reinicie Claude Code. Opus 4.7 precisa da v2.1.111 ou posterior. Opus 4.8 precisa da v2.1.154 ou posterior. Sonnet 5 precisa da v2.1.197 ou posterior. Opus 5 precisa da v2.1.219 ou posterior. Opus 5.5 precisa da v2.1.280 ou posterior
+* Se você não conseguir atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.6 em vez disso
+* Se você atingir isso no [Agent SDK](/docs/pt/agent-sdk/overview), atualize o pacote SDK em vez disso. Opus 4.8 precisa do SDK TypeScript v0.3.154 ou posterior e SDK Python v0.2.88 ou posterior. Sonnet 5 precisa do SDK TypeScript v0.3.197 ou posterior. Opus 5 precisa do SDK TypeScript v0.3.219 ou posterior. Opus 5.5 precisa do SDK TypeScript v0.3.280 ou posterior
+
+
+ Effort não está disponível com o pensamento desativado
+
+
+Você desativou o [pensamento estendido](/docs/pt/model-config#extended-thinking) e executou em um [nível de esforço](/docs/pt/model-config#adjust-effort-level) acima de `high`. O modelo não aceita essa combinação, então a API rejeitou a solicitação.
+
+```text theme={null}
+API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)
+```
+
+**O que fazer:**
+
+* [Abaixe o nível de esforço](/docs/pt/model-config#set-the-effort-level) para `high` ou abaixo.
+* Ative o pensamento novamente, por exemplo desativando [`MAX_THINKING_TOKENS`](/docs/pt/env-vars) ou removendo [`"alwaysThinkingEnabled": false`](/docs/pt/settings-reference#alwaysthinkingenabled) de suas configurações.
+
+Antes da v2.1.242, Claude Code mostrava a própria mensagem da API: `API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking.` Antes da v2.1.251, Claude Code enviava a solicitação no nível de esforço que você definiu, então Opus 5 rejeitava cada solicitação acima de `high` com pensamento desativado. Claude Code agora envia esforço `high` em vez disso para modelos que sabe rejeitarem a combinação, como Opus 5, então na v2.1.251 ou posterior esse erro chega a você apenas de um modelo que Claude Code não sabe rejeitar.
+
+
+ O orçamento de pensamento excede o limite de saída
+
+
+O orçamento de pensamento estendido configurado excede o comprimento máximo de resposta, então não há espaço deixado para a resposta real.
+
+```text theme={null}
+API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
+```
+
+Claude Code ajusta esses valores automaticamente na API Anthropic. Você normalmente vê esse erro em Amazon Bedrock ou Google Cloud's Agent Platform quando [`MAX_THINKING_TOKENS`](/docs/pt/env-vars) está definido mais alto que o limite de saída do provedor, ou quando o modo de plano aumenta o orçamento de pensamento.
+
+**O que fazer:**
+
+* Abaixe `MAX_THINKING_TOKENS` ou aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/pt/env-vars) acima do orçamento de pensamento
+* Veja [Extended thinking](/docs/pt/model-config#extended-thinking) para como o orçamento interage com o comprimento de saída
+
+
+
+O histórico de conversa chegou à API em um estado inconsistente, geralmente após uma chamada de ferramenta ser interrompida ou uma volta ser editada no meio do fluxo.
+
+```text theme={null}
+API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
+API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.
+API Error: 400 duplicate tool_use ID in conversation history. Run /rewind to recover the conversation.
+API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
+API Error: 400 ... thinking blocks ... cannot be modified
+```
+
+Todas as variantes significam a mesma coisa: a sequência de blocos `tool_use`, `tool_result` e `thinking` no histórico não corresponde mais ao que a API espera.
+
+**O que fazer:**
+
+* Se você está usando Opus 4.7 ou Opus 4.8, execute `claude update` primeiro. Versões antes da v2.1.156 podem acionar esse erro durante o uso normal de ferramentas, e `/rewind` não o limpa.
+* Execute `/rewind` ou pressione Esc duas vezes para voltar a um checkpoint antes da volta corrompida e continuar de lá. Veja [Checkpointing](/docs/pt/checkpointing) para como checkpoints são criados e restaurados.
+
+
+ Conteúdo de ferramenta não suportado removido
+
+
+Quando Claude Code se conecta diretamente à API Anthropic e carrega ou visualiza uma sessão salva, ele remove conteúdo de ferramenta que a API Anthropic não aceita e deixa essa linha onde o conteúdo removido estava entre dois blocos de pensamento:
+
+```text theme={null}
+[Unsupported tool content removed]
+```
+
+Tal conteúdo chega a um arquivo de sessão quando algo diferente da API Anthropic responde no formato da API, tipicamente um proxy de terceiros definido através de [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) que traduz chamadas de ferramentas de outro provedor. Claude Code o remove apenas quando a sessão se conecta diretamente à API Anthropic e carrega o histórico salvo como está quando a sessão é executada através de um proxy ou em outro provedor. Antes da v2.1.246, Claude Code enviava o uso de ferramenta e seu resultado de volta para a API, e cada volta da sessão retomada falhava com um erro 400 como `messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ...`.
+
+**O que fazer:**
+
+* Nenhuma ação necessária quando você vê a linha de espaço reservado. A sessão continua sem o conteúdo removido.
+* Se cada volta de uma sessão retomada falhar com o erro 400 em vez disso, execute `claude update` e retome a sessão novamente. Versões antes da v2.1.246 não removem o conteúdo.
+
+
+ role 'system' deve preceder uma mensagem 'assistant'
+
+
+A API recusou a solicitação com um 400 porque uma mensagem de sistema fica em uma posição na conversa que ela não aceita:
+
+```text theme={null}
+API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...
+```
+
+Claude Code envia algum de seu texto de lembrete e anexo como mensagens de sistema dentro da conversa. Quando a API recusa a posição de uma, Claude Code tenta novamente a solicitação uma vez com esse texto enviado como mensagens de usuário ordinárias em vez disso. As redações de posicionamento irmão da API, como `use the top-level 'system' parameter for the initial system prompt`, recebem a mesma recuperação.
+
+Quando o erro aparece, a mensagem de sistema recusada não é uma que Claude Code possa remover. Isso geralmente significa um proxy ou [gateway LLM](/docs/pt/llm-gateway) entre Claude Code e a API adicionou uma mensagem de sistema própria ou reordenou a conversa.
+
+**O que fazer:**
+
+* Execute `/clear` para iniciar uma conversa nova. Se o erro retornar lá também, a causa está no caminho da solicitação, não na conversa salva.
+* Se o erro se repete a cada volta atrás de um proxy ou gateway configurado através de [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars), conecte sem o proxy para confirmar a fonte e relate o erro a quem o opera
+
+Antes da v2.1.280, Claude Code não reconhecia essa redação, então o erro também aparecia quando a mensagem de sistema recusada era uma que Claude Code mesmo enviou, e cada volta posterior da conversa falhava da mesma forma.
+
+
+ Conteúdo criptografado inválido no bloco search\_result
+
+
+A API recusou a solicitação com um 400 porque o histórico de conversa contém conteúdo de busca na web hospedado que ela não consegue descriptografar. A redação nomeia o campo que ela não consegue ler:
+
+```text theme={null}
+API Error: 400 messages.21.content.0: Invalid `encrypted_content` in `search_result` block
+API Error: 400 messages.21.content.3.citations.0: Invalid `encrypted_index` in `text` block
+API Error: 400 Failed to decrypt web search result content
+```
+
+Resultados da [ferramenta de busca na web](/docs/pt/tools-reference#websearch-tool-behavior) hospedada da API carregam campos criptografados que apenas a API pode ler. A API recusa uma solicitação que reproduz conteúdo que ela não consegue descriptografar, como conteúdo produzido para uma organização diferente.
+
+A própria ferramenta [WebSearch](/docs/pt/tools-reference#websearch-tool-behavior) do Claude Code registra resultados de busca como texto simples, então esses blocos geralmente chegam a uma conversa através de um proxy ou [gateway LLM](/docs/pt/llm-gateway) que executou busca na web hospedada em si.
+
+Os blocos recusados permanecem no histórico de conversa, então cada volta posterior e `/compact` falham da mesma forma.
+
+**O que fazer:**
+
+* Execute `/clear` ou inicie uma nova sessão; a nova conversa não carrega os blocos recusados
+* Se você executa Claude Code atrás de um proxy ou gateway, relate o erro a quem o opera
+
+
+ Recusa de Política de Uso
+
+
+A API recusou responder porque conteúdo na conversa acionou uma verificação de [Política de Uso](https://www.anthropic.com/legal/aup). A mensagem inclui um ID de Solicitação que você pode citar para suporte se acreditar que a recusa está incorreta.
+
+```text theme={null}
+API Error: Opus 4.6 can't help with this. Start a new session to continue.
+
+Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup
+```
+
+A mensagem nomeia o modelo que recusou, ou `Claude` quando nenhum modelo é registrado.
+
+A verificação avalia a conversa completa, não apenas seu prompt mais recente, então enviar uma nova mensagem na mesma sessão geralmente re-aciona a mesma recusa. O mesmo se aplica após sair e reabrir a sessão com `--continue` ou `--resume`, já que a transcrição no disco ainda contém o conteúdo acionador. Em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) e [Microsoft Foundry](/docs/pt/microsoft-foundry), essa mensagem também cobre solicitações que as medidas de segurança do modelo sinalizaram como um tópico de cibersegurança. Veja [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).
+
+Antes da v2.1.219, a mensagem lia `Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.`
+
+**O que fazer:**
+
+* Pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint antes da volta que acionou a recusa, depois reformule ou tome uma abordagem diferente. Veja [Checkpointing](/docs/pt/checkpointing).
+* Se você não conseguir identificar qual volta causou, execute `/clear` para iniciar uma conversa nova no mesmo projeto. Sua conversa anterior é preservada no disco e permanece disponível em `/resume`.
+* Em [modo não interativo](/docs/pt/headless) (`-p`), onde rewind não está disponível, tente novamente com um prompt reformulado em uma nova sessão sem `--continue`. Verificações de política variam por modelo, então alternar para um modelo diferente com `--model` também pode resolver a recusa em alguns casos.
+
+
+ As medidas de segurança sinalizaram um tópico de cibersegurança
+
+
+As medidas de segurança do modelo sinalizaram conteúdo na conversa como um tópico de cibersegurança. A mensagem nomeia o modelo que sinalizou a solicitação:
+
+```text theme={null}
+API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude
+```
+
+A mensagem vincula ao [Programa de Verificação Cibernética](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), que concede acesso para trabalho de cibersegurança legítimo. Em Opus 5.5, que requer v2.1.280 ou posterior, a mensagem abre com `Opus 5.5's safeguards flagged this session` em vez disso. Quando a categoria sinalizada tem um modelo de fallback disponível, Claude Code [alterna modelos](/docs/pt/model-config#automatic-model-fallback) em vez de mostrar esse erro.
+
+Em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) e [Microsoft Foundry](/docs/pt/microsoft-foundry), uma sinalização de cibersegurança produz a mensagem de [recusa de Política de Uso](#usage-policy-refusal) em vez disso.
+
+A proteção em si é do lado do servidor e antecede v2.1.203; lançamentos de cliente desde então mudaram apenas a redação da mensagem.
+De v2.1.203 a v2.1.218, a mensagem lia ` has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center:` seguido pelo mesmo link do centro de ajuda, e sessões interativas acrescentavam `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.`
+Antes da v2.1.203, lia `'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` seguido por um link de formulário de isenção.
+
+**O que fazer:**
+
+* Se seu trabalho requer esse conteúdo, solicite acesso através do [Programa de Verificação Cibernética](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)
+* Se sua solicitação não era sobre um tópico de cibersegurança, execute `/feedback` para relatar o falso positivo
+* Para continuar trabalhando na mesma sessão, pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint antes da volta que acionou a sinalização, depois tome uma abordagem diferente. Veja [Checkpointing](/docs/pt/checkpointing).
+
+
+ Erros de instalação
+
+
+Esses erros aparecem durante a instalação ou atualização do Claude Code, a partir do [script de instalação](/docs/pt/setup#install-claude-code), `claude install`, ou `claude update`. Para problemas de `command not found`, PATH, permissão e TLS durante a configuração, consulte [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install).
+
+
+ A instalação foi interrompida antes de ser concluída
+
+
+O script de instalação relata quando a etapa `claude install` é encerrada por um sinal. No Linux, o código de saída 137 significa que o processo recebeu SIGKILL, e em um host com pouca memória, geralmente é o killer de falta de memória (OOM) do kernel. O script imprime esta explicação e sai com o código 137:
+
+```text theme={null}
+Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
+Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
+```
+
+Para qualquer outro sinal fatal, e para o código de saída 137 no macOS, o script imprime `Installation was killed before it could finish (exit code )` com o código de saída real e omite a explicação de falta de memória. A mensagem vem do script de instalação que macOS e Linux usam, que também cobre instalações dentro do WSL; os scripts de instalação nativos do Windows nunca a imprimem. Antes da v2.1.200, o script saía apenas com a linha `Killed` nua do shell.
+
+**O que fazer:**
+
+* Interrompa outros processos para liberar memória e execute novamente o instalador
+* Adicione espaço de swap ou mude para uma instância maior. Consulte [Install killed on low-memory Linux servers](/docs/pt/troubleshoot-install#install-killed-on-low-memory-linux-servers) para os comandos do arquivo de swap.
+
+
+ A conexão foi interrompida durante o download da atualização
+
+
+A conexão com o servidor de download foi fechada enquanto `claude install`, `claude update`, ou o [atualizador automático](/docs/pt/setup#auto-updates) estava buscando o binário do Claude Code, e as tentativas de repetição não se recuperaram. Claude Code tenta novamente o download quando a conexão cai, a transferência trava ou o arquivo baixado falha em sua soma de verificação, até três tentativas no total. Um erro HTTP concluído, como um 404, não é repetido porque o servidor já respondeu. Antes da v2.1.202, uma única conexão interrompida falhava no download imediatamente com o erro nú `aborted` em vez de tentar novamente.
+
+```text theme={null}
+The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
+```
+
+O texto entre parênteses nomeia qual tentativa falhou e o erro de rede subjacente. `claude update` precede a mensagem com `Error: Failed to install native update` no stderr.
+
+Um download que permanece conectado mas não é concluído em 10 minutos falha com `Download timed out: exceeded the total deadline` em vez disso. Claude Code não tenta novamente um download que expirou, porque uma conexão muito lenta para terminar dentro do prazo não terminará em uma tentativa imediata novamente. As etapas abaixo se aplicam a ambas as mensagens.
+
+A causa usual é um proxy ou gateway que fecha uma transferência longa antes de ser concluída. O binário do Claude Code é um download grande, portanto um limite de conexão de proxy que nunca afeta o tráfego normal da API ainda pode interrompê-lo.
+
+**O que fazer:**
+
+* Execute `claude update` novamente. Em uma rede caso contrário saudável, o download geralmente é bem-sucedido na próxima execução. Para a mensagem de tempo limite, execute-a novamente de uma rede mais rápida ou menos limitada.
+* Se sua rede exigir um proxy, defina `HTTPS_PROXY` antes de executar o instalador ou `claude update`. Consulte [Check network connectivity](/docs/pt/troubleshoot-install#check-network-connectivity).
+* Se um proxy corporativo continuar fechando a transferência, peça à sua equipe de rede para permitir o download completo de `downloads.claude.ai`. Consulte [Network access requirements](/docs/pt/network-config#network-access-requirements).
+* Execute `claude doctor` do seu shell para diagnósticos de instalação
+
+
+ Erros de linha de comando
+
+
+Esses 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.
+
+
+ Conflito entre --bg e --print
+
+
+Esta 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.
+
+```text theme={null}
+--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 ''`.
+```
+
+**O que fazer:**
+
+* Remova `-p` ou `--print`. `--bg` toma o prompt como seu argumento posicional, então `claude --bg ""` é o comando completo. Veja [Dispatch new agents from your shell](/docs/pt/agent-view#from-your-shell).
+* 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 ""`
+
+
+ Configuração inválida de --agents
+
+
+O 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`, `--resume` ou `--continue`, ou define [`CLAUDE_CODE_SAFE_MODE`](/docs/pt/env-vars#variables), Claude Code não verifica o valor e inicia a sessão. Antes da v2.1.242, Claude Code iniciava a sessão mesmo assim e deixava de fora as definições que não conseguia carregar.
+
+```text theme={null}
+Error: Invalid --agents configuration:
+
+```
+
+O 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:
+
+1. Quando o valor não é analisado como JSON, Claude Code imprime uma linha `invalid JSON:` com a mensagem do próprio analisador JSON
+2. 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 problema
+3. Quando um nome de agente começa com `-`, Claude Code imprime `: agent names must not start with '-'`
+
+Quando há mais de 20 linhas de problema, Claude Code imprime as primeiras 20 e substitui o resto por `…and N more`.
+
+**O que fazer:**
+
+* Corrija cada problema que a mensagem lista, depois execute o comando novamente. Veja [the fields a CLI-defined subagent takes](/docs/pt/sub-agents#choose-the-subagent-scope).
+
+
+ Sessões em nuvem não podem ser criadas a partir de uma sessão --restricted
+
+
+Quando 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:
+
+```text theme={null}
+Cloud sessions cannot be created from a --restricted session: they would not enforce it.
+```
+
+**O que fazer:**
+
+* Execute a tarefa localmente na sessão restrita
+* 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í
+
+Antes 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.
+
+
+ Sessões em nuvem estão desabilitadas pela política da sua organização
+
+
+A 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:
+
+```text theme={null}
+Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
+```
+
+A 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.
+
+Esta é 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.
+
+Se 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.
+
+**O que fazer:**
+
+* 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)
+* Se a mensagem disser que não conseguiu verificar a política, verifique sua conexão de rede, depois reinicie Claude Code e tente novamente
+
+
+ O valor --json-schema não é um JSON Schema válido
+
+
+O 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.
+
+```text theme={null}
+Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
+```
+
+O 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.
+
+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`.
+
+**O que fazer:**
+
+* Corrija a parte do esquema que o diagnóstico nomeia, depois execute o comando novamente
+* Se o diagnóstico for `schema too large`, reduza o aninhamento do esquema e a reutilização de `$ref`
+* Veja [Get structured output](/docs/pt/headless#get-structured-output) para um esquema funcionando e comando
+
+
+ Arquivo de configurações excede o limite de 2MiB
+
+
+O 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. Um arquivo de configurações é um pequeno documento JSON, então um arquivo desse tamanho geralmente significa que o caminho aponta para o arquivo errado. 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.
+
+```text theme={null}
+Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
+```
+
+Claude 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`.
+
+**O que fazer:**
+
+* Aponte `--settings` para um arquivo JSON de configurações regular com menos de 2 MiB. Veja [Settings](/docs/pt/settings) para o formato.
+
+
+ O diretório atual não existe mais
+
+
+Você 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.
+
+```text theme={null}
+The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
+error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.
+```
+
+A causa e a correção são as mesmas para ambas as formas.
+
+Quando 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.`
+
+No 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`.
+
+**O que fazer:**
+
+* Mude para um diretório que existe, como seu diretório inicial ou de projeto, depois execute `claude` novamente
+* 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` novamente
+* 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 terminal
+
+
+ Diretório temporário recusado ou não pode ser criado
+
+
+No macOS e Linux, Claude Code cria um diretório temporário privado na inicialização, `claude-` 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:
+
+```text wrap theme={null}
+ENOSPC: no space left on device, mkdir '/tmp/claude-501'
+
+Temp directory /tmp/claude-501 is not a directory (may be an attacker-planted symlink). Refusing to use it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.
+
+Temp directory /tmp/claude-501 is owned by uid 502, expected 501. Refusing to use it — another user may have pre-created it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.
+
+Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.
+```
+
+**O que fazer:**
+
+* Para `ENOSPC`, libere espaço em disco no volume que contém o diretório temporário
+* 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ê-la
+* Para `is not readable`, execute `chmod 0700` no diretório nomeado, ou remova-o e inicie novamente
+* 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 sozinho
+
+
+ Diretório não pôde ser resolvido para um local real
+
+
+Você 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.
+
+Você 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:
+
+```text theme={null}
+packages/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.
+```
+
+**O que fazer:**
+
+* Verifique se o caminho nomeia um diretório real dentro do diretório de trabalho, depois execute `/add-dir` novamente
+* A mensagem não muda seu acesso a arquivo; ela apenas relata que o conteúdo `.claude/` do diretório não foi carregado
+
+Antes da v2.1.261, essa mensagem também aparecia para cada `/add-dir ` quando o diretório de trabalho estava em um automount `/net/`, onde Claude Code recusa resolver caminhos por design; o diretório estava bem e tentar novamente não poderia ajudar.
+
+
+ Workspace não confiável ao iniciar Remote Control
+
+
+Você 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. O comando não mostra o diálogo de confiança do workspace em si, então sai com código 1 e nomeia a correção:
+
+```text theme={null}
+Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
+```
+
+Em 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á.
+
+```text theme={null}
+Error: 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).
+```
+
+**O que fazer:**
+
+* Execute `claude` no diretório, aceite o [diálogo de confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust), depois execute `claude remote-control` novamente
+* Em seu diretório inicial, mude para um diretório de projeto e inicie Remote Control lá
+
+
+ Não levado para as sessões que Remote Control inicia
+
+
+Você 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:
+
+```text theme={null}
+Error: `--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`).
+```
+
+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 wrapper: ele as ignora e Remote Control inicia.
+
+Claude 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.
+
+**O que fazer:**
+
+* 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
+* Quando a flag recusada é `--permission-mode`, execute `claude remote-control --permission-mode ` para definir o modo de permissão para as sessões que Remote Control inicia
+
+Antes 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.
+
+
+ claude import ainda não está disponível nesta compilação
+
+
+Você 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.
+
+```text theme={null}
+`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
+```
+
+Claude 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:
+
+* 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ê.
+* 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.
+* 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.
+
+**O que fazer:**
+
+* Em uma instalação nova, inicie `claude`, aguarde o carregamento da sessão, saia e execute `claude import` novamente
+* 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.
+
+
+ Não foi possível ler a configuração do Claude Code
+
+
+Você 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.
+
+```text theme={null}
+Could not read Claude Code config — run `claude` with no arguments to recover it.
+```
+
+**O que fazer:**
+
+* Execute `claude` sem argumentos. Claude Code detecta o arquivo inválido e oferece redefini-lo. Depois execute `claude import` novamente.
+* 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` novamente
+
+
+ Não foi possível importar um servidor do Claude Desktop
+
+
+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 falhou parou a importação e nenhum dos servidores selecionados foi adicionado.
+
+```text theme={null}
+Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
+```
+
+O 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.
+
+**O que fazer:**
+
+* 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` novamente
+* 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).
+
+
+ Não é possível adicionar servidor MCP ao escopo gerenciado
+
+
+Você 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.
+
+```text theme={null}
+Cannot add MCP server to scope: managed
+```
+
+**O que fazer:**
+
+* 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)
+* 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ê implanta
+
+
+ Não é possível ler .mcp.json
+
+
+Um 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.
+
+```text theme={null}
+Can'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.
+```
+
+Antes 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.
+
+**O que fazer:**
+
+* 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.
+
+
+ Servidor é hospedado pela Anthropic e não suporta OAuth local
+
+
+Você 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).
+
+```text theme={null}
+"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.
+```
+
+Claude 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.
+
+**O que fazer:**
+
+* Remova sua entrada com `claude mcp remove `, para que não possa ocultar o conector claude.ai na mesma URL
+* 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.ai
+
+
+
+Um 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:
+
+```text theme={null}
+Server 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.
+```
+
+Claude 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.
+
+**O que fazer:**
+
+* 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 aceita
+* Depois de corrigir o helper ou sua fonte de credencial, selecione o servidor em `/mcp` e escolha **Reconnect**
+
+Antes 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.
+
+
+
+A 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.
+
+```text theme={null}
+Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
+```
+
+A lista após `Available MCP tools:` nomeia as ferramentas MCP que estavam conectadas quando a espera terminou.
+
+**O que fazer:**
+
+* Verifique se o servidor inicia e permanece conectado: execute `claude mcp list` no mesmo diretório e confirme se o servidor está listado como conectado
+* Confirme se o nome da ferramenta corresponde ao nome `mcp____` que o servidor expõe
+* Se o servidor precisa de mais de 30 segundos para iniciar, aumente [`MCP_TIMEOUT`](/docs/pt/env-vars)
+
+
+ Porta de callback OAuth já está em uso
+
+
+Quando 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.
+
+```text theme={null}
+OAuth callback port is already in use — another process may be holding it. Run `lsof -ti: -sTCP:LISTEN` to find it.
+```
+
+No Windows, o comando sugerido é `netstat -ano | findstr :` em vez disso.
+
+**O que fazer:**
+
+* Execute o comando da mensagem para encontrar o processo que mantém a porta e pare-o ou aguarde que termine
+* 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ê usar
+* Depois inicie o sign-in novamente, por exemplo selecionando o servidor em `/mcp`
+
+
+ Nenhuma porta disponível para redirecionamento OAuth
+
+
+Quando 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.
+
+```text theme={null}
+No available ports for OAuth redirect
+```
+
+Antes 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.
+
+**O que fazer:**
+
+* 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 local
+* Depois inicie o sign-in novamente, por exemplo selecionando o servidor em `/mcp`
+
+
+ /security-review falha sem origin/HEAD
+
+
+[`/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.
+
+```text theme={null}
+Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
+fatal: ambiguous argument 'origin/HEAD...': unknown revision or path not in the working tree.
+Use '--' to separate paths from revisions, like this:
+'git [...] -- [...]'
+```
+
+A 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:
+
+* Um checkout de branch único ou CI, que busca um refspec muito estreito
+* Um remote cujo HEAD do lado do servidor aponta para um branch que ninguém fez push
+* Um repositório sem remote `origin`, ou um que você nunca buscou
+
+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 disparam antes do comando ser executado:
+
+* `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`
+* ``Skill 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)
+
+**O que fazer:**
+
+* Crie a ref nomeando o branch padrão do seu remote: `git remote set-head origin `. Isso funciona sempre que a ref de rastreamento local `origin/` existe. Se não existir, como em clones de branch único, busque o branch primeiro: execute `git remote set-branches --add origin `, depois `git fetch origin`, depois execute novamente o comando set-head. Execute `/security-review` novamente.
+* 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.
+* Se o repositório não tem remote, adicione um com `git remote add origin ` 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.
+
+
+
+`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.
+
+```text theme={null}
+Error: Input must be provided either through stdin or as a prompt argument when using --print
+```
+
+**O que fazer:**
+
+* 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ída
+* Para uso único, passe o prompt: `claude -p "your question"`, ou canalize-o com `echo "your question" | claude -p`
+
+
+
+Em [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:
+
+* **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`
+* **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.`
+
+Antes 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.
+
+**O que fazer:**
+
+* 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.
+
+
+
+Seu 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.
+
+```text theme={null}
+Error: 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.
+```
+
+Entrada 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.
+
+**O que fazer:**
+
+* 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 linha
+* Para enviar texto simples em vez disso, remova `--input-format stream-json`; `claude -p` lê um prompt de texto simples de stdin por padrão
+
+
+ Comando desconhecido
+
+
+Em 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:
+
+```text theme={null}
+Unknown command: /hepl. Did you mean /help?
+```
+
+Claude 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:
+
+* 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 enviar
+* 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)
+* 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ão
+
+Claude 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:
+
+* execuções `-p`
+* aplicações [Agent SDK](/docs/pt/agent-sdk/overview)
+* A aba Code do [aplicativo Desktop](/docs/pt/desktop)
+* O painel de chat da [extensão VS Code](/docs/pt/vs-code)
+* [Sessões em nuvem](/docs/pt/claude-code-on-the-web) e [rotinas](/docs/pt/routines)
+
+Para 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`.
+
+Claude 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`.
+
+Antes 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.
+
+**O que fazer:**
+
+* Execute o nome sugerido, ou digite `/` seguido de parte do nome para ver o que está disponível nessa sessão
+* Se Claude Code relata um comando documentado como desconhecido, verifique sua linha na [referência de comandos](/docs/pt/commands) para o requisito que nomeia
+
+
+ Diff é muito grande para ultrareview
+
+
+O 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.
+
+```text theme={null}
+Diff 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 `) to narrow the scope, or split the change.
+```
+
+Revisar um pull request aplica os mesmos limites; essa forma da mensagem começa `PR # is too large for ultrareview` e nomeia as contagens de arquivo e linha do PR.
+
+**O que fazer:**
+
+* 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 branch
+* 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.
+
+
+ Não foi possível encontrar merge-base com o branch base
+
+
+`/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.
+
+```text theme={null}
+Could 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.
+```
+
+A dica após a primeira sentença depende do que Claude Code observou:
+
+* **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 acima
+* **Você passou um branch base que já estava em seu clone**: a dica lê ``Make sure exists locally or on origin (try `git fetch origin `)``
+* **Você passou um branch base que não estava em seu clone**: Claude Code o buscou de origin antes de comparar. A dica lê `` was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra `)``; 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`.
+
+**O que fazer:**
+
+* Se outro branch é seu base real, passe-o explicitamente: `/code-review ultra `
+* Se seu clone pode não ter histórico completo, execute `git fetch --unshallow origin` e execute a revisão novamente
+
+
+ Seu checkout não tem branches
+
+
+Um checkout pode ter commits mas nenhum branch: se você executar `git init` seguido de `git fetch ` 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.
+
+```text theme={null}
+Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b ` — then rerun /code-review ultra.
+```
+
+Antes da v2.1.221, Claude Code tentava revisar cada arquivo rastreado nesse checkout, e o carregamento falhava.
+
+**O que fazer:**
+
+* Crie um branch em seu commit atual com `git checkout -b `, depois execute a revisão novamente
+
+
+ Nenhuma conta GitHub está conectada à sua conta Claude
+
+
+Você executou `/code-review ultra ` ou `claude ultrareview `, 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.
+
+```text theme={null}
+Ultrareview clones / 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).
+```
+
+Quando [`/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.
+
+**O que fazer:**
+
+* 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)
+* Execute a revisão novamente um minuto após conectar
+
+Antes da v2.1.248, Claude Code não verificava isso antes do lançamento.
+
+
+ Sua conta GitHub conectada não consegue ver o repositório
+
+
+Você executou `/code-review ultra ` ou `claude ultrareview `, 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.
+
+```text theme={null}
+Your connected GitHub account can't see / — usually the Claude GitHub app isn't installed on 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.
+```
+
+Quando [`/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.
+
+**O que fazer:**
+
+* Se seu CLI `gh` local consegue ler o repositório, execute `/web-setup` para conectar esse login à sua conta Claude
+* Execute a revisão após a mudança
+
+Antes da v2.1.248, Claude Code não verificava isso antes do lançamento.
+
+
+ A verificação prévia do GitHub App falhou transitoriamente
+
+
+Você 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 ()`, e termina com a sentença de verificação prévia:
+
+```text theme={null}
+Could not upload repo bundle (). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
+```
+
+**O que fazer:**
+
+* 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çamento
+* 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 disso
+
+Antes 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.
+
+
+ GitHub não está conectado à sua conta Claude
+
+
+Você 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:
+
+```text theme={null}
+GitHub 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
+```
+
+Quando você cria uma rotina com [`/schedule`](/docs/pt/routines), a mesma mensagem aparece como uma nota de configuração que nomeia o repositório; a nota não bloqueia a criação da rotina.
+
+**O que fazer:**
+
+* 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.
+* Execute o comando novamente um minuto após conectar
+
+Antes 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.
+
+
+ Autorização de single sign-on necessária
+
+
+Você 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:
+
+```text theme={null}
+Single sign-on authorization needed
+/ belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.
+```
+
+**O que fazer:**
+
+* 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-on
+* 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ção
+* Execute `/install-github-app` novamente
+
+Antes da v2.1.273, Claude Code mostrava o aviso `Admin permissions required` para essa condição em vez disso.
+
+
+ Falha ao retomar a conversa
+
+
+Claude 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:
+
+```text theme={null}
+Failed to resume the conversation.
+Run claude --resume to retry, or claude to start a new session.
+```
+
+Claude 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.
+
+**O que fazer:**
+
+* Execute `claude --resume ` com o ID da sessão da mensagem para tentar novamente
+* 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.
+* Se a tentativa novamente falhar, execute `claude` para iniciar uma nova sessão
+
+
+ Nenhuma conversa encontrada com o ID da sessão
+
+
+Você passou um ID de sessão para `claude --resume ` e nenhuma transcrição salva correspondeu:
+
+```text theme={null}
+No conversation found with session ID:
+```
+
+Claude 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.
+
+Causas comuns:
+
+* **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)
+* **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)
+* **Máquina diferente**: Claude Code armazena transcrições localmente, então retome a sessão na máquina onde foi executada
+* **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 arbitrariamente
+
+**O que fazer:**
+
+* 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ão
+* 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 imprimiu
+
+
+ Não é possível alternar renderizadores nesta sessão
+
+
+Quando 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:
+
+* `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` novamente
+* `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 elas
+
+Na mensagem de restrições, a parte entre parênteses nomeia as restrições que Claude Code encontrou:
+
+```text theme={null}
+Cannot 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.
+```
+
+Cada motivo que a mensagem pode mostrar entre parênteses:
+
+* `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)
+* `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 disso
+* `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 pergunta
+* `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 valor
+
+**O que fazer:**
+
+* 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á
+
+
+ Não foi possível abrir Claude Desktop
+
+
+Você executou [`/desktop`](/docs/pt/desktop#coming-from-the-cli), ou seu alias `/app`, e o comando do sistema que Claude Code usa para abrir Claude Desktop falhou. A sessão permanece no terminal.
+
+```text theme={null}
+Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session= with error -10814). Open Claude Desktop and run /desktop again.
+```
+
+**O que fazer:**
+
+* Abra Claude Desktop você mesmo, depois execute `/desktop` novamente
+* Para ler a saída de erro completa desse comando, ative o log de debug com `/debug`, execute `/desktop` novamente e verifique o log de debug
+
+Antes da v2.1.275, a mensagem era `Failed to open Claude Desktop. Please try opening it manually.` e não dizia o que falhou.
+
+
+ /terminal-setup deixou seu mapa de teclas Zed inalterado
+
+
+Você 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.
+
+Cada mensagem nomeia o caminho para seu mapa de teclas e termina com o bloco de atalho de teclado para adicionar você mesmo:
+
+```text theme={null}
+Couldn't update your Zed keymap, so it was left unchanged.
+To add the binding yourself, add this block to the keymap array in :
+{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
+```
+
+A primeira linha da mensagem nomeia a causa:
+
+* `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 arquivo
+* `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 permitidas
+* `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 nada
+* `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 isso
+
+**O que fazer:**
+
+* Copie o bloco da mensagem para o array de nível superior em seu `keymap.json` no caminho que a mensagem nomeia
+* 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` novamente
+
+Antes 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).
+
+
+ Relatórios de uso de skill não estão disponíveis nesta conexão
+
+
+Você 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:
+
+```text theme={null}
+Skill usage reports are not available on this connection.
+```
+
+**O que fazer:**
+
+* Execute `/skill-doctor` no terminal na máquina onde a sessão está em execução, ou execute `claude -p "/skill-doctor"` lá
+
+
+ Estilos de saída personalizados não podem ser selecionados sobre Remote Control
+
+
+Você 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:
+
+```text theme={null}
+Custom 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.
+```
+
+**O que fazer:**
+
+* Escolha um estilo integrado, por exemplo `/output-style concise`
+* Para usar um estilo personalizado, defina [`outputStyle`](/docs/pt/settings-reference#outputstyle) em `.claude/settings.local.json` do projeto, ou execute `/output-style