8 8
9Esta página lista erros de tempo de execução que o Claude Code exibe e como se recuperar de cada um, além do que verificar quando as respostas parecem estar erradas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install).9Esta página lista erros de tempo de execução que o Claude Code exibe e como se recuperar de cada um, além do que verificar quando as respostas parecem estar erradas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install).
10 10
11Exceto pelos [erros de Wrapper e IDE](#wrapper-and-ide-errors), que o programa de inicialização imprime em vez do próprio Claude Code, esses erros e comandos de recuperação se aplicam em toda a CLI, 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.11Exceto pelos [erros de Wrapper e IDE](#wrapper-and-ide-errors), que o programa de inicialização imprime em vez do próprio Claude Code, esses erros e comandos de recuperação se aplicam em toda a CLI, no [aplicativo Desktop](/docs/pt/desktop) e [sessões em nuvem](/docs/pt/claude-code-on-the-web), já que todos os três envolvem o mesmo CLI do Claude Code. Para outros problemas específicos da superfície, consulte a seção de solução de problemas na página dessa superfície.
12 12
13<Note>13<Note>
14 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).14 O Claude Code chama a API Claude para respostas de modelo, portanto, a maioria dos erros de tempo de execução mapeia para um código de erro de API subjacente. Esta página cobre o que cada erro significa dentro do Claude Code e como se recuperar. Para as definições de código de status HTTP bruto, consulte a [referência de erro da Plataforma Claude](https://platform.claude.com/docs/en/api/errors).
15</Note>15</Note>
16 16
17<h2 id="find-your-error">17<h2 id="find-your-error">
24| :- | :- |24| :- | :- |
25| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |
26| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |
27| `Opus is experiencing high load` / `Fable is experiencing high load` | [Server errors](#api-error-repeated-529-overloaded-errors) |
27| `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 |28| `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 |
28| `API Error: No response from API` | [Server errors](#no-response-from-api) |29| `API Error: No response from API` | [Server errors](#no-response-from-api) |
29| `Server error mid-response. The response above may be incomplete.` | [Server errors](#the-response-above-may-be-incomplete) |30| `Server error mid-response. The response above may be incomplete.` | [Server errors](#the-response-above-may-be-incomplete) |
30| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Server errors](#the-response-above-may-be-incomplete) |31| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Server errors](#the-response-above-may-be-incomplete) |
31| `Connection closed mid-response` / `Response stalled mid-stream` | [Server errors](#the-response-above-may-be-incomplete) |32| `Connection closed mid-response` / `Response stalled mid-stream` | [Server errors](#the-response-above-may-be-incomplete) |
33| `Part of the response never arrived` / `The response stream was malformed` | [Server errors](#the-response-above-may-be-incomplete) |
34| `API Error: Content block not found` / `API Error: Content block already closed` / `API Error: Stream event unreadable` | [Server errors](#the-response-above-may-be-incomplete) |
32| `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) |35| `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) |
33| `Connection closed while thinking` / `Response stalled while thinking` | [Automatic retries](#automatic-retries) |36| `Connection closed while thinking` / `Response stalled while thinking` | [Automatic retries](#automatic-retries) |
34| `Connection lost while your computer was asleep` | [Automatic retries](#automatic-retries) |37| `Connection lost while your computer was asleep` | [Automatic retries](#automatic-retries) |
49| `Could not update your spend limit` | [Usage limits](#could-not-update-your-spend-limit) |52| `Could not update your spend limit` | [Usage limits](#could-not-update-your-spend-limit) |
50| `spend limit reached` / `spend limit unavailable` | [Usage limits](#spend-limit-reached) |53| `spend limit reached` / `spend limit unavailable` | [Usage limits](#spend-limit-reached) |
51| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |54| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |
55| `Couldn't save your login` | [Authentication](#couldnt-save-your-login) |
56| `Authentication required · Sign in again to continue` | [Authentication](#not-logged-in) |
52| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |57| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |
53| `Invalid API key` | [Authentication](#invalid-api-key) |58| `Invalid API key` | [Authentication](#invalid-api-key) |
54| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |59| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |
69| `signed-in claude.ai account or organization changed on this machine` | [Authentication](#remote-control-stopped-because-the-signed-in-account-changed) |74| `signed-in claude.ai account or organization changed on this machine` | [Authentication](#remote-control-stopped-because-the-signed-in-account-changed) |
70| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |75| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
71| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |76| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
77| `Couldn't verify your organization's policy for remote control` | [Troubleshoot Remote Control](/docs/pt/remote-control#couldnt-verify-your-organizations-policy-for-remote-control) |
72| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |78| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |
73| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |79| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |
74| `Login expired · Please run /login` | [Authentication](#login-expired) |80| `Login expired · Please run /login` | [Authentication](#login-expired) |
81| `Failed to start OAuth callback server` | [Authentication](#failed-to-start-oauth-callback-server) |
75| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |82| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |
76| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |83| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |
77| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |84| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
78| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |85| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
79| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |86| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |
87| `Could not refresh your login because another Claude Code process is refreshing it` | [Authentication](#could-not-refresh-your-login) |
88| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [Authentication](#could-not-refresh-your-login) |
80| `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) |89| `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) |
81| `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) |90| `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) |
82| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentication](#anthropic-profile-login-expired) |91| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentication](#anthropic-profile-login-expired) |
120| `Couldn't reconnect to your Remote Control session` | [Network](#couldnt-reconnect-to-your-remote-control-session) |129| `Couldn't reconnect to your Remote Control session` | [Network](#couldnt-reconnect-to-your-remote-control-session) |
121| `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) |130| `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) |
122| `Couldn't share the transcript.` | [Network](#couldnt-share-the-transcript) |131| `Couldn't share the transcript.` | [Network](#couldnt-share-the-transcript) |
132| `Couldn't send feedback` | [Network](#couldnt-send-feedback) |
123| `Prompt is too long` / `Input is too long for requested model` | [Request errors](#prompt-is-too-long) |133| `Prompt is too long` / `Input is too long for requested model` | [Request errors](#prompt-is-too-long) |
124| `Prompt is too long · automatic compaction failed:` | [Request errors](#prompt-is-too-long) |134| `Prompt is too long · automatic compaction failed:` | [Request errors](#prompt-is-too-long) |
125| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Request errors](#prompt-is-too-long) |135| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Request errors](#prompt-is-too-long) |
131| `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) |141| `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) |
132| `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) |142| `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) |
133| `Context exceeds the ...-token limit by ... tokens` na saída `/context` | [Request errors](#context-exceeds-the-token-limit) |143| `Context exceeds the ...-token limit by ... tokens` na saída `/context` | [Request errors](#context-exceeds-the-token-limit) |
134| `Error during compaction: Conversation too long` | [Request errors](#error-during-compaction-conversation-too-long) |
135| `Request too large` | [Request errors](#request-too-large) |144| `Request too large` | [Request errors](#request-too-large) |
136| `Request too large for the API's 32MB request limit` | [Request errors](#request-too-large) |145| `Request too large for the API's 32MB request limit` | [Request errors](#request-too-large) |
137| `Image was too large` | [Request errors](#image-was-too-large) |146| `Image was too large` | [Request errors](#image-was-too-large) |
138| `Unable to resize image` | [Request errors](#unable-to-resize-image) |147| `Unable to resize image` | [Request errors](#unable-to-resize-image) |
139| `PDF too large` / `PDF is password protected` | [Request errors](#pdf-errors) |148| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Request errors](#pdf-errors) |
140| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |149| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |
141| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |150| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |
151| `tool_use.name: String should have at most 200 characters` | [Request errors](#tool-use-name-over-200-characters) |
142| `There's an issue with the selected model` | [Request errors](#theres-an-issue-with-the-selected-model) |152| `There's an issue with the selected model` | [Request errors](#theres-an-issue-with-the-selected-model) |
143| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |153| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |
144| `Model ... not found` | [Request errors](#model-not-found) |154| `Model ... not found` | [Request errors](#model-not-found) |
155| `API error: ... · model not changed` | [Request errors](#api-error-model-not-changed) |
145| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |156| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |
146| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |157| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |
147| `Claude Code ... is older than the minimum version required by your organization's policy` | [Request errors](#claude-code-does-not-support-this-model) |158| `Claude Code ... is older than the minimum version required by your organization's policy` | [Request errors](#claude-code-does-not-support-this-model) |
148| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organizations-settings) |159| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organizations-settings) |
160| `Model ... is not available. Your organization restricts model selection.` | [Request errors](#model-is-restricted-by-your-organizations-settings) |
149| `Model switch ... blocked by a PreModelSwitch hook` | [Request errors](#model-switch-was-blocked-by-a-premodelswitch-hook) |161| `Model switch ... blocked by a PreModelSwitch hook` | [Request errors](#model-switch-was-blocked-by-a-premodelswitch-hook) |
150| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Request errors](#couldnt-save-it-as-your-default) |162| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Request errors](#couldnt-save-it-as-your-default) |
151| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |163| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |
155| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |167| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |
156| `API Error: 400 orphaned tool_result in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |168| `API Error: 400 orphaned tool_result in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |
157| `API Error: 400 duplicate tool_use ID in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |169| `API Error: 400 duplicate tool_use ID in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |
170| `Invalid data in redacted_thinking block` | [Request errors](#invalid-data-in-redacted-thinking-block) |
158| `[Unsupported tool content removed]` | [Request errors](#unsupported-tool-content-removed) |171| `[Unsupported tool content removed]` | [Request errors](#unsupported-tool-content-removed) |
159| `role 'system' must precede an 'assistant' message` | [Request errors](#role-system-must-precede-an-assistant-message) |172| `role 'system' must precede an 'assistant' message` | [Request errors](#role-system-must-precede-an-assistant-message) |
160| `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) |173| `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) |
174| `Invalid encrypted_stdout in encrypted_code_execution_result block` | [Request errors](#invalid-encrypted-content-in-search-result-block) |
161| `server_tool_use.name: Input should be` em cada turno de uma sessão retomada | [Request errors](#unsupported-tool-content-removed) |175| `server_tool_use.name: Input should be` em cada turno de uma sessão retomada | [Request errors](#unsupported-tool-content-removed) |
162| `<model> can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |176| `<model> can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |
163| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |177| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |
164| `<model>'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |178| `<model>'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
165| `Opus 5.5's safeguards flagged this session` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |179| `<model>'s safeguards flagged this session` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
166| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |180| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
167| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |181| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |
168| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |182| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
169| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |183| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
170| `--bg and --print conflict` | [Command-line errors](#command-line-errors) |184| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |
171| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |185| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
172| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |186| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
173| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |187| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
174| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#command-line-errors) |188| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#the-json-schema-value-is-not-a-valid-json-schema) |
175| `Error: Invalid --agents configuration:` | [Command-line errors](#invalid-agents-configuration) |189| `Error: Invalid --agents configuration:` | [Command-line errors](#invalid-agents-configuration) |
190| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Command-line errors](#invalid-agents-configuration) |
191| `Error: --agents file not found` | [Command-line errors](#invalid-agents-configuration) |
176| `Error: Settings file exceeds the 2MiB limit` | [Command-line errors](#settings-file-exceeds-the-2mib-limit) |192| `Error: Settings file exceeds the 2MiB limit` | [Command-line errors](#settings-file-exceeds-the-2mib-limit) |
177| `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) |193| `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) |
178| `Temp directory <dir> ... Refusing to use it` / `ENOSPC: no space left on device, mkdir '<dir>'` | [Command-line errors](#temp-directory-refused-or-cannot-be-created) |194| `Temp directory <dir> ... Refusing to use it` / `ENOSPC: no space left on device, mkdir '<dir>'` | [Command-line errors](#temp-directory-refused-or-cannot-be-created) |
207| `Single sign-on authorization needed` | [Command-line errors](#single-sign-on-authorization-needed) |223| `Single sign-on authorization needed` | [Command-line errors](#single-sign-on-authorization-needed) |
208| `Failed to resume the conversation` | [Command-line errors](#failed-to-resume-the-conversation) |224| `Failed to resume the conversation` | [Command-line errors](#failed-to-resume-the-conversation) |
209| `No conversation found with session ID: <session-id>` | [Command-line errors](#no-conversation-found-with-the-session-id) |225| `No conversation found with session ID: <session-id>` | [Command-line errors](#no-conversation-found-with-the-session-id) |
226| `Windows reported an error (EBADF) when Claude Code read this session's transcript file` | [Command-line errors](#windows-reported-an-error-ebadf) |
210| `Cannot switch renderers in this session` | [Command-line errors](#cannot-switch-renderers-in-this-session) |227| `Cannot switch renderers in this session` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
211| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |228| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
212| `Couldn't open Claude Desktop` | [Command-line errors](#couldnt-open-claude-desktop) |229| `Couldn't open Claude Desktop` | [Command-line errors](#couldnt-open-claude-desktop) |
218| `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) |235| `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) |
219| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |236| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |
220| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |237| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |
238| `Claude Code refuses the marketplace name "<name>"` | [Plugin errors](#claude-code-refuses-the-marketplace-name) |
239| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin errors](#claude-code-refuses-the-marketplace-name) |
221| `Marketplace "<name>" is already added from a different source` | [Plugin errors](#marketplace-is-already-added-from-a-different-source) |240| `Marketplace "<name>" is already added from a different source` | [Plugin errors](#marketplace-is-already-added-from-a-different-source) |
222| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin errors](#marketplace-name-is-another-spelling-of-a-reserved-name) |241| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin errors](#marketplace-name-is-another-spelling-of-a-reserved-name) |
223| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |242| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |
231| `Failed to load marketplace configuration` | [Plugin errors](#failed-to-load-marketplace-configuration) |250| `Failed to load marketplace configuration` | [Plugin errors](#failed-to-load-marketplace-configuration) |
232| `Marketplace configuration file is corrupted` | [Plugin errors](#failed-to-load-marketplace-configuration) |251| `Marketplace configuration file is corrupted` | [Plugin errors](#failed-to-load-marketplace-configuration) |
233| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Plugin errors](#plugin-is-required-by-your-organization) |252| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Plugin errors](#plugin-is-required-by-your-organization) |
253| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [Plugin errors](#plugin-was-not-uninstalled) |
254| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [Plugin errors](#plugin-was-not-uninstalled) |
234| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |255| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |
235| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |256| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |
257| `cannot contain null bytes (\0)` | [Tool errors](#path-cannot-contain-null-bytes) |
258| `Path contains null bytes` | [Tool errors](#path-cannot-contain-null-bytes) |
236| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |259| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |
237| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |260| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |
238| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |261| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |
241| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |264| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |
242| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |265| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |
243| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |266| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |
267| `Cross-session message was dropped at the recipient session's inbox` | [Tool errors](#cross-session-message-dropped-at-the-inbox) |
244| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Tool errors](#refusing-to-send-a-cross-session-message) |268| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Tool errors](#refusing-to-send-a-cross-session-message) |
245| `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) |
246| `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) |
247| `Refusing to send: connected endpoint is a different process with the expected pid` | [Tool errors](#refusing-to-send-a-cross-session-message) |
248| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Tool errors](#refusing-after-a-symlink-changed) |269| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Tool errors](#refusing-after-a-symlink-changed) |
249| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Tool errors](#refusing-after-a-symlink-changed) |270| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Tool errors](#refusing-after-a-symlink-changed) |
250| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Tool errors](#refusing-after-a-symlink-changed) |271| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Tool errors](#refusing-after-a-symlink-changed) |
272| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [Tool errors](#refusing-after-a-symlink-changed) |
251| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Tool errors](#refusing-after-a-symlink-changed) |273| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Tool errors](#refusing-after-a-symlink-changed) |
252| `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) |274| `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) |
253| `task output swap refused (tasks dir moved or linked)` | [Tool errors](#task-output-swap-refused) |275| `task output swap refused (tasks dir moved or linked)` | [Tool errors](#task-output-swap-refused) |
254| `Command killed: its output file was replaced or could no longer be verified` | [Tool errors](#task-output-swap-refused) |276| `Command killed: its output file was replaced or could no longer be verified` | [Tool errors](#task-output-swap-refused) |
277| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
278| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
279| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
255| `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) |280| `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) |
256| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |281| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
257| `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) |282| `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) |
279| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |304| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |
280| `exited before it became reachable` | [Background session errors](#background-service-exited-before-it-became-reachable) |305| `exited before it became reachable` | [Background session errors](#background-service-exited-before-it-became-reachable) |
281| `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) |306| `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) |
307| `Workspace not trusted.` ao iniciar ou reiniciar uma sessão em background | [Background session errors](#workspace-not-trusted-when-dispatching-a-background-session) |
282| `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) |308| `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) |
283| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |309| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |
284| `The connection to Claude Code ended before this message completed` | [Wrapper and IDE errors](#the-connection-to-claude-code-ended-before-this-message-completed) |310| `The connection to Claude Code ended before this message completed` | [Wrapper and IDE errors](#the-connection-to-claude-code-ended-before-this-message-completed) |
291| `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) |317| `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) |
292| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |318| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |
293| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |319| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |
320| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Configuration warnings](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |
294| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |321| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |
295| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |322| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |
296| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |323| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |
297| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |324| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |
325| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Configuration warnings](#managed-settings-block-the-default-model) |
298| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |326| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |
299| `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) |327| `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) |
300| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |328| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |
313 Tentativas automáticas341 Tentativas automáticas
314</h2>342</h2>
315 343
316Claude 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.344Claude 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.
317 345
318Claude Code tenta novamente estas falhas:346Claude Code tenta novamente estas falhas:
319 347
390 418
391A 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.419A 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.
392 420
393Isso indica uma falha inesperada dentro da API. Não é causado pelo seu prompt, configurações ou conta.421Um 5xx da própria API indica uma falha inesperada dentro da API. Não é causado pelo seu prompt, configurações ou conta.
422
423Quando um proxy, balanceador de carga ou gateway responde com uma página de erro HTML, a mensagem mostra o código de status e o título da página, como `API Error: 502 Bad Gateway`. Para uma página sem título, a mensagem mostra o código de status e seu nome padrão. Antes da v2.1.281, o código de status era descartado quando a página tinha um título, e a marcação bruta da página era impressa quando não tinha nenhum.
394 424
395**O que fazer:**425**O que fazer:**
396 426
416 446
417* Verifique [status.claude.com](https://status.claude.com) ou a página de status do provedor nomeada na mensagem para avisos de capacidade447* Verifique [status.claude.com](https://status.claude.com) ou a página de status do provedor nomeada na mensagem para avisos de capacidade
418* Tente novamente em alguns minutos448* Tente novamente em alguns minutos
419* Execute `/model` e mude para um modelo diferente para continuar trabalhando, já que a capacidade é rastreada por modelo. Claude Code o solicita fazer isso quando um modelo está sob carga particularmente alta, por exemplo `Opus is experiencing high load, please use /model to switch to Sonnet`.449* Execute `/model` e mude para um modelo diferente para continuar trabalhando, já que a capacidade é rastreada por modelo. Claude Code o solicita fazer isso quando um modelo está sob carga particularmente alta, por exemplo `Opus is experiencing high load, please use /model to switch to Sonnet`. Em modelos Fable a mensagem nomeia Fable.
450
451 Em uma sessão que o Claude Desktop app executa, como a aba Code ou Cowork, a mensagem lê `Opus is experiencing high load. Switch to Sonnet.` e você muda modelos com o seletor de modelo do app.
420 452
421<h3 id="request-timed-out">453<h3 id="request-timed-out">
422 Request timed out454 Request timed out
433**O que fazer:**465**O que fazer:**
434 466
435* Tente novamente a solicitação467* Tente novamente a solicitação
436* Para tarefas de longa duração, divida o trabalho em prompts menores
437* Se uma rede lenta ou proxy for a causa, aumente `API_TIMEOUT_MS` conforme descrito em [Automatic retries](#automatic-retries)468* Se uma rede lenta ou proxy for a causa, aumente `API_TIMEOUT_MS` conforme descrito em [Automatic retries](#automatic-retries)
438* Se os tempos limite forem frequentes e sua rede estiver saudável, veja [Network and connection errors](#network-and-connection-errors) abaixo469* Se os tempos limite forem frequentes e sua rede estiver saudável, veja [Network and connection errors](#network-and-connection-errors) abaixo
439 470
457**O que fazer:**488**O que fazer:**
458 489
459* 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.490* 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.
460* 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.491* Se se repetir, trate como um [problema de rede ou proxy](#unable-to-connect-to-api).
461* 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.492* 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.
462* 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.493* 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.
463 494
474API Error: Connection lost mid-response. The response above may be incomplete.505API Error: Connection lost mid-response. The response above may be incomplete.
475API Error: Your computer went to sleep mid-response. The response above may be incomplete.506API Error: Your computer went to sleep mid-response. The response above may be incomplete.
476API Error: The response stopped arriving. The response above may be incomplete.507API Error: The response stopped arriving. The response above may be incomplete.
508API Error: Part of the response never arrived. The response above may be incomplete.
509API Error: The response stream was malformed. The response above may be incomplete.
477```510```
478 511
479* `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.512* `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.
480* `Connection lost mid-response`: a conexão foi interrompida.513* `Connection lost mid-response`: a conexão foi interrompida. Você também vê esta variante quando um proxy ou gateway encerra o corpo da resposta de forma limpa antes da resposta ser concluída.
481* `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.514* `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.
515* `Part of the response never arrived`: um evento de fluxo foi descartado entre a API e Claude Code, então um evento posterior referenciou conteúdo que nunca chegou. Antes da v2.1.281, este caso terminou o turno com `API Error: Content block not found`.
516* `The response stream was malformed`: um evento chegou para um bloco de conteúdo que já havia terminado, ou um evento chegou danificado. Um evento danificado é aquele cujos dados não são JSON válido, cujo conteúdo está faltando ou cujo conteúdo não corresponde ao tipo do evento. Antes da v2.1.284, o erro bruto do analisador, como um começando com `API Error: JSON Parse error`, aparecia em vez disso quando um evento com JSON inválido chegava depois que Claude havia completado seu pensamento, um bloco de texto ou uma chamada de ferramenta.
482* `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).517* `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).
483 518
484Antes da v2.1.227, `Connection lost mid-response` lia `Connection closed mid-response` e `The response stopped arriving` lia `Response stalled mid-stream`.519Antes da v2.1.227, `Connection lost mid-response` lia `Connection closed mid-response` e `The response stopped arriving` lia `Response stalled mid-stream`.
485 520
521Quando um evento de fluxo descartado, duplicado ou danificado chega antes de Claude ter iniciado qualquer texto ou chamada de ferramenta, você não vê este aviso:
522
523* Se Claude tivesse completado apenas seu pensamento, Claude Code reemite a solicitação. Quando os fluxos reemitidos quebram da mesma forma, o turno termina com `Part of the response never arrived and no response was produced. Try again.` ou `The response stream was malformed and no response was produced. Try again.`
524* Se nada tivesse sido concluído, Claude Code reenvia a solicitação sem streaming. Se você desativou esse fallback com [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/pt/env-vars), o turno termina com `API Error: Content block not found` para um evento descartado ou `API Error: Content block already closed` para um duplicado. Para um evento danificado com o fallback desativado, o turno termina com `API Error: Stream event unreadable` ou o erro bruto do analisador.
525
486Em quatro casos, Claude Code lida com a falha sem mostrar este aviso imediatamente:526Em quatro casos, Claude Code lida com a falha sem mostrar este aviso imediatamente:
487 527
488* Anteriormente na resposta, Claude Code ou tenta novamente a falha ou termina o turno com um erro diferente. Veja [Automatic retries](#automatic-retries).528* Anteriormente na resposta, Claude Code ou tenta novamente a falha ou termina o turno com um erro diferente. Veja [Automatic retries](#automatic-retries).
512<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.552<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.
513```553```
514 554
515Quando Claude Code pode determinar a categoria de falha, ele nomeia a categoria entre parênteses após `temporarily unavailable`, por exemplo `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> 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`.555Quando Claude Code pode determinar a categoria de falha, ele nomeia a categoria entre parênteses após `temporarily unavailable`, por exemplo `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. As categorias são `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` e `(connection failed)`. 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`.
516 556
517Quando 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.557Quando 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.
518 558
533**O que fazer:**573**O que fazer:**
534 574
535* Tente novamente a ação; isso geralmente tem sucesso na próxima tentativa575* Tente novamente a ação; isso geralmente tem sucesso na próxima tentativa
536* Execute `claude --debug` e repita a ação para ver a resposta do classificador subjacente no log de depuração576* Execute `claude --debug` e repita a ação para detalhes no log de depuração
537 577
538Quando uma verificação de segurança de API separada bloqueou a solicitação do classificador por causa do conteúdo anterior da conversa:578Quando uma verificação de segurança de API separada bloqueou a solicitação do classificador por causa do conteúdo anterior da conversa:
539 579
668API 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 context708API 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
669```709```
670 710
671Esta é 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.711Em uma sessão que o Claude Desktop app executa, a dica não nomeia comandos: ela aponta para a página de configurações de uso do claude.ai, ou em planos Team e Enterprise diz para ativar créditos de uso em claude.ai/admin-settings/usage ou para pedir ao seu administrador.
712
713Esta é 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.
672 714
673Quando 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]`.715Quando 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]`.
674 716
733 775
734A 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.776A 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.
735 777
778Quando um proxy, balanceador de carga ou gateway entre Claude Code e a API responde com sua própria página HTML 429, o texto após o `·` é o título dessa página quando tem um, como `Too Many Requests`. Antes da v2.1.281, a marcação de toda a página era impressa após o `·`.
779
736**O que fazer:**780**O que fazer:**
737 781
738* 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.782* 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.
839Not logged in · Please run /login883Not logged in · Please run /login
840```884```
841 885
886Em uma sessão que o aplicativo Claude Desktop executa, como a aba Code ou Cowork, a mensagem lê `Authentication required · Sign in again to continue`, e você se conecta novamente a partir do aplicativo.
887
842**O que fazer:**888**O que fazer:**
843 889
844* Execute `/login` para autenticar com sua assinatura Claude ou conta Console890* Execute `/login` para se autenticar com sua assinatura Claude ou conta Console
845* 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`891* 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`
846* 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ção892* Para CI ou automação onde o login interativo não é possível, configure um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) que busque uma chave na inicialização
847* Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) para entender qual credencial Claude Code usa quando várias estão presentes893* Veja [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) para entender qual credencial Claude Code usa quando várias estão presentes
848 894
849Se 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.895Se você for solicitado a fazer login repetidamente, veja [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para verificações de relógio do sistema e etapas de recuperação de armazenamento de credenciais do macOS.
850 896
851<h3 id="could-not-resolve-authentication-method">897<h3 id="could-not-resolve-authentication-method">
852 Não foi possível resolver o método de autenticação898 Não foi possível resolver o método de autenticação
853</h3>899</h3>
854 900
855A 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.901A sessão chegou ao cliente da API sem nenhuma credencial. [Sessões em segundo plano](/docs/pt/agent-view) e sessões em nuvem mostram essa mensagem quando o worker inicia sem uma credencial. Execuções interativas, `-p` e Agent SDK relatam a mesma condição que [Não conectado](#not-logged-in) e escrevem essa string apenas no log de depuração, portanto, se você a encontrou lá, siga essa entrada.
856 902
857```text theme={null}903```text theme={null}
858Could 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 omitted904Could 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
859```905```
860 906
861Nas 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.907Nas versões atuais, o erro significa que nenhuma credencial estava disponível para o processo worker. Antes da v2.1.174, uma sessão em segundo plano atribuída a um worker pré-inicializado ocioso poderia falhar dessa forma mesmo quando credenciais válidas foram configuradas. Antes da v2.1.176, uma sessão em nuvem que ficou ociosa antes de ser reivindicada também poderia. Atualize para recuperar.
862 908
863**O que fazer:**909**O que fazer:**
864 910
865* 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 configuradas911* Atualize para v2.1.176 ou posterior se isso aparecer em uma sessão em segundo plano ou nuvem e suas credenciais já estiverem configuradas
866* 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 interativo912* 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
867* Para o Agent SDK, consulte [configuração de autenticação no guia de início rápido](/docs/pt/agent-sdk/quickstart#setup)913* Para o Agent SDK, veja [configuração de autenticação no guia de início rápido](/docs/pt/agent-sdk/quickstart#setup)
868* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida914* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida
869 915
870<h3 id="invalid-api-key">916<h3 id="invalid-api-key">
877Invalid API key · Fix external API key923Invalid API key · Fix external API key
878```924```
879 925
880Quando 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.926Quando a mensagem continua após `Fix external API key` com uma descrição como `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, a API nunca viu a chave. Claude Code encontrou um caractere que os cabeçalhos HTTP não conseguem carregar e parou a solicitação antes de enviá-la. Veja [Valor de cabeçalho de solicitação inválido](#invalid-request-header-value) para saber como ler a descrição e corrigir o valor.
881 927
882**O que fazer:**928**O que fazer:**
883 929
891 Seu script apiKeyHelper está falhando937 Seu script apiKeyHelper está falhando
892</h3>938</h3>
893 939
894Claude 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:940Claude Code executou o comando em sua configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) e não obteve uma chave de volta. Sem uma, a solicitação chega à API com uma credencial de espaço reservado, e a API a rejeita com `401`. O painel `Authentication` no terminal mostra qual desses aconteceu:
895 941
896* O comando saiu com um erro ou expirou942* O comando saiu com um erro ou expirou
897* O comando não imprimiu nada em stdout943* O comando não imprimiu nada em stdout
903 949
904Em [modo não interativo](/docs/pt/headless), stderr também carrega o motivo específico, prefixado com `apiKeyHelper failed:`.950Em [modo não interativo](/docs/pt/headless), stderr também carrega o motivo específico, prefixado com `apiKeyHelper failed:`.
905 951
906Claude 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.952Claude Code executa novamente o script e tenta a solicitação até mais duas vezes antes de mostrar essa mensagem, portanto, a falha aparece dentro de três tentativas. Antes da v2.1.208, Claude Code gastava o [orçamento de tentativas](#automatic-retries) completo reenviando a solicitação com a credencial de espaço reservado e depois relatava um erro de autenticação genérico `401` em vez da falha do script.
907 953
908Executar `/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.954Executar `/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.
909 955
910**O que fazer:**956**O que fazer:**
911 957
912* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha958* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha
913* 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 novamente959* Se o comando relatar uma sessão expirada, reautentique-se com seu provedor de credenciais, por exemplo, conectando-se novamente ao seu SSO ou cofre de segredos
914* 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.960* Corrija o comando para que ele imprima apenas a chave em stdout, como um único token de ASCII imprimível até 16.384 caracteres, e saia com código 0. Veja [girar credenciais com apiKeyHelper](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para uma configuração funcional.
915* 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.961* 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.
916* 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`.962* 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`.
917 963
921 967
922Um 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.968Um 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.
923 969
924Claude 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.970Claude 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.
925 971
926```text theme={null}972```text theme={null}
927Invalid auth token · Fix external auth token973Invalid auth token · Fix external auth token
932A primeira parte da mensagem depende de onde o valor ruim veio:978A primeira parte da mensagem depende de onde o valor ruim veio:
933 979
934* `Invalid auth token`: um token de portador de [`ANTHROPIC_AUTH_TOKEN`](/docs/pt/env-vars) ou [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars)980* `Invalid auth token`: um token de portador de [`ANTHROPIC_AUTH_TOKEN`](/docs/pt/env-vars) ou [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars)
935* `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.981* `Invalid ANTHROPIC_CUSTOM_HEADERS`: um nome ou valor de cabeçalho que você definiu em [`ANTHROPIC_CUSTOM_HEADERS`](/docs/pt/env-vars). A descrição conta qual par `Name: Value` é culpado, como `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, sem repetir o nome ou valor, já que você escolheu ambos.
936* `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.982* `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.
937 983
938Claude 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).984Claude Code relata um `ANTHROPIC_API_KEY` ruim capturado por essa verificação como [Chave de API inválida](#invalid-api-key), com a mesma descrição final. Ele relata uma credencial `/login` salva ruim como [Não conectado](#not-logged-in) em vez disso; execute `/login` para salvar uma nova. A saída de um script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) nunca chega a essa verificação: Claude Code a valida quando o script é executado, e a saída que um cabeçalho HTTP não consegue carregar falha com [Seu script apiKeyHelper está falhando](#your-apikeyhelper-script-is-failing).
939 985
940Após o segundo `·`, a mensagem descreve o problema, como neste exemplo completo:986Após o segundo `·`, a mensagem descreve o problema, como neste exemplo completo:
941 987
943Invalid 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).989Invalid 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).
944```990```
945 991
946As 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`.992As posições contam caracteres começando em um. A descrição é construída a partir de frases fixas e contagens de caracteres, portanto, nunca inclui o valor em si. Ela nomeia o caractere ofensivo apenas quando é um caractere invisível ou tipográfico bem conhecido, como uma marca de ordem de byte, um espaço de largura zero ou uma aspas curva, e relata qualquer outra coisa como `a non-ASCII character`.
947 993
948**O que fazer:**994**O que fazer:**
949 995
965 1011
966A 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.1012A 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.
967 1013
968As 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.1014As variáveis de ambiente têm precedência sobre `/login`, portanto, uma chave exportada no seu perfil de shell ou carregada de um arquivo `.env` é usada mesmo quando você tem uma assinatura Pro ou Max funcionando. Em modo não interativo (`-p`), a chave é sempre usada quando presente.
969 1015
970**O que fazer:**1016**O que fazer:**
971 1017
972* Desdefina `ANTHROPIC_API_KEY` no shell atual e remova-a do seu perfil de shell, depois reinicie `claude`1018* Desdefina `ANTHROPIC_API_KEY` no shell atual e remova-a do seu perfil de shell, depois reinicie `claude`
973* 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.1019* Se a mensagem disser `Update or unset`, você não tem um login salvo para recorrer. Desdefina a chave e execute `/login`, ou substitua a chave por uma de uma organização Console ativa.
974* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura1020* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura
975* 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.1021* Se nenhuma variável de ambiente estiver definida e o erro persistir, entre em contato com o suporte ou conecte-se com uma conta diferente.
976 1022
977<h3 id="your-organization-has-disabled-api-key-authentication">1023<h3 id="your-organization-has-disabled-api-key-authentication">
978 Sua organização desabilitou a autenticação por chave de API1024 Sua organização desabilitou a autenticação por chave de API
979</h3>1025</h3>
980 1026
981Esta 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:1027Esta mensagem requer Claude Code v2.1.169 ou posterior. O administrador da organização Console desabilitou a autenticação por chave de API, portanto, a API rejeita a chave que Claude Code está enviando. A dica de recuperação após o `·` varia de acordo com onde a chave veio:
982 1028
983```text theme={null}1029```text theme={null}
984Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account1030Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
985Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead1031Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
986Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account1032Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
987Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account1033Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
1034Your organization has disabled API key authentication · Sign in again with your claude.ai account
988```1035```
989 1036
990As 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).1037A última forma aparece em uma sessão que o aplicativo Claude Desktop executa, como a aba Code ou Cowork, onde você se conecta novamente a partir do aplicativo.
1038
1039As variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, portanto, executar `/login` sozinho não ajuda enquanto qualquer um ainda estiver fornecendo uma chave. Veja [Precedência de autenticação](/docs/pt/authentication#authentication-precedence).
991 1040
992**O que fazer:**1041**O que fazer:**
993 1042
994* 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`1043* 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`
995* Se a mensagem nomear `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) do seu `settings.json`1044* Se a mensagem nomear `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) do seu `settings.json`
996* Execute `/login` para fazer login com sua conta claude.ai1045* Execute `/login` para se conectar com sua conta claude.ai
997* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API1046* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API
998* 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 Console1047* 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
999 1048
1001 Sua organização desabilitou o acesso à assinatura Claude1050 Sua organização desabilitou o acesso à assinatura Claude
1002</h3>1051</h3>
1003 1052
1004Sua 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.1053Sua organização Claude não permite conectar-se ao Claude Code com um login de assinatura. Executar `/login` novamente com a mesma conta retorna o mesmo erro.
1005 1054
1006```text theme={null}1055```text theme={null}
1007Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access1056Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
1008```1057```
1009 1058
1010Esta é 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.1059Esta é 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.
1011 1060
1012O Agent SDK e o modo não interativo `-p` apresentam isso como o código de erro `oauth_org_not_allowed`.1061O Agent SDK e o modo não interativo `-p` apresentam isso como o código de erro `oauth_org_not_allowed`.
1013 1062
1014**O que fazer:**1063**O que fazer:**
1015 1064
1016* Peça ao seu administrador para habilitar o acesso a Claude Code para sua organização1065* Peça ao seu administrador para habilitar o acesso ao Claude Code para sua organização
1017* 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.1066* Autentique-se com uma chave de API Console em vez de sua assinatura. Veja [Autenticação do Claude Console](/docs/pt/authentication#claude-console-authentication) para configuração.
1018* 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)1067* 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)
1019 1068
1020<h3 id="routines-are-disabled-by-your-organizations-policy">1069<h3 id="routines-are-disabled-by-your-organizations-policy">
1021 Rotinas são desabilitadas pela política da sua organização1070 Rotinas são desabilitadas pela política da sua organização
1022</h3>1071</h3>
1023 1072
1024Um 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.1073Um Proprietário em sua organização Team ou Enterprise desabilitou rotinas no nível da organização. O erro aparece quando você tenta criar ou executar uma rotina, por exemplo, a partir da interface [Rotinas](/docs/pt/routines) em claude.ai/code. No Claude Code v2.1.227 ou posterior, a mesma configuração também [oculta `/schedule`](/docs/pt/routines#troubleshooting) no CLI.
1025 1074
1026```text theme={null}1075```text theme={null}
1027Routines are disabled by your organization's policy.1076Routines are disabled by your organization's policy.
1028```1077```
1029 1078
1030Esta é 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.1079Esta é 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.
1031 1080
1032**O que fazer:**1081**O que fazer:**
1033 1082
1034* 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)1083* 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)
1035* Para trabalho agendado único que não requer rotinas no nível da organização, consulte [tarefas agendadas](/docs/pt/scheduled-tasks)1084* Para trabalho agendado único que não requer rotinas no nível da organização, veja [tarefas agendadas](/docs/pt/scheduled-tasks)
1036 1085
1037<h3 id="remote-control-requires-the-anthropic-api">1086<h3 id="remote-control-requires-the-anthropic-api">
1038 Remote Control requer a API Anthropic1087 Remote Control requer a API Anthropic
1039</h3>1088</h3>
1040 1089
1041A 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.1090A sessão não está falando com a API Anthropic diretamente, portanto, [Remote Control](/docs/pt/remote-control) requer.
1042 1091
1043```text theme={null}1092```text theme={null}
1044Remote 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.1093Remote 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.
1045```1094```
1046 1095
1047Uma 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:1096Uma segunda frase explica o que roteirizou a sessão para longe da API Anthropic; antes da v2.1.219, a mensagem era apenas a primeira frase. Dependendo da causa, a mensagem nomeia:
1048 1097
1049* 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)1098* 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)
1050* [`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 Control1099* [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) apontando para um host diferente de `api.anthropic.com`, como um [gateway LLM](/docs/pt/llm-gateway) ou proxy, mesmo quando você se conecta com claude.ai; antes da v2.1.196, uma URL base personalizada não bloqueava Remote Control
1051* `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`1100* `ANTHROPIC_UNIX_SOCKET` definido, portanto, a sessão envia suas solicitações através de um soquete local em vez de para `api.anthropic.com`
1052* 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-la1101* 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
1053 1102
1054**O que fazer:**1103**O que fazer:**
1055 1104
1056* 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 diretamente1105* Desdefina a variável que a mensagem nomeia, como `CLAUDE_CODE_USE_BEDROCK` ou `ANTHROPIC_BASE_URL`, e reinicie a sessão, ou inicie Remote Control a partir de uma sessão que fala com a API Anthropic diretamente
1057* 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ão1106* 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
1058* Para esta e as outras mensagens de inicialização do Remote Control, consulte [Solucionar problemas do Remote Control](/docs/pt/remote-control#troubleshooting)1107* Para esta e as outras mensagens de inicialização do Remote Control, veja [Solucionar problemas do Remote Control](/docs/pt/remote-control#troubleshooting)
1059 1108
1060<h3 id="remote-control-couldnt-refresh-your-login">1109<h3 id="remote-control-couldnt-refresh-your-login">
1061 Remote Control não conseguiu atualizar seu login1110 Remote Control não conseguiu atualizar seu login
1062</h3>1111</h3>
1063 1112
1064Claude 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.1113Claude Code executa uma conexão [Remote Control](/docs/pt/remote-control) ao vivo em credenciais de curta duração que obtém e renova usando seu login claude.ai salvo. Quando claude.ai para de aceitar esse login, ou Claude Code não tem mais nenhum login salvo, Claude Code para Remote Control e precisa que você se conecte novamente. Qualquer falha pode acontecer enquanto Claude Code ainda está se conectando ou depois, quando renova as credenciais.
1065 1114
1066Quando 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`.1115Quando Claude Code pede ao serviço de login para atualizar seu login salvo e não obtém resposta, ele mantém Remote Control em execução e tenta a atualização novamente enquanto a credencial atual da conexão ainda é válida. Uma atualização não obtém resposta quando Claude Code não consegue alcançar o serviço de login, a solicitação expira ou o serviço falha sem rejeitar seu login. Se o serviço de login ainda não estiver respondendo quando essa credencial expirar, Claude Code para Remote Control e relata `OAuth token refresh failed`.
1067 1116
1068Quando 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:1117Quando Claude Code para Remote Control, ele mostra o motivo em um aviso e em uma linha de transcrição que começa com `Remote Control disconnected`. Sua sessão local continua em execução sem Remote Control. Esta seção cobre essas linhas:
1069 1118
1070```text theme={null}1119```text theme={null}
1071Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control1120Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
1080Claude Code nomeia a causa no meio da mensagem:1129Claude Code nomeia a causa no meio da mensagem:
1081 1130
1082* `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 revogado1131* `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
1083* `OAuth token unavailable`: Claude Code não tinha token de login salvo quando a credencial da conexão venceu para renovação1132* `OAuth token unavailable`: Claude Code não tinha nenhum token de login salvo quando a credencial da conexão venceu para renovação
1084* `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 novo1133* `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
1085* `JWT refresh failed: no OAuth token`: Claude Code não encontrou token de login salvo para renovar1134* `JWT refresh failed: no OAuth token`: Claude Code não encontrou nenhum token de login salvo para renovar
1086* `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ão1135* `Signed out of Claude`: você se desconectou nesta máquina, por exemplo, executando `/logout` em outro terminal, portanto, Claude Code não tem nenhum login salvo para renovar a conexão
1087 1136
1088**O que fazer:**1137**O que fazer:**
1089 1138
1090* Execute `/login` para fazer login novamente1139* Execute `/login` para se conectar novamente
1091* 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.1140* Execute `/remote-control` para reconectar a sessão. Mensagens terminando `run /login to restore Remote Control` não precisam desta etapa: Claude Code se reconecta automaticamente depois que você se conecta.
1092 1141
1093Antes da v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` lia `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, e `JWT refresh failed: no OAuth token — run /login` lia `no OAuth token available for recovery (code <N>)`. As mensagens `Claude.ai login expired`, `Claude.ai login was rejected` e `OAuth token unavailable` foram adicionadas na v2.1.225.1142Antes da v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` lia `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, e `JWT refresh failed: no OAuth token — run /login` lia `no OAuth token available for recovery (code <N>)`. As mensagens `Claude.ai login expired`, `Claude.ai login was rejected` e `OAuth token unavailable` foram adicionadas na v2.1.225.
1094 1143
1095Antes 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.1144Antes da v2.1.238, Claude Code relatava os casos que agora dizem `Signed out of Claude` como `JWT refresh failed: no OAuth token — run /login`, e parava Remote Control com `Claude.ai login expired — run /login to restore Remote Control` assim que uma atualização de login não obtinha resposta.
1096 1145
1097<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1146<h3 id="remote-control-stopped-because-the-signed-in-account-changed">
1098 Remote Control parou porque a conta conectada mudou1147 Remote Control parou porque a conta conectada mudou
1099</h3>1148</h3>
1100 1149
1101Claude 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.1150Claude Code mostra essa linha durante uma sessão [Remote Control](/docs/pt/remote-control) quando você se conecta a uma conta claude.ai ou organização diferente nesta máquina. Você fez a mudança fora da sessão Claude Code, por exemplo, executando `/login` em outro terminal.
1102 1151
1103Uma 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.1152Uma sessão Remote Control que você iniciou enquanto estava conectado através de `/login` pertence à conta claude.ai e organização que estavam conectadas no momento.
1104 1153
1105```text theme={null}1154```text theme={null}
1106Remote 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-control1155Remote 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
1111**O que fazer:**1160**O que fazer:**
1112 1161
1113* Execute `/remote-control` para iniciar uma nova sessão Remote Control sob a conta ou organização atual1162* Execute `/remote-control` para iniciar uma nova sessão Remote Control sob a conta ou organização atual
1114* Para voltar, execute `/login` e faça login na conta ou organização anterior novamente. Depois execute `/remote-control`.1163* Para voltar, execute `/login` e conecte-se à conta ou organização anterior novamente. Depois execute `/remote-control`.
1115 1164
1116Antes 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.1165Antes da v2.1.234, Claude Code não notava quando você mudava para uma conta ou organização diferente fora da sessão Claude Code. Claude Code mantinha a sessão Remote Control conectada até que uma solicitação posterior ao servidor Remote Control falhasse com `Remote Control server rejected the request (HTTP 404)`. Essa falha poderia vir horas após a mudança.
1117 1166
1118<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">1167<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">
1119 Remote Control parou porque o aplicativo que executa a sessão saiu ou mudou de contas1168 Remote Control parou porque o aplicativo que executa a sessão se desconectou ou mudou de contas
1120</h3>1169</h3>
1121 1170
1122Quando 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:1171Quando o aplicativo Claude desktop ou um IDE hospeda sua sessão, Claude Code obtém seu token de login desse aplicativo em vez de `/login`. Quando claude.ai rejeita esse token, Claude Code pede ao aplicativo um novo. Se o aplicativo responder que está desconectado ou que agora está conectado a uma conta Claude diferente, Claude Code encerra a sessão [Remote Control](/docs/pt/remote-control) e envia ao aplicativo uma dessas linhas:
1123 1172
1124```text theme={null}1173```text theme={null}
1125Remote Control stopped — the app running this session is now signed in to a different Claude account1174Remote Control stopped — the app running this session is now signed in to a different Claude account
1130 1179
1131**O que fazer:**1180**O que fazer:**
1132 1181
1133* Se o aplicativo estiver desconectado, faça login nele novamente e depois ative Remote Control novamente no aplicativo1182* Se o aplicativo está desconectado, conecte-se a ele novamente e depois ative Remote Control novamente no aplicativo
1134* 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.1183* 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.
1135 1184
1136Antes 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.1185Antes 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.
1139 Token OAuth revogado ou expirado1188 Token OAuth revogado ou expirado
1140</h3>1189</h3>
1141 1190
1142Seu 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.1191Seu 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.
1143 1192
1144Ambas 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.1193Ambas as mensagens relatam uma rejeição que a API retornou para uma solicitação que Claude Code enviou. Quando o login salvo já foi limpo após uma atualização falhada, você vê [Login expirado](#login-expired). Se você se autenticar com um token de longa duração em [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars), você vê as mesmas mensagens quando esse token expira ou é revogado.
1145 1194
1146```text theme={null}1195```text theme={null}
1147OAuth token revoked · Please run /login1196OAuth token revoked · Please run /login
1150 1199
1151**O que fazer:**1200**O que fazer:**
1152 1201
1153* Execute `/login` para fazer login novamente1202* Execute `/login` para se conectar novamente
1154* Se o erro retornar na mesma sessão após autenticar novamente, execute `/logout` primeiro para limpar completamente o token armazenado, depois `/login`1203* Se você se autenticar com a variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code continua enviando o valor que você definiu após uma solicitação falhar com um 401, em vez de mudar para o token de um login salvo. [`/status`](/docs/pt/commands) mostra essa credencial como uma linha `Auth token` lendo `CLAUDE_CODE_OAUTH_TOKEN`. Gere um token novo com [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token) e reinicie com ele, ou desdefina a variável e execute `/login`. Antes da v2.1.225, Claude Code poderia substituir o valor da variável no meio da sessão pelo token de acesso de curta duração de um login salvo, e a sessão falhava com erros 401 novamente depois que esse token expirava.
1155* 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.1204* Para prompts repetidos para fazer login entre inicializações, veja as verificações de relógio do sistema e etapas de recuperação de armazenamento de credenciais do macOS em [Solução de problemas](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired)
1156* 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)1205* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, veja [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
1157* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
1158 1206
1159<h3 id="api-error-401-invalid-authentication-credentials">1207<h3 id="api-error-401-invalid-authentication-credentials">
1160 API Error: 401 Credenciais de autenticação inválidas1208 API Error: 401 Credenciais de autenticação inválidas
1161</h3>1209</h3>
1162 1210
1163A 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.1211A API reconheceu o formato de sua credencial, mas rejeitou a conta ou organização por trás dela. Anthropic retorna essa mensagem quando uma credencial foi revogada recentemente, quando uma organização foi desabilitada ou removeu seu acesso, ou quando a conta em si foi desativada, portanto, um token expirado não é a causa. A credencial pode ser seu login salvo ou um `ANTHROPIC_API_KEY` aprovado, e a correção difere, portanto, comece executando `/status` para ver qual está ativa.
1164 1212
1165```text theme={null}1213```text theme={null}
1166Please run /login · API Error: 401 Invalid authentication credentials1214Please run /login · API Error: 401 Invalid authentication credentials
1168 1216
1169**O que fazer:**1217**O que fazer:**
1170 1218
1171* 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`.1219* Se `/status` mostrar uma linha `API key` que não está marcada como não em uso, um [`ANTHROPIC_API_KEY`](/docs/pt/authentication#authentication-precedence) aprovado é a credencial ativa e tem precedência sobre seu login, portanto, `/login` não a substitui. Gire a chave no Claude Console, ou volte para sua assinatura executando `unset ANTHROPIC_API_KEY`, ou no PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.
1172* Se `/status` mostrar apenas seu login, execute `/login` uma vez. Se a credencial foi revogada, um novo login a substitui.1220* Se `/status` mostrar apenas seu login, execute `/login` uma vez. Se a credencial foi revogada, um novo login a substitui.
1173* 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.1221* 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.
1174* 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.1222* Se [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) aponta para um [gateway LLM](/docs/pt/llm-gateway), o texto após `401` é a mensagem do seu gateway em vez de Anthropic, e `/login` não a altera. Corrija a credencial que seu gateway espera.
1175 1223
1176<h3 id="login-expired">1224<h3 id="login-expired">
1177 Login expirado1225 Login expirado
1178</h3>1226</h3>
1179 1227
1180Claude 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.1228Claude Code tentou renovar seu login claude.ai salvo e o serviço OAuth rejeitou o token de atualização armazenado, portanto, Claude Code limpou as credenciais salvas. Depois disso, cada solicitação de modelo para localmente com essa mensagem antes de chegar à API, porque apenas `/login` pode criar novas credenciais.
1181 1229
1182Antes 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.1230Antes da v2.1.206, Claude Code enviava a solicitação de modelo de qualquer forma com qualquer credencial que permanecesse no ambiente, e cada modelo falhava com [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model) ou um 401 em vez de um prompt para se conectar.
1183 1231
1184```text theme={null}1232```text theme={null}
1185Login expired · Please run /login1233Login expired · Please run /login
1191Failed to authenticate: OAuth session expired and could not be refreshed1239Failed to authenticate: OAuth session expired and could not be refreshed
1192```1240```
1193 1241
1194Este 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).1242Este não é o mesmo estado que [Token OAuth revogado ou expirado](#oauth-token-revoked-or-expired). Essas mensagens relatam uma rejeição que a API retornou. Claude Code em si produz `Login expired` para um login que já falhou em renovar, portanto, não envia nenhuma solicitação. Quando a renovação falha porque a conta em si está suspensa em vez do login estar obsoleto, Claude Code mostra [Sua conta está em espera](#your-account-is-on-hold).
1195 1243
1196Sessõ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.1244Sessões autenticadas com uma chave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars) ou um provedor de terceiros não usam o login salvo e nunca veem essa mensagem.
1197 1245
1198Você 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.1246Você pode verificar esse estado antes de uma solicitação falhar: [`/status`](/docs/pt/commands) mostra uma linha `Login` lendo `Expired — log in again`, mais a organização e email que tem salvo para o login expirado. A linha aparece apenas quando o login salvo é sua credencial ativa e não pode mais ser atualizado. Sessões autenticadas de outra forma não mostram a linha, mesmo que um login expirado permaneça salvo. Antes da v2.1.210, `/status` não dava nenhuma indicação nesse estado de que um login já havia existido, porque a credencial limpa deixou nada para relatar.
1199 1247
1200**O que fazer:**1248**O que fazer:**
1201 1249
1202* Execute `/login` para fazer login novamente. Tentar novamente sem fazer login mostra a mesma mensagem em cada solicitação.1250* Execute `/login` para se conectar novamente. Tentar novamente sem se conectar mostra a mesma mensagem em cada solicitação.
1203* 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).1251* Em modo não interativo, execute `claude` no mesmo ambiente, complete `/login`, depois reexecute seu comando. Para automação que não consegue se conectar interativamente, autentique-se com `ANTHROPIC_API_KEY` ou [gere um token de longa duração com `claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token).
1204* Se fazer login continuar falhando, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)1252* Se a conexão continuar falhando, veja [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)
1253
1254<h3 id="could-not-refresh-your-login">
1255 Não foi possível atualizar seu login porque outro processo Claude Code está atualizando-o
1256</h3>
1257
1258Esta mensagem não significa que seu login foi rejeitado. Seu login claude.ai salvo havia expirado e precisava ser renovado. Outro processo Claude Code na mesma máquina mantinha o bloqueio de atualização compartilhado, ou saiu e deixou-o para trás, e a atualização não fez progresso enquanto essa sessão esperava. Claude Code para a solicitação antes de enviá-la:
1259
1260```text theme={null}
1261Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login
1262```
1263
1264Em [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), a mensagem lê como segue, e o código de erro estruturado é `server_error`:
1265
1266```text theme={null}
1267Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again
1268```
1269
1270Sessões autenticadas com uma chave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars) ou um provedor de terceiros não usam o login salvo e nunca veem essa mensagem.
1271
1272**O que fazer:**
1273
1274* Tente novamente em um minuto. Se outro processo completar a atualização primeiro, essa sessão usa o login renovado.
1275* Se a mensagem continuar retornando, feche outras janelas e processos Claude Code, depois tente novamente.
1276* Se retornar sem nenhum outro processo Claude Code em execução, execute `/login`. Conectar-se novamente não espera no bloqueio de atualização.
1277
1278<h3 id="couldnt-save-your-login">
1279 Não foi possível salvar seu login
1280</h3>
1281
1282Você se conectou com claude.ai, mas Claude Code não conseguiu salvar o login em seu armazenamento de credenciais, portanto, o login não foi concluído. No macOS, isso pode acontecer quando o keychain de login é bloqueado, por exemplo, no sono ou ociosidade, depois que Claude Code já leu ou salvou credenciais nele durante a mesma sessão.
1283
1284```text theme={null}
1285Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
1286Couldn't save your login. Try logging in again.
1287```
1288
1289A primeira forma aparece no macOS e a segunda em todos os outros lugares. Uma falha transitória de armazenamento de credenciais, como um tempo limite ou um armazenamento ilegível, produz a mesma mensagem.
1290
1291**O que fazer:**
1292
1293* No macOS, desbloqueie o keychain de login e execute `/login` novamente
1294* Em outras plataformas, execute `/login` novamente
1295* Se o login ainda não for salvo, veja [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para o comando de desbloqueio de keychain e outras etapas de recuperação de armazenamento de credenciais
1296
1297<h3 id="failed-to-start-oauth-callback-server">
1298 Falha ao iniciar servidor de callback OAuth
1299</h3>
1300
1301Quando `/login`, `claude auth login` ou `claude setup-token` o conecta através do navegador, Claude Code abre uma porta de escuta em `127.0.0.1` para que seu navegador possa retornar o resultado da conexão a ele. Esta mensagem significa que Claude Code não conseguiu abrir essa porta, e a conexão para antes de uma janela do navegador ou URL de login aparecer:
1302
1303```text theme={null}
1304Failed to start OAuth callback server: Failed to start server. Is port 0 in use?
1305```
1306
1307Se sua mensagem terminar com `Is port 0 in use?`, a tentativa de escutar no endereço de loopback IPv4 `127.0.0.1` falhou completamente. Como a falha acontece antes de uma URL de login existir, o fluxo `Paste code here if prompted` não está disponível como solução alternativa.
1308
1309**O que fazer:**
1310
1311* Para se conectar agora sem o ouvinte local: se você usar uma assinatura claude.ai, execute [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token) em uma máquina onde a conexão funciona e defina o token que ele imprime como `CLAUDE_CODE_OAUTH_TOKEN` nesta máquina. Caso contrário, defina `ANTHROPIC_API_KEY` para uma chave do [Claude Console](https://platform.claude.com/settings/keys). [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) explica como Claude Code escolhe entre credenciais.
1312* Para usar a conexão do navegador nesta máquina, Claude Code deve ser capaz de escutar em `127.0.0.1`. Se ele é executado dentro de uma sandbox, verifique se a política da sandbox permite escutar em portas locais, depois execute `/login` novamente. Se deveria ser capaz e ainda falha, execute `/feedback` para que o relatório inclua detalhes do seu ambiente.
1205 1313
1206<h3 id="claude-login-not-accepted">1314<h3 id="claude-login-not-accepted">
1207 Login Claude não aceito1315 Claude login não aceito
1208</h3>1316</h3>
1209 1317
1210Você 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.1318Você tentou iniciar uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) e o servidor recusou criá-la com um 401: não aceitou o login Claude que esta máquina enviou, geralmente porque o login expirou ou foi revogado.
1211 1319
1212A primeira parte da linha é o próprio motivo do servidor quando ele fornece um. Caso contrário, a linha lê:1320A primeira parte da linha é o próprio motivo do servidor quando fornece um. Caso contrário, a linha lê:
1213 1321
1214```text theme={null}1322```text theme={null}
1215Claude login not accepted · Run /login, then try again1323Claude login not accepted · Run /login, then try again
1217 1325
1218**O que fazer:**1326**O que fazer:**
1219 1327
1220* Execute `/login`, complete o login e tente iniciar a sessão novamente1328* Execute `/login`, complete a conexão e inicie a sessão novamente
1221 1329
1222<h3 id="artifacts-need-a-claude-ai-login">1330<h3 id="artifacts-need-a-claude-ai-login">
1223 Artefatos precisam de um login claude.ai1331 Artefatos precisam de um login claude.ai
1224</h3>1332</h3>
1225 1333
1226Claude 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.1334Claude Code recusou uma publicação ou leitura de [artefato](/docs/pt/artifacts) porque a sessão não tem nenhum login claude.ai que possa usar para artefatos.
1227 1335
1228Cada 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ê:1336Cada forma da mensagem começa com as mesmas palavras, seguidas por um remédio que depende de como sua sessão se autentica. Sem credencial concorrente, lê:
1229 1337
1230```text theme={null}1338```text theme={null}
1231Artifacts 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.1339Artifacts 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.
1235 1343
1236* Execute `/login` e selecione **Claude account with subscription**. A opção **Anthropic Console account** não fornece credenciais claude.ai.1344* Execute `/login` e selecione **Claude account with subscription**. A opção **Anthropic Console account** não fornece credenciais claude.ai.
1237* 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`1345* 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`
1238* 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ão1346* Quando a mensagem diz que essa sessão remota se autentica através da máquina que a iniciou, conecte-se a claude.ai nessa máquina e depois reconecte a sessão
1239* 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.ai1347* 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
1240* Consulte [Disponibilidade](/docs/pt/artifacts#availability) para os outros requisitos que artefatos têm, como plano, provedor de modelo e política de organização1348* Veja [Disponibilidade](/docs/pt/artifacts#availability) para os outros requisitos que artefatos têm, como plano, provedor de modelo e política de organização
1241 1349
1242<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1350<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">
1243 A política do administrador requer um login do Cloud gateway1351 A política do administrador requer um login do gateway de nuvem
1244</h3>1352</h3>
1245 1353
1246As [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:1354As [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:
1249Not signed in to the Cloud gateway — run /login.1357Not signed in to the Cloud gateway — run /login.
1250```1358```
1251 1359
1252Solicitaçõ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.1360As solicitações de modelo falham com essa mensagem quando a sessão não tem nenhum login de gateway, por exemplo, porque você não executou `/login` desde que a política chegou à máquina.
1253 1361
1254Se 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:1362Se a máquina também contiver uma credencial emitida pela Anthropic e as configurações gerenciadas definirem `forceLoginMethod` ou `forceLoginOrgUUID`, Claude Code sai na inicialização. Essa credencial pode ser uma variável `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN`, uma configuração `apiKeyHelper` ou uma chave de API salva por um login Console anterior. A mensagem começa:
1255 1363
1256```text theme={null}1364```text theme={null}
1257Administrator policy requires a Cloud gateway sign-in on this machine; the1365Administrator policy requires a Cloud gateway sign-in on this machine; the
1261 1369
1262**O que fazer:**1370**O que fazer:**
1263 1371
1264* Execute `/login` e complete o login na tela **Cloud gateway**1372* Execute `/login` e complete a conexão na tela **Cloud gateway**
1265* 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`1373* Para a mensagem de inicialização, remova a configuração `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` que você configurou. Para remover uma chave de API Console salva, execute `claude auth logout`, que também remove um login claude.ai salvo. Se você selecionar um provedor de nuvem com `CLAUDE_CODE_USE_*`, a sessão então inicia sem conexão. Caso contrário, inicie `claude` e execute `/login`
1266* 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 gerenciadas1374* 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
1267 1375
1268Na 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.1376Na v2.1.265, uma regressão também mostrou a primeira mensagem em algumas configurações de gateway LLM e proxy que se autenticam com uma chave de API, `apiKeyHelper` ou cabeçalhos personalizados, mesmo sem nenhum requisito de administrador na máquina. Atualize para v2.1.266 ou posterior. Você não precisa alterar sua configuração.
1269 1377
1270Antes 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á.1378Antes 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á.
1271 1379
1273 Sua conta está em espera1381 Sua conta está em espera
1274</h3>1382</h3>
1275 1383
1276A 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:1384A conta Claude por trás do seu login foi suspensa. Claude Code mostra a primeira mensagem quando tenta renovar seu login salvo e aprende sobre a espera, e a segunda quando uma conexão que você completa no navegador a relata:
1277 1385
1278```text theme={null}1386```text theme={null}
1279Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1387Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
1280Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted1388Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
1281```1389```
1282 1390
1283Fazer 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.1391Conectar-se novamente com a mesma conta não limpa a mensagem, porque a espera está na conta em vez do login. Em [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), o código de erro estruturado é `account_on_hold`. Antes da v2.1.235, Claude Code relatava uma conta em espera como [Login expirado · Please run /login](#login-expired), cujas etapas de recuperação não conseguem limpar uma espera.
1284 1392
1285**O que fazer:**1393**O que fazer:**
1286 1394
1287* Abra o link na mensagem para visualizar os detalhes da espera ou apelá-la1395* Abra o link na mensagem para visualizar os detalhes da espera ou apelá-la
1288* 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`1396* 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`
1289 1397
1290<h3 id="anthropic-profile-login-expired">1398<h3 id="anthropic-profile-login-expired">
1291 Login do perfil Anthropic expirado1399 Login de perfil Anthropic expirado
1292</h3>1400</h3>
1293 1401
1294Claude 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.1402Claude Code está se autenticando através de um perfil de credencial Anthropic cuja credencial de login salva expirou, e o perfil não contém nenhuma credencial de atualização que Claude Code possa usar para renová-la. Claude Code para cada solicitação localmente sem tentar novamente, porque uma tentativa novamente leria a mesma credencial expirada.
1295 1403
1296```text theme={null}1404```text theme={null}
1297Anthropic profile login expired · Re-authenticate your Anthropic profile1405Anthropic profile login expired · Re-authenticate your Anthropic profile
1298Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1406Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
1299```1407```
1300 1408
1301Isso 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.1409Isso aparece apenas quando a credencial ativa vem de um perfil de credencial Anthropic, um que você seleciona com a variável de ambiente `ANTHROPIC_PROFILE`, que Claude Code descobre como o perfil ativo em seu diretório de configuração Anthropic, ou que Claude Code escreveu quando você [se conectou sem uma chave de API](/docs/pt/authentication#sign-in-without-an-api-key). Sessões que se autenticam com uma chave de API, um token de portador como `ANTHROPIC_AUTH_TOKEN` ou um provedor de terceiros nunca veem essa mensagem.
1302 1410
1303Em 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:1411Em uma máquina que [oferece a conexão sem chave](/docs/pt/authentication#sign-in-without-an-api-key), execute `/login`, escolha a conta Anthropic Console e conecte-se novamente para renovar um perfil que a conexão Console sem chave ou o `ant auth login` do CLI da Plataforma Claude escreveu. Claude Code substitui a credencial expirada nesse perfil. Para um perfil de federação ou um que outra ferramenta criou, `/login` não renova a credencial. Qual forma você vê depende se você selecionou o perfil ou Claude Code o descobriu:
1304 1412
1305* Quando você define `ANTHROPIC_PROFILE` explicitamente, a mensagem termina com `Re-authenticate your Anthropic profile`.1413* Quando você define `ANTHROPIC_PROFILE` explicitamente, a mensagem termina com `Re-authenticate your Anthropic profile`.
1306* 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.1414* Quando Claude Code descobriu o perfil do seu diretório de configuração, a mensagem oferece `/login`, porque Claude Code dá precedência a um `/login` funcional sobre o perfil descoberto e então se autentica com sua conta claude.ai ou Console. Antes da v2.1.234, Claude Code mostrava o formulário `Re-authenticate your Anthropic profile` neste caso também.
1307 1415
1308**O que fazer:**1416**O que fazer:**
1309 1417
1310* 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 criou1418* Conecte-se ao perfil novamente e tente novamente: em uma máquina que [oferece a conexão sem chave](/docs/pt/authentication#sign-in-without-an-api-key), execute `/login` e escolha a conta Anthropic Console para um perfil que a conexão Console sem chave ou o `ant auth login` do CLI da Plataforma Claude escreveu; para outros perfis, use a ferramenta que os criou
1311* Se um administrador provisionou a credencial do perfil, peça a ele para emitir uma nova1419* Se um administrador provisionou a credencial do perfil, peça a ele para emitir uma nova
1312* Execute `/status` para confirmar a fonte de credencial ativa e o nome do perfil1420* Execute `/status` para confirmar a fonte de credencial ativa e o nome do perfil
1313* Para parar de usar o perfil, desdefina `ANTHROPIC_PROFILE` se você o definiu, depois autentique de outra forma, como `/login` ou `ANTHROPIC_API_KEY`1421* Para parar de usar o perfil, desdefina `ANTHROPIC_PROFILE` se você o definiu, depois autentique-se de outra forma, como `/login` ou `ANTHROPIC_API_KEY`
1314 1422
1315<h3 id="oauth-scope-requirement">1423<h3 id="oauth-scope-requirement">
1316 Requisito de escopo OAuth1424 Requisito de escopo OAuth
1317</h3>1425</h3>
1318 1426
1319O 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:1427O token armazenado é anterior a um escopo de permissão que um recurso mais novo precisa:
1320 1428
1321```text theme={null}1429```text theme={null}
1322OAuth token does not meet scope requirement: user:profile1430OAuth token does not meet scope requirement: user:profile
1330 claude.ai rejeitou o token da sessão1438 claude.ai rejeitou o token da sessão
1331</h3>1439</h3>
1332 1440
1333Uma 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ê:1441Uma solicitação de [conector claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) falhou porque claude.ai rejeitou o token do seu login Claude Code. O token rejeitado é seu login, não a autorização própria do conector em claude.ai, portanto, autorizar o conector novamente não o resolve. Em `/mcp`, o conector mostra como `session token rejected` e sua visualização de detalhes lê:
1334 1442
1335```text theme={null}1443```text theme={null}
1336claude.ai rejected the session token. Run /login, then reconnect.1444claude.ai rejected the session token. Run /login, then reconnect.
1338 1446
1339**O que fazer:**1447**O que fazer:**
1340 1448
1341* Execute `/login` para fazer login novamente1449* Execute `/login` para se conectar novamente
1342* Reconecte o conector de `/mcp`, ou execute `/mcp reconnect <server>`. Reconectar antes de fazer login novamente deixa o conector no mesmo estado. A opção **Reconnect** do painel `/mcp` relata `your claude.ai session token was rejected`; o formulário digitado `/mcp reconnect <server>` relata uma reconexão bem-sucedida mesmo que o token ainda seja rejeitado.1450* Reconecte o conector de `/mcp` ou execute `/mcp reconnect <server>`. Reconectar antes de se conectar novamente deixa o conector no mesmo estado. A opção **Reconnect** do painel `/mcp` relata `your claude.ai session token was rejected`; o formulário digitado `/mcp reconnect <server>` relata uma reconexão bem-sucedida mesmo que o token ainda seja rejeitado.
1343 1451
1344Antes 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.1452Antes 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.
1345 1453
1346<h3 id="mcp-server-needs-you-to-sign-in-again">1454<h3 id="mcp-server-needs-you-to-sign-in-again">
1347 Servidor MCP precisa que você faça login novamente1455 Servidor MCP precisa que você se conecte novamente
1348</h3>1456</h3>
1349 1457
1350Um [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).1458Um [servidor MCP](/docs/pt/mcp) remoto rejeitou a credencial em uma chamada de ferramenta no meio da sessão, geralmente porque uma conexão ou token expirou ou porque o token carece de uma permissão que a ferramenta precisa. A chamada de ferramenta falha e `/mcp` marca o servidor como [precisando de autenticação](/docs/pt/mcp#authenticate-with-remote-mcp-servers).
1351 1459
1352Para um servidor que você faz login de Claude Code, incluindo um conector claude.ai, o login expirou ou foi revogado:1460Para um servidor que você se conecta a partir de Claude Code, incluindo um conector claude.ai, a conexão expirou ou foi revogada:
1353 1461
1354```text theme={null}1462```text theme={null}
1355MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1463MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)
1356```1464```
1357 1465
1358Execute `/mcp`, selecione o servidor e faça login novamente de seu menu.1466Execute `/mcp`, selecione o servidor e conecte-se novamente a partir de seu menu.
1359 1467
1360Para 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:1468Para um servidor configurado com um script [`headersHelper`](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication), Claude Code já reexecutou o helper e tentou novamente a chamada uma vez antes de mostrar isso:
1361 1469
1362```text theme={null}1470```text theme={null}
1363MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)1471MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)
1373 1481
1374Atualize o valor do cabeçalho onde o servidor está configurado, depois reconecte de `/mcp`.1482Atualize o valor do cabeçalho onde o servidor está configurado, depois reconecte de `/mcp`.
1375 1483
1376Antes da v2.1.273, os casos de login expirado, `headersHelper` e cabeçalho `Authorization` todos mostravam `MCP server "<name>" requires re-authorization (token expired)`.1484Antes da v2.1.273, a conexão expirada, `headersHelper` e os casos de cabeçalho `Authorization` todos mostravam `MCP server "<name>" requires re-authorization (token expired)`.
1377 1485
1378Um 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:1486Um 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:
1379 1487
1381MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate1489MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate
1382```1490```
1383 1491
1384Execute `/mcp`, selecione o servidor e autentique novamente de seu menu.1492Execute `/mcp`, selecione o servidor e autentique-se novamente a partir de seu menu.
1385 1493
1386Quando 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.1494Quando a configuração do servidor não define [`oauth.scopes`](/docs/pt/mcp#restrict-oauth-scopes) nem [`authServerMetadataUrl`](/docs/pt/mcp#override-oauth-metadata-discovery), Claude Code solicita o escopo que o servidor nomeou. Com qualquer configuração, Claude Code solicita os escopos dessa configuração. Se você fixou `oauth.scopes`, adicione o escopo ausente a essa lista antes de se autenticar novamente.
1387 1495
1388Antes 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.1496Antes 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.
1389 1497
1391 Incompatibilidade de emissor na resposta de autorização1499 Incompatibilidade de emissor na resposta de autorização
1392</h3>1500</h3>
1393 1501
1394Durante 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:1502Durante um [login OAuth MCP](/docs/pt/mcp#authenticate-with-remote-mcp-servers), o servidor de autorização redirecionou de volta para Claude Code com um parâmetro `iss` que não nomeia o emissor que Claude Code esperava dos metadados OAuth do servidor. Um emissor errado nesta etapa é como um ataque de mistura de servidor de autorização se parece, portanto, Claude Code falha a conexão em vez de trocar o código de autorização. Claude Code mostra o erro no menu do servidor `/mcp` após a conexão do navegador:
1395 1503
1396```text theme={null}1504```text theme={null}
1397Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1505Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
1398```1506```
1399 1507
1400`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.1508`expected` é o emissor dos metadados OAuth do servidor, e `received` é o valor `iss` que o redirecionamento carregava. Uma conexão cujo redirecionamento não carrega nenhum parâmetro `iss` passa na verificação, a menos que os metadados do servidor definam `authorization_response_iss_parameter_supported`, nesse caso Claude Code falha a conexão.
1401 1509
1402**O que fazer:**1510**O que fazer:**
1403 1511
1404* Tente o login novamente de `/mcp`1512* Tente a conexão novamente de `/mcp`
1405* 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 metadados1513* 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
1406* 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 servidor1514* 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
1407 1515
1408Antes da v2.1.232, Claude Code usava o runtime v2 apenas em um lançamento gradual ou quando você definia `MCP_SDK_GENERATION=v2`.1516Antes da v2.1.232, Claude Code usava o runtime v2 apenas em um lançamento gradual ou quando você definia `MCP_SDK_GENERATION=v2`.
1409 1517
1419AWS 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 ...1527AWS 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 ...
1420```1528```
1421 1529
1422Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.1530Antes da v2.1.273, essa mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.
1423 1531
1424**O que fazer:**1532**O que fazer:**
1425 1533
1426* 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 administrador1534* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
1427* 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 proxy1535* Se [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) estiver definido, execute o comando nomeado na mensagem, como `aws sso login --profile myprofile`, em outro terminal e complete a conexão do navegador, depois tente novamente. Caso contrário, atualize a credencial AWS que você usa: sua conexão SSO, chaves de acesso, chave de API ou token de proxy
1428* 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)1536* Com `awsAuthRefresh` definido em uma sessão interativa, você pode executar `/login`, escolher **3rd-party platform**, depois selecionar **Claude Platform on AWS · refresh credentials** em **Using 3rd-party platforms** para executar o mesmo comando sem reiniciar Claude Code. Veja [Configurar credenciais AWS](/docs/pt/claude-platform-on-aws#1-configure-aws-credentials)
1429* 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 perfil1537* 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
1430 1538
1431<h3 id="aws-authentication-failed">1539<h3 id="aws-authentication-failed">
1436 1544
1437Amazon 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.1545Amazon 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.
1438 1546
1439Um 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.1547Um 401 de Amazon Bedrock também chega aqui em vez de em [Credenciais AWS expiradas ou inválidas](#aws-credentials-expired-or-invalid), porque Amazon Bedrock não relata um token expirado como um 401. Um 401 desse endpoint geralmente vem de algo mais no caminho da solicitação, como um proxy corporativo.
1440 1548
1441Uma atualização de credencial corrige um token expirado e não consegue corrigir as outras causas, portanto a mensagem oferece ambas:1549Uma atualização de credencial corrige um token expirado e não consegue corrigir as outras causas, portanto, a mensagem oferece ambas:
1442 1550
1443```text theme={null}1551```text theme={null}
1444AWS 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 ...1552AWS 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 ...
1446 1554
1447A dica de ação no meio varia com sua configuração. A parte estável é o `AWS authentication failed` inicial.1555A dica de ação no meio varia com sua configuração. A parte estável é o `AWS authentication failed` inicial.
1448 1556
1449Quando 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.1557Quando o 403 é a resposta de Amazon Bedrock de que você não tem acesso ao modelo com a ID de modelo especificada, a dica em vez disso diz que você habilite o modelo para sua conta e região no console Amazon Bedrock.
1450 1558
1451Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.1559Antes da v2.1.273, essa mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.
1452 1560
1453**O que fazer:**1561**O que fazer:**
1454 1562
1455* 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 administrador1563* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
1456* 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ê mesmo1564* Atualize suas credenciais AWS em caso de uma credencial expirada ser a causa: execute o comando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) nomeado na mensagem quando um estiver definido, ou atualize sua conexão SSO, chaves de acesso, chave de API ou token de proxy
1457* 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ão1565* 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
1458* 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ão1566* Execute `aws sts get-caller-identity` para confirmar qual identidade suas solicitações usam
1459 1567
1460<h3 id="google-cloud-credentials-expired-or-invalid">1568<h3 id="google-cloud-credentials-expired-or-invalid">
1461 Credenciais do Google Cloud expiradas ou inválidas1569 Credenciais do Google Cloud expiradas ou inválidas
1471 1579
1472**O que fazer:**1580**O que fazer:**
1473 1581
1474* 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 administrador1582* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
1475* 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 novamente1583* Se você se autenticar com credenciais padrão de aplicativo, execute o comando [`gcpAuthRefresh`](/docs/pt/google-vertex-ai#advanced-credential-configuration) nomeado na mensagem, ou `gcloud auth application-default login`, e complete a conexão, depois tente novamente
1476* 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 novamente1584* Se você rotear através de um [gateway LLM](/docs/pt/llm-gateway) com `CLAUDE_CODE_SKIP_VERTEX_AUTH` definido, atualize o token de gateway em `ANTHROPIC_AUTH_TOKEN` ou `ANTHROPIC_CUSTOM_HEADERS`, depois tente novamente
1477* 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)1585* Se você se autenticar com um arquivo de chave de conta de serviço, confirme que `GOOGLE_APPLICATION_CREDENTIALS` aponta para uma chave válida. Veja [Configurar credenciais GCP](/docs/pt/google-vertex-ai#3-configure-gcp-credentials)
1478* 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 shell1586* 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
1479 1587
1480Antes 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.1588Antes da v2.1.273, um 401 de Agent Platform mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar credenciais do Google Cloud.
1481 1589
1482<h3 id="google-cloud-authentication-failed">1590<h3 id="google-cloud-authentication-failed">
1483 Falha na autenticação do Google Cloud1591 Falha na autenticação do Google Cloud
1484</h3>1592</h3>
1485 1593
1486[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.1594[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.
1487 1595
1488A dica de ação no meio varia com sua configuração. A parte estável é o `Google Cloud authentication failed` inicial:1596A dica de ação no meio varia com sua configuração. A parte estável é o `Google Cloud authentication failed` inicial:
1489 1597
1493 1601
1494**O que fazer:**1602**O que fazer:**
1495 1603
1496* 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 administrador1604* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
1497* Confirme as funções em [Configuração IAM](/docs/pt/google-vertex-ai#iam-configuration) são concedidas à identidade com a qual você se autentica1605* Confirme que as funções em [Configuração IAM](/docs/pt/google-vertex-ai#iam-configuration) são concedidas à identidade com a qual você se autentica
1498* Confirme que o modelo está habilitado para seu projeto. Consulte [Request model access](/docs/pt/google-vertex-ai#2-request-model-access)1606* Confirme que o modelo está habilitado para seu projeto. Veja [Solicitar acesso ao modelo](/docs/pt/google-vertex-ai#2-request-model-access)
1499 1607
1500Antes 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.1608Antes da v2.1.273, um 403 de Agent Platform mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar credenciais do Google Cloud.
1501 1609
1502<h3 id="microsoft-foundry-authentication-failed">1610<h3 id="microsoft-foundry-authentication-failed">
1503 Falha na autenticação do Microsoft Foundry1611 Falha na autenticação do Microsoft Foundry
1511 1619
1512**O que fazer:**1620**O que fazer:**
1513 1621
1514* 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 administrador1622* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou Claude Code possui a credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
1515* 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 novamente1623* Atualize a credencial que você configurou em [Configurar credenciais Azure](/docs/pt/microsoft-foundry#2-configure-azure-credentials): gire `ANTHROPIC_FOUNDRY_API_KEY`, cunhe um novo `ANTHROPIC_FOUNDRY_AUTH_TOKEN` ou execute `az login` para que a cadeia de credencial padrão do Microsoft Entra possa se conectar novamente
1516* 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)1624* Se a credencial está atual, confirme que a identidade tem acesso ao recurso Foundry. Veja [Configuração RBAC do Azure](/docs/pt/microsoft-foundry#azure-rbac-configuration)
1517 1625
1518Antes 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.1626Antes da v2.1.273, um 401 ou 403 de Microsoft Foundry mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar credenciais Azure.
1519 1627
1520<h3 id="could-not-load-aws-or-google-cloud-credentials">1628<h3 id="could-not-load-aws-or-google-cloud-credentials">
1521 Não foi possível carregar credenciais AWS ou Google Cloud1629 Não foi possível carregar credenciais AWS ou Google Cloud
1522</h3>1630</h3>
1523 1631
1524Claude 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`:1632Claude Code não conseguiu obter credenciais utilizáveis da cadeia de provedor de credenciais AWS ou de suas credenciais padrão de aplicativo Google na máquina em que é executado, portanto, nenhuma solicitação chegou ao seu provedor de nuvem. Claude Code limpa suas credenciais em cache e tenta novamente duas vezes antes de mostrar essa mensagem. O detalhe após o `·` nomeia a causa específica, como uma sessão SSO expirada, credenciais padrão ausentes relatadas como `Could not load the default credentials` ou uma conexão revogada relatada como `invalid_grant`:
1525 1633
1526```text theme={null}1634```text theme={null}
1527API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.1635API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
1532 1640
1533**O que fazer:**1641**O que fazer:**
1534 1642
1535* 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 Code1643* Execute o comando de conexão do seu provedor, como `aws sso login --profile myprofile` ou `gcloud auth application-default login`, depois tente novamente. [Credenciais Bedrock, Agent Platform ou Foundry não carregando](/docs/pt/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) mostra como confirmar as credenciais fora de Claude Code
1536* 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)1644* 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)
1537 1645
1538<h3 id="aws-default-chain-credential-resolve-timed-out">1646<h3 id="aws-default-chain-credential-resolve-timed-out">
1539 Resolução de credencial de cadeia padrão AWS expirou1647 Resolução de credencial de cadeia padrão AWS expirou
1540</h3>1648</h3>
1541 1649
1542A 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.1650A cadeia de provedor de credencial padrão AWS não produziu credenciais dentro de 60 segundos, portanto, Claude Code parou a resolução e falhou a solicitação. Este tempo limite é uma causa de [Não foi possível carregar credenciais AWS ou Google Cloud](#could-not-load-aws-or-google-cloud-credentials). A falha é resolução de credencial local: a solicitação nunca chegou a [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) ou ao [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint). Claude Code limpa seu [cache de credencial](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout) e tenta novamente antes desse erro aparecer, portanto, no momento em que você o vê, a cadeia travou em tentativas repetidas.
1543 1651
1544```text theme={null}1652```text theme={null}
1545API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.1653API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
1546```1654```
1547 1655
1548As 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.1656As causas comuns são um comando `credential_process` em seu perfil AWS que espera por entrada que não consegue receber, e um contêiner ou VM cujo serviço de metadados de instância (IMDS) nunca responde à sonda da cadeia.
1549 1657
1550Antes da v2.1.267, a mensagem lia `API Error: AWS default-chain credential resolve timed out`.1658Antes da v2.1.267, a mensagem lia `API Error: AWS default-chain credential resolve timed out`.
1551Antes da v2.1.207, uma cadeia travada deixava a solicitação esperando indefinidamente em vez de falhar.1659Antes da v2.1.207, uma cadeia travada deixava a solicitação esperando indefinidamente em vez de falhar.
1553**O que fazer:**1661**O que fazer:**
1554 1662
1555* 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.1663* 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.
1556* 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 navegador1664* Complete a etapa de conexão antes de iniciar Claude Code, por exemplo `aws sso login --profile myprofile`, para que a cadeia seja resolvida do cache SSO local em vez de esperar por um fluxo de navegador
1557* 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)1665* Se sua cadeia executa uma conexão interativa que legitimamente precisa de mais de 60 segundos, como SSO com MFA através de um wrapper como `aws-vault`, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars)
1558 1666
1559<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1667<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">
1560 Tempo limite de verificação de configuração do Bedrock aguardando AWS1668 Verificação de configuração Bedrock expirou esperando por AWS
1561</h3>1669</h3>
1562 1670
1563Uma 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:1671Uma chamada para AWS durante o [assistente de configuração Bedrock](/docs/pt/amazon-bedrock#sign-in-with-bedrock), como a busca de credencial ou a verificação de identidade, não terminou dentro do limite de 60 segundos. O assistente para de esperar e falha a etapa de verificação:
1564 1672
1565```text theme={null}1673```text theme={null}
1566Timed 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.1674Timed 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.
1568 1676
1569O 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).1677O 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).
1570 1678
1571As 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.1679As causas comuns são uma rede ou proxy que trava solicitações para AWS, incluindo a atualização de token SSO, e um helper de credencial ainda esperando por entrada que você não consegue ver. Aumente o limite apenas quando o helper legitimamente precisa de mais tempo.
1572 1680
1573Uma ú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:1681Uma ú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:
1574 1682
1576A request to AWS timed out. Check your network and proxy settings, then try again.1684A request to AWS timed out. Check your network and proxy settings, then try again.
1577```1685```
1578 1686
1579Quando 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.1687Quando os mesmos tempos limite ocorrem na etapa de fixação de modelo, o assistente marca um modelo como `unreachable` em vez de mostrar qualquer mensagem.
1580 1688
1581**O que fazer:**1689**O que fazer:**
1582 1690
1583* 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.1691* Execute `aws sts get-caller-identity` no mesmo shell. Se também travar, o travamento está fora de Claude Code, em sua rede, seu proxy ou o helper de credencial em seu perfil AWS; corrija isso primeiro.
1584* Complete qualquer login interativo antes de abrir o assistente, por exemplo `aws sso login --profile myprofile`1692* Complete qualquer conexão interativa antes de abrir o assistente, por exemplo `aws sso login --profile myprofile`
1585* 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)1693* 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)
1586 1694
1587<h3 id="cloud-gateway-session-expired">1695<h3 id="cloud-gateway-session-expired">
1588 Sessão de gateway de nuvem expirada1696 Sessão de gateway de nuvem expirada
1589</h3>1697</h3>
1590 1698
1591Você 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:1699Você se conectou através de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) e a sessão de gateway salva nesta máquina expirou e não conseguiu ser renovada, ou o gateway não a aceita mais, por exemplo, após o [segredo JWT do gateway ser substituído](/docs/pt/claude-apps-gateway-deploy#jwt-secret-rotation). Se você vir essa linha quando inicia `claude` interativamente, a sessão abriu desconectada do gateway:
1592 1700
1593```text theme={null}1701```text theme={null}
1594Cloud gateway session expired — run /login to reconnect.1702Cloud gateway session expired — run /login to reconnect.
1596 1704
1597A mesma linha pode aparecer no meio da sessão quando a credencial de gateway expira e Claude Code não consegue renová-la.1705A mesma linha pode aparecer no meio da sessão quando a credencial de gateway expira e Claude Code não consegue renová-la.
1598 1706
1599Em 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:1707Em uma execução [não interativa](/docs/pt/headless), uma sessão em segundo plano ou outra sessão desatendida, ou um subcomando `claude` diferente de `claude auth`, Claude Code sai com essa mensagem em vez disso quando o gateway não aceita mais a sessão:
1600 1708
1601```text theme={null}1709```text theme={null}
1602Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1710Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
1604 1712
1605**O que fazer:**1713**O que fazer:**
1606 1714
1607* Execute `/login` na sessão e complete o login do navegador1715* Execute `/login` na sessão e complete a conexão do navegador
1608* Para um lançamento não interativo, inicie `claude` no mesmo ambiente, execute `/login`, depois execute novamente seu comando1716* Para um lançamento não interativo, inicie `claude` no mesmo ambiente, execute `/login`, depois reexecute seu comando
1609 1717
1610<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1718<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">
1611 Tempo limite de login enquanto aguardava você continuar1719 Conexão expirou enquanto esperava você continuar
1612</h3>1720</h3>
1613 1721
1614Durante 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:1722Durante uma conexão [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), o gateway nomeou a conta que se conectou, e Claude Code pediu que você a confirmasse antes de salvar a credencial. Você deixou a confirmação aberta após a expiração da própria conexão, e o gateway não emitiu nenhum token de atualização que pudesse renová-la, portanto, Claude Code não armazenou nada quando você continuou:
1615 1723
1616```text theme={null}1724```text theme={null}
1617Sign-in timed out while waiting for you to continue. Try again.1725Sign-in timed out while waiting for you to continue. Try again.
1619 1727
1620**O que fazer:**1728**O que fazer:**
1621 1729
1622* Execute `/login` novamente e confirme a conta antes do login expirar1730* Execute `/login` novamente e confirme a conta antes da conexão expirar
1623 1731
1624<h3 id="gateway-refused-the-request">1732<h3 id="gateway-refused-the-request">
1625 Gateway recusou a solicitação1733 Gateway recusou a solicitação
1626</h3>1734</h3>
1627 1735
1628Você 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:1736Você está conectado através de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) e uma solicitação retornou um 403: o gateway, ou o upstream por trás dele, recusou. Conectar-se novamente não altera uma recusa, portanto, a mensagem aponta para seu administrador de gateway:
1629 1737
1630```text theme={null}1738```text theme={null}
1631Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1739Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
1634**O que fazer:**1742**O que fazer:**
1635 1743
1636* Peça ao seu administrador de gateway para procurar a solicitação. A cauda `API Error:` carrega a recusa que o gateway retornou1744* Peça ao seu administrador de gateway para procurar a solicitação. A cauda `API Error:` carrega a recusa que o gateway retornou
1637* 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)1745* Para administradores: uma [regra de controle de acesso](/docs/pt/claude-apps-gateway-config#http-tuning) no gateway retorna um 403 que o [log de auditoria](/docs/pt/claude-apps-gateway-deploy#logs) registra com seu motivo, e uma negação de autorização de um upstream passa através por [Mensagens de erro de Upstream](/docs/pt/claude-apps-gateway-config#upstream-error-messages)
1638 1746
1639Antes 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.1747Antes da v2.1.273, um 403 em uma sessão de gateway mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, e conectar-se novamente não limpava a recusa.
1640 1748
1641<h2 id="network-and-connection-errors">1749<h2 id="network-and-connection-errors">
1642 Erros de rede e conexão1750 Erros de rede e conexão
1657No internet route — check your connection or VPN (EHOSTUNREACH)1765No internet route — check your connection or VPN (EHOSTUNREACH)
1658Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host1766Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
1659Connection dropped (ECONNRESET)1767Connection dropped (ECONNRESET)
1660fetch failed
1661Request timed out. Check your internet connection and proxy settings1768Request timed out. Check your internet connection and proxy settings
1662```1769```
1663 1770
1677 1784
1678Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:1785Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:
1679 1786
1787* Verifique se `ANTHROPIC_BASE_URL` está definido executando `echo $ANTHROPIC_BASE_URL`, ou `echo $env:ANTHROPIC_BASE_URL` no PowerShell, e procure por ele no bloco `env` de seus [settings files](/docs/pt/settings). Quando está definido, Claude Code envia solicitações de modelo para esse endereço em vez de `api.anthropic.com`, então um valor remanescente apontando para um proxy local ou gateway que não está mais em execução produz `Connection refused` mesmo que `curl` alcance a API. Remova-o do seu perfil de shell ou configurações e inicie Claude Code a partir de um novo terminal.
1680* No Linux e WSL, verifique `/etc/resolv.conf` para um nameserver inacessível. WSL em particular pode herdar um resolver quebrado do host.1788* No Linux e WSL, verifique `/etc/resolv.conf` para um nameserver inacessível. WSL em particular pode herdar um resolver quebrado do host.
1681* 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.1789* 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.
1682* Docker Desktop e runtimes de contêiner similares podem interceptar tráfego de saída. Saia deles e tente novamente para descartar isso.1790* Docker Desktop e runtimes de contêiner similares podem interceptar tráfego de saída. Saia deles e tente novamente para descartar isso.
1702 1810
1703* 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).1811* 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).
1704* 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.1812* 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.
1705* 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.
1706* 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)1813* 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)
1707 1814
1708<h3 id="socket-is-closed">1815<h3 id="socket-is-closed">
1744* 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 lugar1851* 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
1745* 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-API1852* 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
1746* Em uma rede com uma página de login, como Wi-Fi de convidado, complete o login em um navegador, depois tente novamente1853* Em uma rede com uma página de login, como Wi-Fi de convidado, complete o login em um navegador, depois tente novamente
1747* 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 fallback1854* 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 desativar esse fallback, exceto quando o endpoint de streaming em si retorna `404`, onde Claude Code ainda faz fallback
1748 1855
1749<h3 id="streaming-response-ended-before-any-complete-data-was-received">1856<h3 id="streaming-response-ended-before-any-complete-data-was-received">
1750 Streaming response ended before any complete data was received1857 Streaming response ended before any complete data was received
1826 1933
1827**O que fazer:**1934**O que fazer:**
1828 1935
1829Essas 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).1936Essas 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 na página **Cloud environments** em [admin settings](https://claude.ai/admin-settings).
1830 1937
1831* 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.1938* 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.
1832* 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.1939* 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.
1897* Inicie uma nova sessão com `claude --remote-control` para criar uma nova sessão Remote Control2004* Inicie uma nova sessão com `claude --remote-control` para criar uma nova sessão Remote Control
1898* Para outras mensagens de inicialização do Remote Control, veja [Troubleshoot Remote Control](/docs/pt/remote-control#troubleshooting)2005* Para outras mensagens de inicialização do Remote Control, veja [Troubleshoot Remote Control](/docs/pt/remote-control#troubleshooting)
1899 2006
1900Se 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).2007Se 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).
1901 2008
1902<h3 id="sessions-ended-while-this-machine-was-offline">2009<h3 id="sessions-ended-while-this-machine-was-offline">
1903 Sessions ended while this machine was offline2010 Sessions ended while this machine was offline
1924Couldn't share the transcript.2031Couldn't share the transcript.
1925```2032```
1926 2033
1927O 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.2034O 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 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.
1928 2035
1929**O que fazer:**2036**O que fazer:**
1930 2037
1931* 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 ambiente2038* 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
1932* 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)2039* 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)
1933 2040
2041<h3 id="couldnt-send-feedback">
2042 Couldn't send feedback
2043</h3>
2044
2045Você enviou um relatório do diálogo [`/feedback`, `/bug`, ou `/share`](/docs/pt/commands#all-commands) e o upload para Anthropic falhou. O diálogo mantém seu texto para que você possa tentar novamente.
2046
2047```text theme={null}
2048Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.
2049```
2050
2051O texto após o prefixo nomeia o que falhou:
2052
2053* **`: not signed in. Run /login, then retry.`**: o diálogo carrega apenas quando Claude Code encontrou credenciais Anthropic conforme abriu, e nenhuma era utilizável no momento em que você enviou. Por exemplo, você se desconectou nesta máquina enquanto isso, ou seu login não pôde mais ser atualizado.
2054* **Um parêntese**: `(server returned <status>)` é o código de resposta do serviço; `(request timed out)` e `(couldn't reach the service)` são falhas de rede. Quando Claude Code não consegue nomear um motivo, o parêntese está ausente.
2055
2056Na [feedback drafts queue](/docs/pt/tools-reference#sendfeedback-tool-behavior), a mesma falha termina com `The draft is still queued. Try again later.` em vez disso, e o rascunho permanece na fila para outra tentativa.
2057
2058**O que fazer:**
2059
2060* Para a redação não-assinada, execute `/login` e envie novamente
2061* Caso contrário, envie novamente; 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)
2062* Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues), como a mensagem diz
2063
2064Antes da v2.1.281, cada envio falhava com essa mensagem uma vez que um Remote Control **Stop** ou uma mensagem urgente entre sessões havia chegado enquanto o diálogo estava aberto. Nessas versões, feche o diálogo, reabra-o, e envie novamente.
2065
1934<h2 id="request-errors">2066<h2 id="request-errors">
1935 Erros de solicitação2067 Erros de solicitação
1936</h2>2068</h2>
2008* Execute `/context` para ver um detalhamento do que está consumindo a janela: prompt do sistema, ferramentas, arquivos de memória e mensagens2140* Execute `/context` para ver um detalhamento do que está consumindo a janela: prompt do sistema, ferramentas, arquivos de memória e mensagens
2009* Desabilite servidores MCP que você não está usando com `/mcp disable <name>` para remover suas definições de ferramentas do contexto2141* Desabilite servidores MCP que você não está usando com `/mcp disable <name>` para remover suas definições de ferramentas do contexto
2010* 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 relevante2142* 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
2011* 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.
2012* 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.2143* 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.
2013 2144
2014Veja [Explore the context window](/docs/pt/context-window) para uma visualização interativa de como o contexto se preenche.2145Veja [Explore the context window](/docs/pt/context-window) para uma visualização interativa de como o contexto se preenche.
2038 2169
2039Antes da v2.1.216, `/context` mostrava uso acima de 100% sem linha de aviso explicando o que isso significava ou como se recuperar.2170Antes da v2.1.216, `/context` mostrava uso acima de 100% sem linha de aviso explicando o que isso significava ou como se recuperar.
2040 2171
2041<h3 id="error-during-compaction-conversation-too-long">
2042 Erro durante compactação: Conversa muito longa
2043</h3>
2044
2045`/compact` em si falhou porque não há contexto livre suficiente para manter o resumo que produz.
2046
2047```text theme={null}
2048Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
2049```
2050
2051Isso 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`.
2052
2053**O que fazer:**
2054
2055* 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.
2056* 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`.
2057
2058Essa 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.
2059
2060<h3 id="request-too-large">2172<h3 id="request-too-large">
2061 Solicitação muito grande2173 Solicitação muito grande
2062</h3>2174</h3>
2140* 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 caminho2252* 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
2141* Para PDFs protegidos ou inválidos, remova a senha ou re-exporte o arquivo de seu aplicativo de origem, depois tente novamente2253* Para PDFs protegidos ou inválidos, remova a senha ou re-exporte o arquivo de seu aplicativo de origem, depois tente novamente
2142 2254
2255Quando Claude lê um intervalo de páginas de um PDF com a ferramenta Read, a leitura pode falhar com uma mensagem diferente:
2256
2257```text theme={null}
2258pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.
2259```
2260
2261Leituras de intervalo de páginas renderizam páginas com `pdftoppm`. Instale poppler-utils com o comando que a mensagem fornece, ou em outras plataformas uma compilação poppler que coloca `pdftoppm` em seu `PATH`. Veja [Read tool behavior](/docs/pt/tools-reference#read-tool-behavior) para quais PDFs são lidos por intervalo de páginas.
2262
2143<h3 id="extra-inputs-are-not-permitted">2263<h3 id="extra-inputs-are-not-permitted">
2144 Entradas extras não são permitidas2264 Entradas extras não são permitidas
2145</h3>2265</h3>
2148 2268
2149```text theme={null}2269```text theme={null}
2150API Error: 400 ... Extra inputs are not permitted ... context_management2270API Error: 400 ... Extra inputs are not permitted ... context_management
2151API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header
2152```2271```
2153 2272
2154Claude 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.2273Claude 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.
2185* 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.2304* 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.
2186* 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).2305* 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).
2187 2306
2307<h3 id="tool-use-name-over-200-characters">
2308 tool\_use.name com mais de 200 caracteres
2309</h3>
2310
2311Uma chamada de ferramenta no histórico de conversa carrega um nome mais longo que os 200 caracteres que a API aceita em uma solicitação:
2312
2313```text theme={null}
2314API Error: 400 ... tool_use.name: String should have at most 200 characters
2315```
2316
2317Claude Code corta tal nome para 200 caracteres quando a resposta chega e quando carrega uma conversa salva, então a chamada falha com um erro de ferramenta ordinário `No such tool available` e a conversa continua sem esse erro de API.
2318
2319**O que fazer:**
2320
2321* Execute `claude update`, depois retome a conversa. A versão atualizada repara o nome excessivamente longo quando carrega a transcrição, então uma conversa que estava presa funciona novamente.
2322
2323Antes da v2.1.281, o nome excessivamente longo permanecia no histórico e a API rejeitava cada solicitação que reenviava a conversa, incluindo `/compact` e `--resume`, então esse erro se repetia e a conversa ficava presa.
2324
2188<h3 id="theres-an-issue-with-the-selected-model">2325<h3 id="theres-an-issue-with-the-selected-model">
2189 Há um problema com o modelo selecionado2326 Há um problema com o modelo selecionado
2190</h3>2327</h3>
2202* **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.2339* **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.
2203* 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).2340* 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).
2204* 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.2341* 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.
2205* 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á.
2206* 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.2342* 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.
2207* Para implantações do Google Cloud's Agent Platform, veja [Google Cloud's Agent Platform troubleshooting](/docs/pt/google-vertex-ai#troubleshooting).2343* Para implantações do Google Cloud's Agent Platform, veja [Google Cloud's Agent Platform troubleshooting](/docs/pt/google-vertex-ai#troubleshooting).
2208 2344
2216Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?2352Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?
2217```2353```
2218 2354
2219A 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.2355A 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. Em uma sessão que o [Desktop app](/docs/pt/desktop) inicia para você, a dica sem correspondência lê `Switch to a different model.`
2220 2356
2221Claude 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).2357Claude 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).
2222 2358
2245* 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.2381* 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.
2246* 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.2382* 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.
2247 2383
2384<h3 id="api-error-model-not-changed">
2385 Erro de API ao verificar o modelo escolhido
2386</h3>
2387
2388Você escolheu um modelo com `/model <name>`, ou um aplicativo conectado à sessão solicitou a mudança. A API recusou a solicitação mínima que Claude Code envia para verificar o modelo, por uma razão que não tem entrada própria, como um limite de taxa ou um erro de servidor. A sessão mantém seu modelo atual, e a mensagem termina dizendo assim:
2389
2390```text theme={null}
2391API error: 429 <the server's explanation> · model not changed
2392```
2393
2394O meio da mensagem é o status HTTP e a própria explicação do servidor.
2395
2396**O que fazer:**
2397
2398* Aja sobre a explicação do servidor; para um limite de taxa ou um status 5xx, aguarde e escolha o modelo novamente
2399* As recusas com sua própria redação são cobertas pelas entradas circundantes, como [Model not found](#model-not-found) e [Model is restricted by your organization's settings](#model-is-restricted-by-your-organizations-settings)
2400
2248<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">2401<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">
2249 Claude Opus não está disponível com o plano Claude Pro2402 Claude Opus não está disponível com o plano Claude Pro
2250</h3>2403</h3>
2255Claude 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.2408Claude 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.
2256```2409```
2257 2410
2411Em uma sessão que o aplicativo Claude Desktop executa, a mensagem diz para `sign out and sign in again` em vez de nomear os comandos.
2412
2258**O que fazer:**2413**O que fazer:**
2259 2414
2260* Execute `/model` e selecione um modelo que seu plano inclui2415* Execute `/model` e selecione um modelo que seu plano inclui
2287 O modelo é restringido pelas configurações da sua organização2442 O modelo é restringido pelas configurações da sua organização
2288</h3>2443</h3>
2289 2444
2290Seu administrador de organização desabilitou este modelo no console de administração claude.ai, ou ele é excluído por uma lista de permissões [`availableModels`](/docs/pt/model-config#restrict-model-selection) em configurações gerenciadas. Quando o modelo restringido foi definido com `--model`, `ANTHROPIC_MODEL` ou a configuração `model`, Claude Code substitui um modelo permitido e continua. Digitar `/model <name>` para um modelo restringido é rejeitado com `Run /model to choose a different model.` e a sessão mantém seu modelo atual. 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.2445Seu administrador de organização desabilitou este modelo no console de administração claude.ai, ou configurações gerenciadas o excluem através de uma lista de permissões [`availableModels`](/docs/pt/model-config#restrict-model-selection) ou uma lista [`deniedModels`](/docs/pt/model-config#block-specific-models-or-versions). O aviso aparece na inicialização quando `--model`, `ANTHROPIC_MODEL` ou a configuração `model` nomeou o modelo restringido, e nomeia o modelo que a sessão usa em vez disso. Se as configurações gerenciadas não deixarem nenhum modelo permitido para a sessão usar, veja [Managed settings block the default model](#managed-settings-block-the-default-model). 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.
2291 2446
2292```text theme={null}2447```text theme={null}
2293Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.2448Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
2294```2449```
2295 2450
2451Digitar `/model <name>` para um modelo restringido é rejeitado e a sessão mantém seu modelo atual. Para um modelo desabilitado no console de administração, a rejeição lê `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` Para um modelo que as configurações gerenciadas excluem, lê `Model '<name>' is not available. Your organization restricts model selection.`
2452
2296Um 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.2453Um 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.
2297 2454
2298Claude 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 <alias>` 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.2455Claude 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 permite, e o aviso de substituição nomeia essa versão. Claude Code rejeita `/model <alias>` apenas quando cada versão da família é restringida. Antes 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.
2299 2456
2300**O que fazer:**2457**O que fazer:**
2301 2458
2354 2511
2355**O que fazer:**2512**O que fazer:**
2356 2513
2357* 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 posterior2514* 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. Sonnet 5.5 precisa da v2.1.284 ou posterior
2358* Se você não conseguir atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.6 em vez disso2515* Se você não conseguir atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.6 em vez disso
2359* 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 posterior2516* 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. Sonnet 5.5 precisa do SDK TypeScript v0.3.284 ou posterior
2360 2517
2361<h3 id="effort-isnt-available-with-thinking-turned-off">2518<h3 id="effort-isnt-available-with-thinking-turned-off">
2362 Effort não está disponível com o pensamento desativado2519 Effort não está disponível com o pensamento desativado
2368API 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)2525API 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)
2369```2526```
2370 2527
2528A dica após o `·` varia por sessão: em uma sessão não interativa lê `use --effort high (or the effortLevel setting)`, e em uma sessão que o aplicativo Claude Desktop executa lê `you can lower effort to High`.
2529
2371**O que fazer:**2530**O que fazer:**
2372 2531
2373* [Abaixe o nível de esforço](/docs/pt/model-config#set-the-effort-level) para `high` ou abaixo.2532* [Abaixe o nível de esforço](/docs/pt/model-config#set-the-effort-level) para `high` ou abaixo.
2374* 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.2533* 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.
2375 2534
2376Antes 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.2535Antes 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.
2377 2536
2378<h3 id="thinking-budget-exceeds-output-limit">2537<h3 id="thinking-budget-exceeds-output-limit">
2379 O orçamento de pensamento excede o limite de saída2538 O orçamento de pensamento excede o limite de saída
2385API Error: 400 ... max_tokens must be greater than thinking.budget_tokens2544API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
2386```2545```
2387 2546
2388Claude 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.
2389
2390**O que fazer:**2547**O que fazer:**
2391 2548
2392* Abaixe `MAX_THINKING_TOKENS` ou aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/pt/env-vars) acima do orçamento de pensamento2549* Aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/pt/env-vars) acima do orçamento de pensamento
2393* Veja [Extended thinking](/docs/pt/model-config#extended-thinking) para como o orçamento interage com o comprimento de saída2550* Veja [Extended thinking](/docs/pt/model-config#extended-thinking) para como o orçamento interage com o comprimento de saída
2394 2551
2395<h3 id="tool-use-or-thinking-block-mismatch">2552<h3 id="tool-use-or-thinking-block-mismatch">
2396 Incompatibilidade de bloco de uso de ferramenta ou pensamento2553 Incompatibilidade de bloco de uso de ferramenta ou pensamento
2397</h3>2554</h3>
2398 2555
2399O 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.2556O histórico de conversa chegou à API em um estado inconsistente.
2400 2557
2401```text theme={null}2558```text theme={null}
2402API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.2559API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
2413* 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.2570* 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.
2414* 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.2571* 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.
2415 2572
2573<h3 id="invalid-data-in-redacted-thinking-block">
2574 Dados inválidos no bloco redacted\_thinking
2575</h3>
2576
2577A API recusou a solicitação com um 400 porque não conseguiu aceitar um bloco `redacted_thinking` que uma volta anterior no histórico de conversa carrega.
2578
2579```text theme={null}
2580API Error: 400 ... Invalid `data` in `redacted_thinking` block
2581```
2582
2583Claude Code deixa o pensamento anterior da conversa fora da solicitação e tenta novamente uma vez, então a sessão continua sem mostrar o erro. Antes da v2.1.282, Claude Code mantinha o bloco recusado, e cada volta posterior falhava com o mesmo erro.
2584
2585**O que fazer:**
2586
2587* Se você está na v2.1.281 ou anterior e cada volta falha com esse erro, execute `claude update` e retome a sessão
2588* Se o erro persistir, execute `/clear` para iniciar uma conversa que não carrega o bloco
2589
2416<h3 id="unsupported-tool-content-removed">2590<h3 id="unsupported-tool-content-removed">
2417 Conteúdo de ferramenta não suportado removido2591 Conteúdo de ferramenta não suportado removido
2418</h3>2592</h3>
2442 2616
2443Claude 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.2617Claude 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.
2444 2618
2445Quando 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.2619Quando 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.
2446 2620
2447**O que fazer:**2621**O que fazer:**
2448 2622
2449* 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.
2450* 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 opera2623* 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
2624* 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.
2451 2625
2452Antes 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.2626Antes 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.
2453 2627
2458A 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:2632A 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:
2459 2633
2460```text theme={null}2634```text theme={null}
2461API Error: 400 messages.21.content.0: Invalid `encrypted_content` in `search_result` block2635API Error: 400 ... Invalid `encrypted_content` in `search_result` block
2462API Error: 400 messages.21.content.3.citations.0: Invalid `encrypted_index` in `text` block2636API Error: 400 ... Invalid `encrypted_index` in `text` block
2463API Error: 400 Failed to decrypt web search result content2637API Error: 400 ... Failed to decrypt web search result content
2638API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block
2464```2639```
2465 2640
2466Resultados 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.2641Resultados da ferramenta de [busca na web](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) hospedada da API carregam campos criptografados que apenas a API pode ler. A redação `encrypted_stdout` nomeia a saída de um programa de execução de código hospedado que leu tais resultados, que a API também criptografa. 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.
2467 2642
2468A 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.2643A 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.
2469 2644
2470Os blocos recusados permanecem no histórico de conversa, então cada volta posterior e `/compact` falham da mesma forma.2645Para as três redações de busca na web, Claude Code deixa as chamadas de busca, resultados e citações fora do que envia e tenta novamente a solicitação uma vez, então a sessão continua sem mostrar o erro. A redação `encrypted_stdout` não tem tal recuperação, então essa mensagem ainda chega a você. Antes da v2.1.282, Claude Code mantinha os blocos de busca na web recusados também, e cada volta posterior e `/compact` falhavam da mesma forma.
2471 2646
2472**O que fazer:**2647**O que fazer:**
2473 2648
2474* Execute `/clear` ou inicie uma nova sessão; a nova conversa não carrega os blocos recusados2649* Se você está na v2.1.281 ou anterior e cada volta falha com uma das redações de busca na web, execute `claude update` e retome a sessão
2650* Se o erro persistir, ou a mensagem nomeia `encrypted_stdout`, execute `/rewind` para voltar a um checkpoint antes da volta que adicionou o conteúdo, ou execute `/clear` para iniciar uma conversa que não carrega
2475* Se você executa Claude Code atrás de um proxy ou gateway, relate o erro a quem o opera2651* Se você executa Claude Code atrás de um proxy ou gateway, relate o erro a quem o opera
2476 2652
2477<h3 id="usage-policy-refusal">2653<h3 id="usage-policy-refusal">
2478 Recusa de Política de Uso2654 Recusa de Política de Uso
2479</h3>2655</h3>
2480 2656
2481A 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.2657A API recusou responder porque conteúdo na conversa acionou uma verificação de [Política de Uso](https://www.anthropic.com/legal/aup).
2658
2659A mensagem inclui um ID de Solicitação e um ID de Mensagem que você pode citar para suporte se acreditar que a recusa está incorreta.
2482 2660
2483```text theme={null}2661```text theme={null}
2484API Error: Opus 4.6 can't help with this. Start a new session to continue.2662API Error: Opus 4.6 can't help with this. Start a new session to continue.
2508API 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-claude2686API 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
2509```2687```
2510 2688
2511A 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.2689A 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 e Sonnet 5.5, a mensagem abre com `<model>'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.
2512 2690
2513Em [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.2691Em [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.
2514 2692
2550 A conexão foi interrompida durante o download da atualização2728 A conexão foi interrompida durante o download da atualização
2551</h3>2729</h3>
2552 2730
2553A 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.2731A conexão com o servidor de download foi fechada enquanto `claude install` ou `claude update` 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.
2554 2732
2555```text theme={null}2733```text theme={null}
2556The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.2734The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
2560 2738
2561Um 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.2739Um 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.
2562 2740
2563A 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.2741Um proxy ou gateway pode fechar uma transferência longa antes de ser concluída, e o binário do Claude Code é um download grande.
2564 2742
2565**O que fazer:**2743**O que fazer:**
2566 2744
2576Esses 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.2754Esses 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.
2577 2755
2578<h3 id="conflict-between-bg-and-print">2756<h3 id="conflict-between-bg-and-print">
2579 Conflito entre --bg e --print2757 Conflito entre `--bg` e `--print`
2580</h3>2758</h3>
2581 2759
2582Esta 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.2760Esta 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.
2591* Para executar o prompt não interativamente e imprimir o resultado em vez de criar uma sessão em background, remova `--bg` e execute `claude -p "<task>"`2769* Para executar o prompt não interativamente e imprimir o resultado em vez de criar uma sessão em background, remova `--bg` e execute `claude -p "<task>"`
2592 2770
2593<h3 id="invalid-agents-configuration">2771<h3 id="invalid-agents-configuration">
2594 Configuração inválida de --agents2772 Configuração inválida de `--agents`
2595</h3>2773</h3>
2596 2774
2597O 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.2775O valor que você passou para `--agents` é inválido, então `claude` sai com código 1 em vez de iniciar a sessão. Quando você passa `--safe-mode` ou define [`CLAUDE_CODE_SAFE_MODE`](/docs/pt/env-vars#variables), Claude Code ignora `--agents` completamente. Com `--resume` ou `--continue`, um valor JSON inline não é verificado e a sessão inicia; um valor lido de um arquivo é verificado a cada lançamento. Antes da v2.1.242, Claude Code iniciava a sessão mesmo assim.
2598 2776
2599```text theme={null}2777```text theme={null}
2600Error: Invalid --agents configuration:2778Error: Invalid --agents configuration:
2603 2781
2604O 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:2782O 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:
2605 2783
26061. Quando o valor não é analisado como JSON, Claude Code imprime uma linha `invalid JSON:` com a mensagem do próprio analisador JSON27841. Quando o valor começa com `{` mas não é analisado como JSON, ou o conteúdo de um arquivo `--agents` não é analisado, Claude Code imprime uma linha `invalid JSON:` com a mensagem do próprio analisador JSON
26072. 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 problema27852. 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
26083. Quando um nome de agente começa com `-`, Claude Code imprime `<name>: agent names must not start with '-'`27863. Quando um nome de agente começa com `-`, Claude Code imprime `<name>: agent names must not start with '-'`
2609 2787
2610Quando há mais de 20 linhas de problema, Claude Code imprime as primeiras 20 e substitui o resto por `…and N more`.2788Quando há mais de 20 linhas de problema, Claude Code imprime as primeiras 20 e substitui o resto por `…and N more`.
2611 2789
2790Com `--print`, `--agents` também aceita [o caminho para um arquivo JSON](/docs/pt/sub-agents#choose-the-subagent-scope) no lugar do objeto inline. Antes da v2.1.281, `--agents` aceitava apenas JSON inline e tratava um caminho de arquivo como JSON inválido. O formulário de arquivo tem recusas próprias, impressas no lugar dessa mensagem, incluindo estas:
2791
2792* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code leu o valor como um caminho de arquivo em uma sessão interativa. Passe as definições como JSON inline, ou adicione `-p` para lê-las de um arquivo.
2793* **`Error: --agents file not found: <path>`**: nenhum arquivo existe naquele caminho. Um valor que não começa com `{` e não é JSON válido é lido como um caminho, então JSON inline que seu shell danificou pode falhar dessa forma também. Verifique o caminho ou as aspas e execute o comando novamente.
2794
2612**O que fazer:**2795**O que fazer:**
2613 2796
2614* 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).2797* Corrija cada problema que a mensagem lista, depois execute o comando novamente. Veja [os campos que um subagente definido por CLI toma](/docs/pt/sub-agents#choose-the-subagent-scope).
2615 2798
2616<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">2799<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">
2617 Sessões em nuvem não podem ser criadas a partir de uma sessão --restricted2800 Sessões em nuvem não podem ser criadas a partir de uma sessão `--restricted`
2618</h3>2801</h3>
2619 2802
2620Quando 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:2803Quando 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:
2652* Se a mensagem disser que não conseguiu verificar a política, verifique sua conexão de rede, depois reinicie Claude Code e tente novamente2835* 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
2653 2836
2654<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2837<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
2655 O valor --json-schema não é um JSON Schema válido2838 O valor `--json-schema` não é um JSON Schema válido
2656</h3>2839</h3>
2657 2840
2658O 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.2841O 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.
2668**O que fazer:**2851**O que fazer:**
2669 2852
2670* Corrija a parte do esquema que o diagnóstico nomeia, depois execute o comando novamente2853* Corrija a parte do esquema que o diagnóstico nomeia, depois execute o comando novamente
2671* Se o diagnóstico for `schema too large`, reduza o aninhamento do esquema e a reutilização de `$ref`
2672* Veja [Get structured output](/docs/pt/headless#get-structured-output) para um esquema funcionando e comando2854* Veja [Get structured output](/docs/pt/headless#get-structured-output) para um esquema funcionando e comando
2673 2855
2674<h3 id="settings-file-exceeds-the-2mib-limit">2856<h3 id="settings-file-exceeds-the-2mib-limit">
2675 Arquivo de configurações excede o limite de 2MiB2857 Arquivo de configurações excede o limite de 2MiB
2676</h3>2858</h3>
2677 2859
2678O 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.2860O arquivo que você passou para [`--settings`](/docs/pt/cli-reference#cli-flags) é maior que 2 MiB, então `claude` sai com código 1 na inicialização em vez de carregá-lo. Antes da v2.1.214, Claude Code lia o arquivo sem verificação de tamanho, e um arquivo de vários gigabytes ou um arquivo de dispositivo como `/dev/zero` crescia em memória sem limite.
2679 2861
2680```text theme={null}2862```text theme={null}
2681Error: Settings file exceeds the 2MiB limit: /path/to/settings.json2863Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
2756 Workspace não confiável ao iniciar Remote Control2938 Workspace não confiável ao iniciar Remote Control
2757</h3>2939</h3>
2758 2940
2759Você 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:2941Você iniciou o modo servidor [Remote Control](/docs/pt/remote-control) com `claude remote-control` ou seu alias `claude rc` em um diretório que você não confiou, e o comando não conseguiu perguntar se você confiaria nele. Por exemplo, a entrada padrão ou saída padrão do comando não é um terminal porque uma delas é redirecionada ou canalizada. O comando sai com código 1:
2760 2942
2761```text theme={null}2943```text theme={null}
2762Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.2944Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
2763```2945```
2764 2946
2947Duas variantes que também começam com `Error: Workspace not trusted.` aparecem em um terminal também muito pequeno para mostrar o que confiar no diretório ativa, ou um que não relatou seu tamanho. Amplie a janela ou mude para uma janela de terminal normal, depois execute `claude rc` novamente.
2948
2765Em 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á.2949Em 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á.
2766 2950
2767```text theme={null}2951```text theme={null}
2768Error: 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).2952Error: 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).
2769```2953```
2770 2954
2955Se você responder `n` ou pressionar Enter na [pergunta `Trust <directory>?`](/docs/pt/remote-control#requirements), o comando imprime uma mensagem `Remote Control did not start` que nomeia o diretório e sai com código 1. Execute `claude rc` novamente para responder `y`.
2956
2771**O que fazer:**2957**O que fazer:**
2772 2958
2773* 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` novamente2959* Confie no diretório a partir de um terminal primeiro: execute `claude rc` lá e responda `y`, ou execute `claude` lá e aceite o [diálogo de confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust), depois execute seu comando original novamente
2774* Em seu diretório inicial, mude para um diretório de projeto e inicie Remote Control lá2960* Em seu diretório inicial, mude para um diretório de projeto e inicie Remote Control lá
2775 2961
2962Antes da v2.1.284, o comando nunca perguntava, mesmo em um terminal.
2963
2776<h3 id="not-carried-over-to-the-sessions-remote-control-starts">2964<h3 id="not-carried-over-to-the-sessions-remote-control-starts">
2777 Não levado para as sessões que Remote Control inicia2965 Não levado para as sessões que Remote Control inicia
2778</h3>2966</h3>
2834 Não foi possível importar um servidor do Claude Desktop3022 Não foi possível importar um servidor do Claude Desktop
2835</h3>3023</h3>
2836 3024
2837Claude 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.3025Claude 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.
2838 3026
2839```text theme={null}3027```text theme={null}
2840Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3028Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
2998* Se o repositório não tem remote, adicione um com `git remote add origin <url>` e busque antes de criar a ref. Se o remote está vazio, faça push de seu branch primeiro com `git push -u origin HEAD` e nomeie esse branch no comando set-head; `origin/HEAD` então aponta para o branch que você acabou de fazer push, então `/security-review` vê um diff vazio até o branch divergir dele.3186* Se o repositório não tem remote, adicione um com `git remote add origin <url>` e busque antes de criar a ref. Se o remote está vazio, faça push de seu branch primeiro com `git push -u origin HEAD` e nomeie esse branch no comando set-head; `origin/HEAD` então aponta para o branch que você acabou de fazer push, então `/security-review` vê um diff vazio até o branch divergir dele.
2999 3187
3000<h3 id="input-must-be-provided-when-using-print">3188<h3 id="input-must-be-provided-when-using-print">
3001 Entrada deve ser fornecida ao usar --print3189 Entrada deve ser fornecida ao usar `--print`
3002</h3>3190</h3>
3003 3191
3004`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.3192`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.
3269* 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ão3457* 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
3270* 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 imprimiu3458* 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
3271 3459
3460<h3 id="windows-reported-an-error-ebadf">
3461 Windows relatou um erro (EBADF) quando Claude Code leu o arquivo de transcrição desta sessão
3462</h3>
3463
3464Você retomou uma sessão no Windows, seu arquivo de [transcrição](/docs/pt/sessions#where-transcripts-are-stored) salvo abriu normalmente, e a leitura dele então falhou com o erro do sistema EBADF. O erro do sistema não diz por que a leitura falhou, então a mensagem sugere causas prováveis e o que tentar:
3465
3466```text theme={null}
3467Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.
3468```
3469
3470A mensagem segue a linha de falha própria do comando, como `Failed to resume session <session-id>`. Um comando `claude --resume` ou [`claude -p`](/docs/pt/headless) sai com código 1 após mostrar. Depois de `/resume` dentro de uma sessão, sua sessão atual continua em execução.
3471
3472**O que fazer:**
3473
3474* Exclua a pasta que contém suas transcrições de sessão de software que escaneia ou intercepta leituras de arquivo, como ferramentas de segurança, criptografia ou gerenciamento de endpoint. As transcrições vivem sob `%USERPROFILE%\.claude\projects` por padrão, ou sob o diretório que [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars) nomeia
3475* Se você não conseguir adicionar uma exclusão, adicione Claude Code às aplicações permitidas desse software em vez disso
3476* Retome a sessão novamente
3477
3478Antes da v2.1.282, a falha veio sem explicação: `claude --resume <session-id>` terminou em `Failed to resume session <session-id>`, e uma execução `-p` imprimiu apenas o texto de erro do sistema, como `Failed to resume session: EBADF: bad file descriptor, read`.
3479
3272<h3 id="cannot-switch-renderers-in-this-session">3480<h3 id="cannot-switch-renderers-in-this-session">
3273 Não é possível alternar renderizadores nesta sessão3481 Não é possível alternar renderizadores nesta sessão
3274</h3>3482</h3>
3415 Marketplace is registered from an untrusted source3623 Marketplace is registered from an untrusted source
3416</h3>3624</h3>
3417 3625
3418O marketplace está registrado sob um nome que é [reservado para marketplaces oficiais da Anthropic](/docs/pt/plugins/marketplace-reference#marketplace-file), mas sua fonte registrada não é um repositório GitHub `anthropics`. Claude Code verifica novamente os nomes reservados toda vez que carrega ou atualiza um marketplace, então o marketplace e os plugins instalados a partir dele param de carregar. Antes da v2.1.205, o nome era verificado apenas quando o marketplace era adicionado, então uma entrada registrada antes de seu nome ficar reservado continuava carregando.3626O marketplace está registrado sob um nome que é [reservado para marketplaces oficiais da Anthropic](/docs/pt/plugins/marketplace-reference#marketplace-file), mas sua fonte registrada não é um repositório GitHub `anthropics`. Claude Code verifica novamente os nomes reservados toda vez que carrega ou atualiza um marketplace, então o marketplace e os plugins instalados a partir dele param de carregar. Antes da v2.1.205, uma entrada registrada antes de seu nome ficar reservado continuava carregando.
3419 3627
3420```text theme={null}3628```text theme={null}
3421Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.3629Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.
3452* Renomeie o marketplace para um nome que não soletra um nome reservado e adicione-o novamente3660* Renomeie o marketplace para um nome que não soletra um nome reservado e adicione-o novamente
3453* Para o aviso de entrada ignorada, execute o comando `claude plugin marketplace remove` que ele fornece, ou remova a entrada de `~/.claude/plugins/known_marketplaces.json`3661* Para o aviso de entrada ignorada, execute o comando `claude plugin marketplace remove` que ele fornece, ou remova a entrada de `~/.claude/plugins/known_marketplaces.json`
3454 3662
3663<h3 id="claude-code-refuses-the-marketplace-name">
3664 Claude Code refuses the marketplace name
3665</h3>
3666
3667Um marketplace registrado tem um nome que [se passa por um marketplace oficial da Anthropic](/docs/pt/plugins/marketplace-reference#reserved-names) sob as regras que essa seção lista.
3668
3669Se um marketplace foi registrado sob tal nome antes da verificação bloqueá-lo, o marketplace e os plugins instalados a partir dele param de carregar, porque Claude Code verifica o nome toda vez que lê o catálogo do marketplace. Quando o nome imita um oficial, `claude plugin list` e a aba **Errors** do `/plugin` relatam cada plugin afetado com uma mensagem que começa:
3670
3671```text theme={null}
3672Claude Code refuses the marketplace name "anthropic-plugins-v2"
3673```
3674
3675Para um nome imitador, o próprio erro do marketplace lê `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own` em vez disso. `claude plugin marketplace add` recusa qualquer nome que se passa por outro com `Marketplace name impersonates an official Anthropic/Claude marketplace`.
3676
3677Antes da v2.1.282, `claude plugin list` e `/plugin` relatavam os plugins de um nome imitador como falhando ao carregar também, sem nomear o nome do marketplace como a causa.
3678
3679**O que fazer:**
3680
3681* Execute `claude plugin marketplace remove <name>`. Isso também desinstala os plugins instalados do marketplace e deleta seus dados salvos
3682* Para manter o marketplace em vez disso, aguarde até que seu mantenedor o renomeie, depois execute `claude plugin marketplace update <name>`
3683* Se você publica o marketplace, renomeie-o em seu `marketplace.json`; os usuários então atualizam o marketplace em vez de removê-lo
3684
3455<h3 id="marketplace-is-already-added-from-a-different-source">3685<h3 id="marketplace-is-already-added-from-a-different-source">
3456 Marketplace is already added from a different source3686 Marketplace is already added from a different source
3457</h3>3687</h3>
3654 3884
3655* Peça a um administrador de sua organização claude.ai para mudar o status obrigatório do plugin em claude.ai3885* Peça a um administrador de sua organização claude.ai para mudar o status obrigatório do plugin em claude.ai
3656 3886
3887<h3 id="plugin-was-not-uninstalled">
3888 Plugin was not uninstalled
3889</h3>
3890
3891Você executou [`claude plugin uninstall`](/docs/pt/plugins/cli-reference#plugin-uninstall), ou escolheu **Uninstall** na aba **Installed** do `/plugin`, e a desinstalação parou com uma mensagem começando `"<plugin>" was not uninstalled:`.
3892
3893Quando Claude Code removeu a entrada do plugin de `enabledPlugins` e leu os arquivos de configurações desse escopo novamente, ou o plugin ainda estava ligado lá, ou um arquivo que poderia ligá-lo não conseguiu ser lido ou verificado. Deletar as opções salvas do plugin, segredos e dados enquanto uma entrada de configurações poderia ligá-lo novamente perderia tudo, então a desinstalação para em vez disso: o plugin permanece instalado e nada que ele salvou é deletado.
3894
3895```text theme={null}
3896✘ Failed to uninstall plugin "formatter": "formatter" was not uninstalled: it is still switched on in /home/user/project/.claude/settings.local.json, although the settings change reported no error. It is still installed. Take it out of "enabledPlugins" in that file yourself, then uninstall it again.
3897```
3898
3899O meio da mensagem nomeia o arquivo e a causa:
3900
3901* `it is still switched on in <file>, although the settings change reported no error`: a escrita de configurações relatou sucesso mas a entrada ainda está lá quando o arquivo é lido novamente
3902* `it is still switched on in <file>, and the settings change failed (<error>)`: o arquivo não conseguiu ser salvo, pela razão entre parênteses
3903* `<file> is there and could not be read`: o arquivo existe mas não conseguiu ser lido como configurações, por exemplo porque não é JSON válido, então pode ainda ativar o plugin
3904* `<file> (not read: it is on a network path or is a link to one, or could not be checked)`: Claude Code não leu o arquivo de configurações do projeto ou local porque o arquivo, ou a pasta `.claude` que o contém, é um link que leva a um local de rede, ou porque não conseguiu examinar esse caminho
3905
3906`claude plugin uninstall` sai com código 1, e com `--json` o resultado carrega `failureCode: "settings_still_on"`. `/plugin` mostra a mesma mensagem.
3907
3908**O que fazer:**
3909
3910* Siga a última frase da mensagem: repare ou substitua o arquivo de configurações que ela nomeia, ou remova a entrada do plugin de `enabledPlugins` naquele arquivo você mesmo, depois execute a desinstalação novamente
3911
3657<h2 id="tool-errors">3912<h2 id="tool-errors">
3658 Erros de ferramentas3913 Erros de ferramentas
3659</h2>3914</h2>
3703* Se Claude deveria ser capaz de mudar o arquivo, remova ou estreite a regra de negação `Read` em `/permissions` ou em [settings](/docs/pt/settings-reference#permission-settings)3958* Se Claude deveria ser capaz de mudar o arquivo, remova ou estreite a regra de negação `Read` em `/permissions` ou em [settings](/docs/pt/settings-reference#permission-settings)
3704* Se o arquivo deve permanecer intocado, mantenha a regra e adicione uma regra de negação `Edit` para o mesmo caminho para bloquear a ferramenta NotebookEdit também3959* Se o arquivo deve permanecer intocado, mantenha a regra e adicione uma regra de negação `Edit` para o mesmo caminho para bloquear a ferramenta NotebookEdit também
3705 3960
3961<h3 id="path-cannot-contain-null-bytes">
3962 Path cannot contain null bytes
3963</h3>
3964
3965Uma chamada de ferramenta de arquivo teve seu argumento path ou pattern contendo um byte nulo, que sistemas de arquivos e ferramentas de pesquisa não podem aceitar. Read, Write, Edit, NotebookEdit, Glob, e Grep verificam isso, e a mensagem nomeia a ferramenta e o argumento:
3966
3967```text theme={null}
3968Read file_path cannot contain null bytes (\0). Remove the null byte and try again.
3969```
3970
3971A chamada de ferramenta falha, Claude vê o erro, e o turno continua.
3972
3973**O que fazer:**
3974
3975* Nada da sua parte: o erro é retornado ao Claude como o resultado da ferramenta, e a mensagem em si diz ao Claude para remover o byte nulo e tentar novamente
3976
3977Antes da v2.1.281, um byte nulo em um caminho Read, Write, Edit, ou NotebookEdit terminava o turno inteiro com um erro nomeando `Path contains null bytes`, e a ferramenta nunca era executada.
3978
3706<h3 id="subagent-type-is-required">3979<h3 id="subagent-type-is-required">
3707 subagent\_type é obrigatório3980 subagent\_type é obrigatório
3708</h3>3981</h3>
3839 4112
3840Antes da v2.1.236, Claude Code relatava esses envios como enviados. A sessão receptora os descartava sem ler.4113Antes da v2.1.236, Claude Code relatava esses envios como enviados. A sessão receptora os descartava sem ler.
3841 4114
4115<h3 id="cross-session-message-dropped-at-the-inbox">
4116 Mensagem entre sessões foi descartada na caixa de entrada da sessão receptora
4117</h3>
4118
4119Claude enviou uma [mensagem entre sessões](/docs/pt/cross-session-messaging) para outra de suas sessões nesta máquina, e a caixa de entrada dessa sessão a descartou antes de Claude nessa sessão lê-la. A linha nomeia o endereço do destinatário e, quando o destinatário deu uma razão, adiciona a razão após um travessão:
4120
4121```text wrap theme={null}
4122Cross-session message was dropped at the recipient session's inbox (recipient: uds:/tmp/cc-socks/13605.sock) and not delivered — its queue of undelivered peer messages was full. Claude was told not to resend right away.
4123```
4124
4125Uma linha pode cobrir várias mensagens descartadas. Ela então começa no plural, por exemplo `Cross-session messages (12) were dropped`. Para encontrar qual sessão um endereço pertence, compare-o com a linha [`Peer address`](/docs/pt/cross-session-messaging#the-sessions-inbox-socket) que `/status` mostra em cada sessão.
4126
4127Após o travessão, a linha dá uma ou mais dessas razões:
4128
4129* `its queue of undelivered peer messages was full`: o destinatário já mantinha tantas mensagens não entregues de outras sessões quanto sua fila permite
4130* `you sent faster than that session accepts`: as mensagens da sessão remetente chegaram mais rápido do que o destinatário aceita de um remetente
4131* `it repeated your previous message`: a mensagem era idêntica a uma que a sessão remetente enviou a esse destinatário pouco antes
4132* `a relay loop between sessions was cut`: a mensagem continuava uma cadeia de sessões messageando uma à outra, e a cadeia tinha passado pelo destinatário muitas vezes ou crescido muito
4133
4134**O que fazer:**
4135
4136* Assuma que o destinatário nunca viu as mensagens descartadas. Claude Code diz o mesmo ao Claude, e diz a ele para incluir qualquer coisa que ainda importe em uma mensagem posterior em vez de reenviar imediatamente
4137* Se suas sessões enviam uma à outra atualizações frequentes, peça ao Claude para enviar menos, mensagens maiores, como um relatório quando uma sessão termina seu trabalho
4138* Para `a relay loop between sessions was cut`, digite a próxima instrução em uma das sessões você mesmo. Uma mensagem que Claude envia em resposta ao seu próprio prompt começa uma nova cadeia
4139
4140Antes da v2.1.238, a sessão remetente não recebeu relatório quando a caixa de entrada do destinatário descartou uma mensagem.
4141
3842<h3 id="refusing-to-send-a-cross-session-message">4142<h3 id="refusing-to-send-a-cross-session-message">
3843 Recusando enviar uma mensagem entre sessões4143 Recusando enviar uma mensagem entre sessões
3844</h3>4144</h3>
3853 4153
3854* `reply target is a symlink`: um link simbólico fica no caminho do socket da sessão alvo. Claude Code não entrega através dele, porque um link lá poderia redirecionar a mensagem para um endpoint que a sessão alvo não criou.4154* `reply target is a symlink`: um link simbólico fica no caminho do socket da sessão alvo. Claude Code não entrega através dele, porque um link lá poderia redirecionar a mensagem para um endpoint que a sessão alvo não criou.
3855* `cannot vet reply target`: Claude Code não conseguiu inspecionar o caminho alvo em tudo, por exemplo porque lê-lo falhou com um erro de permissão.4155* `cannot vet reply target`: Claude Code não conseguiu inspecionar o caminho alvo em tudo, por exemplo porque lê-lo falhou com um erro de permissão.
3856* `connected endpoint is not the expected process`: o processo que mantém o socket não é a sessão para a qual a mensagem foi endereçada, então o endereço é obsoleto ou outro processo substituiu o socket.
3857* `connected endpoint identity could not be read`: Claude Code se conectou mas não conseguiu ler qual processo mantém a outra extremidade, então não conseguiu confirmar o alvo. Isso pode ser transitório.
3858* `connected endpoint is not owned by this user`: o processo que mantém o socket é executado como uma conta de usuário diferente, então não é uma de suas sessões.
3859* `connected endpoint owner could not be read`: Claude Code se conectou mas não conseguiu ler qual conta de usuário possui a outra extremidade, então não conseguiu confirmar que o endpoint é seu.
3860* `connected endpoint is a different process with the expected pid`: o ID do processo corresponde ao que a mensagem foi endereçada, mas Claude Code não conseguiu confirmar que é o mesmo processo. Geralmente essa sessão saiu e o sistema operacional reutilizou seu ID de processo, então o endereço é obsoleto.
3861 4156
3862**O que fazer:**4157**O que fazer:**
3863 4158
3864* Geralmente nada: as verificações mantêm uma mensagem de chegar a um endpoint diferente da sessão para a qual foi endereçada, e nada foi enviado4159* Geralmente nada: as verificações mantêm uma mensagem de chegar a um endpoint diferente da sessão para a qual foi endereçada, e nada foi enviado
3865* Peça ao Claude para listar suas sessões novamente e reenviar; uma recusa causada por um endereço obsoleto se limpa uma vez que Claude envia para o atual
3866* Se `reply target is a symlink` se repete para uma sessão, verifique o que criou um link no caminho do socket dessa sessão, mostrado em seu `/status` sob `Peer address`4160* Se `reply target is a symlink` se repete para uma sessão, verifique o que criou um link no caminho do socket dessa sessão, mostrado em seu `/status` sob `Peer address`
3867* Para `connected endpoint identity could not be read`, reenvie; a condição pode ser transitória
3868* Se `connected endpoint is not owned by this user` aparece em uma máquina compartilhada, a sessão nesse endereço é executada sob a conta de usuário de outro, então Claude não pode messageá-la da sua
3869
3870Antes da v2.1.248, Claude Code não verificava o usuário proprietário do endpoint ou o tempo de início do processo, então as recusas que nomeiam essas verificações não aparecem em versões anteriores.
3871 4161
3872<h3 id="refusing-after-a-symlink-changed">4162<h3 id="refusing-after-a-symlink-changed">
3873 Recusando ler, escrever, ou pesquisar um caminho4163 Recusando ler, escrever, ou pesquisar um caminho
3883 4173
3884* `its symlink resolution changed after permission was checked`: um symlink ao longo do caminho, ou em uma raiz de pesquisa Grep ou Glob, foi substituído entre a verificação de permissão e a operação. Em uma recusa de leitura, a frase entre parênteses nomeia qual comparação falhou.4174* `its symlink resolution changed after permission was checked`: um symlink ao longo do caminho, ou em uma raiz de pesquisa Grep ou Glob, foi substituído entre a verificação de permissão e a operação. Em uma recusa de leitura, a frase entre parênteses nomeia qual comparação falhou.
3885* `its parent-directory symlink resolution changed after permission was checked`: um diretório pelo qual o caminho de escrita passa não se resolve mais para o local aprovado4175* `its parent-directory symlink resolution changed after permission was checked`: um diretório pelo qual o caminho de escrita passa não se resolve mais para o local aprovado
4176* `where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve)`: Claude Code não conseguiu seguir o caminho para um local final no disco, por exemplo porque symlinks nele formam um loop
3886* `it is a symbolic link. Write to the link's target path instead`: um link simbólico fica no local de escrita aprovado em si, por exemplo um `CLAUDE.md` que é um symlink para `AGENTS.md`; a mensagem direciona Claude para o alvo do link4177* `it is a symbolic link. Write to the link's target path instead`: um link simbólico fica no local de escrita aprovado em si, por exemplo um `CLAUDE.md` que é um symlink para `AGENTS.md`; a mensagem direciona Claude para o alvo do link
3887* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: a mesma condição capturada quando outro escritor abre o arquivo, como uma escrita para um `.mcp.json` symlinked4178* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: a mesma condição capturada quando outro escritor abre o arquivo, como uma escrita para um `.mcp.json` symlinked
3888* `Refusing to write into symlinked directory: <path>`: o diretório que mantém o arquivo é em si um link simbólico, por exemplo o diretório `.claude/` de um projeto vinculado a outro local4179* `Refusing to write into symlinked directory: <path>`: o diretório que mantém o arquivo é em si um link simbólico, por exemplo o diretório `.claude/` de um projeto vinculado a outro local
3901 4192
3902Antes da v2.1.251, Claude Code verificava novamente a resolução de um caminho apenas para escritas de arquivo, então um link substituído após a verificação de permissão poderia redirecionar uma leitura ou pesquisa para um local diferente sem uma mensagem. Desses, apenas as recusas de escrita de diretório pai, através de symlink, e diretório symlinked aparecem em versões anteriores.4193Antes da v2.1.251, Claude Code verificava novamente a resolução de um caminho apenas para escritas de arquivo, então um link substituído após a verificação de permissão poderia redirecionar uma leitura ou pesquisa para um local diferente sem uma mensagem. Desses, apenas as recusas de escrita de diretório pai, através de symlink, e diretório symlinked aparecem em versões anteriores.
3903 4194
4195Antes da v2.1.280, a recusa `where it leads on disk could not be determined` não aparecia.
4196
3904<h3 id="task-output-swap-refused">4197<h3 id="task-output-swap-refused">
3905 Troca de saída de tarefa recusada4198 Troca de saída de tarefa recusada
3906</h3>4199</h3>
3926* Ou verifique o diretório do seu projeto sob o diretório temporário Claude Code, `/private/tmp/claude-501/-Users-you-my-project` na mensagem de exemplo. Se esse caminho é um link simbólico, ou um diretório que não deveria estar lá, remova o link ou diretório em si em vez do alvo do link, e reinicie Claude Code4219* Ou verifique o diretório do seu projeto sob o diretório temporário Claude Code, `/private/tmp/claude-501/-Users-you-my-project` na mensagem de exemplo. Se esse caminho é um link simbólico, ou um diretório que não deveria estar lá, remova o link ou diretório em si em vez do alvo do link, e reinicie Claude Code
3927* Se a recusa se repete, um processo está substituindo, vinculando, ou removendo entradas sob o diretório temporário Claude Code enquanto a sessão é executada. Defina [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars) para um diretório que nada mais gerencia e reinicie4220* Se a recusa se repete, um processo está substituindo, vinculando, ou removendo entradas sob o diretório temporário Claude Code enquanto a sessão é executada. Defina [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars) para um diretório que nada mais gerencia e reinicie
3928 4221
4222<h3 id="disk-quota-or-temp-filesystem-is-full">
4223 Disco cheio ou sistema de arquivos temporário está cheio
4224</h3>
4225
4226Claude Code salva a saída de cada comando Bash e PowerShell em um arquivo sob seu diretório temporário. Quando um comando sai com um código diferente de zero e nenhuma saída em tudo, Claude Code verifica se o sistema de arquivos que mantém esse arquivo está sem espaço ou inodes, ou se sua cota de disco nele está usada. Se assim for, um diagnóstico aparece no resultado do comando no lugar da saída vazia:
4227
4228```text wrap theme={null}
4229Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.
4230```
4231
4232A mensagem nomeia o que ficou sem espaço:
4233
4234* `Your disk quota is full ... (EDQUOT)`: sua própria cota nesse sistema de arquivos está usada. Uma cota pode estar cheia enquanto o sistema de arquivos ainda mostra espaço livre
4235* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: o sistema de arquivos, ou sua cota nele, não tem espaço deixado
4236* `Command output was lost: the temp filesystem at ... is full` ou `... is out of inodes`: o sistema de arquivos tem quase nenhum espaço livre deixado, ou está ficando sem inodes
4237
4238**O que fazer:**
4239
4240* Delete arquivos que você não precisa mais no sistema de arquivos que mantém o diretório temporário Claude Code. Para `EDQUOT`, delete arquivos que contam contra sua própria cota. Para `out of inodes`, delete muitos arquivos em vez de alguns grandes, já que cada arquivo leva um inode qualquer que seja seu tamanho
4241* Ou reinicie Claude Code com [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars) definido para um diretório em um sistema de arquivos com espaço
4242* Então tenha Claude executar o comando novamente. A saída que ele imprimiu foi perdida, não truncada
4243
3929<h3 id="the-source-file-is-not-valid-utf-8-text">4244<h3 id="the-source-file-is-not-valid-utf-8-text">
3930 O arquivo de origem não é texto UTF-8 válido4245 O arquivo de origem não é texto UTF-8 válido
3931</h3>4246</h3>
3993 Comandos recusados em uma sessão em background4308 Comandos recusados em uma sessão em background
3994</h3>4309</h3>
3995 4310
3996Comandos que abrem um diálogo interativo não podem fazer isso enquanto nenhum terminal está conectado a uma sessão em background. `/install-github-app`, a lista de configurações `/mcp`, e as ações de autenticação no menu do servidor MCP respondem com uma mensagem, e a sessão aparece sob **Needs input** na [agent view](/docs/pt/agent-view) para que você possa encontrá-la, conectar e executar o comando novamente. Enquanto um terminal está conectado, esses comandos funcionam normalmente.4311Comandos que abrem um diálogo interativo não podem fazer isso enquanto nenhum terminal está conectado a uma sessão em background. `/install-github-app`, a lista de configurações `/mcp`, e as ações de autenticação no menu do servidor MCP respondem com uma mensagem. Para `/install-github-app` e a lista de configurações `/mcp`, a sessão também aparece sob **Needs input** na [agent view](/docs/pt/agent-view) para que você possa encontrá-la, conectar e executar o comando novamente. Enquanto um terminal está conectado, esses comandos funcionam normalmente.
3997 4312
3998Antes da v2.1.216, a sessão não aparecia sob **Needs input** após uma dessas recusas. Na v2.1.213 até v2.1.215, os comandos ainda funcionavam enquanto um terminal estava conectado, e a mensagem de recusa dizia para você conectar e executar o comando novamente. De v2.1.208 até v2.1.212, Claude Code recusava-os mesmo enquanto um terminal estava conectado, com uma mensagem como `Can't open MCP settings in a background session`; nessas versões, execute o comando de uma sessão `claude` regular, ou atualize. Antes da v2.1.208, eles abriam seu diálogo dentro da sessão em background. Na v2.1.208 apenas, Claude Code também recusava o seletor `/model` em uma sessão em background, e `/upgrade` imprimia a URL de atualização em vez de abrir um navegador.4313Antes da v2.1.216, a sessão não aparecia sob **Needs input** após `/install-github-app` ou a lista de configurações `/mcp` ser recusada. Na v2.1.213 até v2.1.215, os comandos ainda funcionavam enquanto um terminal estava conectado, e a mensagem de recusa dizia para você conectar e executar o comando novamente. De v2.1.208 até v2.1.212, Claude Code recusava-os mesmo enquanto um terminal estava conectado, com uma mensagem como `Can't open MCP settings in a background session`; nessas versões, execute o comando de uma sessão `claude` regular, ou atualize. Antes da v2.1.208, eles abriam seu diálogo dentro da sessão em background. Na v2.1.208 apenas, Claude Code também recusava o seletor `/model` em uma sessão em background, e `/upgrade` imprimia a URL de atualização em vez de abrir um navegador.
3999 4314
4000A redação nomeia o comando. A lista de configurações `/mcp` relata:4315A redação nomeia o comando. A lista de configurações `/mcp` relata:
4001 4316
4005 4320
4006**O que fazer:**4321**O que fazer:**
4007 4322
4008* Conecte à sessão a partir da agent view, onde ela está listada sob **Needs input**, e execute o comando novamente4323* Conecte à sessão a partir da agent view e execute o comando novamente
4009* Ou use o formulário que a mensagem nomeia, como `/mcp reconnect <server>`, `/mcp enable`, ou `/mcp disable`, que funcionam sem conectar4324* Ou use o formulário que a mensagem nomeia, como `/mcp reconnect <server>`, `/mcp enable`, ou `/mcp disable`, que funcionam sem conectar
4010 4325
4011<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">4326<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">
4040**O que fazer:**4355**O que fazer:**
4041 4356
4042* Geralmente nada: Claude tenta novamente com a grafia local que a mensagem pede4357* Geralmente nada: Claude tenta novamente com a grafia local que a mensagem pede
4043* Se o arquivo está em um compartilhamento de rede em vez de um arquivo local escrito com um caminho de rede, está fora do workspace local da sessão; edite-o de uma sessão interativa regular em vez disso
4044 4358
4045<h3 id="command-blocked-by-the-worktree-isolation-checks">4359<h3 id="command-blocked-by-the-worktree-isolation-checks">
4046 Comando bloqueado pelas verificações de isolamento de worktree4360 Comando bloqueado pelas verificações de isolamento de worktree
4277 4591
4278Em uma instalação npm, um `EUNKNOWN` que aparece enquanto `npm install -g @anthropic-ai/claude-code` está substituindo o binário tem a mesma causa que [`EACCES` durante uma reinstalação](#eacces-when-starting-a-background-session) e limpa quando você tenta novamente após a instalação terminar.4592Em uma instalação npm, um `EUNKNOWN` que aparece enquanto `npm install -g @anthropic-ai/claude-code` está substituindo o binário tem a mesma causa que [`EACCES` durante uma reinstalação](#eacces-when-starting-a-background-session) e limpa quando você tenta novamente após a instalação terminar.
4279 4593
4280Claude Code inicia o serviço em background através do PowerShell para que o serviço sobreviva ao fechamento do terminal, usando PowerShell 7 quando está instalado e Windows PowerShell 5.1 caso contrário. Quando nenhum PowerShell consegue executar, Claude Code inicia o serviço diretamente em vez disso, portanto uma política que bloqueia apenas PowerShell não causa esse erro. Se você o vê enquanto nenhuma instalação npm está em execução, a política está bloqueando o executável Claude Code em si.4594Claude Code inicia o serviço em background através do PowerShell para que o serviço sobreviva ao fechamento do terminal, usando PowerShell 7 quando está instalado e Windows PowerShell 5.1 caso contrário. Quando nenhum PowerShell consegue executar, Claude Code inicia o serviço diretamente em vez disso, portanto uma política que bloqueia apenas PowerShell não causa esse erro.
4281 4595
4282Antes da v2.1.212, Claude Code usava apenas Windows PowerShell 5.1 para iniciar o serviço, portanto qualquer máquina onde Group Policy bloqueava PowerShell 5.1 falhava com `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, mesmo com PowerShell 7 instalado.4596Antes da v2.1.212, Claude Code usava apenas Windows PowerShell 5.1 para iniciar o serviço, portanto qualquer máquina onde Group Policy bloqueava PowerShell 5.1 falhava com `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, mesmo com PowerShell 7 instalado.
4283 4597
4341 Diretório de trabalho não existe mais ao iniciar uma sessão em background4655 Diretório de trabalho não existe mais ao iniciar uma sessão em background
4342</h3>4656</h3>
4343 4657
4344Você tentou iniciar uma [sessão em background](/docs/pt/agent-view) em um diretório que não existe mais. Isso acontece quando você despacha da agent view ou executa `/background` após o diretório em que você estava trabalhando ser deletado ou movido. Também acontece quando você conecta a ou reinicia uma sessão cujo processo saiu e cujo diretório se foi, porque o novo processo iniciaria naquele mesmo diretório. Claude Code não inicia a sessão, e a mensagem nomeia o diretório faltante:4658Você tentou iniciar uma [sessão em background](/docs/pt/agent-view) em um diretório que não existe mais. Claude Code não inicia a sessão, e a mensagem nomeia o diretório faltante:
4345 4659
4346```text theme={null}4660```text theme={null}
4347Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4661Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)
4349 4663
4350Antes da v2.1.257, a sessão parecia iniciar e depois mostrava na agent view como uma linha falha com a mesma razão.4664Antes da v2.1.257, a sessão parecia iniciar e depois mostrava na agent view como uma linha falha com a mesma razão.
4351 4665
4666Antes da v2.1.281, essa mensagem também aparecia quando o diretório já estava desaparecido antes de você iniciar a sessão. Esse caso relata [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).
4667
4352**O que fazer:**4668**O que fazer:**
4353 4669
4354* Recrie o diretório que a mensagem nomeia, ou despache de um diretório que existe, depois tente novamente4670* Recrie o diretório que a mensagem nomeia, ou despache de um diretório que existe, depois tente novamente
4355 4671
4672<h3 id="workspace-not-trusted-when-dispatching-a-background-session">
4673 Workspace não confiável ao despachar uma sessão em background
4674</h3>
4675
4676Você iniciou ou reiniciou uma [sessão em background](/docs/pt/agent-view) em um diretório que você não [confiou](/docs/pt/permissions#project-allow-rules-and-workspace-trust), e o diálogo de confiança de workspace não conseguiu aparecer para perguntar. Claude Code não inicia a sessão:
4677
4678```text theme={null}
4679Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.
4680```
4681
4682De um terminal no diretório da sessão própria, o mesmo comando mostra o diálogo de confiança em vez disso e inicia a sessão uma vez que você aceita. Esta mensagem aparece onde nenhum diálogo pode, como em um script, ou quando você reinicia uma sessão de um diretório diferente do seu próprio.
4683
4684Duas variantes nomeiam uma causa diferente:
4685
4686* **`The home directory is trusted one session at a time`**: o diretório da sessão é seu diretório home. Claude Code nunca salva confiança para o diretório home, portanto aceitar o diálogo lá em uma sessão anterior não conta.
4687* **`<path> could not be resolved on disk`**: Claude Code não conseguiu encontrar o diretório da sessão no disco.
4688
4689**O que fazer:**
4690
4691* Execute `claude` no diretório que a mensagem nomeia e aceite o diálogo de confiança, depois execute o comando novamente
4692* Para a mensagem de diretório home, execute o comando de um terminal no seu diretório home para que o diálogo possa aparecer, ou inicie a sessão de um diretório de projeto em vez disso
4693* Para a mensagem `could not be resolved on disk`, recrie o diretório, ou inicie uma nova sessão de um diretório que existe
4694
4356<h2 id="wrapper-and-ide-errors">4695<h2 id="wrapper-and-ide-errors">
4357 Erros de wrapper e IDE4696 Erros de wrapper e IDE
4358</h2>4697</h2>
4437 4776
4438* Identifique quais arquivos foram pulados para que você possa lidar com cada um com as etapas abaixo. A mensagem fornece apenas uma contagem; o log de debug em `~/.claude/debug/<session-id>.txt` nomeia cada caminho pulado conforme a restauração é executada, então ative o log de debug com `/debug` antes de sua próxima restauração. No macOS ou Linux, você pode encontrar os links diretamente: `find . -type l` para symlinks e `find . -type f -links +1` para arquivos hard-linked.4777* Identifique quais arquivos foram pulados para que você possa lidar com cada um com as etapas abaixo. A mensagem fornece apenas uma contagem; o log de debug em `~/.claude/debug/<session-id>.txt` nomeia cada caminho pulado conforme a restauração é executada, então ative o log de debug com `/debug` antes de sua próxima restauração. No macOS ou Linux, você pode encontrar os links diretamente: `find . -type l` para symlinks e `find . -type f -links +1` para arquivos hard-linked.
4439* Se um arquivo pulado é um link que você criou propositalmente, como um arquivo de configuração gerenciado por um gerenciador de dotfiles ou um arquivo hard-linked por ferramentas como pnpm, o rewind deixou seu conteúdo intacto. Para desfazer as alterações da sessão nele, peça a Claude para reverter a edição ou edite o arquivo você mesmo4778* Se um arquivo pulado é um link que você criou propositalmente, como um arquivo de configuração gerenciado por um gerenciador de dotfiles ou um arquivo hard-linked por ferramentas como pnpm, o rewind deixou seu conteúdo intacto. Para desfazer as alterações da sessão nele, peça a Claude para reverter a edição ou edite o arquivo você mesmo
4440* Se você não criou o link, inspecione o caminho antes de confiar em seu conteúdo: algo substituiu o arquivo após o checkpoint4779* Se você não criou o link, inspecione o caminho antes de confiar em seu conteúdo
4441 4780
4442<h3 id="no-files-were-restored">4781<h3 id="no-files-were-restored">
4443 No files were restored4782 No files were restored
4585* Encurte o frontmatter `description` de seus arquivos de agente, ou peça a Claude para aparar para você.4924* Encurte o frontmatter `description` de seus arquivos de agente, ou peça a Claude para aparar para você.
4586* Remova arquivos de agente que você não usa mais.4925* Remova arquivos de agente que você não usa mais.
4587 4926
4927<h3 id="a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved">
4928 Uma skill, comando ou workflow não foi carregado porque seu nome é reservado
4929</h3>
4930
4931Uma pasta de skill, um frontmatter `name`, um arquivo ou subpasta em `.claude/commands/`, ou um [workflow salvo](/docs/pt/workflows#save-the-workflow-for-reuse) usa o nome `anthropic-skills` ou um nome que começa com `anthropic-skills:`. Claude Code [reserva esse nome para skills sincronizadas de claude.ai](/docs/pt/skills#names-reserved-for-synced-skills) e não carrega esse item.
4932
4933Claude Code mostra este aviso como um aviso de inicialização na visualização de conversa em vez de em stderr:
4934
4935```text theme={null}
4936Not loaded: rename .claude/skills/anthropic-skills, then restart — its name uses "anthropic-skills", a name reserved for the skills synced from your claude.ai account
4937```
4938
4939O aviso nomeia o que mudar para o primeiro item que recusou: uma pasta ou arquivo para renomear, uma linha `name:` para editar, ou um workflow para renomear. Quando mais de um item foi recusado, o aviso termina com uma contagem como `· 2 more`, e o [log de depuração](/docs/pt/debug-your-config) nomeia cada um.
4940
4941**O que fazer:**
4942
4943* Renomeie o item que o aviso nomeia, ou edite a linha `name:` para a qual aponta, depois reinicie a sessão.
4944
4945Antes da v2.1.282, Claude Code carregava skills e comandos com esses nomes.
4946
4588<h3 id="workspace-has-not-been-trusted">4947<h3 id="workspace-has-not-been-trusted">
4589 O espaço de trabalho não foi confiável4948 O espaço de trabalho não foi confiável
4590</h3>4949</h3>
4631 Falha ao carregar configurações gerenciadas remotamente4990 Falha ao carregar configurações gerenciadas remotamente
4632</h3>4991</h3>
4633 4992
4634Sua sessão é elegível para [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings), mas Claude Code não conseguiu buscá-las, então mostra este aviso em sessões interativas. A causa entre parênteses nomeia o que falhou, como `network error`, `request timed out` ou `authentication rejected (401)`, e o resto da linha diz qual política a sessão executa:4993Sua sessão é elegível para [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings), mas Claude Code não conseguiu buscá-las ou não conseguiu aplicar o que o servidor retornou, então mostra este aviso em sessões interativas.
4994
4995A causa entre parênteses nomeia o que falhou, como `network error`, `request timed out` ou `authentication rejected (401)`. A causa `no setting in the server response could be applied as written` significa que o servidor respondeu mas nenhuma das configurações que retornou passou na [validação](/docs/pt/server-managed-settings#invalid-entries-in-delivered-settings). Antes da v2.1.282, esta causa lia `server returned invalid settings`.
4996
4997O resto da linha diz qual política a sessão executa:
4635 4998
4636* **Configurações em cache de uma busca anterior bem-sucedida**: Claude Code executa a sessão nessa política em cache, exceto as [variáveis de ambiente retidas](/docs/pt/server-managed-settings#fetch-and-caching-behavior), e a linha lê `using cached policy`.4999* **Configurações em cache de uma busca anterior bem-sucedida**: Claude Code executa a sessão nessa política em cache, exceto as [variáveis de ambiente retidas](/docs/pt/server-managed-settings#fetch-and-caching-behavior), e a linha lê `using cached policy`.
4637* **Sem cache**: Claude Code executa a sessão sem configurações gerenciadas pelo servidor, e a linha lê `no remote policy applied`.5000* **Sem cache**: Claude Code executa a sessão sem configurações gerenciadas pelo servidor, e a linha lê `no remote policy applied`.
4639**O que fazer:**5002**O que fazer:**
4640 5003
4641* Aja sobre a causa que a mensagem nomeia: para uma causa de rede, verifique se esta máquina pode alcançar `api.anthropic.com`; para uma causa de autenticação, verifique seu login com `/status`5004* Aja sobre a causa que a mensagem nomeia: para uma causa de rede, verifique se esta máquina pode alcançar `api.anthropic.com`; para uma causa de autenticação, verifique seu login com `/status`
5005* Para `no setting in the server response could be applied as written`, peça ao seu administrador para corrigir as configurações no servidor
4642* Execute `/status` ou `claude doctor` para o diagnóstico completo5006* Execute `/status` ou `claude doctor` para o diagnóstico completo
4643 5007
4644Antes da v2.1.248, Claude Code relatava uma busca de configurações falhada apenas no log de depuração.5008Antes da v2.1.248, Claude Code relatava uma busca de configurações falhada apenas no log de depuração.
4658* Inicie Claude Code novamente e aprove a caixa de diálogo para continuar sob as configurações de sua organização. Uma caixa de diálogo recusada não é lembrada, então aparece novamente na próxima inicialização.5022* Inicie Claude Code novamente e aprove a caixa de diálogo para continuar sob as configurações de sua organização. Uma caixa de diálogo recusada não é lembrada, então aparece novamente na próxima inicialização.
4659* Se você não tiver certeza sobre uma configuração que a caixa de diálogo lista, pergunte a quem mantém as configurações gerenciadas de sua organização antes de aprovar5023* Se você não tiver certeza sobre uma configuração que a caixa de diálogo lista, pergunte a quem mantém as configurações gerenciadas de sua organização antes de aprovar
4660 5024
5025<h3 id="managed-settings-block-the-default-model">
5026 As configurações gerenciadas bloqueiam o modelo padrão
5027</h3>
5028
5029As [configurações gerenciadas](/docs/pt/managed-settings) de sua organização bloqueiam o modelo para o qual a opção Padrão se resolve e cada modelo para o qual poderia fazer downgrade. Uma sessão que começaria na opção Padrão sai na inicialização em vez de executar um modelo bloqueado. Qual mensagem você vê depende da configuração que o bloqueia. Quando uma lista [`deniedModels`](/docs/pt/model-config#block-specific-models-or-versions) o bloqueia, a mensagem lê:
5030
5031```text theme={null}
5032Claude Code can't start: your organization's managed settings block the default model (claude-opus-5-5) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".
5033```
5034
5035Quando uma lista `availableModels` com [`availableModelsMatch`](/docs/pt/settings-reference#availablemodelsmatch) definido como `"exact"` a omite, a mensagem lê:
5036
5037```text theme={null}
5038Claude Code can't start: your organization allows only the models listed in "availableModels", and none of them can be used as the default model (claude-opus-5-5 isn't listed). Ask your administrator to update "availableModels".
5039```
5040
5041**O que fazer:**
5042
5043* Se você administra as configurações, adicione um modelo que seus usuários possam executar a `availableModels`, ou estreite as entradas `deniedModels` que bloqueiam cada fallback. [Bloquear modelos ou versões específicas](/docs/pt/model-config#block-specific-models-or-versions) descreve como a opção Padrão faz downgrade
5044* Se você não as administra, envie a mensagem ao seu administrador. Seus próprios arquivos de configurações não podem ampliar uma lista `availableModels` ou `deniedModels` gerenciada
5045
4661<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5046<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">
4662 O servidor MCP é bloqueado pela política gerenciada da empresa5047 O servidor MCP é bloqueado pela política gerenciada da empresa
4663</h3>5048</h3>
4927 5312
4928* Um [`--fallback-model`](/docs/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição5313* Um [`--fallback-model`](/docs/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição
4929* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível5314* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível
4930* [Fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) no Fable 5.1, Fable 5, Opus 5.5 e Opus 5 move a sessão para o modelo de fallback da categoria sinalizada, quando essa categoria tem um, e mostra um aviso na transcrição5315* [Fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) no Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 e Opus 5 move a sessão para o modelo de fallback da categoria sinalizada, quando essa categoria tem um, e mostra um aviso na transcrição
4931 5316
4932A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](/docs/pt/model-config) explica quando cada fallback se aplica.5317A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](/docs/pt/model-config) explica quando cada fallback se aplica.
4933 5318
