83| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentication](#oauth-token-revoked-or-expired) |83| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentication](#oauth-token-revoked-or-expired) |
84| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |84| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |
85| `Login expired · Please run /login` | [Authentication](#login-expired) |85| `Login expired · Please run /login` | [Authentication](#login-expired) |
86| `The browser can't return the sign-in to Claude Code automatically` | [Authentication](#couldnt-start-the-local-sign-in-listener) |
87| `Couldn't start the local listener that receives the browser sign-in. Try again.` | [Authentication](#couldnt-start-the-local-sign-in-listener) |
86| `Failed to start OAuth callback server` | [Authentication](#failed-to-start-oauth-callback-server) |88| `Failed to start OAuth callback server` | [Authentication](#failed-to-start-oauth-callback-server) |
87| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |89| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |
88| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |90| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |
100| `claude.ai rejected the session token` / `session token rejected` | [Authentication](#claude-ai-rejected-the-session-token) |102| `claude.ai rejected the session token` / `session token rejected` | [Authentication](#claude-ai-rejected-the-session-token) |
101| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |103| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
102| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |104| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
105| `(check the helper, then start a new task or chat)` / `(update it, then start a new task or chat)` | [Authentication](#mcp-credential-rejected-in-cowork) |
103| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |106| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
104| `MCP server "<name>" requires re-authorization (token expired)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |107| `MCP server "<name>" requires re-authorization (token expired)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
105| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentication](#mcp-server-url-is-missing-or-not-a-valid-url) |108| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentication](#mcp-server-url-is-missing-or-not-a-valid-url) |
200| `Installation was killed before it could finish (exit code 137)` | [Troubleshoot installation and login](/docs/pt/troubleshoot-install#installation-was-killed-before-it-could-finish) |203| `Installation was killed before it could finish (exit code 137)` | [Troubleshoot installation and login](/docs/pt/troubleshoot-install#installation-was-killed-before-it-could-finish) |
201| `The connection dropped while downloading the update` | [Troubleshoot installation and login](/docs/pt/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |204| `The connection dropped while downloading the update` | [Troubleshoot installation and login](/docs/pt/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |
202| `Download timed out: exceeded the total deadline` | [Troubleshoot installation and login](/docs/pt/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |205| `Download timed out: exceeded the total deadline` | [Troubleshoot installation and login](/docs/pt/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |
206| `Release verification failed for Claude Code <version> (<reason>). The update was not installed.` | [Troubleshoot installation and login](/docs/pt/troubleshoot-install#release-verification-failed) |
207| `Auto-update failed · Run claude doctor` | [Troubleshoot installation and login](/docs/pt/troubleshoot-install#auto-update-failed) |
203| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |208| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |
204| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [Command-line errors](#couldnt-tell-whether-bg-is-a-flag-or-text) |209| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [Command-line errors](#couldnt-tell-whether-bg-is-a-flag-or-text) |
205| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Command-line errors](#conflict-between-a-system-prompt-flag-and-its-file-form) |210| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Command-line errors](#conflict-between-a-system-prompt-flag-and-its-file-form) |
270| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Command-line errors](#custom-output-styles-cant-be-selected-over-remote-control) |275| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Command-line errors](#custom-output-styles-cant-be-selected-over-remote-control) |
271| `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) |276| `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) |
272| `/recap only runs when you ask for it yourself in this session` | [Command-line errors](#recap-only-runs-when-you-ask-for-it-yourself) |277| `/recap only runs when you ask for it yourself in this session` | [Command-line errors](#recap-only-runs-when-you-ask-for-it-yourself) |
278| `/feedback is disabled by your organization's policy`, ou o mesmo para `/bug` ou `/share` | [Command-line errors](#feedback-is-disabled-by-your-organizations-policy) |
273| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |279| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |
274| `cannot be evaluated where sessions load it` | [Test plugins with evals](/docs/pt/plugin-evals#cannot-be-evaluated-where-sessions-load-it) |280| `cannot be evaluated where sessions load it` | [Test plugins with evals](/docs/pt/plugin-evals#cannot-be-evaluated-where-sessions-load-it) |
275| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |281| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |
289| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Plugin troubleshooting](/docs/pt/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |295| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Plugin troubleshooting](/docs/pt/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |
290| `does not load (...), so Claude Code ignores the whole file` | [Plugin troubleshooting](/docs/pt/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |296| `does not load (...), so Claude Code ignores the whole file` | [Plugin troubleshooting](/docs/pt/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |
291| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |297| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |
298| `Plugin not loaded: its manifest <path> was not read` | [Plugin errors](#plugin-not-loaded-its-manifest-was-not-read) |
292| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |299| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |
293| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |300| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
294| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |301| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
304| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |311| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |
305| `cannot contain null bytes (\0)` | [Tool errors](#path-cannot-contain-null-bytes) |312| `cannot contain null bytes (\0)` | [Tool errors](#path-cannot-contain-null-bytes) |
306| `Path contains null bytes` | [Tool errors](#path-cannot-contain-null-bytes) |313| `Path contains null bytes` | [Tool errors](#path-cannot-contain-null-bytes) |
314| `File is too large to read as an image (the limit is 128MB)` | [Tool errors](#file-is-too-large-to-read-as-an-image) |
315| `Cannot read this as an image: <path> is a pipe or a device` | [Tool errors](#file-is-too-large-to-read-as-an-image) |
307| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |316| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |
308| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |317| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |
309| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |318| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |
310| `Failed to write to <name>'s inbox — nothing was sent` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |319| `Failed to write to <name>'s inbox — nothing was sent` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
311| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |320| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
312| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |321| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |
322| `Only a teammate can approve a shutdown request` | [Tool errors](#only-a-teammate-can-approve-a-shutdown-request) |
313| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |323| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |
314| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |324| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |
315| `Cross-session message was dropped at the recipient session's inbox` | [Tool errors](#cross-session-message-dropped-at-the-inbox) |325| `Cross-session message was dropped at the recipient session's inbox` | [Tool errors](#cross-session-message-dropped-at-the-inbox) |
325| `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) |335| `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) |
326| `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) |336| `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) |
327| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |337| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
338| `The command was not started: this computer's disk is full (ENOSPC)` / `(EDQUOT)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
328| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Tool errors](#file-is-not-valid-utf-8) |339| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Tool errors](#file-is-not-valid-utf-8) |
329| `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) |340| `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) |
330| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |341| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
331| `Not published: that file is on a network share` | [Tool errors](#not-published-that-file-is-on-a-network-share) |342| `Not published: that file is on a network share` | [Tool errors](#not-published-that-file-is-on-a-network-share) |
343| `Not published: Claude sent the same content again after a newer version of the artifact turned it away` / `Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away` | [Tool errors](#not-published-a-newer-version-of-the-artifact-turned-it-away) |
332| `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) |344| `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) |
333| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |345| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |
334| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Tool errors](#webfetch-cannot-fetch-localhost) |346| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Tool errors](#webfetch-cannot-fetch-localhost) |
345| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |357| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |
346| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |358| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |
347| `This session's saved conversation is no longer on disk` | [Background session errors](#this-sessions-saved-conversation-is-no-longer-on-disk) |359| `This session's saved conversation is no longer on disk` | [Background session errors](#this-sessions-saved-conversation-is-no-longer-on-disk) |
348| `Bypass permissions was requested at launch and ignored` | [Ignorar todas as verificações com o modo bypassPermissions](/docs/pt/permission-modes#bypass-permissions-acceptance) |360| `Bypass permissions was requested at launch and ignored` | [Bypass permissions ignorado em uma sessão em background](/docs/pt/permission-modes#bypass-permissions-ignored-in-a-background-session) |
349| `kept <id> — its worktree is still at <path>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |361| `kept <id> — its worktree is still at <path>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
350| `kept <id> — <n> unpushed commits on <branch>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |362| `kept <id> — <n> unpushed commits on <branch>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
351| `kept <id> — worktree has commits that are not pushed anywhere` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |363| `kept <id> — worktree has commits that are not pushed anywhere` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
354| `Session <id> was stopped while the respawn was in flight` | [Background session errors](#session-was-stopped-while-the-respawn-was-in-flight) |366| `Session <id> was stopped while the respawn was in flight` | [Background session errors](#session-was-stopped-while-the-respawn-was-in-flight) |
355| `This session was running agent '<name>', which is no longer available` | [Background session errors](#session-agent-no-longer-available) |367| `This session was running agent '<name>', which is no longer available` | [Background session errors](#session-agent-no-longer-available) |
356| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [Background session errors](#restarted-after-its-next-loop-wakeup-was-due) |368| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [Background session errors](#restarted-after-its-next-loop-wakeup-was-due) |
369| `No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder` | [Background session errors](#no-llm-gateway-opened-from-another-folder) |
370| `No LLM gateway: opened from another folder · respawn from <folder>` | [Background session errors](#no-llm-gateway-opened-from-another-folder) |
357| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |371| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |
358| `EUNKNOWN: unknown error, uv_spawn` | [Background session errors](#eunknown-when-starting-a-background-session) |372| `EUNKNOWN: unknown error, uv_spawn` | [Background session errors](#eunknown-when-starting-a-background-session) |
359| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |373| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |
394| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [Configuration warnings](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |408| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [Configuration warnings](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |
395| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |409| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |
396| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |410| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |
411| `matches no tool · check for typos` / `matches no known tool — check for typos` | [Configuration warnings](#matches-no-tool) |
397| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |412| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |
413| `Write(<path>) never matches · use Edit(<path>)` / `Glob(<path>) never matches · use Read(<path>)` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |
398| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |414| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |
415| `allows any option at its * · use an exact value` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |
399| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Configuration warnings](#denying-bash-also-turns-off-the-powershell-tool) |416| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Configuration warnings](#denying-bash-also-turns-off-the-powershell-tool) |
400| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |417| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |
418| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" reads as <N> tokens, so Claude Code treats it as the 100k minimum` | [Valores e avisos para `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/pt/model-config#claude_code_auto_compact_window-values) |
419| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" is too large, so Claude Code treats it as the 1M maximum` | [Valores e avisos para `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/pt/model-config#claude_code_auto_compact_window-values) |
420| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Valores e avisos para `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/pt/model-config#claude_code_auto_compact_window-values) |
401| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Correct the window for a gateway or custom model ID](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |421| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Correct the window for a gateway or custom model ID](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |
402| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Correct the window for a gateway or custom model ID](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |422| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Correct the window for a gateway or custom model ID](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |
403| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |423| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |
462| [`CLAUDE_CODE_MAX_RETRIES`](/docs/pt/env-vars) | 10 | Número de novas tentativas. Limitado a 15 a partir da v2.1.186; a partir da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Reduza-o para expor falhas mais rapidamente em scripts. |482| [`CLAUDE_CODE_MAX_RETRIES`](/docs/pt/env-vars) | 10 | Número de novas tentativas. Limitado a 15 a partir da v2.1.186; a partir da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Reduza-o para expor falhas mais rapidamente em scripts. |
463| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/pt/env-vars) | não definido | Defina como `1` em sessões não supervisionadas, como jobs de CI, para tentar novamente erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. Claude Code falha imediatamente quando uma requisição de velocidade padrão recebe um `429` que relata um limite de gastos ou créditos de uso esgotados, mesmo um de um [limite de gastos de gateway](#spend-limit-reached) que é redefinido em um cronograma. Antes da v2.1.239, o watchdog tentava novamente esses erros indefinidamente. Para requisições no modo rápido, veja [Handle rate limits](/docs/pt/fast-mode#handle-rate-limits). Na v2.1.199 ou posterior, também aumenta a contagem padrão de novas tentativas para outros erros transitórios, como erros de servidor, timeouts e conexões perdidas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. |483| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/pt/env-vars) | não definido | Defina como `1` em sessões não supervisionadas, como jobs de CI, para tentar novamente erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. Claude Code falha imediatamente quando uma requisição de velocidade padrão recebe um `429` que relata um limite de gastos ou créditos de uso esgotados, mesmo um de um [limite de gastos de gateway](#spend-limit-reached) que é redefinido em um cronograma. Antes da v2.1.239, o watchdog tentava novamente esses erros indefinidamente. Para requisições no modo rápido, veja [Handle rate limits](/docs/pt/fast-mode#handle-rate-limits). Na v2.1.199 ou posterior, também aumenta a contagem padrão de novas tentativas para outros erros transitórios, como erros de servidor, timeouts e conexões perdidas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. |
464| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/pt/env-vars) | não definido | Tempo máximo em milissegundos que cada requisição de API passa aguardando erros `429` e `529` quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido. Quando não definido, a espera não tem limite. Requer Claude Code v2.1.295 ou posterior. |484| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/pt/env-vars) | não definido | Tempo máximo em milissegundos que cada requisição de API passa aguardando erros `429` e `529` quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido. Quando não definido, a espera não tem limite. Requer Claude Code v2.1.295 ou posterior. |
485| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](/docs/pt/env-vars) | não definido | Intervalo mínimo em milissegundos entre verificações de se um [limite de uso](#youve-hit-your-session-limit) já foi liberado, enquanto uma requisição aguarda a redefinição desse limite com `CLAUDE_CODE_RETRY_WATCHDOG` definido. Quando uma verificação constata que o limite foi liberado, a requisição é enviada imediatamente. Informe apenas dígitos de `60000` a `10800000`. Quando não definido ou fora desse intervalo, nenhuma verificação é feita. Para saber quando Claude Code ignora essas verificações, veja a [referência de variáveis de ambiente](/docs/pt/env-vars). Requer Claude Code v2.1.305 ou posterior. |
465| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/pt/env-vars) | 500 | Atraso inicial em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 32000, para distribuir as novas tentativas por uma janela mais longa quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](/docs/pt/fast-mode#handle-rate-limits). Requer Claude Code v2.1.292 ou posterior. |486| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/pt/env-vars) | 500 | Atraso inicial em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 32000, para distribuir as novas tentativas por uma janela mais longa quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](/docs/pt/fast-mode#handle-rate-limits). Requer Claude Code v2.1.292 ou posterior. |
466| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/pt/env-vars) | 32000 | Teto em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 64000, para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](/docs/pt/fast-mode#handle-rate-limits). Requer Claude Code v2.1.296 ou posterior. |487| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/pt/env-vars) | 32000 | Teto em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 64000, para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](/docs/pt/fast-mode#handle-rate-limits). Requer Claude Code v2.1.296 ou posterior. |
467| [`API_TIMEOUT_MS`](/docs/pt/env-vars) | 600000 | Tempo em milissegundos que cada tentativa de requisição tem para receber seus cabeçalhos de resposta. Não limita quanto tempo uma resposta de streaming dura depois disso. Aumente-o para redes lentas ou proxies. Para saber como ele limita o prazo de primeiro byte, veja [No response from API](#no-response-from-api). |488| [`API_TIMEOUT_MS`](/docs/pt/env-vars) | 600000 | Tempo em milissegundos que cada tentativa de requisição tem para receber seus cabeçalhos de resposta. Não limita quanto tempo uma resposta de streaming dura depois disso. Aumente-o para redes lentas ou proxies. Para saber como ele limita o prazo de primeiro byte, veja [No response from API](#no-response-from-api). |
490 511
491* Verifique [status.claude.com](https://status.claude.com) ou a página de status do provedor nomeada na mensagem para incidentes ativos512* Verifique [status.claude.com](https://status.claude.com) ou a página de status do provedor nomeada na mensagem para incidentes ativos
492* Aguarde um minuto e envie sua mensagem novamente. Sua mensagem original ainda está na conversa, então para um prompt longo você pode digitar `try again` em vez de colar tudo novamente.513* Aguarde um minuto e envie sua mensagem novamente. Sua mensagem original ainda está na conversa, então para um prompt longo você pode digitar `try again` em vez de colar tudo novamente.
514* Se [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) apontar para um [gateway de LLM](/docs/pt/llm-gateway) e todas as requisições falharem dessa forma, verifique se o seu gateway está rejeitando os campos de busca de ferramentas que o Claude Code envia por padrão. Para verificar, defina `ENABLE_TOOL_SEARCH=false` conforme descrito em [Busca de ferramentas por meio de um gateway de LLM](/docs/pt/mcp#tool-search-through-a-gateway) e tente novamente. Antes da v2.1.304, a busca de ferramentas ficava desativada por trás de um gateway, a menos que você a ativasse com `ENABLE_TOOL_SEARCH`.
493* Se o erro persistir sem nenhum incidente postado, execute `/feedback` para que a Anthropic possa investigar com os detalhes da sua solicitação. Veja [Report an error](#report-an-error) se `/feedback` não estiver disponível no seu ambiente.515* Se o erro persistir sem nenhum incidente postado, execute `/feedback` para que a Anthropic possa investigar com os detalhes da sua solicitação. Veja [Report an error](#report-an-error) se `/feedback` não estiver disponível no seu ambiente.
494 516
495### API Error: Repeated 529 Overloaded errors517### API Error: Repeated 529 Overloaded errors
520Request timed out542Request timed out
521```543```
522 544
523O tempo limite de solicitação padrão é de 10 minutos.545O tempo limite de solicitação padrão é de 10 minutos. Se você definir [`API_TIMEOUT_MS`](/docs/pt/env-vars) como `0`, esse timeout de requisição fica desativado. O [prazo do primeiro byte](#no-response-from-api) e o timeout de inatividade do corpo não são desativados quando você define `0`, então uma requisição de streaming ainda é executada sob [aqueles que se aplicam à sua conexão](/docs/pt/network-config#streaming-idle-watchdogs). Uma tentativa sem streaming mantém seu limite de 300 segundos em uma sessão local e ainda pode terminar com esta mensagem.
524 546
525**O que fazer:**547**O que fazer:**
526 548
549* Se todas as requisições falharem com esta mensagem e você tiver definido `API_TIMEOUT_MS` como `0`, verifique `claude --version`. Em uma versão anterior à v2.1.305, atualize o Claude Code ou defina um valor positivo.
527* Tente novamente a solicitação550* Tente novamente a solicitação
528* Se uma rede lenta ou proxy for a causa, aumente `API_TIMEOUT_MS` conforme descrito em [Automatic retries](#automatic-retries)551* Se uma rede lenta ou proxy for a causa, aumente `API_TIMEOUT_MS` conforme descrito em [Automatic retries](#automatic-retries)
529* Se os tempos limite forem frequentes e sua rede estiver saudável, veja [Network and connection errors](#network-and-connection-errors) abaixo552* Se os tempos limite forem frequentes e sua rede estiver saudável, veja [Network and connection errors](#network-and-connection-errors) abaixo
541* **Primeira tentativa**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/pt/env-vars) quando você o define como 1 ou mais, limitado entre 10 segundos e 30 minutos. Caso contrário, Claude Code usa o tempo limite do watchdog de nível de byte listado em [Streaming idle watchdogs](/docs/pt/network-config#streaming-idle-watchdogs), então as variáveis que alteram esse tempo limite alteram essa espera também. De qualquer forma, Claude Code adiciona um segundo para cada 32KB do corpo da solicitação.564* **Primeira tentativa**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/pt/env-vars) quando você o define como 1 ou mais, limitado entre 10 segundos e 30 minutos. Caso contrário, Claude Code usa o tempo limite do watchdog de nível de byte listado em [Streaming idle watchdogs](/docs/pt/network-config#streaming-idle-watchdogs), então as variáveis que alteram esse tempo limite alteram essa espera também. De qualquer forma, Claude Code adiciona um segundo para cada 32KB do corpo da solicitação.
542* **Nova tentativa**: um segundo a menos que `API_TIMEOUT_MS`, pouco menos de 10 minutos por padrão, para que a nova tentativa possa durar mais que um proxy ou gateway que mantém a resposta até que a geração seja concluída. No Amazon Bedrock, a nova tentativa usa o mesmo prazo que a primeira tentativa, e a mensagem mostra uma duração em vez de duas.565* **Nova tentativa**: um segundo a menos que `API_TIMEOUT_MS`, pouco menos de 10 minutos por padrão, para que a nova tentativa possa durar mais que um proxy ou gateway que mantém a resposta até que a geração seja concluída. No Amazon Bedrock, a nova tentativa usa o mesmo prazo que a primeira tentativa, e a mensagem mostra uma duração em vez de duas.
543 566
567 Exceto no Amazon Bedrock, se você definir `API_TIMEOUT_MS` como `0`, a nova tentativa aguarda 10 minutos mais um segundo por 32KB, ou tanto quanto a primeira tentativa, se isso for mais longo.
568
544Nenhuma espera excede um segundo a menos que um `API_TIMEOUT_MS` positivo, e um `API_TIMEOUT_MS` positivo inferior a 11 segundos desativa o prazo. O watchdog de nível de byte começa apenas depois que os cabeçalhos de resposta chegam, então uma resposta que para de enviar bytes depois disso segue as [regras de fluxo interrompido](#automatic-retries) em vez deste prazo.569Nenhuma espera excede um segundo a menos que um `API_TIMEOUT_MS` positivo, e um `API_TIMEOUT_MS` positivo inferior a 11 segundos desativa o prazo. O watchdog de nível de byte começa apenas depois que os cabeçalhos de resposta chegam, então uma resposta que para de enviar bytes depois disso segue as [regras de fluxo interrompido](#automatic-retries) em vez deste prazo.
545 570
546**O que fazer:**571**O que fazer:**
845* Execute `/status` e confirme que a credencial ativa é a que você espera. Um `ANTHROPIC_API_KEY` perdido em seu ambiente pode rotear requisições através de uma chave de nível inferior em vez de sua assinatura.870* Execute `/status` e confirme que a credencial ativa é a que você espera. Um `ANTHROPIC_API_KEY` perdido em seu ambiente pode rotear requisições através de uma chave de nível inferior em vez de sua assinatura.
846* Verifique seu console de provedor para os limites ativos e solicite um nível mais alto se necessário871* Verifique seu console de provedor para os limites ativos e solicite um nível mais alto se necessário
847* Para chaves de API Anthropic, veja a [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) para saber como os níveis funcionam e como definir limites por workspace872* Para chaves de API Anthropic, veja a [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) para saber como os níveis funcionam e como definir limites por workspace
848* Reduza a concorrência: diminua [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/pt/env-vars), evite executar muitos subagentes paralelos, ou mude para um modelo menor com `/model` para execuções de script de alto volume873* Reduza a concorrência: evite executar muitos subagentes paralelos, ou mude para um modelo menor com `/model` para execuções de script de alto volume
849 874
850### You've hit your monthly spend limit875### You've hit your monthly spend limit
851 876
1267* Se `/status` mostrar apenas seu login, execute `/login` uma vez. Se a credencial foi revogada, um novo login a substitui.1292* Se `/status` mostrar apenas seu login, execute `/login` uma vez. Se a credencial foi revogada, um novo login a substitui.
1268* Se a mesma mensagem voltar para a mesma conta de login, a conta ou a organização não está mais ativa. Verifique a conta e a organização que `/status` informa e peça ao administrador da sua organização que restaure o acesso.1293* Se a mesma mensagem voltar para a mesma conta de login, a conta ou a organização não está mais ativa. Verifique a conta e a organização que `/status` informa e peça ao administrador da sua organização que restaure o acesso.
1269* Se [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) apontar para um [gateway de LLM](/docs/pt/llm-gateway), o texto após `401` é a mensagem do seu gateway e não da Anthropic, e o `/login` não a altera. Em vez disso, corrija a credencial que seu gateway espera.1294* Se [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) apontar para um [gateway de LLM](/docs/pt/llm-gateway), o texto após `401` é a mensagem do seu gateway e não da Anthropic, e o `/login` não a altera. Em vez disso, corrija a credencial que seu gateway espera.
1295* Se todas as requisições falharem com `401` depois que seu gateway tiver a credencial que espera, verifique se o gateway está rejeitando os campos de busca de ferramentas que o Claude Code envia por padrão. Para verificar, defina `ENABLE_TOOL_SEARCH=false` conforme descrito em [Busca de ferramentas por meio de um gateway de LLM](/docs/pt/mcp#tool-search-through-a-gateway) e tente novamente. Antes da v2.1.304, a busca de ferramentas ficava desativada atrás de um gateway, a menos que você a ativasse com `ENABLE_TOOL_SEARCH`.
1270 1296
1271### Login expired1297### Login expired
1272 1298
1338* Em outras plataformas, execute `/login` novamente1364* Em outras plataformas, execute `/login` novamente
1339* Se o login ainda não for salvo, consulte [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para o comando de desbloqueio do keychain e outras etapas de recuperação do armazenamento de credenciais1365* Se o login ainda não for salvo, consulte [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para o comando de desbloqueio do keychain e outras etapas de recuperação do armazenamento de credenciais
1340 1366
1341### Failed to start OAuth callback server1367### Couldn't start the local listener that receives the browser sign-in
1342 1368
1343Quando `/login`, `claude auth login` ou `claude setup-token` faz seu login pelo navegador, o Claude Code abre uma porta de escuta em `127.0.0.1` para que seu navegador possa devolver o resultado do login a ele. Esta mensagem significa que o Claude Code não conseguiu abrir essa porta, e o login é interrompido antes que uma janela do navegador ou uma URL de login apareça:1369Cada uma destas mensagens de `/login`, `claude auth login` ou `claude setup-token` significa que o Claude Code não conseguiu abrir a porta em `127.0.0.1` para onde seu navegador retorna o resultado do login.
1344 1370
1345```text theme={null}1371Com o aviso que começa com `The browser can't return the sign-in to Claude Code automatically`, o login continua sem essa porta. Nenhum navegador é aberto, e o aviso aparece acima de uma URL onde você entra:
1346Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1372
1373```text wrap theme={null}
1374The browser can't return the sign-in to Claude Code automatically. After you sign in, paste the code shown.
1347```1375```
1348 1376
1349Se sua mensagem termina com `Is port 0 in use?`, a tentativa de escutar no endereço de loopback IPv4 `127.0.0.1` falhou completamente. Como a falha acontece antes que exista uma URL de login, o fluxo `Paste code here if prompted` não está disponível como solução alternativa.1377Com a mensagem que inclui `Couldn't start the local listener`, o login foi interrompido. Isso acontece, por exemplo, quando você redireciona entrada para `claude auth login` por pipe:
1378
1379```text theme={null}
1380Couldn't start the local listener that receives the browser sign-in. Try again.
1381```
1350 1382
1351**O que fazer:**1383**O que fazer:**
1352 1384
1353* Para fazer login imediatamente sem o listener local: se você usa uma assinatura claude.ai, execute [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token) em uma máquina onde o login funciona e defina o token que ele imprime como `CLAUDE_CODE_OAUTH_TOKEN` nesta máquina. Caso contrário, defina `ANTHROPIC_API_KEY` com uma chave do [Claude Console](https://platform.claude.com/settings/keys). [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) explica como o Claude Code escolhe entre credenciais.1385* **`The browser can't return the sign-in to Claude Code automatically`**: você não precisa corrigir nada antes. Abra a URL mostrada abaixo do aviso em um navegador e entre. O navegador então mostra um código: cole-o no Claude Code no prompt `Paste code here >`, e o login continua a partir daí.
1354* Para usar o login pelo navegador nesta máquina, o Claude Code precisa conseguir escutar em `127.0.0.1`. Se ele for executado dentro de um sandbox, verifique se a política do sandbox permite escutar em portas locais e então execute `/login` novamente. Se ele deveria conseguir e ainda assim falhar, execute `/feedback` para que o relatório inclua os detalhes do seu ambiente.1386* **`Couldn't start the local listener that receives the browser sign-in`**: execute o mesmo comando novamente. Se ele parar da mesma forma, entre com um token ou chave de API em vez do navegador. Ou, se você redirecionou entrada para `claude auth login` por pipe, execute-o em um terminal para que ele possa receber um código colado.
1387* **Para entrar com um token ou chave de API em vez do navegador**: se você usa uma assinatura claude.ai, execute [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token) em uma máquina onde o login funciona. Depois defina o token que ele imprime como a variável de ambiente [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars) nesta máquina. Caso contrário, defina a variável de ambiente `ANTHROPIC_API_KEY` com uma chave do [Claude Console](https://platform.claude.com/settings/keys). [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) explica como o Claude Code escolhe entre credenciais.
1388* **Para recuperar o retorno automático do navegador**: o Claude Code precisa conseguir escutar em `127.0.0.1`. Se ele for executado dentro de um sandbox, verifique se a política do sandbox permite escutar em portas locais e depois entre novamente. Se escutar deveria funcionar ali e o aviso ainda aparecer, execute `/feedback` para que o relatório inclua os detalhes do seu ambiente.
1389
1390Antes da v2.1.305, o login parava assim que a porta não podia ser aberta e não mostrava nenhuma URL para entrar. A mensagem era, por exemplo, `Failed to start OAuth callback server: Failed to start server. Is port 0 in use?`. Nessas versões, atualize o Claude Code e entre novamente, ou entre com um token ou chave de API em vez do navegador.
1355 1391
1356### Claude login not accepted1392### Claude login not accepted
1357 1393
1513 1549
1514Atualize o valor do cabeçalho onde o servidor está configurado e então reconecte pelo `/mcp`.1550Atualize o valor do cabeçalho onde o servidor está configurado e então reconecte pelo `/mcp`.
1515 1551
1516Antes da v2.1.273, os casos de login expirado, `headersHelper` e cabeçalho `Authorization` mostravam todos `MCP server "<name>" requires re-authorization (token expired)`.1552Em uma sessão do [Cowork](https://claude.com/docs/cowork/overview) na sua máquina no aplicativo Claude Desktop, estas mensagens significam que o servidor MCP rejeitou uma credencial que recebeu. Corrija a que a mensagem indica e, em seguida, inicie uma nova tarefa ou chat no Cowork:
1553
1554```text theme={null}
1555MCP server "<name>" rejected the credential from its headersHelper (check the helper, then start a new task or chat)
1556MCP server "<name>" rejected the Authorization header in its config (update it, then start a new task or chat)
1557```
1558
1559* **Credencial do `headersHelper` rejeitada**: verifique se o helper retorna uma credencial que o servidor aceita e, em seguida, inicie uma nova tarefa ou chat no Cowork
1560* **Cabeçalho `Authorization` rejeitado**: atualize o valor `Authorization` em `headers` na configuração desse servidor e, em seguida, inicie uma nova tarefa ou chat no Cowork
1561
1562Antes da v2.1.302, uma sessão do Cowork mostrava os finais `run /mcp to reconnect`, embora o `/mcp` não esteja disponível lá. Se você vir um desses finais no Cowork, ainda assim verifique o helper ou atualize o cabeçalho e, em seguida, inicie uma nova tarefa ou chat. Antes da v2.1.273, os casos de login expirado, `headersHelper` e cabeçalho `Authorization` mostravam todos `MCP server "<name>" requires re-authorization (token expired)`.
1517 1563
1518Um servidor também pode recusar uma chamada de ferramenta com HTTP 403 `insufficient_scope` para pedir que você autorize um escopo, às vezes um que seu token já lista. A mensagem indica esse escopo:1564Um servidor também pode recusar uma chamada de ferramenta com HTTP 403 `insufficient_scope` para pedir que você autorize um escopo, às vezes um que seu token já lista. A mensagem indica esse escopo:
1519 1565
1812* Confirme que você pode alcançar o host da API a partir do mesmo shell executando `curl -I https://api.anthropic.com`. No Windows PowerShell use `curl.exe -I https://api.anthropic.com` para que o alias `Invoke-WebRequest` integrado não seja usado.1858* Confirme que você pode alcançar o host da API a partir do mesmo shell executando `curl -I https://api.anthropic.com`. No Windows PowerShell use `curl.exe -I https://api.anthropic.com` para que o alias `Invoke-WebRequest` integrado não seja usado.
1813* Se você estiver atrás de um proxy corporativo, defina `HTTPS_PROXY` antes de iniciar Claude Code e veja [Network configuration](/docs/pt/network-config)1859* Se você estiver atrás de um proxy corporativo, defina `HTTPS_PROXY` antes de iniciar Claude Code e veja [Network configuration](/docs/pt/network-config)
1814* Se você rotear através de um gateway de LLM ou relay, defina [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) para seu endereço. Veja [Connect Claude Code to an LLM gateway](/docs/pt/llm-gateway-connect) para configuração.1860* Se você rotear através de um gateway de LLM ou relay, defina [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) para seu endereço. Veja [Connect Claude Code to an LLM gateway](/docs/pt/llm-gateway-connect) para configuração.
1861* Se `ANTHROPIC_BASE_URL` já aponta para seu gateway e toda requisição termina em `Connection dropped`, verifique se seu gateway está rejeitando os campos de tool search que Claude Code envia por padrão. Para verificar, defina `ENABLE_TOOL_SEARCH=false` conforme [Tool search through an LLM gateway](/docs/pt/mcp#tool-search-through-a-gateway) descreve, depois tente novamente. Antes da v2.1.304, o tool search ficava desativado atrás de um gateway, a menos que você o ativasse com `ENABLE_TOOL_SEARCH`.
1815* Certifique-se de que seu firewall permite os hosts listados em [Network access requirements](/docs/pt/network-config#network-access-requirements)1862* Certifique-se de que seu firewall permite os hosts listados em [Network access requirements](/docs/pt/network-config#network-access-requirements)
1816* Falhas intermitentes são [tentadas novamente de forma automática](#automatic-retries); falhas persistentes apontam para um problema de rede local1863* Falhas intermitentes são [tentadas novamente de forma automática](#automatic-retries)
1817 1864
1818Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:1865Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:
1819 1866
2093 2140
2094## Erros de requisição2141## Erros de requisição
2095 2142
2096Esses erros estão relacionados ao conteúdo de sua requisição. A maioria retorna da API após ela rejeitar a requisição; alguns são produzidos localmente pelo Claude Code antes de qualquer requisição ser enviada.2143Esses erros estão relacionados ao conteúdo da sua requisição. A maioria vem da API depois que ela rejeitou a requisição; alguns são produzidos localmente pelo Claude Code antes que qualquer requisição seja enviada.
2097 2144
2098### Prompt é muito longo2145### Prompt is too long
2099 2146
2100A conversa mais os arquivos anexados excedem a janela de contexto do modelo.2147A conversa mais os arquivos anexados excedem a janela de contexto do modelo.
2101 2148
2103Prompt is too long2150Prompt is too long
2104```2151```
2105 2152
2106Em uma sessão interativa, Claude Code mostra este erro como:2153Em uma sessão interativa, o Claude Code mostra esse erro como:
2107 2154
2108```text theme={null}2155```text theme={null}
2109Context limit reached · /compact or /clear to continue2156Context limit reached · /compact or /clear to continue
2110```2157```
2111 2158
2112A linha nomeia apenas `/clear` quando [`DISABLE_COMPACT`](/docs/pt/env-vars) está definido. Formas mais longas do erro, como a forma de falha de compactação abaixo, mantêm a redação `Prompt is too long ·`. Na saída `-p` e na transcrição, o texto permanece `Prompt is too long`.2159A linha menciona apenas `/clear` quando [`DISABLE_COMPACT`](/docs/pt/env-vars) está definida. Formas mais longas do erro, como a forma de falha de compactação abaixo, mantêm o texto `Prompt is too long ·`. Na saída de `-p` e na transcrição, o texto permanece `Prompt is too long`.
2113 2160
2114Quando você desativou a compactação automática em suas [configurações de usuário](/docs/pt/settings-reference#autocompactenabled), a linha também diz:2161Quando você desativou a compactação automática nas suas [configurações de usuário](/docs/pt/settings-reference#autocompactenabled), a linha também informa isso:
2115 2162
2116```text theme={null}2163```text theme={null}
2117Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on2164Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on
2118```2165```
2119 2166
2120O botão **Auto-compact** em `/config` escreve `autoCompactEnabled` nas configurações do usuário. A dica aparece apenas quando uma mudança `/config` teria efeito. Por exemplo, não aparece quando [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars) ou [`DISABLE_COMPACT`](/docs/pt/env-vars) desativou a compactação automática. Também não aparece quando um escopo de precedência mais alta, como configurações de projeto ou gerenciadas, define `autoCompactEnabled` como `false`. Antes da v2.1.235, a linha não tinha dica de compactação automática.2167A opção **Auto-compact** em `/config` grava `autoCompactEnabled` nas configurações de usuário. A dica aparece apenas quando uma alteração em `/config` teria efeito. Por exemplo, ela não aparece quando [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars) ou [`DISABLE_COMPACT`](/docs/pt/env-vars) desativou a compactação automática. Ela também não aparece quando um escopo de maior precedência, como configurações de projeto ou configurações gerenciadas, definiu `autoCompactEnabled` como `false`. Antes da v2.1.235, a linha não trazia nenhuma dica sobre compactação automática.
2121 2168
2122Amazon Bedrock relata essa condição como `Input is too long for requested model.`, que Claude Code trata da mesma forma. Antes da v2.1.217, Claude Code não reconhecia a redação do Bedrock, então a compactação automática nunca era acionada e `/compact` falhava com o mesmo erro.2169O Amazon Bedrock informa essa condição como `Input is too long for requested model.`, que o Claude Code trata da mesma forma. Antes da v2.1.217, o Claude Code não reconhecia o texto do Bedrock, então a compactação automática nunca era acionada por ele e `/compact` falhava com o mesmo erro.
2123 2170
2124Um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway-config#upstream-error-messages) relata essa condição como `capability_rejected: prompt_too_long` quando um upstream de nuvem rejeita a requisição na forma de erro própria do provedor. Claude Code trata o token da mesma forma que `Prompt is too long`. Antes da v2.1.228, Claude Code não reconhecia o token, então a compactação automática não era acionada.2171Um [gateway de apps Claude](/docs/pt/claude-apps-gateway-config#upstream-error-messages) informa essa condição como `capability_rejected: prompt_too_long` quando um upstream de nuvem rejeita a requisição no formato de erro do próprio provedor. O Claude Code trata o token da mesma forma que `Prompt is too long`. Antes da v2.1.228, o Claude Code não reconhecia o token, então a compactação automática não era acionada por ele.
2125 2172
2126Quando a compactação automática foi executada neste turno e falhou em um erro subjacente, como um modelo indisponível ou uma falha de autenticação, a mensagem nomeia esse erro após um separador:2173Quando a compactação automática foi executada neste turno e falhou devido a um erro subjacente, como um modelo indisponível ou uma falha de autenticação, a mensagem nomeia esse erro após um separador:
2127 2174
2128```text theme={null}2175```text theme={null}
2129Prompt is too long · automatic compaction failed: <the underlying error>2176Prompt is too long · automatic compaction failed: <the underlying error>
2130```2177```
2131 2178
2132Resolva o erro nomeado primeiro; `/compact` falha no mesmo erro até você fazer isso. Antes da v2.1.229, uma compactação automática falhada exibia `Prompt is too long` sem a causa.2179Resolva primeiro o erro nomeado; `/compact` falha com o mesmo erro até que você o faça. Antes da v2.1.229, uma compactação automática com falha exibia `Prompt is too long` sem a causa.
2133 2180
2134Quando a compactação automática é executada neste erro, ela normalmente resume suas trocas mais antigas e mantém as mais novas. Como último recurso, Claude Code resume de forma diferente:2181Quando a compactação automática é executada devido a esse erro, ela normalmente resume suas trocas mais antigas e mantém as mais recentes. Como último recurso, o Claude Code resume de forma diferente:
2135 2182
2136* Quando não consegue resumir nenhuma troca completa, Claude Code mantém seu prompt mais novo palavra por palavra e resume tudo antes dele.2183* Quando não consegue resumir nenhuma troca inteira, o Claude Code mantém seu prompt mais recente palavra por palavra e resume tudo o que vem antes dele.
2137* Nesse caso, quando a conversa não termina com seu prompt, Claude Code resume a conversa inteira.2184* Nesse caso, quando a conversa não termina com o seu prompt, o Claude Code resume a conversa inteira.
2138 2185
2139Claude Code pula essa recuperação quando o conteúdo que ele carregaria adiante não contém resposta do modelo e menos de cerca de 1.000 tokens de seu próprio texto, como uma tentativa curta enviada após uma colagem de tamanho excessivo. Execute `/clear` para começar do zero. Antes da v2.1.269, a compactação falhava sempre que não conseguia resumir uma troca completa, então uma sessão nesse estado atingia esse erro novamente a cada turno.2186O Claude Code ignora essa recuperação quando o conteúdo que ele levaria adiante não contém nenhuma resposta do modelo e menos de cerca de 1.000 tokens do seu próprio texto, como uma nova tentativa curta enviada após uma colagem grande demais. Execute `/clear` para começar do zero. Antes da v2.1.269, a compactação falhava sempre que não conseguia resumir uma troca inteira, então uma sessão nesse estado encontrava esse erro novamente a cada turno.
2140 2187
2141Uma conversa de troca única não tem turnos anteriores para resumir. Quando a compactação automática teria sido executada em uma, Claude Code pula a tentativa e explica o que preenche a requisição. Quando a API não relata contagens de tokens em seu erro, a mensagem lê:2188Uma conversa de troca única não tem turnos anteriores para resumir. Quando a compactação automática teria sido executada em uma delas, o Claude Code ignora a tentativa e explica o que preenche a requisição. Quando a API não informa contagens de tokens em seu erro, a mensagem diz:
2142 2189
2143```text theme={null}2190```text theme={null}
2144Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.2191Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.
2145```2192```
2146 2193
2147Quando a API relata contagens de tokens em seu erro, Claude Code as compara com sua própria estimativa do tamanho da conversa para dizer qual é a maior parte da requisição: o conteúdo próprio da conversa ou o system prompt, definições de ferramentas e conteúdo de anexos que Claude Code envia com ela. Quando o conteúdo próprio da conversa é a maior parte da requisição, a mensagem lê:2194Quando a API informa contagens de tokens em seu erro, o Claude Code as compara com sua própria estimativa do tamanho da conversa para identificar o que compõe a maior parte da requisição: o conteúdo próprio da conversa, ou o system prompt, as definições de ferramentas e o conteúdo de anexos que o Claude Code envia com ela. Quando o conteúdo próprio da conversa é a maior parte da requisição, a mensagem diz:
2148 2195
2149```text theme={null}2196```text theme={null}
2150Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).2197Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).
2151```2198```
2152 2199
2153Quando a maior parte da requisição está fora da conversa, a mensagem lê:2200Quando a maior parte da requisição está fora da conversa, a mensagem diz:
2154 2201
2155```text theme={null}2202```text theme={null}
2156Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.2203Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.
2157```2204```
2158 2205
2159Antes da v2.1.162, Claude Code tentava a compactação mesmo assim e exibia o `Prompt is too long` simples quando falhava.2206Antes da v2.1.162, o Claude Code tentava a compactação mesmo assim e exibia apenas `Prompt is too long` quando ela falhava.
2160 2207
2161**O que fazer:**2208**O que fazer:**
2162 2209
2163* Execute `/compact` para resumir turnos anteriores e liberar espaço, ou `/clear` para começar do zero. Se `/compact` responder `Not enough messages to compact.`, a conversa é uma troca única sem nada anterior para resumir, então o espaço é ocupado por esse prompt e o que Claude Code envia com cada requisição: execute `/clear` e reenvie com menos texto colado ou anexos menores, ou reduza as definições de ferramentas e arquivos de memória usando as etapas abaixo2210* Execute `/compact` para resumir turnos anteriores e liberar espaço, ou `/clear` para começar do zero. Se `/compact` responder `Not enough messages to compact.`, a conversa é uma troca única sem nada anterior para resumir, então o espaço está ocupado por esse único prompt e pelo que o Claude Code envia com cada requisição: execute `/clear` e reenvie com menos texto colado ou anexos menores, ou reduza as definições de ferramentas e os arquivos de memória usando os passos abaixo
2164* Execute `/context` para ver um detalhamento do que está consumindo a janela: system prompt, ferramentas, arquivos de memória e mensagens2211* Execute `/context` para ver um detalhamento do que está consumindo a janela: system prompt, ferramentas, arquivos de memória e mensagens
2165* Desabilite servidores MCP que você não está usando com `/mcp disable <name>` para remover suas definições de ferramentas do contexto2212* Desative os servidores MCP que você não está usando com `/mcp disable <name>` para remover as definições de ferramentas deles do contexto
2166* 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 relevante2213* 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 são carregadas apenas quando relevantes
2167* A compactação automática está ativada por padrão e normalmente previne esse erro. Se você a desativou em `/config` ou com [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars), ative-a novamente. Se você mantê-la desativada, execute `/compact` você mesmo antes da janela se encher.2214* A compactação automática é ativada por padrão e normalmente evita esse erro. Se você a desativou em `/config` ou com [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars), ative-a novamente. Se mantê-la desativada, execute `/compact` você mesmo antes que a janela se encha.
2168* Se o erro aparecer perto de 200K tokens em um modelo que aceita mais, uma causa é um ID de modelo que o Claude Code não reconhece. O Claude Code assume uma janela de 200K para esse ID, então, para continuar trabalhando além desse ponto, [informe a janela de contexto real do modelo](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id).2215* Se o erro aparecer perto de 200K tokens em um modelo que aceita mais, uma causa é um ID de modelo que o Claude Code não reconhece. O Claude Code presume uma janela de 200K para esse ID, então, para continuar trabalhando além desse ponto, [informe a ele a janela de contexto real do modelo](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id).
2216* Se o erro apareceu logo depois que você interrompeu o Claude enquanto ele compactava a conversa, sua conversa não foi alterada e continua grande o suficiente para precisar de compactação. Execute `/compact` e envie sua mensagem novamente. Para evitar que o erro se repita, [atualize o Claude Code](/docs/pt/setup#update-claude-code) para a v2.1.304 ou posterior. Antes da v2.1.304, interromper nesse momento podia encerrar o turno com este erro.
2169 2217
2170Veja [Explore a janela de contexto](/docs/pt/context-window) para uma visualização interativa de como o contexto se preenche.2218Consulte [Explorar a janela de contexto](/docs/pt/context-window) para uma visualização interativa de como o contexto se enche.
2171 2219
2172### Contexto excede o limite de tokens2220### Context exceeds the token limit
2173 2221
2174`/context` mostra este aviso no topo de sua saída quando a conversa cresceu além da janela de contexto do modelo. As requisições falham com [`Prompt is too long`](#prompt-is-too-long) até você liberar espaço. Uma sessão interativa mostra esse erro como a linha `Context limit reached`.2222`/context` mostra este aviso no topo da sua saída quando a conversa ultrapassou a janela de contexto do modelo. As requisições falham com [`Prompt is too long`](#prompt-is-too-long) até que você libere espaço. Uma sessão interativa mostra esse erro como a linha `Context limit reached`.
2175 2223
2176```text theme={null}2224```text theme={null}
2177Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.2225Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.
2178```2226```
2179 2227
2180Quando o limite que você excedeu é uma janela de compactação, como o limite de 200K em modelos de contexto 1M, o aviso lê de forma diferente. Uma janela de compactação pode ficar abaixo da janela de contexto do modelo, então requisições após ela ainda podem ter sucesso.2228Quando o limite que você excedeu é uma janela de compactação, como o limite de 200K em modelos com contexto de 1M, o aviso é diferente. Uma janela de compactação pode ficar abaixo da janela de contexto do modelo, então requisições além dela ainda podem ter sucesso.
2181 2229
2182```text theme={null}2230```text theme={null}
2183Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.2231Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.
2184```2232```
2185 2233
2186Ambas as formas nomeiam `/clear` em vez de `/compact` quando você definiu [`DISABLE_COMPACT`](/docs/pt/env-vars).2234Ambas as formas mencionam `/clear` em vez de `/compact` quando você definiu [`DISABLE_COMPACT`](/docs/pt/env-vars).
2187 2235
2188**O que fazer:**2236**O que fazer:**
2189 2237
2190* Em uma conversa com múltiplos turnos, execute `/compact` para resumir turnos anteriores e liberar espaço. Para começar do zero, execute `/clear`2238* Em uma conversa com vários turnos, execute `/compact` para resumir turnos anteriores e liberar espaço. Para começar do zero, execute `/clear`
2191* Para mais formas de reduzir o uso, veja [Prompt é muito longo](#prompt-is-too-long)2239* Para mais formas de reduzir o uso, consulte [Prompt is too long](#prompt-is-too-long)
2192 2240
2193Antes da v2.1.216, `/context` mostrava uso acima de 100% sem linha de aviso explicando o que isso significava ou como se recuperar.2241Antes da v2.1.216, `/context` mostrava uso acima de 100% sem nenhuma linha de aviso explicando o que isso significava ou como se recuperar.
2194 2242
2195### Requisição muito grande2243### Request too large
2196 2244
2197O corpo da requisição bruta excedeu o limite de 32MB da API antes da tokenização, geralmente por causa de conteúdo colado grande, resultados de ferramentas ou anexos. Este limite é separado da [janela de contexto](#prompt-is-too-long).2245O corpo bruto da requisição excedeu o limite de 32MB da API antes da tokenização, geralmente por causa de conteúdo colado grande, resultados de ferramentas ou anexos. Esse limite é separado da [janela de contexto](#prompt-is-too-long).
2198 2246
2199```text theme={null}2247```text theme={null}
2200Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.2248Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.
2201```2249```
2202 2250
2203Quando a requisição foi direto para a API Claude e a própria API a rejeitou, Claude Code mede a conversa e redige a mensagem conforme a recuperação pode funcionar. Através de um proxy, gateway ou provedor de nuvem você obtém a mensagem geral. As formas medidas:2251Quando a requisição foi diretamente para a Claude API e a própria API a rejeitou, o Claude Code mede a conversa e formula a mensagem de acordo com a possibilidade de recuperação. Por meio de um proxy, gateway ou provedor de nuvem, você recebe a mensagem geral. As formas medidas:
2204 2252
2205* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: imagens ou documentos empurraram a requisição para além do limite. Claude Code tenta novamente com eles removidos.2253* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: imagens ou documentos fizeram a requisição ultrapassar o limite. O Claude Code tenta novamente sem eles.
2206* `Request too large for the API's 32MB request limit`: as mensagens sozinhas estão acima do limite, então a mensagem diz `compacting cannot make it fit` e Claude Code não tenta novamente. Em [modo não interativo](/docs/pt/headless), a mensagem diz para você reduzir a entrada ou iniciar uma nova sessão.2254* `Request too large for the API's 32MB request limit`: as mensagens sozinhas ultrapassam o limite, então a mensagem diz `compacting cannot make it fit` e o Claude Code não tenta novamente. No [modo não interativo](/docs/pt/headless), a mensagem diz para você reduzir a entrada ou iniciar uma nova sessão.
2207 2255
2208Antes da v2.1.212, conversas com imagens acumuladas suficientes falhavam a cada turno com `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` Antes da v2.1.229, Claude Code mostrava o conselho de anexo para cada rejeição, mesmo quando a compactação não podia ajudar.2256Antes da v2.1.212, conversas com imagens acumuladas suficientes falhavam em todos os turnos com `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` Antes da v2.1.229, o Claude Code mostrava a orientação sobre anexos para todas as rejeições, mesmo quando compactar não ajudaria.
2209 2257
2210**O que fazer:**2258**O que fazer:**
2211 2259
2212* Se a mensagem diz `compacting cannot make it fit`, pressione Esc duas vezes para voltar além do turno que adicionou o conteúdo grande, ou execute `/clear` para começar do zero2260* Se a mensagem disser `compacting cannot make it fit`, pressione Esc duas vezes para voltar para antes do turno que adicionou o conteúdo grande, ou execute `/clear` para começar do zero
2213* Caso contrário, execute `/compact`, que remove imagens e anexos acumulados2261* Caso contrário, execute `/compact`, que descarta imagens e anexos acumulados
2214* Referencie arquivos grandes por caminho em vez de colar seu conteúdo, para que Claude possa lê-los em pedaços2262* Faça referência a arquivos grandes pelo caminho em vez de colar seu conteúdo, para que o Claude possa lê-los em partes
2215* Para imagens, veja [Imagem era muito grande](#image-was-too-large) abaixo2263* Para imagens, consulte [Image was too large](#image-was-too-large) abaixo
2216 2264
2217### Imagem era muito grande2265### Image was too large
2218 2266
2219Uma imagem colada ou anexada excede os limites de tamanho ou dimensão da API.2267Uma imagem colada ou anexada excede os limites de tamanho ou de dimensão da API.
2220 2268
2221```text theme={null}2269```text theme={null}
2222Image was too large. Double press esc to go back and try again with a smaller image.2270Image was too large. Double press esc to go back and try again with a smaller image.
2229Se um desses erros continuar voltando, atualize o Claude Code. Em versões mais antigas, um erro de imagem podia se repetir por motivos como estes:2277Se um desses erros continuar voltando, atualize o Claude Code. Em versões mais antigas, um erro de imagem podia se repetir por motivos como estes:
2230 2278
2231* Antes da v2.1.299, em uma conversa longa com muitas imagens, o Claude Code podia remover as imagens que você anexou por último em vez daquela acima do limite. A linha `was removed` então se repetia a cada turno, e o Claude não via suas novas imagens.2279* Antes da v2.1.299, em uma conversa longa com muitas imagens, o Claude Code podia remover as imagens que você anexou por último em vez daquela acima do limite. A linha `was removed` então se repetia a cada turno, e o Claude não via suas novas imagens.
2232* Antes da v2.1.299, no VS Code, no aplicativo Desktop e no Agent SDK, as imagens que você anexava enquanto o Claude estava trabalhando não passavam pelo redimensionamento que outras imagens anexadas recebem. Elas chegavam à API em seu tamanho original, o que levava a erros de imagem repetidos em conversas longas.2280* Antes da v2.1.299, no VS Code, no aplicativo Desktop e no Agent SDK, as imagens que você anexava enquanto o Claude estava trabalhando não recebiam o redimensionamento que outras imagens anexadas recebem. Elas chegavam à API em seu tamanho original, o que levava a erros de imagem repetidos em conversas longas.
2233* Antes da v2.1.166, uma imagem colada podia permanecer na conversa, e o mesmo erro então se repetia em todas as mensagens subsequentes2281* Antes da v2.1.166, uma imagem colada podia permanecer na conversa, e o mesmo erro então se repetia em todas as mensagens seguintes
2234 2282
2235**O que fazer:**2283**O que fazer:**
2236 2284
2237* Redimensione a imagem antes de colar. A API aceita imagens de até 8000 pixels na borda mais longa para uma única imagem, ou 3000 pixels quando mais de 20 imagens estão em contexto.2285* Redimensione a imagem antes de colá-la. A API aceita imagens de até 8000 pixels no lado mais longo para uma única imagem, ou 3000 pixels quando há mais de 20 imagens no contexto.
2238* Faça uma captura de tela mais apertada da região relevante em vez da tela inteira2286* Faça uma captura de tela mais recortada da região relevante em vez da tela inteira
2239 2287
2240### Não foi possível redimensionar a imagem2288### Unable to resize image
2241 2289
2242Claude Code não conseguiu reduzir uma imagem anexada antes de enviá-la para a API.2290O Claude Code não conseguiu reduzir a escala de uma imagem anexada antes de enviá-la para a API.
2243 2291
2244```text theme={null}2292```text theme={null}
2245Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.2293Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
2251Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.2299Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.
2252```2300```
2253 2301
2254Claude Code normalmente redimensiona imagens grandes automaticamente. Esses erros significam que a imagem não pôde ser decodificada ou redimensionada para caber dentro dos limites da API.2302O Claude Code normalmente redimensiona imagens grandes automaticamente. Esses erros significam que a imagem não pôde ser decodificada ou redimensionada para caber nos limites da API.
2255 2303
2256**O que fazer:**2304**O que fazer:**
2257 2305
2258* Se a mensagem pedir para você converter a imagem, converta-a para PNG, JPEG, GIF ou WebP e anexe-a novamente. Claude Code pode verificar dimensões para esses formatos a partir do cabeçalho do arquivo, sem decodificar a imagem.2306* Se a mensagem pedir que você converta a imagem, converta-a para PNG, JPEG, GIF ou WebP e anexe-a novamente. O Claude Code consegue verificar as dimensões desses formatos pelo cabeçalho do arquivo, sem decodificar a imagem.
2259* Se a mensagem relatar um limite de dimensão ou tamanho, redimensione ou recomprima a imagem abaixo desse limite antes de anexar.2307* Se a mensagem informar um limite de dimensão ou de tamanho, redimensione ou recomprima a imagem abaixo desse limite antes de anexá-la.
2260* Se a mensagem nomear uma causa, como um JPEG CMYK, um WebP animado ou um arquivo possivelmente danificado, salve novamente a imagem no formato que a mensagem sugere e anexe-a novamente.2308* Se a mensagem nomear uma causa, como um JPEG CMYK, um WebP animado ou um arquivo possivelmente danificado, salve a imagem novamente no formato que a mensagem sugere e anexe-a de novo.
2261 2309
2262### Request rejected as unprocessable by the model2310### Request rejected as unprocessable by the model
2263 2311
2267API Error: 400 Request rejected as unprocessable by the model (too many or oversized images, or unsupported parameters)2315API Error: 400 Request rejected as unprocessable by the model (too many or oversized images, or unsupported parameters)
2268```2316```
2269 2317
2270O Claude Code pode remover as imagens e documentos mais antigos de uma requisição recusada e enviá-la novamente. Antes da v2.1.290, o Claude Code não removia imagens nessa recusa, então uma sessão longa que acumulasse centenas delas podia falhar com esse erro a cada turno.2318O Claude Code pode remover as imagens e os documentos mais antigos de uma requisição recusada e enviá-la novamente. Antes da v2.1.290, o Claude Code não removia imagens nessa recusa, então uma sessão longa que acumulasse centenas delas podia falhar com esse erro a cada turno.
2271 2319
2272**O que fazer:**2320**O que fazer:**
2273 2321
2274* Se a mensagem continuar aparecendo em uma conversa com imagens ou documentos, remova-os você mesmo. Pressione Esc duas vezes para voltar antes dos turnos que os adicionaram, ou execute `/clear` para começar do zero.2322* Se a mensagem continuar aparecendo em uma conversa com imagens ou documentos, remova-os você mesmo. Pressione Esc duas vezes para voltar para antes dos turnos que os adicionaram, ou execute `/clear` para começar do zero.
2275 2323
2276### Erros de PDF2324### Erros de PDF
2277 2325
2278O PDF que você anexou não pôde ser processado. As mensagens são mostradas aqui em sua forma não interativa; em uma sessão interativa, elas solicitam que você pressione esc duas vezes e tente novamente.2326O PDF que você anexou não pôde ser processado. As mensagens são mostradas aqui em sua forma não interativa; em uma sessão interativa, elas pedem que você pressione esc duas vezes e tente novamente.
2279 2327
2280```text theme={null}2328```text theme={null}
2281PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).2329PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
2285 2333
2286**O que fazer:**2334**O que fazer:**
2287 2335
2288* 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 caminho2336* Para PDFs grandes demais, peça ao Claude para ler um intervalo de páginas com a ferramenta Read em vez de anexar o arquivo inteiro, ou extraia o texto com uma ferramenta como `pdftotext` e faça referência ao arquivo de saída pelo caminho
2289* Para PDFs protegidos ou inválidos, remova a senha ou re-exporte o arquivo de seu aplicativo de origem e tente novamente2337* Para PDFs protegidos ou inválidos, remova a senha ou exporte novamente o arquivo a partir do aplicativo de origem e tente outra vez
2290 2338
2291Quando Claude lê um intervalo de páginas de um PDF com a ferramenta Read, a leitura pode falhar com uma mensagem diferente:2339Quando o Claude lê um intervalo de páginas de um PDF com a ferramenta Read, a leitura pode falhar com uma mensagem diferente:
2292 2340
2293```text theme={null}2341```text theme={null}
2294pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.2342pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.
2295```2343```
2296 2344
2297Leituras de intervalo de páginas renderizam páginas com `pdftoppm`. Instale poppler-utils com o comando que a mensagem fornece, ou em outras plataformas um build do poppler que coloca `pdftoppm` em seu `PATH`. Veja [Comportamento da ferramenta Read](/docs/pt/tools-reference#read-tool-behavior) para quais PDFs são lidos por intervalo de páginas.2345Leituras de intervalo de páginas renderizam as páginas com `pdftoppm`. Instale o poppler-utils com o comando que a mensagem fornece ou, em outras plataformas, um build do poppler que coloque `pdftoppm` no seu `PATH`. Consulte [Comportamento da ferramenta Read](/docs/pt/tools-reference#read-tool-behavior) para saber quais PDFs são lidos por intervalo de páginas.
2298 2346
2299### Entradas extras não são permitidas2347### Extra inputs are not permitted
2300 2348
2301Um proxy ou gateway de LLM entre Claude Code e a API removeu o cabeçalho de requisição `anthropic-beta`, então a API rejeitou campos que dependem dele.2349O endpoint que recebeu a requisição rejeitou um dos campos da requisição como uma entrada que ele não aceita, e a mensagem do endpoint menciona esse campo.
2302 2350
2303```text theme={null}2351```text theme={null}
2304API Error: 400 ... Extra inputs are not permitted ... context_management2352API Error: 400 ... context_management: Extra inputs are not permitted
2305```2353```
2306 2354
2307Claude Code envia campos apenas de beta como `context_management` junto com um cabeçalho `anthropic-beta` que os habilita. Quando um gateway encaminha o corpo mas remove o cabeçalho, a API vê campos que não reconhece.2355O Claude Code envia campos exclusivos de beta, como `context_management` e o `defer_loading` da busca de ferramentas, junto com um cabeçalho `anthropic-beta` que os habilita. Quando um gateway encaminha o corpo mas descarta o cabeçalho, a API vê campos que não reconhece. Quando um gateway encaminha um corpo no formato da Anthropic para um upstream com um esquema diferente, esse upstream rejeita esses campos. [Pares de cabeçalho beta e campo de corpo](/docs/pt/llm-gateway-protocol#beta-header-and-body-field-pairs) aborda ambos os casos.
2308 2356
2309**O que fazer:**2357**O que fazer:**
2310 2358
2311* Configure seu gateway para encaminhar o cabeçalho `anthropic-beta`. Veja [passagem de recursos](/docs/pt/llm-gateway-protocol#feature-pass-through) para o que os gateways devem encaminhar.2359* Se a mensagem contiver `context_management: Extra inputs are not permitted`, [atualize o Claude Code](/docs/pt/setup#update-claude-code) para a v2.1.304 ou posterior. Após a atualização, o Claude Code responde a essa rejeição enviando a requisição mais uma vez sem o campo. Antes da v2.1.304, o Claude Code não tentava novamente após essa rejeição.
2312* Como fallback, defina [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/pt/env-vars) antes de iniciar. [Desabilitar capacidades de pré-lançamento](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) cobre o escopo exato.2360* Se a mensagem mencionar `defer_loading` ou `tool_reference`, atualize o Claude Code ou desative a [busca de ferramentas](/docs/pt/mcp#tool-search-through-a-gateway):
2361 * [Atualize o Claude Code](/docs/pt/setup#update-claude-code) para a v2.1.305 ou posterior. O Claude Code então responde a essa rejeição enviando a requisição mais uma vez sem os campos de busca de ferramentas.
2362 * Se você não puder atualizar, ou se a mensagem ainda aparecer depois de atualizar, defina `ENABLE_TOOL_SEARCH=false` no seu shell ou no [`env` das suas configurações](/docs/pt/settings-reference#env). Se um arquivo de configurações já definir a variável, altere-a lá, pois esse valor [pode sobrescrever um export do shell](/docs/pt/settings-reference#how-env-values-interact-with-your-shell). O Claude Code então carrega as ferramentas MCP antecipadamente.
2363* Se o seu gateway descartar o cabeçalho, configure-o para encaminhar o cabeçalho `anthropic-beta`. Consulte [repasse de recursos](/docs/pt/llm-gateway-protocol#feature-pass-through) para saber o que os gateways devem encaminhar.
2364* Como fallback, defina [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/pt/env-vars) antes de iniciar. [Desativar recursos de pré-lançamento](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) cobre o escopo exato.
2365
2366Antes da v2.1.302, esse erro também podia nomear o campo `diagnostics` sem nenhum gateway envolvido. Ele aparecia quando uma sessão que já tinha usado a Anthropic API passava para o Amazon Bedrock ou para o Agent Platform do Google Cloud sem reiniciar. Por exemplo, uma sessão que você deixou aberta passa para o Bedrock quando você executa [`/setup-bedrock`](/docs/pt/commands) em outra janela do Claude Code. Nessas versões, execute `/clear` nessa sessão ou reinicie-a.
2313 2367
2314### Esquema de entrada de ferramenta é inválido2368### Tool input schema is invalid
2315 2369
2316Uma ferramenta na requisição declarou um `input_schema` que falha na validação JSON Schema da API, então a API rejeitou a requisição inteira. O número após `tools.` é a posição da ferramenta que falha na lista de ferramentas da requisição, não um nome que você possa procurar.2370Uma ferramenta na requisição declarou um `input_schema` que falha na validação de JSON Schema da API, então a API rejeitou a requisição inteira. O número após `tools.` é a posição da ferramenta com falha na lista de ferramentas da requisição, não um nome que você possa procurar.
2317 2371
2318```text theme={null}2372```text theme={null}
2319API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid2373API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
2322 2376
2323A primeira forma significa que o esquema não é um JSON Schema draft 2020-12 válido. A segunda significa que um nome de propriedade de nível superior não corresponde ao padrão que a mensagem cita.2377A primeira forma significa que o esquema não é um JSON Schema draft 2020-12 válido. A segunda significa que um nome de propriedade de nível superior não corresponde ao padrão que a mensagem cita.
2324 2378
2325Claude Code [exclui ferramentas MCP cujo esquema de entrada falharia nessa validação](/docs/pt/mcp#tools-with-invalid-input-schemas) quando carrega as ferramentas de um servidor, então as requisições normalmente nunca incluem uma.2379O Claude Code [exclui ferramentas MCP cujo esquema de entrada falharia nessa validação](/docs/pt/mcp#tools-with-invalid-input-schemas) ao carregar as ferramentas de um servidor, então as requisições normalmente nunca incluem uma delas.
2326 2380
2327Em uma [implantação onde a busca de flags está desativada](/docs/pt/env-vars#features-that-need-feature-flag-fetching), ou em uma máquina cujas flags nunca chegaram, Claude Code registra no log do servidor qual ferramenta seria rejeitada mas a envia mesmo assim, então esse erro ainda pode ocorrer.2381Em uma [implantação em que a busca de flags está desativada](/docs/pt/env-vars#features-that-need-feature-flag-fetching), ou em uma máquina cujas flags nunca chegaram, o Claude Code registra no log do servidor qual ferramenta seria rejeitada, mas a envia mesmo assim, então esse erro ainda pode ocorrer.
2328 2382
2329O erro também pode ocorrer para uma ferramenta cujo esquema declara um dialeto JSON Schema diferente de draft 2020-12 em `$schema`. Claude Code não verifica esses esquemas contra o meta-esquema JSON Schema, embora a verificação de nome de propriedade de nível superior ainda se aplique.2383O erro também pode ocorrer para uma ferramenta cujo esquema declara em `$schema` um dialeto de JSON Schema diferente do draft 2020-12. O Claude Code não verifica esses esquemas em relação ao metaesquema do JSON Schema, embora a verificação de nomes de propriedades de nível superior ainda se aplique.
2330 2384
2331Antes da v2.1.216, nenhuma implantação executava as verificações de exclusão.2385Antes da v2.1.216, nenhuma implantação executava as verificações de exclusão.
2332 2386
2333**O que fazer:**2387**O que fazer:**
2334 2388
2335* Se sua versão do Claude Code for anterior a v2.1.216, execute `claude update`.2389* Se a sua versão do Claude Code for anterior à v2.1.216, execute `claude update`.
2336* 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.2390* Remova ou [desative](/docs/pt/mcp#disable-a-server-without-removing-it) o servidor MCP que declara o esquema inválido. O erro identifica a ferramenta apenas pela posição. Na v2.1.216 ou posterior, verifique o log de cada servidor em busca de uma linha que nomeie uma ferramenta cujo esquema de entrada seria rejeitado. Se nenhum log nomear uma, desative os servidores um de cada vez.
2337* Se você mantém o servidor, corrija o `input_schema` da ferramenta. O esquema deve ser um JSON Schema válido, e nomes de propriedades de nível superior devem ter 1 a 64 caracteres e usar apenas letras ASCII e dígitos, `_`, `.` e `-`. Veja [Ferramentas com esquemas de entrada inválidos](/docs/pt/mcp#tools-with-invalid-input-schemas).2391* Se você mantém o servidor, corrija o `input_schema` da ferramenta. O esquema deve ser um JSON Schema válido, e os nomes de propriedades de nível superior devem ter de 1 a 64 caracteres e usar apenas letras e dígitos ASCII, `_`, `.` e `-`. Consulte [Ferramentas com esquemas de entrada inválidos](/docs/pt/mcp#tools-with-invalid-input-schemas).
2338 2392
2339### Nome de ferramenta MCP com mais de 128 caracteres2393### Nome de ferramenta MCP com mais de 128 caracteres
2340 2394
2341Um servidor MCP lista uma ferramenta cujo nome completo, como `mcp__<server>__<tool>`, é mais longo que os 128 caracteres que a API aceita. Claude Code [deixa essa ferramenta fora das ferramentas que envia para Claude](/docs/pt/mcp#tools-with-names-longer-than-128-characters), e as outras ferramentas do servidor continuam funcionando. Em uma sessão que você inicia com `claude --debug` a partir do seu shell, Claude Code escreve esta mensagem no log de depuração em `~/.claude/debug/<session-id>.txt`:2395Um servidor MCP lista uma ferramenta cujo nome completo, como `mcp__<server>__<tool>`, é maior que os 128 caracteres que a API aceita. O Claude Code [deixa essa ferramenta de fora das ferramentas que envia ao Claude](/docs/pt/mcp#tools-with-names-longer-than-128-characters), e as outras ferramentas do servidor continuam funcionando. Em uma sessão que você inicia com `claude --debug` a partir do seu shell, o Claude Code grava esta mensagem no log de depuração em `~/.claude/debug/<session-id>.txt`:
2342 2396
2343```text theme={null}2397```text theme={null}
2344Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 1282398Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128
2347**O que fazer:**2401**O que fazer:**
2348 2402
2349* Se você mantém o servidor, encurte o nome da ferramenta.2403* Se você mantém o servidor, encurte o nome da ferramenta.
2350* Se o servidor está em sua [configuração MCP](/docs/pt/mcp#mcp-installation-scopes), dê a ele um nome mais curto lá, como `db` no lugar de `analytics-database`. Depois atualize o que se refere ao servidor ou às suas ferramentas pelo nome antigo, como [regras de permissão](/docs/pt/permissions#mcp) e [matchers de hook](/docs/pt/hooks#match-mcp-tools).2404* Se o servidor estiver na sua [configuração de MCP](/docs/pt/mcp#mcp-installation-scopes), dê a ele um nome mais curto ali, como `db` no lugar de `analytics-database`. Em seguida, atualize o que se refere ao servidor ou às suas ferramentas pelo nome antigo, como [regras de permissão](/docs/pt/permissions#mcp) e [matchers de hook](/docs/pt/hooks#match-mcp-tools).
2351* Se um [plugin agrupa o servidor](/docs/pt/mcp#plugin-provided-mcp-servers), o nome completo da ferramenta também inclui o nome do plugin. Peça ao mantenedor do plugin para encurtar o nome do servidor ou da ferramenta.2405* Se um [plugin incluir o servidor](/docs/pt/mcp#plugin-provided-mcp-servers), o nome completo da ferramenta também inclui o nome do plugin. Peça ao mantenedor do plugin que encurte o nome do servidor ou da ferramenta.
2352 2406
2353Antes da v2.1.292, Claude Code enviava a ferramenta mesmo assim, e a API rejeitava cada requisição que a incluía com `API Error: 400 ... tools.N.custom.name: String should have at most 128 characters`.2407Antes da v2.1.292, o Claude Code enviava a ferramenta mesmo assim, e a API rejeitava todas as requisições que a incluíam com `API Error: 400 ... tools.N.custom.name: String should have at most 128 characters`.
2354 2408
2355### tool\_use.name com mais de 200 caracteres2409### tool\_use.name com mais de 200 caracteres
2356 2410
2357Uma chamada de ferramenta no histórico de conversa carrega um nome mais longo que os 200 caracteres que a API aceita em uma requisição:2411Uma chamada de ferramenta no histórico da conversa traz um nome maior que os 200 caracteres que a API aceita em uma requisição:
2358 2412
2359```text theme={null}2413```text theme={null}
2360API Error: 400 ... tool_use.name: String should have at most 200 characters2414API Error: 400 ... tool_use.name: String should have at most 200 characters
2361```2415```
2362 2416
2363Claude 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 [`No such tool available`](#no-such-tool-available) e a conversa continua sem esse erro de API.2417O Claude Code corta esse nome para 200 caracteres quando a resposta chega e quando carrega uma conversa salva, então a chamada falha com um erro de ferramenta [`No such tool available`](#no-such-tool-available) e a conversa continua sem esse erro da API.
2364 2418
2365**O que fazer:**2419**O que fazer:**
2366 2420
2367* Execute `claude update` e 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.2421* Execute `claude update` e depois retome a conversa. A versão atualizada corrige o nome longo demais ao carregar a transcrição, então uma conversa que estava travada volta a funcionar.
2368 2422
2369Antes da v2.1.281, o nome excessivamente longo permanecia no histórico e a API rejeitava cada requisição que reenviava a conversa, incluindo `/compact` e `--resume`, então esse erro se repetia e a conversa ficava presa.2423Antes da v2.1.281, o nome longo demais permanecia no histórico e a API rejeitava todas as requisições que reenviavam a conversa, incluindo `/compact` e `--resume`, então esse erro se repetia e a conversa ficava travada.
2370 2424
2371### Há um problema com o modelo selecionado2425### There's an issue with the selected model
2372 2426
2373O nome do modelo configurado não foi reconhecido ou sua conta não tem acesso a ele. A partir da v2.1.160, a dica à direita, mostrada aqui em sua forma interativa, varia por superfície.2427O nome de modelo configurado não foi reconhecido ou sua conta não tem acesso a ele. A partir da v2.1.160, a dica final, mostrada aqui em sua forma interativa, varia conforme a superfície.
2374 2428
2375```text theme={null}2429```text theme={null}
2376There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.2430There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.
2378 2432
2379**O que fazer:**2433**O que fazer:**
2380 2434
2381* **CLI interativa**: execute `/model` para escolher entre modelos disponíveis para sua conta.2435* **CLI interativa**: execute `/model` para escolher entre os modelos disponíveis para sua conta.
2382* **Modo não interativo (`-p`)**: passe `--model` com um alias ou ID válido, ou defina [`ANTHROPIC_MODEL`](/docs/pt/env-vars). O texto de erro mostra `Run --model` nessa superfície.2436* **Modo não interativo (`-p`)**: passe `--model` com um alias ou ID válido, ou defina [`ANTHROPIC_MODEL`](/docs/pt/env-vars). O texto do erro mostra `Run --model` nessa superfície.
2383* **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 sua própria nova tentativa ou seletor de modelo.2437* **Agent SDK**: o texto do 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 sua própria nova tentativa ou seletor de modelo.
2384* 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 [Configuração de modelo](/docs/pt/model-config).2438* Use um alias como `sonnet` ou `opus` em vez de um ID completo com versão. Os aliases resolvem para um padrão mantido, então não ficam desatualizados. Consulte [Configuração de modelo](/docs/pt/model-config).
2385* Se o modelo errado continuar 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.2439* Se o modelo errado continuar voltando na CLI, um ID desatualizado 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 desatualizado.
2386* Claude Code relata um login claude.ai expirado como [Login expirado](#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.2440* O Claude Code informa um login do 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 renovado fazia todos os modelos falharem com esse erro; execute `/login` se você vir isso em uma versão mais antiga.
2387* Para implantações do Google Cloud's Agent Platform, veja [Solução de problemas do Google Cloud's Agent Platform](/docs/pt/google-vertex-ai#troubleshooting).2441* Se [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) apontar para um [gateway de LLM](/docs/pt/llm-gateway) e todos os modelos falharem dessa forma, verifique se o seu gateway está rejeitando os campos de busca de ferramentas que o Claude Code envia por padrão. Para verificar, defina `ENABLE_TOOL_SEARCH=false` conforme descrito em [Busca de ferramentas por meio de um gateway de LLM](/docs/pt/mcp#tool-search-through-a-gateway) e tente novamente. Antes da v2.1.304, a busca de ferramentas ficava desativada atrás de um gateway, a menos que você a ativasse com `ENABLE_TOOL_SEARCH`.
2442* Para implantações no Agent Platform do Google Cloud, consulte [Solução de problemas do Agent Platform do Google Cloud](/docs/pt/google-vertex-ai#troubleshooting).
2388 2443
2389### Modelo não é um ID de modelo reconhecido2444### Model is not a recognized model id
2390 2445
2391A string que você passou para uma mudança de modelo não é uma que Claude Code possa usar como modelo, então ele recusou a mudança sem enviar uma requisição e a sessão mantém seu modelo atual. Você pode obter esse erro quando um modelo é definido através do método [Agent SDK](/docs/pt/agent-sdk/typescript) `setModel()`, por um aplicativo que executa a CLI do Claude Code para você, como o [Aplicativo Desktop](/docs/pt/desktop), ou quando você escolhe um modelo de um dispositivo conectado através de [Remote Control](/docs/pt/remote-control). Antes da v2.1.200, Claude Code salvava a string e falhava na próxima requisição com [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model).2446A string que você passou para uma troca de modelo não é uma que o Claude Code possa usar como modelo, então ele recusou a troca sem enviar uma requisição e a sessão mantém seu modelo atual. Você pode receber esse erro quando um modelo é definido pelo método `setModel()` do [Agent SDK](/docs/pt/agent-sdk/typescript), por um aplicativo que executa a CLI do Claude Code para você, como o [aplicativo Desktop](/docs/pt/desktop), ou quando você escolhe um modelo a partir de um dispositivo conectado por meio do [Remote Control](/docs/pt/remote-control). Antes da v2.1.200, o Claude Code salvava a string e falhava na próxima requisição com [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).
2392 2447
2393```text theme={null}2448```text theme={null}
2394Model "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?2449Model "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?
2395```2450```
2396 2451
2397Neste exemplo, um aplicativo enviou o nome de exibição `Sonnet 5`, que a mensagem repete sem seu espaço. A dica à direita nomeia o alias ou ID de modelo mais próximo. Quando nada é próximo o suficiente, lê `Run /model to see available models.` Em uma sessão que o [Aplicativo Desktop](/docs/pt/desktop) inicia para você, a dica sem correspondência lê `Switch to a different model.`2452Neste exemplo, um aplicativo enviou o nome de exibição `Sonnet 5`, que a mensagem repete sem o espaço. A dica final nomeia o alias ou ID de modelo mais próximo. Quando nada é próximo o suficiente, ela diz `Run /model to see available models.` em vez disso. Em uma sessão que o [aplicativo Desktop](/docs/pt/desktop) inicia para você, a dica sem correspondência diz `Switch to a different model.`
2398 2453
2399Quando você muda através do Agent SDK ou um aplicativo na API Anthropic, apenas uma string que não pode ser um ID de modelo obtém esse erro, como um nome de exibição ou uma string vazia.2454Quando você troca pelo Agent SDK ou por um aplicativo na Anthropic API, apenas uma string que não pode ser um ID de modelo recebe esse erro, como um nome de exibição ou uma string vazia.
2400 2455
2401Quando você escolhe um modelo de um dispositivo Remote Control, Claude Code verifica a string localmente. Qualquer string que não seja um alias de modelo, um modelo que Claude Code lista ou você configurou, ou um ID que começa com `claude-` obtém esse erro, um ID digitado incorretamente como `claud-sonnet-5` incluído. Antes da v2.1.260, essa verificação não cobria escolhas de Remote Control, então uma string não reconhecida era aplicada e falhava na próxima requisição.2456Quando você escolhe um modelo a partir de um dispositivo do Remote Control, o Claude Code verifica a string localmente. Qualquer string que não seja um alias de modelo, um modelo que o Claude Code lista ou que você configurou, ou um ID que começa com `claude-` recebe esse erro, incluindo um ID digitado errado como `claud-sonnet-5`. Antes da v2.1.260, essa verificação não cobria escolhas feitas pelo Remote Control, então uma string não reconhecida era aplicada e falhava na próxima requisição.
2402 2457
2403**O que fazer:**2458**O que fazer:**
2404 2459
2405* Execute `/model` sem argumento para abrir o seletor e escolher entre os modelos disponíveis para sua conta, depois passe o alias ou ID mostrado lá2460* Execute `/model` sem argumento para abrir o seletor e escolher entre os modelos disponíveis para sua conta, depois passe o alias ou ID mostrado ali
2406* Se você usou um alias que apenas uma versão mais nova do Claude Code suporta, execute `claude update`, ou passe o ID completo do modelo. O servidor ainda pode exigir uma versão mínima do Claude Code para esse modelo; veja [Claude Code não suporta este modelo](#claude-code-does-not-support-this-model).2461* Se você usou um alias que só uma versão mais recente do Claude Code suporta, execute `claude update`, ou passe o ID completo do modelo. O servidor ainda pode exigir uma versão mínima do Claude Code para esse modelo; consulte [Claude Code does not support this model](#claude-code-does-not-support-this-model).
2407* Um modelo salvo antes da v2.1.200 não é reparado por essa verificação. Se um valor obsoleto continua voltando, remova-o dos locais listados em [Definindo seu modelo](/docs/pt/model-config#setting-your-model).2462* Um modelo salvo antes da v2.1.200 não é corrigido por essa verificação. Se um valor desatualizado continuar voltando, remova-o dos locais listados em [Definir seu modelo](/docs/pt/model-config#setting-your-model).
2408* Em qualquer provedor diferente da API Anthropic, ou atrás de um gateway ou `ANTHROPIC_BASE_URL` customizado, apenas uma string vazia obtém esse erro. Claude Code ainda pode escrever a [linha de diagnóstico de modelo não reconhecido](#unrecognized-model-id-on-a-request) no momento da requisição, em cada provedor.2463* Em qualquer provedor que não seja a Anthropic API, ou por trás de um gateway ou de um `ANTHROPIC_BASE_URL` personalizado, apenas uma string vazia recebe esse erro. O Claude Code ainda pode gravar a [linha de diagnóstico de modelo não reconhecido](#unrecognized-model-id-on-a-request) no momento da requisição, em todos os provedores.
2409 2464
2410### Modelo não encontrado2465### Model not found
2411 2466
2412Você mudou para um modelo por nome e Claude Code não conseguiu confirmar que um modelo com esse nome existe. Quando o nome não é um [alias de modelo](/docs/pt/model-config#model-aliases) ou outra ortografia que Claude Code aceita localmente, Claude Code o verifica com uma requisição mínima de API, e esse erro é geralmente a resposta do seu endpoint de API. Com `/model <name>`, um nome que não pode ser um ID de modelo, como um contendo espaços, obtém a mesma mensagem.2467Você trocou para um modelo pelo nome e o Claude Code não conseguiu confirmar que existe um modelo com esse nome. Quando o nome não é um [alias de modelo](/docs/pt/model-config#model-aliases) ou outra grafia que o Claude Code aceita localmente, o Claude Code o verifica com uma requisição mínima à API, e esse erro geralmente é a resposta do seu endpoint de API. Com `/model <name>`, um nome que não pode ser um ID de modelo de forma alguma, como um que contenha espaços, recebe a mesma mensagem.
2413 2468
2414```text theme={null}2469```text theme={null}
2415Model 'claude-opus-9' not found2470Model 'claude-opus-9' not found
2420**O que fazer:**2475**O que fazer:**
2421 2476
2422* Execute `/model` sem argumento e escolha entre os modelos disponíveis para sua conta, ou use um [alias de modelo](/docs/pt/model-config#model-aliases) como `sonnet`, que resolve para um padrão mantido2477* Execute `/model` sem argumento e escolha entre os modelos disponíveis para sua conta, ou use um [alias de modelo](/docs/pt/model-config#model-aliases) como `sonnet`, que resolve para um padrão mantido
2423* 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.2478* Se você digitou um ID completo, confira-o no catálogo de modelos do seu provedor. Um modelo recém-lançado pode estar disponível na Anthropic API antes que seu provedor ou sua região o ofereça.
2424* No Agent SDK, `setModel()` falha com essa mensagem e a sessão continua executando em seu modelo anterior. No SDK TypeScript, chame [`supportedModels()`](/docs/pt/agent-sdk/typescript#query-object) para listar os modelos para os quais você pode mudar.2479* No Agent SDK, `setModel()` falha com essa mensagem e a sessão continua em execução no modelo anterior. No SDK TypeScript, chame [`supportedModels()`](/docs/pt/agent-sdk/typescript#query-object) para listar os modelos para os quais você pode trocar.
2425* 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 [configurações](/docs/pt/model-config#setting-your-model) ou com `--model`.2480* Antes da v2.1.265, `/model` também rejeitava a grafia de alias `opusplan[1m]` com esse erro. Nessas versões, atualize o Claude Code, ou defina o modelo nas [configurações](/docs/pt/model-config#setting-your-model) ou com `--model`.
2426 2481
2427### Não foi possível confirmar o modelo com a API2482### Couldn't confirm model with the API
2428 2483
2429Você mudou de modelos através do método [Agent SDK](/docs/pt/agent-sdk/typescript) `setModel()` ou um aplicativo que executa a CLI do Claude Code para você, como o [Aplicativo Desktop](/docs/pt/desktop), e a requisição que confirma o ID do modelo com seu endpoint de API não obteve resposta em cinco segundos. A sessão mantém seu modelo atual.2484Você trocou de modelo pelo método `setModel()` do [Agent SDK](/docs/pt/agent-sdk/typescript) ou por um aplicativo que executa a CLI do Claude Code para você, como o [aplicativo Desktop](/docs/pt/desktop), e a requisição que confirma o ID do modelo com seu endpoint de API não recebeu resposta em cinco segundos. A sessão mantém seu modelo atual.
2430 2485
2431```text theme={null}2486```text theme={null}
2432Couldn't confirm model "claude-sonnet-5" with the API. Try again, or run /model to see available models.2487Couldn't confirm model "claude-sonnet-5" with the API. Try again, or run /model to see available models.
2433```2488```
2434 2489
2435Em uma sessão que o [Aplicativo Desktop](/docs/pt/desktop) inicia para você, a mensagem termina em `Try again.`2490Em uma sessão que o [aplicativo Desktop](/docs/pt/desktop) inicia para você, a mensagem termina em `Try again.`
2436 2491
2437**O que fazer:**2492**O que fazer:**
2438 2493
2439* Mude para o modelo novamente2494* Troque para o modelo novamente
2440* Se a mudança continuar falhando, verifique se Claude Code pode alcançar seu endpoint de API; veja [Erros de rede e conexão](#network-and-connection-errors)2495* Se a troca continuar falhando, verifique se o Claude Code consegue alcançar seu endpoint de API; consulte [Erros de rede e de conexão](#network-and-connection-errors)
2441 2496
2442### Erro de API ao verificar o modelo escolhido2497### Erro de API ao verificar o modelo escolhido
2443 2498
2444Você escolheu um modelo com `/model <name>`, ou um aplicativo conectado à sessão solicitou a mudança. A API recusou a requisição mínima que Claude Code envia para verificar o modelo, por um motivo que não tem entrada própria, como um rate limit ou um erro de servidor. A sessão mantém seu modelo atual, e a mensagem termina dizendo:2499Você escolheu um modelo com `/model <name>`, ou um aplicativo conectado à sessão solicitou a troca. A API recusou a requisição mínima que o Claude Code envia para verificar o modelo, por um motivo que não tem uma entrada própria, como um rate limit ou um erro do servidor. A sessão mantém seu modelo atual, e a mensagem termina dizendo isso:
2445 2500
2446```text theme={null}2501```text theme={null}
2447API error: 429 <the server's explanation> · model not changed2502API error: 429 <the server's explanation> · model not changed
2448```2503```
2449 2504
2450O meio da mensagem é o status HTTP e a própria explicação do servidor.2505O meio da mensagem é o status HTTP e a explicação do próprio servidor.
2451 2506
2452**O que fazer:**2507**O que fazer:**
2453 2508
2454* Aja sobre a explicação do servidor; para um rate limit ou um status 5xx, aguarde e escolha o modelo novamente2509* Aja de acordo com a explicação do servidor; para um rate limit ou um status 5xx, aguarde e escolha o modelo novamente
2455* As recusas com sua própria redação são cobertas pelas entradas ao redor, como [Modelo não encontrado](#model-not-found) e [Modelo é restringido pelas configurações de sua organização](#model-is-restricted-by-your-organizations-settings)2510* As recusas com texto próprio são cobertas pelas entradas ao redor, como [Model not found](#model-not-found) e [Model is restricted by your organization's settings](#model-is-restricted-by-your-organizations-settings)
2456 2511
2457### Claude Opus não está disponível com o plano Claude Pro2512### Claude Opus is not available with the Claude Pro plan
2458 2513
2459Seu plano de assinatura ativo não inclui o modelo que você selecionou.2514Seu plano de assinatura ativo não inclui o modelo que você selecionou.
2460 2515
2462Claude 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.2517Claude 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.
2463```2518```
2464 2519
2465Em 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.2520Em uma sessão executada pelo aplicativo Claude Desktop, a mensagem diz `sign out and sign in again` em vez de nomear os comandos.
2466 2521
2467**O que fazer:**2522**O que fazer:**
2468 2523
2469* Execute `/model` e selecione um modelo que seu plano inclui2524* Execute `/model` e selecione um modelo que seu plano inclua
2470* Se você atualizou seu plano recentemente e ainda vê isso, execute `/logout` e depois `/login`. O token armazenado reflete seu plano no momento em que você se autenticou, então atualizar em claude.ai não entra em vigor em uma sessão existente até você se autenticar novamente.2525* Se você fez upgrade do seu plano recentemente e ainda vê isso, execute `/logout` e depois `/login`. O token armazenado reflete seu plano no momento em que você entrou, então um upgrade no claude.ai não tem efeito em uma sessão existente até que você se autentique novamente.
2471* Veja [claude.com/pricing](https://claude.com/pricing) para quais modelos cada plano inclui2526* Consulte [claude.com/pricing](https://claude.com/pricing) para saber quais modelos cada plano inclui
2472 2527
2473### Claude Code não suporta este modelo2528### Claude Code does not support this model
2474 2529
2475A API recusou a requisição com um 400 porque sua versão do Claude Code está abaixo de um mínimo necessário. Ou o modelo que você selecionou requer uma versão mais nova, que o servidor verifica por modelo, ou a política de sua organização requer uma. O 400 carrega o código de erro `claude_code_version_too_old`, e a mensagem diz qual mínimo se aplica.2530A API recusou a requisição com um 400 porque sua versão do Claude Code está abaixo de um mínimo exigido. Ou o modelo que você selecionou exige uma versão mais recente, o que o servidor verifica por modelo, ou a política da sua organização exige uma. O 400 traz o código de erro `claude_code_version_too_old`, e a mensagem diz qual mínimo se aplica.
2476 2531
2477```text theme={null}2532```text theme={null}
2478API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.2533API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.
2479```2534```
2480 2535
2481A redação da política organizacional lê:2536O texto da política da organização diz:
2482 2537
2483```text theme={null}2538```text theme={null}
2484API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.2539API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.
2485```2540```
2486 2541
2487A versão que a API verifica é a relatada pelo binário Claude Code que fez a requisição.2542A versão que a API verifica é a informada pelo binário do Claude Code que fez a requisição.
2488 2543
2489**O que fazer:**2544**O que fazer:**
2490 2545
2491Atualize esse binário e inicie uma nova sessão. De onde o binário veio decide como, exceto em um [ambiente auto-hospedado](/docs/pt/self-hosted-environments-deploy#pin-the-version):2546Atualize esse binário e depois inicie uma nova sessão. A origem do binário determina como, exceto em um [ambiente auto-hospedado](/docs/pt/self-hosted-environments-deploy#pin-the-version):
2492 2547
2493| O binário que fez a requisição | Como atualizá-lo |2548| O binário que fez a requisição | Como atualizá-lo |
2494| :- | :- |2549| :- | :- |
2495| Um Claude Code que você instalou | Execute `claude update` |2550| Um Claude Code que você instalou | Execute `claude update` |
2496| O aplicativo Claude desktop | Atualize o aplicativo |2551| O aplicativo Claude desktop | Atualize o aplicativo |
2497| O binário que a [extensão VS Code](/docs/pt/vs-code) agrupa | Atualize a extensão |2552| O binário incluído na [extensão do VS Code](/docs/pt/vs-code) | Atualize a extensão |
2498| O binário que um pacote Agent SDK agrupa | [Atualize o pacote SDK](/docs/pt/agent-sdk/hosting#runtime-dependencies), depois reinicie seu aplicativo. Em um [executável de arquivo único compilado](/docs/pt/agent-sdk/typescript#compile-to-a-single-executable), reconstrua-o |2553| O binário incluído em um pacote do Agent SDK | [Atualize o pacote do SDK](/docs/pt/agent-sdk/hosting#runtime-dependencies) e depois reinicie sua aplicação. Em um [executável compilado de arquivo único](/docs/pt/agent-sdk/typescript#compile-to-a-single-executable), recompile-o |
2499 2554
2500* Se você executar `claude update` no [canal de lançamento estável](/docs/pt/setup#configure-release-channel), ele não o leva além da versão estável mais recente, que ainda pode estar abaixo do mínimo necessário. Mude para o canal latest e atualize novamente. Se sua organização fixa seu canal ou versão através de [configurações gerenciadas](/docs/pt/managed-settings), peça ao seu administrador para alterá-lo2555* Se você executar `claude update` no [canal de lançamento stable](/docs/pt/setup#configure-release-channel), ele não o leva além da versão stable mais recente, que ainda pode estar abaixo do mínimo exigido. Mude para o canal latest e atualize novamente. Se sua organização fixa seu canal ou sua versão por meio de [configurações gerenciadas](/docs/pt/managed-settings), peça ao seu administrador que altere isso
2501* Para a redação por modelo, você pode continuar trabalhando na sessão atual mudando para outro modelo: execute `/model` na CLI, chame [`setModel()`](/docs/pt/agent-sdk/typescript#query-object) no objeto `Query` do SDK TypeScript em modo de entrada de streaming, ou chame [`set_model()`](/docs/pt/agent-sdk/python#claudesdkclient) no `ClaudeSDKClient` do SDK Python2556* Para o texto por modelo, você pode continuar trabalhando na sessão atual trocando para outro modelo: execute `/model` na CLI, chame [`setModel()`](/docs/pt/agent-sdk/typescript#query-object) no objeto `Query` do SDK TypeScript no modo de entrada por streaming, ou chame [`set_model()`](/docs/pt/agent-sdk/python#claudesdkclient) no `ClaudeSDKClient` do SDK Python
2502* Para a redação da política organizacional, atualize antes de continuar2557* Para o texto da política da organização, atualize antes de continuar
2503 2558
2504### Modelo é restringido pelas configurações de sua organização2559### Model is restricted by your organization's settings
2505 2560
2506Seu administrador de organização desabilitou este modelo no console de administração claude.ai, ou configurações gerenciadas o excluem através de uma allowlist [`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. Se as configurações gerenciadas não deixarem nenhum modelo permitido para a sessão usar, veja [Configurações gerenciadas bloqueiam o modelo padrão](#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á executando no console de administração claude.ai.2561O administrador da sua organização desativou esse modelo no console de administração do claude.ai, ou as configurações gerenciadas o excluem por meio de uma allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) ou de 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 restrito, e ele nomeia o modelo que a sessão usa no lugar. Se as configurações gerenciadas não deixarem nenhum modelo permitido para a sessão usar, consulte [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 depois que um administrador desativa, no console de administração do claude.ai, o modelo em que uma sessão está sendo executada.
2507 2562
2508```text theme={null}2563```text theme={null}
2509Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.2564Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
2510```2565```
2511 2566
2512Digitar `/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.`2567Digitar `/model <name>` para um modelo restrito é rejeitado e a sessão mantém seu modelo atual. Para um modelo desativado no console de administração, a rejeição diz `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, ela diz `Model '<name>' is not available. Your organization restricts model selection.`
2513 2568
2514Um aviso prefixado com um nome de agente, skill ou comando significa que a restrição se aplicou ao [modelo solicitado do subagente](/docs/pt/sub-agents#choose-a-model): o subagente executa no modelo substituído e o modelo de sua sessão não muda. Antes da v2.1.223, Claude Code mostrava o aviso apenas para subagentes lançados com a ferramenta Agent.2569Um aviso prefixado com o nome de um agente, skill ou comando significa que a restrição se aplicou ao [modelo solicitado por esse subagente](/docs/pt/sub-agents#choose-a-model): o subagente é executado no modelo substituto e o modelo da sua sessão não muda. Antes da v2.1.223, o Claude Code mostrava o aviso apenas para subagentes iniciados com a ferramenta Agent.
2515 2570
2516Claude 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 as configurações de sua organização 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.2571O Claude Code trata um alias de família de modelos, um entre `opus`, `sonnet`, `haiku` ou `fable`, como uma solicitação para essa família, e não para sua versão mais recente. Na Anthropic API e no [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), um alias de família restrito resolve para a versão mais recente da família que as configurações da sua organização permitem, e o aviso de substituição nomeia essa versão. O Claude Code rejeita `/model <alias>` apenas quando todas as versões da família estão restritas. Antes da v2.1.205, um alias de família era substituído ou rejeitado com base apenas em sua versão mais recente, mesmo quando uma versão mais antiga da mesma família era permitida.
2517 2572
2518**O que fazer:**2573**O que fazer:**
2519 2574
2520* Execute `/model` para escolher entre os modelos que sua organização permite. Modelos restringidos estão ocultos do seletor.2575* Execute `/model` para escolher entre os modelos que sua organização permite. Modelos restritos ficam ocultos no seletor.
2521* Se o modelo restringido foi definido em `--model`, `ANTHROPIC_MODEL`, o campo `model` de um arquivo de configurações ou o frontmatter `model` de um [subagente](/docs/pt/sub-agents#choose-a-model), skill ou comando, remova ou atualize esse valor para que o aviso não recorra2576* Se o modelo restrito foi definido em `--model`, `ANTHROPIC_MODEL`, no campo `model` de um arquivo de configurações, ou no frontmatter `model` de um [subagente](/docs/pt/sub-agents#choose-a-model), skill ou comando, remova ou atualize esse valor para que o aviso não se repita
2522* Se você precisar de acesso ao modelo restringido, peça ao administrador de sua organização para habilitá-lo. Veja [Restrições de modelo da organização](/docs/pt/model-config#organization-model-restrictions).2577* Se você precisar de acesso ao modelo restrito, peça ao administrador da sua organização que o ative. Consulte [Restrições de modelo da organização](/docs/pt/model-config#organization-model-restrictions).
2523 2578
2524### Não foi possível mudar para o modelo padrão2579### Can't switch to the default model
2525 2580
2526Você escolheu o modelo Padrão, por exemplo selecionando a linha Padrão no seletor `/model` ou digitando `/model default`. Claude Code recusou a mudança, então a sessão mantém seu modelo atual.2581Você escolheu o modelo Default, por exemplo selecionando a linha Default no seletor `/model` ou digitando `/model default`. O Claude Code recusou a troca, então a sessão mantém seu modelo atual.
2527 2582
2528```text theme={null}2583```text theme={null}
2529Can't switch to the default model: your organization's managed settings block it (claude-opus-4-6) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".2584Can't switch to the default model: your organization's managed settings block it (claude-opus-4-6) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".
2530```2585```
2531 2586
2532A redação após os dois pontos nomeia o que bloqueou a mudança:2587O texto após os dois-pontos indica o que bloqueou a troca:
2533 2588
2534* **`your organization's managed settings block it ... in "deniedModels"`**: uma lista de negação gerenciada bloqueia o modelo para o qual a opção Padrão resolve2589* **`your organization's managed settings block it ... in "deniedModels"`**: uma lista de bloqueio gerenciada bloqueia o modelo para o qual a opção Default resolve
2535* **`your organization allows only the models listed in "availableModels"`**: uma allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) gerenciada com [`availableModelsMatch`](/docs/pt/settings-reference#availablemodelsmatch) definida como `"exact"` deixa de fora o modelo para o qual a opção Padrão resolve2590* **`your organization allows only the models listed in "availableModels"`**: uma allowlist gerenciada [`availableModels`](/docs/pt/model-config#restrict-model-selection) com [`availableModelsMatch`](/docs/pt/settings-reference#availablemodelsmatch) definida como `"exact"` deixa de fora o modelo para o qual a opção Default resolve
2536* **`Claude Code couldn't read your organization's managed settings to check which models they allow`**: as [configurações gerenciadas](/docs/pt/managed-settings) não puderam ser lidas, e Claude Code recusa a mudança em vez de aplicá-la sem verificação2591* **`Claude Code couldn't read your organization's managed settings to check which models they allow`**: as [configurações gerenciadas](/docs/pt/managed-settings) não puderam ser lidas, e o Claude Code recusa a troca em vez de aplicá-la sem verificação
2537 2592
2538**O que fazer:**2593**O que fazer:**
2539 2594
2540* Para as redações [`deniedModels`](/docs/pt/settings-reference#deniedmodels) e `availableModels`, execute `/model` e escolha um modelo que sua organização permite por nome2595* Para os textos sobre [`deniedModels`](/docs/pt/settings-reference#deniedmodels) e `availableModels`, execute `/model` e escolha pelo nome um modelo que sua organização permite
2541* Peça ao seu administrador para atualizar a configuração gerenciada que a mensagem nomeia2596* Peça ao seu administrador que atualize a configuração gerenciada que a mensagem nomeia
2542* Para a redação `couldn't read`, reinicie Claude Code; se continuar acontecendo, peça ao seu administrador para verificar as configurações gerenciadas2597* Para o texto `couldn't read`, reinicie o Claude Code; se continuar acontecendo, peça ao seu administrador que verifique as configurações gerenciadas
2543 2598
2544Se uma sessão em vez disso falhar ao iniciar com uma mensagem `Claude Code can't start` sob essas configurações gerenciadas, veja [Configurações gerenciadas bloqueiam o modelo padrão](#managed-settings-block-the-default-model).2599Se, em vez disso, uma sessão não conseguir iniciar com uma mensagem `Claude Code can't start` sob essas configurações gerenciadas, consulte [Managed settings block the default model](#managed-settings-block-the-default-model).
2545 2600
2546### A mudança de modelo foi bloqueada por um hook PreModelSwitch2601### Model switch was blocked by a PreModelSwitch hook
2547 2602
2548Um [hook PreModelSwitch](/docs/pt/hooks#premodelswitch) não aprovou a mudança de modelo que você ou um cliente solicitou, então a sessão mantém seu modelo atual. Quando a mudança veio de um host [Agent SDK](/docs/pt/agent-sdk/overview) ou [Remote Control](/docs/pt/remote-control) em vez de um comando que você digitou, a mensagem lê `Model switch blocked by a PreModelSwitch hook` sem nomear o modelo de destino.2603Um [hook PreModelSwitch](/docs/pt/hooks#premodelswitch) não aprovou a troca de modelo que você ou um cliente solicitou, então a sessão mantém seu modelo atual. Quando a troca veio de um host do [Agent SDK](/docs/pt/agent-sdk/overview) ou do [Remote Control](/docs/pt/remote-control) em vez de um comando que você digitou, a mensagem diz `Model switch blocked by a PreModelSwitch hook` sem nomear o modelo de destino.
2549 2604
2550```text theme={null}2605```text theme={null}
2551Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.2606Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.
2552```2607```
2553 2608
2554A razão após os dois pontos diz o que recusou a mudança:2609O motivo após os dois-pontos indica o que recusou a troca:
2555 2610
2556* **Uma razão que um hook escreveu**: um hook PreModelSwitch forneceu essa razão quando [negou a mudança ou pediu confirmação](/docs/pt/hooks#premodelswitch-decision-control). Aborde o que ele pede, ou escolha um modelo que seus hooks permitem.2611* **Um motivo escrito por um hook**: um hook PreModelSwitch forneceu esse motivo ao [negar a troca ou pedir confirmação](/docs/pt/hooks#premodelswitch-decision-control). Resolva o que ele pede, ou escolha um modelo que seus hooks permitam.
2557* **`PreModelSwitch hook <name> did not respond before its timeout`**: um hook que não responde antes de seu [timeout](/docs/pt/hooks#timeouts) bloqueia a mudança. Corrija o comando pendurado ou aumente o `timeout` desse hook, depois mude novamente.2612* **`PreModelSwitch hook <name> did not respond before its timeout`**: um hook que não responde antes do seu [timeout](/docs/pt/hooks#timeouts) bloqueia a troca. Corrija o comando travado ou aumente o `timeout` desse hook e depois troque novamente.
2558* **`confirmation required, and this session cannot ask`**: um hook respondeu `ask` sem uma razão, e uma requisição de controle não tem forma de mostrar o prompt de confirmação. Um comando `/model` em uma [execução `-p`](/docs/pt/headless) relata a mesma condição com `(run /model interactively to confirm)` após a razão. Faça a mudança de uma sessão interativa, ou mude a decisão do hook para este modelo.2613* **`confirmation required, and this session cannot ask`**: um hook respondeu `ask` sem um motivo, e uma requisição de controle não tem como mostrar o prompt de confirmação. Um comando `/model` em uma [execução `-p`](/docs/pt/headless) informa a mesma condição com `(run /model interactively to confirm)` após o motivo. Faça a troca a partir de uma sessão interativa, ou altere a decisão do hook para esse modelo.
2559* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code não conseguiu dizer quais hooks PreModelSwitch seus [plugins gerenciados](/docs/pt/settings-reference#enabledplugins) da organização entregam, por exemplo porque um plugin gerenciado falhou ao carregar. Um desses hooks pode bloquear a mudança, então Claude Code recusa em vez de aplicar a mudança sem verificação. O início da razão nomeia o que falhou. Claude Code re-verifica a cada tentativa de mudança, então uma falha que desde então foi limpa para de bloquear; se continuar falhando, execute `claude --debug` e mude novamente para capturar os detalhes, depois corrija o plugin ou peça ao seu administrador para corrigi-lo.2614* **`so organization-managed PreModelSwitch hooks could not be checked`**: o Claude Code não conseguiu determinar quais hooks PreModelSwitch os [plugins gerenciados](/docs/pt/settings-reference#enabledplugins) da sua organização fornecem, por exemplo porque um plugin gerenciado falhou ao carregar. Um desses hooks poderia bloquear a troca, então o Claude Code recusa em vez de aplicar a troca sem verificação. O início do motivo nomeia o que falhou. O Claude Code verifica novamente a cada tentativa de troca, então uma falha que já foi resolvida deixa de bloquear; se continuar falhando, execute `claude --debug` e troque novamente para capturar os detalhes, depois corrija o plugin ou peça ao seu administrador que o corrija.
2560* **`a PreModelSwitch hook failed before answering`** ou **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: a execução do hook terminou sem um veredicto, e Claude Code não trata isso como aprovação. Execute `claude --debug` para ver o que falhou, depois mude novamente.2615* **`a PreModelSwitch hook failed before answering`** ou **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: a execução do hook terminou sem um veredito, e o Claude Code não trata isso como aprovação. Execute `claude --debug` para ver o que falhou e depois troque novamente.
2561 2616
2562Antes da v2.1.260, a recusa de plugin gerenciado lia `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code tentou novamente o carregamento do plugin uma vez e depois recusou mudanças posteriores na sessão, mesmo quando sua organização não gerenciava plugins. Reinicie a sessão para executar o carregamento do plugin novamente nessas versões.2617Antes da v2.1.260, a recusa por plugin gerenciado dizia `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. O Claude Code tentava carregar o plugin novamente uma vez e depois recusava as trocas seguintes na sessão, mesmo quando sua organização não gerenciava nenhum plugin. Nessas versões, reinicie a sessão para executar o carregamento do plugin novamente.
2563 2618
2564### Não foi possível salvá-lo como seu padrão2619### Couldn't save it as your default
2565 2620
2566Você escolheu um modelo para salvar como seu padrão, por exemplo com `/model <name>` ou `Enter` no seletor `/model`, e Claude Code não conseguiu escrever a escolha em seu arquivo de configurações de usuário, `~/.claude/settings.json`. A mudança em si foi aplicada, então a sessão atual executa no modelo que você escolheu, mas seu padrão não muda e a próxima sessão começa no valor antigo.2621Você escolheu um modelo para salvar como padrão, por exemplo com `/model <name>` ou `Enter` no seletor `/model`, e o Claude Code não conseguiu gravar a escolha no seu arquivo de configurações de usuário, `~/.claude/settings.json`. A troca em si foi aplicada, então a sessão atual é executada no modelo que você escolheu, mas seu padrão não mudou e a próxima sessão começa com o valor antigo.
2567 2622
2568```text theme={null}2623```text theme={null}
2569Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)2624Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)
2570```2625```
2571 2626
2572A razão após o caminho do arquivo diz o que falhou:2627O motivo após o caminho do arquivo indica o que falhou:
2573 2628
2574* **`can't be written (<code>)`**: a escrita falhou com o código de erro do sistema operacional entre parênteses, como `EROFS` quando o arquivo, ou o arquivo para o qual ele aponta, fica em um sistema de arquivos que recusa escritas. Torne o arquivo gravável e mude novamente. Se outra ferramenta gera o arquivo, defina a chave `model` nessa ferramenta; veja [Uma mudança que você fez no Claude Code é perdida em novas sessões](/docs/pt/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).2629* **`can't be written (<code>)`**: a gravação falhou com o código de erro do sistema operacional entre parênteses, como `EROFS` quando o arquivo, ou o arquivo para o qual ele aponta, está em um sistema de arquivos que recusa gravações. Torne o arquivo gravável e troque novamente. Se outra ferramenta gera o arquivo, defina a chave `model` nessa ferramenta; consulte [A change you made in Claude Code is lost in new sessions](/docs/pt/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).
2575* **`isn't valid JSON`**: o arquivo no disco não analisa, e Claude Code o deixa intocado em vez de sobrescrever conteúdo que não consegue ler de volta. Corrija o erro de sintaxe, depois mude novamente; veja [Corrija um arquivo de configurações quebrado](/docs/pt/settings#fix-a-broken-settings-file).2630* **`isn't valid JSON`**: o arquivo no disco não pode ser analisado, e o Claude Code o deixa intacto em vez de sobrescrever um conteúdo que não consegue ler de volta. Corrija o erro de sintaxe e depois troque novamente; consulte [Corrigir um arquivo de configurações quebrado](/docs/pt/settings#fix-a-broken-settings-file).
2576 2631
2577Um aviso terminando `couldn't confirm it was saved as your default (~/.claude/settings.json is still being written)` significa que a escrita não havia terminado após três segundos. Continua em segundo plano, então o padrão ainda pode ser salvo; verifique qual modelo sua próxima sessão começa, ou execute `/model <name>` novamente.2632Um aviso que termina com `couldn't confirm it was saved as your default (~/.claude/settings.json is still being written)` significa que a gravação não tinha terminado após três segundos. Ela continua em segundo plano, então o padrão ainda pode ser salvo; verifique em qual modelo sua próxima sessão começa, ou execute `/model <name>` novamente.
2578 2633
2579Antes da v2.1.265, o aviso dizia que o modelo era `saved as your default for new sessions` mesmo quando a escrita falhava.2634Antes da v2.1.265, o aviso dizia que o modelo foi `saved as your default for new sessions` mesmo quando a gravação falhava.
2580 2635
2581### Advisor é menos capaz que o modelo principal atual2636### Advisor is less capable than the current main model
2582 2637
2583Seu [modelo advisor](/docs/pt/advisor) tem classificação inferior ao modelo principal da sua sessão, então Claude Code mantém a seleção, mas não anexa o advisor às requisições do modelo principal.2638Seu [modelo advisor](/docs/pt/advisor) tem classificação inferior ao modelo principal da sua sessão, então o Claude Code mantém a seleção, mas não anexa o advisor às requisições do modelo principal.
2584 2639
2585```text theme={null}2640```text theme={null}
2586Advisor set to Opus 4.82641Advisor set to Opus 4.8
2587Note: Opus 4.8 is less capable than the current main model (Sonnet 5.5), so the advisor will not activate. Choose a more capable advisor, or switch to a smaller main model.2642Note: Opus 4.8 is less capable than the current main model (Sonnet 5.5), so the advisor will not activate. Choose a more capable advisor, or switch to a smaller main model.
2588```2643```
2589 2644
2590Outras mensagens relatam a mesma condição:2645Outras mensagens informam a mesma condição:
2591 2646
2592* Em uma sessão interativa, uma notificação lê `Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor`.2647* Em uma sessão interativa, uma notificação diz `Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor`.
2593* Na inicialização com a flag `--advisor`, um aviso lê `"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.` e a sessão inicia mesmo assim.2648* Quando você inicia com a flag `--advisor` no [modo não interativo](/docs/pt/headless), e a execução não é uma [sessão em segundo plano](/docs/pt/agent-view), um aviso vai para o stderr e a execução começa mesmo assim. Ele diz `"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.` Uma sessão interativa grava esse aviso apenas no [log de depuração](#configuration-warnings).
2594 2649
2595**O que fazer:**2650**O que fazer:**
2596 2651
2597* Escolha um advisor de classificação mais alta ou um modelo principal de classificação mais baixa. [Escolha um modelo advisor](/docs/pt/advisor#choose-an-advisor-model) mostra a classificação e lista os advisors aceitos para cada modelo principal.2652* Escolha um advisor com classificação mais alta ou um modelo principal com classificação mais baixa. [Escolher um modelo advisor](/docs/pt/advisor#choose-an-advisor-model) mostra a classificação e lista os advisors aceitos para cada modelo principal.
2598* Mantenha o advisor definido se quiser que [subagentes](/docs/pt/sub-agents) cujo modelo ele pode aconselhar continuem a usá-lo2653* Mantenha o advisor definido se quiser que [subagentes](/docs/pt/sub-agents) cujo modelo ele pode aconselhar continuem a usá-lo
2599 2654
2600Antes da v2.1.287, Claude Code classificava vários pares de forma diferente. Ele mostrava esta nota para um advisor Sonnet 5.5 com um modelo principal Opus 4.7 ou Opus 4.8, um par que agora aceita. Também anexava alguns advisors que agora produzem esta nota, como um advisor Opus 4.8 com um modelo principal Sonnet 5.5.2655Antes da v2.1.287, o Claude Code classificava várias combinações de forma diferente. Ele mostrava esta nota para um advisor Sonnet 5.5 com um modelo principal Opus 4.7 ou Opus 4.8, uma combinação que agora aceita. Ele também anexava alguns advisors que agora produzem esta nota, como um advisor Opus 4.8 com um modelo principal Sonnet 5.5.
2601 2656
2602### thinking.type.enabled não é suportado para este modelo2657### thinking.type.enabled is not supported for this model
2603 2658
2604Sua versão do Claude Code é mais antiga que o mínimo para o modelo selecionado. A CLI enviou uma configuração de pensamento que o modelo não aceita mais.2659Sua versão do Claude Code é mais antiga que a mínima para o modelo selecionado. A CLI enviou uma configuração de pensamento que o modelo não aceita mais.
2605 2660
2606```text theme={null}2661```text theme={null}
2607API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.2662API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
2609 2664
2610**O que fazer:**2665**O que fazer:**
2611 2666
2612* Execute `claude update` e reinicie Claude Code. Opus 4.7 precisa de v2.1.111 ou posterior. Opus 4.8 precisa de v2.1.154 ou posterior. Sonnet 5 precisa de v2.1.197 ou posterior. Opus 5 precisa de v2.1.219 ou posterior. Opus 5.5 precisa de v2.1.280 ou posterior. Sonnet 5.5 precisa de v2.1.284 ou posterior2667* Execute `claude update` e reinicie o Claude Code. O Opus 4.7 precisa da v2.1.111 ou posterior. O Opus 4.8 precisa da v2.1.154 ou posterior. O Sonnet 5 precisa da v2.1.197 ou posterior. O Opus 5 precisa da v2.1.219 ou posterior. O Opus 5.5 precisa da v2.1.280 ou posterior. O Sonnet 5.5 precisa da v2.1.284 ou posterior
2613* No [canal de lançamento estável](/docs/pt/setup#configure-release-channel), atualizar não o leva além da versão estável mais recente, que ainda pode ser mais antiga que essas versões. Mude para o canal latest e depois atualize2668* No [canal de lançamento stable](/docs/pt/setup#configure-release-channel), atualizar não o leva além da versão stable mais recente, que ainda pode ser mais antiga que essas versões. Mude para o canal latest e depois atualize
2614* Se você não conseguir atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.62669* Se você não puder atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.6
2615* Se você atingir isso no [Agent SDK](/docs/pt/agent-sdk/overview), atualize o pacote SDK. 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 posterior2670* Se você encontrar isso no [Agent SDK](/docs/pt/agent-sdk/overview), atualize o pacote do SDK. O Opus 4.8 precisa do SDK TypeScript v0.3.154 ou posterior e do SDK Python v0.2.88 ou posterior. O Sonnet 5 precisa do SDK TypeScript v0.3.197 ou posterior. O Opus 5 precisa do SDK TypeScript v0.3.219 ou posterior. O Opus 5.5 precisa do SDK TypeScript v0.3.280 ou posterior. O Sonnet 5.5 precisa do SDK TypeScript v0.3.284 ou posterior
2616 2671
2617### Esforço não está disponível com pensamento desativado2672### Effort isn't available with thinking turned off
2618 2673
2619Você desativou [pensamento estendido](/docs/pt/model-config#extended-thinking) e executou em um [nível de esforço](/docs/pt/model-config#adjust-effort-level) acima de `high`. O modelo não aceita essa combinação, então a API rejeitou a requisição.2674Você desativou o [pensamento estendido](/docs/pt/model-config#extended-thinking) e executou em um [nível de esforço](/docs/pt/model-config#adjust-effort-level) acima de `high`. O modelo não aceita essa combinação, então a API rejeitou a requisição.
2620 2675
2621```text theme={null}2676```text theme={null}
2622API 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)2677API 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)
2623```2678```
2624 2679
2625A 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`.2680A dica após o `·` varia conforme a sessão: em uma sessão não interativa ela diz `use --effort high (or the effortLevel setting)`, e em uma sessão executada pelo aplicativo Claude Desktop ela diz `you can lower effort to High`.
2626 2681
2627**O que fazer:**2682**O que fazer:**
2628 2683
2629* [Abaixe o nível de esforço](/docs/pt/model-config#set-the-effort-level) para `high` ou abaixo.2684* [Reduza o nível de esforço](/docs/pt/model-config#set-the-effort-level) para `high` ou abaixo.
2630* 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.2685* Ative o pensamento novamente, por exemplo removendo a definição de [`MAX_THINKING_TOKENS`](/docs/pt/env-vars) ou removendo [`"alwaysThinkingEnabled": false`](/docs/pt/settings-reference#alwaysthinkingenabled) das suas configurações.
2631 2686
2632Antes 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 requisição no nível de esforço que você definiu, então Opus 5 rejeitava cada requisição acima de `high` com pensamento desativado. Claude Code agora envia esforço `high` em vez disso para modelos que ele sabe rejeitam a combinação, como Opus 5.2687Antes da v2.1.242, o Claude Code mostrava a mensagem da própria 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, o Claude Code enviava a requisição no nível de esforço que você definiu, então o Opus 5 rejeitava todas as requisições acima de `high` com o pensamento desativado. O Claude Code agora envia o esforço `high` para os modelos que ele sabe que rejeitam a combinação, como o Opus 5.
2633 2688
2634### Orçamento de pensamento excede o limite de saída2689### Thinking budget exceeds output limit
2635 2690
2636O orçamento de pensamento estendido configurado excede o comprimento máximo de resposta, então não há espaço deixado para a resposta real.2691O orçamento de pensamento estendido configurado excede o tamanho máximo da resposta, então não sobra espaço para a resposta propriamente dita.
2637 2692
2638```text theme={null}2693```text theme={null}
2639API Error: 400 ... max_tokens must be greater than thinking.budget_tokens2694API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
2641 2696
2642**O que fazer:**2697**O que fazer:**
2643 2698
2644* Aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/pt/env-vars) acima do orçamento de pensamento2699* Aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/pt/env-vars) para acima do orçamento de pensamento
2645* Veja [Pensamento estendido](/docs/pt/model-config#extended-thinking) para como o orçamento interage com o comprimento de saída2700* Consulte [Pensamento estendido](/docs/pt/model-config#extended-thinking) para saber como o orçamento interage com o tamanho da saída
2646 2701
2647### Response exceeded the output token maximum2702### Response exceeded the output token maximum
2648 2703
2653API Error: Claude's response exceeded the 64000 output token maximum for a request sent without streaming. The CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable cannot raise this limit.2708API Error: Claude's response exceeded the 64000 output token maximum for a request sent without streaming. The CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable cannot raise this limit.
2654```2709```
2655 2710
2656A forma que menciona `a request sent without streaming` significa que uma requisição por streaming falhou e o Claude Code a reenviou sem streaming, o que limita a resposta a 64.000 tokens de saída. Antes da v2.1.299, uma resposta cortada em uma requisição reenviada dessa forma encerrava o turno sem essa mensagem, como se a resposta estivesse completa.2711A forma que menciona `a request sent without streaming` significa que uma requisição com streaming falhou e o Claude Code a reenviou sem streaming, o que limita a resposta a 64.000 tokens de saída. Antes da v2.1.299, uma resposta cortada em uma requisição reenviada dessa forma encerrava o turno sem essa mensagem, como se a resposta estivesse completa.
2657 2712
2658**O que fazer:**2713**O que fazer:**
2659 2714
2660* Se o Claude escreveu algum texto antes de a resposta ser cortada, responda `continue` em uma sessão interativa para pedir o restante. Esse texto permanece na conversa.2715* Se o Claude escreveu algum texto antes de a resposta ser cortada, responda `continue` em uma sessão interativa para pedir o restante. Esse texto permanece na conversa.
2661* Se a mensagem disser para definir `CLAUDE_CODE_MAX_OUTPUT_TOKENS`, consulte [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/pt/env-vars) para saber como o valor é limitado e [Definir variáveis de ambiente](/docs/pt/env-vars#set-environment-variables) para saber onde defini-lo2716* Se a mensagem disser para definir `CLAUDE_CODE_MAX_OUTPUT_TOKENS`, consulte [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/pt/env-vars) para saber como o valor é limitado e [Definir variáveis de ambiente](/docs/pt/env-vars#set-environment-variables) para saber onde defini-la
2662* Para manter cada resposta abaixo do limite, peça ao Claude a saída em partes menores, como um arquivo ou uma seção por resposta2717* Para manter cada resposta abaixo do limite, peça ao Claude a saída em partes menores, como um arquivo ou uma seção por resposta
2663 2718
2664### Incompatibilidade de bloco de uso de ferramenta ou pensamento2719### Incompatibilidade de blocos de uso de ferramenta ou de pensamento
2665 2720
2666O histórico de conversa chegou à API em um estado inconsistente.2721O histórico da conversa chegou à API em um estado inconsistente.
2667 2722
2668```text theme={null}2723```text theme={null}
2669API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.2724API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
2677 2732
2678**O que fazer:**2733**O que fazer:**
2679 2734
2680* Se você está usando Opus 4.7 ou Opus 4.8, execute `claude update` primeiro. Versões anteriores a v2.1.156 podem acionar esse erro durante o uso normal de ferramentas, e `/rewind` não o limpa.2735* Se você estiver usando o Opus 4.7 ou o Opus 4.8, execute `claude update` primeiro. Versões anteriores à v2.1.156 podem acionar esse erro durante o uso normal de ferramentas, e `/rewind` não o resolve.
2681* Execute `/rewind`, ou pressione Esc duas vezes, para voltar a um checkpoint antes do turno corrompido e continuar de lá. Veja [Checkpointing](/docs/pt/checkpointing) para como checkpoints são criados e restaurados.2736* Execute `/rewind`, ou pressione Esc duas vezes, para voltar a um checkpoint anterior ao turno corrompido e continuar a partir dali. Consulte [Checkpointing](/docs/pt/checkpointing) para saber como os checkpoints são criados e restaurados.
2682 2737
2683### Dados inválidos no bloco redacted\_thinking2738### Invalid data in redacted\_thinking block
2684 2739
2685A API recusou a requisição com um 400 porque não conseguiu aceitar um bloco `redacted_thinking` que um turno anterior no histórico de conversa carrega.2740A API recusou a requisição com um 400 porque não conseguiu aceitar um bloco `redacted_thinking` que um turno anterior do histórico da conversa contém.
2686 2741
2687```text theme={null}2742```text theme={null}
2688API Error: 400 ... Invalid `data` in `redacted_thinking` block2743API Error: 400 ... Invalid `data` in `redacted_thinking` block
2689```2744```
2690 2745
2691Claude Code deixa o pensamento anterior da conversa fora da requisiçã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 turno posterior falhava com o mesmo erro.2746O Claude Code deixa o pensamento anterior da conversa fora da requisição e tenta novamente uma vez, então a sessão continua sem mostrar o erro. Antes da v2.1.282, o Claude Code mantinha o bloco recusado, e todos os turnos seguintes falhavam com o mesmo erro.
2692 2747
2693**O que fazer:**2748**O que fazer:**
2694 2749
2695* Se você está na v2.1.281 ou anterior e cada turno falha com esse erro, execute `claude update` e retome a sessão2750* Se você estiver na v2.1.281 ou anterior e todos os turnos falharem com esse erro, execute `claude update` e retome a sessão
2696* Se o erro persistir, execute `/clear` para iniciar uma conversa que não carrega o bloco2751* Se o erro persistir, execute `/clear` para iniciar uma conversa que não contenha o bloco
2697 2752
2698### Conteúdo de ferramenta não suportado removido2753### Unsupported tool content removed
2699 2754
2700Quando Claude Code se conecta diretamente à API Anthropic e carrega ou visualiza uma sessão salva, ele remove conteúdo de ferramenta que a API Anthropic não aceita e deixa esta linha onde o conteúdo removido estava entre dois blocos de pensamento:2755Quando o Claude Code se conecta diretamente à Anthropic API e carrega ou pré-visualiza uma sessão salva, ele remove o conteúdo de ferramentas que a Anthropic API não aceita e deixa esta linha onde o conteúdo removido ficava entre dois blocos de pensamento:
2701 2756
2702```text theme={null}2757```text theme={null}
2703[Unsupported tool content removed]2758[Unsupported tool content removed]
2704```2759```
2705 2760
2706Tal conteúdo chega a um arquivo de sessão quando algo diferente da API Anthropic responde no formato da API, tipicamente um proxy de terceiros definido através de [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) que traduz chamadas de ferramenta de outro provedor. Claude Code o remove apenas quando a sessão se conecta diretamente à API Anthropic, e carrega o histórico salvo como está quando a sessão executa através de um proxy ou em outro provedor. Antes da v2.1.246, Claude Code enviava o uso de ferramenta e seu resultado de volta para a API, e cada turno da sessão retomada falhava com um erro 400 como `messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ...`.2761Esse conteúdo chega a um arquivo de sessão quando algo diferente da Anthropic API respondeu no formato da API, normalmente um proxy de terceiros definido por meio de [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) que traduz as chamadas de ferramenta de outro provedor. O Claude Code o remove apenas quando a sessão se conecta diretamente à Anthropic API, e carrega o histórico salvo como está quando a sessão passa por um proxy ou roda em outro provedor. Antes da v2.1.246, o Claude Code enviava o uso da ferramenta e seu resultado de volta à API, e todos os turnos da sessão retomada falhavam com um erro 400 como `messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ...`.
2707 2762
2708**O que fazer:**2763**O que fazer:**
2709 2764
2710* Nenhuma ação necessária quando você vê a linha de espaço reservado. A sessão continua sem o conteúdo removido.2765* Nada é necessário quando você vê a linha substituta. A sessão continua sem o conteúdo removido.
2711* Se cada turno de uma sessão retomada falha com o erro 400, execute `claude update` e retome a sessão novamente. Versões anteriores a v2.1.246 não removem o conteúdo.2766* Se, em vez disso, todos os turnos de uma sessão retomada falharem com o erro 400, execute `claude update` e retome a sessão novamente. Versões anteriores à v2.1.246 não removem o conteúdo.
2712 2767
2713### role 'system' deve preceder uma mensagem 'assistant'2768### role 'system' must precede an 'assistant' message
2714 2769
2715A API recusou a requisição com um 400 porque uma mensagem de sistema fica em uma posição na conversa que ela não aceita:2770A API recusou a requisição com um 400 porque uma mensagem de sistema está em uma posição da conversa que ela não aceita:
2716 2771
2717```text theme={null}2772```text theme={null}
2718API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...2773API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...
2719```2774```
2720 2775
2721Claude Code envia parte 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 requisição uma vez com esse texto enviado como mensagens de usuário ordinárias. As redações de posicionamento irmãs da API, como `use the top-level 'system' parameter for the initial system prompt`, obtêm a mesma recuperação.2776O Claude Code envia parte do seu texto de lembretes e de anexos como mensagens de sistema dentro da conversa. Quando a API recusa a posição de uma delas, o Claude Code tenta novamente a requisição uma vez com esse texto enviado como mensagens de usuário comuns. Os textos de posicionamento semelhantes da API, como `use the top-level 'system' parameter for the initial system prompt`, recebem a mesma recuperação.
2722 2777
2723Quando o erro aparece, a mensagem de sistema recusada não é uma que Claude Code possa remover. Isso geralmente significa que um proxy ou [gateway de LLM](/docs/pt/llm-gateway) entre Claude Code e a API adicionou uma mensagem de sistema própria.2778Quando o erro aparece, a mensagem de sistema recusada não é uma que o Claude Code possa remover. Isso geralmente significa que um proxy ou [gateway de LLM](/docs/pt/llm-gateway) entre o Claude Code e a API adicionou uma mensagem de sistema própria.
2724 2779
2725**O que fazer:**2780**O que fazer:**
2726 2781
2727* Se o erro se repete a cada turno 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 opera2782* Se o erro se repetir a cada turno por trás de um proxy ou gateway configurado por meio de [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars), conecte-se sem o proxy para confirmar a origem e informe o erro a quem o opera
2728* Execute `/clear` para iniciar uma conversa nova. Se o erro retornar lá também, a causa está no caminho da requisição, não na conversa salva.2783* Execute `/clear` para iniciar uma conversa nova. Se o erro voltar ali também, a causa está no caminho da requisição, não na conversa salva.
2729 2784
2730Antes 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 o próprio Claude Code enviou, e cada turno posterior da conversa falhava da mesma forma.2785Antes da v2.1.280, o Claude Code não reconhecia esse texto, então o erro também aparecia quando a mensagem de sistema recusada era uma que o próprio Claude Code enviou, e todos os turnos seguintes da conversa falhavam da mesma forma.
2731 2786
2732### Conteúdo criptografado inválido no bloco search\_result2787### Invalid encrypted\_content in search\_result block
2733 2788
2734A API recusou a requisição com um 400 porque o histórico de conversa contém conteúdo de busca na web hospedado que não consegue descriptografar. A redação nomeia o campo que não consegue ler:2789A API recusou a requisição com um 400 porque o histórico da conversa contém conteúdo de pesquisa na web hospedada que ela não consegue descriptografar. O texto nomeia o campo que ela não consegue ler:
2735 2790
2736```text theme={null}2791```text theme={null}
2737API Error: 400 ... Invalid `encrypted_content` in `search_result` block2792API Error: 400 ... Invalid `encrypted_content` in `search_result` block
2740API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block2795API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block
2741```2796```
2742 2797
2743Resultados da [ferramenta de busca na web hospedada](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) da API carregam campos criptografados que apenas a API consegue 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 requisição que reproduz conteúdo que não consegue descriptografar, como conteúdo produzido para uma organização diferente.2798Os resultados da [ferramenta de pesquisa na web](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) hospedada da API trazem campos criptografados que apenas a API consegue ler. O texto `encrypted_stdout` nomeia a saída de um programa de execução de código hospedado que leu esses resultados, que a API também criptografa. A API recusa uma requisição que reenvia conteúdo que ela não consegue descriptografar, como conteúdo produzido para uma organização diferente.
2744 2799
2745A 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 de LLM](/docs/pt/llm-gateway) que executou busca na web hospedada.2800A própria [ferramenta WebSearch](/docs/pt/tools-reference#websearch-tool-behavior) do Claude Code registra os resultados de pesquisa como texto simples, então esses blocos geralmente chegam a uma conversa por meio de um proxy ou [gateway de LLM](/docs/pt/llm-gateway) que executou ele mesmo a pesquisa na web hospedada.
2746 2801
2747Para 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 requisiçã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 turno posterior e `/compact` falhava da mesma forma.2802Para os três textos de pesquisa na web, o Claude Code deixa as chamadas de pesquisa, os resultados e as citações fora do que envia e tenta novamente a requisição uma vez, então a sessão continua sem mostrar o erro. O texto `encrypted_stdout` não tem essa recuperação, então essa mensagem ainda chega até você. Antes da v2.1.282, o Claude Code também mantinha os blocos de pesquisa na web recusados, e todos os turnos seguintes e `/compact` falhavam da mesma forma.
2748 2803
2749**O que fazer:**2804**O que fazer:**
2750 2805
2751* Se você está na v2.1.281 ou anterior e cada turno falha com uma das redações de busca na web, execute `claude update` e retome a sessão2806* Se você estiver na v2.1.281 ou anterior e todos os turnos falharem com um dos textos de pesquisa na web, execute `claude update` e retome a sessão
2752* Se o erro persistir, ou a mensagem nomear `encrypted_stdout`, execute `/rewind` para voltar a um checkpoint antes do turno que adicionou o conteúdo, ou execute `/clear` para iniciar uma conversa que não o carrega2807* Se o erro persistir, ou se a mensagem nomear `encrypted_stdout`, execute `/rewind` para voltar a um checkpoint anterior ao turno que adicionou o conteúdo, ou execute `/clear` para iniciar uma conversa que não o contenha
2753* Se você executa Claude Code atrás de um proxy ou gateway, relate o erro a quem o opera2808* Se você executa o Claude Code por trás de um proxy ou gateway, informe o erro a quem o opera
2754 2809
2755### Recusa de Política de Uso2810### Recusa pela Política de Uso
2756 2811
2757A API recusou responder porque conteúdo na conversa acionou uma verificação de [Política de Uso](https://www.anthropic.com/legal/aup).2812A API se recusou a responder porque o conteúdo da conversa acionou uma verificação da [Política de Uso](https://www.anthropic.com/legal/aup).
2758 2813
2759Se a mensagem incluir a linha `` Details: `[reasoning_extraction]` ``, veja [As proteções sinalizaram uma requisição pelo raciocínio do Claude](#safeguards-flagged-a-request-for-claudes-reasoning).2814Se a mensagem incluir a linha `` Details: `[reasoning_extraction]` ``, consulte [Safeguards flagged a request for Claude's reasoning](#safeguards-flagged-a-request-for-claudes-reasoning).
2760 2815
2761A mensagem inclui um ID de Requisição e um ID de Mensagem que você pode citar para suporte se acreditar que a recusa está incorreta.2816A mensagem inclui um Request ID e um Message ID que você pode citar ao suporte se acreditar que a recusa está incorreta.
2762 2817
2763```text theme={null}2818```text theme={null}
2764API Error: Opus 4.6 can't help with this. Start a new session to continue.2819API Error: Opus 4.6 can't help with this. Start a new session to continue.
2766Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup2821Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup
2767```2822```
2768 2823
2769A mensagem nomeia o modelo que recusou, ou `Claude` quando nenhum modelo é registrado.2824A mensagem nomeia o modelo que recusou, ou `Claude` quando nenhum modelo está registrado.
2770 2825
2771A verificação avalia a conversa completa, não apenas seu prompt mais recente, então enviar uma nova mensagem na mesma sessão geralmente re-aciona a mesma recusa. O mesmo se aplica após sair e reabrir a sessão com `--continue` ou `--resume`, já que a transcrição no disco ainda contém o conteúdo que aciona. Em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) e [Microsoft Foundry](/docs/pt/microsoft-foundry), essa mensagem também cobre requisições que as medidas de segurança do modelo sinalizaram como um tópico de cibersegurança. Veja [Medidas de segurança sinalizaram um tópico de cibersegurança](#safety-measures-flagged-a-cybersecurity-topic).2826A verificação avalia a conversa completa, não apenas seu prompt mais recente, então enviar uma nova mensagem na mesma sessão geralmente aciona a mesma recusa novamente. O mesmo se aplica depois de sair e reabrir a sessão com `--continue` ou `--resume`, já que a transcrição no disco ainda contém o conteúdo que a acionou. No [Amazon Bedrock](/docs/pt/amazon-bedrock), no [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) e no [Microsoft Foundry](/docs/pt/microsoft-foundry), essa mensagem também cobre requisições que as medidas de segurança do modelo sinalizaram como um tema de cibersegurança. Consulte [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).
2772 2827
2773Antes da v2.1.219, a mensagem lia `Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.`2828Antes da v2.1.219, a mensagem dizia `Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.`
2774 2829
2775**O que fazer:**2830**O que fazer:**
2776 2831
2777* Pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint antes do turno que acionou a recusa, depois reformule ou tome uma abordagem diferente. Veja [Checkpointing](/docs/pt/checkpointing).2832* Pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint anterior ao turno que acionou a recusa, depois reformule ou adote uma abordagem diferente. Consulte [Checkpointing](/docs/pt/checkpointing).
2778* Se você não conseguir identificar qual turno causou, execute `/clear` para iniciar uma conversa nova no mesmo projeto. Sua conversa anterior é preservada no disco e permanece disponível em `/resume`.2833* Se você não conseguir identificar qual turno a causou, execute `/clear` para iniciar uma conversa nova no mesmo projeto. Sua conversa anterior é preservada no disco e continua disponível em `/resume`.
2779* Em [modo não interativo](/docs/pt/headless) (`-p`), onde rewind não está disponível, tente novamente com um prompt reformulado em uma nova sessão sem `--continue`. As verificações de política variam por modelo, então mudar para um modelo diferente com `--model` também pode resolver a recusa em alguns casos.2834* No [modo não interativo](/docs/pt/headless) (`-p`), em que o rewind não está disponível, tente novamente com um prompt reformulado em uma nova sessão sem `--continue`. As verificações de política variam conforme o modelo, então trocar para um modelo diferente com `--model` também pode resolver a recusa em alguns casos.
2780 2835
2781### Medidas de segurança sinalizaram um tópico de cibersegurança2836### Medidas de segurança sinalizaram um tópico de cibersegurança
2782 2837
2783As medidas de segurança do modelo sinalizaram conteúdo na conversa como um tópico de cibersegurança. A mensagem nomeia o modelo que sinalizou a requisição:2838As medidas de segurança do modelo sinalizaram conteúdo na conversa como um tópico de cibersegurança. A mensagem indica o modelo que sinalizou a requisição:
2784 2839
2785```text theme={null}2840```text theme={null}
2786API 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. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude2841API 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. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude
2787```2842```
2788 2843
2789Se a mensagem incluir a linha `` Details: `[reasoning_extraction]` ``, veja [As proteções sinalizaram uma requisição pelo raciocínio do Claude](#safeguards-flagged-a-request-for-claudes-reasoning).2844Se a mensagem incluir a linha `` Details: `[reasoning_extraction]` ``, consulte [As salvaguardas sinalizaram uma requisição do raciocínio do Claude](#safeguards-flagged-a-request-for-claudes-reasoning).
2790 2845
2791Esta 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. Modelos com [fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) exibem uma mensagem diferente, sem esse link; em Opus 5.5 e Sonnet 5.5, ela abre com `<model>'s safeguards flagged this session`. Essa seção também explica quando Claude Code muda de modelo em vez disso.2846Esta mensagem contém um link para o [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), que concede acesso para trabalhos legítimos de cibersegurança. Modelos com [fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) exibem uma mensagem diferente, sem esse link; no Opus 5.5 e no Sonnet 5.5, ela começa com `<model>'s safeguards flagged this session`. Essa seção também aborda quando o Claude Code troca de modelo em vez disso.
2792 2847
2793Em [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.2848No [Amazon Bedrock](/docs/pt/amazon-bedrock), no [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) e no [Microsoft Foundry](/docs/pt/microsoft-foundry), uma sinalização de cibersegurança produz, em vez disso, a mensagem de [recusa pela Política de Uso](#usage-policy-refusal).
2794 2849
2795**O que fazer:**2850**O que fazer:**
2796 2851
2797* Se seu trabalho requer este conteúdo, solicite acesso através do [Programa de Verificação Cibernética](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)2852* Se o seu trabalho exige esse conteúdo, solicite acesso por meio do [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)
2798* Se sua requisição não era sobre um tópico de cibersegurança, execute `/feedback` para relatar o falso positivo2853* Se a sua requisição não era sobre um tópico de cibersegurança, execute `/feedback` para relatar o falso positivo
2799* Para continuar trabalhando na mesma sessão, pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint antes do turno que acionou a sinalização, depois tome uma abordagem diferente. Veja [Checkpointing](/docs/pt/checkpointing).2854* Para continuar trabalhando na mesma sessão, pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint anterior ao turno que acionou a sinalização e, em seguida, adote uma abordagem diferente. Consulte [Checkpointing](/docs/pt/checkpointing).
2800 2855
2801Se a mensagem que você vê estiver redigida como uma destas, trata-se da mesma sinalização em uma versão anterior do Claude Code:2856Se a mensagem que você vê estiver redigida como uma destas, trata-se da mesma sinalização em uma versão anterior do Claude Code:
2802 2857
2804* Da v2.1.203 até a v2.1.218, a mensagem dizia `<model> has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center:` seguida do mesmo link da central de ajuda. Em sessões interativas, ela continuava com `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.`2859* Da v2.1.203 até a v2.1.218, a mensagem dizia `<model> has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center:` seguida do mesmo link da central de ajuda. Em sessões interativas, ela continuava com `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.`
2805* Antes da v2.1.203, ela dizia `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` seguida de um link para um formulário de isenção2860* Antes da v2.1.203, ela dizia `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` seguida de um link para um formulário de isenção
2806 2861
2807### As proteções sinalizaram uma requisição pelo raciocínio do Claude2862### As salvaguardas sinalizaram uma requisição do raciocínio do Claude
2808 2863
2809A API recusou a requisição porque as proteções a sinalizaram como pedindo ao modelo que reproduzisse seu raciocínio interno na resposta. A API chama essa [categoria de recusa](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#refusal-response) de `reasoning_extraction`, e a mensagem de recusa inclui esta linha:2864A API recusou a requisição porque as salvaguardas a sinalizaram como um pedido para que o modelo reproduzisse seu raciocínio interno na resposta. A API chama essa [categoria de recusa](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#refusal-response) de `reasoning_extraction`, e a mensagem de recusa inclui esta linha:
2810 2865
2811```text theme={null}2866```text theme={null}
2812Details: `[reasoning_extraction]`2867Details: `[reasoning_extraction]`
2816 2871
2817**O que fazer:**2872**O que fazer:**
2818 2873
2819* Remova ou reformule qualquer instrução que peça a Claude para escrever seu pensamento ou raciocínio literalmente ou em um formato fixo, como uma seção `<thinking>`, uma seção de rascunho ou um campo `reasoning` em saída JSON. A instrução pode estar em seu prompt ou em uma personalização que Claude Code carrega com ele, como CLAUDE.md, uma skill, um prompt de subagente, um estilo de saída ou a descrição de uma ferramenta MCP.2874* Remova ou reformule qualquer instrução que peça ao Claude para escrever seu pensamento ou raciocínio literalmente ou em um formato fixo, como uma seção `<thinking>`, uma seção de rascunho ou um campo `reasoning` em saída JSON. A instrução pode estar no seu prompt ou em uma personalização que o Claude Code carrega junto com ele, como CLAUDE.md, uma skill, um prompt de subagente, um estilo de saída ou a descrição de uma ferramenta MCP.
2820* Para verificar se uma personalização é o gatilho, execute [`claude --safe-mode`](/docs/pt/cli-reference#cli-flags) em seu terminal para iniciar uma sessão com as personalizações desativadas e, em seguida, envie o mesmo prompt2875* Para verificar se uma personalização é a causa, execute [`claude --safe-mode`](/docs/pt/cli-reference#cli-flags) no seu terminal para iniciar uma sessão com as personalizações desativadas e, em seguida, envie o mesmo prompt
2821* Depois de alterar uma personalização, inicie uma nova sessão2876* Depois de alterar uma personalização, inicie uma nova sessão
2822* Para reformular um prompt que você já enviou, veja [Rewind and summarize](/docs/pt/checkpointing#rewind-and-summarize)2877* Para reformular um prompt que você já enviou, consulte [Rewind and summarize](/docs/pt/checkpointing#rewind-and-summarize)
2823* Você ainda pode pedir a Claude que explique sua resposta. Peça uma explicação curta, as evidências por trás de um resultado ou um resumo das ações que ele realizou. Para ler resumos do pensamento do Claude, veja [`showThinkingSummaries`](/docs/pt/settings-reference#showthinkingsummaries).2878* Você ainda pode pedir ao Claude que explique a resposta dele. Peça uma explicação curta, as evidências por trás de um resultado ou um resumo das ações que ele executou. Para ler resumos do pensamento do Claude, consulte [`showThinkingSummaries`](/docs/pt/settings-reference#showthinkingsummaries).
2824* Para mais exemplos, e o que fazer se uma requisição reformulada ainda for recusada, veja [Keep reasoning in thinking blocks](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#keep-reasoning-in-thinking-blocks)2879* Para mais exemplos, e para saber o que fazer se uma requisição reformulada ainda for recusada, consulte [Keep reasoning in thinking blocks](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#keep-reasoning-in-thinking-blocks)
2825 2880
2826### Output blocked by content filtering policy2881### Output blocked by content filtering policy
2827 2882
2828O filtro de conteúdo de saída da API interrompeu a resposta que Claude estava gerando. O texto da mensagem vem da API:2883O filtro de conteúdo de saída da API interrompeu a resposta que o Claude estava gerando. O texto da mensagem vem da API:
2829 2884
2830```text theme={null}2885```text theme={null}
2831API Error: Output blocked by content filtering policy2886API Error: Output blocked by content filtering policy
2833 2888
2834**O que fazer:**2889**O que fazer:**
2835 2890
2836* Reformule sua última mensagem ou tome uma abordagem diferente2891* Reformule sua última mensagem ou adote uma abordagem diferente
2837* Para voltar a um checkpoint antes do turno que acionou o bloqueio, pressione Esc duas vezes ou execute `/rewind`. Veja [Checkpointing](/docs/pt/checkpointing)2892* Para voltar a um checkpoint anterior ao turno que acionou o bloqueio, pressione Esc duas vezes ou execute `/rewind`. Consulte [Checkpointing](/docs/pt/checkpointing)
2838 2893
2839## Erros de linha de comando2894## Erros de linha de comando
2840 2895
3361 3416
3362Mensagens semelhantes são disparadas antes mesmo de o comando ser executado:3417Mensagens semelhantes são disparadas antes mesmo de o comando ser executado:
3363 3418
3364* `Shell command permission check failed for pattern "..."`: a verificação de permissão do comando não o permitiu. [Verificações de permissão em comandos injetados](/docs/pt/skills#permission-checks-on-injected-commands) explica quais resultados abortam em cada modo de permissão e como pré-aprovar um comando com `allowed-tools`3419* `Shell command permission check failed for pattern "..."`: a verificação de permissão do comando não o permitiu. [Permission checks on injected commands](/docs/pt/skills#permission-checks-on-injected-commands) explica quais resultados abortam em cada modo de permissão e como pré-aprovar um comando com `allowed-tools`
3365* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: o frontmatter da skill exige bash em uma máquina que não o tem. Instale o Git for Windows ou altere o frontmatter para `shell: powershell`. Consulte [Como os comandos injetados são executados](/docs/pt/skills#how-injected-commands-run)3420* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: o frontmatter da skill exige bash em uma máquina sem ele. Instale o Git for Windows ou altere o frontmatter para `shell: powershell`. Consulte [How injected commands run](/docs/pt/skills#how-injected-commands-run)
3366* `No shell command in <name> was run`: um dos comandos `!` do arquivo contém um caractere de controle bruto diferente de tab ou nova linha, então nenhum deles é executado. Consulte [como encontrar e remover o caractere](#no-shell-command-was-run)3421* `No shell command in <name> was run`: um dos comandos `!` do arquivo contém um caractere de controle bruto diferente de tab ou nova linha, então nenhum deles é executado. Consulte [como encontrar e remover o caractere](#no-shell-command-was-run)
3367 3422
3368**O que fazer:**3423**O que fazer:**
3464O Claude Code sugere o nome de comando ou alias mais próximo que o menu lista nesta sessão. Quando nada é próximo, a mensagem termina após o nome. A causa geralmente é uma das seguintes:3519O Claude Code sugere o nome de comando ou alias mais próximo que o menu lista nesta sessão. Quando nada é próximo, a mensagem termina após o nome. A causa geralmente é uma das seguintes:
3465 3520
3466* Um erro de digitação, como `/hepl` em vez de `/help`. [Como o menu de comandos corresponde ao que você digita](/docs/pt/commands#how-the-command-menu-matches-what-you-type) explica como escolher uma correspondência próxima antes de enviar3521* Um erro de digitação, como `/hepl` em vez de `/help`. [Como o menu de comandos corresponde ao que você digita](/docs/pt/commands#how-the-command-menu-matches-what-you-type) explica como escolher uma correspondência próxima antes de enviar
3467* Um comando que existe, mas não está disponível nesta sessão porque um requisito não é atendido, como sua plataforma, plano ou método de autenticação. As entradas de solução de problemas para [`/web-setup`](/docs/pt/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) e [`/schedule`](/docs/pt/routines#schedule-returns-unknown-command) explicam dois casos comuns. Alguns comandos respondem com sua própria mensagem quando a política da sua organização os desativa, como [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)3522* Um comando que existe, mas não está disponível nesta sessão porque um requisito não é atendido, como sua plataforma, plano ou método de autenticação. Consulte a entrada de [`/web-setup`](/docs/pt/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command), [`/schedule`](/docs/pt/routines#schedule-returns-unknown-command) ou [`/auto-mode-setup`](/docs/pt/auto-mode-config#auto-mode-setup-returns-unknown-command). Alguns comandos respondem com sua própria mensagem quando a política da sua organização os desativa, como [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)
3468* Um comando de um [plugin](/docs/pt/plugins/overview) ou [servidor MCP](/docs/pt/mcp#use-mcp-prompts-as-commands) que não está instalado ou conectado nesta sessão3523* Um comando de um [plugin](/docs/pt/plugins/overview) ou [servidor MCP](/docs/pt/mcp#use-mcp-prompts-as-commands) que não está instalado ou conectado nesta sessão
3469 3524
3470O Claude Code responde dessa forma a um nome com `/` sem correspondência apenas em uma sessão de terminal interativa. Em todas as outras sessões, ele envia o prompt ao Claude como uma mensagem normal, com uma nota de que o comando não foi executado e uma lista dos comandos que o Claude pode executar na sessão. Essas sessões incluem:3525O Claude Code responde dessa forma a um nome com `/` sem correspondência apenas em uma sessão de terminal interativa. Em todas as outras sessões, ele envia o prompt ao Claude como uma mensagem normal, com uma nota de que o comando não foi executado e uma lista dos comandos que o Claude pode executar na sessão. Essas sessões incluem:
3513 3568
3514* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar seu branch base explicitamente, como no exemplo acima3569* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar seu branch base explicitamente, como no exemplo acima
3515* **Você passou um branch base que já estava no seu clone**: a dica diz ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3570* **Você passou um branch base que já estava no seu clone**: a dica diz ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``
3516* **Você passou um branch base que não estava no seu clone**: o Claude Code o buscou do origin antes de comparar. A dica diz ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando o Claude Code não consegue determinar se seu clone é raso, ele sugere `git fetch --unshallow origin` em vez disso. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para todo branch base buscado, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.3571* **Você passou um branch base que não estava no seu clone**: o Claude Code fez fetch dele a partir do origin antes de comparar. A dica diz ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando o Claude Code não consegue determinar se seu clone é raso (shallow), ele sugere `git fetch --unshallow origin` em vez disso. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para todo branch base obtido por fetch, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.
3517 3572
3518**O que fazer:**3573**O que fazer:**
3519 3574
3856* Abra a sessão você mesmo e execute `/recap` ali: no terminal dela, no [aplicativo Desktop](/docs/pt/desktop) ou no [aplicativo móvel](/docs/pt/mobile), em [claude.ai/code](https://claude.ai/code), ou pelo [Remote Control](/docs/pt/remote-control)3911* Abra a sessão você mesmo e execute `/recap` ali: no terminal dela, no [aplicativo Desktop](/docs/pt/desktop) ou no [aplicativo móvel](/docs/pt/mobile), em [claude.ai/code](https://claude.ai/code), ou pelo [Remote Control](/docs/pt/remote-control)
3857* Se uma tarefa agendada na nuvem ou outro programa o enviou, remova `/recap` desse prompt3912* Se uma tarefa agendada na nuvem ou outro programa o enviou, remova `/recap` desse prompt
3858 3913
3914### /feedback está desativado pela política da sua organização
3915
3916Esta mensagem significa que a política da sua organização não permite feedback sobre o produto a partir do Claude Code, então `/feedback`, `/bug` e `/share` não abrem a caixa de diálogo de feedback. A mensagem indica o comando que você digitou no prompt do Claude Code:
3917
3918```text wrap theme={null}
3919/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.
3920```
3921
3922A mensagem também pode consistir apenas na primeira frase.
3923
3924**O que fazer:**
3925
3926* Para relatar um bug, abra uma issue em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Qualquer pessoa pode ler as issues ali, então omita código, transcrições e qualquer outra coisa confidencial.
3927
3928Antes da v2.1.302, a mensagem completa dizia `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`
3929
3859## Erros de plugin3930## Erros de plugin
3860 3931
3861Esses erros vêm da configuração de [plugin](/docs/pt/plugins/overview) e [marketplace](/docs/pt/plugins/overview). Para problemas de plugin que não produzem uma das mensagens nesta página, como uma URL de marketplace que não carrega ou um plugin que é instalado mas não aparece, consulte [Solução de problemas de plugin](/docs/pt/plugins/troubleshooting).3932Esses erros vêm da configuração de [plugin](/docs/pt/plugins/overview) e [marketplace](/docs/pt/plugins/overview). Para problemas de plugin que não produzem uma das mensagens nesta página, como uma URL de marketplace que não carrega ou um plugin que é instalado mas não aparece, consulte [Solução de problemas de plugin](/docs/pt/plugins/troubleshooting).
4001 4072
4002### Path escapes plugin directory4073### Path escapes plugin directory
4003 4074
4004Um caminho de componente de plugin, declarado no `plugin.json` do plugin ou em sua [entrada de marketplace](/docs/pt/plugins/marketplace-reference#plugin-entries), resolve fora do diretório do próprio plugin. Claude Code descarta esse caminho e carrega o resto do plugin. O nome do componente na mensagem, como `commands` ou `hooks`, nomeia o campo que declarou o caminho.4075Um dos caminhos de componente do plugin leva para fora do diretório do plugin ou não pôde ser confirmado dentro dele, então Claude Code descarta esse caminho e carrega o resto do plugin. Para um caminho que o plugin declara em `plugin.json` ou em sua [entrada de marketplace](/docs/pt/plugins/marketplace-reference#plugin-entries), o nome do componente na mensagem, como `commands` ou `hooks`, nomeia o campo que declarou o caminho.
4005 4076
4006```text theme={null}4077```text theme={null}
4007commands path escapes plugin directory: ./../shared.md4078commands path escapes plugin directory: ./../shared.md
4015commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory4086commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory
4016```4087```
4017 4088
4089Uma mensagem que fornece o caminho completo de um dos próprios arquivos de um plugin de marketplace, como `hooks/hooks.json`, significa que Claude Code ignorou esse arquivo. Isso acontece quando Claude Code não consegue confirmar que o arquivo está dentro do plugin ou, para um plugin em um [marketplace local](/docs/pt/plugins/loading#in-place-and-copied-plugins), dentro desse marketplace. A mensagem relata cada um desses arquivos sob o nome de componente mostrado:
4090
4091* `hooks/hooks.json`: `hooks`
4092* `monitors/monitors.json`: `monitors`
4093* `settings.json`: `settings`
4094* `SKILL.md` na raiz do plugin: `skills`
4095
4096Por exemplo, esta mensagem é para um `hooks/hooks.json` que resolve fora tanto do plugin quanto de seu marketplace local:
4097
4098```text theme={null}
4099hooks path escapes plugin directory: /home/user/my-marketplace/my-plugin/hooks/hooks.json — it resolves to /home/user/dotfiles/hooks.json, outside the plugin directory and its marketplace directory
4100```
4101
4018No macOS e Linux, Claude Code também rejeita um caminho de componente que contém uma barra invertida em qualquer lugar, mesmo quando o caminho fica dentro do plugin. Um plugin cujos caminhos de componente usam separadores de estilo Windows carrega no Windows e dispara essa rejeição nas outras plataformas:4102No macOS e Linux, Claude Code também rejeita um caminho de componente que contém uma barra invertida em qualquer lugar, mesmo quando o caminho fica dentro do plugin. Um plugin cujos caminhos de componente usam separadores de estilo Windows carrega no Windows e dispara essa rejeição nas outras plataformas:
4019 4103
4020```text theme={null}4104```text theme={null}
4023 4107
4024Antes da v2.1.251, Claude Code carregava um caminho `commands` declarado em uma entrada de marketplace mesmo quando apontava para fora do diretório do plugin.4108Antes da v2.1.251, Claude Code carregava um caminho `commands` declarado em uma entrada de marketplace mesmo quando apontava para fora do diretório do plugin.
4025 4109
4026Antes da v2.1.257, a verificação olhava apenas para a grafia do caminho, não para onde um symlink leva.4110Antes da v2.1.257, a verificação dos caminhos que o plugin declara olhava apenas para a grafia do caminho, não para onde um symlink leva.
4027 4111
4028**O que fazer:**4112**O que fazer:**
4029 4113
4030* Mova o arquivo referenciado dentro do diretório do plugin e aponte o caminho para ele com um caminho relativo `./`4114* Se você instalou o plugin e não o mantém, relate a mensagem ao autor dele
4031* Se o caminho é um symlink para um arquivo fora do plugin, substitua o symlink por uma cópia do arquivo4115* Para um caminho que o plugin declara, mova o arquivo referenciado para dentro do diretório do plugin e aponte o caminho para ele com um caminho relativo `./`
4032* Se a mensagem diz que o caminho contém uma barra invertida, escreva o caminho com barras para frente, por exemplo `./commands/deploy.md`4116* Se o caminho, ou uma pasta acima dele dentro do plugin, for um symlink que leva para fora do plugin, substitua o symlink por uma cópia daquilo para o que ele aponta
4117* Se a mensagem disser que um caminho que o plugin declara contém uma barra invertida, escreva o caminho com barras para frente, por exemplo `./commands/deploy.md`
4118* Se a mensagem terminar com `EACCES`, restaure sua permissão de execução em cada diretório que leva ao arquivo ou pasta que o caminho nomeia. Verifique os diretórios acima do caminho, depois siga cada symlink que encontrar e verifique os diretórios que levam até onde ele aponta. Para qualquer outro código de erro, consulte-o nas [causas e etapas para um caminho que não pôde ser verificado](#path-could-not-be-checked).
4033* Para compartilhar arquivos com outros plugins no mesmo marketplace, vincule-os com um symlink dentro do diretório do plugin, seguindo as [regras de symlink](/docs/pt/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)4119* Para compartilhar arquivos com outros plugins no mesmo marketplace, vincule-os com um symlink dentro do diretório do plugin, seguindo as [regras de symlink](/docs/pt/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)
4034 4120
4121### Plugin not loaded: its manifest was not read
4122
4123Claude Code não conseguiu confirmar que o [manifesto](/docs/pt/plugins/manifest-reference) de um plugin de marketplace em `.claude-plugin/plugin.json` está dentro do plugin, então não carrega nada desse plugin. Para um plugin em um [marketplace local](/docs/pt/plugins/loading#in-place-and-copied-plugins), Claude Code também não conseguiu confirmar que o manifesto está dentro desse marketplace. A mensagem aparece na aba **Errors** do `/plugin`, e o motivo no final dela diz o que Claude Code encontrou.
4124
4125Por exemplo, esta mensagem é para um plugin em um marketplace local cuja pasta `.claude-plugin` é um symlink que leva para fora do marketplace:
4126
4127```text theme={null}
4128Plugin not loaded: its manifest /home/user/my-marketplace/my-plugin/.claude-plugin/plugin.json was not read, because it resolves to /home/user/dotfiles/my-plugin/.claude-plugin/plugin.json, outside the plugin directory and its marketplace directory
4129```
4130
4131**O que fazer:**
4132
4133* Se o motivo terminar com `EACCES`, restaure sua permissão de execução em cada diretório que leva ao manifesto. Verifique os diretórios acima do manifesto, depois siga cada symlink que encontrar e verifique os diretórios que levam até onde ele aponta. Para qualquer outro código de erro, consulte-o nas [causas e etapas para um caminho que não pôde ser verificado](#path-could-not-be-checked).
4134* Se você mantém o plugin e o motivo diz para onde o manifesto resolve, a pasta `.claude-plugin` ou o próprio `plugin.json` é um symlink que leva até lá. Substitua esse link por uma cópia daquilo para o que ele aponta.
4135* Se você instalou o plugin e não o mantém, relate a mensagem ao autor dele
4136
4035### Path could not be checked4137### Path could not be checked
4036 4138
4037Claude Code perguntou ao sistema operacional se um caminho de plugin existe e recebeu um erro diferente de "não encontrado", então ele não carrega o que o caminho nomeia. Quanto do plugin carrega depende de qual caminho falhou:4139Claude Code perguntou ao sistema operacional se um caminho de plugin existe e recebeu um erro diferente de "não encontrado", então ele não carrega o que o caminho nomeia. Quanto do plugin carrega depende de qual caminho falhou:
4226 4328
4227Antes 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.4329Antes 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.
4228 4330
4331### File is too large to read as an image
4332
4333Claude tentou ler um arquivo como imagem com a [ferramenta Read](/docs/pt/tools-reference#read-tool-behavior), e o arquivo é maior que 128 MB, o máximo que Read carrega de um arquivo de imagem. Nada foi lido, e Claude recebe este erro como o resultado da ferramenta:
4334
4335```text wrap theme={null}
4336File is too large to read as an image (the limit is 128MB): <path>. If it is an image, resize it or export a smaller copy, then read that.
4337```
4338
4339Quando o caminho é um pipe ou um dispositivo em vez de um arquivo regular, Read para assim que mais de 128 MB tiverem chegado e retorna este erro em vez disso:
4340
4341```text wrap theme={null}
4342Cannot read this as an image: <path> is a pipe or a device, not a regular file, and it sent more than 128MB without ending.
4343```
4344
4345**O que fazer:**
4346
4347* Se Claude seguiu a mensagem `File is too large` e passou a redimensionar a imagem ou ler uma cópia menor, não faça nada
4348* Se Claude parou no erro, exporte você mesmo uma cópia com menos de 128 MB, por exemplo em uma resolução menor, e aponte Claude para esse arquivo
4349* Se o caminho era um pipe ou um dispositivo, aponte Claude para um arquivo de imagem regular em vez disso
4350
4229### subagent\_type é obrigatório4351### subagent\_type é obrigatório
4230 4352
4231```text theme={null}4353```text theme={null}
4316* Execute `claude` na pasta que o [log de debug](/docs/pt/debug-your-config) nomeia e aceite o diálogo de confiança. A definição é reaplicada na próxima vez que Claude Code traz o colega de volta; você não precisa reiniciar a sessão de liderança4438* Execute `claude` na pasta que o [log de debug](/docs/pt/debug-your-config) nomeia e aceite o diálogo de confiança. A definição é reaplicada na próxima vez que Claude Code traz o colega de volta; você não precisa reiniciar a sessão de liderança
4317* Ou defina a entrada `hasTrustDialogAccepted` para `true` em `~/.claude.json`, usando a chave exata `projects["<path>"]` que o log de debug imprime4439* Ou defina a entrada `hasTrustDialogAccepted` para `true` em `~/.claude.json`, usando a chave exata `projects["<path>"]` que o log de debug imprime
4318 4440
4441### Only a teammate can approve a shutdown request
4442
4443Claude Code recusou uma aprovação de encerramento de [equipe de agentes](/docs/pt/agent-teams) porque a sessão que a enviou não está sendo executada como um colega. Nada foi enviado e nada foi encerrado. A recusa aparece no resultado da ferramenta da sessão remetente:
4444
4445```text wrap theme={null}
4446Only a teammate can approve a shutdown request, and this session is not running as one. Nothing was sent. To shut down a teammate, send that teammate a shutdown_request message. The teammate is the one that approves it.
4447```
4448
4449**O que fazer:**
4450
4451* Se a recusa apareceu na sua sessão de liderança, primeiro verifique se o colega já foi encerrado desde então. A recusa volta ao Claude com a instrução de enviar um `shutdown_request` em vez disso, e o turno continua. Em uma sessão de liderança interativa, `<name> has shut down.` aparece quando o colega aprova uma solicitação de encerramento.
4452* Se o colega ainda estiver em execução, peça ao líder em seu prompt para encerrar o colega, por exemplo `Ask the researcher teammate to shut down`. Veja [Encerrar colegas](/docs/pt/agent-teams#shut-down-teammates).
4453* Se um antigo colega que você mesmo retomou com `claude --resume` recebeu essa recusa, nada foi enviado. Para encerrar essa sessão, execute `/exit` em seu prompt.
4454
4319### Mensagem muito grande para entrega entre sessões4455### Mensagem muito grande para entrega entre sessões
4320 4456
4321A [mensagem entre sessões](/docs/pt/cross-session-messaging) do Claude para outra de suas sessões nesta máquina era muito longa para enviar. Claude Code a recusou, e a sessão receptora não recebeu nada. A recusa aparece no resultado da ferramenta da sessão remetente, não como um banner em seu terminal. Ela nomeia ambos os tamanhos e como fazer a mensagem caber:4457A [mensagem entre sessões](/docs/pt/cross-session-messaging) do Claude para outra de suas sessões nesta máquina era muito longa para enviar. Claude Code a recusou, e a sessão receptora não recebeu nada. A recusa aparece no resultado da ferramenta da sessão remetente, não como um banner em seu terminal. Ela nomeia ambos os tamanhos e como fazer a mensagem caber:
4449 4585
4450### Cota de disco ou sistema de arquivos temporário está cheio4586### Cota de disco ou sistema de arquivos temporário está cheio
4451 4587
4452Claude 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, Claude Code verifica se o sistema de arquivos que contém esse arquivo está sem espaço ou inodes, ou se sua cota de disco nele está esgotada. Se assim for, um diagnóstico aparece no resultado do comando no lugar da saída vazia:4588Claude Code salva a saída de cada comando Bash e PowerShell em um arquivo sob seu diretório temporário. Estas mensagens no resultado de um comando significam que o sistema de arquivos que contém esse diretório, ou sua cota de disco nele, está cheio.
4589
4590Se Claude Code não consegue criar esse arquivo porque o sistema de arquivos ou sua cota nele está cheio, seu comando não é iniciado, e o resultado diz:
4591
4592```text wrap theme={null}
4593The command was not started: this computer's disk is full (ENOSPC), so the file that captures command output could not be created. Nothing ran. If this is the user's own computer, tell them before deleting anything to make room.
4594```
4595
4596Quando um comando sai com um código diferente de zero e nenhuma saída, Claude Code verifica o sistema de arquivos que contém o arquivo de saída. Se esse sistema de arquivos está sem espaço ou inodes, ou sua cota de disco nele está esgotada, um diagnóstico substitui a saída vazia no resultado do comando:
4453 4597
4454```text wrap theme={null}4598```text wrap theme={null}
4455Your 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.4599Your 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.
4460* `Your disk quota is full ... (EDQUOT)`: sua própria cota nesse sistema de arquivos está esgotada. Uma cota pode estar cheia enquanto o sistema de arquivos ainda mostra espaço livre4604* `Your disk quota is full ... (EDQUOT)`: sua própria cota nesse sistema de arquivos está esgotada. Uma cota pode estar cheia enquanto o sistema de arquivos ainda mostra espaço livre
4461* `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 mais espaço4605* `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 mais espaço
4462* `Command output was lost: the temp filesystem at ... is full` ou `... is out of inodes`: o sistema de arquivos quase não tem espaço livre, ou está ficando sem inodes4606* `Command output was lost: the temp filesystem at ... is full` ou `... is out of inodes`: o sistema de arquivos quase não tem espaço livre, ou está ficando sem inodes
4607* `The command was not started: this computer's disk is full (ENOSPC)` ou `... (EDQUOT)`: o sistema de arquivos não tem espaço para o arquivo de saída, ou, com `EDQUOT`, sua própria cota nele está esgotada
4463 4608
4464**O que fazer:**4609**O que fazer:**
4465 4610
4466* Delete arquivos que você não precisa mais no sistema de arquivos que contém o diretório temporário do 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 ocupa um inode qualquer que seja seu tamanho4611* Delete arquivos que você não precisa mais no sistema de arquivos que contém o diretório temporário do Claude Code. Se sua mensagem não nomeia esse diretório, consulte seu local padrão na referência de [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars). 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 ocupa um inode qualquer que seja seu tamanho
4467* Ou reinicie Claude Code com [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars) definido para um diretório em um sistema de arquivos com espaço4612* 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
4468* Então peça ao Claude para executar o comando novamente. A saída que ele imprimiu foi perdida, não truncada4613* Então peça ao Claude para executar o comando novamente
4614
4615Antes da v2.1.305, um comando que Claude Code não conseguia iniciar porque o disco estava cheio retornava apenas o texto de erro do sistema operacional. Esse texto dizia, por exemplo, `ENOSPC: no space left on device, open <path>.output`.
4469 4616
4470### File is not valid UTF-84617### File is not valid UTF-8
4471 4618
4524* No Windows, para deixar Claude publicar diretamente do compartilhamento, mapeie-o para uma letra de unidade e passe a unidade quando iniciar Claude Code. No PowerShell, por exemplo, execute `net use Z: \\server\share` e depois `claude --add-dir Z:\`. Claude poderá então publicar arquivos dessa unidade. Adicionar a unidade no meio da sessão com `/add-dir` não é suficiente.4671* No Windows, para deixar Claude publicar diretamente do compartilhamento, mapeie-o para uma letra de unidade e passe a unidade quando iniciar Claude Code. No PowerShell, por exemplo, execute `net use Z: \\server\share` e depois `claude --add-dir Z:\`. Claude poderá então publicar arquivos dessa unidade. Adicionar a unidade no meio da sessão com `/add-dir` não é suficiente.
4525* No macOS ou Linux, monte o compartilhamento em um diretório, como um sob `/mnt` ou `/Volumes`, e publique a partir desse caminho em vez do caminho de automount4672* No macOS ou Linux, monte o compartilhamento em um diretório, como um sob `/mnt` ou `/Volumes`, e publique a partir desse caminho em vez do caminho de automount
4526 4673
4674### Not published: Claude sent the same content again after a newer version of the artifact turned it away
4675
4676Esta linha vermelha sob uma chamada Artifact significa que Claude Code interrompeu uma publicação repetida: o [artefato](/docs/pt/artifacts) não foi atualizado, e nada foi escrito no arquivo a partir do qual Claude publica. Você não precisa fazer nada, a menos que Claude pare sem publicar.
4677
4678Anteriormente na sessão, Claude Code recusou uma publicação porque o artefato tinha uma versão mais recente, por exemplo uma que um [editor](/docs/pt/artifacts#let-someone-edit-with-you) ou outra de suas sessões publicou. O final da linha diz o que Claude precisa fazer a seguir:
4679
4680```text wrap theme={null}
4681Not published: Claude sent the same content again after a newer version of the artifact turned it away. Claude needs to work from that newer version first.
4682Not published: Claude sent the same content again after a newer version of the artifact turned it away. The artifact hasn't changed since, so publishing it once more should go through.
4683Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. Claude needs to work from that newer version first.
4684Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. The artifact hasn't changed since, so publishing once more should go through.
4685```
4686
4687**O que fazer:**
4688
4689* **Termina com `Claude needs to work from that newer version first`**: se Claude parou aí, peça a ele para buscar a versão atual do artefato, mesclar suas alterações nela e publicar novamente
4690* **Termina com `should go through`**: se Claude parou aí, peça a ele para publicar novamente
4691
4527### Lendo um arquivo local de fora das pastas conectadas em uma sessão Cowork4692### Lendo um arquivo local de fora das pastas conectadas em uma sessão Cowork
4528 4693
4529Em uma sessão [Cowork](https://claude.com/docs/cowork/overview) em execução em sua máquina no aplicativo Claude Desktop, Claude nomeou um arquivo local para um [artefato](/docs/pt/artifacts). Claude Code não conseguiu confirmar que o arquivo é um arquivo simples dentro das pastas conectadas da sessão: o caminho fica fora dessas pastas, passa através de um link simbólico, ou é escrito de uma forma que pode nomear um arquivo diferente do que parece. Ler tal arquivo precisa de sua aprovação, e em uma sessão que não pode mostrar a você o cartão de aprovação, como uma configurada para pular todas as aprovações, Claude Code recusa a leitura.4694Em uma sessão [Cowork](https://claude.com/docs/cowork/overview) em execução em sua máquina no aplicativo Claude Desktop, Claude nomeou um arquivo local para um [artefato](/docs/pt/artifacts). Claude Code não conseguiu confirmar que o arquivo é um arquivo simples dentro das pastas conectadas da sessão: o caminho fica fora dessas pastas, passa através de um link simbólico, ou é escrito de uma forma que pode nomear um arquivo diferente do que parece. Ler tal arquivo precisa de sua aprovação, e em uma sessão que não pode mostrar a você o cartão de aprovação, como uma configurada para pular todas as aprovações, Claude Code recusa a leitura.
4816* Para continuar o loop, [responda à sessão](/docs/pt/agent-view#peek-and-reply) e diga isso, como `keep the loop running`. Claude lê o aviso com sua resposta e pode agendar o próximo despertar4981* Para continuar o loop, [responda à sessão](/docs/pt/agent-view#peek-and-reply) e diga isso, como `keep the loop running`. Claude lê o aviso com sua resposta e pode agendar o próximo despertar
4817* Se você terminou com o loop, não faça nada. Ele já parou4982* Se você terminou com o loop, não faça nada. Ele já parou
4818 4983
4984### No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder
4985
4986A [sessão em background](/docs/pt/agent-view) que mostra esta mensagem não está usando seu [gateway de LLM](/docs/pt/llm-gateway): ela não recebeu o endereço do gateway, portanto suas requisições falham. A mensagem aparece na conversa no lugar da resposta de Claude, com o ID e a pasta da sua sessão preenchidos:
4987
4988```text wrap theme={null}
4989No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder. To fix, run `claude respawn abc12345` from ~/project in another terminal where your gateway is set, or set ANTHROPIC_BASE_URL and its API key or token in a settings file's env block.
4990```
4991
4992Enquanto você está conectado à sessão, o aviso sob seu prompt mostra a forma curta `No LLM gateway: opened from another folder · respawn from ~/project`.
4993
4994Você despachou, acordou ou reiniciou a sessão a partir de uma pasta diferente daquela que a mensagem nomeia, enquanto `ANTHROPIC_BASE_URL` estava definido para seu gateway. Para os casos em que um gateway exportado no shell chega a uma sessão em background, consulte [LLM gateway](/docs/pt/agent-view#llm-gateway).
4995
4996**O que fazer:**
4997
4998* **Você usou a agent view em um projeto cujas configurações definem o gateway**: coloque `ANTHROPIC_BASE_URL` e sua chave de API ou token no [bloco `env` de um arquivo de configurações](/docs/pt/llm-gateway-connect#set-in-a-settings-file). Use `~/.claude/settings.json`, ou `.claude/settings.local.json` no próprio projeto da sessão, ambos lidos por uma sessão reiniciada com respawn. Depois execute `claude respawn <id>` no seu shell a partir de qualquer pasta.
4999* **Você exportou o gateway no seu terminal**: em um terminal onde você exportou as variáveis do gateway, use `cd` para ir à pasta que a mensagem nomeia e execute o comando `claude respawn <id>` da mensagem. A sessão reinicia a partir de sua conversa salva.
5000 * O gateway chega à sessão apenas quando o [supervisor](/docs/pt/agent-view#the-supervisor-process) foi ele próprio iniciado a partir de um shell que exportou o mesmo gateway. Se o supervisor não foi, reinicie-o a partir desse terminal como descreve [O despacho falha com `Could not resolve authentication method`](/docs/pt/agent-view#dispatch-fails-with-could-not-resolve-authentication-method), depois execute o comando respawn novamente.
5001
5002Antes da v2.1.302, uma sessão em background nessa situação mostrava um erro de login como [`Not logged in · Please run /login`](#not-logged-in) em vez disso, sem nomear a pasta.
5003
4819### Erros do launcher CLAUDE\_CODE\_PROCESS\_WRAPPER5004### Erros do launcher CLAUDE\_CODE\_PROCESS\_WRAPPER
4820 5005
4821[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/pt/corporate-launcher) está definido, e seu valor não pode ser usado, portanto Claude Code recusa iniciar o processo afetado em vez de executá-lo sem o launcher. Problemas de configuração são relatados com uma mensagem que começa com o nome da variável e declara a razão, por exemplo:5006[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/pt/corporate-launcher) está definido, e seu valor não pode ser usado, portanto Claude Code recusa iniciar o processo afetado em vez de executá-lo sem o launcher. Problemas de configuração são relatados com uma mensagem que começa com o nome da variável e declara a razão, por exemplo:
5094 5279
5095## Avisos de configuração5280## Avisos de configuração
5096 5281
5097Claude Code escreve a maioria dessas mensagens em stderr, não na conversa, e escreve a maioria delas na inicialização. Uma entrada diz assim quando sua mensagem aparece em outro lugar, como no log de depuração ou como um aviso de inicialização na visualização de conversa, ou em outro momento, como a [linha de diagnóstico de modelo não reconhecido](#unrecognized-model-id-on-a-request) no momento da solicitação.5282Para encontrar um aviso que Claude Code deu na inicialização em uma sessão interativa, procure primeiro abaixo do banner de inicialização e depois no log de depuração:
5283
5284* **Linha abaixo do banner de inicialização**: alguns avisos sobre [regras de permissão](/docs/pt/permissions), como [`⚠ Deny rule Bsh matches no tool · check for typos`](#matches-no-tool)
5285* **Log de depuração**: Claude Code mantém este log apenas no modo de depuração. Para ler os avisos nele, inicie Claude Code a partir do seu shell com `claude --debug-file <path>` e depois abra o arquivo nesse caminho.
5286
5287No [modo não interativo](/docs/pt/headless) com saída de texto, fora de uma [sessão em segundo plano](/docs/pt/agent-view), procure os avisos de inicialização em stderr.
5288
5289Antes da v2.1.305, procure em stderr também em uma sessão interativa, incluindo os avisos de regras de permissão que agora aparecem como linhas abaixo do banner.
5098 5290
5099### Claude Code saiu após um erro de interface irrecuperável5291### Claude Code saiu após um erro de interface irrecuperável
5100 5292
5214 5406
5215### O diretório de trabalho é um caminho de rede5407### O diretório de trabalho é um caminho de rede
5216 5408
5217Claude Code não adiciona caminhos de rede como diretórios de trabalho. Procurar um caminho de rede pode entrar em contato com o host que ele nomeia, e no Windows esse contato pode enviar suas credenciais ao host, então Claude Code recusa o caminho sem procurá-lo. Você vê esta mensagem quando executa `/add-dir` com tal caminho, ou como um aviso na inicialização. Quando aparece na inicialização, Claude Code inicia sem esse diretório.5409Claude Code não adiciona caminhos de rede como diretórios de trabalho. Procurar um caminho de rede pode entrar em contato com o host que ele nomeia, e no Windows esse contato pode enviar suas credenciais ao host. Portanto, Claude Code recusa o caminho sem procurá-lo.
5410
5411Você vê esta mensagem quando executa `/add-dir` com um caminho de rede:
5218 5412
5219```text theme={null}5413```text theme={null}
5220\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).5414\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).
5221```5415```
5222 5416
5417Quando, em vez disso, você passa um na inicialização, com `--add-dir` ou em `permissions.additionalDirectories`, Claude Code inicia sem esse diretório. Em uma sessão interativa, você não vê a mensagem na inicialização, porque ela vai para o log de depuração junto com os outros [avisos de inicialização](#configuration-warnings).
5418
5223Os caminhos que Claude Code recusa desta forma incluem:5419Os caminhos que Claude Code recusa desta forma incluem:
5224 5420
5225* Compartilhamentos UNC como `\\server\share`5421* Compartilhamentos UNC como `\\server\share`
5465 5661
5466Antes da v2.1.260, Claude Code relatava uma regra com parênteses não correspondentes como `Mismatched parentheses`.5662Antes da v2.1.260, Claude Code relatava uma regra com parênteses não correspondentes como `Mismatched parentheses`.
5467 5663
5468### Não é correspondido pelas verificações de permissão de arquivo5664### Matches no tool · check for typos
5665
5666Esta linha abaixo do banner de inicialização nomeia uma [regra de permissão](/docs/pt/permissions) deny ou ask cujo nome de ferramenta Claude Code não reconhece, então a regra não se aplica à ferramenta que você pretendia. Uma regra deny escrita como `Bsh` não é aplicada a Bash, nem uma que usa o rótulo que uma ferramenta mostra na transcrição em vez de seu nome canônico. A linha repete a regra como você a escreveu:
5667
5668```text theme={null}
5669⚠ Deny rule Bsh matches no tool · check for typos
5670```
5469 5671
5470Claude Code encontrou uma regra `Write`, `NotebookEdit`, `MultiEdit` ou `Glob` [permissão](/docs/pt/permissions#read-and-edit) com um caminho em um de seus [arquivos de configurações](/docs/pt/settings#where-settings-live), em [configurações gerenciadas](/docs/pt/managed-settings), ou em um valor de flag `--allowedTools`, `--disallowedTools` ou `--settings`. Ele verifica permissões de arquivo apenas contra regras `Edit` e `Read`, então nunca consulta uma regra de caminho que nomeia uma das outras ferramentas de arquivo. Ele mantém a regra e não muda mais nada; o aviso nomeia a regra, sua fonte entre parênteses e a substituição a escrever:5672No [modo não interativo](/docs/pt/headless) com saída de texto, Claude Code imprime o aviso em stderr em sua forma mais longa:
5471 5673
5472```text theme={null}5674```text theme={null}
5473Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).5675Permission deny rule "Bsh" matches no known tool — check for typos.
5474```5676```
5475 5677
5476**O que fazer:**5678**O que fazer:**
5477 5679
5680* Corrija o nome da ferramenta na regra, por exemplo `Bash` em vez de `Bsh`. Consulte os nomes canônicos na [referência de ferramentas](/docs/pt/tools-reference).
5681* Para descobrir onde a regra está definida, execute `/permissions` na sessão e selecione a regra. Seus detalhes dizem de onde ela vem, como `From project local settings`, ou `From CLI argument` para um valor de `--disallowedTools`.
5682* Se os detalhes disserem `From enterprise managed settings`, encaminhe a linha a quem mantém suas [configurações gerenciadas](/docs/pt/managed-settings), já que você não pode alterar essa regra por conta própria.
5683
5684Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`.
5685
5686Antes da v2.1.305, uma sessão interativa imprimia a forma mais longa em stderr na inicialização em vez de mostrar a linha.
5687
5688### Não é correspondido pelas verificações de permissão de arquivo
5689
5690Claude Code encontrou uma [regra de permissão](/docs/pt/permissions#read-and-edit) `Write`, `NotebookEdit`, `MultiEdit` ou `Glob` com um caminho em um de seus [arquivos de configurações](/docs/pt/settings#where-settings-live), em [configurações gerenciadas](/docs/pt/managed-settings), ou em um valor da flag `--allowedTools`, `--disallowedTools` ou `--settings`. Ele verifica permissões de arquivo apenas contra regras `Edit` e `Read`, então nunca consulta uma regra de caminho que nomeia uma das outras ferramentas de arquivo. Ele mantém a regra e não muda mais nada.
5691
5692* **Sessão interativa**: o aviso completo vai para o [log de depuração](#configuration-warnings), e uma regra deny ou ask com essa forma também aparece como esta linha abaixo do banner de inicialização:
5693
5694 ```text theme={null}
5695 ⚠ Deny rule Write(docs/**) never matches · use Edit(docs/**)
5696 ```
5697
5698 Uma regra allow com essa forma não recebe linha. Para descobrir onde a regra está definida, execute `/permissions` na sessão e selecione a regra.
5699* **[Modo não interativo](/docs/pt/headless) com saída de texto**: o aviso completo em stderr nomeia a regra, sua fonte entre parênteses e a substituição a escrever:
5700
5701 ```text theme={null}
5702 Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).
5703 ```
5704* **[Sessão em segundo plano](/docs/pt/agent-view), ou `--output-format json` ou `stream-json`**: o aviso completo vai para o log de depuração em vez de stderr, então a saída lida por máquina fica limpa. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`.
5705
5706**O que fazer:**
5707
5478* Substitua as regras `Write(path)`, `NotebookEdit(path)` e `MultiEdit(path)` legadas por `Edit(path)`. As regras `Edit` cobrem todas as ferramentas de edição de arquivo.5708* Substitua as regras `Write(path)`, `NotebookEdit(path)` e `MultiEdit(path)` legadas por `Edit(path)`. As regras `Edit` cobrem todas as ferramentas de edição de arquivo.
5479* Exceto em `--allowedTools`, onde Claude Code aceita uma regra `Glob` sem aviso, substitua as regras `Glob(path)` por `Read(path)`.5709* Exceto em `--allowedTools`, onde Claude Code aceita uma regra `Glob` sem aviso, substitua as regras `Glob(path)` por `Read(path)`.
5480* Corrija a regra na fonte que o aviso nomeia entre parênteses: um caminho de arquivo de configurações, ou o próprio flag para `--allowed-tools` e `--disallowed-tools`. Um caminho `claude-settings-<hash>.json` que não existe no disco representa um valor `--settings` inline. Corrija o JSON que você passa para esse flag.5710* Corrija a regra em sua fonte, que o aviso completo nomeia entre parênteses: um caminho de arquivo de configurações, ou a própria flag para `--allowed-tools` e `--disallowed-tools`. Um caminho `claude-settings-<hash>.json` que não existe no disco representa um valor `--settings` inline. Corrija o JSON que você passa para essa flag.
5481* Deixe as regras de nome de ferramenta simples como `Write` ou `Glob` sozinhas. Claude Code as corresponde no [nível de ferramenta](/docs/pt/permissions#match-all-uses-of-a-tool) e não avisa sobre elas.5711* Deixe as regras de nome de ferramenta simples como `Write` ou `Glob` sozinhas. Claude Code as corresponde no [nível de ferramenta](/docs/pt/permissions#match-all-uses-of-a-tool) e não avisa sobre elas.
5482* Se a fonte lê `managed policy settings`, encaminhe o aviso a quem mantém suas configurações gerenciadas, já que você não pode limpá-lo você mesmo.5712* Para uma regra de configurações gerenciadas, os parênteses do aviso completo dizem `managed policy settings` e os detalhes da regra em `/permissions` dizem `From enterprise managed settings`. Encaminhe esse aviso a quem mantém suas configurações gerenciadas, já que você não pode limpá-lo você mesmo.
5483 5713
5484Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr, então a saída lida por máquina fica limpa. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`. Antes da v2.1.210, Claude Code aceitava essas regras sem aviso.5714Antes da v2.1.210, Claude Code aceitava essas regras sem aviso. Antes da v2.1.305, uma sessão interativa imprimia o aviso completo em stderr.
5485 5715
5486### Tem um curinga antes do resto do comando5716### Tem um curinga antes do resto do comando
5487 5717
5488Claude Code encontrou uma regra de permissão `Bash` allow cujo `*` vem antes de uma palavra posterior que determina qual comando é, como `Bash(git * main)` ou `Bash(git -C * status *)`, em um de seus [arquivos de configurações](/docs/pt/settings#where-settings-live), em [configurações gerenciadas](/docs/pt/managed-settings), ou em um valor de flag `--allowedTools` ou `--settings`. O `*` corresponde a qualquer texto, incluindo opções inseridas nessa posição: `Bash(git * main)` também aprova `git -c core.fsmonitor=<script> diff main`, onde `-c` faz git executar um programa que o comando nomeia. [Padrões de curinga](/docs/pt/permissions#wildcard-patterns) mostra as regras de correspondência.5718Claude Code encontrou uma regra de permissão `Bash` allow cujo `*` vem antes de uma palavra posterior que determina qual comando é, como `Bash(git * main)` ou `Bash(git -C * status *)`, em um de seus [arquivos de configurações](/docs/pt/settings#where-settings-live), em [configurações gerenciadas](/docs/pt/managed-settings), ou em um valor de flag `--allowedTools` ou `--settings`. O `*` corresponde a qualquer texto, incluindo opções inseridas nessa posição: `Bash(git * main)` também aprova `git -c core.fsmonitor=<script> diff main`, onde `-c` faz git executar um programa que o comando nomeia. [Padrões de curinga](/docs/pt/permissions#wildcard-patterns) mostra as regras de correspondência.
5489 5719
5490O aviso existe para que você possa estreitar uma regra cujo curinga é mais amplo do que você pretendia. Claude Code mantém a regra e não muda nada sobre como ela corresponde; o aviso nomeia a regra e sua fonte entre parênteses:5720O aviso existe para que você possa estreitar uma regra cujo curinga é mais amplo do que você pretendia. Claude Code mantém a regra e não muda nada sobre como ela corresponde. No [modo não interativo](/docs/pt/headless) com saída de texto, o aviso em stderr nomeia a regra e sua fonte entre parênteses:
5491 5721
5492```text theme={null}5722```text theme={null}
5493Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).5723Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).
5494```5724```
5495 5725
5726Em uma sessão interativa, o aviso completo vai para o [log de depuração](#configuration-warnings) e a regra aparece como esta linha abaixo do banner de inicialização:
5727
5728```text theme={null}
5729⚠ Allow rule Bash(git -C * status *) allows any option at its * · use an exact value
5730```
5731
5732Para descobrir onde a regra está definida, execute `/permissions` na sessão e selecione a regra.
5733
5496**O que fazer:**5734**O que fazer:**
5497 5735
5498* Substitua o `*` antes do subcomando pelo valor exato que você quer dizer: `Bash(git checkout main)` em vez de `Bash(git * main)`.5736* Substitua o `*` antes do subcomando pelo valor exato que você quer dizer: `Bash(git checkout main)` em vez de `Bash(git * main)`.
5499* Mova cada `*` após o subcomando: `Bash(git status *)` em vez de `Bash(git -C * status *)`. Escreva uma regra por subcomando que você quer permitir.5737* Mova cada `*` após o subcomando: `Bash(git status *)` em vez de `Bash(git -C * status *)`. Escreva uma regra por subcomando que você quer permitir.
5500* Corrija a regra na fonte que o aviso nomeia entre parênteses: um caminho de arquivo de configurações, ou o próprio flag `--allowed-tools`. Um caminho `claude-settings-<hash>.json` que não existe no disco representa um valor `--settings` inline. Corrija o JSON que você passa para esse flag.5738* Corrija a regra em sua fonte, que o aviso completo nomeia entre parênteses: um caminho de arquivo de configurações, ou a própria flag `--allowed-tools`. Um caminho `claude-settings-<hash>.json` que não existe no disco representa um valor `--settings` inline. Corrija o JSON que você passa para essa flag.
5501* Se a fonte lê `managed policy settings`, encaminhe o aviso a quem mantém suas configurações gerenciadas, já que você não pode limpá-lo você mesmo.5739* Para uma regra de configurações gerenciadas, os parênteses do aviso completo dizem `managed policy settings` e os detalhes da regra em `/permissions` dizem `From enterprise managed settings`. Encaminhe esse aviso a quem mantém suas configurações gerenciadas, já que você não pode limpá-lo você mesmo.
5502 5740
5503Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr, então a saída lida por máquina fica limpa. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`. Antes da v2.1.246, Claude Code aceitava essas regras sem aviso.5741Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr, então a saída lida por máquina fica limpa. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`. Antes da v2.1.246, Claude Code aceitava essas regras sem aviso.
5504 5742
5743Antes da v2.1.305, uma sessão interativa imprimia o aviso completo em stderr em vez de mostrar uma linha.
5744
5505### Negar Bash também desativa a ferramenta PowerShell5745### Negar Bash também desativa a ferramenta PowerShell
5506 5746
5507Você removeu a ferramenta Bash inteira, por exemplo com `--disallowedTools Bash` ou com uma [regra deny](/docs/pt/permissions#match-all-uses-of-a-tool) `Bash` ou `Bash(*)` simples em um de seus arquivos de configurações. No Windows com Git Bash instalado, [negar Bash também desativa a ferramenta PowerShell](/docs/pt/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool), então a sessão inicia sem nenhuma ferramenta de shell. Claude Code imprime este aviso na inicialização:5747Você removeu a ferramenta Bash inteira, por exemplo com `--disallowedTools Bash` ou com uma [regra deny](/docs/pt/permissions#match-all-uses-of-a-tool) `Bash` ou `Bash(*)` simples em um de seus arquivos de configurações. No Windows com Git Bash instalado, [negar Bash também desativa a ferramenta PowerShell](/docs/pt/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool), então a sessão inicia sem nenhuma ferramenta de shell.
5748
5749No [modo não interativo](/docs/pt/headless) com saída de texto, Claude Code imprime este aviso em stderr na inicialização, e uma sessão interativa o escreve apenas no [log de depuração](#configuration-warnings):
5508 5750
5509```text theme={null}5751```text theme={null}
5510Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.5752Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.
5517 5759
5518Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`. Antes da v2.1.287, Claude Code desativava a ferramenta PowerShell da mesma forma sem imprimir um aviso.5760Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`. Antes da v2.1.287, Claude Code desativava a ferramenta PowerShell da mesma forma sem imprimir um aviso.
5519 5761
5762Antes da v2.1.305, uma sessão interativa também imprimia o aviso em stderr na inicialização.
5763
5520### crossSessionInbound deve ser um de accept, hold, refuse5764### crossSessionInbound deve ser um de accept, hold, refuse
5521 5765
5522Um arquivo de configurações define [`crossSessionInbound`](/docs/pt/settings-reference#crosssessioninbound) para um valor que Claude Code não reconhece, como o erro de digitação `"reject"`. A segunda frase do aviso depende de qual arquivo contém o valor; em um arquivo de usuário, projeto, local ou `--settings`, lê:5766Um arquivo de configurações define [`crossSessionInbound`](/docs/pt/settings-reference#crosssessioninbound) para um valor que Claude Code não reconhece, como o erro de digitação `"reject"`. A segunda frase do aviso depende de qual arquivo contém o valor; em um arquivo de usuário, projeto, local ou `--settings`, lê:
5566* Se a mensagem nomear um ID de modelo que esta versão não reconhece, execute `claude update`. Uma versão que reconhece o ID como um modelo de contexto 1M aplica o limite sem configuração adicional.5810* Se a mensagem nomear um ID de modelo que esta versão não reconhece, execute `claude update`. Uma versão que reconhece o ID como um modelo de contexto 1M aplica o limite sem configuração adicional.
5567* Se você quer que a sessão use a janela completa do modelo, desdefina `CLAUDE_CODE_DISABLE_1M_CONTEXT`; o aviso relata apenas que o limite de 200K não é aplicado5811* Se você quer que a sessão use a janela completa do modelo, desdefina `CLAUDE_CODE_DISABLE_1M_CONTEXT`; o aviso relata apenas que o limite de 200K não é aplicado
5568 5812
5569Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr.5813No [modo não interativo](/docs/pt/headless) com saída de texto, este aviso aparece em stderr. Em uma sessão interativa, em uma [sessão em segundo plano](/docs/pt/agent-view), ou com `--output-format json` ou `stream-json`, ele vai para o log de depuração. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`.
5814
5815Antes da v2.1.305, uma sessão interativa imprimia o aviso em stderr na inicialização.
5570 5816
5571### ID de modelo não reconhecido em uma solicitação5817### ID de modelo não reconhecido em uma solicitação
5572 5818
5678Se um erro não estiver listado aqui ou a correção sugerida não ajudar:5924Se um erro não estiver listado aqui ou a correção sugerida não ajudar:
5679 5925
5680* Execute `/feedback` dentro do Claude Code para enviar a transcrição e uma descrição para a Anthropic. O comando também oferece abrir um problema do GitHub pré-preenchido. O envio para a Anthropic requer [autenticação](/docs/pt/authentication). No Amazon Bedrock, na plataforma de agentes do Google Cloud, no Microsoft Foundry e em outros provedores terceirizados, ou quando nenhuma credencial da Anthropic está configurada, `/feedback` salva um arquivo local que você pode enviar para seu representante de conta da Anthropic.5926* Execute `/feedback` dentro do Claude Code para enviar a transcrição e uma descrição para a Anthropic. O comando também oferece abrir um problema do GitHub pré-preenchido. O envio para a Anthropic requer [autenticação](/docs/pt/authentication). No Amazon Bedrock, na plataforma de agentes do Google Cloud, no Microsoft Foundry e em outros provedores terceirizados, ou quando nenhuma credencial da Anthropic está configurada, `/feedback` salva um arquivo local que você pode enviar para seu representante de conta da Anthropic.
5927* Se `/feedback` responder que está desativado pela política da sua organização, consulte [a entrada dessa mensagem](#feedback-is-disabled-by-your-organizations-policy)
5681* Execute `claude doctor` do seu shell para um diagnóstico somente leitura da sua instalação, ou execute o checkup `/doctor` dentro do Claude Code para encontrar e corrigir problemas de configuração5928* Execute `claude doctor` do seu shell para um diagnóstico somente leitura da sua instalação, ou execute o checkup `/doctor` dentro do Claude Code para encontrar e corrigir problemas de configuração
5682* Verifique [status.claude.com](https://status.claude.com) para incidentes ativos5929* Verifique [status.claude.com](https://status.claude.com) para incidentes ativos
5683* Pesquise [problemas existentes](https://github.com/anthropics/claude-code/issues) no GitHub5930* Pesquise [problemas existentes](https://github.com/anthropics/claude-code/issues) no GitHub
