> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência de erros

> Procure mensagens de erro de tempo de execução do Claude Code com o que cada uma significa e como corrigi-la.

Esta página lista erros de tempo de execução que o Claude Code exibe e como se recuperar de cada um, além do que verificar quando as respostas parecem estar erradas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Solucionar problemas de instalação e login](https://code.claude.com/docs/pt/troubleshoot-install.md).

Exceto pelos [erros de Wrapper e IDE](#wrapper-and-ide-errors), que o programa de inicialização imprime em vez do próprio Claude Code, esses erros e comandos de recuperação se aplicam em toda a CLI, no [aplicativo Desktop](https://code.claude.com/docs/pt/desktop.md) e [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), já que todos os três envolvem o mesmo CLI do Claude Code. Para outros problemas específicos da superfície, consulte a seção de solução de problemas na página dessa superfície.

> [!NOTE]
>
> O Claude Code chama a API Claude para respostas de modelo, portanto, a maioria dos erros de tempo de execução mapeia para um código de erro de API subjacente. Esta página cobre o que cada erro significa dentro do Claude Code e como se recuperar. Para as definições de código de status HTTP bruto, consulte a [referência de erro da Plataforma Claude](https://platform.claude.com/docs/en/api/errors).

## Encontre seu erro

Corresponda a mensagem que você vê a uma seção abaixo.

| Mensagem | Seção |
| :- | :- |
| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |
| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |
| `Opus is experiencing high load` / `Fable is experiencing high load` | [Server errors](#api-error-repeated-529-overloaded-errors) |
| `Request timed out` | [Server errors](#request-timed-out), ou [Network](#unable-to-connect-to-api) se a mensagem mencionar sua conexão com a internet |
| `API Error: No response from API` | [Server errors](#no-response-from-api) |
| `API Error: Stream idle timeout - no chunks received` | [Streaming idle watchdogs](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs), ou [Long thinking ends in proxy timeouts](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md#long-thinking-ends-in-proxy-timeouts) por trás de um gateway de aplicativos Claude |
| `Server error mid-response. The response above may be incomplete.` | [Server errors](#the-response-above-may-be-incomplete) |
| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Server errors](#the-response-above-may-be-incomplete) |
| `Connection closed mid-response` / `Response stalled mid-stream` | [Server errors](#the-response-above-may-be-incomplete) |
| `Part of the response never arrived` / `The response stream was malformed` | [Server errors](#the-response-above-may-be-incomplete) |
| `API Error: Content block not found` / `API Error: Content block already closed` / `API Error: Stream event unreadable` | [Server errors](#the-response-above-may-be-incomplete) |
| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Automatic retries](#automatic-retries) |
| `Connection closed while thinking` / `Response stalled while thinking` | [Automatic retries](#automatic-retries) |
| `Connection lost while your computer was asleep` | [Automatic retries](#automatic-retries) |
| `The model's tool call could not be parsed (retry also failed).` | [Automatic retries](#automatic-retries) |
| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `Auto mode could not evaluate this action and is blocking it for safety` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `Not run · auto mode's check had no usable answer` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `Auto mode classifier transcript exceeded context window` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
| `The server-side auto mode classifier gave no verdict` | [Server errors](#the-server-returned-no-safety-verdict) |
| `<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier` | [Server errors](#was-not-reviewed-and-did-not-run) |
| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [Server errors](#the-server-returned-no-safety-verdict) |
| `Agent terminated early due to an API error` | [Server errors](#agent-terminated-early-due-to-an-api-error) |
| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [Usage limits](#youve-hit-your-session-limit) |
| `Usage credits required for 1M context` | [Usage limits](#usage-credits-required-for-1m-context) |
| `Usage credits ran out before the response was finished.` | [Adicionar créditos de uso](https://code.claude.com/docs/pt/costs.md#add-usage-credits-to-your-subscription) |
| `the prompt to confirm went unanswered · nothing was sent`, a partir da v2.1.324 | [Limites de uso](#the-prompt-to-confirm-went-unanswered) |
| `Claude stopped here · send a message to be asked again` | [Limites de uso](#the-prompt-to-confirm-went-unanswered) |
| `Server is temporarily limiting requests` | [Usage limits](#server-is-temporarily-limiting-requests) |
| `Request rejected (429)` | [Usage limits](#request-rejected-429) |
| `Credit balance is too low` | [Usage limits](#credit-balance-is-too-low) |
| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Usage limits](#youve-hit-your-monthly-spend-limit) |
| `Could not update your spend limit` / `Could not remove your spend limit` | [Limites de uso](#could-not-update-your-spend-limit) |
| `spend limit reached` / `spend limit unavailable` / `This request exceeds your group's budget` | [Limites de uso](#spend-limit-reached) |
| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |
| `Couldn't save your login` | [Authentication](#couldnt-save-your-login) |
| `Sign in again to take your previous account or API key off the config file.` | [Autenticação](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |
| `Your account or API key may still be in the config file. Run claude auth logout.` | [Autenticação](#your-account-or-api-key-may-still-be-in-the-config-file) |
| `Authentication required · Sign in again to continue` | [Authentication](#not-logged-in) |
| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |
| `Invalid API key` | [Authentication](#invalid-api-key) |
| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |
| `Your organization's settings need an update` | [Autenticação](#claude-code-didnt-send-your-claude-ai-login) |
| `Couldn't load your organization's settings. Check your connection` | [Autenticação](#claude-code-didnt-send-your-claude-ai-login) |
| `Restart Claude Code to finish signing in` | [Autenticação](#claude-code-didnt-send-your-claude-ai-login) |
| `Invalid auth token · Fix external auth token` | [Authentication](#invalid-request-header-value) |
| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [Authentication](#invalid-request-header-value) |
| `Invalid request header from the environment · Fix the environment variable` | [Authentication](#invalid-request-header-value) |
| `This organization has been disabled` | [Authentication](#this-organization-has-been-disabled) |
| `Your organization has disabled API key authentication` | [Authentication](#your-organization-has-disabled-api-key-authentication) |
| `Your organization has disabled Claude subscription access` | [Authentication](#your-organization-has-disabled-claude-subscription-access) |
| `Scheduled tasks are off for your organization` | [Autenticação](#routines-are-disabled-by-your-organizations-policy) |
| `Routines are off for your organization` | [Autenticação](#routines-are-disabled-by-your-organizations-policy) |
| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentication](#remote-control-requires-the-anthropic-api) |
| `OAuth token refresh failed — run /login to re-authenticate` | [Authentication](#remote-control-couldnt-refresh-your-login) |
| `JWT refresh failed: no OAuth token — run /login` | [Authentication](#remote-control-couldnt-refresh-your-login) |
| `Claude.ai login expired` | [Authentication](#remote-control-couldnt-refresh-your-login) |
| `Claude.ai login was rejected — run /login, then /remote-control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
| `OAuth token unavailable — run /login to restore Remote Control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
| `Signed out of Claude — run /login, then /remote-control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
| `Remote Control could not renew this computer's connection` | [Authentication](#remote-control-could-not-renew-this-computers-connection) |
| `signed-in claude.ai account or organization changed on this machine` | [Authentication](#remote-control-stopped-because-the-signed-in-account-changed) |
| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
| `Couldn't verify your organization's policy for remote control` | [Troubleshoot Remote Control](https://code.claude.com/docs/pt/remote-control.md#couldnt-verify-your-organizations-policy-for-remote-control) |
| `Remote Control didn't finish connecting` | [Iniciar uma sessão do Remote Control](https://code.claude.com/docs/pt/remote-control.md#start-a-remote-control-session) |
| `Remote Control is disabled by your organization's policy` | [Troubleshoot Remote Control](https://code.claude.com/docs/pt/remote-control.md#remote-control-is-disabled-by-your-organizations-policy) |
| `Remote Control was turned off by your organization's policy` | [Troubleshoot Remote Control](https://code.claude.com/docs/pt/remote-control.md#remote-control-was-turned-off-by-your-organizations-policy) |
| `Session failed: working folder not found:` | [Solucionar problemas do Remote Control](https://code.claude.com/docs/pt/remote-control.md#working-folder-not-found) |
| `The program file this Remote Control started from is gone` | [Solucionar problemas do Remote Control](https://code.claude.com/docs/pt/remote-control.md#program-file-is-gone) |
| `Session failed: program not found:` | [Solução de problemas do Remote Control](https://code.claude.com/docs/pt/remote-control.md#program-file-is-gone) |
| `Session failed: spawn error:` seguido de uma mensagem `ENOENT` | [Solucionar problemas do Remote Control](https://code.claude.com/docs/pt/remote-control.md#program-file-is-gone) |
| `Remote Control disconnected:` seguido de um motivo que menciona um `share link` | [Remote Control](https://code.claude.com/docs/pt/remote-control.md#what-connected-devices-see) |
| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |
| `Failed to authenticate: OAuth token revoked` | [Authentication](#oauth-token-revoked-or-expired) |
| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentication](#oauth-token-revoked-or-expired) |
| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |
| `Login expired · Please run /login` | [Authentication](#login-expired) |
| `The browser can't return the sign-in to Claude Code automatically` | [Authentication](#couldnt-start-the-local-sign-in-listener) |
| `Couldn't start the local listener that receives the browser sign-in. Try again.` | [Authentication](#couldnt-start-the-local-sign-in-listener) |
| `Failed to start OAuth callback server` | [Authentication](#failed-to-start-oauth-callback-server) |
| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |
| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |
| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
| `Managed settings on this machine configure a Cloud gateway sign-in; run interactive /login to authenticate.` | [`claude auth login`](https://code.claude.com/docs/pt/cli-reference#cli-commands) |
| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |
| `Login reached its time limit · Please run /login` / `Failed to authenticate: this login reached its time limit` | [Autenticação](#login-expired) |
| `Failed to authenticate: your claude.ai login expired` | [Depois que o login expira](https://code.claude.com/docs/pt/authentication.md#after-the-login-expires) |
| `claude.ai login ended · usage now billed to` / `Warning: the claude.ai login on this machine has ended` | [Depois que o login expira](https://code.claude.com/docs/pt/authentication.md#after-the-login-expires) |
| `Could not refresh your login because another Claude Code process is refreshing it` | [Authentication](#could-not-refresh-your-login) |
| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [Authentication](#could-not-refresh-your-login) |
| `Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [Autenticação](#could-not-refresh-your-login-disk-full) |
| `Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [Autenticação](#could-not-refresh-your-login-disk-full) |
| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |
| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |
| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentication](#anthropic-profile-login-expired) |
| `Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile` | [Authentication](#anthropic-profile-login-expired) |
| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile` | [Authentication](#anthropic-profile-login-expired) |
| `does not meet scope requirement user:profile` | [Authentication](#oauth-scope-requirement) |
| `claude.ai rejected the session token` / `session token rejected` | [Authentication](#claude-ai-rejected-the-session-token) |
| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
| `(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) |
| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
| `MCP server "<name>" requires re-authorization (token expired)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
| `Couldn't read the stored credentials for MCP server "<name>", so the request didn't run` | [Authentication](#couldnt-read-the-stored-credentials-for-mcp-server) |
| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentication](#couldnt-read-the-stored-credentials-for-mcp-server) |
| `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) |
| `Issuer mismatch in authorization response (RFC 9207)` | [Authentication](#issuer-mismatch-in-authorization-response) |
| `Stopped an OAuth request` | [Autenticação](#stopped-an-oauth-request) |
| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Authentication](#refusing-to-send-credentials-to-non-https-token-endpoint) |
| `Cloud gateway session expired — run /login to reconnect.` | [Authentication](#cloud-gateway-session-expired) |
| `Cloud gateway <url> no longer accepts this session` | [Authentication](#cloud-gateway-session-expired) |
| `Sign-in timed out while waiting for you to continue. Try again.` | [Authentication](#sign-in-timed-out-while-waiting-for-you-to-continue) |
| `AWS credentials expired or invalid` | [Authentication](#aws-credentials-expired-or-invalid) |
| `AWS authentication failed` | [Authentication](#aws-authentication-failed) |
| `Google Cloud credentials expired or invalid` | [Authentication](#google-cloud-credentials-expired-or-invalid) |
| `Google Cloud authentication failed` | [Authentication](#google-cloud-authentication-failed) |
| `Microsoft Foundry authentication failed` | [Authentication](#microsoft-foundry-authentication-failed) |
| `Gateway refused the request` | [Authentication](#gateway-refused-the-request) |
| `Could not load AWS credentials` / `Could not load Google Cloud credentials` | [Authentication](#could-not-load-aws-or-google-cloud-credentials) |
| `AWS default-chain credential resolve timed out` | [Authentication](#aws-default-chain-credential-resolve-timed-out) |
| `Timed out after 60s waiting for AWS` | [Authentication](#bedrock-setup-verification-timed-out-waiting-for-aws) |
| `A request to AWS timed out. Check your network and proxy settings, then try again.` | [Authentication](#bedrock-setup-verification-timed-out-waiting-for-aws) |
| `Could not load the default credentials` on Google Cloud's Agent Platform | [Authentication](#could-not-load-aws-or-google-cloud-credentials) |
| `Unable to connect to API` | [Network](#unable-to-connect-to-api) |
| `Connection refused —` / `Can't reach the API server —` / `No internet route —` / `Couldn't connect through your proxy` / `Connection dropped`, cada um com um código de erro entre parênteses | [Network](#unable-to-connect-to-api) |
| `Unable to connect to Anthropic services` durante a configuração | [Network](#unable-to-connect-to-anthropic-services) |
| `Unable to fetch your privacy settings at this time` | [Configurações de privacidade no claude.ai](https://claude.ai/settings/data-privacy-controls) |
| `Socket is closed` | [Network](#socket-is-closed) |
| `Waiting for API response · will retry in` | [Automatic retries](#automatic-retries), ou [Network](#unable-to-connect-to-api) se persistir |
| `API returned an empty or malformed response` | [Network](#api-returned-an-empty-or-malformed-response) |
| `Streaming response ended before any complete data was received` | [Network](#streaming-response-ended-before-any-complete-data-was-received) |
| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Network](#bedrock-streaming-response-has-an-unexpected-content-type) |
| `Claude Code used only the certificates that it could read in full from the NODE_EXTRA_CA_CERTS file` / `Claude Code ignored all of the NODE_EXTRA_CA_CERTS file: it holds no certificate that Claude Code can read` | [Certificados de CA personalizados](https://code.claude.com/docs/pt/network-config.md#custom-ca-certificates) |
| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |
| `SSL certificate error (...)` durante login ou inicialização | [Network](#ssl-certificate-errors) |
| `unable to get local issuer certificate` | [Network](#ssl-certificate-errors) |
| `403` com `x-deny-reason: host_not_allowed` em uma sessão na nuvem ou tarefa agendada na nuvem | [Network](#host-not-allowed-in-a-cloud-session) |
| `proxy refused the connection` | [Network](#the-proxy-refused-the-connection) |
| `403` com `GitHub GraphQL is not available from Claude Code sessions` em uma sessão na nuvem | [GitHub proxy](https://code.claude.com/docs/pt/cloud-environments.md#github-proxy) |
| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [Network](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |
| `Failed to fetch session from Sessions API: Failed to fetch session logs` | [Network](#failed-to-fetch-session-from-sessions-api) |
| `Couldn't load the history of cloud session` | [Rede](#couldnt-load-the-history-of-cloud-session) |
| `Couldn't reconnect to your Remote Control session` | [Network](#couldnt-reconnect-to-your-remote-control-session) |
| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Network](#sessions-ended-while-this-machine-was-offline) |
| `Couldn't share the transcript.` | [Network](#couldnt-share-the-transcript) |
| `Couldn't send feedback` | [Network](#couldnt-send-feedback) |
| `Feedback payload too large. Try again without the transcript, or shorten the details.` | [Rede](#feedback-payload-too-large) |
| `MCP server "<name>" connection timed out. Your computer went to sleep or its clock changed while connecting.` | [Network](#mcp-server-connection-timed-out-during-a-sleep-or-clock-change) |
| `Prompt is too long` / `Input is too long for requested model` | [Request errors](#prompt-is-too-long) |
| `Prompt is too long · automatic compaction failed:` | [Request errors](#prompt-is-too-long) |
| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Request errors](#prompt-is-too-long) |
| `Context limit reached · /compact or /clear to continue` | [Request errors](#prompt-is-too-long) |
| `Context limit reached · /clear to continue` | [Request errors](#prompt-is-too-long) |
| `capability_rejected: prompt_too_long` em uma sessão de gateway de aplicativos Claude | [Request errors](#prompt-is-too-long) |
| `upstream rejected the request` / `request too large for this upstream` em uma sessão de gateway de aplicativos Claude | [Upstream error messages](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#upstream-error-messages) |
| `upstream rate limit exceeded` em uma sessão de gateway de aplicativos Claude | [Upstream error messages](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#upstream-error-messages) |
| `all upstreams failed (N attempted)` em uma sessão de gateway de aplicativos Claude | [Upstream error messages](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#upstream-error-messages) |
| `Claude Code may not be enabled for your organization` após um login de gateway de aplicativos Claude | [Claude apps gateway troubleshooting](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md#troubleshooting) |
| `Context exceeds the ...-token limit by ... tokens` na saída `/context` | [Request errors](#context-exceeds-the-token-limit) |
| `Request too large` | [Request errors](#request-too-large) |
| `Request too large for the API's 32MB request limit` | [Request errors](#request-too-large) |
| `Image was too large` | [Request errors](#image-was-too-large) |
| `API Error: an image in the conversation could not be processed and was removed` | [Request errors](#image-was-too-large) |
| `An image in the conversation exceeds the dimension limit for many-image requests` | [Erros de requisição](#image-was-too-large) |
| `Unable to resize image` | [Request errors](#unable-to-resize-image) |
| `Request rejected as unprocessable by the model` | [Request errors](#request-rejected-as-unprocessable-by-the-model) |
| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Request errors](#pdf-errors) |
| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |
| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |
| `N tools left out` ao lado de um servidor em `/mcp` / `Claude wasn't given N tools because the Anthropic API would reject their input schemas` | [Ferramentas com esquemas de entrada inválidos](https://code.claude.com/docs/pt/mcp.md#tools-with-invalid-input-schemas) |
| `Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128` | [Request errors](#mcp-tool-name-over-128-characters) |
| `tools.N.custom.name: String should have at most 128 characters` | [Request errors](#mcp-tool-name-over-128-characters) |
| `tool_use.name: String should have at most 200 characters` | [Request errors](#tool-use-name-over-200-characters) |
| `There's an issue with the selected model` | [Request errors](#theres-an-issue-with-the-selected-model) |
| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |
| `Model ... not found` | [Request errors](#model-not-found) |
| `Couldn't confirm model ... with the API` | [Request errors](#couldnt-confirm-model-with-the-api) |
| `API error: ... · model not changed` | [Request errors](#api-error-model-not-changed) |
| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |
| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |
| `Claude Code ... is older than the minimum version required by your organization's policy` | [Request errors](#claude-code-does-not-support-this-model) |
| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organizations-settings) |
| `Model ... is not available. Your organization restricts model selection.` | [Request errors](#model-is-restricted-by-your-organizations-settings) |
| `Can't switch to the default model` | [Request errors](#cant-switch-to-the-default-model) |
| `Model switch ... blocked by a PreModelSwitch hook` | [Request errors](#model-switch-was-blocked-by-a-premodelswitch-hook) |
| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Request errors](#couldnt-save-it-as-your-default) |
| `is less capable than the current main model` / `Advisor will not activate on the main model` / `cannot advise` | [Request errors](#advisor-is-less-capable-than-the-current-main-model) |
| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |
| `Effort '<level>' isn't available with thinking turned off on this model` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |
| `effort '<level>' is not supported when thinking is disabled` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |
| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |
| `Claude's response exceeded the ... output token maximum` | [Request errors](#response-exceeded-the-output-token-maximum) |
| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |
| `API Error: 400 orphaned tool_result in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |
| `API Error: 400 duplicate tool_use ID in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |
| `Invalid data in redacted_thinking block` | [Request errors](#invalid-data-in-redacted-thinking-block) |
| `[Unsupported tool content removed]` | [Request errors](#unsupported-tool-content-removed) |
| `role 'system' must precede an 'assistant' message` | [Request errors](#role-system-must-precede-an-assistant-message) |
| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Request errors](#invalid-encrypted-content-in-search-result-block) |
| `Invalid encrypted_stdout in encrypted_code_execution_result block` | [Request errors](#invalid-encrypted-content-in-search-result-block) |
| `server_tool_use.name: Input should be` em cada turno de uma sessão retomada | [Request errors](#unsupported-tool-content-removed) |
| `<model> can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |
| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |
| `<model>'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
| `<model>'s safeguards flagged this session` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
| `` Details: `[reasoning_extraction]` `` | [Request errors](#safeguards-flagged-a-request-for-claudes-reasoning) |
| `API Error: Output blocked by content filtering policy` | [Request errors](#output-blocked-by-content-filtering-policy) |
| `Installation was killed before it could finish (exit code 137)` | [Troubleshoot installation and login](https://code.claude.com/docs/pt/troubleshoot-install.md#installation-was-killed-before-it-could-finish) |
| `The connection dropped while downloading the update` | [Troubleshoot installation and login](https://code.claude.com/docs/pt/troubleshoot-install.md#the-connection-dropped-while-downloading-the-update) |
| `Download timed out: exceeded the total deadline` | [Troubleshoot installation and login](https://code.claude.com/docs/pt/troubleshoot-install.md#the-connection-dropped-while-downloading-the-update) |
| `Release verification failed for Claude Code <version> (<reason>). The update was not installed.` | [Troubleshoot installation and login](https://code.claude.com/docs/pt/troubleshoot-install.md#release-verification-failed) |
| `Auto-update failed · Run claude doctor` | [Troubleshoot installation and login](https://code.claude.com/docs/pt/troubleshoot-install.md#auto-update-failed) |
| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |
| `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) |
| `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) |
| `Error: bypassPermissions not supported in restricted mode` | [Modo restrito](https://code.claude.com/docs/pt/permission-modes.md#restricted-mode-refuses-bypasspermissions) |
| `Session was started with bypass permissions, so plan mode won't ask before most edits or commands` | [Modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode) |
| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
| `Cloud sessions use your claude.ai login`, no final de uma negação de política que nomeia uma credencial | [Command-line errors](#cloud-sessions-use-your-claude-ai-login) |
| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |
| `Cloud sessions aren't available:` seguido do motivo pelo qual a política da sua organização não pôde ser carregada | [Command-line errors](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |
| `Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in.` | [Não é possível obter o UUID da organização](https://code.claude.com/docs/pt/claude-code-on-the-web.md#unable-to-get-organization-uuid) |
| `Cloud sessions need a claude.ai sign-in` | [Unable to get organization UUID](https://code.claude.com/docs/pt/claude-code-on-the-web.md#unable-to-get-organization-uuid) |
| `Nothing was stashed: "<path>" is now a folder in place of a tracked file or link` / `are now folders in place of tracked files or links` | [Command-line errors](#nothing-was-stashed-because-a-folder-replaced-a-tracked-file) |
| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#the-json-schema-value-is-not-a-valid-json-schema) |
| `Error: Invalid --agents configuration:` | [Command-line errors](#invalid-agents-configuration) |
| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Command-line errors](#invalid-agents-configuration) |
| `Error: --agents file not found` | [Command-line errors](#invalid-agents-configuration) |
| `Error: Settings file exceeds the 2MiB limit` | [Command-line errors](#settings-file-exceeds-the-2mib-limit) |
| `Configuration error in` | [Erros de linha de comando](#configuration-error-in-claude-json) |
| `Claude configuration file at <path> was empty and no backup holds anything: starting with defaults.` | [Erros de linha de comando](#claude-configuration-file-was-empty) |
| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Command-line errors](#the-current-directory-no-longer-exists) |
| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [Command-line errors](#temp-directory-refused-or-cannot-be-created) |
| `ENOSPC: no space left on device, mkdir '<dir>'` | [Command-line errors](#temp-directory-refused-or-cannot-be-created) |
| `Error: Claude Code could not save ... because the disk is full (ENOSPC)` / `because your disk quota is used up (EDQUOT)` | [Erros de linha de comando](#could-not-save-because-the-disk-is-full) |
| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [Command-line errors](#directory-couldnt-be-resolved-to-a-real-location) |
| `Error: Workspace not trusted` ao iniciar Remote Control | [Command-line errors](#workspace-not-trusted-when-starting-remote-control) |
| `Error: Workspace not trusted` ao executar `claude ultrareview` | [Command-line errors](#workspace-not-trusted-when-running-claude-ultrareview) |
| `Ultrareview did not start` | [Command-line errors](#ultrareview-did-not-start) |
| `Remote Control did not start: "<question>" got no answer` | [Erros de linha de comando](#remote-control-did-not-start-got-no-answer) |
| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Command-line errors](#not-carried-over-to-the-sessions-remote-control-starts) |
| `Remote Control did not start, because sessions would skip part or all of the --settings file` | [Erros de linha de comando](#remote-control-did-not-start-because-of-the-settings-file) |
| `The settings file <file> has changed since Remote Control started, so this session did not start` | [Erros de linha de comando](#settings-file-changed-since-remote-control-started) |
| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Command-line errors](#sandbox-is-not-supported-by-claude-remote-control) |
| `` `claude import` is not yet available in this build `` | [Command-line errors](#claude-import-is-not-yet-available-in-this-build) |
| `Could not read Claude Code config` | [Command-line errors](#could-not-read-claude-code-config) |
| `Could not import <server>: <reason>` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |
| `Cannot add MCP server to scope: managed` | [Command-line errors](#cannot-add-mcp-server-to-the-managed-scope) |
| `Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide` | [Command-line errors](#cannot-add-mcp-server-when-managed-settings-allow-only-plugin-servers) |
| `is Anthropic-hosted and doesn't support local OAuth` | [Command-line errors](#anthropic-hosted-and-doesnt-support-local-oauth) |
| `Can't add to .mcp.json: it lists servers at the top level` | Mova os servidores para dentro de uma chave `mcpServers`, como no [formato de escopo de projeto](https://code.claude.com/docs/pt/mcp.md#project-scope). |
| `Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes` | [Command-line errors](#cant-read-mcp-json) |
| `MCP server "<name>" was not saved to` / `was not removed from` | [Command-line errors](#mcp-server-was-not-saved-or-removed) |
| `MCP server "<name>" may not have been saved` / `may not have been removed` | [Command-line errors](#mcp-server-may-not-have-been-saved-or-removed) |
| `Server rejected the Authorization header minted by the configured headersHelper` | [Command-line errors](#server-rejected-the-authorization-header-minted-by-the-configured-headershelper) |
| `This server (Java MCP SDK 0.17.0 or older) rejected Claude Code's elicitation capability` | [Erros de linha de comando](#mcp-server-rejected-the-elicitation-capability) |
| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Command-line errors](#mcp-permission-prompt-tool-not-found) |
| `OAuth callback port <port> is already in use — another process may be holding it` | [Command-line errors](#oauth-callback-port-is-already-in-use) |
| `No available ports for OAuth redirect` | [Command-line errors](#no-available-ports-for-oauth-redirect) |
| `Shell command failed for pattern "..."`, de `/security-review` ou qualquer skill que injete contexto dinâmico | [Command-line errors](#security-review-fails-without-origin-head) |
| `Shell command permission check failed for pattern "..."`, de uma skill que injete contexto dinâmico | [Command-line errors](#security-review-fails-without-origin-head) |
| ``Couldn't run `<command>` for <name>. A file named HEAD or .git in this folder or one above it may not be yours``, de uma skill que injeta contexto dinâmico | [Verificações de permissão em comandos injetados](https://code.claude.com/docs/pt/skills.md#permission-checks-on-injected-commands) |
| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Command-line errors](#security-review-fails-without-origin-head) |
| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Command-line errors](#no-shell-command-was-run) |
| `This skill, command or hook and the arguments filled into it add up to more than 4,000,000 characters` | [Erros de linha de comando](#skill-command-or-hook-over-the-4000000-character-limit) |
| `Input must be provided either through stdin or as a prompt argument when using --print` | [Command-line errors](#input-must-be-provided-when-using-print) |
| `Claude Code can't read the keyboard here: stdin is not a terminal` | [Command-line errors](#claude-code-cant-read-the-keyboard-here) |
| `Error: Input contained only whitespace` | [Command-line errors](#input-contained-only-whitespace) |
| `Blank prompt — the message was only whitespace, so nothing was sent to the model.` | [Command-line errors](#input-contained-only-whitespace) |
| `Error: stream-json input carried over 256M characters with no newline` | [Command-line errors](#stream-json-input-carried-over-256m-characters-with-no-newline) |
| `Unknown command: /<name>`, com ou sem uma sugestão `Did you mean` | [Command-line errors](#unknown-command) |
| `Diff is too large for ultrareview` / `PR #<N> is too large for ultrareview` | [Command-line errors](#diff-is-too-large-for-ultrareview) |
| `Could not find merge-base with <branch>` | [Command-line errors](#could-not-find-merge-base-with-the-base-branch) |
| `Your checkout has no branches (detached HEAD only)` | [Command-line errors](#your-checkout-has-no-branches) |
| `Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected` | [Command-line errors](#no-github-account-is-connected-to-your-claude-account) |
| `Your connected GitHub account can't see <owner>/<repo>` | [Command-line errors](#your-connected-github-account-cant-see-the-repository) |
| `The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead` | [Command-line errors](#the-github-app-preflight-failed-transiently) |
| `Not uploading this working tree` com `the upload cannot follow that setting` | [Command-line errors](#the-repository-upload-cant-follow-a-git-setting) |
| `Not uploading this working tree` com outra causa / `Git will not work in this checkout because its folder, or the .git in it, belongs to another user` | [Enviar repositórios locais sem GitHub](https://code.claude.com/docs/pt/claude-code-on-the-web.md#send-local-repositories-without-github) |
| `GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud` | [Command-line errors](#github-isnt-connected-to-your-claude-account) |
| `Your GitHub organization has an IP allowlist that is blocking Claude` | [Command-line errors](#a-github-organization-policy-is-blocking-claude) |
| `Your GitHub organization requires single sign-on` | [Command-line errors](#a-github-organization-policy-is-blocking-claude) |
| `Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude` | [Command-line errors](#a-github-organization-policy-is-blocking-claude) |
| `Single sign-on authorization needed` | [Command-line errors](#single-sign-on-authorization-needed) |
| `Failed to resume the conversation` | [Command-line errors](#failed-to-resume-the-conversation) |
| `No conversation found with session ID: <session-id>` | [Command-line errors](#no-conversation-found-with-the-session-id) |
| `Windows reported an error (EBADF) when Claude Code read this session's transcript file` | [Command-line errors](#windows-reported-an-error-ebadf) |
| `Cannot switch renderers in this session` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
| `Can't restart while work is running in the background` | [Erros de linha de comando](#cant-restart-while-work-is-running-or-remote-control-is-connected) |
| `Can't restart while Remote Control is connected. To use the installed version, exit and start Claude Code again, then run /resume.` | [Erros de linha de comando](#cant-restart-while-work-is-running-or-remote-control-is-connected) |
| `Claude Code couldn't restart` | [Command-line errors](#claude-code-couldnt-restart) |
| `Couldn't open Claude Desktop` | [Command-line errors](#couldnt-open-claude-desktop) |
| `Failed to open Claude Desktop. Please try opening it manually.` | [Command-line errors](#couldnt-open-claude-desktop) |
| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` / `Your Zed keymap is a symbolic link` | [Erros de linha de comando](#terminal-setup-left-your-zed-keymap-unchanged) |
| `Your Zed keymap isn't a readable list of keybindings` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |
| `Skill usage reports are not available on this connection.` | [Command-line errors](#skill-usage-reports-are-not-available-on-this-connection) |
| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Command-line errors](#custom-output-styles-cant-be-selected-over-remote-control) |
| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |
| `/recap only runs when you ask for it yourself in this session` | [Command-line errors](#recap-only-runs-when-you-ask-for-it-yourself) |
| `/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) |
| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |
| `credential store on this machine holds a symbolic link inside it` | [Conceder ferramentas](https://code.claude.com/docs/pt/plugin-evals.md#grant-tools) |
| `cannot be evaluated where sessions load it` | [Test plugins with evals](https://code.claude.com/docs/pt/plugin-evals.md#cannot-be-evaluated-where-sessions-load-it) |
| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |
| `Claude Code refuses the marketplace name "<name>"` | [Plugin errors](#claude-code-refuses-the-marketplace-name) |
| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin errors](#claude-code-refuses-the-marketplace-name) |
| `Marketplace "<name>" is already added from a different source` | [Plugin errors](#marketplace-is-already-added-from-a-different-source) |
| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin errors](#marketplace-name-is-another-spelling-of-a-reserved-name) |
| `Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name` | [Plugin troubleshooting](https://code.claude.com/docs/pt/plugins/troubleshooting.md#cannot-install-plugins-from-a-marketplace-with-this-name) |
| `Cannot add marketplace "<name>": Claude Code reserves this name and cannot register a marketplace under it` | [Plugin troubleshooting](https://code.claude.com/docs/pt/plugins/troubleshooting.md#claude-code-reserves-this-name) |
| `Marketplace "<name>" is added but ignored` | [Plugin troubleshooting](https://code.claude.com/docs/pt/plugins/troubleshooting.md#marketplace-is-added-but-ignored) |
| `Marketplace "<name>" is registered but was refused (see the debug log)` | [Plugin troubleshooting](https://code.claude.com/docs/pt/plugins/troubleshooting.md#marketplace-is-added-but-ignored) |
| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |
| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |
| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |
| `Plugin archive integrity check failed` | [Plugin errors](#plugin-archive-integrity-check-failed) |
| `An npm plugin source must name a registry package` | [Plugin troubleshooting](https://code.claude.com/docs/pt/plugins/troubleshooting.md#an-npm-plugin-source-must-name-a-registry-package) |
| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Plugin troubleshooting](https://code.claude.com/docs/pt/plugins/troubleshooting.md#the-packages-it-lists-are-not-installed) |
| `does not load (...), so Claude Code ignores the whole file` | [Plugin troubleshooting](https://code.claude.com/docs/pt/plugins/troubleshooting.md#does-not-load-so-claude-code-ignores-the-whole-file) |
| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |
| `path not read: <path> is absolute or has a ".." part` | [Erros de plugin](#server-file-path-not-read) |
| `Plugin not loaded: its manifest <path> was not read` | [Plugin errors](#plugin-not-loaded-its-manifest-was-not-read) |
| `path couldn't be checked` / `path could not be checked` | [Erros de plugin](#path-could-not-be-checked) |
| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
| `Failed to load marketplace configuration` | [Plugin errors](#failed-to-load-marketplace-configuration) |
| `Marketplace configuration file is corrupted` | [Plugin errors](#failed-to-load-marketplace-configuration) |
| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Plugin errors](#plugin-is-required-by-your-organization) |
| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [Plugin errors](#plugin-was-not-uninstalled) |
| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [Plugin errors](#plugin-was-not-uninstalled) |
| `Plugin "<plugin>" was not uninstalled: installed_plugins.json` | [Plugin troubleshooting](https://code.claude.com/docs/pt/plugins/troubleshooting.md#installed-plugins-json-holds-a-record-this-version-cannot-read) |
| `Plugin directory does not exist: <path>` | [Plugin troubleshooting](https://code.claude.com/docs/pt/plugins/troubleshooting.md#plugin-directory-does-not-exist) |
| `Skipping connection (recent failure cached; retries automatically in 15 min, or edit the plugin config to retry now)` | [Plugin errors](#skipping-connection-recent-failure-cached) |
| `is not added on this machine, so your organization's marketplace policy keeps its plugins off` | [Adicionar um marketplace](https://code.claude.com/docs/pt/plugins/install.md#add-a-marketplace) |
| `A mod's http.fetch hook stopped this request` | [Ativar ou desativar mods](https://code.claude.com/docs/pt/plugins/mods/overview.md#turn-mods-on-or-off) |
| `Error: No such tool available: <tool name>` | [Tool errors](#no-such-tool-available) |
| `MCP server "<name>" connection closed before the tool call was answered` | [Tool errors](#connection-closed-before-the-tool-call-was-answered) |
| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [Erros de ferramenta](#mcp-server-is-disabled) |
| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Tool errors](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |
| `Permission prompt tool returned an invalid result` | [Erros de ferramenta](#permission-prompt-tool-returned-an-invalid-result) |
| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |
| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |
| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Erros de ferramenta](#setting-blocks-writes-outside-the-working-directories) |
| `<path>: Writes outside the working directories are blocked (permissions.blockWritesOutsideWorkingDirectories)` | [Erros de ferramenta](#setting-blocks-writes-outside-the-working-directories) |
| `Writes to Claude Code settings files are blocked while permissions.blockWritesOutsideWorkingDirectories is on` | [Erros de ferramenta](#writes-to-claude-code-settings-files-are-blocked) |
| `cannot contain null bytes (\0)` | [Tool errors](#path-cannot-contain-null-bytes) |
| `Path contains null bytes` | [Tool errors](#path-cannot-contain-null-bytes) |
| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [Erros de ferramenta](#command-contains-an-invisible-character) |
| `This command's variables and substitutions expand to more text than the permission check reads, so it was not run` | Peça ao Claude para usar menos variáveis e substituições, ou variáveis e substituições mais curtas. |
| `This call was not run. Claude Code could not confirm that the shell is back in the directory`, a partir da v2.1.323 | [Erros de ferramenta](#command-approved-before-a-restart-was-not-run) |
| `File is too large to read as an image (the limit is 128MB)` | [Tool errors](#file-is-too-large-to-read-as-an-image) |
| `Cannot read this as an image: <path> is a pipe or a device` | [Tool errors](#file-is-too-large-to-read-as-an-image) |
| `could not fully check your permission rules` | [Ações que nenhum modo aprova automaticamente](https://code.claude.com/docs/pt/permission-modes.md#actions-no-mode-auto-approves) |
| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |
| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |
| `Sandbox is required but failed to initialize: <reason>` | [Solução de problemas de sandboxing](https://code.claude.com/docs/pt/sandboxing.md#commands-refused-with-sandbox-is-required) |
| `Sandbox is required (sandbox.failIfUnavailable) and stopped being available in this session: <reason>` | [Solução de problemas de sandboxing](https://code.claude.com/docs/pt/sandboxing.md#commands-refused-with-sandbox-is-required) |
| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |
| `Sandbox settings can't be changed here` / `Sandbox settings are overridden by a higher-priority configuration` | [Solução de problemas de sandboxing](https://code.claude.com/docs/pt/sandboxing.md#sandbox-settings-overridden) |
| `Failed to write to <name>'s inbox — nothing was sent` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |
| `Only a teammate can approve a shutdown request` | [Tool errors](#only-a-teammate-can-approve-a-shutdown-request) |
| `cannot be handed to a teammate intact` | [Erros de ferramenta](#command-line-deny-rule-cannot-be-handed-to-a-teammate) |
| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |
| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |
| `Cross-session message was dropped at the recipient session's inbox` | [Tool errors](#cross-session-message-dropped-at-the-inbox) |
| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Tool errors](#refusing-to-send-a-cross-session-message) |
| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Tool errors](#refusing-after-a-symlink-changed) |
| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Tool errors](#refusing-after-a-symlink-changed) |
| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Tool errors](#refusing-after-a-symlink-changed) |
| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [Tool errors](#refusing-after-a-symlink-changed) |
| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Tool errors](#refusing-after-a-symlink-changed) |
| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Tool errors](#refusing-after-a-symlink-changed) |
| `The search failed, so this is not a "no matches" result: matches may exist` | [Erros de ferramenta](#the-search-failed) |
| `task output swap refused (tasks dir moved or linked)` | [Tool errors](#task-output-swap-refused) |
| `Command killed: its output file was replaced or could no longer be verified` | [Tool errors](#task-output-swap-refused) |
| `Disk full: this computer's volume holding <dir> (Claude Code's temporary directory) has <n> MB free` / `Nearly out of inodes: this computer's volume holding <dir>` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
| `Disk full: a test write beside this command's output file` / `Disk quota used up: a test write beside this command's output file` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
| `The command was not started: this computer's disk is full (ENOSPC)` / `the user's disk quota is used up (EDQUOT)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` / `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) |
| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
| `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) |
| `git is not installed on this Mac. To install it, run xcode-select --install, then try again.` | [Erros de ferramenta](#git-is-not-installed-on-this-mac) |
| `Refusing to apply edits to <path>: a hook is configured for file edits in this session` | [Erros de ferramenta](#a-hook-is-configured-for-file-edits) |
| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
| `Not published: that file is on a network share` | [Tool errors](#not-published-that-file-is-on-a-network-share) |
| `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) |
| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |
| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |
| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Tool errors](#webfetch-cannot-fetch-localhost) |
| `Claude Code is unable to fetch from ...` | [Erros de ferramenta](#claude-code-is-unable-to-fetch-from-a-host) |
| `The safety check for domain ... is rate-limited` | [Tool errors](#webfetch-domain-safety-check-failed) |
| `The safety check for domain ... is temporarily rate-limited` | [Tool errors](#webfetch-domain-safety-check-failed) |
| `Unable to verify if domain ... is safe to fetch` | [Tool errors](#webfetch-domain-safety-check-failed) |
| `MCP tool "<tool>" on server "<server>" gave no answer that could be read` / `answered without its text` | [Como o resultado de um hook de ferramenta MCP é lido](https://code.claude.com/docs/pt/hooks.md#how-the-tools-result-is-read) |
| `Can't open MCP settings while no terminal is attached to this background session` | [Background session errors](#commands-refused-in-a-background-session) |
| `Can't open MCP settings in a background session` | [Background session errors](#commands-refused-in-a-background-session) |
| `blocked because the path is spelled in a form that cannot be safely resolved` | [Background session errors](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |
| `blocked because the path is network-shaped` | [Background session errors](#write-or-command-blocked-because-the-path-names-a-network-location) |
| `is isolated in the worktree <path>, but this command <reason>. Refusing to run it` | [Background session errors](#command-blocked-by-the-worktree-isolation-checks) |
| `too complex to verify that it stays inside the worktree` | [Background session errors](#command-blocked-by-the-worktree-isolation-checks) |
| `This session has no saved transcript` | [Background session errors](#this-session-has-no-saved-transcript) |
| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |
| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |
| `This session's saved conversation is no longer on disk` | [Background session errors](#this-sessions-saved-conversation-is-no-longer-on-disk) |
| `This forked session could not be started. Fork the conversation again to retry.` | [Erros de sessão em segundo plano](#this-forked-session-could-not-be-started) |
| `Bypass permissions was requested at launch and ignored` | [Bypass permissions ignorado em uma sessão em background](https://code.claude.com/docs/pt/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |
| `kept <id> — its worktree is still at <path>` | [Erros de sessão em segundo plano](#worktree-has-commits-that-are-not-pushed-anywhere) se a próxima linha da mensagem mencionar commits não enviados, caso contrário [O que a exclusão de uma sessão remove](https://code.claude.com/docs/pt/agent-view.md#what-deleting-a-session-removes) |
| `kept <id> — <n> unpushed commits on <branch>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
| `kept <id> — worktree has commits that are not pushed anywhere` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
| `terminal host process died — press Enter to restart` / `This session's terminal host process died` | [Background session errors](#terminal-host-process-died) |
| `Session isn't responding` / `Press enter again to restart this session — it isn't responding` | [Background session errors](#session-isnt-responding) |
| `Session <id> was stopped while the respawn was in flight` | [Background session errors](#session-was-stopped-while-the-respawn-was-in-flight) |
| `This session was running agent '<name>', which is no longer available` | [Background session errors](#session-agent-no-longer-available) |
| `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) |
| `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) |
| `No LLM gateway: opened from another folder · respawn from <folder>` | [Background session errors](#no-llm-gateway-opened-from-another-folder) |
| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |
| `EUNKNOWN: unknown error, uv_spawn` | [Background session errors](#eunknown-when-starting-a-background-session) |
| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |
| `exited before it became reachable` | [Background session errors](#background-service-exited-before-it-became-reachable) |
| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Background session errors](#working-directory-no-longer-exists-when-starting-a-background-session) |
| `Workspace not trusted.` ao iniciar ou reiniciar uma sessão em background | [Background session errors](#workspace-not-trusted-when-dispatching-a-background-session) |
| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Background session errors](#eacces-when-starting-a-background-session) |
| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |
| `Subprocess initialization did not complete within 60000ms` | [Erros de wrapper e IDE](#subprocess-initialization-did-not-complete-within-60000ms) |
| `Claude Code did not finish starting` | [Erros de wrapper e IDE](#subprocess-initialization-did-not-complete-within-60000ms) |
| `The connection to Claude Code ended before this message completed` | [Wrapper and IDE errors](#the-connection-to-claude-code-ended-before-this-message-completed) |
| `Could not locate the Claude CLI on PATH` | [Wrapper and IDE errors](#could-not-locate-the-claude-cli-on-path) |
| `The Claude Code program for this computer, the <build> build, could not be found` | [Erros de wrapper e IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |
| `Restored the code, but skipped N files` | [Rewind warnings and errors](#restored-the-code-but-skipped-files) |
| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind warnings and errors](#no-files-were-restored) |
| `Couldn't restore N files: the backup is missing or the file can't be written` | Torne graváveis os arquivos que falharam e, em seguida, restaure-os a partir do controle de versão. |
| `The file backups are still being copied. Nothing was changed. Try again in a moment.` | Selecione o mesmo ponto em [`/rewind`](https://code.claude.com/docs/pt/checkpointing) novamente. Quando você restaura o código logo após [`/branch`](https://code.claude.com/docs/pt/sessions#branch-a-session), o Claude Code ainda pode estar copiando os backups de arquivos para a nova sessão. |
| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |
| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |
| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |
| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Fullscreen rendering](https://code.claude.com/docs/pt/fullscreen.md#fullscreen-renderer-didnt-finish-starting) |
| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |
| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |
| `declares type "claudeai-proxy", which only claude.ai connectors use` | Remova a entrada da sua configuração MCP. Consulte [Usar servidores MCP do claude.ai](https://code.claude.com/docs/pt/mcp.md#use-mcp-servers-from-claude-ai). |
| `hook needs quotes around a path with a space` | [Configuration warnings](#hook-needs-quotes-around-a-path-with-a-space) |
| `Instruction file not loaded` | [Configuration warnings](#instruction-file-not-loaded) |
| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Configuration warnings](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |
| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Configuration warnings](#skill-or-command-name-refused) |
| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |
| `Two Claude Code config files exist: this run uses <path>, not <path>` | [Avisos de configuração](#two-claude-code-config-files-exist) |
| `a settings change wasn't saved` | Torne graváveis `~/.claude/settings.json` e o `.claude/settings.local.json` do projeto e, em seguida, faça a alteração novamente. Se outra ferramenta gerar o arquivo, consulte [Uma alteração é perdida em novas sessões](https://code.claude.com/docs/pt/settings.md#a-change-you-made-in-claude-code-is-lost-in-new-sessions). Se um arquivo não for válido, consulte [Corrigir um arquivo de configurações corrompido](https://code.claude.com/docs/pt/settings.md#fix-a-broken-settings-file). |
| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Avisos de configuração](#make-this-change-again-later) |
| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |
| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |
| `Your organization requires remote managed settings to load, but they could not be loaded` | [Impor inicialização fail-closed](https://code.claude.com/docs/pt/server-managed-settings.md#enforce-fail-closed-startup) |
| `Remote managed settings are still loading` | [Avisos de configuração](#remote-managed-settings-failed-to-load) |
| `Remote managed settings did not load` | [Avisos de configuração](#remote-managed-settings-failed-to-load) |
| `Claude Code couldn't load your organization's settings` / `Claude Code couldn't reach Anthropic to load your organization's settings` / `requires them before a session can start` | [Avisos de configuração](#couldnt-load-your-organizations-settings) |
| `Claude Code can't start this session yet` | [Avisos de configuração](#couldnt-load-your-organizations-settings) |
| `Your Claude session has expired. Sign in again to continue (claude auth login).` | [Avisos de configuração](#couldnt-load-your-organizations-settings) |
| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |
| `Your organization's managed settings need your approval, which couldn't be asked for here.` | [Configuration warnings](#managed-settings-need-your-approval) |
| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Configuration warnings](#managed-settings-block-the-default-model) |
| `Your organization's managed settings allow Claude Code to use: <providers>` | [Configuration warnings](#managed-settings-dont-allow-this-api-provider) |
| `Your organization's managed settings allow Claude Code to use no API provider at all` | [Configuration warnings](#managed-settings-dont-allow-this-api-provider) |
| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |
| `"<name>" is a reserved MCP server name and was not loaded` | [Configuration warnings](#mcp-server-name-is-reserved) |
| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |
| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |
| `Unable to read managed policy settings` | [Configuration warnings](#unable-to-read-managed-policy-settings) |
| `Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded; fix or remove each entry:` | [Configuration warnings](#managed-settings-hooks-not-loaded) |
| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |
| `apply_flag_settings: nothing in this request was applied and earlier settings stay in force. Fix or remove these invalid settings and send it again` | [`applyFlagSettings()`](https://code.claude.com/docs/pt/agent-sdk/typescript#applyflagsettings) |
| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |
| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [Configuration warnings](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |
| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |
| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |
| `matches no tool · check for typos` / `matches no known tool — check for typos` | [Configuration warnings](#matches-no-tool) |
| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |
| `Write(<path>) never matches · use Edit(<path>)` / `Glob(<path>) never matches · use Read(<path>)` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |
| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |
| `allows any option at its * · use an exact value` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |
| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Configuration warnings](#denying-bash-also-turns-off-the-powershell-tool) |
| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |
| `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`](https://code.claude.com/docs/pt/model-config#claude_code_auto_compact_window-values) |
| `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`](https://code.claude.com/docs/pt/model-config#claude_code_auto_compact_window-values) |
| `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`](https://code.claude.com/docs/pt/model-config#claude_code_auto_compact_window-values) |
| `Model "<model>" isn't recognized · context assumed to be <N> tokens` / `Claude Code doesn't recognize the model "<model>", so it assumes a context window of <N> tokens` | [Corrigir a janela para um gateway ou ID de modelo personalizado](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |
| `Model "<model>" isn't recognized · did you mean "<suggestion>"?` / `Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?` | [Corrigir um nome de modelo digitado incorretamente](https://code.claude.com/docs/pt/model-config.md#fix-a-mistyped-model-name) |
| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |
| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Configuration warnings](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |
| `Sandbox mask files left behind at write-deny paths` | [Configuration warnings](#stale-sandbox-mask-files-left-by-a-killed-session) |
| `Stale sandbox mask files left by a killed session` | [Configuration warnings](#stale-sandbox-mask-files-left-by-a-killed-session) |
| `Ubuntu's AppArmor restriction on user namespaces stops bubblewrap here` | [Solução de problemas de sandboxing](https://code.claude.com/docs/pt/sandboxing.md#apparmor-restriction-stops-bubblewrap) |
| `bwrap: setting up uid map: Permission denied` / `bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted` | [Solução de problemas de sandboxing](https://code.claude.com/docs/pt/sandboxing.md#bwrap-uid-map-permission-denied) |
| As respostas parecem ter qualidade inferior ao normal | [Response quality](#responses-seem-lower-quality-than-usual) |

## Tentativas automáticas

Claude Code tenta novamente falhas transitórias até 10 vezes com backoff exponencial antes de mostrar um erro. Nem sempre tenta novamente uma falha que chega no meio da resposta do Claude. Quando você vê um dos erros nesta página, Claude Code já fez as tentativas que se aplicam a essa falha.

Claude Code tenta novamente estas falhas:

* Erros de servidor, respostas sobrecarregadas e timeouts de requisição que chegam antes de qualquer parte da resposta do Claude ter sido transmitida.
* Um erro de servidor ou resposta sobrecarregada que chega depois que Claude terminou de pensar, mas antes de ter iniciado qualquer texto ou chamada de ferramenta. Claude Code tenta novamente um erro de servidor nesse ponto até duas vezes. Antes da v2.1.284, Claude Code encerrava o turno com o erro nesse ponto.
* Conexões perdidas. Quando uma conexão cai no meio de uma requisição antes de Claude ter completado qualquer parte de sua resposta, incluindo seu pensamento, Claude Code reemite a requisição com o mesmo backoff e o turno continua, mesmo que algum texto já tivesse começado a ser transmitido. Quando cai depois que Claude terminou de pensar mas antes de ter iniciado qualquer texto ou chamada de ferramenta, Claude Code em vez disso reemite a requisição até duas vezes em rápida sucessão, e encerra o turno com `Connection lost before a response was produced` se a conexão continuar caindo nesse ponto.
* Uma conexão que Claude Code detecta que foi quebrada pelo seu computador entrando em modo de suspensão no meio de uma requisição. Claude Code a conta como uma conexão perdida sob as regras acima; uma vez que o rótulo de nova tentativa nomeia a razão específica, ele exibe `Connection lost while your computer was asleep`, e se o turno terminar depois que Claude terminou de pensar mas antes de qualquer texto ou chamada de ferramenta, a mensagem exibe `Your computer went to sleep before a response was produced`.
* Um fluxo de resposta travado, quando os cabeçalhos de resposta chegaram mas nenhuma parte da resposta do Claude chegou, ou quando Claude terminou de pensar mas não iniciou qualquer texto ou chamada de ferramenta: Claude Code aborta a conexão travada e transmite a requisição novamente no máximo uma vez. Se a resposta travar uma segunda vez depois que Claude terminou de pensar mas antes de qualquer texto ou chamada de ferramenta, Claude Code encerra o turno com `The response stalled before a response was produced`.
* Uma requisição de streaming que a API nunca responde com cabeçalhos de resposta, em uma conexão onde o [prazo de primeiro byte é executado](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs). No prazo, Claude Code aborta a requisição e a reenvia dentro do orçamento de tentativas. Se o prazo também expirar para um reenvio, o turno termina com [No response from API](#no-response-from-api). Quando você define `CLAUDE_CODE_RETRY_WATCHDOG`, Claude Code continua reenviando dentro do orçamento em vez disso.
* Uma resposta de streaming que o filtro de conteúdo de saída da API interrompe antes de Claude ter terminado de pensar ou iniciado qualquer texto ou chamada de ferramenta. Claude Code reenvia a requisição uma vez, dentro do orçamento de tentativas, e mostra [Output blocked by content filtering policy](#output-blocked-by-content-filtering-policy) se o filtro também interromper a segunda resposta.
* Throttles 429 temporários, mas não o `429` de limite de gastos de um gateway, que não é um throttle; veja [Spend limit reached](#spend-limit-reached).
  * Quando você está conectado com uma assinatura claude.ai, isso inclui throttles 429 que não carregam os cabeçalhos de cota do seu plano. Antes da v2.1.199, Claude Code tentava novamente esses throttles apenas para logins com chave de API e Enterprise.
* Uma requisição rejeitada porque a entrada mais `max_tokens` excede o limite de contexto. Reenviá-la sem alterações falharia da mesma forma, então Claude Code tenta novamente com um `max_tokens` reduzido, e para de tentar novamente e compacta em dois casos:
  * Quando nenhuma redução pode caber, por exemplo quando a conversa em si quase preenche a janela de contexto.
  * Quando uma nova tentativa não pode encolher `max_tokens` ainda mais. Antes da v2.1.218, Claude Code poderia reenviar uma requisição reduzida que ainda não cabia, como quando o orçamento de pensamento estendido excedia o contexto restante, até o orçamento de tentativas se esgotar.
* Uma resposta que diz que Claude está chamando uma ferramenta, mas não contém nenhuma chamada de ferramenta. Claude Code tenta novamente pedindo ao Claude a chamada de ferramenta, até duas vezes. Se ambas as novas tentativas falharem da mesma forma, você vê `The model's tool call could not be parsed (retry also failed).` e o turno termina. Para tentar novamente, envie outra mensagem. Antes da v2.1.307, Claude Code tentava novamente uma vez antes de encerrar o turno.
* Uma credencial expirada ou ausente do Google Cloud na [Plataforma de Agentes do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md), ou credenciais AWS que falham ao carregar em sua máquina. Claude Code descarta suas credenciais em cache e tenta novamente até duas vezes, depois relata o erro para que você possa se autenticar novamente imediatamente, conforme descrito em [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). Antes da v2.1.228, Claude Code tentava novamente uma credencial do Google Cloud com falha através do orçamento de tentativas completo antes de mostrar o erro.
* Um `401` ou `403` da API Anthropic, diretamente ou através de um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway), enquanto um script [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper) fornece a credencial. Claude Code executa novamente o script e tenta novamente com sua saída nova, dentro do orçamento de tentativas completo. Quando o script em si falha na nova execução, Claude Code mostra [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing) em vez disso.

Antes da v2.1.227, `Connection lost before a response was produced` era exibido como `Connection closed while thinking, before producing a response` e `The response stalled before a response was produced` era exibido como `Response stalled while thinking, before producing a response`.

Claude Code não tenta novamente estas falhas:

* Uma falha de validação de certificado TLS, como um proxy inspecionando TLS, um pacote `NODE_EXTRA_CA_CERTS` ausente, ou um certificado expirado. Claude Code relata o erro na primeira tentativa, para que você possa corrigir a configuração do certificado imediatamente; veja [SSL certificate errors](#ssl-certificate-errors). Claude Code ainda tenta novamente condições TLS transitórias como um timeout de handshake. Antes da v2.1.199, Claude Code tentava novamente falhas de certificado através do orçamento de tentativas completo antes de mostrar o erro.
* Um erro de servidor, conexão perdida, ou fluxo travado que chega depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou iniciou um depois de terminar seu pensamento, mas antes de terminar a resposta. Claude Code não executa novamente a requisição, porque isso poderia executar as mesmas chamadas de ferramenta duas vezes. Ele mantém o que Claude completou, executa qualquer chamada de ferramenta que Claude terminou, e continua o turno a partir de seus resultados. Para o que você vê em uma sessão interativa e em uma não interativa, leia [The response above may be incomplete](#the-response-above-may-be-incomplete). Antes da v2.1.199, Claude Code descartava a saída parcial e relatava todo o turno como um erro quando um erro de servidor chegava no meio do fluxo.
* Uma falha que chega depois que Claude terminou a resposta: nada precisa ser tentado novamente, então Claude Code mantém a resposta completa e encerra o turno normalmente.
* Uma [resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado](#bedrock-streaming-response-has-an-unexpected-content-type), porque o gateway ou proxy que reescreve a resposta reescreveria a nova tentativa da mesma forma. Requer Claude Code v2.1.208 ou posterior.
* Uma nova tentativa sem streaming de uma requisição de streaming com falha que recebe um status de sucesso mas [nenhuma mensagem da API Claude no corpo](#api-returned-an-empty-or-malformed-response). Claude Code encerra o turno com esse erro.
* Uma requisição que a verificação de política da sua organização negou, que aparece como uma linha `API Error:` carregando a mensagem de negação. Os administradores da sua organização configuram a verificação com [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks), um recurso do Claude Enterprise, e a mensagem termina com as instruções que eles configuraram, ou por padrão diz para você entrar em contato com eles. Claude Code não reenvia a requisição negada para o mesmo modelo ou para um [modelo de fallback](https://code.claude.com/docs/pt/model-config.md#fallback-model-chains), porque a negação é sobre o conteúdo da requisição e não sobre o modelo. Antes da v2.1.239, Claude Code poderia reenviar uma requisição negada, sem streaming ou em um modelo de fallback configurado, antes de mostrar a negação.

### O que você vê enquanto Claude Code tenta novamente ou aguarda

Ao tentar novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y` após um rótulo de erro. O rótulo nomeia a razão específica desde a primeira tentativa para falhas sobre as quais você pode agir imediatamente: a rede está inativa, um handshake TLS falhou, ou você atingiu um rate limit. Para outros erros, ele exibe `API error` no início. A partir da v2.1.198, ele muda para a razão específica a partir da terceira tentativa, ou na tentativa final quando `CLAUDE_CODE_MAX_RETRIES` permite menos de três; versões anteriores mudam apenas na tentativa final.

A partir da v2.1.198, a dica usual do spinner é suprimida durante novas tentativas. Uma vez que a razão do erro é revelada, se a falha for uma sobrecarga 529, a linha abaixo da contagem regressiva também nomeia onde verificar o status do serviço: `status.claude.com` na API Anthropic, ou o host do provedor ou gateway nomeado na mensagem em outras configurações.

#### Waiting for API response

O banner `Waiting for API response · will retry in … · check your network` significa que Claude Code aguardou pelo menos 20 segundos sem receber nenhum dado para uma requisição. A requisição ainda não falhou: a contagem regressiva vai até o ponto em que Claude Code aborta a conexão travada. Se o aborto acontecer:

* Antes de Claude ter completado um bloco de texto ou uma chamada de ferramenta, ou iniciado um depois de terminar seu pensamento, Claude Code tenta novamente a requisição ou encerra o turno com um erro. [Automatic retries](#automatic-retries) diz quais travamentos ele tenta novamente e quantas vezes.
* Depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou iniciou um depois de terminar seu pensamento, mas antes de Claude ter terminado a resposta, Claude Code mantém o que Claude completou, continua o turno a partir de qualquer chamada de ferramenta que Claude terminou, e mostra [The response above may be incomplete](#the-response-above-may-be-incomplete). Em uma sessão não interativa, e para a resposta de um subagente em qualquer sessão, Claude Code pode primeiro pedir ao Claude que continue a resposta; essa entrada diz quando faz isso e quando você ainda vê o aviso lá.
* Depois que Claude terminou a resposta, Claude Code encerra o turno normalmente.

O banner desaparece automaticamente assim que os dados são retomados ou uma nova tentativa é bem-sucedida. Se reaparecer em cada tentativa, trate-o como um [problema de rede](#unable-to-connect-to-api). Se você se conecta através de um gateway, veja [O banner de espera aparece e desaparece atrás de um gateway](#waiting-banner-behind-a-gateway). Antes da v2.1.185, o banner aparecia após 10 segundos com redação diferente.

#### O banner de espera aparece e desaparece atrás de um gateway

Se o banner `Waiting for API response` aparecer e desaparecer enquanto Claude pensa e você se conecta através de um gateway, [atualize o Claude Code](https://code.claude.com/docs/pt/setup.md#update-claude-code) para a v2.1.309 ou posterior. O banner aparece após 45 segundos sem dados nestas conexões:

* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars) definido como um host diferente da API Anthropic, como um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway)
* Uma sessão do [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway)
* [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md) com `ANTHROPIC_AWS_BASE_URL` definido

Antes da v2.1.309, o banner aparecia após 20 segundos nessas conexões.

### Ajustar o comportamento de novas tentativas

Você pode ajustar o comportamento de novas tentativas com estas variáveis de ambiente:

| Variável | Padrão | Efeito |
| :- | :- | :- |
| [`CLAUDE_CODE_MAX_RETRIES`](https://code.claude.com/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. |
| [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/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](https://code.claude.com/docs/pt/fast-mode.md#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. |
| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](https://code.claude.com/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. |
| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS` | sem teto | Com `CLAUDE_CODE_RETRY_WATCHDOG` definido, o tempo máximo em milissegundos que uma requisição aguarda a redefinição do [limite de uso](#youve-hit-your-session-limit) do seu plano, como o limite da sessão ou o semanal. Quando a redefinição está mais distante do que esse teto, a requisição falha imediatamente, a menos que os créditos de uso tenham margem ou a API não tenha conseguido verificá-los. Nesses casos, ela é tentada novamente e falha se o teto for ultrapassado antes de ela ser bem-sucedida. Requer Claude Code v2.1.301 ou posterior. |
| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/pt/env-vars) | não definido | Intervalo mínimo em milissegundos entre verificações de se um [limite de uso](#youve-hit-your-session-limit) já foi liberado, enquanto uma requisição aguarda a redefinição desse limite com `CLAUDE_CODE_RETRY_WATCHDOG` definido. Quando uma verificação constata que o limite foi liberado, a requisição é enviada imediatamente. Informe apenas dígitos de `60000` a `10800000`. Quando não definido ou fora desse intervalo, nenhuma verificação é feita. Para saber quando Claude Code ignora essas verificações, veja a [referência de variáveis de ambiente](https://code.claude.com/docs/pt/env-vars.md). Requer Claude Code v2.1.305 ou posterior. |
| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 500 | Atraso inicial em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 32000, para distribuir as novas tentativas por uma janela mais longa quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.292 ou posterior. |
| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 32000 | Teto em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 300000, para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite de capacidade. Valores acima de 64000 requerem a v2.1.323 ou posterior. Não tem efeito nos mesmos casos que `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`. Requer Claude Code v2.1.296 ou posterior. |
| [`API_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars) | 600000 | Tempo em milissegundos que cada tentativa de requisição tem para receber seus cabeçalhos de resposta. Não limita quanto tempo uma resposta de streaming dura depois disso. Aumente-o para redes lentas ou proxies. Para saber como ele limita o prazo de primeiro byte, veja [No response from API](#no-response-from-api). |
| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/pt/env-vars) | não definido | Limite de reenvios de uma [requisição sem streaming](#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Ao atingir o limite, a requisição falha. Uma resposta do Claude que leva mais tempo que o timeout para ser gerada atinge o timeout novamente a cada reenvio, então defina um número baixo, como `0`, para falhar mais cedo. Para o timeout de cada tentativa, veja [Quanto tempo uma tentativa sem streaming aguarda](#how-long-a-non-streaming-attempt-waits). Requer Claude Code v2.1.285 ou posterior. |
| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars) | não definido | Prazo em milissegundos para o primeiro byte de resposta de uma requisição de streaming. Requer Claude Code v2.1.242 ou posterior. Para saber como Claude Code escolhe o prazo quando esta variável não está definida, veja [No response from API](#no-response-from-api). |

#### Quanto tempo uma tentativa sem streaming aguarda

Uma tentativa sem streaming termina no seu timeout de requisição ou no timeout de inatividade do corpo, o que ocorrer primeiro:

* **Timeout de requisição**: `API_TIMEOUT_MS` quando você define um valor positivo, caso contrário 300 segundos em uma sessão local.
* **[Timeout de inatividade do corpo](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs), onde ele é executado**: por padrão, 5 a 6 minutos sem uma resposta, não importa quão alto você defina `API_TIMEOUT_MS`.

## Erros do servidor

A maioria desses erros vem do provedor de inferência: o serviço da Anthropic na API Anthropic e o serviço por trás do endpoint desse provedor no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway personalizado. [Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) e [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) também cobrem causas do seu lado, como uma conta Amazon Bedrock que não consegue invocar o modelo classificador ou um subagent que atingiu um limite de uso.

### API Error: 500 Internal server error

Claude Code mostra o código de status e a mensagem de erro da API para qualquer resposta 5xx. O exemplo abaixo mostra uma resposta 500 na API Anthropic:

```text theme={null}
API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.
```

A frase final nomeia onde verificar a saúde do serviço e varia por provedor. As configurações do Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry nomeiam a página de status desse provedor. Um `ANTHROPIC_BASE_URL` personalizado nomeia o host do gateway.

Um 5xx da própria API indica uma falha inesperada dentro da API. Não é causado pelo seu prompt, configurações ou conta.

Quando um proxy, balanceador de carga ou gateway responde com uma página de erro HTML, a mensagem mostra o código de status e o título da página, como `API Error: 502 Bad Gateway`. Para uma página sem título, a mensagem mostra o código de status e seu nome padrão. Antes da v2.1.281, o código de status era descartado quando a página tinha um título, e a marcação bruta da página era impressa quando não tinha nenhum.

**O que fazer:**

* Verifique [status.claude.com](https://status.claude.com) ou a página de status do provedor nomeada na mensagem para incidentes ativos
* Aguarde um minuto e envie sua mensagem novamente. Sua mensagem original ainda está na conversa, então para um prompt longo você pode digitar `try again` em vez de colar tudo novamente.
* Se [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars) apontar para um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) e todas as requisições falharem dessa forma, verifique se o seu gateway e o upstream dele aceitam os campos de [busca de ferramentas](https://code.claude.com/docs/pt/mcp.md#tool-search-through-a-gateway). Por padrão, o Claude Code envia campos de ferramenta `defer_loading` e blocos `tool_reference`, com o cabeçalho `anthropic-beta` que os habilita. 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`.
* Se o erro persistir sem nenhum incidente postado, execute `/feedback` para que a Anthropic possa investigar com os detalhes da sua solicitação. Veja [Report an error](#report-an-error) se `/feedback` não estiver disponível no seu ambiente.

### API Error: Repeated 529 Overloaded errors

A API está temporariamente em capacidade máxima em todos os usuários. Claude Code já tentou novamente várias vezes antes de mostrar esta mensagem:

```text theme={null}
API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.
```

A frase final varia por provedor da mesma forma que o erro 500 acima.

Um 529 não é seu limite de uso e não conta contra sua cota.

**O que fazer:**

* Verifique [status.claude.com](https://status.claude.com) ou a página de status do provedor nomeada na mensagem para avisos de capacidade
* Tente novamente em alguns minutos
* Execute `/model` e mude para um modelo diferente para continuar trabalhando, já que a capacidade é rastreada por modelo. Claude Code o solicita fazer isso quando um modelo está sob carga particularmente alta, por exemplo `Opus is experiencing high load, please use /model to switch to Sonnet`. Em modelos Fable a mensagem nomeia Fable.

  Em uma sessão que o Claude Desktop app executa, como a aba Code ou Cowork, a mensagem lê `Opus is experiencing high load. Switch to Sonnet.` e você muda modelos com o seletor de modelo do app.

### Request timed out

A API não respondeu antes do prazo de conexão.

```text theme={null}
Request timed out
```

O tempo limite de solicitação padrão é de 10 minutos. Se você definir [`API_TIMEOUT_MS`](https://code.claude.com/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](https://code.claude.com/docs/pt/network-config.md#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.

**O que fazer:**

* 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.
* Tente novamente a solicitação
* Se uma rede lenta ou proxy for a causa, aumente `API_TIMEOUT_MS` conforme descrito em [Automatic retries](#automatic-retries)
* Se os tempos limite forem frequentes e sua rede estiver saudável, veja [Network and connection errors](#network-and-connection-errors) abaixo

### No response from API

Claude Code enviou uma requisição de streaming e a API não retornou cabeçalhos de resposta dentro do prazo para o primeiro byte. Claude Code aborta uma requisição desse tipo em vez de aguardar o timeout de requisição completo `API_TIMEOUT_MS`, e a envia novamente se o [retry budget](#tune-retry-behavior) permitir. Quando o prazo também passa para a nova tentativa, o turno termina com esta mensagem, que mostra quanto tempo cada tentativa aguardou.

Se você definir [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/pt/env-vars), Claude Code continua tentando novamente sob o orçamento descrito em [Tune retry behavior](#tune-retry-behavior) em vez de encerrar o turno.

```text theme={null}
API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.
```

Claude Code define o tempo de espera para cabeçalhos de resposta da primeira tentativa e a espera da nova tentativa separadamente:

* **Primeira tentativa**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/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](https://code.claude.com/docs/pt/network-config.md#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.
* **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.

  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.

Nenhuma espera excede um segundo a menos que um `API_TIMEOUT_MS` positivo, e um `API_TIMEOUT_MS` positivo inferior a 11 segundos desativa o prazo. O watchdog de nível de byte começa apenas depois que os cabeçalhos de resposta chegam, então uma resposta que para de enviar bytes depois disso segue as [regras de fluxo interrompido](#automatic-retries) em vez deste prazo.

Em uma sessão do [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway), esse prazo só é aplicado quando você [o ativa](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md#retry-an-unanswered-request-sooner-with-the-first-byte-deadline) definindo `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` como `1` ou mais.

**O que fazer:**

* Envie sua mensagem novamente. Sua mensagem original ainda está na conversa, então para um prompt longo você pode digitar `try again` em vez de colar tudo novamente.
* Se se repetir, trate como um [problema de rede ou proxy](#unable-to-connect-to-api).
* Se um proxy ou gateway em sua rede mantém respostas até que sejam concluídas, aumente `API_TIMEOUT_MS` para que a nova tentativa aguarde mais. No Amazon Bedrock, aumente `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` também.
* Se a primeira tentativa continuar expirando e a nova tentativa tiver sucesso, aumente `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` para que a primeira tentativa também aguarde o tempo suficiente.

Antes da v2.1.242, Claude Code aguardava o tempo limite de solicitação completo `API_TIMEOUT_MS`, 10 minutos por padrão, antes de falhar em uma solicitação de streaming sem resposta. Antes da v2.1.261, a nova tentativa aguardava o mesmo prazo que a primeira tentativa e a mensagem não mostrava durações. Antes da v2.1.307, Claude Code ignorava `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` em uma sessão do Claude apps gateway.

### The response above may be incomplete

Uma solicitação de streaming falhou enquanto a resposta ainda estava em andamento, depois que Claude completou um bloco de texto ou uma chamada de ferramenta, ou havia iniciado um após terminar seu pensamento. Reenviar a solicitação pode executar as mesmas chamadas de ferramenta duas vezes, então Claude Code mantém a saída que Claude completou e anexa este aviso em vez de descartar o turno. Qual variante você vê nomeia a causa:

```text theme={null}
API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.
API Error: Part of the response never arrived. The response above may be incomplete.
API Error: The response stream was malformed. The response above may be incomplete.
```

* `Server error mid-response`: um erro de servidor sobrecarregado ou 5xx no meio do fluxo. Esta variante requer Claude Code v2.1.199 ou posterior; antes disso, esse caso descartava a saída parcial e relatava todo o turno como um erro.
* `Connection lost mid-response`: a conexão foi interrompida. Você também vê esta variante quando um proxy ou gateway encerra o corpo da resposta de forma limpa antes da resposta ser concluída.
* `Your computer went to sleep mid-response`: Claude Code detectou que seu computador entrou em modo de suspensão enquanto a resposta estava sendo transmitida. Depois que seu computador acordar, Claude Code trata a conexão como quebrada e para de ler dela.
* `Part of the response never arrived`: um evento de fluxo foi descartado entre a API e Claude Code, então um evento posterior referenciou conteúdo que nunca chegou. Antes da v2.1.281, este caso terminou o turno com `API Error: Content block not found`.
* `The response stream was malformed`: um evento chegou para um bloco de conteúdo que já havia terminado, ou um evento chegou danificado. Um evento danificado é aquele cujos dados não são JSON válido, cujo conteúdo está faltando ou cujo conteúdo não corresponde ao tipo do evento. Antes da v2.1.284, o erro bruto do analisador, como um começando com `API Error: JSON Parse error`, aparecia em vez disso quando um evento com JSON inválido chegava depois que Claude havia completado seu pensamento, um bloco de texto ou uma chamada de ferramenta.
* `The response stopped arriving`: a conexão permaneceu aberta mas parou de entregar dados, então o watchdog de inatividade de streaming a abortou. Antes da v2.1.222, Claude Code também poderia relatar essa falha em conexões de [gateway](https://code.claude.com/docs/pt/gateways.md) alcançadas através de `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL` enquanto os pings de keep-alive do servidor ainda estavam chegando, porque contava apenas eventos de resposta analisados lá; atualizar para a versão mais recente interrompe esses tempos limite espúrios nessas rotas. Gateways alcançados através de uma URL de base de provedor como `ANTHROPIC_BEDROCK_BASE_URL` não são envolvidos pelo watchdog de byte; veja [Streaming idle watchdogs](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs).

Antes da v2.1.227, `Connection lost mid-response` lia `Connection closed mid-response` e `The response stopped arriving` lia `Response stalled mid-stream`.

Quando um evento de fluxo descartado, duplicado ou danificado chega antes de Claude ter iniciado qualquer texto ou chamada de ferramenta, você não vê este aviso:

* Se Claude tivesse completado apenas seu pensamento, Claude Code reemite a solicitação. Quando os fluxos reemitidos quebram da mesma forma, o turno termina com `Part of the response never arrived and no response was produced. Try again.` ou `The response stream was malformed and no response was produced. Try again.`
* Se nada tivesse sido concluído, Claude Code reenvia a solicitação sem streaming. Se você desativou esse fallback com [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](https://code.claude.com/docs/pt/env-vars), o turno termina com `API Error: Content block not found` para um evento descartado ou `API Error: Content block already closed` para um duplicado. Para um evento danificado com o fallback desativado, o turno termina com `API Error: Stream event unreadable` ou o erro bruto do analisador.

Em quatro casos, Claude Code lida com a falha sem mostrar este aviso imediatamente:

* Anteriormente na resposta, Claude Code ou tenta novamente a falha ou termina o turno com um erro diferente. Veja [Automatic retries](#automatic-retries).
* Quando uma dessas falhas chega depois que Claude terminou a resposta, Claude Code mantém a resposta completa e termina o turno normalmente, sem este aviso. Antes da v2.1.222, Claude Code mostrava este aviso quando a conexão era interrompida ou travava após a resposta terminar, e relatava o turno como um erro mesmo que a resposta fosse completa.
* Em uma [sessão não interativa](https://code.claude.com/docs/pt/headless.md), como uma execução `-p`, uma execução do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md) ou uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), você não precisa enviar `continue` você mesmo quando a resposta cortada está na conversa principal e contém texto mas nenhuma chamada de ferramenta: Claude Code mantém a saída parcial e solicita a Claude continuar de onde parou, até três vezes seguidas. Você vê este aviso para tal resposta apenas uma vez que Claude Code tenha usado essas continuações. Antes da v2.1.246, Claude Code terminava um turno não interativo com este aviso na primeira interrupção.
* Em um [subagent](https://code.claude.com/docs/pt/sub-agents.md#api-errors-in-subagents), seja a sessão interativa ou não: quando sua resposta cortada contém texto mas nenhuma chamada de ferramenta, Claude Code solicita ao subagent continuar. O aviso se torna a última mensagem do subagent apenas uma vez que essas continuações sejam usadas. Antes da v2.1.257, um subagent mostrava este aviso na primeira interrupção.

**O que fazer:**

* Em uma sessão interativa, leia a resposta que permanece na tela: Claude Code mantém cada bloco que Claude completou antes do erro, mas descarta um bloco final interrompido quando o turno termina, então as frases ou chamadas de ferramenta finais podem estar faltando. Responda com `continue` para que Claude retome seu último bloco completado.
* Em [modo não interativo](https://code.claude.com/docs/pt/headless.md) (`-p`):
  * Com a saída de texto padrão, Claude Code imprime o último bloco de texto completado que ainda mantém de antes no turno, seguido por esta mensagem. Quando não mantém nenhum, Claude Code imprime apenas esta mensagem, por exemplo porque Claude Code compactou a conversa no meio do turno e limpou esse texto. Antes da v2.1.219, Claude Code imprimia apenas esta mensagem na saída de texto `-p` e descartava a resposta que já havia produzido.
  * Com `--output-format json` ou `stream-json`, Claude Code relata esta mensagem no campo `result`.
  * Para continuar o turno uma vez que a conexão esteja estável, retome a sessão e envie `continue` conforme descrito em [Continue conversations](https://code.claude.com/docs/pt/headless.md#continue-conversations).

### Auto mode cannot determine the safety of an action

O modelo que [auto mode](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) usa para classificar ações não conseguiu produzir uma decisão, então auto mode não aprovou a ação automaticamente. A mensagem que você vê depende de como o classificador falhou.

Quando o modelo classificador está indisponível:

```text theme={null}
<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.
```

Em uma sessão interativa, uma linha esmaecida `Not run · auto mode's check had no usable answer` aparece sob a chamada de ferramenta em vez desta mensagem. A linha também pode substituir uma mensagem informando que [o servidor não deu veredicto](#the-server-returned-no-safety-verdict) ou, fora de uma sessão remota, uma mensagem que começa com `Auto mode could not evaluate`. Pressione `Ctrl+O` para ler a mensagem correspondente no [visualizador de transcrição](https://code.claude.com/docs/pt/interactive-mode.md#transcript-viewer). Antes da v2.1.296, a mensagem aparecia como um erro vermelho.

Quando Claude Code pode determinar a categoria de falha, ele nomeia a categoria entre parênteses após `temporarily unavailable`, por exemplo `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. As categorias são `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` e `(connection failed)`. Se `(timed out)` ou `(connection failed)` se repetir, verifique sua conexão; veja [Unable to connect to API](#unable-to-connect-to-api). Antes da v2.1.229, a mensagem nunca nomeava uma categoria e lia `Wait briefly and then try this action again`.

Quando nenhuma categoria se encaixa, a mensagem aparece sem categoria entre parênteses; mais de uma falha produz essa forma. No [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), incluindo o [endpoint Mantle](https://code.claude.com/docs/pt/amazon-bedrock.md#use-the-mantle-endpoint), também aparece quando sua conta AWS não consegue invocar o modelo nomeado na mensagem, e essa falha se repete em cada tentativa até que sua conta receba acesso ao modelo.

**O que fazer:**

* Tente novamente após alguns segundos; Claude vê a mesma mensagem e geralmente tenta novamente por conta própria. Uma falha transitória não está relacionada à [elegibilidade de auto mode](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode); você não precisa alterar configurações
* Se as tentativas continuarem falhando, continue com tarefas somente leitura e volte à ação bloqueada mais tarde
* No Amazon Bedrock, se a mensagem retornar em cada tentativa, verifique se sua conta pode invocar o modelo que ela nomeia: para modelos padrão do Amazon Bedrock, confirme que sua [política IAM](https://code.claude.com/docs/pt/amazon-bedrock.md#iam-configuration) permite invocá-lo; para IDs de modelo Mantle, [entre em contato com sua equipe de conta AWS](https://code.claude.com/docs/pt/amazon-bedrock.md#mantle-endpoint-errors)
* Se a mensagem retornar em cada tentativa e nomear o modelo que você definiu em [`CLAUDE_CODE_AUTO_MODE_MODEL`](https://code.claude.com/docs/pt/permission-modes#choose-the-classifier-model), verifique se a API ou o provedor de nuvem em que sua sessão é executada oferece esse ID de modelo. Se não oferecer, defina a variável como um ID de modelo que ele ofereça, ou remova a definição da variável para usar o [modelo classificador padrão](https://code.claude.com/docs/pt/permission-modes.md#default-classifier-model).

Quando uma solicitação de classificador falha porque seu token OAuth expirou ou foi rotacionado por outra sessão, Claude Code atualiza o token e tenta novamente a solicitação uma vez, então uma expiração de token rotineira não aparece como esta mensagem. Antes da v2.1.216, um token expirado ou rotacionado falhava em cada solicitação de classificador, e auto mode negava cada ação verificada com esta mensagem até que o token fosse atualizado.

Quando o classificador retornou uma resposta não analisável:

```text theme={null}
Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details
```

**O que fazer:**

* Tente novamente a ação; isso geralmente tem sucesso na próxima tentativa
* Execute `claude --debug` e repita a ação para detalhes no log de depuração

Quando uma verificação de segurança de API separada bloqueou a solicitação do classificador por causa do conteúdo anterior da conversa:

```text theme={null}
Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details
```

Claude Code nega a ação mas diz a Claude que isso não é um julgamento de que a ação é insegura, e continuar com outras tarefas em vez de tentar novamente. Essas negações não contam para [limites de pausa de auto mode](https://code.claude.com/docs/pt/permission-modes.md#when-auto-mode-falls-back). Em uma execução [`-p` não interativa](https://code.claude.com/docs/pt/headless), Claude Code não interrompe a execução. O que Claude recebe depende de onde solicitou a ação:

* Para um [subagent em segundo plano](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) em uma execução `-p` sem `--input-format stream-json`, Claude Code retorna um resultado de erro contendo `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode`
* Em todos os outros lugares, incluindo sessões interativas e a conversa principal de uma execução `-p`, Claude Code retorna essa negação a Claude

Antes da v2.1.225, Claude Code contava essas recusas para os limites de pausa e retornava a mesma mensagem de rejeição que um bloco de classificador genuíno.

**O que fazer:**

* Isso não é uma decisão sobre sua ação. O conteúdo já em sua conversa acionou um filtro de segurança na API quando auto mode enviou a conversa para o classificador
* Tentar novamente não ajudará; o mesmo conteúdo de conversa acionará o filtro novamente
* Em uma sessão interativa, mude para um [modo de permissão](https://code.claude.com/docs/pt/permission-modes.md) diferente para que você possa aprovar a ação quando solicitado
* Inicie uma conversa nova sem o conteúdo acionador

Quando a conversa é longa demais para a requisição de classificador do Claude Code e o Claude Code não consegue [compactá-la por conta própria](#was-not-reviewed-and-did-not-run):

```text theme={null}
Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
```

O que acontece com a ação depende de onde Claude a solicitou:

* Em uma sessão interativa, auto mode volta para um prompt de permissão normal para essa ação para que você possa aprová-la ou negá-la manualmente
* Para um [subagent em segundo plano](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) em uma execução [`-p` não interativa](https://code.claude.com/docs/pt/headless) sem `--input-format stream-json`, Claude Code retorna um resultado de erro contendo `Agent aborted: auto mode classifier transcript exceeded context window in headless mode`, e a execução continua
* Em outro lugar em uma execução `-p` sem um [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags), não há prompt para voltar, então a ação não é executada e a execução continua

**O que fazer:**

* Em uma sessão interativa, aprove ou negue a ação no prompt que aparece
* Em uma sessão interativa, execute `/compact` para reduzir o tamanho da conversa para que ações subsequentes se encaixem novamente na janela do classificador

### The server returned no safety verdict

Sob [revisão de classificador do lado do servidor](https://code.claude.com/docs/pt/permission-modes.md#server-side-classifier-review), auto mode nega uma ação quando o servidor não dá um veredicto para ela. A negação nomeia uma categoria entre parênteses quando Claude Code pode determinar uma, como `(timed out)`:

```text theme={null}
The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.
```

O resto da mensagem diz a Claude se uma nova tentativa pode ajudar. Antes de algumas dessas negações, Claude Code aguarda para que a próxima tentativa de Claude não siga imediatamente. Durante a espera em uma sessão interativa, o spinner mostra `Auto mode check unavailable` com uma contagem regressiva, e pressionar `Esc` interrompe o turno.

Após dez respostas seguidas sem veredicto, auto mode interrompe o turno:

```text theme={null}
Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.
```

Algumas negações não contam para as dez, incluindo [uma negação causada pela alteração de um hook ou mod](#hook-changed-input-after-review).

A mensagem de parada aparece em um lugar diferente em cada tipo de sessão:

* Em uma sessão interativa, a mensagem aparece como um aviso na transcrição e o turno termina
* Em uma execução [`-p` não interativa](https://code.claude.com/docs/pt/headless), a execução termina e relata um erro de execução. Com a saída de texto padrão, a mensagem é impressa em stderr.
* Quando um [subagent](https://code.claude.com/docs/pt/sub-agents.md) atingiu o limite, o subagent para antes de terminar, e Claude recebe o que produziu com uma nota de que auto mode o interrompeu

**O que fazer:**

* Em uma sessão interativa, pressione `Ctrl+O` para ler o texto da negação no [visualizador de transcrição](https://code.claude.com/docs/pt/interactive-mode.md#transcript-viewer).
* Se a negação nomear `(the conversation is too long for the check)`, execute `/compact` no prompt do Claude Code para encurtar a conversa. Até que a conversa fique mais curta, enviar outra mensagem resulta na mesma negação. Se você desativou a [compactação automática](https://code.claude.com/docs/pt/settings-reference.md#autocompactenabled), ative-a novamente para que o Claude Code compacte por conta própria na próxima vez.
* Envie outra mensagem para que Claude tente novamente. A contagem de respostas começa do zero.
* Se a parada se repetir e suas solicitações passarem por um [gateway ou proxy LLM](https://code.claude.com/docs/pt/llm-gateway), verifique se ele corta respostas de streaming ou as reescreve. [Revisão de classificador do lado do servidor](https://code.claude.com/docs/pt/permission-modes.md#server-side-classifier-review) diz qual comportamento de gateway causa negações, e o [guia de compatibilidade de gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#feature-pass-through) lista o que passar inalterado.
* Defina `CLAUDE_CODE_AUTO_MODE_SERVER=0` antes de iniciar Claude Code para usar suas próprias solicitações de classificador. Antes da v2.1.281, Claude Code não lia a variável em uma conexão direta com a API Anthropic.
* Para aprovar as ações você mesmo, [mude para fora de auto mode](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes)

Antes da v2.1.280, Claude Code negava cada ação de uma resposta sem veredicto imediatamente e nunca interrompia o turno.

Antes da v2.1.302, em uma conexão direta com a API Anthropic, Claude Code não compactava uma conversa que havia ficado longa demais para a verificação do servidor.

#### `a hook changed this call's input after auto mode reviewed it`

Esta negação significa que um hook ou mod [alterou a entrada da chamada](https://code.claude.com/docs/pt/hooks.md#pretooluse-updatedinput-in-auto-mode) depois que o servidor a revisou, então a revisão não cobre o que seria executado. Não é um julgamento de que a ação é insegura.

Chamadas posteriores na mesma resposta de Claude podem ser negadas com este motivo:

```text theme={null}
another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged
```

Claude pode então emitir cada chamada negada novamente para que o servidor a revise. Se um prompt de permissão for aberto, responda a ele. Você não precisa fazer mais nada, a menos que Claude diga na resposta que o modo auto não conseguiu verificar a chamada. Nesse caso, interrompa a alteração ou aprove a chamada você mesmo, e peça a Claude para tentar a chamada novamente:

* **Interromper a alteração**: desative o [hook](https://code.claude.com/docs/pt/hooks.md#disable-or-remove-hooks) ou o [mod](https://code.claude.com/docs/pt/plugins/mods/overview.md#turn-mods-on-or-off) que alterou a chamada ou uma chamada anterior na mesma resposta de Claude, ou peça ao seu administrador para desativá-lo. Para procurar um hook, execute [`/hooks`](https://code.claude.com/docs/pt/hooks#the-%2Fhooks-menu) no prompt do Claude Code. Em uma sessão de terminal, execute `/plugin` para ver os mods ativos.
* **Aprovar a chamada você mesmo**: [mude para o modo Manual](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes)

### Was not reviewed and did not run

Uma negação `was not reviewed and did not run` significa que a conversa é longa demais para que o classificador do [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) verifique a ação, então a ação não foi executada. Claude Code retorna esta mensagem a Claude:

```text theme={null}
<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier. Claude Code will try to compact the conversation before the next request; if this action is still needed after that, issue it again and it will be reviewed normally.
```

Se a compactação falhar, ações posteriores que o classificador não consegue verificar recebem uma de duas outras mensagens:

* Uma negação [`gave no verdict (the conversation is too long for the check)`](#the-server-returned-no-safety-verdict)
* A mensagem [`Auto mode classifier transcript exceeded context window`](#auto-mode-cannot-determine-the-safety-of-an-action)

**O que fazer:**

* Se a compactação que a mensagem anuncia tiver sucesso, você não precisa fazer nada.
* Se você vir qualquer uma dessas duas mensagens, execute `/compact` no prompt do Claude Code para encurtar a conversa você mesmo. Se você desativou a [compactação automática](https://code.claude.com/docs/pt/settings-reference.md#autocompactenabled), ative-a novamente para que o Claude Code compacte por conta própria na próxima vez.

### Agent terminated early due to an API error

A solicitação de API de um [subagent](https://code.claude.com/docs/pt/sub-agents.md) falhou terminalmente, por exemplo porque um limite de uso foi atingido ou as novas tentativas de um erro de servidor se esgotaram, então o subagent parou antes de terminar sua tarefa. Esta mensagem requer Claude Code v2.1.199 ou posterior; antes disso, o texto de erro da API era retornado a Claude como se fosse o resultado do subagent.

```text theme={null}
Agent terminated early due to an API error: <error detail>
```

**O que fazer:**

* Corresponda o detalhe do erro após os dois pontos à sua própria seção nesta página, como [Usage limits](#usage-limits) ou [Server errors](#server-errors), e siga as etapas dessa seção
* Uma vez que o erro subjacente seja resolvido, peça a Claude para tentar novamente a tarefa ou [retomar o subagent](https://code.claude.com/docs/pt/sub-agents.md#resume-subagents)

Quando um rate limit, sobrecarga ou erro de servidor interrompe um subagent em primeiro plano que já produziu saída de texto, Claude recebe essa saída parcial marcada como incompleta em vez deste erro. Um subagent cuja única saída foram chamadas de ferramenta também recebe este erro; na v2.1.199 essa forma retornava um resultado parcial vazio. Veja [API errors in subagents](https://code.claude.com/docs/pt/sub-agents.md#api-errors-in-subagents).

## Limites de uso

A maioria dos erros nesta seção significa que uma cota vinculada à sua conta ou plano foi atingida. Três funcionam de forma diferente: [`Server is temporarily limiting requests`](#server-is-temporarily-limiting-requests) é um throttle do lado do servidor não relacionado à sua cota de plano, [`Usage credits required for 1M context`](#usage-credits-required-for-1m-context) é uma verificação de direito em vez de uma cota esgotada, e [`The prompt to confirm went unanswered`](#the-prompt-to-confirm-went-unanswered) significa que um prompt de consentimento de créditos de uso foi fechado sem resposta, independentemente de uma cota ter sido atingida.

### You've hit your session limit

Os planos de assinatura incluem uma permissão de uso contínua. Quando ela se esgota, você vê uma destas mensagens:

```text theme={null}
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pm
```

Claude Code bloqueia outras requisições até o horário de reset mostrado na mensagem. Os limites de sessão e semanal são compartilhados entre todos os modelos, portanto, trocar de modelo não restaura o acesso. Os limites de Opus e Sonnet se aplicam apenas a requisições para essa família de modelos, portanto, trocar para um modelo fora da família com `/model` mantém você trabalhando.

Em uma sessão interativa conectada com uma assinatura claude.ai, Claude Code também pode aguardar na sessão aberta e continuar a tarefa interrompida logo após o reset. Veja [Wait for a usage limit to reset](https://code.claude.com/docs/pt/interactive-mode.md#wait-for-a-usage-limit-to-reset) para o que você vê, como iniciar ou cancelar uma espera e como desativar a continuação automática. Antes da v2.1.234, Claude Code não oferecia essa espera.

O uso é contado contra as permissões de sessão e semanal ao mesmo tempo. Uma única rajada de atividade pesada, como um grande fanout de fluxo de trabalho, pode esgotar a permissão semanal antes da janela de sessão ser resetada.

**O que fazer:**

* Aguarde o horário de reset mostrado no erro
* Na aba Code do [Desktop app](https://code.claude.com/docs/pt/desktop.md), o cartão de limite de sessão oferece uma caixa de seleção **Auto-continue when limits reset**. O cartão de limite semanal não oferece. Quando marcada, o Desktop app tenta novamente o turno interrompido após o reset e mostra o horário da tentativa no cartão. A caixa de seleção do Desktop e a configuração **Continue automatically at usage limit** da CLI em `/config` são separadas, portanto, desative cada uma por conta própria.
* Para o limite de Opus ou Sonnet, execute `/model` e mude para um modelo fora dessa família para continuar trabalhando. Cada modelo tem seu próprio cache de prompt, portanto, a próxima requisição relê toda a conversa sem acertos de cache; veja [Switching models](https://code.claude.com/docs/pt/prompt-caching.md#switching-models)
* Execute `/usage` para ver seus limites de plano e quando eles são resetados
* Execute `/usage-credits` para comprar uso adicional em Pro, Max e Ultra, ou para solicitá-lo ao seu administrador em Team e Enterprise. Veja [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para saber como isso é cobrado.
* Para atualizar seu plano para limites base mais altos, veja [claude.com/pricing](https://claude.com/pricing)

Antes de uma janela se esgotar, Claude Code pode avisá-lo de que você usou a maior parte dela, com uma mensagem como `You've used 85% of your session limit · resets 3:45pm`. Para monitorar sua permissão restante, adicione os campos `rate_limits` a uma [custom status line](https://code.claude.com/docs/pt/statusline.md#rate-limit-usage), ou no Desktop app clique no [usage ring](https://code.claude.com/docs/pt/desktop.md#check-usage).

### Usage credits required for 1M context

O modelo selecionado usa a janela de contexto estendido de 1M tokens, e seu plano só o inclui através de créditos de uso.

```text theme={null}
API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context
```

Em uma sessão que o Claude Desktop app executa, a dica não nomeia comandos: ela aponta para a página de configurações de uso do claude.ai, ou em planos Team e Enterprise diz para ativar créditos de uso em claude.ai/admin-settings/usage ou para pedir ao seu administrador.

Esta é uma verificação de direito, não um esgotamento de cota. Ela é acionada mesmo quando suas permissões de sessão e semanal têm capacidade restante. Veja [Extended context](https://code.claude.com/docs/pt/model-config.md#extended-context) para saber quais planos incluem contexto de 1M diretamente e quais exigem créditos de uso.

Quando este erro aparece no meio da conversa porque o contexto cresceu além de 200K tokens, Claude Code compacta automaticamente a conversa de volta para o limite de contexto padrão e mantém a sessão nesse limite depois, portanto, nenhuma ação é necessária. Em versões anteriores à v2.1.172, o erro se repetia em cada requisição subsequente, incluindo `/compact`; execute `/clear` nessas versões para recuperar. Os passos abaixo se aplicam quando você selecionou explicitamente um modelo `[1m]`.

**O que fazer:**

* Execute `/model` e selecione a variante sem o sufixo `[1m]` para voltar à janela de contexto padrão
* Onde a mensagem menciona `/usage-credits`, execute-a para ativar a cobrança medida para a variante 1M em Pro, Max e Ultra, ou para solicitar créditos de uso ao seu administrador em Team e Enterprise. Depois que os créditos de uso estiverem ativados, reinicie Claude Code ou inicie uma nova sessão, o que a mensagem disser. Até então, a sessão permanece no limite de contexto padrão.
* Se o erro persistir após `/model`, um ID de modelo 1M pode estar definido em outro lugar. Veja [Setting your model](https://code.claude.com/docs/pt/model-config.md#setting-your-model) para os locais de configuração a verificar em ordem de prioridade.
* Para remover variantes 1M do seletor de modelo completamente, defina [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](https://code.claude.com/docs/pt/env-vars)

Antes da v2.1.268, a mensagem terminava com `run /usage-credits to turn them on, or /model to switch to standard context` e não mencionava reiniciar.

### The prompt to confirm went unanswered

Quando o [prompt de consentimento de créditos de uso do Fable](https://code.claude.com/docs/pt/model-config.md#fable-and-usage-credits) fecha sem ninguém respondê-lo, Claude Code encerra o turno com uma destas mensagens:

```text theme={null}
Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered · nothing was sent · answer it where this session is running, or /model to change
Fable 5.1 now uses usage credits · the prompt to confirm went unanswered · nothing was sent · answer it where this session is running, or /model to change
```

As mensagens nomeiam o modelo Fable da sessão, portanto, em Fable 5.2 elas leem `continuing on Fable 5.2` e `Fable 5.2 now uses usage credits`. Com o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) conectado, cada mensagem pode, em vez disso, terminar com `Claude stopped here · send a message to be asked again, or switch models`. Antes da v2.1.257, a primeira mensagem começava `Fable 5 limit reached`.

Isso acontece em sessões [Remote Control](https://code.claude.com/docs/pt/remote-control.md), [background sessions](https://code.claude.com/docs/pt/agent-view.md), sessões de colegas de [agent team](https://code.claude.com/docs/pt/agent-teams.md), e sessões que outro aplicativo hospeda através do Agent SDK. Para quando Claude Code fecha o prompt, veja [Fable and usage credits](https://code.claude.com/docs/pt/model-config.md#fable-and-usage-credits).

**O que fazer:**

* Onde a sessão é executada, no terminal ou no aplicativo que a hospeda, envie outro prompt e responda o prompt de consentimento quando ele reaparecer. Para uma sessão em background, anexe-a primeiro da [agents view](https://code.claude.com/docs/pt/agent-view.md). Se a mensagem disser `Claude stopped here`, você também pode responder do seu dispositivo conectado e responder o prompt de consentimento lá.
* Execute `/model` para mudar para um modelo que não cobra créditos de uso
* Para dar a si mesmo mais tempo, defina [`dialogExpiry`](https://code.claude.com/docs/pt/settings-reference#dialogexpiry) para um valor mais longo ou `"never"`

Antes da v2.1.236, esta mensagem não aparecia: enquanto um cliente Remote Control estava conectado, Claude Code aguardava 60 segundos por uma resposta e depois continuava o turno em seu modelo padrão.

### Server is temporarily limiting requests

A API aplicou um throttle de curta duração que não está relacionado à sua cota de plano.

```text theme={null}
API Error: Server is temporarily limiting requests (not your usage limit)
```

Claude Code diferencia estes da sua cota de plano pela ausência dos cabeçalhos de cota unificada que uma resposta de limite real carrega. A partir da v2.1.199, isto é [retried automatically](#automatic-retries) com backoff antes de ser mostrado, independentemente de como você se autentica. Em versões anteriores, uma sessão conectada com uma assinatura claude.ai falhava no turno na primeira ocorrência; apenas as entradas de chave de API e Enterprise a retentavam.

**O que fazer:**

* Aguarde brevemente e tente novamente
* Verifique [status.claude.com](https://status.claude.com) se persistir

### Request rejected (429)

Você atingiu o rate limit configurado para sua chave de API, projeto Amazon Bedrock ou projeto Google Cloud.

```text theme={null}
API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.
```

A frase final nomeia onde verificar a saúde do serviço e varia por provedor. Amazon Bedrock, Agent Platform do Google Cloud e configurações Microsoft Foundry nomeiam o status do serviço daquele provedor em vez da página de status Anthropic. Um `ANTHROPIC_BASE_URL` personalizado nomeia o host do gateway.

Quando um proxy, balanceador de carga ou gateway entre Claude Code e a API responde com sua própria página HTML 429, o texto após o `·` é o título dessa página quando tem um, como `Too Many Requests`. Antes da v2.1.281, a marcação de toda a página era impressa após o `·`.

**O que fazer:**

* 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.
* Verifique seu console de provedor para os limites ativos e solicite um nível mais alto se necessário
* 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
* 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

### You've hit your monthly spend limit

O uso incluído do seu plano não pode cobrir esta requisição, e os [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) que de outra forma pagariam por isso atingiram um limite de gastos. Seu plano não pode cobrir uma requisição quando uma de suas janelas de uso se esgotou, ou quando apenas créditos de uso pagam pela requisição. Um exemplo é uma requisição para um modelo que [bills to usage credits](https://code.claude.com/docs/pt/model-config.md#fable-and-usage-credits).

As palavras antes do `·` nomeiam o limite que bloqueou você, como o limite de gastos mensais da sua organização, e o texto após ele diz como aumentar esse limite. Em uma sessão na nuvem ou sob [Remote Control](https://code.claude.com/docs/pt/remote-control.md), esse texto não fornece URL, e uma mensagem sobre o seu próprio `monthly spend limit` não diz como aumentá-lo. Outras sessões mostram formas como estas:

```text theme={null}
You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings
```

`team's shared budget` é um orçamento agrupado que um administrador atribuiu a um grupo ao qual você pertence; a mensagem não nomeia o grupo. `channel's monthly spend limit` é o orçamento do único canal Slack em que a sessão é executada, portanto, sua organização ainda pode ter orçamento fora dele.

Quando uma das janelas do seu plano é o que se esgotou, a mensagem também diz quando essa janela é resetada, por exemplo `· your session limit resets 3:45pm`, e o acesso retorna então sem que ninguém aumente o limite. Em organizações com cobrança baseada em uso, a mensagem diz `usage limit` em vez de `spend limit`, como em `You've hit your individual usage limit`.

Se você se conectar através de um gateway de aplicativos Claude e vir `spend limit reached` em minúsculas, esse é o limite do seu operador de gateway; veja [Spend limit reached](#spend-limit-reached).

**O que fazer:**

* Em Pro, Max e Ultra, aumente seu limite de gastos mensais em [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai, ou execute `/usage-credits`
* Em Team e Enterprise, aumente o limite em [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) se você gerencia o faturamento, ou peça a um administrador. `/usage-credits` envia essa solicitação ao seu administrador para você
* Para o limite de um canal, peça a um proprietário da organização ou ao gerenciador do canal para aumentá-lo em claude.ai. Veja [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) na documentação Claude Tag
* Se a mensagem nomear um horário de reset para a janela do seu plano, você pode aguardar em vez disso
* Execute `/usage` para ver as janelas do seu plano e quando cada uma é resetada

### Spend limit reached

Você se conecta através de um [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway) e atingiu um [spend cap](https://code.claude.com/docs/pt/claude-apps-gateway-spend-limits.md) que seu operador de gateway definiu. O gateway bloqueia suas requisições até que o operador aumente o limite, ou até que o limite seja resetado, se estiver acima de \$0. Ele marca cada resposta `429` bloqueada com `x-should-retry: false`, portanto, no terminal, Claude Code mostra esta mensagem sem tentar novamente.

```text theme={null}
spend limit reached · resets Dec 1
```

Verifique se a mensagem contém uma data:

* **Com uma data**: o limite é resetado às 00:00 UTC nessa data
* **Sem data**: seu limite é \$0, ou seu gateway executa uma versão anterior à v2.1.225

Qualquer texto adicional na mensagem é uma nota do seu operador de gateway.

Da v2.1.225 até a v2.1.319 no servidor do gateway, a mensagem nomeava o período do limite e o horário de reset, como em `spend limit reached (daily; resets 2026-08-09 00:00 UTC)`.

**O que fazer:**

* Se a mensagem tiver uma data, aguarde o reset, ou siga a nota do operador se a mensagem contiver uma
* Peça ao seu operador de gateway para aumentar o limite se a mensagem não tiver data, se você ainda estiver bloqueado após a data, ou se você atingir o limite rotineiramente

Uma segunda mensagem do gateway, `This request exceeds your group's budget`, significa que o [orçamento agrupado](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#pooled-budget-order) do seu grupo foi esgotado. Siga os passos que ela indica:

```text theme={null}
This request exceeds your group's budget. Ask your organization's admins to raise it, or try again after it resets on November 1 at 00:00 UTC.
```

Uma mensagem relacionada, `spend limit unavailable`, significa que o gateway não conseguiu ler seus registros de gastos e bloqueou a requisição como precaução em vez de sobre seu limite. Geralmente se limpa por conta própria; se persistir, informe seu operador de gateway.

### Credit balance is too low

Sua organização Console ficou sem créditos pré-pagos, ou Claude Code está enviando suas requisições com uma chave de API Console quando você pretendia usar sua assinatura.

```text theme={null}
Credit balance is too low
Credit balance too low · Add funds: https://platform.claude.com/settings/billing
```

**O que fazer:**

* Se você tem um plano Pro, Max, Ultra, Team ou Enterprise e vê isso, execute `/status` e verifique a linha `API key`. Um `ANTHROPIC_API_KEY` aprovado em seu ambiente roteia requisições através dessa chave em vez de sua assinatura. Desdefina-o no shell atual e remova-o do seu perfil de shell, depois relance `claude`. Execute `/login` se você ainda não se conectou com sua assinatura.
* Adicione créditos em [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considere ativar o auto-reload lá para que o saldo seja recarregado antes de atingir zero
* Defina limites de gastos por workspace no Console para evitar que um único projeto drene o saldo da organização. Veja [Manage costs effectively](https://code.claude.com/docs/pt/costs.md).

### Could not update your spend limit

O servidor rejeitou uma alteração de limite de gastos que você fez a partir do prompt que aparece quando você atinge seu limite de gastos.

```text theme={null}
Could not update your spend limit: <reason from the server>
```

Quando o servidor explica a rejeição, a mensagem termina com essa razão, e tentar novamente o mesmo valor falha novamente. Quando a falha não tem razão fornecida pelo servidor, como uma conexão perdida, a mensagem lê `Could not update your spend limit. Press Enter to retry.` e tentar novamente pode ter sucesso. Antes da v2.1.216, Claude Code mostrava a forma genérica para cada falha.

Se você remover o limite, a forma genérica começa com `Could not remove your spend limit` na v2.1.327 ou posterior.

**O que fazer:**

* Se a mensagem incluir uma razão, escolha um limite que a satisfaça, como um valor menor
* Se a mensagem mostrar apenas a forma genérica, tente novamente; a falha pode ser transitória
* Se a alteração continuar falhando, faça-a a partir de suas [claude.ai billing settings](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) no navegador em vez disso

## Erros de autenticação

Esses erros significam que o Claude Code não consegue provar à API quem você é. Execute `/status` a qualquer momento para ver qual credencial está ativa no momento.

### Not logged in

Nenhuma credencial válida está disponível para esta sessão.

```text theme={null}
Not logged in · Please run /login
```

Em uma sessão executada pelo aplicativo Claude Desktop, como a aba Code ou o Cowork, a mensagem diz `Authentication required · Sign in again to continue`, e você faz login novamente pelo aplicativo.

Se você fizer login com sua conta claude.ai em outra janela do Claude Code que usa o mesmo [diretório de configuração](https://code.claude.com/docs/pt/claude-directory.md), uma sessão interativa que mostra esta mensagem passa a usar esse login por conta própria. Você não precisa reiniciá-la.

Antes da v2.1.286 no macOS, a sessão podia continuar mostrando a mensagem depois que você fazia login em outra janela. Nessas versões, reinicie a sessão que mostra a mensagem.

**O que fazer:**

* Execute `/login` para se autenticar com sua assinatura Claude ou conta do Console
* Se você esperava que uma variável de ambiente o autenticasse, confirme que `ANTHROPIC_API_KEY` está definida e exportada no shell onde você iniciou o `claude`
* Para CI ou automação em que o login interativo não é possível, configure um script [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper) que obtenha uma chave na inicialização
* Se jobs `claude -p` encerram com esta mensagem quando alguém entra novamente na mesma conta e organização claude.ai, atualize o Claude Code onde esse login é executado. Antes da v2.1.318, o Claude Code removia o login armazenado durante esse login, antes de salvar o novo.
* Consulte [Precedência de autenticação](https://code.claude.com/docs/pt/authentication.md#authentication-precedence) para entender qual credencial o Claude Code usa quando várias estão presentes

Se for solicitado que você faça login repetidamente, consulte [Não conectado ou token expirado](https://code.claude.com/docs/pt/troubleshoot-install.md#not-logged-in-or-token-expired) para verificações do relógio do sistema e etapas de recuperação do armazenamento de credenciais do macOS.

### Could not resolve authentication method

A sessão chegou ao cliente da API sem nenhuma credencial. [Sessões em segundo plano](https://code.claude.com/docs/pt/agent-view.md) e sessões na nuvem mostram esta mensagem quando o worker é iniciado sem uma credencial. Execuções interativas, com `-p` e do Agent SDK relatam a mesma condição como [Not logged in](#not-logged-in) e gravam esta string apenas no log de depuração, então, se você a encontrou lá, siga aquela entrada.

```text theme={null}
Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
```

Nas versões atuais, o erro significa que nenhuma credencial estava disponível para o processo do worker. Antes da v2.1.174, uma sessão em segundo plano atribuída a um worker pré-inicializado ocioso podia falhar dessa forma mesmo quando credenciais válidas estavam configuradas. Antes da v2.1.176, uma sessão na nuvem que ficava ociosa antes de ser assumida também podia. Atualize para se recuperar.

**O que fazer:**

* Atualize para a v2.1.176 ou posterior se isso aparecer em uma sessão em segundo plano ou na nuvem e suas credenciais já estiverem configuradas
* Confirme que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou as credenciais do seu provedor de nuvem estão definidas no ambiente que inicia o worker, e não apenas no seu shell interativo
* Para o Agent SDK, consulte [configuração de autenticação no início rápido](https://code.claude.com/docs/pt/agent-sdk/quickstart.md#setup)
* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida

### Invalid API key

A variável de ambiente `ANTHROPIC_API_KEY` ou o script `apiKeyHelper` retornou uma chave que a API rejeitou, ou o Claude Code bloqueou uma chave de `ANTHROPIC_API_KEY` antes de enviá-la.

```text theme={null}
Invalid API key · Fix external API key
```

Quando a mensagem continua após `Fix external API key` com uma descrição como `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, a API nunca viu a chave. O Claude Code encontrou um caractere que os cabeçalhos HTTP não conseguem transportar e interrompeu a requisição antes de enviá-la. Consulte [Invalid request header value](#invalid-request-header-value) para saber como ler a descrição e corrigir o valor.

**O que fazer:**

* Verifique se há erros de digitação e confirme que a chave não foi revogada no [Console](https://platform.claude.com/settings/keys)
* No mesmo shell, execute `env | grep ANTHROPIC`, ou no PowerShell `Get-ChildItem Env:ANTHROPIC*`. Ferramentas como direnv, plugins de shell dotenv e terminais de IDE podem carregar uma chave desatualizada de um arquivo `.env` no seu projeto sem que você a defina explicitamente.
* Remova a definição de `ANTHROPIC_API_KEY` e execute `/login` para usar a autenticação por assinatura
* Se a chave vier de um script [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper), execute o script diretamente para confirmar que ele imprime uma chave válida no stdout
* Execute `/status` para confirmar qual fonte de credencial o Claude Code está realmente usando

### Your apiKeyHelper script is failing

O Claude Code executou o comando na sua configuração [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper) e não recebeu uma chave de volta. Sem ela, a requisição chega à API com uma credencial provisória, e a API a rejeita com `401`. O painel `Authentication` no terminal mostra qual destes casos aconteceu:

* O comando terminou com um erro ou atingiu o timeout
* O comando não imprimiu nada no stdout
* O comando imprimiu algo além da chave, como um banner de login ou uma linha de log. O painel mostra `returned output that cannot be used as an API key` e informa o que está errado, sem repetir a saída. Antes da v2.1.227, o Claude Code enviava o que quer que o comando imprimisse, após remover os espaços em branco ao redor.

```text theme={null}
Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
```

No [modo não interativo](https://code.claude.com/docs/pt/headless.md), o stderr também traz o motivo específico, prefixado com `apiKeyHelper failed:`.

O Claude Code executa o script novamente e tenta a requisição novamente até mais duas vezes antes de mostrar esta mensagem, então a falha aparece em até três tentativas. Antes da v2.1.208, o Claude Code gastava todo o [orçamento de novas tentativas](#automatic-retries) reenviando a requisição com a credencial provisória e então relatava um erro de autenticação `401` genérico em vez da falha do script.

Executar `/login` não ajuda aqui: a saída do helper [tem precedência](https://code.claude.com/docs/pt/authentication.md#authentication-precedence) sobre um login salvo enquanto a configuração estiver presente.

**O que fazer:**

* Execute diretamente no seu shell o comando configurado em `apiKeyHelper` para reproduzir a falha
* Se o comando relatar uma sessão expirada, autentique-se novamente com seu provedor de credenciais, por exemplo, fazendo login novamente no seu SSO ou cofre de segredos
* Corrija o comando para que ele imprima apenas a chave no stdout, como um único token de ASCII imprimível de até 16.384 caracteres, e termine com código de saída 0. Consulte [rotacionar credenciais com apiKeyHelper](https://code.claude.com/docs/pt/llm-gateway-connect.md#rotate-credentials-with-apikeyhelper) para uma configuração funcional.
* Execute `/status` para ver a falha e confirmar que `apiKeyHelper` é a fonte de credencial ativa. A linha `apiKeyHelper` mostra `Failing` com o detalhe da última falha, como o código de saída e a saída de erro do comando, e desaparece após a próxima execução bem-sucedida. Antes da v2.1.274, `/status` mostrava apenas a fonte de credencial, não a falha.
* Cada vez que o comando falha, seu código de saída e sua saída de erro também aparecem em um painel `Authentication` no terminal. Antes da v2.1.212, o painel se chamava `Cloud authentication`.

### Claude Code didn't send your claude.ai login

Estas mensagens significam que o Claude Code recusou sua requisição e não enviou seu login claude.ai:

```text theme={null}
Your organization's settings need an update. Ask your administrator to fix the API key helper configuration.
Couldn't load your organization's settings. Check your connection, then restart Claude Code.
Restart Claude Code to finish signing in.
```

**O que fazer:**

* `Your organization's settings need an update`: peça ao seu administrador que corrija a configuração do API key helper
  * Para informar ao seu administrador quais fontes gerenciadas sua máquina tem, execute `/status` no prompt do Claude Code e copie a [linha `Setting sources`](https://code.claude.com/docs/pt/managed-settings#read-the-source-in-/status). Se aparecer uma linha `Skipped sources`, copie-a também
  * Se você administra as configurações e o helper está no arquivo de configurações gerenciadas de uma máquina ou em uma política MDM, consulte [Quando o `apiKeyHelper` de uma máquina não está em vigor](https://code.claude.com/docs/pt/server-managed-settings#machine-apikeyhelper-not-in-effect)
* `Couldn't load your organization's settings`: verifique sua conexão e reinicie o Claude Code. Se a mensagem voltar após uma reinicialização, informe seu administrador
* `Restart Claude Code to finish signing in`: reinicie o Claude Code

Antes da v2.1.315, um prompt ou upload de arquivo recusado imprimia uma única mensagem que começava com `Claude Code didn't send your claude.ai login`.

### Invalid request header value

Um valor que o Claude Code estava prestes a enviar como cabeçalho de requisição contém um caractere que os cabeçalhos HTTP não conseguem transportar: uma quebra de linha, um byte NUL ou um caractere acima de `U+00FF`, como uma aspa curva ou um espaço de largura zero. O Claude Code interrompe a requisição antes que qualquer coisa seja enviada e informa a variável ou configuração a corrigir. A causa usual é uma credencial colada de um documento ou chat que trazia um caractere invisível ou uma quebra de linha perdida.

O Claude Code executa esta verificação quando envia requisições à Claude API diretamente ou por meio de um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway). Em um provedor de nuvem de terceiros, como o [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), o Claude Code não a executa antes de enviar.

```text theme={null}
Invalid auth token · Fix external auth token
Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
Invalid request header from the environment · Fix the environment variable
```

A primeira parte da mensagem depende de onde veio o valor inválido:

* `Invalid auth token`: um bearer token de [`ANTHROPIC_AUTH_TOKEN`](https://code.claude.com/docs/pt/env-vars) ou [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/pt/env-vars)
* `Invalid ANTHROPIC_CUSTOM_HEADERS`: um nome ou valor de cabeçalho que você definiu em [`ANTHROPIC_CUSTOM_HEADERS`](https://code.claude.com/docs/pt/env-vars). A descrição indica pela contagem qual par `Name: Value` está com problema, como `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, sem repetir o nome ou o valor, já que você escolheu ambos.
* `Invalid request header from the environment`: um valor que o Claude Code copia para um cabeçalho de requisição a partir de outra variável de ambiente, como `CLAUDE_AGENT_SDK_CLIENT_APP`. A descrição informa a variável a corrigir.

O Claude Code relata uma `ANTHROPIC_API_KEY` inválida detectada por esta verificação como [Invalid API key](#invalid-api-key), com a mesma descrição ao final. Já uma credencial salva do `/login` inválida é relatada como [Not logged in](#not-logged-in); execute `/login` para salvar uma nova. A saída de um script [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper) nunca chega a esta verificação: o Claude Code a valida quando o script é executado, e uma saída que um cabeçalho HTTP não consegue transportar falha com [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing).

Após o segundo `·`, a mensagem descreve o problema, como neste exemplo completo:

```text theme={null}
Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).
```

As posições contam caracteres a partir de um. A descrição é construída a partir de frases fixas e contagens de caracteres, então nunca inclui o próprio valor. Ela nomeia o caractere problemático apenas quando ele é um caractere invisível ou tipográfico bem conhecido, como uma marca de ordem de bytes, um espaço de largura zero ou uma aspa curva, e relata qualquer outro como `a non-ASCII character`.

**O que fazer:**

* Defina novamente a variável ou configuração que a mensagem indica, redigitando os caracteres ao redor da posição informada em vez de colar da mesma fonte novamente
* Para `ANTHROPIC_CUSTOM_HEADERS`, mantenha um par `Name: Value` por linha e reescreva o par que a mensagem indica
* Execute `/status` para confirmar qual fonte de credencial está ativa

### This organization has been disabled

O Claude Code está usando uma `ANTHROPIC_API_KEY` desatualizada de uma organização do Console desativada. Quando você tem um login de assinatura salvo, a chave o sobrescreve.

```text theme={null}
Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.
```

A dica após o `·` depende das suas credenciais salvas: a primeira forma aparece quando um `/login` armazenado pode assumir depois que você remove a definição da chave, e a segunda quando a chave é sua única credencial.

Se você exportar uma chave no perfil do seu shell ou carregá-la de um `.env`, o Claude Code a usa em vez do `/login`, mesmo com uma assinatura Pro, Max ou Ultra funcionando. No modo não interativo (`-p`), a chave é sempre usada quando presente.

**O que fazer:**

* Remova a definição de `ANTHROPIC_API_KEY` no shell atual e remova-a do perfil do seu shell, depois inicie o `claude` novamente
* Se a mensagem disser `Update or unset`, você não tem um login salvo para usar como alternativa. Remova a definição da chave e execute `/login`, ou substitua a chave por uma de uma organização do Console ativa.
* Execute `/status` em seguida para confirmar que a credencial ativa é sua assinatura
* Se nenhuma variável de ambiente estiver definida e o erro persistir, entre em contato com o suporte ou faça login com uma conta diferente.

### Your organization has disabled API key authentication

Esta mensagem requer o Claude Code v2.1.169 ou posterior. O administrador da sua organização do Console desativou a autenticação por chave de API, então a API rejeita a chave que o Claude Code está enviando. A dica de recuperação após o `·` varia conforme a origem da chave:

```text theme={null}
Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Sign in again with your claude.ai account
```

A última forma aparece em uma sessão executada pelo aplicativo Claude Desktop, como a aba Code ou o Cowork, onde você faz login novamente pelo aplicativo.

As variáveis de ambiente e o `apiKeyHelper` têm precedência sobre o `/login`, então executar apenas `/login` não ajuda enquanto qualquer um deles ainda estiver fornecendo uma chave. Consulte [Precedência de autenticação](https://code.claude.com/docs/pt/authentication.md#authentication-precedence).

**O que fazer:**

* Se a mensagem mencionar `ANTHROPIC_API_KEY`, remova sua definição no shell atual e remova-a do perfil do seu shell ou do arquivo `.env`, depois inicie o `claude` novamente
* Se a mensagem mencionar `apiKeyHelper`, remova a configuração [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper) do seu `settings.json`
* Execute `/login` para fazer login com sua conta claude.ai
* Execute `/status` em seguida para confirmar que a credencial ativa é sua assinatura e não uma chave de API
* Se você precisar de autenticação por chave de API para automação, peça ao administrador da sua organização que a reative no Console

### Your organization has disabled Claude subscription access

Sua organização Claude não permite fazer login no Claude Code com um login de assinatura. Executar `/login` novamente com a mesma conta retorna o mesmo erro.

```text theme={null}
Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
```

Esta é uma configuração da organização no lado do servidor, então não pode ser sobrescrita por configurações locais, variáveis de ambiente ou flags da CLI.

O Agent SDK e o modo não interativo `-p` apresentam isso como o código de erro `oauth_org_not_allowed`.

**O que fazer:**

* Peça ao seu administrador que habilite o acesso ao Claude Code para sua organização
* Autentique-se com uma chave de API do Console em vez da sua assinatura. Consulte [Autenticação do Claude Console](https://code.claude.com/docs/pt/authentication.md#claude-console-authentication) para a configuração.
* Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com o [suporte da Anthropic](https://support.claude.com)

### Scheduled tasks are off for your organization

As [tarefas agendadas na nuvem](https://code.claude.com/docs/pt/routines.md) estão desativadas para sua organização, então você não pode criá-las nem executá-las. A mensagem do claude.ai as chama de tarefas agendadas ou rotinas, e uma frase sobre seu administrador vem em seguida:

```text theme={null}
Scheduled tasks are off for your organization. …
Routines are off for your organization. …
```

Você não pode ativá-las com configurações locais, variáveis de ambiente ou flags da CLI.

**O que fazer:**

* Pergunte ao Owner do seu plano Team ou Enterprise se ele pode ativar a opção rotulada **Scheduled tasks (Was Routines)** ou **Routines** em [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities)

### Remote Control requires the Anthropic API

A sessão não está se comunicando diretamente com a Anthropic API, o que o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) exige.

```text theme={null}
Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.
```

Uma segunda frase explica o que desviou a sessão da Anthropic API; antes da v2.1.219, a mensagem era apenas a primeira frase. Dependendo da causa, a mensagem menciona:

* Uma variável de provedor `CLAUDE_CODE_USE_*`, como `CLAUDE_CODE_USE_BEDROCK` para o [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) ou `CLAUDE_CODE_USE_VERTEX` para o [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md)
* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars) apontando para um host diferente de `api.anthropic.com`, como um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) ou proxy, mesmo quando você faz login com claude.ai; antes da v2.1.196, uma URL base personalizada não bloqueava o Remote Control
* `ANTHROPIC_UNIX_SOCKET` definida, de modo que a sessão envia suas requisições por um socket local em vez de para `api.anthropic.com`
* Um login de [gateway de nuvem](https://code.claude.com/docs/pt/claude-apps-gateway) corporativo feito pelo `/login`, que não oferece suporte ao Remote Control e não tem variável para remover

**O que fazer:**

* Remova a definição da variável que a mensagem menciona, como `CLAUDE_CODE_USE_BEDROCK` ou `ANTHROPIC_BASE_URL`, e reinicie a sessão, ou inicie o Remote Control a partir de uma sessão que se comunica diretamente com a Anthropic API
* Se a variável não estiver definida no seu shell, verifique a chave `env` nos seus [arquivos de configuração](https://code.claude.com/docs/pt/settings.md#where-settings-live), que aplica variáveis de ambiente a todas as sessões
* Para esta e as outras mensagens de inicialização do Remote Control, consulte [Solução de problemas do Remote Control](https://code.claude.com/docs/pt/remote-control.md#troubleshooting)

### Remote Control couldn't refresh your login

O Claude Code executa uma conexão ativa do [Remote Control](https://code.claude.com/docs/pt/remote-control.md) com credenciais de curta duração que ele obtém e renova usando seu login claude.ai salvo. Quando o claude.ai deixa de aceitar esse login, ou o Claude Code não tem mais nenhum login salvo, o Claude Code interrompe o Remote Control e precisa que você faça login novamente. Qualquer uma das falhas pode acontecer enquanto o Claude Code ainda está se conectando ou mais tarde, quando ele renova as credenciais.

Quando o Claude Code pede ao serviço de login que atualize seu login salvo e não obtém resposta, ele mantém o Remote Control em execução e tenta a atualização novamente enquanto a credencial atual da conexão ainda é válida. Uma atualização fica sem resposta quando o Claude Code não consegue alcançar o serviço de login, a requisição atinge o timeout ou o serviço falha sem rejeitar seu login. Se o serviço de login ainda não estiver respondendo quando essa credencial expirar, o Claude Code interrompe o Remote Control e relata `OAuth token refresh failed`.

Quando o Claude Code interrompe o Remote Control, ele mostra o motivo em um aviso e em uma linha da transcrição que começa com `Remote Control disconnected`. Sua sessão local continua em execução sem o Remote Control. Esta seção aborda estas linhas:

```text theme={null}
Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
```

O Claude Code indica a causa no meio da mensagem:

* `Claude.ai login expired` e `Claude.ai login was rejected`: o claude.ai não aceita mais seu token de login salvo, porque ele expirou ou foi revogado
* `OAuth token unavailable`: o Claude Code não tinha nenhum token de login salvo quando a credencial da conexão precisou ser renovada
* `OAuth token refresh failed`: o claude.ai rejeitou seu token de login salvo enquanto o Claude Code estava se reconectando, e a atualização do token não produziu um novo
* `JWT refresh failed: no OAuth token`: o Claude Code não encontrou nenhum token de login salvo para renovar
* `Signed out of Claude`: você fez logout nesta máquina, por exemplo, executando `/logout` em outro terminal, então o Claude Code não tem mais nenhum login salvo para renovar a conexão

**O que fazer:**

* Execute `/login` para fazer login novamente
* Execute `/remote-control` para reconectar a sessão. Mensagens que terminam com `run /login to restore Remote Control` não precisam desta etapa: o Claude Code se reconecta sozinho assim que você faz login.

Antes da v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` dizia `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, e `JWT refresh failed: no OAuth token — run /login` dizia `no OAuth token available for recovery (code <N>)`. As mensagens `Claude.ai login expired`, `Claude.ai login was rejected` e `OAuth token unavailable` foram adicionadas na v2.1.225.

Antes da v2.1.238, o Claude Code relatava os casos que agora dizem `Signed out of Claude` como `JWT refresh failed: no OAuth token — run /login` e interrompia o Remote Control com `Claude.ai login expired — run /login to restore Remote Control` assim que uma atualização de login ficava sem resposta.

### Remote Control could not renew this computer's connection

Este aviso aparece no terminal que executa [`claude remote-control`](https://code.claude.com/docs/pt/remote-control#start-a-remote-control-session) quando o servidor não consegue usar seu login claude.ai para renovar a credencial da conexão antes que ela expire. A última frase do aviso diz por quanto tempo a credencial atual ainda funciona, ou que ela já expirou:

```text theme={null}
Remote Control could not renew this computer's connection: claude.ai did not accept the sign-in it uses. Run `claude /login` to sign in again. The connection keeps working for about 26 hours; if it still cannot sign in then, it stops.
```

**O que fazer:**

* Se o aviso disser para executar `claude /login`, abra outro terminal na máquina que executa o servidor, execute `claude /login` ali e faça login com sua conta claude.ai
* Se o servidor ainda não conseguir fazer login depois que a credencial da conexão expirar, ele imprime um erro contendo `Poll: Authentication failed (401)` e para. Faça login novamente conforme indica a segunda frase do aviso e, em seguida, execute `claude remote-control` novamente no terminal em que o servidor parou.

### Remote Control stopped because the signed-in account changed

O Claude Code mostra esta linha durante uma sessão do [Remote Control](https://code.claude.com/docs/pt/remote-control.md) quando você faz login em uma conta ou organização claude.ai diferente nesta máquina. Você fez a troca fora da sessão do Claude Code, por exemplo, executando `/login` em outro terminal.

Uma sessão do Remote Control que você iniciou enquanto estava conectado pelo `/login` pertence à conta e à organização claude.ai que estavam conectadas naquele momento.

```text theme={null}
Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control
```

O Claude Code interrompe a sessão do Remote Control assim que o claude.ai confirma que a conta ou a organização mudou. Sua sessão local continua em execução sem o Remote Control.

**O que fazer:**

* Execute `/remote-control` para iniciar uma nova sessão do Remote Control na conta ou organização atual
* Para voltar, execute `/login` e faça login novamente na conta ou organização anterior. Depois execute `/remote-control`.

Antes da v2.1.234, o Claude Code não percebia quando você trocava para uma conta ou organização diferente fora da sessão do Claude Code. O Claude Code mantinha a sessão do Remote Control conectada até que uma requisição posterior ao servidor do Remote Control falhasse com `Remote Control server rejected the request (HTTP 404)`. Essa falha podia ocorrer horas após a troca.

### Remote Control stopped because the app running the session signed out or switched accounts

Quando o aplicativo Claude para desktop ou uma IDE hospeda sua sessão, o Claude Code obtém o token de login desse aplicativo em vez do `/login`. Quando o claude.ai rejeita esse token, o Claude Code pede um novo ao aplicativo. Se o aplicativo responder que está desconectado, ou que agora está conectado a uma conta Claude diferente, o Claude Code encerra a sessão do [Remote Control](https://code.claude.com/docs/pt/remote-control.md) e envia ao aplicativo uma destas linhas:

```text theme={null}
Remote Control stopped — the app running this session is now signed in to a different Claude account
Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
```

Sua sessão local continua em execução sem o Remote Control.

**O que fazer:**

* Se o aplicativo estiver desconectado, faça login nele novamente e depois reative o Remote Control no aplicativo
* Se o aplicativo trocou de conta, o Claude Code não pode continuar a sessão encerrada na nova conta. Inicie uma nova sessão do Remote Control nessa conta.

Antes da v2.1.238, o Claude Code enviava ao aplicativo as mensagens `run /login` listadas em [Remote Control couldn't refresh your login](#remote-control-couldnt-refresh-your-login) em ambos os casos.

### OAuth token revoked or expired

Seu login salvo não é mais válido. Um token revogado significa que você fez logout em todos os lugares ou que um administrador removeu o acesso; um token expirado significa que a atualização automática falhou no meio da sessão.

Ambas as mensagens relatam uma rejeição que a API retornou para uma requisição enviada pelo Claude Code. Quando o login salvo já foi apagado após uma renovação com falha, consulte [Login expired](#login-expired). Se você se autentica com um token de longa duração em [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/pt/env-vars), você vê as mesmas mensagens quando esse token expira ou é revogado.

```text theme={null}
OAuth token revoked · Please run /login
Please run /login · API Error: 401 OAuth token has expired ...
```

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) (`-p`) e no [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), as mensagens são as seguintes, e o código de erro estruturado é `authentication_failed`:

```text theme={null}
Failed to authenticate: OAuth token revoked. Please log in again or contact your administrator.
Failed to authenticate. API Error: 401 OAuth token has expired ...
```

Antes da v2.1.287, no modo não interativo e no Agent SDK, a mensagem de token revogado dizia `Your account does not have access to Claude. Please login again or contact your administrator.`

**O que fazer:**

* Execute `/login` no prompt do Claude Code para fazer login novamente
* Se o seu comando `-p` ou programa do Agent SDK usa um login salvo, execute `claude` no mesmo ambiente, conclua o `/login` e então execute o comando ou programa novamente. Para automação que não pode fazer login interativamente, autentique-se com [`ANTHROPIC_API_KEY`](https://code.claude.com/docs/pt/env-vars) ou [gere um token de longa duração com `claude setup-token`](https://code.claude.com/docs/pt/authentication#generate-a-long-lived-token).
* Se você se autentica com a variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`, o Claude Code continua enviando o valor que você definiu depois que uma requisição falha com 401, em vez de passar para o token de um login armazenado. [`/status`](https://code.claude.com/docs/pt/commands) mostra essa credencial como uma linha `Auth token` com o valor `CLAUDE_CODE_OAUTH_TOKEN`. Gere um novo token com [`claude setup-token`](https://code.claude.com/docs/pt/authentication#generate-a-long-lived-token) e reinicie com ele, ou remova a definição da variável e execute `/login`. Antes da v2.1.225, o Claude Code podia substituir o valor da variável no meio da sessão pelo token de acesso de curta duração de um login armazenado, e a sessão falhava novamente com erros 401 quando esse token expirava.
* Para solicitações repetidas de login entre inicializações, consulte as verificações do relógio do sistema e as etapas de recuperação do armazenamento de credenciais do macOS em [Solução de problemas](https://code.claude.com/docs/pt/troubleshoot-install.md#not-logged-in-or-token-expired)
* Para outras falhas, incluindo `403 Forbidden` e problemas de OAuth no navegador, consulte [Login e autenticação](https://code.claude.com/docs/pt/troubleshoot-install.md#login-and-authentication)

### API Error: 401 Invalid authentication credentials

A API reconheceu o formato da sua credencial, mas rejeitou a conta ou a organização por trás dela. A Anthropic retorna esta mensagem quando uma credencial foi revogada recentemente, quando uma organização foi desativada ou removeu seu acesso, ou quando a própria conta foi desativada, então um token expirado não é a causa. A credencial pode ser seu login salvo ou uma `ANTHROPIC_API_KEY` aprovada, e a correção é diferente, então comece executando `/status` para ver qual delas está ativa.

```text theme={null}
Please run /login · API Error: 401 Invalid authentication credentials
```

**O que fazer:**

* Se `/status` mostrar uma linha `API key` que não esteja marcada como não utilizada, uma [`ANTHROPIC_API_KEY`](https://code.claude.com/docs/pt/authentication#authentication-precedence) aprovada é a credencial ativa e tem precedência sobre seu login, então o `/login` não a substitui. Rotacione a chave no Claude Console, ou volte para sua assinatura executando `unset ANTHROPIC_API_KEY`, ou no PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.
* Se `/status` mostrar apenas seu login, execute `/login` uma vez. Se a credencial foi revogada, um novo login a substitui.
* 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.
* Se [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars) apontar para um [gateway de LLM](https://code.claude.com/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.
* Se todas as requisições falharem com `401` depois que seu gateway tiver a credencial que espera, verifique se o gateway e seu upstream aceitam os campos de [tool search](https://code.claude.com/docs/pt/mcp.md#tool-search-through-a-gateway). Por padrão, o Claude Code envia campos de ferramenta `defer_loading` e blocos `tool_reference`, com o cabeçalho `anthropic-beta` que os habilita. 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`.

### Login expired

O Claude Code tentou renovar seu login claude.ai salvo e o serviço OAuth rejeitou o refresh token armazenado, então o Claude Code apagou as credenciais salvas. Sem [outra credencial salva](https://code.claude.com/docs/pt/authentication.md#after-the-login-expires), as requisições ao modelo então param com esta mensagem:

```text theme={null}
Login expired · Please run /login
```

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) (`-p`) e no [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), a mensagem é a seguinte, e o código de erro estruturado é `authentication_failed`:

```text theme={null}
Failed to authenticate: OAuth session expired and could not be refreshed
```

Se o login atingiu seu limite de tempo, ambas as mensagens dizem `reached its time limit` no Claude Code v2.1.318 ou posterior. Para uma mensagem `Login expired` que termina com `or re-authenticate your Anthropic profile`, consulte [Anthropic profile login expired](#anthropic-profile-login-expired).

Quando a renovação falha porque a própria conta está suspensa, o Claude Code mostra [Your account is on hold](#your-account-is-on-hold).

**O que fazer:**

* Execute `/login` para fazer login novamente.
* Se você fizer login com sua conta claude.ai em outra janela do Claude Code, consulte [Not logged in](#not-logged-in) para saber quando esta sessão passa a usar esse login por conta própria.
* No modo não interativo, execute `claude` no mesmo ambiente, conclua o `/login` e então execute seu comando novamente. Para automação que não pode fazer login interativamente, autentique-se com `ANTHROPIC_API_KEY` ou [gere um token de longa duração com `claude setup-token`](https://code.claude.com/docs/pt/authentication#generate-a-long-lived-token).
* Se o login continuar falhando, consulte [Login e autenticação](https://code.claude.com/docs/pt/troubleshoot-install.md#login-and-authentication)

### Could not refresh your login because another Claude Code process is refreshing it

Esta mensagem não significa que seu login foi rejeitado. Seu login claude.ai salvo havia expirado e precisava ser renovado. Outro processo do Claude Code na mesma máquina detinha o bloqueio compartilhado de atualização, ou terminou e o deixou para trás, e a atualização não progrediu enquanto esta sessão esperava. O Claude Code interrompe a requisição antes de enviá-la:

```text theme={null}
Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login
```

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) (`-p`) e no [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), a mensagem é a seguinte, e o código de erro estruturado é `server_error`:

```text theme={null}
Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again
```

**O que fazer:**

* Tente novamente em um minuto. Se outro processo concluir a atualização primeiro, esta sessão usa o login renovado.
* Se a mensagem continuar voltando, feche as outras janelas e processos do Claude Code e tente novamente.
* Se ela voltar sem nenhum outro processo do Claude Code em execução, execute `/login`. Fazer login novamente não espera pelo bloqueio de atualização.

### Could not refresh your login: the disk that holds the Claude Code config directory is full

Libere espaço no disco que contém o diretório de configuração do Claude Code e depois envie sua mensagem novamente. Fazer login não ajudaria enquanto o disco estiver cheio, porque um novo login não poderia ser salvo. O diretório de configuração é `~/.claude` no seu diretório pessoal, a menos que você defina [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/pt/env-vars).

```text wrap theme={null}
Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full · Delete files you no longer need on that disk, then try again · Signing in again won't help
```

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) (`-p`) e no [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), a mensagem diz:

```text wrap theme={null}
Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full. Delete files you no longer need on that disk and retry; signing in again won't help
```

**O que fazer:**

* Para um script, execute novamente seu comando `claude -p`
* Se o disco já mostrar espaço livre, esgotar a cota de disco ou os inodes produz a mesma mensagem. Exclua seus próprios arquivos nesse disco. Se a mensagem voltar, exclua muitos arquivos pequenos em vez de alguns grandes, porque cada arquivo ocupa um inode, qualquer que seja seu tamanho.

### Couldn't save your login

Você fez login com claude.ai, mas o Claude Code não conseguiu salvar o login no seu armazenamento de credenciais, então o login não foi concluído. No macOS, isso pode acontecer quando o keychain de login é bloqueado, por exemplo, durante a suspensão ou inatividade, depois que o Claude Code já leu ou salvou credenciais nele durante a mesma sessão.

```text theme={null}
Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
Couldn't save your login. Try logging in again.
```

A primeira forma aparece no macOS e a segunda em todos os outros lugares. Uma falha transitória do armazenamento de credenciais, como um timeout ou um armazenamento ilegível, produz a mesma mensagem.

**O que fazer:**

* No macOS, desbloqueie o keychain de login e então execute `/login` novamente
* Em outras plataformas, execute `/login` novamente
* Se o login ainda não for salvo, consulte [Não conectado ou token expirado](https://code.claude.com/docs/pt/troubleshoot-install.md#not-logged-in-or-token-expired) para o comando de desbloqueio do keychain e outras etapas de recuperação do armazenamento de credenciais

### Sign in again to take your previous account or API key off the config file

Este aviso após você entrar significa que qualquer conta com a qual você estava conectado antes ainda pode estar armazenada em [`~/.claude.json`](https://code.claude.com/docs/pt/claude-directory#ce-claude-json):

```text theme={null}
Sign in again to take your previous account or API key off the config file.
```

Uma chave de API também pode ainda estar em `~/.claude.json` se um login do Console tiver criado uma no Linux ou no Windows.

**O que fazer:**

* Execute `claude auth login` no seu shell para entrar novamente. O Claude Code então tenta novamente o salvamento que remove do arquivo a conta ou a chave de API substituída.

### Your account or API key may still be in the config file

Você executou `/logout` ou `claude auth logout`, e o Claude Code desconectou este processo, mas não conseguiu confirmar que [`~/.claude.json`](https://code.claude.com/docs/pt/claude-directory#ce-claude-json) não contém mais sua conta. Ou o salvamento não foi concluído, ou o arquivo não pôde ser lido de volta para verificação.

```text theme={null}
Your account or API key may still be in the config file. Run claude auth logout.
```

Uma chave de API também pode ainda estar em `~/.claude.json` se um login do Console tiver criado uma no Linux ou no Windows.

**O que fazer:**

* Execute `claude auth logout` no seu shell para tentar o salvamento novamente. Quando o salvamento for concluído, o comando imprime `Successfully logged out from your Anthropic account.`

### Couldn't start the local listener that receives the browser sign-in

Cada 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.

Com 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:

```text wrap theme={null}
The browser can't return the sign-in to Claude Code automatically. After you sign in, paste the code shown.
```

Com 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:

```text theme={null}
Couldn't start the local listener that receives the browser sign-in. Try again.
```

**O que fazer:**

* **`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í.
* **`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.
* **Para entrar com um token ou chave de API em vez do navegador**: se você usa uma assinatura claude.ai, execute [`claude setup-token`](https://code.claude.com/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`](https://code.claude.com/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](https://code.claude.com/docs/pt/authentication.md#authentication-precedence) explica como o Claude Code escolhe entre credenciais.
* **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.

Antes 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.

### Claude login not accepted

Você tentou iniciar uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), e o servidor se recusou a criá-la com um 401: ele não aceitou o login Claude que esta máquina enviou, geralmente porque o login expirou ou foi revogado.

A primeira parte da linha é o próprio motivo do servidor, quando ele informa um. Caso contrário, a linha diz:

```text theme={null}
Claude login not accepted · Run /login, then try again
```

**O que fazer:**

* Execute `/login`, conclua o login e então inicie a sessão novamente

### Artifacts need a claude.ai login

O Claude Code recusou a publicação ou leitura de um [artefato](https://code.claude.com/docs/pt/artifacts.md) porque a sessão não tem um login claude.ai que possa usar para artefatos.

Todas as formas da mensagem começam com as mesmas palavras, seguidas de uma solução que depende de como sua sessão se autentica. Sem nenhuma credencial concorrente, ela diz:

```text theme={null}
Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.
```

**O que fazer:**

* Execute `/login` e selecione **Claude account with subscription**. A opção **Anthropic Console account** não fornece credenciais claude.ai.
* Quando a mensagem mencionar uma credencial que tem precedência, como `ANTHROPIC_API_KEY`, uma configuração `apiKeyHelper` ou uma chave do Console salva por um `/login` anterior, remova-a da forma que a mensagem indica e então execute `/login`
* Quando a mensagem disser que esta sessão remota se autentica pela máquina que a iniciou, faça login no claude.ai nessa máquina e então reconecte a sessão
* Quando a mensagem disser que a credencial é injetada pelo ambiente host da sessão, você não pode alterá-la nessa sessão; inicie uma sessão que esteja conectada ao claude.ai
* Consulte [Disponibilidade](https://code.claude.com/docs/pt/artifacts.md#availability) para os outros requisitos dos artefatos, como plano, provedor de modelo e política da organização

### Administrator policy requires a Cloud gateway sign-in

As [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) de um administrador nesta máquina definem [`forceLoginMethod`](https://code.claude.com/docs/pt/settings-reference#forceloginmethod) como `"gateway"` ou definem [`forceLoginGatewayUrl`](https://code.claude.com/docs/pt/settings-reference#forcelogingatewayurl). A menos que você selecione um provedor de nuvem por meio de uma variável como `CLAUDE_CODE_USE_BEDROCK`, o Claude Code passa a aceitar apenas o login do [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway). Você vê uma de duas mensagens:

```text theme={null}
Not signed in to the Cloud gateway — run /login.
```

As requisições ao modelo falham com esta mensagem quando a sessão não tem um login no gateway, por exemplo, porque você não executou `/login` desde que a política chegou à máquina.

Se a máquina também tiver uma credencial emitida pela Anthropic e as configurações gerenciadas definirem `forceLoginMethod` ou `forceLoginOrgUUID`, o Claude Code é encerrado na inicialização. Essa credencial pode ser uma variável `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN`, uma configuração `apiKeyHelper` ou uma chave de API salva por um login anterior no Claude Console.

A mensagem de inicialização indica a credencial com a qual a sessão está configurada, onde ela está definida e a etapa que a remove. Por exemplo, com uma variável `ANTHROPIC_API_KEY` definida no seu shell, ela diz:

```text theme={null}
Administrator policy requires a Cloud gateway sign-in on this machine, but this session is configured with an API key from ANTHROPIC_API_KEY, which a gateway machine does not accept.

To continue: unset ANTHROPIC_API_KEY (or run in a shell without it), then run claude and sign in with /login.
```

**O que fazer:**

* Para `Not signed in to the Cloud gateway`, execute `/login` e conclua o login na tela **Cloud gateway**
* Para a mensagem de inicialização, remova a credencial seguindo as etapas no final da mensagem
* Se você acredita que a máquina não deveria exigir o gateway, peça ao administrador que a gerencia que remova `forceLoginMethod` e `forceLoginGatewayUrl` das configurações gerenciadas dela

Antes da v2.1.284, a mensagem de inicialização listava as credenciais possíveis em vez de indicar a configurada. Ela começava com `Administrator policy requires a Cloud gateway sign-in on this machine; the Anthropic-issued credential configured here (ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.` Se você vir esse texto e não conseguir saber qual credencial remover, atualize para a v2.1.284 ou posterior e inicie o `claude` novamente.

Na v2.1.265, uma regressão também mostrava a primeira mensagem em algumas configurações de gateway de LLM e proxy que se autenticam com uma chave de API, `apiKeyHelper` ou cabeçalhos personalizados, mesmo sem nenhum requisito de administrador na máquina. Atualize para a v2.1.266 ou posterior. Você não precisa alterar sua configuração.

Antes da v2.1.261, em máquinas que definem `forceLoginMethod` como `"gateway"`, o Claude Code usava um login salvo remanescente em vez de falhar as requisições ao modelo, e relatava uma credencial de ambiente configurada com `This machine's managed settings require a first-party login` em vez da mensagem de inicialização.

### Your account is on hold

A conta Claude por trás do seu login foi suspensa. O Claude Code mostra a primeira mensagem quando tenta renovar seu login salvo e descobre a suspensão, e a segunda quando um login que você conclui no navegador a informa:

```text theme={null}
Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
```

Fazer login novamente com a mesma conta não elimina a mensagem, porque a suspensão está na conta e não no login. No [modo não interativo](https://code.claude.com/docs/pt/headless.md) (`-p`) e no [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), o código de erro estruturado é `account_on_hold`. Antes da v2.1.235, o Claude Code relatava uma conta suspensa como [Login expired · Please run /login](#login-expired), cujas etapas de recuperação não conseguem remover uma suspensão.

**O que fazer:**

* Abra o link na mensagem para ver os detalhes da suspensão ou contestá-la
* Se você tiver outra conta Claude ou uma chave de API que não seja afetada pela suspensão, pode continuar trabalhando enquanto a suspensão é resolvida: execute `/login` com essa conta ou defina a chave com `ANTHROPIC_API_KEY`

### Anthropic profile login expired

O Claude Code está se autenticando por meio de um perfil de credenciais da Anthropic cuja credencial de login salva expirou, e o perfil não contém nenhuma credencial de atualização que o Claude Code possa usar para renová-la. O Claude Code interrompe cada requisição localmente sem tentar novamente.

```text theme={null}
Anthropic profile login expired · Re-authenticate your Anthropic profile
Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile
```

**O que fazer:**

* Se a mensagem começar com `Login expired`, execute `/login` para entrar novamente
* Para renovar um perfil que o login sem chave do Console ou o `ant auth login` da CLI da Claude Platform gravou, execute `/login` em uma máquina que [ofereça o login sem chave](https://code.claude.com/docs/pt/authentication.md#sign-in-without-an-api-key). Escolha a conta do Anthropic Console e depois **Sign in with your Console account**. O Claude Code substitui a credencial expirada nesse perfil
* Para renovar um perfil que outra ferramenta criou, entre novamente com essa ferramenta. Se, em vez disso, você escolher **Sign in with your Console account** no `/login`, o Claude Code deixa o perfil como está e cria uma chave de API
* Se um administrador provisionou a credencial do perfil, peça a ele que emita uma nova
* Execute `/status` para confirmar a fonte de credencial ativa e o nome do perfil
* Para deixar de usar o perfil, remova a definição de `ANTHROPIC_PROFILE` se você a definiu e então autentique-se de outra forma, como `/login` ou `ANTHROPIC_API_KEY`

O início da mensagem indica como o Claude Code encontrou o perfil:

* Quando o Claude Code descobriu o perfil a partir do seu diretório de configuração e o modo de autenticação dele é `user_oauth`, a mensagem começa com `Login expired` e oferece `/login` primeiro. O Claude Code dá a um `/login` funcional precedência sobre o perfil descoberto e então se autentica com sua conta claude.ai. Da v2.1.234 até a v2.1.277, essa forma dizia `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile`. Antes da v2.1.234, o Claude Code também mostrava a forma `Re-authenticate your Anthropic profile` nesse caso.
* Quando você selecionou o perfil com `ANTHROPIC_PROFILE`, a mensagem começa com `Anthropic profile login expired`.

Isso aparece apenas quando a credencial ativa vem de um perfil de credenciais da Anthropic, seja um que você seleciona com a variável de ambiente `ANTHROPIC_PROFILE`, um que o Claude Code descobre como o perfil ativo no seu diretório de configuração da Anthropic, ou um que o Claude Code gravou quando você [entrou sem uma chave de API](https://code.claude.com/docs/pt/authentication.md#sign-in-without-an-api-key). Sessões que se autenticam com uma chave de API, um bearer token como `ANTHROPIC_AUTH_TOKEN` ou um provedor de terceiros nunca veem esta mensagem.

### OAuth scope requirement

O token armazenado é anterior a um escopo de permissão de que um recurso mais recente precisa:

```text theme={null}
OAuth token does not meet scope requirement: user:profile
```

**O que fazer:**

* Execute `/login` para obter um novo token com os escopos atuais. Você não precisa fazer logout antes.

### claude.ai rejected the session token

Uma requisição de um [conector do claude.ai](https://code.claude.com/docs/pt/mcp.md#use-mcp-servers-from-claude-ai) falhou porque o claude.ai rejeitou o token do seu login no Claude Code. O token rejeitado é o seu login, e não a autorização própria do conector no claude.ai, então autorizar o conector novamente não resolve. Em `/mcp`, o conector aparece como `session token rejected` e sua visualização de detalhes diz:

```text theme={null}
claude.ai rejected the session token. Run /login, then reconnect.
```

**O que fazer:**

* Execute `/login` para fazer login novamente
* Reconecte o conector pelo `/mcp` ou execute `/mcp reconnect <server>`. Reconectar antes de fazer login novamente deixa o conector no mesmo estado. A opção **Reconnect** do painel `/mcp` informa `your claude.ai session token was rejected`; a forma digitada `/mcp reconnect <server>` informa uma reconexão bem-sucedida mesmo que o token ainda seja rejeitado.

Antes da v2.1.222, o Claude Code marcava o conector como precisando de autenticação, o que direcionava você ao fluxo de autorização do conector, embora concluí-lo não resolvesse o estado.

### MCP server needs you to sign in again

Um [servidor MCP](https://code.claude.com/docs/pt/mcp.md) remoto rejeitou a credencial em uma chamada de ferramenta no meio da sessão, geralmente porque um login ou token expirou ou porque o token não tem uma permissão de que a ferramenta precisa. A chamada de ferramenta falha, e o `/mcp` marca o servidor como [precisando de autenticação](https://code.claude.com/docs/pt/mcp.md#authenticate-with-remote-mcp-servers).

Para um servidor no qual você faz login a partir do Claude Code, incluindo um conector do claude.ai, o login expirou ou foi revogado:

```text theme={null}
MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)
```

Execute `/mcp`, selecione o servidor e faça login novamente pelo menu dele.

Para um servidor configurado com um script [`headersHelper`](https://code.claude.com/docs/pt/mcp#use-dynamic-headers-for-custom-authentication), o Claude Code já executou o helper novamente e tentou a chamada de novo uma vez antes de mostrar isto:

```text theme={null}
MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)
```

Verifique se o helper retorna uma credencial que o servidor aceita e então reconecte pelo `/mcp`, que executa o helper novamente.

Para um servidor com um cabeçalho `Authorization` estático na sua configuração:

```text theme={null}
MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
```

Atualize o valor do cabeçalho onde o servidor está configurado e então reconecte pelo `/mcp`.

Em 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:

```text theme={null}
MCP server "<name>" rejected the credential from its headersHelper (check the helper, then start a new task or chat)
MCP server "<name>" rejected the Authorization header in its config (update it, then start a new task or chat)
```

* **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
* **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

Antes 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)`.

Um servidor também pode recusar uma chamada de ferramenta com HTTP 403 `insufficient_scope` para pedir que você autorize um escopo, às vezes um que seu token já lista. A mensagem indica esse escopo:

```text theme={null}
MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate
```

Execute `/mcp`, selecione o servidor e autentique-se novamente pelo menu dele.

Quando a configuração do servidor não define [`oauth.scopes`](https://code.claude.com/docs/pt/mcp#restrict-oauth-scopes) nem [`authServerMetadataUrl`](https://code.claude.com/docs/pt/mcp#override-oauth-metadata-discovery), o Claude Code solicita o escopo que o servidor indicou. Com qualquer uma dessas configurações, o Claude Code solicita os escopos dessa configuração. Se você fixou `oauth.scopes`, adicione o escopo ausente a essa lista antes de se autenticar novamente.

Antes da v2.1.274, este caso mostrava a mensagem `needs you to sign in again`, e antes da v2.1.273 mostrava `requires re-authorization (token expired)` como os outros casos.

### Couldn't read the stored credentials for MCP server

O Claude Code mantém seus logins de [servidores MCP](https://code.claude.com/docs/pt/mcp.md) OAuth em um armazenamento de credenciais. Esta mensagem significa que o Claude Code não conseguiu ler esse armazenamento, então uma requisição ao servidor não foi executada:

```text theme={null}
Couldn't read the stored credentials for MCP server "<name>", so the request didn't run. If your Mac's keychain is locked, unlock it, then try again.
Couldn't read the stored credentials for MCP server "<name>", so the request didn't run. Try again.
```

Seus logins armazenados não foram alterados: tente novamente quando o armazenamento puder ser lido, e faça login novamente apenas se o servidor pedir.

Em uma execução de [`claude -p`](https://code.claude.com/docs/pt/headless) ou do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md) no macOS, o keychain pode se tornar legível depois que uma requisição já foi enviada sem o login armazenado. Essa requisição falha com:

```text theme={null}
A request to MCP server "<name>" was sent without your stored credentials, so the server rejected it. The credentials are available now. Try again.
```

**O que fazer:**

* Se a mensagem pedir que você desbloqueie o keychain do seu Mac, execute [`claude doctor`](https://code.claude.com/docs/pt/cli-reference#cli-commands) na sessão do shell em que você executa o Claude Code e verifique se o relatório contém um aviso sobre o keychain:
  * Se o relatório listar um aviso que começa com `macOS Keychain is not writable`, ou se seu shell não tiver o comando `claude`, execute este comando de desbloqueio nessa sessão do shell:

    ```bash theme={null}
    security unlock-keychain ~/Library/Keychains/login.keychain-db
    ```

  * Se o relatório não listar nenhum aviso sobre o keychain, pule o comando de desbloqueio

* Tente novamente onde você viu a mensagem:
  * Para `claude -p`, execute o comando novamente
  * Em uma sessão interativa, reconecte o servidor a partir de `/mcp` se ele aparecer como com falha ali e, em seguida, peça ao Claude que tente novamente
  * Em uma aplicação do Agent SDK que continua em execução, chame [`reconnectMcpServer()`](https://code.claude.com/docs/pt/agent-sdk/typescript#methods) em TypeScript ou [`ClaudeSDKClient.reconnect_mcp_server()`](https://code.claude.com/docs/pt/agent-sdk/python#methods) em Python, ou inicie uma nova sessão

* Se o servidor então relatar que precisa de autenticação, o Claude Code não encontrou nenhum login que possa usar para esse servidor. Faça login interativamente: execute `/mcp` em uma sessão do Claude Code, ou [`claude mcp login <name>`](https://code.claude.com/docs/pt/mcp#authenticate-from-the-command-line) no seu shell. Em uma aplicação do Agent SDK, consulte [Autenticação OAuth2 no Agent SDK](https://code.claude.com/docs/pt/agent-sdk/mcp.md#oauth2-authentication).

Antes da v2.1.307, uma execução de `claude -p` ou do Agent SDK em um Mac com o keychain de login bloqueado relatava que o servidor precisava de autenticação em vez de mostrar qualquer uma das mensagens.

### MCP server URL is missing or not a valid URL

O Claude Code se recusou a iniciar um login OAuth para um servidor MCP remoto porque a `url` configurada do servidor não é analisada como uma URL. A menos que o Claude Code tenha um problema de configuração mais específico a relatar para o servidor, executar [`claude mcp login <name>`](https://code.claude.com/docs/pt/mcp#authenticate-from-the-command-line) no seu shell imprime a recusa como:

```text theme={null}
Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.
```

**O que fazer:**

* Defina a `url` da entrada como o endpoint real do servidor onde o servidor está configurado, ou defina a variável de ambiente que sua [referência `${VAR}`](https://code.claude.com/docs/pt/mcp#environment-variable-expansion-in-mcp-json) indica, e então execute o login novamente.

### Issuer mismatch in authorization response

Durante um [login OAuth do MCP](https://code.claude.com/docs/pt/mcp.md#authenticate-with-remote-mcp-servers), o servidor de autorização redirecionou de volta para o Claude Code com um parâmetro `iss` que não indica o emissor que o Claude Code esperava com base nos metadados OAuth do servidor. Um emissor incorreto nesta etapa é a aparência de um ataque de confusão de servidor de autorização (mix-up), então o Claude Code faz o login falhar em vez de trocar o código de autorização. O Claude Code mostra o erro no menu do servidor em `/mcp` após o login no navegador:

```text theme={null}
Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
```

`expected` é o emissor dos metadados OAuth do servidor, e `received` é o valor de `iss` que o redirecionamento trouxe. Um login cujo redirecionamento não traz nenhum parâmetro `iss` passa na verificação, a menos que os metadados do servidor definam `authorization_response_iss_parameter_supported`, caso em que o Claude Code faz o login falhar.

**O que fazer:**

* Tente o login novamente pelo `/mcp`
* Se o erro se repetir, relate-o ao operador do servidor. A correção é no lado do servidor: o servidor de autorização deve retornar no parâmetro `iss` o mesmo emissor que anuncia em seus metadados
* Para se conectar enquanto o servidor está sendo corrigido, inicie o Claude Code com [`MCP_SDK_GENERATION=v1`](https://code.claude.com/docs/pt/env-vars), cujo [runtime](https://code.claude.com/docs/pt/mcp.md#mcp-client-runtimes) não executa esta verificação. Isso remove uma proteção contra ataques de mix-up, então prefira a correção no lado do servidor

Antes da v2.1.232, o Claude Code usava o runtime v2 apenas em uma implantação gradual ou quando você definia `MCP_SDK_GENERATION=v2`.

### Stopped an OAuth request

Esta mensagem significa que o Claude Code interrompeu uma [requisição OAuth para um servidor MCP](https://code.claude.com/docs/pt/mcp.md#authenticate-with-remote-mcp-servers) porque um endpoint OAuth a redirecionou. Em ambas as formas da mensagem, o primeiro endereço é aquele que enviou o redirecionamento:

```text theme={null}
Stopped an OAuth request, which can hold secrets: https://auth.example.com redirected it to https://other.example.com. Ask the owner of https://auth.example.com to remove that redirect.
Stopped an OAuth request: https://auth.example.com redirected it more than 5 times. Ask the owner of https://auth.example.com to fix those redirects.
```

**O que fazer:**

* Peça a quem administra o primeiro endereço, como o operador do servidor MCP, para remover ou corrigir o redirecionamento. Depois, tente novamente a partir de `/mcp`.

### Refusing to send credentials to non-https token endpoint

No [runtime v2](https://code.claude.com/docs/pt/mcp.md#mcp-client-runtimes), o Claude Code envia uma requisição de token do [OAuth do MCP](https://code.claude.com/docs/pt/mcp.md#authenticate-with-remote-mcp-servers) apenas para um endpoint de token servido por HTTPS ou em `localhost`, `127.0.0.1` ou `::1`. Esta mensagem significa que o endpoint de token do servidor não é nenhum desses, então o Claude Code parou antes de enviar a requisição. Isso acontece após o login no navegador, então a etapa do navegador é bem-sucedida primeiro, e novamente sempre que o Claude Code atualiza o token do servidor.

Em sua forma completa, a mensagem vem do MCP SDK e cita o endpoint de token que ele recusou. No log de depuração, ela vem após `Error during auth completion:` para um login ou `Token refresh failed:` para uma atualização. No seu shell, `claude mcp login <name>` a imprime após `Couldn't complete authentication for "<name>":`, e em uma sessão, o `/mcp` a mostra no menu do servidor:

```text theme={null}
Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).
```

O Claude Code trata uma URL de servidor que tenha uma query string ou um segmento de caminho longo e de aparência aleatória como possivelmente secreta. Para esse tipo de servidor, ele oculta os erros de login que o MCP SDK gera antes de mostrá-los ou registrá-los em log. Esse erro então aparece como um nome curto que pode mudar entre versões, como `io`, seguido de `from the MCP SDK for` e a URL do servidor ocultada. Outros erros do MCP SDK assumem o mesmo formato ali. A mensagem ocultada só pode ser este erro quando o endpoint de token do servidor é `http://` simples em um endereço diferente de `localhost`, `127.0.0.1` ou `::1`.

**O que fazer:**

* Sirva esse endpoint de token por HTTPS, por exemplo, colocando o servidor atrás de um proxy reverso ou túnel que termine o TLS e configurando o servidor para anunciar o endereço `https://`
* Para se conectar sem alterar o servidor, inicie o Claude Code com [`MCP_SDK_GENERATION=v1`](https://code.claude.com/docs/pt/env-vars), cujo [runtime](https://code.claude.com/docs/pt/mcp.md#mcp-client-runtimes) não aplica esta regra e envia a requisição de token por HTTP simples. Essa escolha dura até você sair e se aplica a todos os servidores. O runtime v1 também ignora a [verificação do emissor](#issuer-mismatch-in-authorization-response), então prefira servir o endpoint por HTTPS

### AWS credentials expired or invalid

Seu token de sessão da AWS expirou ou foi rejeitado. Esta mensagem aparece em um 401 da [Claude Platform na AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md) ou do [endpoint Mantle](https://code.claude.com/docs/pt/amazon-bedrock.md#use-the-mantle-endpoint), que é como esses provedores relatam um token de segurança expirado.

A dica de ação no meio varia conforme sua configuração. A parte estável é o início `AWS credentials expired or invalid`:

```text theme={null}
AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
```

Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.

**O que fazer:**

* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
* Se [`awsAuthRefresh`](https://code.claude.com/docs/pt/amazon-bedrock#advanced-credential-configuration) estiver definido, execute em outro terminal o comando indicado na mensagem, como `aws sso login --profile myprofile`, e conclua o login no navegador, depois tente novamente. Caso contrário, atualize você mesmo a credencial da AWS que usa: seu login SSO, chaves de acesso, chave de API ou token de proxy
* Com `awsAuthRefresh` definido em uma sessão interativa, você pode, em vez disso, executar `/login`, escolher **3rd-party platform** e então selecionar **Claude Platform on AWS · refresh credentials** em **Using 3rd-party platforms** para executar o mesmo comando sem reiniciar o Claude Code. Consulte [Configurar credenciais da AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md#1-configure-aws-credentials)
* Se o erro se repetir depois que o comando de atualização for bem-sucedido, confirme que a identidade é válida fora do Claude Code com `aws sts get-caller-identity` no mesmo shell e perfil

### AWS authentication failed

Seu provedor AWS retornou um 403, ou o [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) retornou um 401.

O Amazon Bedrock relata um token de segurança expirado como 403, mas um 403 também é como ele relata uma negação de autorização, como uma `AccessDeniedException` causada pela falta de uma permissão do IAM. O Claude Code não consegue distinguir essas duas causas.

Um 401 do Amazon Bedrock também cai aqui em vez de em [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), porque o Amazon Bedrock não relata um token expirado como 401. Um 401 desse endpoint normalmente vem de algo mais no caminho da requisição, como um proxy corporativo.

Uma atualização de credencial corrige um token expirado, mas não consegue corrigir as outras causas, então a mensagem oferece ambas:

```text theme={null}
AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
```

A dica de ação no meio varia conforme sua configuração. A parte estável é o início `AWS authentication failed`.

Quando o 403 é a resposta do Amazon Bedrock de que você não tem acesso ao modelo com o ID de modelo especificado, a dica, em vez disso, diz para você habilitar o modelo para sua conta e região no console do Amazon Bedrock.

Antes da v2.1.273, esta mensagem aparecia apenas quando `awsAuthRefresh` estava configurado.

**O que fazer:**

* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
* Atualize suas credenciais da AWS caso uma credencial expirada seja a causa: execute o comando [`awsAuthRefresh`](https://code.claude.com/docs/pt/amazon-bedrock#advanced-credential-configuration) indicado na mensagem, quando houver um definido, ou atualize você mesmo seu login SSO, chaves de acesso, chave de API ou token de proxy
* Se suas credenciais estiverem atualizadas, confirme que as permissões do IAM em [Configuração do IAM](https://code.claude.com/docs/pt/amazon-bedrock.md#iam-configuration) estão anexadas à identidade que você está usando e que o modelo selecionado está habilitado para sua conta e região
* Execute `aws sts get-caller-identity` para confirmar qual identidade suas requisições usam

### Google Cloud credentials expired or invalid

Suas credenciais do Google Cloud para o [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md) expiraram ou foram rejeitadas: a requisição retornou um 401, que é como o Agent Platform relata a expiração de credenciais.

A dica de ação no meio varia conforme sua configuração. A parte estável é o início `Google Cloud credentials expired or invalid`:

```text theme={null}
Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...
```

**O que fazer:**

* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com seu administrador
* Se você definiu `CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD`, siga em vez disso as etapas para [Claude Models on Google Cloud (gerenciado pela Anthropic)](https://code.claude.com/docs/pt/claude-models-on-google-cloud-anthropic-managed.md#google-cloud-credentials-expired-or-invalid)
* Se você se autentica com application default credentials, execute o comando [`gcpAuthRefresh`](https://code.claude.com/docs/pt/google-vertex-ai#advanced-credential-configuration) indicado na mensagem, ou `gcloud auth application-default login`, e conclua o login, depois tente novamente
* Se você faz o roteamento por um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) com `CLAUDE_CODE_SKIP_VERTEX_AUTH` definida, atualize o token do gateway em `ANTHROPIC_AUTH_TOKEN` ou `ANTHROPIC_CUSTOM_HEADERS` e então tente novamente
* Se você se autentica com um arquivo de chave de conta de serviço, confirme que `GOOGLE_APPLICATION_CREDENTIALS` aponta para uma chave válida. Consulte [Configurar credenciais do GCP](https://code.claude.com/docs/pt/google-vertex-ai.md#3-configure-gcp-credentials)
* Se o erro se repetir após uma atualização, confirme que a identidade funciona fora do Claude Code com `gcloud auth application-default print-access-token` no mesmo shell

Antes da v2.1.273, um 401 do Agent Platform mostrava a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar as credenciais do Google Cloud.

### Google Cloud authentication failed

A [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md) retornou um 403, que ela usa para negações de autorização em vez de credenciais expiradas. Geralmente, a identidade com a qual você se autentica não tem uma permissão de IAM, ou o modelo não está habilitado para o seu projeto.

A dica de ação no meio varia de acordo com a sua configuração. A parte estável é o `Google Cloud authentication failed` inicial:

```text theme={null}
Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...
```

**O que fazer:**

* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com o seu administrador
* Se você definiu `CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD`, siga em vez disso as etapas para [Claude Models on Google Cloud (gerenciado pela Anthropic)](https://code.claude.com/docs/pt/claude-models-on-google-cloud-anthropic-managed.md#google-cloud-authentication-failed)
* Confirme se as funções em [Configuração de IAM](https://code.claude.com/docs/pt/google-vertex-ai.md#iam-configuration) foram concedidas à identidade com a qual você se autentica
* Confirme se o modelo está habilitado para o seu projeto. Consulte [Solicitar acesso ao modelo](https://code.claude.com/docs/pt/google-vertex-ai.md#2-request-model-access)

Antes da v2.1.273, um 403 da Agent Platform exibia a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar as credenciais do Google Cloud.

### Microsoft Foundry authentication failed

O [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md) retornou um 401 ou 403: a credencial do Azure na requisição foi rejeitada, ou a identidade por trás dela não tem acesso ao recurso do Foundry. O `/login` não consegue gerar credenciais do Azure. A dica de ação no meio varia de acordo com a sua configuração. A parte estável é o `Microsoft Foundry authentication failed` inicial:

```text theme={null}
Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...
```

**O que fazer:**

* Se a dica disser que as credenciais são gerenciadas por este ambiente, o aplicativo que iniciou o Claude Code é dono da credencial e as outras etapas aqui não se aplicam: tente novamente ou entre em contato com o seu administrador
* Atualize a credencial que você configurou em [Configurar credenciais do Azure](https://code.claude.com/docs/pt/microsoft-foundry.md#2-configure-azure-credentials): faça a rotação de `ANTHROPIC_FOUNDRY_API_KEY`, gere um novo `ANTHROPIC_FOUNDRY_AUTH_TOKEN` ou execute `az login` para que a cadeia de credenciais padrão do Microsoft Entra possa fazer login novamente
* Se a credencial estiver atualizada, confirme se a identidade tem acesso ao recurso do Foundry. Consulte [Configuração do Azure RBAC](https://code.claude.com/docs/pt/microsoft-foundry.md#azure-rbac-configuration)

Antes da v2.1.273, um 401 ou 403 do Microsoft Foundry exibia a mensagem genérica `Please run /login` ou `Failed to authenticate`, que não consegue atualizar as credenciais do Azure.

### Could not load AWS or Google Cloud credentials

O Claude Code não conseguiu obter credenciais utilizáveis da cadeia de provedores de credenciais da AWS ou das suas credenciais padrão de aplicativo do Google na máquina em que é executado, então nenhuma requisição chegou ao seu provedor de nuvem. O detalhe após o `·` indica a causa específica, como uma sessão de SSO expirada, credenciais padrão de aplicativo ausentes relatadas como `Could not load the default credentials` ou um login revogado relatado como `invalid_grant`:

```text theme={null}
API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
```

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) com `-p` e no [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), o código de erro estruturado é `cloud_credential_error`. Antes da v2.1.267, a mensagem exibia apenas o texto de detalhe após `API Error:`, e o código estruturado era `server_error` ou `unknown`.

**O que fazer:**

* Execute o comando de login do seu provedor, como `aws sso login --profile myprofile` ou `gcloud auth application-default login`, e depois tente novamente. [Credenciais do Bedrock, Agent Platform ou Foundry não carregando](https://code.claude.com/docs/pt/troubleshoot-install.md#bedrock-agent-platform-or-foundry-credentials-not-loading) mostra como confirmar as credenciais fora do Claude Code
* Se o detalhe indicar `AWS default-chain credential resolve timed out`, a cadeia travou em vez de falhar, então siga [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out)

### AWS default-chain credential resolve timed out

A cadeia de provedores de credenciais padrão da AWS não produziu credenciais em 60 segundos, então o Claude Code interrompeu a resolução e falhou a requisição. Esse timeout é uma das causas de [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). A falha é na resolução local de credenciais: a requisição nunca chegou ao [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), à [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md) ou ao [endpoint Mantle](https://code.claude.com/docs/pt/amazon-bedrock.md#use-the-mantle-endpoint). O Claude Code limpa seu [cache de credenciais](https://code.claude.com/docs/pt/amazon-bedrock.md#credential-caching-and-resolution-timeout) e tenta novamente antes que esse erro apareça, então, quando você o vê, a cadeia já travou em tentativas repetidas.

```text theme={null}
API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
```

As causas comuns são um comando `credential_process` no seu perfil da AWS que aguarda uma entrada que não pode receber, e um contêiner ou VM cujo serviço de metadados da instância (IMDS) nunca responde à sondagem da cadeia.

Antes da v2.1.267, a mensagem era `API Error: AWS default-chain credential resolve timed out`.
Antes da v2.1.207, uma cadeia travada deixava a requisição aguardando indefinidamente em vez de falhar.

**O que fazer:**

* Execute `aws sts get-caller-identity` no mesmo shell com o mesmo `AWS_PROFILE`. Se ele também travar, corrija o perfil; um comando `credential_process` que solicita entrada interativamente é uma causa comum.
* Conclua a etapa de login antes de iniciar o Claude Code, por exemplo `aws sso login --profile myprofile`
* Se a sua cadeia executa um login interativo que legitimamente precisa de mais de 60 segundos, como SSO com MFA por meio de um wrapper como `aws-vault`, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars)

### Bedrock setup verification timed out waiting for AWS

Uma chamada à AWS durante a verificação de credenciais do [assistente de configuração do Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#sign-in-with-bedrock), como a busca de credenciais ou a verificação de identidade, não terminou dentro do limite de 60 segundos. O assistente para de aguardar e falha a etapa de verificação:

```text theme={null}
Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.
```

O número reflete o seu limite: 60 segundos por padrão, ou o valor que você definiu em [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars).

As causas comuns são uma rede ou proxy que trava as requisições à AWS, incluindo a atualização do token de SSO, e um auxiliar de credenciais ainda aguardando uma entrada que você não consegue ver. Aumente o limite apenas quando o auxiliar legitimamente precisar de mais tempo.

Uma única requisição travada à AWS também pode falhar por seu próprio timeout por requisição, que exibe uma mensagem mais curta na mesma etapa:

```text theme={null}
A request to AWS timed out. Check your network and proxy settings, then try again.
```

Quando os mesmos timeouts ocorrem na etapa de fixação do modelo, o assistente marca um modelo como `unreachable` em vez de exibir qualquer uma das mensagens.

**O que fazer:**

* Execute `aws sts get-caller-identity` no mesmo shell. Se ele também travar, o travamento está fora do Claude Code, na sua rede, no seu proxy ou no auxiliar de credenciais do seu perfil da AWS; corrija isso primeiro.
* Conclua qualquer login interativo antes de abrir o assistente, por exemplo `aws sso login --profile myprofile`
* Se um auxiliar de credenciais no seu perfil da AWS legitimamente precisar de mais de 60 segundos para solicitar sua entrada, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars)

### Cloud gateway session expired

Você fez login por meio de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway), e a sessão do gateway salva nesta máquina expirou e não pôde ser renovada, ou o gateway não a aceita mais, por exemplo, depois que o [segredo JWT do gateway é substituído](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md#jwt-secret-rotation). Se você vir esta linha ao iniciar o `claude` interativamente, a sessão foi aberta sem login no gateway:

```text theme={null}
Cloud gateway session expired — run /login to reconnect.
```

A mesma linha pode aparecer no meio da sessão quando a credencial do gateway expira e o Claude Code não consegue renová-la.

Em uma execução [não interativa](https://code.claude.com/docs/pt/headless.md), em uma sessão em segundo plano ou outra sessão não supervisionada, ou em um subcomando do `claude` diferente de `claude auth`, o Claude Code encerra com esta mensagem quando o gateway não aceita mais a sessão:

```text theme={null}
Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
```

**O que fazer:**

* Execute `/login` na sessão e conclua o login no navegador
* Para uma inicialização não interativa, inicie o `claude` no mesmo ambiente, execute `/login` e depois execute seu comando novamente

### Sign-in timed out while waiting for you to continue

Durante um login em um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway), o gateway informou a conta que fez login, e o Claude Code pediu que você a confirmasse antes de salvar a credencial. Você deixou a confirmação aberta além da expiração do próprio login, e o gateway não emitiu nenhum refresh token que pudesse renová-lo, então o Claude Code não armazenou nada quando você continuou:

```text theme={null}
Sign-in timed out while waiting for you to continue. Try again.
```

**O que fazer:**

* Execute `/login` novamente e confirme a conta antes que o login expire

### Gateway refused the request

Você fez login por meio de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway), e uma requisição retornou um 403: o gateway, ou o upstream por trás dele, a recusou. Fazer login novamente não altera uma recusa, então a mensagem direciona você ao administrador do seu gateway:

```text theme={null}
Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
```

**O que fazer:**

* Peça ao administrador do seu gateway que investigue a requisição. O final `API Error:` traz a recusa que o gateway retornou
* Para administradores: uma [regra de controle de acesso](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#http-tuning) no gateway retorna um 403 que o [log de auditoria](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md#logs) registra com o motivo, e a negação de autorização de um upstream é repassada conforme [Mensagens de erro do upstream](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#upstream-error-messages)

Antes da v2.1.273, um 403 em uma sessão de gateway exibia a mensagem genérica `Please run /login` ou `Failed to authenticate`, e fazer login novamente não eliminava a recusa.

## Erros de rede e conexão

A maioria desses erros significa que uma requisição de rede do Claude Code falhou ao alcançar seu destino, ou algo entre Claude Code e a API alterou a resposta no caminho de volta; quando uma entrada também tem uma causa local, como uma falha na escrita de arquivo, seu corpo diz isso. Geralmente originam-se em sua rede local, proxy ou firewall, ou na política de rede do ambiente de nuvem.

### Unable to connect to API

A conexão TCP com a API falhou ou nunca foi concluída. Para os códigos de erro de conexão comuns, a mensagem indica o tipo de falha e mantém o código entre parênteses:

```text theme={null}
Unable to connect to API. Check your internet connection
Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server — check your internet or DNS (ENOTFOUND)
No internet route — check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
Request timed out. Check your internet connection and proxy settings
```

Um código que Claude Code não reconhece aparece como `Unable to connect to API` seguido pelo código entre parênteses. Algumas dessas mensagens podem mostrar mais de um código: `Connection refused` pode mostrar `ConnectionRefused` ou `ECONNREFUSED`, por exemplo, e `Can't reach the API server` pode mostrar `ENOTFOUND` ou `FailedToOpenSocket`.

Antes da v2.1.227, cada uma dessas mensagens codificadas lia `Unable to connect to API` seguida pelo código, por exemplo `Unable to connect to API (ECONNREFUSED)`.

As causas comuns incluem sem acesso à internet, uma VPN que bloqueia `api.anthropic.com`, ou um proxy corporativo necessário que não está configurado.

**O que fazer:**

* Confirme que você pode alcançar o host da API a partir do mesmo shell executando `curl -I https://api.anthropic.com`. No Windows PowerShell use `curl.exe -I https://api.anthropic.com` para que o alias `Invoke-WebRequest` integrado não seja usado.
* Se você estiver atrás de um proxy corporativo, defina `HTTPS_PROXY` antes de iniciar Claude Code e veja [Network configuration](https://code.claude.com/docs/pt/network-config.md)
* Se você rotear através de um gateway de LLM ou relay, defina [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars) para seu endereço. Veja [Connect Claude Code to an LLM gateway](https://code.claude.com/docs/pt/llm-gateway-connect.md) para configuração.
* Se `ANTHROPIC_BASE_URL` já aponta para seu gateway e toda requisição termina em `Connection dropped`, verifique se seu gateway e o upstream dele aceitam os campos de [tool search](https://code.claude.com/docs/pt/mcp.md#tool-search-through-a-gateway). Por padrão, Claude Code envia campos de ferramenta `defer_loading` e blocos `tool_reference`, com o header `anthropic-beta` que os habilita. 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`.
* Certifique-se de que seu firewall permite os hosts listados em [Network access requirements](https://code.claude.com/docs/pt/network-config.md#network-access-requirements)
* Falhas intermitentes são [tentadas novamente de forma automática](#automatic-retries)

Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:

* Verifique se `ANTHROPIC_BASE_URL` está definido executando `echo $ANTHROPIC_BASE_URL`, ou `echo $env:ANTHROPIC_BASE_URL` no PowerShell, e procure por ele no bloco `env` de seus [arquivos de configurações](https://code.claude.com/docs/pt/settings.md). Quando está definido, Claude Code envia requisições de modelo para esse endereço em vez de `api.anthropic.com`, então um valor remanescente apontando para um proxy local ou gateway que não está mais em execução produz `Connection refused` mesmo que `curl` alcance a API. Remova-o do seu perfil de shell ou configurações e inicie Claude Code a partir de um novo terminal.
* No Linux e WSL, verifique `/etc/resolv.conf` para um nameserver inacessível. WSL em particular pode herdar um resolver quebrado do host.
* No macOS, um cliente VPN que foi desconectado ou desinstalado pode deixar uma interface de túnel ou regra de roteamento para trás. Verifique `ifconfig` para interfaces `utun` obsoletas e remova a extensão de rede da VPN em Configurações do Sistema.
* Docker Desktop e runtimes de contêiner similares podem interceptar tráfego de saída. Saia deles e tente novamente para descartar isso.

### Unable to connect to Anthropic services

Durante a configuração de primeira execução, Claude Code verifica se consegue alcançar `api.anthropic.com` e `platform.claude.com` antes de mostrar a etapa de login. Quando qualquer uma das verificações falha, Claude Code imprime o motivo e sai.

```text theme={null}
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.
```

Claude Code envia a verificação através da mesma [configuração de proxy](https://code.claude.com/docs/pt/network-config.md) que as requisições de API e dá a cada sonda 10 segundos. Quando a sonda com falha passou por um proxy, a mensagem nomeia a variável de ambiente que a configurou, como `HTTPS_PROXY`. Antes da v2.1.222, a verificação usava um transporte de proxy diferente sem timeout: atrás de uma URL de proxy com o esquema `https://`, ela poderia travar em `Checking connectivity...` indefinidamente e depois falhar mesmo que as requisições de API através do mesmo proxy funcionem.

Claude Code pula essa verificação quando um [arquivo de configurações gerenciadas, política MDM ou policy helper](https://code.claude.com/docs/pt/managed-settings.md) define [`forceLoginMethod`](https://code.claude.com/docs/pt/settings-reference#forceloginmethod) como `"gateway"`, ou define [`forceLoginGatewayUrl`](https://code.claude.com/docs/pt/settings-reference#forcelogingatewayurl) sem `forceLoginMethod`. Com qualquer uma das configurações, Claude Code abre a etapa de login na tela **Cloud gateway** em vez de um método de login Anthropic. Claude Code também pula a verificação quando uma fonte de configurações gerenciadas na máquina existe mas não pode ser lida, já que essa fonte pode conter a configuração do gateway. Antes da v2.1.247, Claude Code executava a verificação sob essa configuração também, e saía com esse erro quando os endpoints da Anthropic eram inacessíveis.

Claude Code também pula a verificação em uma máquina sem configurações gerenciadas quando seu próprio `~/.claude/settings.json` [nomeia um gateway](https://code.claude.com/docs/pt/claude-apps-gateway#set-the-gateway-url-in-user-settings) com `forceLoginMethod` e `forceLoginGatewayUrl`. Antes da v2.1.295, Claude Code executava a verificação nesse caso.

**O que fazer:**

* Se a mensagem nomear uma variável de proxy, verifique se seu valor aponta para o proxy correto e peça ao seu time de rede para permitir conexões HTTPS através dele para o host na mensagem. Veja [Network configuration](https://code.claude.com/docs/pt/network-config.md).
* Trabalhe através das verificações em [Unable to connect to API](#unable-to-connect-to-api). O teste `curl` e a orientação de firewall lá se aplicam a essa verificação também.
* Se sua rede está aberta e a falha persiste, Claude Code pode não estar [disponível em seu país](https://www.anthropic.com/supported-countries)

### Socket is closed

`Socket is closed` significa que a conexão que carregava uma resposta de streaming foi fechada enquanto a resposta ainda estava chegando. A causa mais comum é um proxy corporativo no Windows descartando um túnel estabelecido no meio da resposta.

Dependendo de quão longe a resposta havia progredido, Claude Code tenta novamente a requisição, mantém o que Claude produziu, ou encerra o turno. Veja [Automatic retries](#automatic-retries).

Antes da v2.1.214, Claude Code não tentava novamente essa falha, e o turno parava com um erro contendo `Socket is closed`.

**O que fazer:**

* Se você vir esse erro, atualize para v2.1.214 ou posterior com `claude update`, depois envie sua mensagem novamente
* Se os turnos continuarem falhando atrás do mesmo proxy após atualizar, trabalhe através de [Unable to connect to API](#unable-to-connect-to-api) e verifique a configuração do proxy em [Network configuration](https://code.claude.com/docs/pt/network-config.md)

### API returned an empty or malformed response

Claude Code mostra esse erro quando sua nova tentativa sem streaming de uma requisição de streaming com falha obtém um status de sucesso HTTP mas o corpo não é uma mensagem de API Claude: comumente uma página de erro HTML ou login, um corpo vazio, ou JSON em outro formato. Um proxy, gateway, ou página de login de rede respondendo no lugar da API é a fonte usual. Claude Code não tenta novamente a requisição, e o turno termina com esse erro.

```text theme={null}
API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.
```

Após essa abertura, a mensagem relata o que voltou e qual requisição falhou:

* Uma cláusula `Response:` com o tipo de conteúdo, o tipo de corpo, como `body is an HTML page` ou `empty body`, seu tamanho em bytes, e se a resposta carregava um id de requisição Anthropic. Quando a resposta nomeia um servidor reconhecível, como `nginx` ou `cloudflare`, ou carrega headers intermediários, como `cf-ray` ou `via`, a cláusula lista esses também.
* Uma sentença nomeando o id da requisição de streaming com falha e a falha que acionou a nova tentativa. Quando um stream havia aberto antes da falha, também relata quantos eventos de stream chegaram e, se algum chegou, quanto tempo o stream havia ficado silencioso quando a tentativa falhou.

Antes da v2.1.234, a mensagem terminava após `intercepting the request`.

Antes da v2.1.271, uma resposta que carregava uma mensagem de API válida sob um tipo de conteúdo não-JSON como `text/plain` também terminava o turno com esse erro. Alguns gateways de LLM usam esse tipo de conteúdo para a resposta sem streaming.

**O que fazer:**

* Leia a cláusula `Response:` para ver qual sistema respondeu. Um corpo HTML, nenhum id de requisição Anthropic, ou um servidor nomeado como `nginx` ou `cloudflare` significa que algo entre Claude Code e a API respondeu em seu lugar
* Se você rotear através de um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway-connect.md#troubleshoot-gateway-errors), teste a rota com uma requisição direta e corrija o hop que retorna a resposta não-API
* Em uma rede com uma página de login, como Wi-Fi de convidado, complete o login em um navegador, depois tente novamente
* Se apenas a rota sem streaming através de seu gateway está quebrada, defina [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1`](https://code.claude.com/docs/pt/env-vars#variables) para desativar esse fallback, exceto quando o endpoint de streaming em si retorna `404`, onde Claude Code ainda recorre ao fallback

### Streaming response ended before any complete data was received

Uma resposta de streaming de seu provedor de modelo foi concluída sem entregar nenhum dado utilizável, então Claude Code reenviou a requisição sem streaming para terminar o turno. Claude Code mostra o aviso uma vez por sessão, apenas em sessões interativas. Antes da v2.1.239, Claude Code tentava novamente de forma silenciosa sem streaming.

```text theme={null}
Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.
```

Claude Code envia cada requisição afetada duas vezes: a tentativa de streaming vazia e a nova tentativa. A causa usual é um proxy ou gateway que consome ou transforma o corpo da resposta de streaming no caminho de volta.

**O que fazer:**

* Configure qualquer proxy ou gateway entre Claude Code e seu provedor de modelo para passar corpos de resposta de streaming e seus headers através sem modificação
* Em [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), veja [Streaming errors behind a gateway or proxy](https://code.claude.com/docs/pt/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy) para os requisitos de header e corpo

### Bedrock streaming response has an unexpected content-type

Um gateway ou proxy entre Claude Code e [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) está transformando o corpo da resposta de streaming ou seu header `Content-Type`. Amazon Bedrock transmite respostas como `application/vnd.amazon.eventstream`. Em vez de decodificar um corpo que não consegue ler, Claude Code rejeita uma resposta de streaming bem-sucedida que relata um content-type diferente. Claude Code não tenta novamente a requisição.

```text theme={null}
Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
```

Antes da v2.1.208, a mesma configuração incorreta aparecia como `API Error: Truncated event message received` após toda a resposta ter sido armazenada em buffer.

**O que fazer:**

* Configure o gateway para passar o corpo da resposta `InvokeModelWithResponseStream` e seu header `Content-Type` através sem modificação. Um intermediário que re-emite o stream como server-sent events é uma causa comum.
* Definir [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](https://code.claude.com/docs/pt/env-vars) oculta esse erro, mas Claude Code não decodifica um corpo binário sob um header reescrito, então essas requisições recorrem a um caminho sem streaming mais lento como fallback. Veja [Streaming errors behind a gateway or proxy](https://code.claude.com/docs/pt/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy).

### SSL certificate errors

Um proxy ou appliance de segurança em sua rede está interceptando tráfego TLS com seu próprio certificado, e Claude Code não confia nele.

```text theme={null}
Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
```

Antes da v2.1.273, ambas as mensagens terminavam em `Check your proxy or corporate SSL certificates`, sem o código OpenSSL ou a dica `NODE_EXTRA_CA_CERTS`.

A partir da v2.1.199, uma falha de validação de certificado não é tentada novamente, então esse erro aparece na primeira tentativa em vez de após o [retry budget](#automatic-retries) completo. Versões anteriores gastavam alguns minutos tentando novamente antes de mostrá-lo. Condições TLS transitórias, como um timeout de handshake, ainda são tentadas novamente.

Durante `/login` e a verificação de conectividade de inicialização, a mesma falha produz uma mensagem diferente:

```text theme={null}
SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.
```

Em [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), as requisições que Claude Code em si envia para AWS, como as chamadas de credencial de função STS e SSO, descoberta de modelo, e as verificações do assistente de configuração, dependem da mesma configuração de certificado. Veja [Certificate errors behind a TLS-inspecting proxy](https://code.claude.com/docs/pt/amazon-bedrock.md#certificate-errors-behind-a-tls-inspecting-proxy).

**O que fazer:**

* Exporte o bundle de CA de sua organização e aponte Claude Code para ele com `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
* Veja [Network configuration](https://code.claude.com/docs/pt/network-config.md#custom-ca-certificates) para instruções de configuração completa
* Não defina `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desabilita a validação de certificado inteiramente

### Host not allowed in a cloud session

Em uma sessão na nuvem ou tarefa agendada na nuvem, um `403` ou um erro de DNS como `ENOTFOUND` pode significar que o host requisitado não está na [allowlist do ambiente de nuvem](https://code.claude.com/docs/pt/cloud-environments.md#access-levels). Para confirmar, compare o host com essa lista. Um `403` com este header confirma o bloqueio, mas nem todo `403` de uma requisição bloqueada o contém:

```text theme={null}
HTTP 403
x-deny-reason: host_not_allowed
```

Você também pode ver um certificado TLS que não corresponde ao certificado real do destino. Sessões na nuvem roteiam tráfego de saída através de um proxy que aplica a política de rede, então um certificado incompatível significa que o proxy terminou a conexão, não o destino.

Isso não é um problema de rede do lado do cliente. Sessões na nuvem e [tarefas agendadas na nuvem](https://code.claude.com/docs/pt/routines.md) executam dentro de uma VM em sandbox cujo tráfego de saída através da rede da sessão é filtrado para a allowlist do [ambiente de nuvem](https://code.claude.com/docs/pt/cloud-environments.md):

* **Tráfego do GitHub e de conectores**: [operações GitHub](https://code.claude.com/docs/pt/cloud-environments.md#github-proxy) e tráfego do conector MCP usam canais separados, é por isso que podem continuar funcionando enquanto outros hosts são bloqueados
* **Ambiente padrão**: o ambiente **Default** usa acesso **Limited** com **Allow package managers** marcado. Suas sessões alcançam a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) de registros de pacotes, APIs de provedores de nuvem, registros de contêiner e domínios de desenvolvimento comuns.

**O que fazer:**

Essas etapas alteram um de seus próprios ambientes. Um [ambiente compartilhado pela organização](https://code.claude.com/docs/pt/cloud-environments.md#organization-shared-environments) abre como somente leitura no seletor, então peça a um Owner para alterar seu acesso de rede na página **Cloud environments** em [admin settings](https://claude.ai/admin-settings).

* Abra seu ambiente para edição, ou a partir do [formulário da tarefa agendada na nuvem](https://code.claude.com/docs/pt/routines.md#environments-and-network-access) ou a partir do [seletor de ambiente](https://code.claude.com/docs/pt/cloud-environments.md#configure-your-environment) onde você inicia sessões na nuvem.
* No diálogo **Edit cloud environment**, selecione **Limited** em **Network access**, depois adicione o domínio bloqueado a **Allowed domains**. Digite um domínio por linha. Marque **Allow package managers** para permitir a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) junto com seus próprios domínios. Selecione **Full** em vez disso se você quiser acesso irrestrito.
* Clique em **Save changes**. A próxima execução usa a allowlist atualizada. Para uma sessão na nuvem que já está aberta, veja [quando uma mudança de acesso de rede alcança sessões existentes](https://code.claude.com/docs/pt/cloud-environments.md#network-access).

Veja [Network access](https://code.claude.com/docs/pt/cloud-environments.md#network-access) para níveis de acesso e a allowlist padrão. Sessões locais da CLI não são afetadas por essa política.

### The proxy refused the connection

Você vê essa mensagem quando Claude lê um [artefato](https://code.claude.com/docs/pt/artifacts.md) através do proxy que você definiu em `HTTPS_PROXY` ou uma [variável de proxy](https://code.claude.com/docs/pt/network-config.md#environment-variables) relacionada. O conteúdo do artefato vem de `*.frame.claudeusercontent.com`, então Claude Code primeiro envia ao proxy uma requisição `CONNECT` pedindo para abrir um túnel para esse host. Quando o proxy recusa, nada alcança o host, e a mensagem carrega o status HTTP do proxy:

```text theme={null}
artifact content fetch failed (proxy refused the connection: HTTP 407)
artifact content fetch failed (proxy refused the connection: HTTP 403)
the proxy refused the connection to the artifact's content host (HTTP 502)
```

O status é a resposta do proxy para o `CONNECT`. O host nunca respondeu, então cada status aponta para uma correção diferente:

* `HTTP 407`: o proxy requer credenciais que não recebeu. Coloque-as na URL do proxy, como [Basic authentication](https://code.claude.com/docs/pt/network-config.md#basic-authentication) mostra.
* `HTTP 403`: o proxy recusa fazer túnel para `*.frame.claudeusercontent.com`. Peça a quem executa o proxy para permitir esse host, que [Network access requirements](https://code.claude.com/docs/pt/network-config.md#network-access-requirements) lista.
* Qualquer outro status, como `HTTP 502`: o proxy não abriu o túnel por seu próprio motivo, como falhar ao alcançar o host. Procure o status nos logs do proxy.
* `unreadable reply` no lugar de um status: o que está no endereço do proxy não respondeu com uma linha de status HTTP. Verifique se o endereço é um proxy HTTP.

**O que fazer:**

* Verifique o endereço e credenciais na variável de proxy, como [Proxy configuration](https://code.claude.com/docs/pt/network-config.md#proxy-configuration) descreve, depois execute `curl -x http://proxy.example.com:8080 -I https://api.anthropic.com` a partir do shell em que você inicia Claude Code, usando sua própria URL de proxy. No Windows PowerShell, execute `curl.exe`. Se essa sonda falhar da mesma forma, corrija a configuração do proxy primeiro. Se funcionar, a recusa é específica para o host do artefato.
* Se sua rede deixa Claude Code alcançar o host do artefato diretamente, adicione `.frame.claudeusercontent.com` a [`NO_PROXY`](https://code.claude.com/docs/pt/network-config#environment-variables). Mantenha a entrada estreita: uma entrada `.claudeusercontent.com` mais ampla também contorna o proxy para `bridge.claudeusercontent.com`, que organizações com [IP allowlisting](https://code.claude.com/docs/pt/network-config.md#organization-ip-allowlists-and-proxy-egress) precisam manter no proxy.

Antes da v2.1.238, Claude Code relatava um túnel recusado como um erro de rede genérico.

### The cloud environments service returned an empty or unexpected response

Claude Code solicita sua lista de [ambientes de nuvem](https://code.claude.com/docs/pt/cloud-environments.md) em vários pontos, como quando você cria uma sessão na nuvem a partir da CLI ou executa [`/remote-env`](https://code.claude.com/docs/pt/cloud-environments#select-an-environment-from-the-cli). Quando não consegue ler a resposta do servidor, mostra uma dessas mensagens:

```text theme={null}
The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.
```

O servidor aceitou a requisição mas respondeu com um corpo que não é a lista de ambientes: vazio, não JSON, ou JSON sem a lista. Isso geralmente acompanha uma disrupção do lado do serviço e se resolve por conta própria. Dependendo da superfície que solicitou a lista, Claude Code pode adicionar um prefixo, como `couldn't list environments:` no diálogo `/remote-env`.

**O que fazer:**

* Tente novamente a ação. Claude Code solicita a lista novamente cada vez
* Se a mensagem continuar aparecendo, verifique [status.claude.com](https://status.claude.com) para incidentes ativos

Antes da v2.1.236, Claude Code mostrava um TypeError JavaScript bruto em vez dessas mensagens.

### Failed to fetch session from Sessions API

Essa mensagem significa que Claude Code encontrou a [sessão na nuvem que você pediu para trazer ao seu terminal](https://code.claude.com/docs/pt/claude-code-on-the-web.md#from-cloud-to-terminal), mas não conseguiu ler seu histórico de conversa dos servidores da Anthropic, então não a abriu:

```text theme={null}
Failed to fetch session from Sessions API: Failed to fetch session logs
```

Você a vê após `claude --teleport`, `/teleport`, ou ao escolher a sessão na lista [`/tasks`](https://code.claude.com/docs/pt/commands). `claude --teleport <session-id>` a imprime e sai com código 1.

**O que fazer:**

* Execute o mesmo teleport novamente. Se falhar da mesma forma, [relate o problema](#report-an-error)

Antes da v2.1.296, Claude Code não tentava novamente uma leitura com falha e, após uma, podia abrir a sessão com uma conversa vazia e relatar sucesso em vez de imprimir essa mensagem.

### Couldn't load the history of cloud session

Essa mensagem significa que Claude Code encontrou a [sessão na nuvem que você pediu para trazer ao seu terminal](https://code.claude.com/docs/pt/claude-code-on-the-web.md#from-cloud-to-terminal), mas a requisição do seu histórico de conversa retornou como não encontrada:

```text theme={null}
Couldn't load the history of cloud session session_01HJKLMNOPQRSTUVWXYZ. Check it at https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ?from=cli
```

**O que fazer:**

* Abra o link na mensagem para verificar a sessão no seu navegador. Se ela abrir lá e o mesmo teleport falhar dessa forma novamente, [relate o problema](#report-an-error).

### Couldn't reconnect to your Remote Control session

```text theme={null}
Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
```

Retomar com `claude --resume` ou `claude --continue` reconecta à sessão [Remote Control](https://code.claude.com/docs/pt/remote-control.md) registrada nessa conversa. Essa mensagem significa que a reconexão falhou por um motivo que pode ser temporário, como uma interrupção de rede ou um erro de servidor, então Claude Code não consegue confirmar se a sessão remota ainda existe. Sua sessão local continua executando sem Remote Control.

**O que fazer:**

* Execute `/remote-control` para tentar novamente a conexão
* Inicie uma nova sessão com `claude --remote-control` para criar uma nova sessão Remote Control
* Para outras mensagens de inicialização do Remote Control, veja [Troubleshoot Remote Control](https://code.claude.com/docs/pt/remote-control.md#troubleshooting)

Se o servidor relatar em vez disso que a sessão anterior se foi, você não vê essa mensagem. Claude Code inicia uma nova sessão em seu lugar ou mostra [`Previous session is unavailable — run /remote-control to start a new one`](https://code.claude.com/docs/pt/remote-control#previous-session-is-unavailable).

### Sessions ended while this machine was offline

Claude Code mostra essa mensagem no terminal executando [`claude remote-control`](https://code.claude.com/docs/pt/remote-control#start-a-remote-control-session) depois que sua máquina estava offline tempo suficiente para que o servidor limpasse o ambiente Remote Control que sua máquina estava servindo. As sessões nesse ambiente terminaram, e você não consegue retomá-las. A contagem é o número de sessões que terminaram.

```text theme={null}
2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.
```

**O que fazer:**

* Quando Claude Code lista worktrees mantidos sob essa mensagem, recupere qualquer trabalho não commitado deles
* Execute `claude remote-control` para iniciar um ambiente novo

### Couldn't share the transcript

Depois que você concorda em compartilhar sua transcrição de sessão a partir de um prompt de pesquisa, como a [pesquisa de qualidade de sessão](https://code.claude.com/docs/pt/data-usage.md#session-quality-surveys), Claude Code a carrega para Anthropic, ou salva um arquivo local em vez disso em provedores de terceiros, em sessões [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway), e quando nenhuma credencial Anthropic está disponível. Essa mensagem significa que o compartilhamento não foi concluído.

```text theme={null}
Couldn't share the transcript.
```

O upload deve caber em um limite de 8 MiB. Em uma sessão longa, Claude Code progressivamente descarta partes do compartilhamento. Você vê essa mensagem quando nenhuma versão reduzida pode ser enviada ou um erro de rede ou servidor interrompe o upload. Quando Claude Code salva um arquivo local em vez disso, a mensagem significa que não conseguiu escrever o arquivo.

**O que fazer:**

* Execute `/feedback` para enviar a transcrição com uma descrição do que aconteceu. Veja [Report an error](#report-an-error) se `/feedback` não estiver disponível em seu ambiente
* Se outras requisições também estão falhando, verifique sua conexão de rede e veja [Unable to connect to API](#unable-to-connect-to-api)

### Couldn't send feedback

Uma mensagem que começa com `Couldn't send feedback` significa que o serviço de feedback não confirmou o relatório que você enviou pelo [diálogo `/feedback`, `/bug` ou `/share`](https://code.claude.com/docs/pt/commands#all-commands), ou um [rascunho de feedback](https://code.claude.com/docs/pt/tools-reference.md#sendfeedback-tool-behavior) na fila. Trate-o como não recebido. Quando uma frase sobre sua organização vem após os dois-pontos, sua organização recusa feedback.

O segundo exemplo é uma recusa da organização:

```text wrap theme={null}
Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

Couldn't send feedback: Feedback has not been enabled for your organization. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.
```

**O que fazer:**

* **Não autenticado**: a mensagem continua com `: not signed in. Run /login, then retry.` Execute `/login` e envie novamente
* **Recusa da sua organização**: por exemplo `: Feedback has not been enabled for your organization.` ou `: Feedback collection is not available for organizations with custom data retention policies.` `/feedback` pode então responder que está [desativado pela política da sua organização](#feedback-is-disabled-by-your-organizations-policy) por sete dias. Um rascunho na fila permanece na fila e ainda [expira conforme o previsto](https://code.claude.com/docs/pt/tools-reference.md#discard-or-keep-a-draft)
* **Credenciais recusadas**: a mensagem continua com `: the sign-in this session uses is not allowed to send feedback` ou `: the server did not accept the credentials this session uses`. Execute `/status` no prompt do Claude Code para ver qual login, token ou chave de API esta sessão envia
* **`(request timed out)` ou `(couldn't reach the service)` logo após `Couldn't send feedback`**: envie o relatório ou o rascunho na fila novamente. O diálogo mantém seu texto, e a mensagem de um rascunho na fila diz `The draft is still queued.` Se outras requisições também estiverem falhando, verifique sua conexão de rede e veja [Unable to connect to API](#unable-to-connect-to-api). Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)
* **`(server returned <status>)`, ou nenhum motivo, logo após `Couldn't send feedback`**: o status é o código de resposta do serviço. A própria mensagem do serviço vem depois dele quando foi enviada, como em `(server returned 403: Access Forbidden)`. Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

Issues em github.com/anthropics/claude-code são públicas, então deixe de fora código, transcrições e qualquer outra coisa confidencial ao abrir uma.

Antes da v2.1.281, cada envio falhava com essa mensagem uma vez que um Remote Control **Stop** ou uma mensagem urgente entre sessões havia chegado enquanto o diálogo estava aberto. Nessas versões, feche o diálogo, reabra-o, e envie novamente.

### Feedback payload too large

Essa mensagem na [tela de revisão](https://code.claude.com/docs/pt/tools-reference.md#review-and-edit-a-draft) de um [rascunho de feedback](https://code.claude.com/docs/pt/tools-reference.md#sendfeedback-tool-behavior) significa que Claude Code não tem confirmação de que o serviço aceitou o rascunho. Trate-o como não recebido. O rascunho permanece na sua fila de `/feedback`, então você pode enviá-lo novamente.

```text wrap theme={null}
Feedback payload too large. Try again without the transcript, or shorten the details.
```

**O que fazer:**

* Na tela de revisão, defina **Send transcript** como `no` e envie o rascunho novamente. Encurtar os detalhes remove no máximo 10 KB de texto, que é tudo o que os detalhes de um rascunho podem conter.

### MCP server connection timed out during a sleep or clock change

Essa mensagem significa que uma conexão com um [servidor MCP](https://code.claude.com/docs/pt/mcp.md) atingiu o timeout, e Claude Code descobriu que o relógio do seu sistema avançou durante a tentativa:

```text theme={null}
MCP server "<name>" connection timed out. Your computer went to sleep or its clock changed while connecting.
```

Claude Code não consegue dizer se seu computador entrou em suspensão ou se o relógio foi adiantado, então a mensagem nomeia ambos.

**O que fazer:**

Conecte-se ao servidor novamente e mantenha seu computador ativo até a tentativa terminar. Se o servidor se conectar, não há nada a corrigir.

* **Em uma sessão interativa**: execute `/mcp`, selecione o servidor e selecione **Reconnect**
* **No seu shell**: execute novamente o comando [`claude -p`](https://code.claude.com/docs/pt/headless), [`claude mcp list`](https://code.claude.com/docs/pt/mcp#managing-your-servers) ou `claude mcp get`. Se o servidor então falhar com uma mensagem que começa com `Skipping connection (recent failure cached`, aguarde 15 minutos e execute o comando novamente.
* **Em uma aplicação do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md)**: chame [`reconnectMcpServer()`](https://code.claude.com/docs/pt/agent-sdk/typescript#methods) em TypeScript ou [`ClaudeSDKClient.reconnect_mcp_server()`](https://code.claude.com/docs/pt/agent-sdk/python#methods) em Python
* **Se o servidor falhar novamente**: se a mensagem for diferente desta, veja [o que verificar quando um servidor MCP não se conecta](https://code.claude.com/docs/pt/mcp-quickstart.md#troubleshooting). Se esta mensagem voltar embora seu computador tenha permanecido ativo e nada tenha alterado o relógio, veja [Report an error](#report-an-error).

Antes da v2.1.307, Claude Code mostrava uma mensagem de timeout como `MCP server "<name>" connection timed out after <N>ms` em vez desta.

## Erros de requisição

Esses 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.

### Prompt is too long

A conversa mais os arquivos anexados excedem a janela de contexto do modelo.

```text theme={null}
Prompt is too long
```

Em uma sessão interativa, o Claude Code mostra esse erro como:

```text theme={null}
Context limit reached · /compact or /clear to continue
```

A linha menciona apenas `/clear` quando [`DISABLE_COMPACT`](https://code.claude.com/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`.

Quando você desativou a compactação automática nas suas [configurações de usuário](https://code.claude.com/docs/pt/settings-reference.md#autocompactenabled), a linha também informa isso:

```text theme={null}
Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on
```

A 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`](https://code.claude.com/docs/pt/env-vars) ou [`DISABLE_COMPACT`](https://code.claude.com/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.

O 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.

Um [gateway de apps Claude](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#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.

Quando 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:

```text theme={null}
Prompt is too long · automatic compaction failed: <the underlying error>
```

Resolva 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.

Quando 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:

* 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.
* Nesse caso, quando a conversa não termina com o seu prompt, o Claude Code resume a conversa inteira.

O 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.

Uma 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:

```text theme={null}
Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.
```

Quando a API 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:

```text theme={null}
Prompt 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).
```

Quando a maior parte da requisição está fora da conversa, a mensagem diz:

```text theme={null}
Prompt 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.
```

Antes da v2.1.162, o Claude Code tentava a compactação mesmo assim e exibia apenas `Prompt is too long` quando ela falhava.

**O que fazer:**

* 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
* Execute `/context` para ver um detalhamento do que está consumindo a janela: system prompt, ferramentas, arquivos de memória e mensagens
* Desative os servidores MCP que você não está usando com `/mcp disable <name>` para remover as definições de ferramentas deles do contexto
* Reduza arquivos de memória `CLAUDE.md` grandes, ou mova instruções para [regras com escopo de caminho](https://code.claude.com/docs/pt/memory.md#path-specific-rules) que são carregadas apenas quando relevantes
* 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`](https://code.claude.com/docs/pt/env-vars), ative-a novamente. Se mantê-la desativada, execute `/compact` você mesmo antes que a janela se encha.
* Se o Claude Code avisou que não reconhece o ID do seu modelo, o aviso pode mencionar a janela que ele presumiu. Quando a janela real do modelo for diferente, [informe ao Claude Code a janela real](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id).
  * Se você usa um [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars) personalizado e o erro começa com `Prompt is too long · automatic compaction failed`, [defina a janela de contexto do modelo](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) ou [atualize](https://code.claude.com/docs/pt/setup.md#update-claude-code) para a v2.1.299 ou posterior. Antes da v2.1.299, o Claude Code encerrava o turno com essa mensagem perto da janela presumida de 200K em vez de enviar a requisição.
* 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](https://code.claude.com/docs/pt/setup.md#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.
* Na v2.1.305, com muitas ferramentas MCP e uma conexão direta com a API da Anthropic, esse erro pode ocultar um erro 400 ou 422 não relacionado vindo da API. [Atualize o Claude Code](https://code.claude.com/docs/pt/setup.md#update-claude-code) para a v2.1.306 ou posterior para ver o erro original.

Consulte [Explorar a janela de contexto](https://code.claude.com/docs/pt/context-window.md) para uma visualização interativa de como o contexto se enche.

### Context exceeds the token limit

`/context` mostra este aviso no topo de sua saída quando a conversa cresceu além da janela de contexto do modelo:

```text theme={null}
Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.
```

Após um aviso `Context exceeds`, você não precisa executar nenhum dos comandos enquanto a [compactação automática](https://code.claude.com/docs/pt/settings-reference.md#autocompactenabled) estiver ativada, que é o padrão:

* **Compactação automática ativada**: envie sua próxima mensagem. Se ela ainda falhar com [`Prompt is too long`](#prompt-is-too-long), consulte essa entrada.
* **Compactação automática desativada**: na sessão, execute `/compact` se o aviso o mencionar, ou `/clear` para recomeçar. Até que você execute um deles, as mensagens falham com `Context limit reached`, ou `Prompt is too long` na saída de `-p`.

Quando 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.

```text theme={null}
Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.
```

Ambas as formas mencionam `/clear` em vez de `/compact` quando você definiu [`DISABLE_COMPACT`](https://code.claude.com/docs/pt/env-vars).

**O que fazer:**

* **Após um aviso de janela de compactação**: em uma conversa de vários turnos, execute `/compact` para resumir turnos anteriores e liberar espaço. Para começar do zero, execute `/clear`.
* Para mais formas de reduzir o uso, consulte [Prompt is too long](#prompt-is-too-long)

Antes da v2.1.216, `/context` mostrava uso acima de 100% sem nenhuma linha de aviso explicando o que isso significava ou como se recuperar.

### Request too large

O 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).

```text theme={null}
Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.
```

Quando a 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:

* `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.
* `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](https://code.claude.com/docs/pt/headless.md), a mensagem diz para você reduzir a entrada ou iniciar uma nova sessão.

Antes da v2.1.212, conversas com imagens acumuladas suficientes falhavam 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.

**O que fazer:**

* 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
* Caso contrário, execute `/compact`, que descarta imagens e anexos acumulados
* 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
* Para imagens, consulte [Image was too large](#image-was-too-large) abaixo

### Image was too large

Uma imagem colada ou anexada excede os limites de tamanho ou de dimensão da API.

```text theme={null}
Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size
API Error: an image in the conversation could not be processed and was removed.
An image in the conversation exceeds the dimension limit for many-image requests (3000px). Run /compact to remove old images from context, or start a new session.
```

A linha `could not be processed and was removed` significa que a API recusou uma imagem na conversa, como uma acima dos limites de tamanho ou de dimensão.

Se 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:

* 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.
* 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.
* 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

**O que fazer:**

* 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.
* Faça uma captura de tela mais recortada da região relevante em vez da tela inteira
* Para a mensagem `dimension limit for many-image requests`, execute `/compact` no prompt do Claude Code se a mensagem o mencionar, ou inicie uma nova sessão com menos imagens

A mensagem `dimension limit for many-image requests` mostra o limite de pixels informado no erro da API.

### Unable to resize image

O Claude Code não conseguiu reduzir a escala de uma imagem anexada antes de enviá-la para a API.

```text theme={null}
Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.
```

O 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.

O erro que você vê pode mencionar um limite de pixels diferente, como `2576x2576px` onde estes exemplos dizem `2000x2000px`.

**O que fazer:**

* 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.
* Se a mensagem informar um limite de dimensão ou de tamanho, redimensione ou recomprima a imagem abaixo desse limite antes de anexá-la.
* 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.

### Request rejected as unprocessable by the model

A API recusou a requisição como uma que o modelo não consegue processar. A mensagem é da própria API.

```text theme={null}
API Error: 400 Request rejected as unprocessable by the model (too many or oversized images, or unsupported parameters)
```

O 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.

**O que fazer:**

* 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.

### Erros de PDF

O PDF que você anexou não pôde ser processado. As mensagens são mostradas aqui em sua forma não interativa; em uma sessão interativa, elas pedem que você pressione esc duas vezes e tente novamente.

```text theme={null}
PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
PDF is password protected. Try using a CLI tool to extract or convert the PDF.
The PDF file was not valid. Try converting it to text first (e.g., pdftotext).
```

**O que fazer:**

* Para PDFs 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
* Para PDFs protegidos ou inválidos, remova a senha ou exporte novamente o arquivo a partir do aplicativo de origem e tente outra vez

Quando o Claude lê um intervalo de páginas de um PDF com a ferramenta Read, a leitura pode falhar com uma mensagem diferente:

```text theme={null}
pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.
```

Leituras 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](https://code.claude.com/docs/pt/tools-reference.md#read-tool-behavior) para saber quais PDFs são lidos por intervalo de páginas.

### Extra inputs are not permitted

O 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.

```text theme={null}
API Error: 400 ... context_management: Extra inputs are not permitted
```

O 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](https://code.claude.com/docs/pt/llm-gateway-protocol.md#beta-header-and-body-field-pairs) aborda ambos os casos.

**O que fazer:**

* Se a mensagem contiver `context_management: Extra inputs are not permitted`, [atualize o Claude Code](https://code.claude.com/docs/pt/setup.md#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.
* Se a mensagem nomear `defer_loading` ou `tool_reference`, [atualize o Claude Code](https://code.claude.com/docs/pt/setup.md#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](https://code.claude.com/docs/pt/llm-gateway-protocol.md#retry-without-tool-search) sem os campos de busca de ferramentas.
* Se o seu gateway descartar o cabeçalho, configure-o para encaminhar o cabeçalho `anthropic-beta`. Consulte [repasse de recursos](https://code.claude.com/docs/pt/llm-gateway-protocol.md#feature-pass-through) para saber o que os gateways devem encaminhar.
* Como fallback, defina [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](https://code.claude.com/docs/pt/env-vars) antes de iniciar. [Desativar recursos de pré-lançamento](https://code.claude.com/docs/pt/llm-gateway-protocol.md#disable-pre-release-capabilities) cobre o escopo exato.

Antes 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`](https://code.claude.com/docs/pt/commands) em outra janela do Claude Code. Nessas versões, execute `/clear` nessa sessão ou reinicie-a.

### Tool input schema is invalid

Uma 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.

```text theme={null}
API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'
```

A primeira forma significa que o esquema não é um JSON Schema draft 2020-12 válido. A segunda significa que um nome de propriedade de nível superior não corresponde ao padrão que a mensagem cita.

O Claude Code [exclui ferramentas MCP cujo esquema de entrada falharia nessa validação](https://code.claude.com/docs/pt/mcp.md#tools-with-invalid-input-schemas) ao carregar as ferramentas de um servidor, então as requisições normalmente nunca incluem uma delas.

O erro ainda pode ocorrer, como quando:

* A [busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching) está ativada, mas as [flags ainda não chegaram](https://code.claude.com/docs/pt/env-vars.md#first-session-after-an-install-or-upgrade). Antes da v2.1.328, o erro também podia ocorrer com a busca desativada.
* O esquema da ferramenta declara em `$schema` um dialeto de JSON Schema diferente do draft 2020-12.

**O que fazer:**

* Se a sua versão do Claude Code for anterior à v2.1.300, execute [`claude update`](https://code.claude.com/docs/pt/setup#update-claude-code) no seu shell. Antes da v2.1.300, o Claude Code não [tentava novamente a requisição sem os parâmetros da ferramenta rejeitada](https://code.claude.com/docs/pt/mcp.md#tools-whose-input-schema-the-api-refuses), então este erro se repetia em toda requisição que incluía a ferramenta.
* Remova ou [desative](https://code.claude.com/docs/pt/mcp.md#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.
* 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](https://code.claude.com/docs/pt/mcp.md#tools-with-invalid-input-schemas).

### Nome de ferramenta MCP com mais de 128 caracteres

Um 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](https://code.claude.com/docs/pt/mcp.md#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`:

```text theme={null}
Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128
```

**O que fazer:**

* Se você mantém o servidor, encurte o nome da ferramenta.
* Se o servidor estiver na sua [configuração de MCP](https://code.claude.com/docs/pt/mcp.md#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](https://code.claude.com/docs/pt/permissions.md#mcp) e [matchers de hook](https://code.claude.com/docs/pt/hooks.md#match-mcp-tools).
* Se um [plugin incluir o servidor](https://code.claude.com/docs/pt/mcp.md#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.

Antes 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`.

### tool\_use.name com mais de 200 caracteres

Uma chamada de ferramenta no histórico da conversa traz um nome maior que os 200 caracteres que a API aceita em uma requisição:

```text theme={null}
API Error: 400 ... tool_use.name: String should have at most 200 characters
```

O 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.

**O que fazer:**

* 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.

Antes 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.

### There's an issue with the selected model

O 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.

```text theme={null}
There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.
```

**O que fazer:**

* **CLI interativa**: execute `/model` para escolher entre os modelos disponíveis para sua conta.
* **Modo não interativo (`-p`)**: passe `--model` com um alias ou ID válido, ou defina [`ANTHROPIC_MODEL`](https://code.claude.com/docs/pt/env-vars). O texto do erro mostra `Run --model` nessa superfície.
* **Agent SDK**: o texto do erro omite a dica porque o modelo é definido programaticamente. Defina [`model` em `Options`](https://code.claude.com/docs/pt/agent-sdk/typescript#options) em TypeScript ou [`ClaudeAgentOptions(model=...)`](https://code.claude.com/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.
* 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](https://code.claude.com/docs/pt/model-config.md).
* 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](https://code.claude.com/docs/pt/model-config.md#setting-your-model) e remova o valor desatualizado.
* Antes da v2.1.206, um login do claude.ai expirado que não podia mais ser renovado fazia todos os modelos falharem com esse erro. Execute `/login` nessas versões.
* Se [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars) aponta para um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) e todos os modelos falham dessa forma, verifique se o seu gateway e o upstream dele aceitam os campos de [busca de ferramentas](https://code.claude.com/docs/pt/mcp.md#tool-search-through-a-gateway). Por padrão, o Claude Code envia campos de ferramenta `defer_loading` e blocos `tool_reference`, com o cabeçalho `anthropic-beta` que os habilita. 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`.
* Para implantações no Agent Platform do Google Cloud, consulte [Solução de problemas do Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md#troubleshooting).

### Model is not a recognized model id

A 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](https://code.claude.com/docs/pt/agent-sdk/typescript.md), por um aplicativo que executa a CLI do Claude Code para você, como o [aplicativo Desktop](https://code.claude.com/docs/pt/desktop.md), ou quando você escolhe um modelo a partir de um dispositivo conectado por meio do [Remote Control](https://code.claude.com/docs/pt/remote-control.md). 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).

```text theme={null}
Model "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?
```

Neste 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](https://code.claude.com/docs/pt/desktop.md) inicia para você, a dica sem correspondência diz `Switch to a different model.`

Quando 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.

Quando 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.

**O que fazer:**

* Execute `/model` sem argumento para abrir o seletor e escolher entre os modelos disponíveis para sua conta, depois passe o alias ou ID mostrado ali
* 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).
* 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](https://code.claude.com/docs/pt/model-config.md#setting-your-model).
* 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.

### Model not found

Você 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](https://code.claude.com/docs/pt/model-config.md#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.

```text theme={null}
Model 'claude-opus-9' not found
```

Em provedores com IDs de modelo específicos do provedor, a mensagem pode adicionar uma sugestão `Try '...' instead` que nomeia o ID do seu provedor para um modelo de fallback.

**O que fazer:**

* Execute `/model` sem argumento e escolha entre os modelos disponíveis para sua conta, ou use um [alias de modelo](https://code.claude.com/docs/pt/model-config.md#model-aliases) como `sonnet`, que resolve para um padrão mantido
* 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.
* No Agent SDK, `setModel()` falha com essa mensagem e a sessão continua em execução no modelo anterior. No SDK TypeScript, chame [`supportedModels()`](https://code.claude.com/docs/pt/agent-sdk/typescript#query-object) para listar os modelos para os quais você pode trocar.
* 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](https://code.claude.com/docs/pt/model-config.md#setting-your-model) ou com `--model`.

### Couldn't confirm model with the API

Você trocou de modelo por meio do método `setModel()` do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/typescript.md) ou de um app que executa a CLI do Claude Code para você, como o [app Desktop](https://code.claude.com/docs/pt/desktop.md), e a requisição que confirma o ID do modelo com o seu endpoint de API não recebeu resposta em 15 segundos. A sessão mantém o modelo atual.

```text theme={null}
Couldn't confirm model "claude-sonnet-5" with the API. Try again, or run /model to see available models.
```

Em uma sessão que o [aplicativo Desktop](https://code.claude.com/docs/pt/desktop.md) inicia para você, a mensagem termina em `Try again.`

**O que fazer:**

* Troque para o modelo novamente
* 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)

### Erro de API ao verificar o modelo escolhido

Você 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:

```text theme={null}
API error: 429 <the server's explanation> · model not changed
```

O meio da mensagem é o status HTTP e a explicação do próprio servidor.

**O que fazer:**

* Aja de acordo com a explicação do servidor; para um rate limit ou um status 5xx, aguarde e escolha o modelo novamente
* 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)

### Claude Opus is not available with the Claude Pro plan

Seu plano de assinatura ativo não inclui o modelo que você selecionou.

```text theme={null}
Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.
```

Em uma sessão executada pelo aplicativo Claude Desktop, a mensagem diz `sign out and sign in again` em vez de nomear os comandos.

**O que fazer:**

* Execute `/model` e selecione um modelo que seu plano inclua
* 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.
* Consulte [claude.com/pricing](https://claude.com/pricing) para saber quais modelos cada plano inclui

### Claude Code does not support this model

A 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.

```text theme={null}
API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.
```

O texto da política da organização diz:

```text theme={null}
API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.
```

A versão que a API verifica é a informada pelo binário do Claude Code que fez a requisição.

**O que fazer:**

Atualize esse binário e depois inicie uma nova sessão. A origem do binário determina como, exceto em um [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#pin-the-version):

| O binário que fez a requisição | Como atualizá-lo |
| :- | :- |
| Um Claude Code que você instalou | Execute `claude update` |
| O aplicativo Claude desktop | Atualize o aplicativo |
| O binário incluído na [extensão do VS Code](https://code.claude.com/docs/pt/vs-code.md) | Atualize a extensão |
| O binário incluído em um pacote do Agent SDK | [Atualize o pacote do SDK](https://code.claude.com/docs/pt/agent-sdk/hosting.md#runtime-dependencies) e depois reinicie sua aplicação. Em um [executável compilado de arquivo único](https://code.claude.com/docs/pt/agent-sdk/typescript.md#compile-to-a-single-executable), recompile-o |

* Se você executar `claude update` no [canal de lançamento stable](https://code.claude.com/docs/pt/setup.md#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](https://code.claude.com/docs/pt/managed-settings.md), peça ao seu administrador que altere isso
* Para o texto por modelo, você pode continuar trabalhando na sessão atual trocando para outro modelo: execute `/model` na CLI, chame [`setModel()`](https://code.claude.com/docs/pt/agent-sdk/typescript#query-object) no objeto `Query` do SDK TypeScript no modo de entrada por streaming, ou chame [`set_model()`](https://code.claude.com/docs/pt/agent-sdk/python#claudesdkclient) no `ClaudeSDKClient` do SDK Python
* Para o texto da política da organização, atualize antes de continuar

### Model is restricted by your organization's settings

O 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`](https://code.claude.com/docs/pt/model-config#restrict-model-selection) ou de uma lista [`deniedModels`](https://code.claude.com/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.

```text theme={null}
Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
```

Digitar `/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.`

Um aviso prefixado com o nome de um agente, skill ou comando significa que a restrição se aplicou ao [modelo solicitado por esse subagente](https://code.claude.com/docs/pt/sub-agents.md#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.

O 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](https://code.claude.com/docs/pt/claude-platform-on-aws.md), 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.

**O que fazer:**

* Execute `/model` para escolher entre os modelos que sua organização permite. Modelos restritos ficam ocultos no seletor.
* 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](https://code.claude.com/docs/pt/sub-agents.md#choose-a-model), skill ou comando, remova ou atualize esse valor para que o aviso não se repita
* 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](https://code.claude.com/docs/pt/model-config.md#organization-model-restrictions).

### Can't switch to the default model

Você 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.

```text theme={null}
Can'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".
```

O texto após os dois-pontos indica o que bloqueou a troca:

* **`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
* **`your organization allows only the models listed in "availableModels"`**: uma allowlist gerenciada [`availableModels`](https://code.claude.com/docs/pt/model-config#restrict-model-selection) com [`availableModelsMatch`](https://code.claude.com/docs/pt/settings-reference#availablemodelsmatch) definida como `"exact"` deixa de fora o modelo para o qual a opção Default resolve
* **`Claude Code couldn't read your organization's managed settings to check which models they allow`**: as [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) não puderam ser lidas, e o Claude Code recusa a troca em vez de aplicá-la sem verificação

**O que fazer:**

* Para os textos sobre [`deniedModels`](https://code.claude.com/docs/pt/settings-reference#deniedmodels) e `availableModels`, execute `/model` e escolha pelo nome um modelo que sua organização permite
* Peça ao seu administrador que atualize a configuração gerenciada que a mensagem nomeia
* Para o texto `couldn't read`, reinicie o Claude Code; se continuar acontecendo, peça ao seu administrador que verifique as configurações gerenciadas

Se, 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).

### Model switch was blocked by a PreModelSwitch hook

Um [hook PreModelSwitch](https://code.claude.com/docs/pt/hooks.md#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](https://code.claude.com/docs/pt/agent-sdk/overview.md) ou do [Remote Control](https://code.claude.com/docs/pt/remote-control.md) em vez de um comando que você digitou, a mensagem diz `Model switch blocked by a PreModelSwitch hook` sem nomear o modelo de destino.

```text theme={null}
Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.
```

O motivo após os dois-pontos indica o que recusou a troca:

* **Um motivo escrito por um hook**: um hook PreModelSwitch forneceu esse motivo ao [negar a troca ou pedir confirmação](https://code.claude.com/docs/pt/hooks.md#premodelswitch-decision-control). Resolva o que ele pede, ou escolha um modelo que seus hooks permitam.
* **`PreModelSwitch hook <name> did not respond before its timeout`**: um hook que não responde antes do seu [timeout](https://code.claude.com/docs/pt/hooks.md#timeouts) bloqueia a troca. Corrija o comando travado ou aumente o `timeout` desse hook e depois troque novamente.
* **`confirmation required, and this session cannot ask`**: um hook respondeu `ask` sem um motivo, e uma requisição de controle não tem como mostrar o prompt de confirmação. Um comando `/model` em uma [execução `-p`](https://code.claude.com/docs/pt/headless) informa a mesma condição com `(run /model interactively to confirm)` após o motivo. Faça a troca a partir de uma sessão interativa, ou altere a decisão do hook para esse modelo.
* **`so organization-managed PreModelSwitch hooks could not be checked`**: o Claude Code anterior à v2.1.323 recusa quando não consegue determinar quais hooks PreModelSwitch seus [plugins gerenciados](https://code.claude.com/docs/pt/settings-reference.md#enabledplugins) fornecem. O texto antes dessa frase menciona o que falhou. Para acabar com a recusa, atualize o Claude Code. Para também fazer os hooks de um plugin com falha funcionarem, corrija o plugin ou fale com seu administrador. Para mais detalhes, inicie `claude --debug` no seu shell e troque de modelo, depois leia o [log de depuração](https://code.claude.com/docs/pt/hooks.md#debug-hooks).
* **`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.

Antes 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.

### Couldn't save it as your default

Você 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.

```text theme={null}
Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)
```

O motivo após o caminho do arquivo indica o que falhou:

* **`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 [Uma alteração que você fez no Claude Code se perde em novas sessões](https://code.claude.com/docs/pt/settings.md#a-change-you-made-in-claude-code-is-lost-in-new-sessions).
* **`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](https://code.claude.com/docs/pt/settings.md#fix-a-broken-settings-file).

Um 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.

Antes da v2.1.265, o aviso dizia que o modelo foi `saved as your default for new sessions` mesmo quando a gravação falhava.

### Advisor is less capable than the current main model

Seu [modelo advisor](https://code.claude.com/docs/pt/advisor.md) 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.

```text theme={null}
Advisor set to Opus 4.8
Note: 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.
```

Outras mensagens informam a mesma condição:

* 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`.
* Quando você inicia com a flag `--advisor` no [modo não interativo](https://code.claude.com/docs/pt/headless.md), e a execução não é uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md), 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).

**O que fazer:**

* Escolha um advisor com classificação mais alta ou um modelo principal com classificação mais baixa. [Escolher um modelo advisor](https://code.claude.com/docs/pt/advisor.md#choose-an-advisor-model) mostra a classificação e lista os advisors aceitos para cada modelo principal.
* Mantenha o advisor definido se quiser que [subagentes](https://code.claude.com/docs/pt/sub-agents.md) cujo modelo ele pode aconselhar continuem a usá-lo

Antes 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.

### thinking.type.enabled is not supported for this model

Sua 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.

```text theme={null}
API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```

**O que fazer:**

* Execute `claude update` e reinicie 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
* No [canal de lançamento stable](https://code.claude.com/docs/pt/setup.md#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
* Se você não puder atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.6
* Se você encontrar isso no [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), 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

### Effort isn't available with thinking turned off

Você desativou o [pensamento estendido](https://code.claude.com/docs/pt/model-config.md#extended-thinking) e executou em um [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) acima de `high`. O modelo não aceita essa combinação, então a API rejeitou a requisição.

```text theme={null}
API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)
```

A 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`.

**O que fazer:**

* [Reduza o nível de esforço](https://code.claude.com/docs/pt/model-config.md#set-the-effort-level) para `high` ou abaixo.
* Ative o pensamento novamente, por exemplo removendo a definição de [`MAX_THINKING_TOKENS`](https://code.claude.com/docs/pt/env-vars) ou removendo [`"alwaysThinkingEnabled": false`](https://code.claude.com/docs/pt/settings-reference#alwaysthinkingenabled) das suas configurações.

Antes 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.

### Thinking budget exceeds output limit

O 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.

```text theme={null}
API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
```

**O que fazer:**

* Aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](https://code.claude.com/docs/pt/env-vars) para acima do orçamento de pensamento
* Consulte [Pensamento estendido](https://code.claude.com/docs/pt/model-config.md#extended-thinking) para saber como o orçamento interage com o tamanho da saída

### Response exceeded the output token maximum

A resposta do Claude atingiu o maior número de tokens de saída que a requisição permitia e foi cortada ali:

```text theme={null}
API Error: Claude's response exceeded the ... output token maximum. To configure this behavior, set the CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable.
API 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.
```

A 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.

**O que fazer:**

* 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.
* Se a mensagem disser para definir `CLAUDE_CODE_MAX_OUTPUT_TOKENS`, consulte [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](https://code.claude.com/docs/pt/env-vars) para saber como o valor é limitado e [Definir variáveis de ambiente](https://code.claude.com/docs/pt/env-vars.md#set-environment-variables) para saber onde defini-la
* 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

### Incompatibilidade de blocos de uso de ferramenta ou de pensamento

O histórico da conversa chegou à API em um estado inconsistente.

```text theme={null}
API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.
API Error: 400 duplicate tool_use ID in conversation history. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified
```

Todas as variantes significam a mesma coisa: a sequência de blocos `tool_use`, `tool_result` e `thinking` no histórico não corresponde mais ao que a API espera.

**O que fazer:**

* Se você 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.
* Execute `/rewind`, ou pressione Esc duas vezes, para voltar a um checkpoint anterior ao turno corrompido e continuar a partir dali. Consulte [Checkpointing](https://code.claude.com/docs/pt/checkpointing.md) para saber como os checkpoints são criados e restaurados.

### Invalid data in redacted\_thinking block

A 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.

```text theme={null}
API Error: 400 ... Invalid `data` in `redacted_thinking` block
```

O 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.

**O que fazer:**

* 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
* Se o erro persistir, execute `/clear` para iniciar uma conversa que não contenha o bloco

### Unsupported tool content removed

Quando 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:

```text theme={null}
[Unsupported tool content removed]
```

Esse 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`](https://code.claude.com/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', ...`.

**O que fazer:**

* Nada é necessário quando você vê a linha substituta. A sessão continua sem o conteúdo removido.
* 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.

### role 'system' must precede an 'assistant' message

A 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:

```text theme={null}
API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...
```

O 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.

Quando 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](https://code.claude.com/docs/pt/llm-gateway) entre o Claude Code e a API adicionou uma mensagem de sistema própria.

**O que fazer:**

* Se o erro se repetir a cada turno por trás de um proxy ou gateway configurado por meio de [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars), conecte-se sem o proxy para confirmar a origem e informe o erro a quem o opera
* 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.

Antes 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.

### Invalid encrypted\_content in search\_result block

A 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:

```text theme={null}
API Error: 400 ... Invalid `encrypted_content` in `search_result` block
API Error: 400 ... Invalid `encrypted_index` in `text` block
API Error: 400 ... Failed to decrypt web search result content
API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block
```

Os 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.

A própria [ferramenta WebSearch](https://code.claude.com/docs/pt/tools-reference.md#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](https://code.claude.com/docs/pt/llm-gateway) que executou ele mesmo a pesquisa na web hospedada.

Para 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.

**O que fazer:**

* 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
* 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
* Se você executa o Claude Code por trás de um proxy ou gateway, informe o erro a quem o opera

### Recusa pela Política de Uso

A 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).

Se a mensagem incluir a linha `` Details: `[reasoning_extraction]` ``, consulte [Safeguards flagged a request for Claude's reasoning](#safeguards-flagged-a-request-for-claudes-reasoning).

A mensagem inclui um Request ID e um Message ID que você pode citar ao suporte se acreditar que a recusa está incorreta.

```text theme={null}
API Error: Opus 4.6 can't help with this. Start a new session to continue.

Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup
```

A mensagem nomeia o modelo que recusou, ou `Claude` quando nenhum modelo está registrado.

A verificação avalia a conversa completa, não apenas seu prompt mais recente, então enviar uma nova mensagem na mesma sessão geralmente 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](https://code.claude.com/docs/pt/amazon-bedrock.md), no [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md) e no [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md), 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).

Antes 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.`

**O que fazer:**

* 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](https://code.claude.com/docs/pt/checkpointing.md).
* 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`.
* No [modo não interativo](https://code.claude.com/docs/pt/headless.md) (`-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.

### Medidas de segurança sinalizaram um tópico de cibersegurança

As medidas de segurança do modelo sinalizaram conteúdo na conversa como um tópico de cibersegurança. A mensagem indica o modelo que sinalizou a requisição:

```text theme={null}
API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude
```

Se 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).

Esta 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](https://code.claude.com/docs/pt/model-config.md#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.

No [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), no [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md) e no [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md), uma sinalização de cibersegurança produz, em vez disso, a mensagem de [recusa pela Política de Uso](#usage-policy-refusal).

**O que fazer:**

* 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)
* Se a sua requisição não era sobre um tópico de cibersegurança, execute `/feedback` para relatar o falso positivo
* Para continuar trabalhando na mesma sessão, pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint anterior ao turno que acionou a sinalização e, em seguida, adote uma abordagem diferente. Consulte [Checkpointing](https://code.claude.com/docs/pt/checkpointing.md).

Se a mensagem que você vê estiver redigida como uma destas, trata-se da mesma sinalização em uma versão anterior do Claude Code:

* Da v2.1.219 até a v2.1.296, a mensagem também podia incluir `Apply to the Cyber Verification Program to reduce these interruptions.` antes da frase final
* 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.`
* 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

### As salvaguardas sinalizaram uma requisição do raciocínio do Claude

A 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:

```text theme={null}
Details: `[reasoning_extraction]`
```

Antes da v2.1.234, as mensagens de recusa não incluíam a linha `Details`.

**O que fazer:**

* 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.
* Para verificar se uma personalização é a causa, execute [`claude --safe-mode`](https://code.claude.com/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
* Depois de alterar uma personalização, inicie uma nova sessão
* Para reformular um prompt que você já enviou, consulte [Rewind and summarize](https://code.claude.com/docs/pt/checkpointing.md#rewind-and-summarize)
* 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`](https://code.claude.com/docs/pt/settings-reference#showthinkingsummaries).
* 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)

### Output blocked by content filtering policy

O filtro de conteúdo de saída da API interrompeu a resposta que o Claude estava gerando. O texto da mensagem vem da API:

```text theme={null}
API Error: Output blocked by content filtering policy
```

**O que fazer:**

* Reformule sua última mensagem ou adote uma abordagem diferente
* Para voltar a um checkpoint anterior ao turno que acionou o bloqueio, pressione Esc duas vezes ou execute `/rewind`. Consulte [Checkpointing](https://code.claude.com/docs/pt/checkpointing.md)

## Erros de linha de comando

Esses erros vêm da linha de comando `claude` e de seus subcomandos, de um nome de comando que você envia no prompt e de comandos como `/security-review`, que coletam contexto executando comandos de shell antes de o prompt ser executado. Eles também vêm de `/tui`, que reinicia a CLI.

### Conflito entre `--bg` e `--print`

Esta mensagem requer o Claude Code v2.1.198 ou posterior. Você combinou `--bg` com `-p` ou `--print` na mesma invocação de `claude`. `--bg` inicia uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md#from-your-shell) à qual você se conecta depois com `claude agents`, enquanto `--print` é executado de forma [não interativa](https://code.claude.com/docs/pt/headless.md) e nunca inicia a sessão interativa à qual `claude agents` se conecta. Antes da v2.1.198, essa combinação criava silenciosamente um job em segundo plano ao qual nunca era possível se conectar.

```text theme={null}
--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.
```

**O que fazer:**

* Remova `-p` ou `--print`. `--bg` recebe o prompt como seu argumento posicional, então `claude --bg "<task>"` é o comando completo. Consulte [Dispatch de novos agentes a partir do seu shell](https://code.claude.com/docs/pt/agent-view.md#from-your-shell).
* Para executar o prompt de forma não interativa e imprimir o resultado em vez de criar uma sessão em segundo plano, remova `--bg` e execute `claude -p "<task>"`

### Couldn't tell whether `--bg` is a flag or text

Você executou `claude` com `--bg` ou `--background` em uma posição na qual o Claude Code não conseguiu determinar se você queria usá-lo como a flag de segundo plano ou como texto. O comando não iniciou nada, imprimiu esta linha e saiu com código 1:

```text theme={null}
Couldn't tell whether --bg is a flag or text here, so nothing was started. To start a background session put it first: claude --bg <prompt>
```

Se você digitou `--background`, a linha menciona `--background` em vez disso.

**O que fazer:**

* Para iniciar uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md#from-your-shell), execute o comando novamente no seu shell com a flag primeiro: `claude --bg --name nightly-audit "<task>"`

### Conflito entre uma flag de system prompt e sua forma de arquivo

Você passou [`--append-subagent-system-prompt`](https://code.claude.com/docs/pt/cli-reference#cli-flags) junto com `--append-subagent-system-prompt-file` em uma única invocação de `claude`, então `claude` sai com código 1 em vez de iniciar a sessão:

```text theme={null}
Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
```

Antes da v2.1.283, `claude` saía da mesma forma quando você passava `--system-prompt` com `--system-prompt-file`, ou `--append-system-prompt` com `--append-system-prompt-file`, porque esses pares entravam em conflito em vez de se [combinarem](https://code.claude.com/docs/pt/cli-reference.md#system-prompt-flags). Nessas versões, a mensagem nomeia o par que você combinou.

**O que fazer:**

* Mantenha uma forma da flag e remova a outra. Para combinar um arquivo de prompt fixo com texto específico de cada execução, mescle o texto no arquivo antes de iniciar, em vez de passar as duas flags

### Configuração `--agents` inválida

O valor que você passou para `--agents` é inválido, então `claude` sai com código 1 em vez de iniciar a sessão. Quando você passa `--safe-mode` ou define [`CLAUDE_CODE_SAFE_MODE`](https://code.claude.com/docs/pt/env-vars#variables), o Claude Code ignora `--agents` completamente. Com `--resume` ou `--continue`, um valor JSON inline não é verificado e a sessão é iniciada; um valor lido de um arquivo é verificado em cada inicialização. Antes da v2.1.242, o Claude Code iniciava a sessão mesmo assim.

```text theme={null}
Error: Invalid --agents configuration:
<what failed>
```

O que vem após a primeira linha depende de como o valor falhou. O Claude Code executa essas verificações em ordem e para na primeira que falhar. Se o seu valor tiver dois tipos de problema, você verá o segundo somente depois de corrigir o primeiro:

1. Quando o valor começa com `{` mas não é analisado como JSON, ou o conteúdo de um arquivo `--agents` não é analisado, o Claude Code imprime uma linha `invalid JSON:` contendo a própria mensagem do analisador JSON
2. Quando é analisado, mas uma definição de agente não corresponde ao esquema para [subagentes definidos pela CLI](https://code.claude.com/docs/pt/sub-agents.md#choose-the-subagent-scope), o Claude Code imprime uma linha por problema
3. Quando o nome de um agente começa com `-`, o Claude Code imprime `<name>: agent names must not start with '-'`

Quando há mais de 20 linhas de problema, o Claude Code imprime as 20 primeiras e substitui o restante por `…and N more`.

Com `--print`, `--agents` também aceita [o caminho para um arquivo JSON](https://code.claude.com/docs/pt/sub-agents.md#choose-the-subagent-scope) no lugar do objeto inline. Antes da v2.1.281, `--agents` aceitava apenas JSON inline e tratava um caminho de arquivo como JSON inválido. A forma de arquivo tem suas próprias recusas, impressas no lugar desta mensagem, incluindo estas:

* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: o Claude Code leu o valor como um caminho de arquivo em uma sessão interativa. Passe as definições como JSON inline, ou adicione `-p` para lê-las de um arquivo.
* **`Error: --agents file not found: <path>`**: não existe nenhum arquivo nesse caminho. Um valor que não começa com `{` e não é JSON válido é lido como um caminho, então um JSON inline que seu shell corrompeu também pode falhar dessa forma. Verifique o caminho ou as aspas e execute o comando novamente.

**O que fazer:**

* Corrija cada problema que a mensagem lista e execute o comando novamente. Consulte [os campos que um subagente definido pela CLI aceita](https://code.claude.com/docs/pt/sub-agents.md#choose-the-subagent-scope).

### Sessões na nuvem não podem ser criadas a partir de uma sessão `--restricted`

Quando você inicia uma sessão com [`--restricted`](https://code.claude.com/docs/pt/cli-reference#cli-flags), o Claude Code se recusa a criar [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md#from-terminal-to-cloud) a partir dela, porque a nova sessão seria executada fora do processo restrito e não aplicaria o modo restrito. O Claude Code recusa no cliente, antes de contatar o servidor, então nenhuma sessão na nuvem é criada:

```text theme={null}
Cloud sessions cannot be created from a --restricted session: they would not enforce it.
```

**O que fazer:**

* Execute a tarefa localmente na sessão restrita
* Se você controla como a sessão foi iniciada, inicie uma nova sessão `claude` sem `--restricted` e crie a sessão na nuvem a partir dela

Antes da v2.1.248, o Claude Code não tinha a flag `--restricted`; versões anteriores rejeitam a própria flag com um erro de opção desconhecida.

### Sessões na nuvem estão desativadas pela política da sua organização

A política `allow_remote_sessions` da sua organização está desativada, então as [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) e os comandos que as usam não estão disponíveis:

```text theme={null}
Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
```

A mensagem aparece quando você [cria uma sessão na nuvem a partir do terminal](https://code.claude.com/docs/pt/claude-code-on-the-web.md#from-terminal-to-cloud) e quando você envia um comando que precisa de sessões na nuvem, como `/teleport`, `/remote-env` ou `/web-setup`. Antes da v2.1.268, enviar um desses comandos retornava [`Unknown command`](#unknown-command).

Se a mensagem, em vez disso, nomear uma credencial que esta sessão está usando e terminar com `Cloud sessions use your claude.ai login.`, consulte [Cloud sessions use your claude.ai login](#cloud-sessions-use-your-claude-ai-login). Se o Claude Code não conseguiu carregar a política da sua organização de forma alguma, você verá [uma mensagem diferente](#couldnt-verify-your-organizations-policy-for-cloud-sessions).

**O que fazer:**

* Peça a um [Owner](https://code.claude.com/docs/pt/server-managed-settings.md#access-control) da sua organização para ativar sessões na nuvem nas configurações de administrador do Claude Code em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)

### Cloud sessions use your claude.ai login

Quando a [negação por política](#cloud-sessions-are-disabled-by-your-organizations-policy) nomeia uma credencial que esta sessão está usando e termina com esta frase, o Claude Code verificou a política de sessões na nuvem da organização que emitiu essa credencial. Essa organização pode ser diferente daquela à qual seu login do claude.ai pertence:

```text theme={null}
Cloud sessions are disabled by your organization's policy. This session is using ANTHROPIC_API_KEY, so Claude Code checked the policy for the organization that key belongs to. Cloud sessions use your claude.ai login.
```

A última frase significa que as sessões na nuvem são executadas com seu login do claude.ai, e não com essa credencial. Essa forma aparece quando você inicia, retoma ou envia uma mensagem para uma sessão na nuvem a partir do seu shell, como com `--cloud` ou `--teleport`. Antes da v2.1.296, o Claude Code também imprimia nesse caso a forma que instrui você a contatar o administrador da sua organização.

### Couldn't verify your organization's policy for cloud sessions

Essas mensagens significam que o Claude Code não conseguiu carregar a política da sua organização, que ele verifica antes de criar, retomar ou enviar mensagens para uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md). Enquanto a requisição da política não terminou, a mensagem é:

```text theme={null}
Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.
```

Dentro de uma sessão, um comando que precisa de sessões na nuvem, como `/teleport` ou `/web-setup`, também exibe esta mensagem. Ele faz isso mesmo onde seu shell imprimiria uma forma `Cloud sessions aren't available:`, e sua segunda frase diz `Check your network connection, then restart Claude Code and try again.`

Depois que a requisição da política falha, a mensagem diz o que falhou. Isso se aplica quando você inicia, retoma ou envia uma mensagem para uma sessão na nuvem a partir do seu shell com uma flag como `--cloud` ou `--teleport`. Sem rota até a API, ela diz:

```text theme={null}
Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.
```

Outras falhas seguem a mesma abertura com sua própria causa, como um proxy que recusou a requisição com HTTP 403, um erro de servidor ou credenciais que a API não aceitou. Quando a API não aceitou uma credencial que esta sessão usa no lugar do seu login do claude.ai, como uma variável de ambiente `ANTHROPIC_API_KEY`, a mensagem também pode nomeá-la e dizer para removê-la:

```text theme={null}
Cloud sessions aren't available: api.anthropic.com didn't accept this session's credentials when Claude Code asked for your organization's policy. Cloud sessions use your claude.ai login. ANTHROPIC_API_KEY is set, so this session is using API-key auth — unset it (or run in a shell without it) to use cloud sessions.
```

Antes da v2.1.296, essas falhas também imprimiam a mensagem `Couldn't verify`.

**O que fazer:**

* Para a mensagem `Couldn't verify`, verifique sua conexão de rede e tente novamente. Dentro de uma sessão, reinicie o Claude Code primeiro
* Para uma mensagem `Cloud sessions aren't available:`, faça o que sua causa exige, como verificar seu proxy ou remover a credencial que ela nomeia, e execute o comando novamente

### Nada foi guardado no stash porque uma pasta substituiu um arquivo rastreado

Esta mensagem significa que uma pasta no seu checkout agora está onde antes havia um arquivo ou link rastreado pelo git. Ela aparece depois que você escolhe a opção de stash ao trazer uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md#from-cloud-to-terminal) para o seu terminal, por exemplo com `claude --teleport` ou `/teleport`. Fazer stash desse estado poderia excluir os arquivos dentro da pasta, então o Claude Code recusa o stash e deixa seu checkout e seu índice inalterados:

```text wrap theme={null}
Error: Nothing was stashed: "f" is now a folder in place of a tracked file or link, and stashing could delete what's in it for good. Commit the change or move the folder somewhere else, then try again.
```

**O que fazer:**

* Faça commit da alteração ou mova a pasta para outro lugar, como a mensagem diz, e execute o teleport novamente

### O valor de `--json-schema` não é um JSON Schema válido

O esquema que você passou para [`--json-schema`](https://code.claude.com/docs/pt/cli-reference#cli-flags) no [modo não interativo](https://code.claude.com/docs/pt/headless.md#get-structured-output) falhou na compilação do JSON Schema, então `claude` sai com código 1 em vez de executar o prompt. Antes da v2.1.205, um esquema inválido produzia uma saída não estruturada sem erro, e qualquer esquema que usasse a palavra-chave `format` era tratado como inválido.

```text theme={null}
Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
```

O texto após os segundos dois-pontos é o diagnóstico do validador e nomeia a palavra-chave ou o local que falhou. Esquemas que usam a palavra-chave `format`, como `"format": "email"`, são válidos: o Claude Code aceita `format` como uma anotação e não o aplica.

O Claude Code executa duas verificações antes da compilação do esquema: rejeita um valor que não é JSON analisável com `Error: --json-schema is not valid JSON`, e um JSON válido que não é um objeto com `Error: --json-schema must be a JSON object`.

**O que fazer:**

* Corrija a parte do esquema que o diagnóstico nomeia e execute o comando novamente
* Consulte [Obter saída estruturada](https://code.claude.com/docs/pt/headless.md#get-structured-output) para ver um esquema e um comando que funcionam

### O arquivo de configurações excede o limite de 2MiB

O arquivo que você passou para [`--settings`](https://code.claude.com/docs/pt/cli-reference#cli-flags) é maior que 2 MiB, então `claude` sai com código 1 na inicialização em vez de carregá-lo. Antes da v2.1.214, o Claude Code lia o arquivo sem verificar o tamanho, e um arquivo de vários gigabytes ou um arquivo de dispositivo como `/dev/zero` fazia a memória crescer sem limite.

```text theme={null}
Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
```

O Claude Code rejeita da mesma forma um caminho de `--settings` que não seja um arquivo regular: um dispositivo, FIFO ou socket relata `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` seguido do caminho, e um diretório relata um motivo `EISDIR`.

**O que fazer:**

* Aponte `--settings` para um arquivo de configurações JSON regular com menos de 2 MiB. Consulte [Configurações](https://code.claude.com/docs/pt/settings.md) para ver o formato.

### Configuration error in \~/.claude.json

O Claude Code não conseguiu analisar `~/.claude.json`, o arquivo que contém os detalhes da sua conta, servidores MCP e o estado por projeto. Uma inicialização [não interativa](https://code.claude.com/docs/pt/headless.md), como `claude -p`, encerra com código de saída 1.

Quando o Claude Code encontra um [backup](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically), a saída o menciona e imprime uma linha `cp` que o copia de volta:

```text wrap theme={null}
Claude configuration file at /home/user/.claude.json is corrupted: <JSON parser's message>
The corrupted file has been backed up to: /home/user/.claude/backups/.claude.json.corrupted.1793664000000
A backup file exists at: /home/user/.claude/backups/.claude.json.backup.1793660400000
You can manually restore it by running: cp -f "/home/user/.claude/backups/.claude.json.backup.1793660400000" "/home/user/.claude.json"

Configuration error in /home/user/.claude.json: <JSON parser's message>
```

**O que fazer:**

* **A saída tem uma linha `cp`**: execute essa linha no seu terminal. No Windows, execute-a no PowerShell.
* **A saída não tem uma linha `cp`, ou o erro volta depois que você a executa**: se `~/.claude.json` ainda contiver sua configuração, corrija o JSON. Se não conseguir, copie outro arquivo `.claude.json.backup.<timestamp>` de [`~/.claude/backups/`](https://code.claude.com/docs/pt/claude-directory#cleaned-up-automatically) por cima dele, se houver um, ou renomeie-o. Sem nenhum arquivo em `~/.claude.json`, o Claude Code inicia com as configurações padrão e sem nada do que o arquivo continha.
* **`~/.claude.json` não contém mais sua configuração**: encontre um arquivo `.claude.json.corrupted.<timestamp>` que ainda a contenha, em [`~/.claude/backups/`](https://code.claude.com/docs/pt/claude-directory#cleaned-up-automatically) ou no seu diretório pessoal. Corrija o JSON e copie-o por cima de `~/.claude.json`. Se não conseguir encontrar ou corrigir um, tente os mesmos passos com um arquivo `.claude.json.backup.<timestamp>` que contenha sua configuração. Se nenhum contiver, renomeie `~/.claude.json` e adicione seus servidores MCP novamente com [`claude mcp add`](https://code.claude.com/docs/pt/mcp#installing-mcp-servers).

### Claude configuration file was empty and no backup holds anything

Esta mensagem na inicialização significa que o arquivo mencionado estava vazio e nenhuma das [cópias `.backup`](https://code.claude.com/docs/pt/claude-directory#cleaned-up-automatically) do arquivo contém nada. O Claude Code iniciou com os padrões para o que esse arquivo contém. Seus arquivos `settings.json` e `.mcp.json` são arquivos separados.

```text wrap theme={null}
Claude configuration file at /home/user/.claude.json was empty and no backup holds anything: starting with defaults.
```

**O que fazer:**

* Configure novamente o que você tinha configurado nesse arquivo. Por exemplo, adicione seus [servidores MCP](https://code.claude.com/docs/pt/mcp.md#mcp-installation-scopes) de escopo `user` e `local` com `claude mcp add` no seu terminal.
* Faça login novamente se o Claude Code solicitar

Antes da v2.1.318, o Claude Code informava um arquivo vazio sem backup como [corrompido](#configuration-error-in-claude-json).

### O diretório atual não existe mais

Você iniciou `claude` a partir de um diretório que foi excluído ou movido depois que seu shell entrou nele, por exemplo um worktree ou um diretório temporário que outro shell removeu. O Claude Code não consegue ler seu diretório de trabalho, então sai com código 1 antes de iniciar a sessão, tanto no modo interativo quanto no [não interativo](https://code.claude.com/docs/pt/headless.md). Antes da v2.1.239, o Claude Code travava com o código-fonte do bundle minificado e uma stack `ENOENT ... uv_cwd` bruta no stderr em vez desta mensagem.

```text theme={null}
The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.
```

A causa e a correção são as mesmas para as duas formas.

Quando o Claude Code não consegue ler o diretório de trabalho por outro motivo, como uma alteração de permissões, a mensagem nomeia o código de erro: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`

No macOS, `EPERM` para um diretório em `~/Desktop`, `~/Documents`, `~/Downloads` ou no iCloud Drive geralmente significa que o macOS está bloqueando o acesso do seu aplicativo de terminal a essa pasta. Outros comandos que leem essa pasta falham da mesma forma: `ls` nela relata `Operation not permitted`, mesmo com `sudo`.

**O que fazer:**

* Mude para um diretório que exista, como seu diretório pessoal ou o diretório do projeto, e execute `claude` novamente
* Se o diretório foi recriado no mesmo caminho, seu shell ainda mantém o diretório excluído. Execute `cd "$PWD"` ou saia e entre novamente no diretório, e então execute `claude` novamente
* Para `EPERM` no macOS, feche seu aplicativo de terminal com Cmd+Q, abra-o novamente, volte para essa pasta e execute `claude`. Se `ls` nessa pasta ainda falhar, abra **Ajustes do Sistema > Privacidade e Segurança > Arquivos e Pastas**, ative a pasta para seu aplicativo de terminal e reabra o terminal

### Diretório temporário recusado ou não pode ser criado

No macOS e no Linux, o Claude Code cria um diretório temporário privado na inicialização, `claude-<uid>`, sob o diretório temporário do sistema ou o valor que o sobrescreve em [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/pt/env-vars). Quando o diretório não pode ser criado, ou uma entrada já existente nesse caminho falha nas verificações de segurança, o Claude Code imprime a falha no stderr e sai com código 1 em vez de iniciar a sessão:

```text wrap theme={null}
Claude Code's temporary directory /tmp/claude-501 could not be created: the volume holding /tmp is full (ENOSPC). Free space on that volume, or set CLAUDE_CODE_TMPDIR to a directory on another one, then try again.

Temp directory /tmp/claude-501 is not a directory (may be an attacker-planted symlink). Refusing to use it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is owned by uid 502, expected 501. Refusing to use it — another user may have pre-created it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.
```

**O que fazer:**

* Para `could not be created` seguido de `is full (ENOSPC)`, libere espaço em disco no volume que a mensagem menciona. Quando ela diz `your disk quota on the volume holding /tmp is used up (EDQUOT)`, exclua arquivos seus nesse volume de que você não precisa mais
* Para as formas `Refusing to use it`, remova a própria entrada nomeada, não aquilo para o qual um link aponta, e inicie o Claude Code novamente; para a forma `owned by uid`, somente um administrador ou esse usuário pode removê-la
* Para `is not readable`, execute `chmod 0700` no diretório nomeado, ou remova-o e inicie novamente
* Em qualquer um desses casos, defina [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/pt/env-vars) como um diretório que você controla e inicie o Claude Code novamente, deixando o caminho recusado como está

Antes da v2.1.309, o Claude Code imprimia apenas o texto de erro do sistema operacional quando o volume estava cheio ou sua cota estava esgotada. Um exemplo é `ENOSPC: no space left on device, mkdir '/tmp/claude-501'`, e as mesmas etapas se aplicam.

### O Claude Code não conseguiu salvar porque o disco está cheio

Esta linha no stderr após uma execução de [`claude -p`](https://code.claude.com/docs/pt/headless) significa que o disco está cheio ou sua cota de disco está esgotada, então o Claude Code não conseguiu salvar tudo da execução:

```text wrap theme={null}
Error: Claude Code could not save all of this session's transcript under /Users/you/.claude because the disk is full (ENOSPC). If you resume this session, part of the conversation may be missing. Free up space on that disk before the next run.
```

Com saída em texto ou `json`, a execução sai com o código 1, e a resposta já foi impressa. Com saída `stream-json`, a execução mantém seu código de saída habitual, e a resposta ainda chega.

**O que fazer:**

* **`the disk is full (ENOSPC)`**: antes da próxima execução, libere espaço no disco que contém o caminho da mensagem
* **`your disk quota is used up (EDQUOT)`**: antes da próxima execução, libere espaço ou peça uma cota maior

### O diretório não pôde ser resolvido para um local real

Você executou `/add-dir` para um subdiretório do seu diretório de trabalho, e o Claude Code não conseguiu resolver o diretório para seu local real.

Você já tem acesso a arquivos em um subdiretório do diretório de trabalho, então `/add-dir` apenas carrega suas skills, comandos e agentes. Antes de carregá-los, o Claude Code verifica se o local real do diretório, com todos os links simbólicos resolvidos, está dentro do diretório de trabalho. Quando o Claude Code não consegue resolver esse local, ele não carrega nada e mostra esta mensagem:

```text theme={null}
packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.
```

**O que fazer:**

* Verifique se o caminho nomeia um diretório real dentro do diretório de trabalho e execute `/add-dir` novamente
* A mensagem não altera seu acesso a arquivos; ela apenas informa que o conteúdo `.claude/` do diretório não foi carregado

Antes da v2.1.261, esta mensagem também aparecia para cada `/add-dir <subdirectory>` quando o diretório de trabalho estava em um automount `/net/<host>`, onde o Claude Code, por design, não resolve caminhos; o diretório estava correto e tentar novamente não ajudava.

### Workspace não confiável ao iniciar o Remote Control

> [!NOTE]
>
> Se `claude ultrareview` imprimiu `Error: Workspace not trusted`, consulte, em vez disso, [Workspace not trusted ao executar claude ultrareview](#workspace-not-trusted-when-running-claude-ultrareview).

Você iniciou o modo servidor do [Remote Control](https://code.claude.com/docs/pt/remote-control.md) com `claude remote-control` ou seu alias `claude rc` em um diretório no qual você não confiou, e o comando não pôde perguntar se você confia nele. Por exemplo, a entrada padrão ou a saída padrão do comando não é um terminal porque uma delas está redirecionada ou conectada a um pipe. O comando sai com código 1:

```text theme={null}
Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
```

Duas variantes que também começam com `Error: Workspace not trusted.` aparecem em um terminal pequeno demais para mostrar o que confiar no diretório ativa, ou em um que não informou seu tamanho. Aumente a janela ou mude para uma janela de terminal normal e execute `claude rc` novamente.

No seu diretório pessoal a mensagem é diferente, porque a caixa de diálogo de confiança do workspace nunca salva a confiança para o diretório pessoal, então aceitá-la ali não pode satisfazer essa verificação. Antes da v2.1.214, o diretório pessoal mostrava a mensagem acima, cujo conselho não pode funcionar ali.

```text theme={null}
Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).
```

Se você responder `n` ou pressionar Enter na [pergunta `Trust <directory>?`](https://code.claude.com/docs/pt/remote-control#requirements), o comando imprime uma mensagem `Remote Control did not start` que nomeia o diretório e sai com código 1. Execute `claude rc` novamente para responder `y`.

**O que fazer:**

* Confie no diretório primeiro a partir de um terminal: execute `claude` ali e aceite a [caixa de diálogo de confiança do workspace](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust), e então execute seu comando original novamente
* No seu diretório pessoal, mude para um diretório de projeto e inicie o Remote Control ali

Antes da v2.1.284, o comando nunca perguntava, mesmo em um terminal.

### Workspace not trusted ao executar claude ultrareview

Em uma pasta na qual você não confiou, quando [`claude ultrareview`](https://code.claude.com/docs/pt/ultrareview#trust-the-folder-before-the-review-runs) não consegue perguntar se você confia nela, a execução sai com código 1 antes de a revisão começar:

```text theme={null}
Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog. Or, in a script or CI job, pass `--trust-workspace` to trust the folder for this run only.
```

Por exemplo, o subcomando não consegue perguntar quando sua entrada padrão ou saída padrão não é um terminal. Enviar a saída para um arquivo, como em `claude ultrareview --json > findings.json`, significa que a saída padrão não é um terminal.

**O que fazer:**

* Em um script ou job de CI, acrescente `--trust-workspace` para confiar na pasta nessa execução: `claude ultrareview --trust-workspace`. Acrescente-a apenas para código em que você confia, porque o git e o Claude Code podem então executar programas indicados na configuração do git e nas configurações do projeto da pasta. Para um pull request cujo código você não confia, [execute a revisão a partir de um branch em que você confia](https://code.claude.com/docs/pt/ultrareview.md#trust-the-folder-before-the-review-runs).
* Na sua própria máquina, execute `claude` nessa pasta e aceite a [caixa de diálogo de confiança do workspace](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust), e então execute seu comando original novamente

Em uma sessão, `/ultrareview` e `/code-review ultra` podem parar com `Ultrareview did not start: "<folder>" is not trusted, and this session started without asking whether you trust it`. Inicie `claude` nessa pasta sem [`IS_DEMO`](https://code.claude.com/docs/pt/env-vars#variables) definida, aceite a caixa de diálogo de confiança do workspace e execute o comando na nova sessão.

Cada uma destas mensagens de `claude ultrareview` significa que nenhuma revisão foi iniciada e o código de saída é 1:

* **`Error: Workspace not trusted. This terminal ...`**: o terminal não informou a contagem de linhas e colunas, ou não comporta a pergunta de confiança e seus avisos. Aumente-o ou use um terminal que informe seu tamanho e execute `claude ultrareview` novamente. Fora do seu diretório pessoal, você também pode executar `claude` nessa pasta uma vez e aceitar a caixa de diálogo de confiança, para que execuções posteriores ali não perguntem.
* **`Error: Workspace not trusted. <folder> is your home directory`**: como a confiança para seu diretório pessoal nunca é salva, executar `claude` ali primeiro não ajuda. Execute `claude ultrareview` a partir de um diretório de projeto, depois de executar `claude` ali uma vez para aceitar a caixa de diálogo de confiança, ou acrescente `--trust-workspace`.
* **`No answer in time.` seguido de `Error: Workspace not trusted`**: a pergunta `Trust <folder>? [y/N]` ficou sem resposta por 5 minutos. Execute `claude ultrareview` novamente e responda.
* **`Ultrareview did not start: <folder> is not trusted`**: você recusou na pergunta `Trust <folder>? [y/N]`, por exemplo respondendo `n` ou pressionando Enter. Para iniciar a revisão, execute `claude ultrareview` novamente e responda `y`.
* **``Ultrareview did not start: `--trust-workspace` takes no value``**: algo que não é uma flag vem depois de `--trust-workspace`, como um número de PR ou `false`. Se você não confia na pasta, omita a flag. Para confiar nela nesta execução, coloque o número do PR ou o branch base antes da flag: `claude ultrareview 1234 --trust-workspace`.

Antes da v2.1.309, `claude ultrareview` não aceitava `--trust-workspace`.

### O Remote Control não iniciou porque uma pergunta ficou sem resposta

Esta mensagem significa que [`claude remote-control`](https://code.claude.com/docs/pt/remote-control) fez a pergunta de primeira execução citada na mensagem e não obteve resposta:

```text theme={null}
Remote Control did not start: "Enable Remote Control?" got no answer. Run `claude remote-control` at a terminal and answer y once; it won't ask again.
Remote Control did not start: "Choose [1/2] (default: 1):" got no answer. You can run `claude remote-control` and choose, or pass --spawn=same-dir or --spawn=worktree.
```

**O que fazer:**

* **`Enable Remote Control?`**: em um script ou serviço, a entrada padrão termina antes que alguém possa responder. Execute `claude remote-control` uma vez em um terminal, como o usuário com o qual seu script ou serviço é executado, e responda `y`.
* **`Choose [1/2] (default: 1):`**: execute `claude remote-control` novamente e [escolha um modo de spawn](https://code.claude.com/docs/pt/remote-control.md#set-the-default-spawn-mode-for-a-project), ou passe [`--spawn=same-dir` ou `--spawn=worktree`](https://code.claude.com/docs/pt/remote-control#start-a-remote-control-session) para pular a pergunta

### Não repassado para as sessões que o Remote Control inicia

Você iniciou o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) com uma flag global de `claude` antes do verbo `remote-control`, uma que restringiria ou configuraria as sessões que o Remote Control inicia, como `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` ou `--mcp-config`. Uma flag colocada antes do verbo nunca chega a essas sessões. Em vez disso, o Claude Code se recusa a iniciar, nomeando a flag:

```text theme={null}
Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`). Pass settings with `claude remote-control --settings <file>`.
```

O Claude Code não recusa flags globais que são inofensivas de descartar, como `--verbose`, `--model` ou um `--session-id` ou `--plugin-dir` injetado por um wrapper: ele as ignora e o Remote Control inicia.

O Claude Code também se recusa a iniciar para uma flag global que ainda não reconhece como inofensiva, então uma flag adicionada em uma versão mais recente pode aparecer nesta mensagem até que uma versão posterior a marque como inofensiva.

**O que fazer:**

* Remova a flag de antes do verbo e passe as [próprias opções do Remote Control](https://code.claude.com/docs/pt/remote-control.md#start-a-remote-control-session) depois dele; `claude remote-control --help` as lista
* Quando a flag recusada for `--permission-mode`, execute `claude remote-control --permission-mode <mode>` para definir o modo de permissão das sessões que o Remote Control inicia

Antes da v2.1.248, `claude remote-control` não aceitava suas próprias flags quando uma flag global vinha primeiro, e o comando falhava com um erro `unknown option`.

### O Remote Control não iniciou por causa do arquivo de `--settings`

O arquivo que você passou para [`claude remote-control --settings`](https://code.claude.com/docs/pt/remote-control#start-a-remote-control-session) tem um problema:

```text theme={null}
Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON
```

**O que fazer:**

* Corrija o problema que a mensagem cita e execute seu comando `claude remote-control` novamente

### O arquivo de configurações mudou desde que o Remote Control foi iniciado

Esta mensagem no terminal que executa `claude remote-control` significa que as sessões não serão iniciadas a partir do arquivo que você passou para [`--settings`](https://code.claude.com/docs/pt/remote-control#start-a-remote-control-session) tal como ele está agora:

```text theme={null}
Session failed: Error: The settings file /path/to/settings.json has changed since Remote Control started, so this session did not start. Restart `claude remote-control` to use it as it is now.
```

**O que fazer:**

* Para usar o arquivo tal como está agora, interrompa `claude remote-control` e execute o mesmo comando novamente. Para recuperar as sessões que ele estava servindo, consulte [Resume sessions after stopping the server](https://code.claude.com/docs/pt/remote-control.md#resume-sessions-after-stopping-the-server).
* Para manter as configurações com as quais o Remote Control foi iniciado, restaure o conteúdo do arquivo como estava e execute o comando novamente se `claude remote-control` tiver saído

### `--sandbox` or `--no-sandbox` is not supported by claude remote-control

Este erro significa que o comando que inicia seu servidor de [Remote Control](https://code.claude.com/docs/pt/remote-control.md) passa `--sandbox` ou `--no-sandbox` depois de `remote-control`, e `claude remote-control` não aceita nenhuma dessas flags. O servidor sai com código 1 em vez de iniciar:

```text theme={null}
Error: --sandbox is not supported by claude remote-control. The flag had no effect and was removed. To sandbox sessions, set sandbox.enabled to true in settings.
Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.
```

**O que fazer:**

* Remova a flag do comando, inclusive em um script ou definição de serviço que inicia o servidor para você, e então execute-o novamente
* Para executar em sandbox as sessões que o servidor inicia, ative o [sandboxing](https://code.claude.com/docs/pt/sandboxing.md) definindo [`sandbox.enabled`](https://code.claude.com/docs/pt/settings-reference#sandbox-enabled) como `true` em um [arquivo de configurações](https://code.claude.com/docs/pt/settings.md#where-settings-live)

Ambas as flags foram removidas de `claude remote-control` na v2.1.300, então um comando escrito para uma versão anterior ainda pode conter uma delas.

### claude import ainda não está disponível neste build

Você executou [`claude import`](https://code.claude.com/docs/pt/cli-reference#cli-commands), e o Claude Code encontrou o fluxo de importação desativado, então o comando sai com código 1 em vez de iniciar a importação. Antes da v2.1.222, um build com o fluxo de importação desativado tratava `import` como um prompt e iniciava uma sessão interativa em vez de imprimir esta mensagem.

```text theme={null}
`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
```

O Claude Code ativa `claude import` por meio de uma feature flag que ele busca da Anthropic e armazena em cache no disco. Esta mensagem significa que o valor em cache está desativado. A causa geralmente é uma das seguintes:

* Você não iniciou uma sessão desde a instalação, então o Claude Code ainda não buscou a flag. O primeiro `claude import` pode imprimir isso mesmo quando o recurso está disponível para você.
* Você usa o Claude Code por meio do Amazon Bedrock, do Agent Platform do Google Cloud, do Microsoft Foundry ou do Claude Platform on AWS, ou por meio de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway#availability-and-limitations). O Claude Code não busca feature flags nessas sessões, então `claude import` permanece indisponível.
* Você definiu `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/pt/env-vars#variables), `DISABLE_GROWTHBOOK` ou [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/pt/env-vars), que desativam a busca de feature flags, então `claude import` permanece indisponível.

**O que fazer:**

* Em uma instalação nova, inicie `claude`, aguarde a sessão carregar, saia e execute `claude import` novamente
* Onde a busca de feature flags permanece desativada, faça a configuração você mesmo: adicione servidores MCP com [`claude mcp add`](https://code.claude.com/docs/pt/mcp#installing-mcp-servers) e crie os [arquivos `CLAUDE.md`](https://code.claude.com/docs/pt/memory#how-claude-md-files-load), as [skills e comandos](https://code.claude.com/docs/pt/skills.md#where-skills-live) e os [subagentes](https://code.claude.com/docs/pt/sub-agents.md#choose-the-subagent-scope) que você deseja transferir. A mensagem também nomeia `~/.claude/settings.json`. Da configuração que `claude import` transfere, esse arquivo contém apenas o [modo de permissão](https://code.claude.com/docs/pt/settings-reference.md#permission-settings); o Claude Code não lê servidores MCP dele.

### Não foi possível ler a configuração do Claude Code

Você executou [`claude import`](https://code.claude.com/docs/pt/cli-reference#cli-commands) enquanto o Claude Code não conseguia analisar `~/.claude.json`, o arquivo onde ele armazena os detalhes da sua conta e o estado de cada projeto. O subcomando lê esse arquivo para verificar a disponibilidade, mas não mostra a caixa de diálogo de recuperação que a sessão interativa mostra, então sai com código 1. Antes da v2.1.222, `claude import` com um arquivo de configuração ilegível iniciava uma sessão interativa, cuja caixa de diálogo de recuperação tratava o arquivo.

```text theme={null}
Could not read Claude Code config — run `claude` with no arguments to recover it.
```

**O que fazer:**

* Execute `claude` sem argumentos. O Claude Code detecta o arquivo inválido e oferece redefini-lo. Em seguida, execute `claude import` novamente.
* Para manter edições manuais que você fez, corrija a sintaxe JSON em `~/.claude.json` em um editor e execute `claude import` novamente

### Não foi possível importar um servidor do Claude Desktop

O Claude Code não conseguiu adicionar um dos servidores que você selecionou em `claude mcp add-from-claude-desktop`. O comando ainda importa os outros servidores selecionados e imprime uma linha para cada servidor que não conseguiu adicionar. Antes da v2.1.205, o primeiro servidor que falhava interrompia a importação.

```text theme={null}
Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
```

O texto após o nome do servidor é o motivo. O mais comum é a verificação de nome: o Claude Desktop permite caracteres em nomes de servidor, como espaços e pontos, que `claude mcp` restringe a letras, números, hífens e sublinhados. Outros motivos incluem uma configuração de servidor que falha na validação e um servidor bloqueado pela [política de MCP](https://code.claude.com/docs/pt/managed-mcp.md) da sua organização.

**O que fazer:**

* Renomeie o servidor em `claude_desktop_config.json` para usar apenas letras, números, hífens e sublinhados e execute `claude mcp add-from-claude-desktop` novamente
* Adicione esse servidor diretamente com `claude mcp add` ou `claude mcp add-json` com um nome válido. Consulte [Importar servidores MCP do Claude Desktop](https://code.claude.com/docs/pt/mcp.md#import-mcp-servers-from-claude-desktop).

### Não é possível adicionar o servidor MCP ao escopo gerenciado

Você executou `claude mcp add` ou `claude mcp add-json` com `--scope managed`. Esse escopo contém os servidores que sua organização fornece por meio da configuração gerenciada [`managedMcpServers`](https://code.claude.com/docs/pt/settings-reference#managedmcpservers). O Claude Code os lê apenas das configurações gerenciadas, então o comando não pode gravar um servidor nesse escopo.

```text theme={null}
Cannot add MCP server to scope: managed
```

**O que fazer:**

* Adicione o servidor a um escopo em que você possa gravar: `local`, `user` ou `project`. Sem `--scope`, o comando usa `local`. Consulte [Escopos de instalação do MCP](https://code.claude.com/docs/pt/mcp.md#mcp-installation-scopes)
* Para fornecer o servidor a todos os usuários da sua organização, adicione-o a [`managedMcpServers`](https://code.claude.com/docs/pt/settings-reference#managedmcpservers) nas configurações gerenciadas que você implanta

### Não é possível adicionar o servidor MCP quando as configurações gerenciadas permitem apenas servidores de plugins

Você executou `claude mcp add` ou `claude mcp add-json` enquanto as configurações gerenciadas da sua organização definem [`strictPluginOnlyCustomization`](https://code.claude.com/docs/pt/settings-reference#strictpluginonlycustomization) como `true` ou como uma lista que inclui `mcp`. Com essa configuração, o Claude Code não carrega servidores MCP de `~/.claude.json` ou `.mcp.json`, então o comando sai com código 1 em vez de salvar um servidor que nunca seria carregado:

```text theme={null}
Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.
```

`claude mcp add-from-claude-desktop` relata cada servidor que você seleciona como não importado, com esta mensagem como motivo. [`/import`](https://code.claude.com/docs/pt/commands#all-commands) relata esta mensagem para cada servidor MCP que tenta adicionar e ainda importa os outros itens que encontrou.

Antes da v2.1.284, esses comandos salvavam o servidor e relatavam sucesso, e o servidor nunca era carregado.

**O que fazer:**

* Instale um [plugin](https://code.claude.com/docs/pt/plugins/install.md) que forneça o servidor
* Peça ao seu administrador para distribuir o servidor em um [plugin](https://code.claude.com/docs/pt/plugins/org.md), ou para fornecê-lo por meio de [`managedMcpServers`](https://code.claude.com/docs/pt/settings-reference#managedmcpservers) se for um servidor HTTP ou SSE remoto

### Não é possível ler .mcp.json

Um comando que lê o [`.mcp.json`](https://code.claude.com/docs/pt/mcp#project-scope) do projeto, como `claude mcp add` ou `claude mcp add-json` com `--scope project`, ou `claude mcp remove`, descobriu que o arquivo no seu diretório atual não é um arquivo regular ou é maior que 2 MiB, então sai com este erro em vez de ler o arquivo.

```text theme={null}
Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.
```

Antes da v2.1.257, um FIFO em `.mcp.json` deixava o comando esperando para sempre sem saída, e um link simbólico para um arquivo de dispositivo como `/dev/zero` fazia a memória crescer até o processo ser encerrado.

**O que fazer:**

* Verifique o que está em `.mcp.json` no seu diretório atual. Substitua-o por um arquivo JSON comum no [formato de escopo de projeto](https://code.claude.com/docs/pt/mcp.md#project-scope), ou exclua-o, e então execute o comando novamente.

### O servidor MCP não foi salvo ou removido

Este erro significa que um comando como `claude mcp add` ou `claude mcp remove` não conseguiu gravar sua alteração em `~/.claude.json`. Outros processos do Claude Code podem ter mantido o arquivo bloqueado, ou o arquivo pode ser somente leitura ou estar protegido por um sandbox.

```text theme={null}
MCP server "example" was not saved to /home/user/.claude.json. If other Claude Code processes use that file, they may have kept it locked: add the server again, with CLAUDE_CODE_CONFIG_LOCK_WAIT_MS=60000 set to wait up to a minute. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox first.
```

Depois de uma remoção, a mensagem diz `was not removed from` no lugar de `was not saved to`, e `remove the server again` no lugar de `add the server again`. Para um servidor de escopo `local`, o caminho é seguido pelo diretório do projeto ao qual a entrada pertence, como `(local scope for /path/to/project)`.

**O que fazer:**

* **Outros processos do Claude Code estão em execução**: o comando espera cerca de 10 a 20 segundos pelo bloqueio do arquivo e então desiste sem gravar. Execute o mesmo comando novamente com [`CLAUDE_CODE_CONFIG_LOCK_WAIT_MS`](https://code.claude.com/docs/pt/env-vars#variables) definida para uma espera mais longa em milissegundos, como `60000`.
* **O arquivo é somente leitura ou está protegido por sandbox**: torne gravável o arquivo citado na mensagem e execute o mesmo comando de adição ou remoção novamente, ou execute esse comando fora do sandbox.

Antes da v2.1.283, `claude mcp add`, `claude mcp add-json` e `claude mcp remove` informavam sucesso mesmo quando a alteração não chegava ao arquivo. Antes da v2.1.318, a mensagem não mencionava o bloqueio, e o Claude Code não lia [`CLAUDE_CODE_CONFIG_LOCK_WAIT_MS`](https://code.claude.com/docs/pt/env-vars#variables).

### O servidor MCP pode não ter sido salvo ou removido

Você executou `claude mcp add`, `claude mcp add-json` ou `claude mcp remove` para um servidor no [escopo](https://code.claude.com/docs/pt/mcp.md#mcp-installation-scopes) `user` ou `local`, e o Claude Code não conseguiu ler `~/.claude.json` de volta para confirmar a alteração. A alteração pode ou não estar no disco. Os parênteses após `to confirm the change` informam o motivo.

```text theme={null}
MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.
```

Depois de uma remoção, a mensagem diz `may not have been removed` e termina com `then remove the server again if it is still listed`. Se o motivo for `the file was not found`, o servidor ainda pode estar configurado.

Antes da v2.1.283, os comandos relatavam sucesso mesmo quando a alteração não podia ser confirmada.

**O que fazer:**

* Execute `claude mcp get <name>` para verificar se a alteração está no disco. Para um servidor de escopo `local`, execute-o a partir do diretório do projeto ao qual o servidor pertence, já que o escopo local é por projeto.
* Se o servidor estiver ausente após uma adição, ou ainda listado após uma remoção, execute o mesmo comando de adição ou remoção novamente.

### O servidor é hospedado pela Anthropic e não oferece suporte a OAuth local

Você iniciou um login para um servidor MCP cuja URL aponta para um host de conector hospedado pela Anthropic que se autentica por meio de um provedor de identidade de terceiros. Esses hosts incluem `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` e `gcal.mcp.claude.com`. O Claude Code se recusa a iniciar seu fluxo OAuth local para esses hosts tanto no painel `/mcp` quanto em `claude mcp login`, porque [o login deles funciona apenas por meio do claude.ai](https://code.claude.com/docs/pt/mcp.md#use-mcp-servers-from-claude-ai).

```text theme={null}
"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.
```

**O que fazer:**

* Remova sua entrada com `claude mcp remove <name>`, para que ela não possa ocultar o conector do claude.ai na mesma URL
* Depois de removê-la, conecte o serviço em [claude.ai/customize/connectors](https://claude.ai/customize/connectors), com login feito na conta que você usa no Claude Code. Uma vez conectado, [o conector aparece automaticamente no Claude Code](https://code.claude.com/docs/pt/mcp.md#use-mcp-servers-from-claude-ai) se o seu método de autenticação ativo for um login de assinatura do claude.ai

### O servidor rejeitou o cabeçalho Authorization gerado pelo headersHelper configurado

Um servidor MCP cujo [`headersHelper`](https://code.claude.com/docs/pt/mcp#use-dynamic-headers-for-custom-authentication) fornece o cabeçalho `Authorization` respondeu à conexão com HTTP 401 ou 403, então o Claude Code relata a conexão como falha. Como o helper fornece o cabeçalho `Authorization`, o Claude Code [não recorre ao OAuth](https://code.claude.com/docs/pt/mcp.md#authenticate-with-remote-mcp-servers) para o servidor:

```text theme={null}
Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.
```

O Claude Code executa o helper novamente a cada tentativa de conexão, então uma nova tentativa após uma rejeição transitória, como uma condição de corrida na rotação de token, pode ter sucesso com uma credencial nova.

**O que fazer:**

* Execute o comando `headersHelper` você mesmo da maneira como o Claude Code o executa: a partir do [diretório em que o Claude Code o executa](https://code.claude.com/docs/pt/mcp.md#where-the-helper-runs), com as [variáveis de ambiente que o Claude Code define para ele](https://code.claude.com/docs/pt/mcp.md#use-dynamic-headers-for-custom-authentication) e sem as [variáveis de credencial que o Claude Code remove](https://code.claude.com/docs/pt/mcp.md#which-variables-a-helper-can-read) para um servidor de um `.mcp.json` de projeto, de um plugin ou de um arquivo de agente de projeto. Verifique se ele imprime um valor de `Authorization` que o endpoint do servidor aceita
* Depois de corrigir o helper ou sua fonte de credenciais, selecione o servidor em `/mcp` e escolha **Reconnect**

Antes da v2.1.248, o Claude Code executava a descoberta OAuth para um servidor cujo helper fornecia o cabeçalho `Authorization`. Essa descoberta podia falhar com `Incompatible auth server: does not support dynamic client registration` em vez de relatar a credencial rejeitada.

### O servidor MCP rejeitou a capacidade de elicitation

Um servidor MCP construído com o Java MCP SDK 0.11.0 a 0.17.0 recusou a conexão. Essas versões do SDK não conseguem analisar os [modos de elicitação](https://code.claude.com/docs/pt/mcp.md#elicitation-modes-claude-code-declares) `form` e `url` que o Claude Code declara em seu handshake. A mensagem diz:

```text theme={null}
This server (Java MCP SDK 0.17.0 or older) rejected Claude Code's elicitation capability. Set "bareElicitationCapability": true for it, or upgrade to Java MCP SDK 0.17.1+ (Spring AI 1.0.7+ or 1.1.6+).
```

**O que fazer:**

* Atualize o servidor para o Java MCP SDK 0.17.1 ou posterior, ou para uma das versões do Spring AI indicadas na mensagem
* Ou adicione `"bareElicitationCapability": true` à entrada desse servidor na sua configuração de MCP e reinicie o Claude Code. O campo é aceito em entradas stdio, `sse`, `http` e `ws` e requer o Claude Code v2.1.281 ou posterior

Esta entrada de `.mcp.json` define o campo para um servidor HTTP:

```json theme={null}
{
  "mcpServers": {
    "inventory": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "bareElicitationCapability": true
    }
  }
}
```

Após a reinicialização, `/mcp` mostra o servidor como conectado. O Claude Code declara o modo form somente para esse servidor, então remova o campo assim que atualizá-lo.

Um servidor também pode falhar com seu próprio texto de erro, como um contendo `Unrecognized field "form"`. As mesmas correções se aplicam.

### Ferramenta de prompt de permissão MCP não encontrada

A ferramenta que você passou para [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags) não estava entre as ferramentas MCP conectadas quando a execução precisou pela primeira vez de uma decisão de permissão, seja porque seu servidor nunca se conectou, seja porque nenhum servidor conectado expõe uma ferramenta com esse nome. O Claude Code ainda envia seu prompt: a execução [não interativa](https://code.claude.com/docs/pt/headless.md) sai com este erro, e código de saída 1, na primeira chamada de ferramenta, então não produz nenhuma resposta mesmo que a requisição tenha sido feita. Antes do primeiro prompt, o Claude Code aguarda até o timeout de conexão por servidor de 30 segundos, definido por [`MCP_TIMEOUT`](https://code.claude.com/docs/pt/env-vars), para que esse servidor se conecte. Antes da v2.1.206, a inicialização não esperava o servidor terminar de se conectar, então um servidor saudável, mas lento para iniciar, também produzia este erro.

```text theme={null}
Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
```

A lista após `Available MCP tools:` nomeia as ferramentas MCP que estavam conectadas.

**O que fazer:**

* Verifique se o servidor inicia e permanece conectado: execute `claude mcp list` no mesmo diretório e confirme se o servidor está listado como conectado
* Confirme se o nome da ferramenta corresponde ao nome `mcp__<server>__<tool>` que o servidor expõe
* Se o servidor precisar de mais de 30 segundos para iniciar, aumente [`MCP_TIMEOUT`](https://code.claude.com/docs/pt/env-vars)

### A porta de callback do OAuth já está em uso

Quando você faz login em um servidor MCP remoto com OAuth, o Claude Code inicia um listener local para receber o callback de login. Se a porta de que esse listener precisa estiver ocupada por outro processo, o login falha com esta mensagem. Isso acontece principalmente com uma [porta de callback fixa](https://code.claude.com/docs/pt/mcp.md#use-a-fixed-oauth-callback-port) definida por meio da variável [`MCP_OAUTH_CALLBACK_PORT`](https://code.claude.com/docs/pt/env-vars) ou de `--callback-port`, já que, sem ela, o Claude Code escolhe uma porta disponível.

```text theme={null}
OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
```

No Windows, o comando sugerido é `netstat -ano | findstr :<port>`.

**O que fazer:**

* Execute o comando da mensagem para encontrar o processo que ocupa a porta, e encerre-o ou espere que ele termine
* Se outro programa precisar dessa porta permanentemente, registre um URI de redirecionamento diferente no servidor e defina sua porta com `MCP_OAUTH_CALLBACK_PORT` ou `--callback-port`, o que você usar
* Em seguida, inicie o login novamente, por exemplo selecionando o servidor em `/mcp`

### Nenhuma porta disponível para o redirecionamento do OAuth

Quando você faz login em um servidor MCP remoto com [OAuth](https://code.claude.com/docs/pt/mcp.md#authenticate-with-remote-mcp-servers), o Claude Code inicia um listener local para receber o callback de login. O login falha com esta mensagem quando o Claude Code não consegue vincular uma porta local para ele. Algo na máquina está impedindo que ele escute em `127.0.0.1`, por exemplo um software de segurança ou uma política de sandbox que nega listeners locais.

```text theme={null}
No available ports for OAuth redirect
```

Antes da v2.1.268, o Claude Code não recorria a uma porta atribuída pelo sistema operacional, então a mensagem também aparecia quando apenas as portas escolhidas por ele mesmo não podiam ser vinculadas. Isso pode acontecer em hosts Windows onde o Hyper-V reserva intervalos de portas que cobrem as portas das quais o Claude Code escolhe.

**O que fazer:**

* Verifique se um software de segurança ou uma política de sandbox impede que processos escutem em `127.0.0.1`, e permita que o Claude Code vincule uma porta local
* Em seguida, inicie o login novamente, por exemplo selecionando o servidor em `/mcp`

### /security-review falha sem origin/HEAD

[`/security-review`](https://code.claude.com/docs/pt/commands#all-commands) constrói seu contexto de revisão fazendo o diff do seu branch em relação a `origin/HEAD`, a ref local que registra qual branch é o padrão no seu remote `origin`. Quando essa ref não existe, os comandos git que coletam o diff falham e a revisão para antes de começar.

```text theme={null}
Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
fatal: ambiguous argument 'origin/HEAD...': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'
```

A mensagem pode citar `git log` ou um `git diff` diferente. O Git cria `origin/HEAD` somente quando o remote anuncia um branch padrão e seu refspec de fetch o cobre, o que acontece com um `git clone` completo de um remote com commits. A ref está ausente nestas configurações:

* Um checkout de branch único ou de CI, que faz fetch de um refspec estreito demais
* Um remote cujo HEAD do lado do servidor aponta para um branch que ninguém enviou
* Um repositório sem remote `origin`, ou um do qual você nunca fez fetch

O Claude Code mostra o mesmo erro para qualquer skill que [injeta contexto dinâmico](https://code.claude.com/docs/pt/skills.md#when-an-injected-command-fails), e um comando injetado que falha aborta a invocação dessa skill.

Mensagens semelhantes são disparadas antes mesmo de o comando ser executado:

* `Shell command permission check failed for pattern "..."`: a verificação de permissão do comando não o permitiu. Consulte [Verificações de permissão em comandos injetados](https://code.claude.com/docs/pt/skills.md#permission-checks-on-injected-commands) para saber quais resultados abortam em cada modo de permissão e quando `allowed-tools` pré-aprova um comando
* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: o frontmatter da skill exige bash em uma máquina que não o tem. Instale o Git for Windows ou altere o frontmatter para `shell: powershell`. Consulte [Como os comandos injetados são executados](https://code.claude.com/docs/pt/skills.md#how-injected-commands-run)

**O que fazer:**

* Crie a ref nomeando o branch padrão do seu remote: `git remote set-head origin <default-branch>`. Isso funciona sempre que a ref de rastreamento local `origin/<default-branch>` existe. Se ela não existir, como em clones de branch único, faça primeiro o fetch do branch: execute `git remote set-branches --add origin <branch>`, depois `git fetch origin` e, em seguida, execute novamente o comando set-head. Execute `/security-review` novamente.
* Se preferir não nomear o branch, execute `git fetch origin` e depois `git remote set-head origin --auto`, que pergunta ao remote qual branch é o padrão. Ele falha com `error: Cannot determine remote HEAD` quando o remote não anuncia nenhum branch padrão, porque está vazio ou seu HEAD aponta para um branch que ninguém enviou; nesse caso, nomeie o branch explicitamente. Ele falha com `error: Not a valid ref` quando seu clone não faz fetch desse branch; amplie o refspec como acima primeiro.
* Se o repositório não tiver remote, adicione um com `git remote add origin <url>` e faça fetch antes de criar a ref. Se o remote estiver vazio, envie primeiro seu branch com `git push -u origin HEAD` e nomeie esse branch no comando set-head; `origin/HEAD` então aponta para o branch que você acabou de enviar, então `/security-review` vê um diff vazio até que o branch divirja dele.

### No shell command in a skill or command was run

`No shell command in <name> was run` significa que um [comando de contexto dinâmico](https://code.claude.com/docs/pt/skills.md#inject-dynamic-context) `` !`<command>` `` nesse arquivo de skill ou de comando contém um caractere que a ferramenta Bash ou PowerShell recusa:

* **Qualquer uma das ferramentas**: um caractere de controle bruto diferente de tabulação ou nova linha
* **Ferramenta PowerShell**: também U+FEFF ou U+180E

A mensagem termina com o comando recusado, mostrando cada caractere recusado como `�`, como neste exemplo da ferramenta Bash:

```text theme={null}
No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as � below: remove them from the skill or command file, or from the arguments or options substituted into it.
build.sh --target�dist
```

**O que fazer:**

* Encontre cada `�` no comando citado no final da mensagem. Remova o caractere que ele representa do [arquivo de skill ou de comando](https://code.claude.com/docs/pt/skills.md#where-skills-live), ou dos argumentos ou [opções](https://code.claude.com/docs/pt/plugins/manifest-reference.md#user-configuration) substituídos no arquivo.

### Skill, comando ou hook acima do limite de 4.000.000 caracteres

Uma mensagem com `more than 4,000,000 characters` significa que uma skill, um comando ou um [hook de prompt ou de agente](https://code.claude.com/docs/pt/hooks.md#prompt-and-agent-hook-fields) não foi executado. Se você colou um texto longo como argumentos, salve-o em um arquivo, execute `/clear`, já que o texto permanece na conversa, e então passe o caminho do arquivo. Fora do [Code Mode](https://code.claude.com/docs/pt/code-mode.md#tool-call-refused-by-a-hook), um hook de prompt ou de agente `PreToolUse` acima do limite não bloqueia a chamada. Use um [hook de comando](https://code.claude.com/docs/pt/hooks.md#command-hook-fields), que não tem esse limite.

### É necessário fornecer uma entrada ao usar `--print`

O `claude` sem argumentos precisa que o stdout seja um terminal para iniciar a interface interativa. Quando o stdout é redirecionado, ou o console não é um terminal real, como o PowerShell ISE e alguns painéis de saída de IDE, `claude` é executado de forma [não interativa](https://code.claude.com/docs/pt/headless.md). Esse é o mesmo modo de `claude -p`, que exige um prompt, então a mensagem nomeia `--print` mesmo quando você não passou a flag. Passar `-p`/`--print` sem prompt e sem nada enviado via pipe no stdin produz o mesmo erro em qualquer lugar.

```text theme={null}
Error: Input must be provided either through stdin or as a prompt argument when using --print
```

**O que fazer:**

* Para uso interativo, execute `claude` em um terminal real: o Windows Terminal ou o console do PowerShell em vez do ISE, e o terminal integrado da sua IDE em vez de um painel de saída
* Para uso pontual, passe o prompt: `claude -p "your question"`, ou envie-o via pipe com `echo "your question" | claude -p`

### O Claude Code não consegue ler o teclado aqui

Você executou `claude` sem [`-p`](https://code.claude.com/docs/pt/headless), o que inicia uma [sessão interativa](https://code.claude.com/docs/pt/interactive-mode.md), mas sua entrada padrão não é um terminal. Algo a conectou a um pipe ou a redirecionou, ou o programa que iniciou `claude` forneceu seu próprio fluxo de entrada.

Uma sessão interativa precisa de um terminal de onde ler suas teclas, e o que o Claude Code faz sem um depende da sua plataforma:

* **Windows**: o Claude Code imprime a mensagem no stderr e sai com código 1 em vez de iniciar a interface
* **macOS e Linux**: o Claude Code lê suas teclas de `/dev/tty` e inicia a sessão, com qualquer texto enviado via pipe como seu primeiro prompt. Você vê a mensagem quando `/dev/tty` não pode ser aberto, e sua primeira linha nomeia `/dev/tty` no lugar do texto do Windows.

No Windows, a mensagem diz:

```text theme={null}
Claude Code can't read the keyboard here: stdin is not a terminal (it is piped, redirected, or supplied by the program that launched claude), and on Windows it can't fall back to the console for input yet.
Run claude directly in Windows Terminal, PowerShell, or Command Prompt, without piping or redirecting its input.
To send text as a prompt and print the reply instead, add -p; it also works with --continue and --resume <session-id> (for example: type notes.md | claude -p --continue).
```

**O que fazer:**

* Para trabalhar de forma interativa, execute `claude` diretamente em um terminal, sem conectar sua entrada a um pipe nem redirecioná-la
* Para obter uma resposta sem a interface interativa, por exemplo a partir de um script, adicione `-p` e forneça o prompt como argumento ou no stdin, como em `claude -p "your question"` ou `echo "your question" | claude -p`. O mesmo funciona com `--continue` e `--resume <session-id>`.

Antes da v2.1.287, o Claude Code iniciava a interface em vez de imprimir esta mensagem e, então, não mostrava nada na tela ou falhava com um erro contendo `Raw mode is not supported`.

Se, em vez disso, você vir `Raw mode is not supported` durante `claude install`, consulte [`Raw mode is not supported` durante a instalação](https://code.claude.com/docs/pt/troubleshoot-install#raw-mode-is-not-supported-during-install).

### A entrada continha apenas espaços em branco

No [modo não interativo](https://code.claude.com/docs/pt/headless.md), o Claude Code recusa um prompt composto inteiramente de espaços, tabulações ou quebras de linha em vez de enviá-lo, porque a API rejeita mensagens sem texto visível. A mensagem que você vê depende de onde veio o prompt em branco:

* **Argumento de prompt ou stdin enviado via pipe para `claude -p`**: `claude` sai com `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`
* **Mensagem enviada para uma sessão `--input-format stream-json` ou do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md) em execução**: o Claude Code encerra o turno sem chamar o modelo e a sessão continua utilizável. A recusa chega como uma mensagem informativa e como o texto de resultado do turno: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`

Antes da v2.1.229, o Claude Code enviava a mensagem composta apenas de espaços em branco para a API, que rejeitava a requisição com um erro 400.

**O que fazer:**

* Inclua texto visível no prompt. Se um script constrói o prompt a partir de uma variável ou arquivo, verifique se a origem não está vazia antes de chamar o Claude Code.

### A entrada stream-json trouxe mais de 256M caracteres sem quebra de linha

Seu programa enviou mais de 268.435.456 caracteres no stdin sem uma quebra de linha para uma execução `claude -p --input-format stream-json`, então o Claude Code imprime este erro no stderr e sai com código 1 em vez de armazenar mais entrada em buffer. A mensagem expressa esse limite como `256M`. Antes da v2.1.257, o Claude Code armazenava essa entrada em buffer sem limite, aumentando a memória até o processo travar ou ser encerrado.

```text theme={null}
Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.
```

Uma entrada tão longa sem quebra de linha geralmente significa que o produtor nem é um produtor stream-json, como um arquivo binário ou uma saída de log em texto simples enviada via pipe por engano. Uma única mensagem acima do limite falha na mesma verificação.

**O que fazer:**

* Verifique o que está sendo enviado via pipe para o stdin. Com [`--input-format stream-json`](https://code.claude.com/docs/pt/cli-reference#cli-flags), cada mensagem deve ser uma linha JSON terminada por quebra de linha
* Para enviar texto simples, remova `--input-format stream-json`; `claude -p` lê um prompt de texto simples do stdin por padrão

### Comando desconhecido

Em uma sessão de terminal interativa, você enviou um nome com `/` que não corresponde a nenhum comando nesta sessão, então o Claude Code relata o nome em vez de executar algo:

```text theme={null}
Unknown command: /hepl. Did you mean /help?
```

O 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:

* Um erro de digitação, como `/hepl` em vez de `/help`. [Como o menu de comandos corresponde ao que você digita](https://code.claude.com/docs/pt/commands.md#how-the-command-menu-matches-what-you-type) explica como escolher uma correspondência próxima antes de enviar
* 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`](https://code.claude.com/docs/pt/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command), [`/schedule`](https://code.claude.com/docs/pt/routines#schedule-returns-unknown-command) ou [`/auto-mode-setup`](https://code.claude.com/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)
* Um comando de um [plugin](https://code.claude.com/docs/pt/plugins/overview.md) ou [servidor MCP](https://code.claude.com/docs/pt/mcp.md#use-mcp-prompts-as-commands) que não está instalado ou conectado nesta sessão

O 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:

* Execuções com `-p`
* Aplicações do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md)
* A aba Code do [aplicativo Desktop](https://code.claude.com/docs/pt/desktop.md)
* O painel de chat da [extensão do VS Code](https://code.claude.com/docs/pt/vs-code.md)
* [Sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) e [tarefas agendadas na nuvem](https://code.claude.com/docs/pt/routines.md)

Para um comando integrado que não pode ser executado em uma dessas sessões, o Claude Code ainda responde que o comando não está disponível em vez de enviá-lo ao Claude. Antes da v2.1.274, somente sessões na nuvem e tarefas agendadas na nuvem enviavam um nome sem correspondência ao Claude. Antes da v2.1.273, elas também respondiam `Unknown command`.

O Claude Code não trata todo prompt que começa com `/` como um comando. Ele envia o prompt ao Claude como uma mensagem normal quando a primeira palavra após a `/` começa com pontuação, como o `/--` que abre um comentário de documentação do Lean, ou é um caminho como `/var/log/syslog`.

Antes da v2.1.236, se você pressionasse `Enter` enquanto o menu de comandos listava uma correspondência próxima para o nome digitado, o Claude Code executava essa correspondência, então um erro de digitação como `/hepl` executava `/help` em vez de produzir esta mensagem.

**O que fazer:**

* Execute o nome sugerido, ou digite `/` seguido de parte do nome para ver o que está disponível nesta sessão
* Se o Claude Code relatar um comando documentado como desconhecido, verifique sua linha na [referência de comandos](https://code.claude.com/docs/pt/commands.md) para ver o requisito que ela nomeia

### O diff é grande demais para o ultrareview

O diff entre seu branch e o branch base, incluindo alterações não commitadas e preparadas (staged), excede os limites de tamanho de um [ultrareview](https://code.claude.com/docs/pt/ultrareview.md), então `/code-review ultra` e o subcomando `claude ultrareview` recusam a revisão antes de a sessão na nuvem ser iniciada. Uma revisão recusada não consome uma execução gratuita e não cobra créditos de uso. A mensagem nomeia os limites em vigor, o tamanho do seu diff e os arquivos que mais contribuem com linhas alteradas. Antes da v2.1.216, a mensagem mostrava apenas as estatísticas brutas do diff.

```text theme={null}
Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.
```

Revisar um pull request aplica os mesmos limites; essa forma da mensagem começa com `PR #<N> is too large for ultrareview` e nomeia as contagens de arquivos e linhas do PR.

**O que fazer:**

* Passe um branch base mais próximo do seu trabalho, como `/code-review ultra develop`, para que a revisão cubra apenas o diff em relação a esse branch
* Divida a alteração em branches menores e revise cada um. Os arquivos que a mensagem nomeia são os que mais contribuem com linhas alteradas, então comece movendo-os para um branch próprio.

### Não foi possível encontrar o merge-base com o branch base

`/code-review ultra` e o subcomando `claude ultrareview` revisam o diff entre seu branch e um branch base, o que requer um commit que os dois compartilham. Quando `git merge-base` não encontra nenhum, o Claude Code recusa a revisão antes de a sessão na nuvem ser iniciada. Em um clone que o Claude Code consegue verificar como completo, com pelo menos um branch, ele recorre a [revisar todos os arquivos rastreados](https://code.claude.com/docs/pt/ultrareview.md#diff-limits-and-fallbacks) em vez de recusar. Você vê esta recusa quando o branch base não pode ser encontrado de forma alguma, quando o Claude Code não consegue verificar se seu clone está completo, ou no raro repositório em que o diff da árvore inteira não é possível, como no formato de objeto SHA-256.

```text theme={null}
Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.
```

A dica após a primeira frase depende do que o Claude Code observou:

* **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
* **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>`)``
* **Você passou um branch base que não estava no seu clone**: o Claude Code o buscou do origin antes de comparar. A dica diz ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando o Claude Code não consegue determinar se seu clone é raso (shallow), ele sugere `git fetch --unshallow origin` em vez disso. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para todo branch base buscado, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.

**O que fazer:**

* Se outro branch for sua base real, passe-o explicitamente: `/code-review ultra <branch>`
* Se seu clone talvez não tenha o histórico completo, execute `git fetch --unshallow origin` e execute a revisão novamente

### Seu checkout não tem branches

Um checkout pode ter commits, mas nenhum branch: se você executar `git init` seguido de `git fetch <url>` e `git checkout FETCH_HEAD`, você obtém um HEAD destacado (detached) sem refs. O Claude Code empacota seu repositório como um bundle git para enviá-lo para um [ultrareview](https://code.claude.com/docs/pt/ultrareview.md), e não consegue empacotar um repositório que não tem branches nem outras refs, então `/code-review ultra` e o subcomando `claude ultrareview` recusam a revisão antes de a sessão na nuvem ser iniciada.

```text theme={null}
Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.
```

Antes da v2.1.221, o Claude Code tentava revisar todos os arquivos rastreados neste checkout, e o envio falhava.

**O que fazer:**

* Crie um branch no seu commit atual com `git checkout -b <name>` e execute a revisão novamente

### Nenhuma conta do GitHub está conectada à sua conta Claude

Você executou `/code-review ultra <PR#>` ou `claude ultrareview <PR#>` e, antes de criar a sessão na nuvem, o Claude Code pergunta ao servidor se [a conta do GitHub conectada à sua conta Claude](https://code.claude.com/docs/pt/ultrareview.md#review-a-pull-request) consegue acessar o repositório do PR. Nenhuma conta está conectada, ou a conexão expirou, então o clone na nuvem falharia e o Claude Code recusa a inicialização. O Claude Code não consome uma execução gratuita nem cobra créditos de uso por uma inicialização recusada.

```text theme={null}
Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).
```

Quando [`/web-setup`](https://code.claude.com/docs/pt/web-quickstart#connect-from-your-terminal) não está disponível na sua sessão, a mensagem nomeia apenas o link do claude.ai.

**O que fazer:**

* Execute `/web-setup` para conectar seu login da CLI do GitHub à sua conta Claude, ou conecte uma conta em [claude.ai/connect-github](https://claude.ai/connect-github)
* Execute a revisão novamente um minuto após conectar

Antes da v2.1.248, o Claude Code não verificava isso antes da inicialização.

### Sua conta do GitHub conectada não consegue ver o repositório

Você executou `/code-review ultra <PR#>` ou `claude ultrareview <PR#>`, e [a conta do GitHub conectada à sua conta Claude](https://code.claude.com/docs/pt/ultrareview.md#review-a-pull-request) não consegue ler o repositório do PR, então o clone na nuvem falharia e o Claude Code recusa a inicialização. O Claude Code não consome uma execução gratuita nem cobra créditos de uso por uma inicialização recusada.

```text theme={null}
Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.
```

Quando [`/web-setup`](https://code.claude.com/docs/pt/web-quickstart#connect-from-your-terminal) não está disponível na sua sessão, a mensagem nomeia apenas a instalação do aplicativo.

**O que fazer:**

* Se sua CLI `gh` local consegue ler o repositório, execute `/web-setup` para conectar esse login à sua conta Claude
* Execute a revisão novamente após a alteração

Antes da v2.1.248, o Claude Code não verificava isso antes da inicialização.

### A verificação prévia do GitHub App falhou de forma transitória

Você iniciou uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) a partir de um repositório local, e duas etapas falharam juntas. O Claude Code não conseguiu criar ou enviar o bundle do seu repositório. Antes do envio, ele verificou se o serviço na nuvem consegue clonar o repositório do GitHub e, em vez de uma resposta definitiva, essa verificação terminou em um erro que uma nova tentativa poderia resolver, como um erro de rede, um timeout ou um erro temporário do servidor. A mensagem completa começa com o que impediu o bundle, por exemplo `Could not upload repo bundle (<error>)`, e termina com a frase da verificação prévia:

```text theme={null}
Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
```

**O que fazer:**

* Execute o comando novamente após um momento. Quando a verificação do GitHub for aprovada, o Claude Code poderá iniciar a sessão a partir de um clone do GitHub, então o envio com falha deixa de bloquear a inicialização
* Se as novas tentativas continuarem falhando, o início da mensagem nomeia o que impediu o envio. Quando essa causa for algo que você possa corrigir, corrija-a para que a sessão possa ser iniciada a partir do seu repositório local

Antes da v2.1.251, o Claude Code terminava a mensagem com `Please set up GitHub on https://claude.ai/code` mesmo quando a verificação do GitHub falhava apenas de forma transitória, e conselhos de configuração não resolvem uma falha transitória.

### O envio do repositório não consegue seguir uma configuração do git

Você iniciou uma [sessão na nuvem que envia seu repositório local](https://code.claude.com/docs/pt/claude-code-on-the-web.md#send-local-repositories-without-github), ou um [ultrareview](https://code.claude.com/docs/pt/ultrareview.md) de um branch, e o envio não consegue seguir uma das configurações do git que decidem quais regras de atributos se aplicam aos seus arquivos. Se o envio prosseguisse e deixasse de aplicar uma regra, um arquivo que o git transforma antes de armazenar, como um que um filtro clean criptografa, poderia chegar à nuvem como está no disco. Em vez disso, o Claude Code recusa o envio, e nada é enviado:

```text theme={null}
Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.
```

A mensagem nomeia a configuração e onde ela está definida, e termina com a correção para o caso que você encontrou. A mesma recusa aparece para `core.attributesFile` e `attr.tree`, cada uma com sua própria correção.

A mensagem pode nomear um arquivo de configuração que sua configuração do git inclui por meio de uma diretiva `include` ou `includeIf`, mesmo quando a condição dessa diretiva não se aplica a este repositório.

**O que fazer:**

* Aplique a correção indicada na frase final da mensagem

### O GitHub não está conectado à sua conta Claude

Você iniciou uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) a partir do seu repositório local, por exemplo com `/autofix-pr`. Nenhuma conta do GitHub está conectada à sua conta Claude, ou a conexão expirou, então o Claude Code recusa a inicialização:

```text theme={null}
GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github
```

Quando você cria uma tarefa agendada na nuvem com [`/schedule`](https://code.claude.com/docs/pt/routines), a mesma mensagem aparece como uma nota de configuração que menciona o repositório; a nota não impede a criação da tarefa.

**O que fazer:**

* Execute `/web-setup` para conectar seu login da CLI do GitHub à sua conta Claude, ou conecte uma conta em [claude.ai/connect-github](https://claude.ai/connect-github). Consulte [Opções de autenticação do GitHub](https://code.claude.com/docs/pt/claude-code-on-the-web.md#github-authentication-options) para ver como as duas diferem.
* Execute o comando novamente um minuto após conectar

Antes da v2.1.268, o Claude Code relatava isso como uma falha temporária da verificação do Claude GitHub App e sugeria tentar novamente ou instalar o aplicativo; nenhuma das duas opções conecta uma conta do GitHub.

### Uma política da organização do GitHub está bloqueando o Claude

Você executou um comando no prompt do Claude Code que inicia uma sessão na nuvem, como [`/autofix-pr`](https://code.claude.com/docs/pt/claude-code-on-the-web#auto-fix-pull-requests). Antes de criar a sessão, o Claude Code verifica o acesso do Claude ao repositório no GitHub, e o GitHub recusou porque sua organização do GitHub tem uma política que bloqueia o Claude. O Claude Code para nesse ponto e mostra uma mensagem indicando a política.

Quando o que bloqueia o acesso é uma IP allow list, a mensagem diz:

```text theme={null}
Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist.
```

Quando o que bloqueia é o single sign-on, a mensagem diz:

```text theme={null}
Your GitHub organization requires single sign-on. Disconnect and reconnect GitHub on the Connectors page in Claude on the web, click Authorize next to your organization when GitHub asks, then try again.
```

Quando o que bloqueia é uma política de Acesso Condicional do Microsoft Entra ID, a mensagem diz:

```text theme={null}
Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude. Ask your GitHub Enterprise or Entra ID admin to allow Claude in that policy.
```

**O que fazer:**

* **IP allow list**: peça a um proprietário da sua organização ou enterprise do GitHub que permita os endereços IP de saída da Anthropic. Consulte [Allow lists e firewalls do GitHub](https://code.claude.com/docs/pt/network-config.md#github-allow-lists-and-firewalls) para ver os endereços e as configurações do GitHub a alterar.
* **Single sign-on**: desconecte o GitHub em [claude.ai/customize/connectors](https://claude.ai/customize/connectors) e conecte-o novamente. Quando o GitHub pedir, clique em **Authorize** ao lado da sua organização para que a nova conexão seja autorizada para o single sign-on dela.
* **Política de Acesso Condicional**: peça ao seu administrador do GitHub Enterprise ou do Microsoft Entra ID que permita o Claude nessa política
* Após a alteração, execute o comando novamente

### Autorização de single sign-on necessária

Você executou [`/install-github-app`](https://code.claude.com/docs/pt/github-actions#quick-setup) e escolheu um repositório cuja organização exige SAML single sign-on. Antes da configuração, o Claude Code verifica seu acesso ao repositório com o GitHub CLI, e o GitHub recusou essa verificação porque seu token do `gh` ainda não está autorizado para a organização. O assistente mostra o aviso com as etapas para autorizar:

```text theme={null}
Single sign-on authorization needed
<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.
```

**O que fazer:**

* Autorize novamente seu login do GitHub CLI com os escopos `repo` e `workflow` executando `gh auth refresh -h github.com -s repo,workflow`, e autorize a organização quando o GitHub solicitar o single sign-on
* Se você se autentica com um personal access token em `GH_TOKEN`, abra [github.com/settings/tokens](https://github.com/settings/tokens), selecione **Configure SSO** no token e autorize a organização
* Execute `/install-github-app` novamente

Antes da v2.1.273, o Claude Code mostrava o aviso `Admin permissions required` para essa condição.

### Falha ao retomar a conversa

O Claude Code não conseguiu ler ou processar a transcrição salva da sessão que você selecionou no [seletor do `claude --resume`](https://code.claude.com/docs/pt/sessions#use-the-session-picker), então encerra o processo em vez de continuar em um estado parcialmente carregado. A mensagem inclui o comando para tentar novamente:

```text theme={null}
Failed to resume the conversation.
Run claude --resume <session-id> to retry, or claude to start a new session.
```

O Claude Code sai com o código 1 após mostrar a mensagem. O seletor do `/resume` dentro de uma sessão em execução, em vez disso, informa `Failed to resume conversation` na conversa, e sua sessão atual continua em execução. Antes da v2.1.216, uma retomada com falha a partir do seletor do `claude --resume` ficava indefinidamente no indicador `Resuming conversation…` em vez de mostrar essa mensagem.

**O que fazer:**

* Execute `claude --resume <session-id>` com o ID da sessão da mensagem para tentar novamente
* Em uma versão anterior à v2.1.285, se a nova tentativa falhar da mesma forma, execute `claude update` e retome novamente. Essas versões falham na retomada quando a transcrição salva contém uma entrada que elas não conseguem ler.
* Se a nova tentativa falhar novamente, execute `claude` para iniciar uma nova sessão

### Nenhuma conversa encontrada com o ID da sessão

Você passou um ID de sessão para `claude --resume <session-id>` e nenhuma transcrição salva correspondeu a ele:

```text theme={null}
No conversation found with session ID: <session-id>
```

O Claude Code sai com o código 1 após mostrar a mensagem. O Claude Code [pesquisa primeiro o projeto atual e depois todos os outros projetos nesta máquina](https://code.claude.com/docs/pt/sessions.md#where-the-session-picker-looks) em busca do ID. Antes da v2.1.223, a busca parava no diretório do projeto atual e em seus git worktrees, então retome a partir do diretório em que a sessão trabalhou por último.

Causas comuns:

* **ID digitado incorretamente**: para uma execução não interativa, o ID é o campo `session_id` da [saída de `--output-format json`](https://code.claude.com/docs/pt/headless#get-structured-output)
* **Transcrição excluída**: o Claude Code remove transcrições após o [período de retenção](https://code.claude.com/docs/pt/sessions.md#where-transcripts-are-stored), 30 dias por padrão, seguindo as [regras de limpeza de retenção](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically)
* **Máquina diferente**: o Claude Code armazena transcrições localmente, então retome a sessão na máquina em que ela foi executada
* **Cópias duplicadas**: se você copiou um diretório de projeto em `~/.claude/projects` de modo que duas transcrições tenham o mesmo ID, o Claude Code informa essa mensagem em vez de retomar uma das cópias arbitrariamente

**O que fazer:**

* Para uma sessão interativa, abra o [seletor de sessões](https://code.claude.com/docs/pt/sessions.md#use-the-session-picker) com `claude --resume` e pressione `Ctrl+A` para ampliá-lo a todos os projetos desta máquina, depois selecione a sessão
* Sessões criadas com `claude -p` ou com o [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md) não aparecem no seletor, então confira novamente o ID com o `session_id` que sua execução original imprimiu

### O Windows relatou um erro (EBADF) quando o Claude Code leu o arquivo de transcrição desta sessão

Você retomou uma sessão no Windows, o [arquivo de transcrição](https://code.claude.com/docs/pt/sessions.md#where-transcripts-are-stored) salvo dela abriu normalmente, e a leitura depois falhou com o erro de sistema EBADF. O erro de sistema não diz por que a leitura falhou, então a mensagem sugere causas prováveis e o que tentar:

```text theme={null}
Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.
```

A mensagem vem após a própria linha de falha do comando, como `Failed to resume session <session-id>`. Um comando `claude --resume` ou [`claude -p`](https://code.claude.com/docs/pt/headless) sai com o código 1 após mostrá-la. Após `/resume` dentro de uma sessão, sua sessão atual continua em execução.

**O que fazer:**

* Exclua a pasta que contém suas transcrições de sessão de softwares que verificam ou interceptam leituras de arquivos, como ferramentas de segurança, criptografia ou gerenciamento de endpoints. As transcrições ficam em `%USERPROFILE%\.claude\projects` por padrão, ou no diretório indicado por [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/pt/env-vars)
* Se você não puder adicionar uma exclusão, adicione o Claude Code aos aplicativos permitidos desse software
* Retome a sessão novamente

Antes da v2.1.282, a falha vinha sem explicação: `claude --resume <session-id>` terminava em `Failed to resume session <session-id>`, e uma execução com `-p` imprimia apenas o texto do erro de sistema, como `Failed to resume session: EBADF: bad file descriptor, read`.

### Não é possível trocar de renderizador nesta sessão

Quando você troca de renderizador, o Claude Code reinicia seu processo. Você executou [`/tui`](https://code.claude.com/docs/pt/fullscreen#enable-fullscreen-rendering) em uma sessão que o Claude Code se recusa a reiniciar, então ele não troca e não salva nada. A mensagem que você vê indica a causa:

* `Cannot switch renderers while work is running in the background`: você tem trabalho em segundo plano em execução que uma reinicialização abandonaria, como um shell em segundo plano ou um subagente. Aguarde o trabalho terminar ou interrompa-o com [`/tasks`](https://code.claude.com/docs/pt/commands), depois execute `/tui fullscreen` ou `/tui default` novamente
* `Cannot switch renderers in this session`: a sessão tem restrições que o Claude Code não consegue repassar ao processo reiniciado. Antes da v2.1.234, o Claude Code reiniciava mesmo assim e a sessão relançada era executada sem elas

Na mensagem de restrições, a parte entre parênteses indica as restrições que o Claude Code encontrou:

```text theme={null}
Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.
```

Cada motivo que a mensagem pode mostrar entre parênteses:

* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: você iniciou a sessão com uma flag que o Claude Code não repassa ao processo reiniciado. Essas flags incluem [`--system-prompt`](https://code.claude.com/docs/pt/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, uma allowlist de [`--tools`](https://code.claude.com/docs/pt/cli-reference#cli-flags), [`--setting-sources`](https://code.claude.com/docs/pt/cli-reference#cli-flags) e [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags)
* `permission rules set for this session only`: uma [atualização de permissão](https://code.claude.com/docs/pt/hooks.md#permission-update-entries) de um hook ou chamador do SDK adicionou regras deny ou ask com o destino `session`. Regras allow com escopo de sessão não causam a recusa. Uma reinicialização as descarta, e o Claude Code solicita novamente
* `ask-before-running rules with no command-line form`: uma atualização de permissão de um hook ou chamador do SDK adicionou regras ask junto com as regras que o Claude Code repassa como `--allowed-tools` e `--disallowed-tools`. Não existe flag para regras ask
* `permission rules a command line cannot carry intact` e `added directories a command line cannot carry intact`: uma atualização de permissão adicionou uma regra ou um caminho de diretório no meio da sessão. A linha de comando do processo reiniciado não consegue transportar o texto dela como o mesmo valor

**O que fazer:**

* Em uma sessão iniciada sem essas restrições, execute `/tui fullscreen`, ou `/tui default` para voltar. O Claude Code salva a [configuração `tui`](https://code.claude.com/docs/pt/settings-reference#tui) ali

### Can't restart while work is running or Remote Control is connected

O Claude Code não reiniciou, e a sua sessão continua em execução como estava. Siga a correção indicada na mensagem.

### Claude Code couldn't restart

Quando essa mensagem diz que sua conversa está salva, a conversa está no disco e você pode retomá-la de onde parou. O Claude Code estava se reiniciando, por exemplo para ativar ou desativar a renderização em tela cheia depois que você executou [`/tui`](https://code.claude.com/docs/pt/fullscreen#enable-fullscreen-rendering), e não conseguiu iniciar o novo processo, então saiu com status 1:

```text theme={null}
Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.
```

Quando a reinicialização não tinha nenhuma conversa para reabrir, por exemplo porque `/tui` foi sua primeira entrada em uma nova sessão, a mensagem diz `Claude Code couldn't restart. Start Claude Code again.`

**O que fazer:**

* Execute `claude` novamente no seu shell. Se a mensagem disse que sua conversa está salva, execute [`/resume`](https://code.claude.com/docs/pt/sessions#resume-a-session) na nova sessão e selecione a conversa. Se ela não estiver na lista, [amplie o seletor de sessões](https://code.claude.com/docs/pt/sessions.md#where-the-session-picker-looks)
* Se as reinicializações continuarem falhando, inicie o Claude Code a partir do seu shell com [`claude --debug-file claude-debug.log`](https://code.claude.com/docs/pt/cli-reference#cli-flags). Se uma reinicialização a partir dessa sessão falhar, o `claude-debug.log` no diretório de onde você iniciou registra uma linha `Failed to relaunch:` com o erro do sistema operacional. Inclua essa linha ao [relatar o problema](#report-an-error)

### Não foi possível abrir o Claude Desktop

Você executou [`/desktop`](https://code.claude.com/docs/pt/desktop#coming-from-the-cli) ou seu alias `/app` em uma sessão, ou [`claude --desktop`](https://code.claude.com/docs/pt/cli-reference#cli-flags) no seu shell, e o comando de sistema que o Claude Code usa para abrir o Claude Desktop falhou. Após `/desktop`, a sessão permanece no terminal; `claude --desktop` imprime a mensagem sem o prefixo `Error:` e sai com status 1.

O texto entre parênteses indica o comando que falhou, com seu status de saída e a primeira linha da saída de erro quando ele os produziu. No macOS esse comando é `open`, como neste exemplo; no Windows é `rundll32`:

```text theme={null}
Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.
```

**O que fazer:**

* Abra o Claude Desktop você mesmo e depois execute `/desktop` ou `claude --desktop` novamente
* Para ler a saída de erro completa do comando que falhou, ative o log de depuração com `/debug` e execute `/desktop` novamente, ou execute `claude --desktop --debug-file <path>`, e depois verifique o log de depuração

Antes da v2.1.285, a mensagem terminava com `Open Claude Desktop and run /desktop again.` Antes da v2.1.275, ela era `Failed to open Claude Desktop. Please try opening it manually.` e não dizia o que havia falhado.

### /terminal-setup deixou seu keymap do Zed inalterado

Você executou [`/terminal-setup`](https://code.claude.com/docs/pt/terminal-config#enter-multiline-prompts) no Zed, e o Claude Code não conseguiu concluir a atualização do seu `keymap.json` do Zed, então deixou o arquivo como estava.

Cada mensagem indica o caminho para o seu keymap e inclui o bloco de atalho de teclado para você adicionar manualmente:

```text theme={null}
Couldn't update your Zed keymap, so it was left unchanged.
To add the binding yourself, add this block to the keymap array in <path to keymap.json>:
{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
```

A primeira linha da mensagem indica a causa:

* `Couldn't read your Zed keymap, so it was left unchanged.`: o Claude Code não conseguiu ler o arquivo, por exemplo por causa de permissões de arquivo
* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: o arquivo foi lido, mas não é interpretado como um array de blocos de atalhos de teclado, mesmo permitindo comentários `//` e vírgulas finais
* `Your Zed keymap is a symbolic link, so it was left unchanged.`: `keymap.json` é um link para outro arquivo
* `Couldn't back up your Zed keymap; not modifying it.`: o Claude Code não conseguiu copiar o arquivo para um backup `.bak` ao lado dele, então não alterou nada
* `Couldn't update your Zed keymap, so it was left unchanged.`: o resultado mesclado não foi verificado como um keymap válido contendo o atalho, então o Claude Code o descartou em vez de gravá-lo. Um bloco de atalho de teclado com uma chave duplicada pode causar isso

**O que fazer:**

* Copie o bloco da mensagem para o array de nível superior do seu `keymap.json`, no caminho que a mensagem indica
* Para `isn't a readable list of keybindings`, corrija o erro de sintaxe ou faça com que o valor de nível superior do arquivo seja um array, depois execute `/terminal-setup` novamente

Antes da v2.1.247, o `/terminal-setup` não conseguia interpretar um keymap do Zed que usasse comentários `//` ou vírgulas finais, e substituía o arquivo inteiro apenas pelo seu próprio atalho, informando que o atalho havia sido instalado. Para restaurar um keymap que uma versão anterior substituiu, use o arquivo de backup `.bak` descrito em [Inserir prompts de várias linhas](https://code.claude.com/docs/pt/terminal-config.md#enter-multiline-prompts).

### Relatórios de uso de skills não estão disponíveis nesta conexão

Você executou [`/skill-doctor`](https://code.claude.com/docs/pt/skills#find-unused-skills) pelo [Remote Control](https://code.claude.com/docs/pt/remote-control.md), a partir do seu celular ou navegador. O Claude Code não envia o relatório de uso de skills pelo Remote Control e, em vez disso, responde com esta mensagem:

```text theme={null}
Skill usage reports are not available on this connection.
```

**O que fazer:**

* Execute `/skill-doctor` no terminal da máquina em que a sessão está em execução, ou execute `claude -p "/skill-doctor"` ali

### Estilos de saída personalizados não podem ser selecionados pelo Remote Control

Você executou [`/output-style`](https://code.claude.com/docs/pt/output-styles#change-your-output-style) a partir do aplicativo móvel ou da web via [Remote Control](https://code.claude.com/docs/pt/remote-control.md), ou o comando chegou em uma mensagem retransmitida para a sessão. Como esse turno pode não vir do proprietário da conta, o Claude Code lista e seleciona apenas [estilos integrados](https://code.claude.com/docs/pt/output-styles.md#built-in-output-styles) nele, e adiciona este aviso sempre que o comando lista os estilos ou não reconhece o nome que você informou. Um nome de [estilo personalizado](https://code.claude.com/docs/pt/output-styles.md#create-a-custom-output-style) recebe a mesma resposta que um nome que não existe:

```text theme={null}
Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.
```

**O que fazer:**

* Escolha um estilo integrado, por exemplo `/output-style concise`
* Para usar um estilo personalizado, defina [`outputStyle`](https://code.claude.com/docs/pt/settings-reference#outputstyle) no `.claude/settings.local.json` do projeto, ou execute `/output-style <style>` no próprio terminal da sessão, se ela tiver um

### Estilos de saída são salvos nas configurações locais, que esta sessão não carrega

Você tentou trocar de [estilo de saída](https://code.claude.com/docs/pt/output-styles.md) com `/output-style <style>` ou `/config outputStyle=<style>` em uma sessão cujas fontes de configuração excluem `local`. Exemplos são uma sessão do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/typescript.md) cujo [`settingSources`](https://code.claude.com/docs/pt/agent-sdk/typescript#options) omite `"local"` e uma sessão da CLI iniciada com um valor de [`--setting-sources`](https://code.claude.com/docs/pt/cli-reference#cli-flags) que omite `local`. Ambos os comandos salvam o estilo em `.claude/settings.local.json`, um arquivo que essa sessão nunca lê de volta, então o Claude Code recusa em vez de gravar uma configuração que não teria efeito:

```text theme={null}
Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.
```

**O que fazer:**

* Adicione `local` às fontes de configuração da sessão e troque novamente
* Defina a chave [`outputStyle`](https://code.claude.com/docs/pt/settings-reference#outputstyle) em um arquivo de configurações que a sessão carregue, como `.claude/settings.json` no projeto ou `~/.claude/settings.json`. No SDK TypeScript, defina `outputStyle` dentro do objeto `settings` inline; consulte [Ativar um estilo de saída](https://code.claude.com/docs/pt/agent-sdk/modifying-system-prompts.md#activate-an-output-style)

### /recap só é executado quando você mesmo o solicita

A requisição de [`/recap`](https://code.claude.com/docs/pt/interactive-mode#session-recap) não veio da sua própria entrada. Ela chegou em uma mensagem retransmitida para a sessão a partir de uma thread do Slack, do Teams ou de um [projeto](https://code.claude.com/docs/pt/claude-projects.md), ou em um prompt que uma [tarefa agendada na nuvem](https://code.claude.com/docs/pt/routines.md) ou outro programa enviou.

Uma mensagem retransmitida recebe o aviso mesmo quando foi você quem a escreveu. O Claude Code não consegue saber se uma mensagem retransmitida ou automatizada veio da pessoa cuja conta executa a sessão, então responde com este aviso em vez de um resumo:

```text theme={null}
/recap only runs when you ask for it yourself in this session: from the terminal, the Claude app or claude.ai/code, or over Remote Control. A message relayed from Slack, Teams or a project thread, or sent by a routine or another program, can't request it.
```

Um `/recap` que você passa para `claude -p`, ou que seu próprio aplicativo do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md) envia para uma sessão que ele iniciou, conta como sua própria entrada.

**O que fazer:**

* Abra a sessão você mesmo e execute `/recap` ali: no terminal dela, no [aplicativo Desktop](https://code.claude.com/docs/pt/desktop.md) ou no [aplicativo móvel](https://code.claude.com/docs/pt/mobile.md), em [claude.ai/code](https://claude.ai/code), ou pelo [Remote Control](https://code.claude.com/docs/pt/remote-control.md)
* Se uma tarefa agendada na nuvem ou outro programa o enviou, remova `/recap` desse prompt

### /feedback está desativado pela política da sua organização

Esta mensagem significa que o feedback sobre o produto está desativado, então o comando que você digitou não abre a caixa de diálogo de feedback. Tanto uma política da organização quanto uma recusa anterior produzem a mensagem:

* **Política da organização**: a política da sua organização não permite feedback sobre o produto a partir do Claude Code. `/feedback`, `/bug` e `/share` respondem todos com a mensagem.
* **Recusa anterior**: o serviço de feedback recusou um relatório que você enviou, por exemplo com [`Couldn't send feedback: Feedback has not been enabled for your organization.`](#couldnt-send-feedback) `/feedback` e `/bug` podem então responder com a mensagem. Isso dura sete dias a partir dessa recusa nesta máquina. Isso se aplica a todos os planos, incluindo Pro e Max.

A mensagem indica o comando que você digitou no prompt do Claude Code:

```text wrap theme={null}
/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.
```

A mensagem também pode consistir apenas na primeira frase.

**O que fazer:**

* 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.
* Após uma recusa anterior, aguarde até que os sete dias tenham passado e envie um relatório novamente para ver se o serviço ainda o recusa

Antes da v2.1.319, uma recusa anterior não produzia esta mensagem.

Antes da v2.1.302, a mensagem completa dizia `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`

## Erros de plugin

Esses erros vêm da configuração de [plugin](https://code.claude.com/docs/pt/plugins/overview.md) e [marketplace](https://code.claude.com/docs/pt/plugins/overview.md). 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](https://code.claude.com/docs/pt/plugins/troubleshooting.md).

### plugin eval is currently in early access

Você executou [`claude plugin eval`](https://code.claude.com/docs/pt/plugin-evals) ou `claude plugin eval init` e ele saiu com código 1 com uma dessas mensagens antes de fazer qualquer coisa:

```text theme={null}
`plugin eval` is currently in early access
```

```text theme={null}
`plugin eval` is currently unavailable
```

A primeira mensagem significa que sua compilação é mais antiga que v2.1.269, a primeira versão em que o comando está geralmente disponível. A segunda significa que a Anthropic desativou o comando no servidor; nada em sua máquina o ativa novamente.

**O que fazer:**

* Execute `claude --version`, depois `claude update`, e execute o comando novamente em uma nova sessão. Consulte os [requisitos para plugin evals](https://code.claude.com/docs/pt/plugin-evals.md#requirements)
* Se você vir a segunda mensagem em uma compilação atual, tente novamente mais tarde após outro `claude update`

### Marketplace is registered from an untrusted source

O marketplace está registrado sob um nome que é [reservado para marketplaces oficiais da Anthropic](https://code.claude.com/docs/pt/plugins/marketplace-reference.md#marketplace-file), mas sua fonte registrada não é um repositório GitHub `anthropics`. Claude Code verifica novamente os nomes reservados toda vez que carrega ou atualiza um marketplace, então o marketplace e os plugins instalados a partir dele param de carregar. Antes da v2.1.205, uma entrada registrada antes de seu nome ficar reservado continuava carregando.

```text theme={null}
Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.
```

Para um marketplace cuja fonte não é um repositório GitHub ou uma URL Git, como um diretório local, a frase do meio lê `can only be used with GitHub sources from the 'anthropics' organization` em vez disso. `claude plugin marketplace add` executa a mesma verificação e recusa um nome reservado com `Failed to add marketplace:` seguido pela mesma frase de nome reservado.

**O que fazer:**

* Se o marketplace já está registrado, execute `claude plugin marketplace remove <name>`, depois adicione-o novamente do repositório oficial `github.com/anthropics`
* Se você publicar um marketplace de terceiros que usou o nome antes de ficar reservado, renomeie-o e peça aos usuários para adicioná-lo novamente de sua fonte
* Consulte a lista de nomes reservados em [Marketplace schema](https://code.claude.com/docs/pt/plugins/marketplace-reference.md#marketplace-file)

### Marketplace name is another spelling of a reserved name

O nome do marketplace não é em si um nome reservado, mas Claude Code o trata como outra grafia de um. [Nomes reservados](https://code.claude.com/docs/pt/plugins/marketplace-reference.md#reserved-name-spellings) lista quais grafias contam como um nome reservado. Claude Code recusa tal nome quando você adiciona o marketplace:

```text theme={null}
Failed to add marketplace: "claude.code.plugins" is another spelling of "claude-code-plugins", a reserved marketplace name.
```

Quando um marketplace já está registrado sob tal nome, sua entrada para de carregar, e `/plugin`, `claude plugin install`, e `claude plugin update` avisam:

```text wrap theme={null}
known_marketplaces.json has an entry named "claude.code.plugins", another spelling of the reserved marketplace name "claude-code-plugins", so it is ignored. Remove it with: claude plugin marketplace remove claude.code.plugins
```

Quando o nome precisaria de aspas de shell, a recusa no momento da adição lê `This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be.`

**O que fazer:**

* Renomeie o marketplace para um nome que não soletra um nome reservado e adicione-o novamente
* Para o aviso de entrada ignorada, execute o comando `claude plugin marketplace remove` que ele fornece, ou remova a entrada de `~/.claude/plugins/known_marketplaces.json`

### Claude Code refuses the marketplace name

Um marketplace registrado tem um nome que [se passa por um marketplace oficial da Anthropic](https://code.claude.com/docs/pt/plugins/marketplace-reference.md#reserved-names) sob as regras que essa seção lista.

Se um marketplace foi registrado sob tal nome antes da verificação bloqueá-lo, o marketplace e os plugins instalados a partir dele param de carregar, porque Claude Code verifica o nome toda vez que lê o catálogo do marketplace. Quando o nome imita um oficial, `claude plugin list` e a aba **Errors** do `/plugin` relatam cada plugin afetado com uma mensagem que começa:

```text theme={null}
Claude Code refuses the marketplace name "anthropic-plugins-v2"
```

Para um nome imitador, o próprio erro do marketplace lê `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own` em vez disso. `claude plugin marketplace add` recusa qualquer nome que se passa por outro com `Marketplace name impersonates an official Anthropic/Claude marketplace`.

Antes da v2.1.282, `claude plugin list` e `/plugin` relatavam os plugins de um nome imitador como falhando ao carregar também, sem nomear o nome do marketplace como a causa.

**O que fazer:**

* Para manter um marketplace que um arquivo de configurações declara inline com `"source": "settings"`, renomeie-o antes de remover o nome antigo, porque remover o marketplace também exclui sua entrada dos seus arquivos de configurações. Claude Code v2.1.292 ou posterior lista estas etapas na mensagem:
  1. Em cada arquivo de configurações que lista o marketplace em `extraKnownMarketplaces`, dê à chave da entrada e ao seu `source.name` um mesmo nome novo em ASCII simples que não se pareça com um oficial. Se um administrador adiciona o marketplace por meio das configurações gerenciadas da sua organização, o administrador realiza esta etapa
  2. Execute `claude plugin marketplace remove <old-name>`, ou remova o nome antigo na aba **Marketplaces** do `/plugin`. Isso também desinstala seus plugins e exclui seus dados, opções e segredos
  3. Inicie o Claude Code novamente, na pasta do projeto se o arquivo for um arquivo de configurações de projeto. Depois instale os plugins a partir do marketplace renomeado
* Para manter qualquer outro marketplace, aguarde até que seu mantenedor o renomeie, depois execute `claude plugin marketplace update <name>`
* Para remover o marketplace, execute `claude plugin marketplace remove <name>`. Isso também desinstala os plugins instalados do marketplace e exclui seus dados, opções e segredos
* Se você publica o marketplace, renomeie-o em seu `marketplace.json`; os usuários então atualizam o marketplace em vez de removê-lo

### Marketplace is already added from a different source

Você indicou uma nova fonte de marketplace com [`--marketplace <source>` no comando de instalação](https://code.claude.com/docs/pt/plugins/install#add-a-marketplace-and-install-in-one-command), em uma sessão ou a partir do seu shell. O catálogo que Claude Code buscou dessa fonte tem o mesmo nome de um marketplace que você já adicionou de uma fonte diferente. Claude Code mantém o marketplace existente em vez de substituí-lo, e o plugin não é instalado.

```text theme={null}
Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.
```

**O que fazer:**

* Se o marketplace que você já adicionou é o que você quer, instale a partir dele pelo nome: `/plugin install <plugin>@<name>`
* Para mudar para a nova fonte, execute `/plugin marketplace remove <name>`, depois tente a instalação novamente

### Plugin command references user\_config in a shell command

Um hook de plugin, [monitor](https://code.claude.com/docs/pt/plugins/components.md#monitors), ou comando MCP [`headersHelper`](https://code.claude.com/docs/pt/mcp#use-dynamic-headers-for-custom-authentication) referencia uma `${user_config.KEY}` [opção de plugin](https://code.claude.com/docs/pt/plugins/manifest-reference.md#user-configuration), e a string substituída seria passada para um shell. Um valor configurado contendo `$(...)`, backticks, ou `;` seria executado como código lá, então Claude Code recusa iniciar o componente em vez de substituir o valor. A verificação é executada no modelo de comando, então o erro aparece mesmo quando nenhum valor está configurado ainda. Antes da v2.1.207, o valor era substituído no comando shell.

A redação depende de qual superfície referenciou a opção. Um hook de forma shell relata:

```text theme={null}
Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}
```

Um monitor relata:

```text theme={null}
Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.
```

Um MCP `headersHelper` relata:

```text theme={null}
headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).
```

**O que fazer:**

* Para um hook, adicione um array `args` para que ele seja executado em [exec form](https://code.claude.com/docs/pt/hooks.md#exec-form-and-shell-form), onde cada `${user_config.KEY}` se torna um argumento sem shell no meio. Ou remova a referência e leia a variável de ambiente `$CLAUDE_PLUGIN_OPTION_<KEY>` dentro do script
* Para um monitor, remova a referência e faça o script do monitor ler o valor de um arquivo de configuração
* Para um `headersHelper`, mova `${user_config.KEY}` para o campo `headers` do servidor, que não é analisado por shell, ou leia o valor dentro do script helper

### Plugin archive integrity check failed

A entrada do marketplace do plugin usa uma [fonte `archive`](https://code.claude.com/docs/pt/plugins/marketplace-reference#archive-plugin-source) com um pin `sha256`, e o digest do arquivo baixado não corresponde ao pin. Claude Code recusa a instalação, então nada muda no cache de plugin. A incompatibilidade tem três possíveis causas:

* O arquivo na URL mudou depois que o autor computou o pin
* O autor inseriu o digest errado na entrada do marketplace
* A URL serve um arquivo diferente do que o autor fixou

```text theme={null}
Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.
```

**O que fazer:**

* Se você publica o plugin, recompute o digest do arquivo exato que a URL serve, por exemplo com `shasum -a 256 my-plugin.zip`, ou `Get-FileHash -Algorithm SHA256 my-plugin.zip` no PowerShell, e atualize o `sha256` na entrada do marketplace
* Se você instala o plugin, execute `/plugin marketplace update <name>` para atualizar o catálogo caso a entrada tenha sido corrigida, depois tente a instalação novamente
* Se os digests ainda discordarem após uma atualização, pergunte ao proprietário do marketplace qual arquivo eles fixaram antes de instalar

### Path escapes plugin directory

Um 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](https://code.claude.com/docs/pt/plugins/marketplace-reference.md#plugin-entries), o nome do componente na mensagem, como `commands` ou `hooks`, nomeia o campo que declarou o caminho.

```text theme={null}
commands path escapes plugin directory: ./../shared.md
```

Na saída do comando `claude plugin`, o mesmo erro lê `Path escapes plugin directory: ./../shared.md (commands)`.

Claude Code rejeita tanto um caminho que aponta para fora do plugin conforme escrito, como `../shared-utils`, e um symlink que leva para fora do plugin e não é um que as [regras de symlink do marketplace](https://code.claude.com/docs/pt/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks) permitem. Para um symlink, a mensagem também diz para onde o caminho resolve:

```text theme={null}
commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory
```

Uma mensagem que fornece o caminho completo de um dos próprios arquivos de um plugin de marketplace, como `hooks/hooks.json`, significa que Claude Code ignorou esse arquivo. Quando Claude Code não consegue confirmar que o arquivo está dentro do plugin ou, para um plugin em um [marketplace local](https://code.claude.com/docs/pt/plugins/loading.md#in-place-and-copied-plugins), dentro desse marketplace, ele ignora o arquivo. A mensagem relata esses arquivos sob o nome de componente mostrado:

* `hooks/hooks.json`: `hooks`
* `monitors/monitors.json`: `monitors`
* `SKILL.md` na raiz do plugin: `skills`

Por exemplo, esta mensagem é para um `hooks/hooks.json` que resolve fora tanto do plugin quanto de seu marketplace local:

```text theme={null}
hooks 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
```

No 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:

```text theme={null}
commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform
```

Antes 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.

Antes 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.

**O que fazer:**

* Se você instalou o plugin e não o mantém, relate a mensagem ao autor dele
* 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 `./`
* 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
* 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`
* 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).
* 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](https://code.claude.com/docs/pt/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)

### Server file path not read

A mensagem `path not read` significa que Claude Code não leu um arquivo de servidor MCP ou LSP que um plugin nomeia, por causa do caminho do arquivo. O resto do plugin carrega, sem os servidores que o arquivo define.

Uma parte `..` conta mesmo quando o caminho fica dentro do plugin, como neste exemplo:

```text theme={null}
mcp-servers path not read: ./sub/../x.json is absolute or has a ".." part
```

**O que fazer:**

* Se você instalou o plugin e não o mantém, relate a mensagem ao autor dele
* Se você mantém o plugin, mantenha o arquivo de servidor dentro do diretório do plugin. Nomeie-o no manifesto ou na entrada de marketplace com um caminho que comece com `./` e não tenha `..`, por exemplo `./servers/x.json`
* Para compartilhar um arquivo de servidor entre plugins no mesmo marketplace, vincule o arquivo a cada plugin com um symlink, seguindo as [regras de symlink](https://code.claude.com/docs/pt/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)

### Plugin not loaded: its manifest was not read

Claude Code não conseguiu confirmar que o [manifesto](https://code.claude.com/docs/pt/plugins/manifest-reference.md) 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](https://code.claude.com/docs/pt/plugins/loading.md#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.

Por exemplo, esta mensagem é para um plugin em um marketplace local cuja pasta `.claude-plugin` é um symlink que leva para fora do marketplace:

```text theme={null}
Plugin 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
```

**O que fazer:**

* 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).
* 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.
* Se você instalou o plugin e não o mantém, relate a mensagem ao autor dele

### Path could not be checked

Claude 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:

* Um dos [locais de componente padrão](https://code.claude.com/docs/pt/plugins/manifest-reference.md#standard-layout) de um plugin, como a pasta `skills/`, o arquivo `monitors/monitors.json`, ou um [`SKILL.md` na raiz do plugin](https://code.claude.com/docs/pt/plugins/components#skills): os outros componentes do plugin ainda carregam
* O próprio diretório do plugin: nada desse plugin carrega

Você não vê esse erro para um caminho que não existe em absoluto. Em `/plugin`, o erro aparece sob o plugin e nomeia o caminho e o código que o sistema operacional retornou:

```text theme={null}
skills path couldn't be checked: /home/user/my-plugin/skills (ELOOP)
```

Em `claude plugin list`, o mesmo erro lê `Path not found: /home/user/my-plugin/skills (skills, ELOOP)`.

As causas que produzem esse erro incluem:

* `ELOOP`: um symlink no caminho aponta para si mesmo ou forma um loop
* `EIO` ou `ESTALE`: o caminho está em uma montagem de rede que está quebrada ou obsoleta
* `EACCES`: um dos diretórios acima do caminho nega a você permissão para atravessá-lo

**O que fazer:**

* Substitua um symlink que aponta para si mesmo por uma pasta real, ou delete-o
* Se o caminho está em uma montagem de rede, remonte o compartilhamento
* Se o código é `EACCES`, restaure sua permissão de execução nos diretórios acima do caminho
* Execute `/reload-plugins` após corrigir o caminho, ou reinicie Claude Code, para carregar o plugin ou componente

Antes da v2.1.265, Claude Code tratava uma pasta de componente padrão que não conseguia verificar como ausente e carregava o plugin sem esse componente, sem erro.

### Marketplace entry path does not stay inside the marketplace directory

A [entrada de marketplace](https://code.claude.com/docs/pt/plugins/marketplace-reference.md#plugin-entries) do plugin declara um caminho de origem que Claude Code não consegue resolver para um local dentro do próprio diretório do marketplace, então o plugin não instala ou carrega. A recusa cobre:

* Um caminho de entrada que é absoluto, sobe para fora do marketplace com `..`, ou é soletrado como um caminho de rede
* No macOS e Linux, um caminho de entrada que contém uma barra invertida em qualquer lugar após o `./` inicial
* Uma entrada em um marketplace buscado de uma fonte remota, como git ou uma URL, que alcança seu alvo através de um symlink resolvendo fora do diretório do marketplace
* Uma entrada relativa em um marketplace adicionado de uma URL direta para seu `marketplace.json`: Claude Code baixa apenas esse arquivo, então nenhum arquivo de plugin local existe para o caminho nomear. Consulte [Plugins with relative paths fail in URL-based marketplaces](https://code.claude.com/docs/pt/plugins/troubleshooting.md#plugins-with-relative-paths-fail-in-url-based-marketplaces)

`claude plugin install` relata a recusa assim:

```text theme={null}
Cannot install my-plugin@my-marketplace: its marketplace entry path does not stay inside the marketplace directory (an absolute, climbing, network-shaped, backslash-containing or link-traversing entry, an entry of a fetched marketplace that resolves or opens outside its tree — or a relative entry in a url-catalog marketplace, which has no local directory)
```

Quando uma entrada de plugin já instalado falha na mesma verificação, `claude plugin list` mostra o plugin como `failed to load` com:

```text theme={null}
Plugin source path refused: ./my-plugin does not stay inside its marketplace directory. Check that the marketplace entry has a plain relative path.
```

**O que fazer:**

* Se você mantém o marketplace, escreva o `source` da entrada como um caminho relativo simples com barras para frente, como `./plugins/my-plugin`, e mantenha qualquer symlink que ele cruze apontado dentro do diretório do marketplace
* Se você adicionou o marketplace de uma URL direta, entradas relativas não conseguem resolver. Peça ao autor do marketplace para usar [outra fonte de plugin](https://code.claude.com/docs/pt/plugins/marketplace-reference.md#plugin-sources), ou adicione o marketplace de seu repositório git em vez disso

### Failed to load marketplace configuration

Claude Code mantém os marketplaces de plugin que você adicionou em um arquivo de registro em `~/.claude/plugins/known_marketplaces.json`. Um comando de plugin que precisa do registro, como `claude plugin install`, falha com uma de duas mensagens quando Claude Code não consegue usar o arquivo:

* `Failed to load marketplace configuration`: o arquivo existe, mas não é JSON válido ou não pode ser lido. Um arquivo vazio falha dessa forma também.
* `Marketplace configuration file is corrupted`: o arquivo é JSON válido mas seu conteúdo não corresponde ao esquema do registro.

Com um arquivo vazio, `claude plugin install` relata:

```text theme={null}
✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF
```

Antes da v2.1.246, `claude plugin install` não relatava essa falha.

**O que fazer:**

* Abra `~/.claude/plugins/known_marketplaces.json` e repare o JSON, ou corrija as entradas que a mensagem nomeia como não correspondendo ao esquema do registro
* Se você não conseguir repará-lo, delete o arquivo ou substitua seu conteúdo por `{}`, depois adicione novamente cada marketplace com `claude plugin marketplace add <source>`. Claude Code re-registra os marketplaces que suas configurações de usuário ou gerenciadas declaram em [`extraKnownMarketplaces`](https://code.claude.com/docs/pt/settings-reference#extraknownmarketplaces) na próxima vez que você o inicia em uma pasta que você confiou.

### Plugin is required by your organization

Você executou `claude plugin disable`, ou usou a aba **Installed** do `/plugin`, para desativar um [plugin sincronizado de claude.ai](https://code.claude.com/docs/pt/plugins/loading.md#synced-plugins) que sua organização marca como obrigatório:

```text theme={null}
Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.
```

Claude Code não salva nada e o plugin permanece ativado.

Quando você tenta desativar um plugin que um plugin obrigatório depende, Claude Code recusa da mesma forma, com uma mensagem nomeando o plugin obrigatório que precisa dele.

**O que fazer:**

* Peça a um administrador de sua organização claude.ai para mudar o status obrigatório do plugin em claude.ai

### Plugin was not uninstalled

Você executou [`claude plugin uninstall`](https://code.claude.com/docs/pt/plugins/cli-reference#plugin-uninstall), ou escolheu **Uninstall** na aba **Installed** do `/plugin`, e a desinstalação parou com uma mensagem começando `"<plugin>" was not uninstalled:`. Se o texto após esse dois-pontos começar com `installed_plugins.json` em vez de nomear um arquivo de configurações, a causa é conteúdo em `installed_plugins.json` que esta versão de Claude Code não consegue ler. Para esse formulário, consulte [`installed_plugins.json` holds a record this version can't read](https://code.claude.com/docs/pt/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read).

Quando Claude Code removeu a entrada do plugin de `enabledPlugins` e leu os arquivos de configurações desse escopo novamente, ou o plugin ainda estava ligado lá, ou um arquivo que poderia ligá-lo não conseguiu ser lido ou verificado. Deletar as opções salvas do plugin, segredos e dados enquanto uma entrada de configurações poderia ligá-lo novamente perderia tudo, então a desinstalação para em vez disso: o plugin permanece instalado e nada que ele salvou é deletado.

```text theme={null}
✘ Failed to uninstall plugin "formatter": "formatter" was not uninstalled: it is still switched on in /home/user/project/.claude/settings.local.json, although the settings change reported no error. It is still installed. Take it out of "enabledPlugins" in that file yourself, then uninstall it again.
```

O meio da mensagem nomeia o arquivo e a causa:

* `it is still switched on in <file>, although the settings change reported no error`: a escrita de configurações relatou sucesso mas a entrada ainda está lá quando o arquivo é lido novamente
* `it is still switched on in <file>, and the settings change failed (<error>)`: o arquivo não conseguiu ser salvo, pela razão entre parênteses
* `<file> is there and could not be read`: o arquivo existe mas não conseguiu ser lido como configurações, por exemplo porque não é JSON válido, então pode ainda ativar o plugin
* `<file> (not read: it is on a network path or is a link to one, or could not be checked)`: Claude Code não leu o arquivo de configurações do projeto ou local porque o arquivo, ou a pasta `.claude` que o contém, é um link que leva a um local de rede, ou porque não conseguiu examinar esse caminho

`claude plugin uninstall` sai com código 1, e com `--json` o resultado carrega `failureCode: "settings_still_on"`. `/plugin` mostra a mesma mensagem.

**O que fazer:**

* Siga a última frase da mensagem: repare ou substitua o arquivo de configurações que ela nomeia, ou remova a entrada do plugin de `enabledPlugins` naquele arquivo você mesmo, depois execute a desinstalação novamente

### Skipping connection (recent failure cached; retries automatically in 15 min, or edit the plugin config to retry now)

Esta mensagem significa que Claude Code não iniciou um [servidor MCP fornecido por um plugin](https://code.claude.com/docs/pt/mcp.md#plugin-provided-mcp-servers) do tipo stdio, porque uma conexão com esse servidor falhou menos de 15 minutos antes:

```text theme={null}
Skipping connection (recent failure cached; retries automatically in 15 min, or edit the plugin config to retry now)
```

A sessão continua sem as ferramentas do servidor, e Claude Code não tenta o servidor novamente nessa sessão quando os 15 minutos terminam. Quando você inicia uma nova sessão ou execução de [`claude -p`](https://code.claude.com/docs/pt/headless) pelo menos 15 minutos após a conexão com falha mais recente, Claude Code tenta o servidor novamente.

**O que fazer:**

Para que Claude Code tente o servidor novamente sem esperar:

* **Em uma sessão interativa**: execute `/mcp`, selecione o servidor e selecione **Reconnect**
* **Em uma aplicação do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md)**: chame [`reconnectMcpServer()`](https://code.claude.com/docs/pt/agent-sdk/typescript#methods) em TypeScript ou [`ClaudeSDKClient.reconnect_mcp_server()`](https://code.claude.com/docs/pt/agent-sdk/python#methods) em Python com o nome do servidor
* **Em `claude -p`**: inicie uma sessão interativa que carregue o mesmo plugin, na mesma máquina e com a mesma conta do sistema operacional e o mesmo valor de [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/pt/env-vars) das suas execuções. Reconecte o servidor ali a partir de `/mcp`. Quando ele se conectar, Claude Code tentará a conexão na sua próxima execução.
* **Se você está desenvolvendo o plugin**: altere o `command`, `args` ou `env` do servidor no `.mcp.json` ou `plugin.json` do plugin. Claude Code tenta a conexão na próxima sessão ou execução de `claude -p` que carregar a entrada alterada.

A mensagem substitui o erro da conexão com falha. Se a nova tentativa também falhar, Claude Code relata o erro dessa tentativa em vez desta mensagem.

## Erros de ferramentas

Esses erros vêm das chamadas de ferramenta do Claude. Claude corrige a maioria dos erros de ferramentas por conta própria. Quando um deles precisa de uma mudança sua, a lista **O que fazer** desse erro diz o que mudar.

### Nenhuma ferramenta com esse nome disponível

Claude chamou uma ferramenta por um nome que não está na lista de ferramentas da sessão. Claude Code retorna o erro ao Claude como o resultado da chamada de ferramenta, e o turno continua. Quando Claude Code consegue identificar por que a ferramenta está ausente, ele adiciona uma frase após o nome da ferramenta que dá a razão ou nomeia a ferramenta a ser chamada em vez disso, como na segunda linha:

```text theme={null}
Error: No such tool available: <tool name>
Error: No such tool available: read. Tool names are case-sensitive: call Read instead.
```

Logo após você retomar uma sessão, um servidor MCP ainda pode estar em sua primeira tentativa de conexão quando Claude chama uma de suas ferramentas. Claude Code então [aguarda o servidor](https://code.claude.com/docs/pt/mcp.md#tool-availability) e retorna esse erro se a ferramenta ainda não estiver disponível quando a espera terminar. Antes da v2.1.284, tal chamada falhava imediatamente em vez de aguardar.

Uma chamada cujo nome de ferramenta Claude Code [cortou para 200 caracteres](#tool-use-name-over-200-characters) também falha com esse erro.

**O que fazer:**

* Se acontecer uma vez, você não precisa fazer nada. Claude lê o erro e o turno continua.
* Se chamadas às ferramentas de um servidor MCP continuarem falhando com esse erro, execute `/mcp` na sessão ou `claude mcp list` no seu shell para verificar o [status](https://code.claude.com/docs/pt/mcp.md#server-status) do servidor, e reconecte um servidor com falha a partir de `/mcp`. No Agent SDK, veja [Tratamento de erros](https://code.claude.com/docs/pt/agent-sdk/mcp.md#error-handling).

### MCP server connection closed before the tool call was answered

Uma chamada de ferramenta para um [servidor MCP](https://code.claude.com/docs/pt/mcp.md) HTTP ou um [conector do claude.ai](https://code.claude.com/docs/pt/mcp.md#use-mcp-servers-from-claude-ai) perdeu sua conexão antes de o servidor responder, então Claude Code não consegue saber se a ferramenta foi executada:

```text theme={null}
MCP server "<name>" connection closed before the tool call was answered. The tool may have run: check whether it did before running it again.
```

Repetir a chamada poderia repetir a ação da ferramenta, como criar uma segunda issue. Por isso, Claude Code repete a chamada por conta própria, uma vez, quando o servidor marca a ferramenta como segura para repetir.

**O que fazer:**

* Verifique no serviço sobre o qual a ferramenta atua se a ação aconteceu, por exemplo se a issue ou o registro que ela deveria criar está lá
* Se a ação aconteceu, não execute a ferramenta novamente. Claude recebeu esta mensagem no lugar do resultado da ferramenta, então informe ao Claude o resultado.
* Se a ação não aconteceu, peça ao Claude para executar a ferramenta novamente. Você não precisa reconectar o servidor antes, porque Claude Code se conecta a ele novamente na próxima chamada a uma de suas ferramentas. Se essa conexão também falhar, veja [Mid-session drops of a remote server](https://code.claude.com/docs/pt/mcp.md#mid-session-drops-of-a-remote-server).
* Se você desenvolve o servidor e a ferramenta é segura para ser chamada duas vezes, [marque-a como segura para repetir](https://code.claude.com/docs/pt/mcp.md#tool-calls-pending-when-a-connection-closes) para que Claude Code possa repetir uma chamada perdida

### MCP server is disabled

Esta mensagem em um resultado de ferramenta significa que Claude chamou uma ferramenta em um [servidor MCP](https://code.claude.com/docs/pt/mcp.md) que está [desativado](https://code.claude.com/docs/pt/mcp.md#disable-a-server-without-removing-it). Claude Code não se conectou ao servidor, então a ferramenta não foi executada, e Claude recebeu este texto no lugar de um resultado:

```text wrap theme={null}
MCP server "<name>" is disabled — re-enable it via /mcp to use its tools
```

**O que fazer:**

* Se você pretendia desativar o servidor, não precisa fazer nada
* Se Claude precisa das ferramentas do servidor, ative-o novamente a partir de `/mcp` no prompt do Claude Code
* Em uma aplicação do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), ative o servidor novamente chamando [`toggleMcpServer()`](https://code.claude.com/docs/pt/agent-sdk/typescript#togglemcpserver) em TypeScript com `enabled` definido como `true`, ou [`toggle_mcp_server()`](https://code.claude.com/docs/pt/agent-sdk/python#claudesdkclient) em Python com `enabled` definido como `True`

### Chamada de ferramenta MCP atingiu o timeout com a pergunta do servidor sem resposta

No [modo não interativo](https://code.claude.com/docs/pt/headless.md), um [servidor MCP](https://code.claude.com/docs/pt/mcp.md) pediu uma entrada por meio de [elicitation](https://code.claude.com/docs/pt/mcp.md#respond-to-mcp-elicitation-requests) durante uma chamada de ferramenta, e o limite de tempo da chamada se esgotou antes de chegar uma resposta:

```text theme={null}
MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit. Do not call this tool again in this turn. Tell the user that the server's question got no answer, and wait for their reply.
```

Antes da v2.1.310, o resultado terminava em `timed out after <N>s` e não dizia nada sobre a pergunta.

**O que fazer:**

* Configure um [hook `Elicitation`](https://code.claude.com/docs/pt/hooks#elicitation) que responda às requisições do servidor
* Em uma aplicação TypeScript do Agent SDK, faça seu callback [`onElicitation`](https://code.claude.com/docs/pt/agent-sdk/typescript#options) retornar sua resposta antes que o limite se esgote
* Para dar mais tempo a uma resposta, defina um [`timeout`](https://code.claude.com/docs/pt/mcp#time-limits-on-mcp-tool-calls) maior em milissegundos na entrada de configuração do servidor, como `"timeout": 600000` para 10 minutos
* Execute a tarefa em uma sessão interativa em vez disso e responda você mesmo ao [diálogo](https://code.claude.com/docs/pt/mcp.md#respond-to-mcp-elicitation-requests) do servidor

### Permission prompt tool returned an invalid result

A ferramenta que você passou para [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags) retornou uma resposta que Claude Code não conseguiu ler, então a chamada de ferramenta que aguardava por ela não foi executada, mesmo que a resposta permitisse a chamada:

```text wrap theme={null}
Permission prompt tool returned an invalid result. Expected a single text block param with type="text" and a string text value.
```

**O que fazer:**

* Retorne um bloco de texto cujo texto seja `{"behavior": "allow"}` ou `{"behavior": "deny", "message": "<reason>"}`. Para alterar a entrada, adicione `updatedInput` ao objeto `allow`. Da v2.1.86 até a v2.1.206, um `allow` precisava de `"updatedInput": {}` para manter a entrada.
* Não retorne [`structuredContent`](https://code.claude.com/docs/pt/agent-sdk/custom-tools#return-structured-data), que seu MCP SDK pode adicionar por conta própria. Por exemplo, registre a ferramenta:
  * **`FastMCP` ou `MCPServer` de `mcp.server`**: com `structured_output=False`
  * **`FastMCP` de `fastmcp`**: com `output_schema=None`, e retorne uma string
  * **MCP TypeScript SDK**: sem `outputSchema`
* Se o erro ocorre apenas com entradas de cerca de 40 KB ou mais, não copie a entrada para `updatedInput` ou para a `message` de uma negação. Para alterar uma entrada tão grande, [aumente o limite de saída da sua ferramenta de prompt](https://code.claude.com/docs/pt/mcp.md#raise-the-limit-for-a-specific-tool).

### Agent seria iniciado com zero ferramentas

Cada entrada na lista [`tools` do subagente](https://code.claude.com/docs/pt/sub-agents#supported-frontmatter-fields) falhou em corresponder a uma ferramenta utilizável, então Claude Code recusou iniciar o subagente: sem ferramentas, ele não poderia agir. A mensagem agrupa suas entradas pelo que deu errado:

* **Unrecognized**: a entrada não corresponde a nenhum nome de ferramenta, geralmente um erro de digitação como `Grpe` para `Grep`.
* **Not available to subagents**: a entrada nomeia uma ferramenta real que [subagentes não podem usar](https://code.claude.com/docs/pt/sub-agents.md#available-tools). Subagentes em background mantêm um conjunto de ferramentas integradas menor, então uma entrada que apenas um subagente em foreground pode usar fica aqui quando o subagente seria executado em background, que é o padrão. Se você listar `Agent`, a mensagem o relata no próximo grupo.
* **Matched no tools in this session**: a entrada é válida mas nenhuma ferramenta na sessão atual corresponde a ela agora, como `mcp__github__*` sem servidor GitHub MCP conectado, ou `Agent` para um subagente no [limite de profundidade](https://code.claude.com/docs/pt/sub-agents.md#let-subagents-spawn-their-own-subagents).

Omitir o campo `tools` nunca dispara essa recusa. Se você deixar a lista `tools` vazia, ou `disallowedTools` remover cada entrada nela, Claude Code também pula a recusa e inicia o subagente sem ferramentas.

Antes da v2.1.208, o subagente era iniciado sem ferramentas e poderia retornar um resultado vazio ou confuso.

```text theme={null}
Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
```

**O que fazer:**

* Corrija cada entrada que o erro nomeia com base nas [ferramentas disponíveis para subagentes](https://code.claude.com/docs/pt/sub-agents.md#available-tools)
* Remova entradas para ferramentas que a sessão não tem, como ferramentas MCP de um servidor que não está conectado
* Se a entrada nomeia um servidor MCP conectado, compare a entrada com o nome desse servidor conforme os [nomes de ferramentas](https://code.claude.com/docs/pt/permissions.md#mcp) do servidor o escrevem, como `reports__v2` em `mcp__reports__v2__get_totals`. Para esse servidor, escreva `mcp__reports__v2__*`, que é `mcp__` seguido pelo nome completo e `__*`. Com o mais curto `mcp__reports`, que nomeia um servidor chamado `reports`, o subagente não recebe nenhuma das ferramentas `reports__v2`
* Para uma ferramenta que [subagentes em background descartam](https://code.claude.com/docs/pt/sub-agents.md#available-tools), como `CronCreate`, remova a entrada
* Para manter em vez disso uma ferramenta como `CronCreate`, [deixe Claude aguardar o subagente](https://code.claude.com/docs/pt/sub-agents.md#let-claude-wait-for-a-subagent), já que um subagente que Claude aguarda é executado em foreground e mantém a ferramenta. Se a definição define `background: true`, remova esse campo primeiro, porque ele mantém o subagente em background
* Delete o campo `tools` em vez de listar ferramentas para dar ao subagente cada [ferramenta disponível para subagentes](https://code.claude.com/docs/pt/sub-agents.md#available-tools)
* Para uma lista `tools` que contém apenas `Agent`, aumente o [limite de profundidade](https://code.claude.com/docs/pt/sub-agents.md#let-subagents-spawn-their-own-subagents) ou dê ao agente pelo menos uma outra ferramenta: Claude Code retém `Agent` nesse limite, então uma lista com nada mais nela se resolve para nenhuma ferramenta

### Arquivo é coberto por uma regra de negação Read

A ferramenta Edit ou Write foi chamada em um caminho correspondido por uma [regra de negação `Read`](https://code.claude.com/docs/pt/permissions#read-and-edit), incluindo criar um novo arquivo nesse caminho. Ambas as ferramentas mudam conteúdo que Claude tem que ser capaz de ler de volta, então Claude Code recusa a chamada antes de qualquer acesso a arquivo. NotebookEdit não é coberto por regras de negação `Read`. Antes da v2.1.228, a regra bloqueava apenas a ferramenta Edit, e antes da v2.1.208, apenas uma regra de negação `Edit` bloqueava edições.

```text theme={null}
File is covered by a Read deny rule in your permission settings and cannot be edited.
```

Quando Claude Code recusa a ferramenta Write, a mensagem termina `and cannot be written` em vez disso.

**O que fazer:**

* Se Claude deveria ser capaz de mudar o arquivo, remova ou estreite a regra de negação `Read` em `/permissions` ou em [settings](https://code.claude.com/docs/pt/settings-reference.md#permission-settings)
* Se o arquivo deve permanecer intocado, mantenha a regra e adicione uma regra de negação `Edit` para o mesmo caminho para bloquear a ferramenta NotebookEdit também

### Configuração bloqueia escritas fora dos diretórios de trabalho

Quando Claude tenta escrever um arquivo e a chamada de ferramenta falha com esta mensagem, o caminho está fora dos [diretórios de trabalho](https://code.claude.com/docs/pt/permissions.md#working-directories) da sessão e [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/pt/settings-reference#permissions-blockwritesoutsideworkingdirectories) está ativado:

```text wrap theme={null}
<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories. Ask the user to add the directory with /add-dir, or to remove that setting.
```

Claude Code recusa essa escrita em todos os modos de permissão. A recusa também pode dizer:

```text wrap theme={null}
<path>: Writes outside the working directories are blocked (permissions.blockWritesOutsideWorkingDirectories). Add the directory with /add-dir, or remove that setting.
```

**O que fazer:**

* Se Claude não deveria escrever lá, não faça nada
* Para deixar Claude escrever em um diretório existente que contém o caminho, execute `/add-dir <directory>` no prompt do Claude Code, ou passe `--add-dir <directory>` ao iniciar o Claude Code
* Se o caminho é um arquivo de configurações do Claude Code, como `~/.claude/settings.json`, edite-o você mesmo. Adicionar seu diretório com `/add-dir` não ajuda, porque Claude Code então recusa a escrita [como um arquivo de configurações](#writes-to-claude-code-settings-files-are-blocked).
* Para manter um diretório gravável em todas as sessões, liste-o em [`permissions.additionalDirectories`](https://code.claude.com/docs/pt/settings-reference#permissions-additionaldirectories) nas suas configurações de usuário ou gerenciadas
* Para desativar `permissions.blockWritesOutsideWorkingDirectories`, remova-a de cada arquivo de configurações que a define e, em seguida, reinicie o Claude Code
* Se nenhum dos seus arquivos de configurações tem `permissions.blockWritesOutsideWorkingDirectories`, ela pode vir de `--settings` ou de uma aplicação hospedeira. Claude Code também recusa essas escritas enquanto não consegue ler `permissions` nas suas [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md#keys-that-fail-closed). Pergunte a quem inicia ou gerencia a sessão.

### Writes to Claude Code settings files are blocked

Quando Claude tenta escrever um arquivo e a chamada de ferramenta falha com esta mensagem, Claude Code trata o arquivo como um de seus arquivos de configurações e [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/pt/settings-reference#permissions-blockwritesoutsideworkingdirectories) está ativado:

```text wrap theme={null}
<path>: Writes to Claude Code settings files are blocked while permissions.blockWritesOutsideWorkingDirectories is on, because a settings file can lift that block. While a managed settings folder cannot be resolved, any .json file counts as one.
```

**O que fazer:**

* Para mudar uma configuração, edite você mesmo o arquivo de configurações
* Para deixar Claude editar arquivos de configurações novamente, remova `permissions.blockWritesOutsideWorkingDirectories` de cada arquivo de configurações que a define e, em seguida, reinicie o Claude Code
* Se o arquivo não é um dos seus arquivos de configurações, encontre-o entre os outros arquivos que Claude Code trata como arquivos de configurações:
  * **Um arquivo que você passou para `--agents` ou `--mcp-config`**: edite-o você mesmo
  * **A cópia armazenada das [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md#security-considerations) e os arquivos mantidos com ela**: peça a um [Owner](https://code.claude.com/docs/pt/server-managed-settings.md#access-control) para mudar a configuração nas configurações gerenciadas pelo servidor.
  * **Qualquer arquivo `.json`, enquanto Claude Code não consegue determinar para onde a pasta [`managed-settings.d/`](https://code.claude.com/docs/pt/managed-settings#split-a-file-based-policy-across-teams) leva**: peça ao seu administrador para verificar essa pasta

### Path cannot contain null bytes

Uma chamada de ferramenta de arquivo teve seu argumento path ou pattern contendo um byte nulo, que sistemas de arquivos e ferramentas de pesquisa não podem aceitar. Read, Write, Edit, NotebookEdit, Glob, e Grep verificam isso, e a mensagem nomeia a ferramenta e o argumento:

```text theme={null}
Read file_path cannot contain null bytes (\0). Remove the null byte and try again.
```

A chamada de ferramenta falha, Claude vê o erro, e o turno continua.

**O que fazer:**

* Nada da sua parte: o erro é retornado ao Claude como o resultado da ferramenta, e a mensagem em si diz ao Claude para remover o byte nulo e tentar novamente

Antes 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.

### Comando contém um caractere invisível

A [ferramenta PowerShell](https://code.claude.com/docs/pt/tools-reference.md#powershell-tool) se recusou a executar um comando que contém U+FEFF ou U+180E:

```text theme={null}
Error: command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run. Remove the character, keep the text that needs it in a file that the command reads, or write it as $([char]0xFEFF) or $([char]0x180E) inside a double-quoted string
```

**O que fazer:**

* **Para um comando que Claude escreveu**: você não tem nada a corrigir. A mensagem diz ao Claude como reescrever o comando.
* **Para um arquivo de skill ou de comando**: a mensagem vem após `No shell command in <name> was run`. Veja [onde encontrar o caractere e removê-lo](#no-shell-command-was-run).

### Comando aprovado não foi executado após o Claude Code reiniciar

Um comando de shell que você aprovou não foi executado, e Claude recebe esta mensagem como o resultado do comando:

```text wrap theme={null}
This call was not run. Claude Code could not confirm that the shell is back in the directory where it was approved. That directory may be gone or replaced, lie outside the directory where the session started, or be one that Claude Code needs approval to enter or is not allowed to examine. The shell's directory is <directory>. If the command still makes sense, cd to the directory it was meant for and make the call again; it may need approval again.
```

A terceira frase da mensagem pode, em vez disso, dizer `It does not keep track of that directory across a restart in a session that has been in a worktree.`

**O que fazer:**

* Deixe Claude continuar e responda ao prompt se for solicitado que você aprove o comando novamente.

### File is too large to read as an image

Claude tentou ler um arquivo como imagem com a [ferramenta Read](https://code.claude.com/docs/pt/tools-reference.md#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:

```text wrap theme={null}
File 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.
```

Quando 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:

```text wrap theme={null}
Cannot read this as an image: <path> is a pipe or a device, not a regular file, and it sent more than 128MB without ending.
```

**O que fazer:**

* 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
* 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
* Se o caminho era um pipe ou um dispositivo, aponte Claude para um arquivo de imagem regular em vez disso

### subagent\_type é obrigatório

```text theme={null}
subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...
```

Claude chamou a [ferramenta Agent](https://code.claude.com/docs/pt/tools-reference.md#agent-tool-behavior) sem um `subagent_type`, e essa sessão não tem [subagente de propósito geral](https://code.claude.com/docs/pt/sub-agents.md#built-in-subagents) para recorrer. Esse é o caso em duas configurações:

* [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](https://code.claude.com/docs/pt/env-vars) está definido em modo não interativo, que remove cada subagente integrado
* O agente de thread principal da sessão tem uma [allowlist `tools: Agent(...)`](https://code.claude.com/docs/pt/sub-agents#restrict-which-subagents-can-be-spawned) que deixa de fora `general-purpose`

**O que fazer:**

* Geralmente nada: a mensagem lista os subagentes que a sessão tem, então Claude pode tentar novamente com um deles
* Se Claude continuar falhando, adicione `general-purpose` à allowlist `tools: Agent(...)`, ou remova a definição de `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`

Antes da v2.1.235, a mesma chamada falhava com `Agent type 'general-purpose' not found`.

### Índice de memória está acima de seu limite de leitura

Claude escreveu no índice de [memória automática](https://code.claude.com/docs/pt/memory.md#auto-memory) `MEMORY.md` e o deixou acima de um de seus limites de leitura: 200 linhas ou 25KB. A escrita foi bem-sucedida, mas apenas as primeiras 200 linhas ou 25KB, o que vier primeiro, carregam no início de uma sessão, então tudo além do limite é descartado cada vez que o índice é lido. Antes da v2.1.210, um índice acima do limite era silenciosamente truncado no próximo carregamento sem sinal de tempo de escrita.

```text theme={null}
Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.
```

Apenas o conteúdo que carrega conta para os limites. Frontmatter YAML e comentários HTML em nível de bloco são removidos antes do índice ser carregado, então são excluídos da medição. Antes da v2.1.211, Claude Code media o arquivo bruto, e frontmatter ou comentários poderiam disparar esse erro mesmo quando o conteúdo carregado se encaixasse.

Claude Code entrega o erro ao Claude após a escrita em vez de imprimi-lo como um banner em seu terminal, então você pode notar apenas na transcrição.

Quando a escrita do Claude traz o arquivo perto de um limite sem cruzá-lo, Claude Code retorna um lembrete mais suave para compactar o índice em vez desse erro.

**O que fazer:**

* Deixe Claude reescrever `MEMORY.md`, ou peça a ele: mantenha uma linha por entrada, mova detalhes para arquivos de tópico, e mescle ou descarte entradas obsoletas
* Para aparar o índice você mesmo, veja [Audit and edit your memory](https://code.claude.com/docs/pt/memory.md#audit-and-edit-your-memory)

### Padrão pkill corresponde ao processo Claude Code

Um comando `pkill` em uma chamada de ferramenta Bash usou um padrão, tipicamente com `-f`, que corresponde ao próprio processo Claude Code, então Claude Code recusa o comando em vez de deixá-lo encerrar a sessão. Claude Code testa o padrão com `pgrep` antes de executar `pkill` e recusa quando seu próprio ID de processo está no resultado. A verificação é executada apenas em Linux; em macOS, `pkill` é executado sem modificações. Antes da v2.1.214, o comando era executado, e um padrão correspondente matava a sessão Claude Code no meio de um turno.

```text theme={null}
pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.
```

A recusa aparece no resultado da ferramenta Bash em vez de como um banner em seu terminal, e Claude geralmente ajusta o comando por conta própria.

**O que fazer:**

* Estreite o padrão para que corresponda apenas ao processo pretendido, por exemplo o caminho completo do binário alvo em vez de uma substring curta
* Para parar processos iniciados pelo shell atual, use `pkill -P $$` com o padrão, que limita a correspondência aos processos filhos do próprio shell

### Falha ao escrever na caixa de entrada de um colega

Claude Code não conseguiu escrever uma mensagem no arquivo de caixa de correio de um colega sob `~/.claude/teams/{team-name}/inboxes/`, então o destinatário não recebeu nada. A escrita falha quando Claude Code não consegue criar ou atualizar o arquivo, por exemplo porque o disco está cheio, o diretório não é gravável, ou outro agente mantém o bloqueio da caixa de entrada por muito tempo. Antes da v2.1.224, Claude Code relatava a mensagem como enviada mesmo quando a escrita falhava.

O erro aparece no resultado da ferramenta do agente remetente em vez de como um banner em seu terminal, e seu texto diz ao Claude para tentar novamente:

```text theme={null}
Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.
```

Mensagens de protocolo estruturadas de [equipe de agentes](https://code.claude.com/docs/pt/agent-teams.md) falham da mesma forma, e o erro nomeia a mensagem não entregue: quando Claude Code não consegue escrever uma aprovação de plano, rejeição de plano, solicitação de encerramento, ou rejeição de encerramento, o erro diz `Failed to write the <message> to <name>'s inbox — nothing was sent`. O `plan approval` nessa lista é a decisão do líder aprovando o plano de um colega; a submissão de plano do colega é a mensagem separada `plan approval request`. Essa mensagem e duas outras mensagens de protocolo carregam seu próprio texto de mensagem e consequência:

* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`: o plano do colega nunca chegou ao líder, e o colega permanece em modo de planejamento até uma resubmissão bem-sucedida
* `The permission request could not be delivered to the team lead (mailbox write failed)`: a solicitação de permissão do colega nunca chegou ao líder, então ninguém aprovou a chamada de ferramenta
* `The confirmation could not be written to team-lead's inbox.`: a aprovação de encerramento em si entrou em vigor e o colega sai; apenas a confirmação para o líder está faltando

Quando você mesmo envia uma mensagem a um colega, digitando `@name` seguido pela mensagem na sessão de liderança, a mesma falha aparece como uma notificação, `Couldn't write to @name's inbox — message not sent. Try again.`, e Claude Code mantém seu texto na caixa de prompt para que você possa enviá-lo novamente.

**O que fazer:**

* Peça ao remetente para reenviar a mensagem; contenção para o bloqueio da caixa de entrada é transitória e se resolve em uma nova tentativa
* Verifique espaço em disco livre, e verifique que `~/.claude/teams` e os arquivos sob ele são graváveis pelo seu usuário

### Definição de agente do colega não foi restaurada

Claude enviou uma mensagem a um colega de [equipe de agentes](https://code.claude.com/docs/pt/agent-teams.md) parado, e Claude Code o trouxe de volta sem reaplicar a [definição de subagente](https://code.claude.com/docs/pt/agent-teams.md#use-subagent-definitions-for-teammates) de que foi gerado. O aviso segue o relatório de retomada no resultado da ferramenta do agente remetente e nomeia a razão. Quando o arquivo de definição veio de uma pasta sem confiança salva, ele diz:

```text wrap theme={null}
Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.
```

A verificação se aplica a uma definição no diretório `.claude/agents/` do projeto ou de um diretório `--add-dir`, e aceitar o diálogo de confiança para uma pasta pai não a satisfaz.

**O que fazer:**

* Execute `claude` na pasta que o [log de debug](https://code.claude.com/docs/pt/debug-your-config.md) 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
* Ou defina a entrada `hasTrustDialogAccepted` para `true` em `~/.claude.json`, usando a chave exata `projects["<path>"]` que o log de debug imprime

### Only a teammate can approve a shutdown request

Claude Code recusou uma aprovação de encerramento de [equipe de agentes](https://code.claude.com/docs/pt/agent-teams.md) 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:

```text wrap theme={null}
Only 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.
```

**O que fazer:**

* 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.
* 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](https://code.claude.com/docs/pt/agent-teams.md#shut-down-teammates).
* 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.

### A command-line deny rule cannot be handed to a teammate intact

Esta mensagem significa que Claude Code não iniciou um colega em [painel dividido](https://code.claude.com/docs/pt/agent-teams.md#choose-a-display-mode) na sua [equipe de agentes](https://code.claude.com/docs/pt/agent-teams.md). Claude Code passa as regras de negação de linha de comando do líder para um colega em painel dividido na própria linha de comando do colega, e para quando o colega interpretaria uma delas de forma diferente:

```text wrap theme={null}
The deny rule "<rule>" cannot be handed to a teammate intact, so the teammate was not started. Remove that rule or move it to permissions.deny in settings, then try again.
```

**O que fazer:**

* Execute `/config` na sessão de liderança e defina **Teammate mode** como `in-process`. Se a linha disser `overridden` e já mostrar `in-process`, percorra os valores até voltar a ele. Então peça ao Claude para iniciar o colega novamente. Um colega in-process [é executado sob as regras de negação ativas do líder](https://code.claude.com/docs/pt/agent-teams.md#permissions).
* Sessões posteriores que obtêm [`teammateMode`](https://code.claude.com/docs/pt/settings-reference#teammatemode) das suas configurações de usuário também iniciam colegas in-process, porque `/config` salva a escolha lá. Para voltar a painéis divididos em uma sessão posterior, defina **Teammate mode** como `auto`, `tmux` ou `iterm2`, o que você usava antes.

### Mensagem muito grande para entrega entre sessões

A [mensagem entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md) 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:

```text wrap theme={null}
Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.
```

Reenviar o mesmo texto falha da mesma forma.

**O que fazer:**

* Peça ao Claude para resumir a mensagem, ou para colocar o conteúdo em massa em um arquivo e enviar o caminho do arquivo
* Peça ao Claude para dividir o conteúdo em várias mensagens mais curtas

Antes da v2.1.235, Claude Code relatava uma mensagem superdimensionada como enviada. A sessão receptora a descartava sem ler.

### Muitas mensagens para essa sessão agora

Claude enviou uma rajada rápida de [mensagens entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md) para uma de suas sessões nesta máquina, e a rajada atingiu o que a caixa de entrada dessa sessão aceita. Claude Code recusou o próximo envio, e a sessão receptora não recebeu nada dele. A recusa aparece no resultado da ferramenta da sessão remetente, não como um banner em seu terminal:

```text wrap theme={null}
Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.
```

**O que fazer:**

* Geralmente nada: Claude agrupa o conteúdo restante em uma mensagem, ou espera antes de enviar mais
* Se você mesmo disparou a rajada, peça ao Claude para combinar o que resta em uma única mensagem

Antes da v2.1.236, Claude Code relatava esses envios como enviados. A sessão receptora os descartava sem ler.

### Mensagem entre sessões foi descartada na caixa de entrada da sessão receptora

Claude enviou uma [mensagem entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md) para outra de suas sessões nesta máquina, e a caixa de entrada dessa sessão a descartou antes de Claude nessa sessão lê-la. A linha nomeia o destinatário e, quando o destinatário deu uma razão, adiciona a razão após um travessão:

```text wrap theme={null}
Cross-session message was dropped at the recipient session's inbox (recipient: uds:/tmp/cc-socks/13605.sock) and not delivered — its queue of undelivered peer messages was full. Claude was told not to resend right away.
```

Uma linha pode cobrir várias mensagens descartadas. Ela então começa no plural, por exemplo `Cross-session messages (12) were dropped`. Para encontrar a qual sessão um endereço pertence, compare-o com a [linha `Peer address`](https://code.claude.com/docs/pt/cross-session-messaging#the-sessions-inbox-socket) que `/status` mostra em cada sessão.

Após o travessão, a linha dá uma ou mais dessas razões:

* `its queue of undelivered peer messages was full`: o destinatário já mantinha tantas mensagens não entregues de outras sessões quanto sua fila permite
* `you sent faster than that session accepts`: as mensagens da sessão remetente chegaram mais rápido do que o destinatário aceita de um remetente
* `it repeated your previous message`: a mensagem era idêntica a uma que a sessão remetente enviou a esse destinatário pouco antes
* `a relay loop between sessions was cut`: a mensagem continuava uma longa [cadeia de respostas que pode ser interrompida](https://code.claude.com/docs/pt/cross-session-messaging.md#limitations), como uma que inclui uma sessão fora desta máquina

**O que fazer:**

* Assuma que o destinatário nunca viu as mensagens descartadas. Claude Code diz o mesmo ao Claude, e diz a ele para incluir qualquer coisa que ainda importe em uma mensagem posterior em vez de reenviar imediatamente
* Se suas sessões enviam umas às outras atualizações frequentes, peça ao Claude para enviar menos mensagens e maiores, como um relatório quando uma sessão termina seu trabalho
* Para `a relay loop between sessions was cut`, digite você mesmo a próxima instrução em uma das sessões. Uma mensagem que Claude envia em resposta ao seu próprio prompt começa uma nova cadeia

Antes da v2.1.238, a sessão remetente não recebia relatório quando a caixa de entrada do destinatário descartava uma mensagem.

### Recusando enviar uma mensagem entre sessões

Antes de Claude Code escrever uma [mensagem entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md) para outra de suas sessões nesta máquina, ele verifica que o socket da caixa de entrada da sessão alvo é o endpoint para o qual a mensagem foi endereçada. Quando uma verificação falha, Claude Code recusa o envio na sessão remetente, e a sessão alvo não recebe nada. Para uma mensagem que Claude envia, a recusa aparece no resultado da ferramenta da sessão remetente:

```text theme={null}
Failed to send to api-worker: Refusing to send: reply target is a symlink
```

O texto após `Refusing to send:` nomeia a verificação que falhou:

* `reply target is a symlink`: um link simbólico fica no caminho do socket da sessão alvo. Claude Code não entrega através dele, porque um link lá poderia redirecionar a mensagem para um endpoint que a sessão alvo não criou.
* `cannot vet reply target`: Claude Code não conseguiu inspecionar o caminho alvo de forma alguma, por exemplo porque lê-lo falhou com um erro de permissão.

**O que fazer:**

* Geralmente nada: as verificações impedem que uma mensagem chegue a um endpoint diferente da sessão para a qual foi endereçada, e nada foi enviado
* Se `reply target is a symlink` se repete para uma sessão, verifique o que criou um link no caminho do socket dessa sessão, mostrado em seu `/status` sob `Peer address`

### Recusando ler, escrever, ou pesquisar um caminho

Claude Code verifica as [regras de permissão](https://code.claude.com/docs/pt/permissions.md#read-and-edit) de um caminho de arquivo, então confirma essa resolução novamente quando a ferramenta abre o arquivo ou inicia a pesquisa. Quando não consegue confirmar que o caminho ainda leva ao local que a verificação aprovou, Claude Code recusa a operação em vez de segui-la. A recusa aparece no resultado da ferramenta:

```text wrap theme={null}
Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.
```

Cada recusa nomeia sua razão:

* `its symlink resolution changed after permission was checked`: um symlink ao longo do caminho, ou em uma raiz de pesquisa Grep ou Glob, foi substituído entre a verificação de permissão e a operação. Em uma recusa de leitura, a frase entre parênteses nomeia qual comparação falhou.
* `its parent-directory symlink resolution changed after permission was checked`: um diretório pelo qual o caminho de escrita passa não se resolve mais para o local aprovado
* `where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve)`: Claude Code não conseguiu seguir o caminho até um local final no disco, por exemplo porque symlinks nele formam um loop
* `it is a symbolic link. Write to the link's target path instead`: um link simbólico fica no próprio local de escrita solicitado, por exemplo um `CLAUDE.md` que é um symlink para `AGENTS.md`; a mensagem direciona Claude para o alvo do link
* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: a mesma condição capturada quando outro escritor abre o arquivo, como uma escrita em um `.mcp.json` que é um symlink
* `Refusing to write into symlinked directory: <path>`: o diretório que contém o arquivo é em si um link simbólico, por exemplo o diretório `.claude/` de um projeto vinculado a outro local
* `a path one of its Read deny rules is written through changed while the search was being prepared. Retry.`: uma regra de negação `Read` para a pesquisa nomeia um caminho que passa através de um symlink, e esse link mudou enquanto Claude Code estava preparando a pesquisa
* `it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.`: a raiz de pesquisa existe mas não pôde ser aberta; o código entre parênteses é o erro do sistema operacional
* `its permission check expired before it ran (too many concurrent file operations). Retry.`: Claude Code descartou o registro de aprovação sob muitas operações de arquivo simultâneas antes de a ferramenta usá-lo; tentar novamente executa uma nova verificação de permissão
* `ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration`: Claude Code não conseguiu resolver o binário `rg` para um caminho absoluto, então recusa pesquisas fora do diretório de trabalho em vez de executar uma que suas regras de negação não cobrem

**O que fazer:**

* Geralmente nada: a recusa chega ao Claude como o resultado da ferramenta, e a operação recusada não é executada
* Se uma recusa de symlink se repete em um caminho, encontre o que continua reescrevendo um link lá, como uma ferramenta de build ou observador de arquivos, ou peça ao Claude para usar o caminho resolvido do arquivo em vez do vinculado
* Se essa recusa aparece para cada arquivo enquanto Claude Code é executado no Windows dentro de um AppContainer ou sandbox de token restrito, atualize para v2.1.265 ou posterior
* Se uma recusa de leitura aparece em macOS para um arquivo que nada está reescrevendo, como uma captura de tela arrastada para o prompt, atualize para v2.1.273 ou posterior
* Para a recusa de ripgrep, instale ripgrep com seu gerenciador de pacotes para que `rg` se resolva para um caminho absoluto em `PATH`, ou mantenha pesquisas sob o diretório de trabalho

Antes da v2.1.251, Claude Code verificava novamente a resolução de um caminho apenas para escritas de arquivo, então um link substituído após a verificação de permissão poderia redirecionar uma leitura ou pesquisa para um local diferente sem uma mensagem. Desses, apenas as recusas de escrita de diretório pai, através de symlink, e diretório que é symlink aparecem em versões anteriores.

Antes da v2.1.280, a recusa `where it leads on disk could not be determined` não aparecia.

### The search failed, so this is not a "no matches" result

Uma pesquisa [Grep](https://code.claude.com/docs/pt/tools-reference.md#grep-tool-behavior) ou [Glob](https://code.claude.com/docs/pt/tools-reference.md#glob-tool-behavior) que Claude executou falhou antes de retornar qualquer resultado, então não se sabe se existem correspondências. A mensagem que Claude recebe no lugar dos resultados começa:

```text wrap theme={null}
The search failed, so this is not a "no matches" result: matches may exist. What happened to the search program (ripgrep) is not known, and no results were read. Run the search once more. If it fails again, tell the user that searches are failing.
```

**O que fazer:**

* **Na primeira vez que aparecer**: nada. A mensagem pede ao Claude que pesquise novamente primeiro.
* **Se Claude disser que as pesquisas estão falhando**: capture o erro do ripgrep para um relatório de bug:
  1. No seu shell, inicie uma sessão com as mesmas flags da sessão em que as pesquisas falharam, mais [`--debug-file claude-debug.log`](https://code.claude.com/docs/pt/cli-reference#cli-flags)
  2. Envie ao Claude a solicitação que levou à pesquisa que falhou
  3. Se a pesquisa falhar novamente, encontre a linha contendo `rg error (signal=` em `claude-debug.log`
  4. Inclua essa linha ao [relatar o problema](#report-an-error)

### Troca de saída de tarefa recusada

Claude Code salva a saída de cada comando Bash em um arquivo sob seu diretório temporário. Toda vez que abre um desses arquivos, verifica que o caminho ainda leva ao arquivo que criou, sem link simbólico, link físico extra, ou diretório movido redirecionando-o. Essa mensagem significa que essa verificação falhou, então Claude Code recusou a operação em vez de escrever ou ler saída através desse caminho. A mensagem aparece no resultado da ferramenta Bash:

```text wrap theme={null}
task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.
```

O texto entre parênteses nomeia a verificação que falhou. Razões como `output symlink was re-pointed`, `output file identity changed`, e `not a regular file` todas relatam a mesma condição: algo no ou ao longo do caminho de saída não é mais o arquivo que Claude Code criou. Apenas algumas razões carregam uma frase `To recover:`.

Se a verificação falhar enquanto um comando ainda está em execução, Claude Code para o comando, e seu resultado relata:

```text theme={null}
Command killed: its output file was replaced or could no longer be verified
```

**O que fazer:**

* Atualize para v2.1.260 ou posterior. Versões anteriores às vezes mostravam essa mensagem quando nenhum link ou diretório movido estava presente
* Reinicie Claude Code com [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/pt/env-vars) definido para um diretório novo
* Ou verifique o diretório do seu projeto sob o diretório temporário do Claude Code, `/private/tmp/claude-501/-Users-you-my-project` na mensagem de exemplo. Se esse caminho é um link simbólico, ou um diretório que não deveria estar lá, remova o link ou diretório em si em vez do alvo do link, e reinicie Claude Code
* Se a recusa se repete, um processo está substituindo, vinculando, ou removendo entradas sob o diretório temporário do Claude Code enquanto a sessão é executada. Defina [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/pt/env-vars) para um diretório que nada mais gerencia e reinicie

### Disco cheio ou cota de disco esgotada

Libere espaço, inodes ou cota de disco no volume que contém o diretório temporário do Claude Code. Uma linha no resultado de um comando que começa com `Disk full:`, `Disk quota used up:` ou `Nearly out of inodes:` nomeia esse diretório.

Claude Code salva a saída de cada comando Bash e PowerShell em um arquivo sob esse diretório. Se não conseguir criar esse arquivo porque o volume ou sua cota nele está cheio, seu comando não é iniciado, e o resultado que Claude lê é:

```text wrap theme={null}
The command was not started: this computer's disk is full (ENOSPC) on the volume holding /tmp/claude-501 (Claude Code's temporary directory), so the file that captures command output could not be created there and nothing ran. Free space on that volume, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another one, then retry. If this is the user's own computer, tell them before deleting anything to make room.
```

As mensagens `Disk full:`, `Disk quota used up:` e `Nearly out of inodes:` seguem um comando que foi executado e saiu com um código diferente de zero. Por exemplo:

```text wrap theme={null}
Disk full: this computer's volume holding /tmp/claude-501 (Claude Code's temporary directory) has 3 MB free, so whatever this command printed was lost and its own writes may have failed with "No space left on device". Free space on that volume, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another one, then retry. If this is the user's own computer, tell them before deleting anything to make room.
```

**O que fazer:**

* No macOS e no Linux, execute `df -h <dir>` no seu shell para ver qual volume contém o diretório e quão cheio ele está. `df -i <dir>` mostra quantos inodes estão livres. `<dir>` é o diretório que sua mensagem nomeia, como em `df -i /tmp/claude-501`
* **`Disk full: this computer's volume` ou `disk is full (ENOSPC)`**: em qualquer lugar desse volume, delete arquivos de que você não precisa
* **`Disk quota used up:`, `disk quota is used up (EDQUOT)` ou `Disk full: a test write`**: delete seus próprios arquivos nesse volume, mesmo que ele ainda mostre espaço livre
* **`Nearly out of inodes:`**: delete muitos arquivos nesse volume. Cada um ocupa um inode qualquer que seja seu tamanho, então o que importa é a quantidade deles, não o tamanho
* Ou reinicie Claude Code com [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/pt/env-vars) definido para um diretório em um volume com espaço
* Então peça ao Claude para executar o comando novamente

Antes da v2.1.309, as mensagens diziam o seguinte, e os mesmos passos se aplicam:

* `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)`
* `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)`
* `Command output was lost: the temp filesystem at <dir> is full` ou `... is out of inodes`
* `The command was not started: this computer's disk is full (ENOSPC), so the file that captures command output could not be created. Nothing ran.`, ou o mesmo com `(EDQUOT)`. Esta forma não nomeia nenhum diretório: procure no volume que contém o diretório temporário do seu sistema, como `/tmp`, ou o diretório definido em `CLAUDE_CODE_TMPDIR`

Antes 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`.

### git is not installed on this Mac

Esta mensagem significa que uma etapa no Claude Code precisava do git, e o git que ele encontrou é o substituto da Apple em `/usr/bin/git`. As ferramentas de desenvolvedor que fornecem o git não estão instaladas.

Claude Code não inicia o substituto e mostra este texto em vez disso, por exemplo dentro de uma mensagem mais longa:

```text wrap theme={null}
git is not installed on this Mac. To install it, run xcode-select --install, then try again.
```

**O que fazer:**

* No Terminal, execute `xcode-select --install`, conclua a instalação que ele inicia e, em seguida, tente novamente o que você estava fazendo no Claude Code

### File is not valid UTF-8

Claude usou a ferramenta Edit ou NotebookEdit em um arquivo cujos bytes não decodificam como UTF-8, e Claude Code recusou a alteração. Nada foi escrito, então o arquivo está como estava. Essas ferramentas salvam o arquivo inteiro de volta como UTF-8, o que teria transformado cada byte que não conseguissem decodificar no caractere de substituição `U+FFFD`. A mensagem aparece no resultado da ferramenta:

```text wrap theme={null}
File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary. This tool saves the whole file as UTF-8, which would replace every byte it cannot decode with U+FFFD. Nothing was written. Make the change with a shell command that reads and writes the file in its own encoding, or ask the user whether to convert the file to UTF-8 first.
```

Um arquivo que deveria ser UTF-8 também recebe essa mensagem quando contém até mesmo uma única sequência de bytes inválida, porque a verificação cobre os bytes do arquivo como um todo.

**O que fazer:**

* Para manter o arquivo em sua codificação atual, deixe Claude fazer a alteração com um comando de shell que lê e escreve o arquivo nessa codificação, como a mensagem diz a ele para fazer
* Para continuar editando o arquivo com a ferramenta Edit, converta-o para UTF-8, ou corrija os bytes inválidos em um arquivo que deveria ser UTF-8, e então peça ao Claude para fazer a edição novamente

Antes da v2.1.296, Edit e NotebookEdit aplicavam tal edição e salvavam cada byte que não conseguiam decodificar como `U+FFFD`. Nessas versões, atualize Claude Code.

### Refusing to apply edits: a hook is configured for file edits in this session

Claude tentou publicar um [artefato](https://code.claude.com/docs/pt/artifacts.md) com uma [atualização em uma etapa](https://code.claude.com/docs/pt/artifacts.md#turn-off-one-step-artifact-updates), uma pequena alteração no arquivo do artefato incluída na publicação, e Claude Code recusou. Nada foi publicado e o arquivo permanece inalterado. A mensagem aparece no resultado da ferramenta Artifact:

```text wrap theme={null}
Refusing to apply edits to <path>: a hook is configured for file edits in this session, so a publish can't apply edits here. Edit the file, then publish it without edits. Nothing was published.
```

Claude Code não permite atualizações em uma etapa enquanto sua sessão tem um [hook `PreToolUse`](https://code.claude.com/docs/pt/hooks#pretooluse) ou [mod](https://code.claude.com/docs/pt/plugins/mods/overview.md) em `Edit` ou `Write`.

**O que fazer:**

* Nada, se Claude prosseguiu editando o arquivo e publicando-o
* Se Claude parou na mensagem, peça ao Claude para editar o arquivo e publicar
* Se a mensagem continuar voltando, saia e reinicie o Claude Code
* Se a mensagem voltar mesmo após reiniciar, [desative as atualizações em uma etapa](https://code.claude.com/docs/pt/artifacts.md#turn-off-one-step-artifact-updates)

### O arquivo de origem não é texto UTF-8 válido

Claude tentou publicar um [artefato](https://code.claude.com/docs/pt/artifacts.md) de um arquivo cujos bytes não decodificam como texto, ou cujo texto já contém o caractere de substituição `U+FFFD`, então Claude Code recusou a publicação antes de fazer upload de qualquer coisa. A mensagem aparece no resultado da ferramenta Artifact e nomeia a primeira posição a corrigir:

```text wrap theme={null}
file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.

file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as &#xFFFD;), then publish again. Nothing was published.
```

Claude Code decodifica o arquivo como UTF-8, ou como UTF-16 quando começa com uma marca de ordem de byte UTF-16 little-endian. Quando tal arquivo UTF-16 não decodifica, a primeira mensagem nomeia `UTF-16` e ainda diz a você para reescrever o arquivo como UTF-8. Quando mais posições seguem a nomeada, a mensagem adiciona uma contagem como `(+2 more)` após a posição.

**O que fazer:**

* Geralmente nada: Claude reescreve o arquivo e publica novamente
* Se o arquivo é um que você escreveu ou exportou, salve-o novamente como UTF-8, e substitua cada `U+FFFD` pelo caractere que uma edição, colagem, ou conversão anterior perdeu
* Para mostrar um `U+FFFD` intencional na página, escreva-o como `&#xFFFD;` no HTML em vez do caractere literal

Antes da v2.1.267, Claude Code fazia upload de tal arquivo sem verificá-lo, e o servidor recusava a publicação em vez disso.

### Não publicado: esse arquivo está em um compartilhamento de rede

Claude tentou publicar um [artefato](https://code.claude.com/docs/pt/artifacts.md) de um arquivo em um caminho que nomeia um host de rede:

* No Windows, um caminho `\\server\share` que não está sob uma unidade de rede mapeada que você passou na inicialização com [`--add-dir`](https://code.claude.com/docs/pt/cli-reference#cli-flags)
* No macOS ou Linux, um caminho de automount como `/net/<host>/page.html`

Consultar tal caminho contata o host que ele nomeia, e no Windows esse contato pode enviar suas credenciais ao host. Claude Code se recusa a publicar o arquivo e não o lê. A recusa aparece no resultado da ferramenta Artifact:

```text theme={null}
Not published: that file is on a network share. Publish a file from this session's folders instead.
```

**O que fazer:**

* Nada, se você não precisa desse arquivo exato: a mensagem diz ao Claude para publicar um arquivo das próprias pastas da sessão em vez disso
* Para publicar esse arquivo exato, copie-o para uma pasta em um disco local e peça novamente
* 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.
* 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

### Not published: Claude sent the same content again after a newer version of the artifact turned it away

Esta linha vermelha sob uma chamada Artifact significa que Claude Code interrompeu uma publicação repetida: o [artefato](https://code.claude.com/docs/pt/artifacts.md) 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.

Anteriormente na sessão, Claude Code recusou uma publicação porque o artefato tinha uma versão mais recente, por exemplo uma que um [editor](https://code.claude.com/docs/pt/artifacts.md#let-someone-edit-with-you) ou outra de suas sessões publicou. O final da linha diz o que Claude precisa fazer a seguir:

```text wrap theme={null}
Not 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.
Not 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.
Not 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.
Not 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.
```

**O que fazer:**

* **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
* **Termina com `should go through`**: se Claude parou aí, peça a ele para publicar novamente

### Lendo um arquivo local de fora das pastas conectadas em uma sessão Cowork

Em 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](https://code.claude.com/docs/pt/artifacts.md). 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.

A recusa aparece no resultado da ferramenta Artifact; quando o arquivo não pôde ser examinado de forma alguma, ela nomeia essa falha em vez disso:

```text wrap theme={null}
Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.

cannot read file_path (ENOENT) — the file could not be examined, and no one can answer the approval card in this Cowork session. Check that the file exists as a plain file inside the connected folders, then retry with that path.
```

**O que fazer:**

* Geralmente nada: a mensagem diz ao Claude para usar um arquivo simples dentro das pastas conectadas em vez disso
* Para colocar esse arquivo exato no artefato, copie-o para uma das pastas conectadas da sessão como um arquivo regular, não um symlink, e peça novamente

### WebFetch não consegue buscar localhost

Claude chamou [WebFetch](https://code.claude.com/docs/pt/tools-reference.md#webfetch-tool-behavior) com uma URL cujo nome de host não tem ponto, como `http://localhost:3000` ou um nome de intranet simples como `http://wiki/`. WebFetch recusa essas URLs antes de fazer qualquer requisição:

```text wrap theme={null}
WebFetch cannot fetch localhost or other hostnames without a dot. To reach a local server, use Bash with curl instead.
```

**O que fazer:**

* Geralmente nada: a mensagem aponta Claude para `curl` através da ferramenta Bash, que pode alcançar servidores locais e de intranet

Antes da v2.1.268, WebFetch relatava essas URLs com um erro genérico `Invalid URL`.

### Claude Code is unable to fetch from a host

WebFetch envia o nome de host de uma URL para `api.anthropic.com` antes de requisitar a página, para verificá-lo contra a lista de bloqueio de segurança de domínio da Anthropic. Esta mensagem significa que a verificação respondeu que o nome de host não pode ser buscado:

```text wrap theme={null}
Claude Code is unable to fetch from example.com
```

Claude Code não contatou o host, porque a verificação é executada antes da requisição.

Para saber o que a verificação envia, veja [Verificação de segurança de domínio do WebFetch](https://code.claude.com/docs/pt/data-usage.md#webfetch-domain-safety-check).

### Verificação de segurança de domínio WebFetch falhou

Antes de buscar uma URL, WebFetch envia o nome de host da URL para `api.anthropic.com` para verificá-lo contra a [lista de bloqueio de segurança de domínio](https://code.claude.com/docs/pt/data-usage.md#webfetch-domain-safety-check) da Anthropic. Se a verificação não puder ser concluída, WebFetch não consegue confirmar que o domínio é seguro, então não busca a página e o resultado da ferramenta carrega uma dessas mensagens em vez disso:

```text wrap theme={null}
The safety check for domain example.com is rate-limited (too many domain checks from this network; the limit is shared and can stay exhausted for minutes). Do not retry WebFetch in a loop or sleep to wait it out; continue without this page and report that its safety check was rate-limited. A single later attempt is fine; if that is rate-limited too, stop.

Unable to verify if domain example.com is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.
```

* `rate-limited`: o endpoint de verificação respondeu com HTTP `429`. A mensagem diz ao Claude para continuar sem a página e para tentar novamente no máximo uma vez depois. Claude Code não armazena em cache uma verificação que falhou, então uma busca posterior desse domínio executa a verificação novamente. Se sessões em sua rede atingem isso com frequência, você pode pular a verificação com [`skipWebFetchPreflight: true`](https://code.claude.com/docs/pt/settings-reference#skipwebfetchpreflight) em settings.
* `Unable to verify`: a requisição de verificação falhou, expirou, ou recebeu outro status de erro. Se sua rede bloqueia `api.anthropic.com`, adicione esse domínio à allowlist, ou pule a verificação com [`skipWebFetchPreflight: true`](https://code.claude.com/docs/pt/settings-reference#skipwebfetchpreflight) em settings.

Antes da v2.1.286, a mensagem de rate limit dizia `The safety check for domain example.com is temporarily rate-limited (too many domain checks from this network). Retry after about a minute; retrying sooner will fail the same way.`.
Antes da v2.1.285, uma verificação atingida pelo rate limit era relatada com a mensagem `Unable to verify` em vez disso.

## Erros de sessão em background

As [sessões em background](https://code.claude.com/docs/pt/agent-view.md) são executadas sem um terminal interativo próprio, portanto os comandos que precisam de um se comportam de forma diferente lá. Essas mensagens aparecem na transcrição de uma sessão em background, no terminal que se conecta a uma, na sessão ou shell de onde você a despacha, ou, para as [entradas worktree-guard](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) abaixo, em qualquer sessão isolada em um worktree ou executando um subagente isolado em worktree; quando uma mensagem é específica de uma superfície, sua entrada diz isso.

### Comandos recusados em uma sessão em background

Comandos que abrem um diálogo interativo não podem fazer isso enquanto nenhum terminal está conectado a uma sessão em background. `/install-github-app`, a lista de configurações `/mcp`, e as ações de autenticação no menu do servidor MCP respondem com uma mensagem. Para `/install-github-app` e a lista de configurações `/mcp`, a sessão também aparece sob **Needs input** na [agent view](https://code.claude.com/docs/pt/agent-view.md) para que você possa encontrá-la, conectar e executar o comando novamente. Enquanto um terminal está conectado, esses comandos funcionam normalmente.

Antes da v2.1.216, a sessão não aparecia sob **Needs input** após `/install-github-app` ou a lista de configurações `/mcp` ser recusada. Na v2.1.213 até v2.1.215, os comandos ainda funcionavam enquanto um terminal estava conectado, e a mensagem de recusa dizia para você conectar e executar o comando novamente. De v2.1.208 até v2.1.212, Claude Code recusava-os mesmo enquanto um terminal estava conectado, com uma mensagem como `Can't open MCP settings in a background session`; nessas versões, execute o comando de uma sessão `claude` regular, ou atualize. Antes da v2.1.208, eles abriam seu diálogo dentro da sessão em background. Na v2.1.208 apenas, Claude Code também recusava o seletor `/model` em uma sessão em background, e `/upgrade` imprimia a URL de atualização em vez de abrir um navegador.

A redação nomeia o comando. A lista de configurações `/mcp` relata:

```text theme={null}
Can't open MCP settings while no terminal is attached to this background session. This session now shows "needs input" in agent view — open it and run /mcp to manage servers, or use `/mcp enable|disable|reconnect <server>` to steer without the panel.
```

**O que fazer:**

* Conecte à sessão a partir da agent view e execute o comando novamente
* Ou use o formulário que a mensagem nomeia, como `/mcp reconnect <server>`, `/mcp enable`, ou `/mcp disable`, que funcionam sem conectar

### Write ou command bloqueado porque o caminho não pode ser resolvido com segurança

Claude abordou um arquivo ou diretório de trabalho através de uma grafia que o [worktree-isolation guard](https://code.claude.com/docs/pt/agent-view.md#how-file-edits-are-isolated) não consegue resolver para um local verificável. O guard verifica writes e diretórios de trabalho de comando em [qualquer sessão isolada em um worktree](https://code.claude.com/docs/pt/worktrees.md#how-claude-code-enforces-isolation), interativa ou background, e em [subagentes isolados em worktree](https://code.claude.com/docs/pt/worktrees.md#isolate-subagents-with-worktrees). Ele resolve symlinks antes de verificar que a operação não atinge o checkout compartilhado, e quando a resolução falha, ele bloqueia a operação em vez de deixá-la chegar lá. A mensagem nomeia as formas de caminho que recusa e como tentar novamente:

```text theme={null}
This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.
```

Um comando bloqueado relata a mesma causa para seu diretório de trabalho e termina com `re-run the command from its direct symlink-free path`. Antes da v2.1.217, o guard comparava grafias de caminho sem resolver symlinks, portanto essas grafias não eram bloqueadas e um write roteado através de um symlink poderia chegar ao checkout compartilhado.

**O que fazer:**

* Geralmente nada: a mensagem completa vai para Claude como um erro de ferramenta, e Claude tenta novamente com o caminho direto que nomeia. Para um edit de arquivo bloqueado, a visualização de conversa mostra apenas uma linha curta `Error editing file`; a mensagem completa aparece na visualização de transcrição, que você abre com `Ctrl+O`. Um comando bloqueado a imprime em sua saída de comando.
* Se o bloqueio se repetir no mesmo arquivo, o caminho provavelmente passa por um symlink incluído em um commit cujo alvo contém `..`, como `docs/current -> ../README.md`; peça a Claude para editar o arquivo de destino por seu caminho real em vez de através do link

### Write ou command bloqueado porque o caminho nomeia um local de rede

Claude abordou um arquivo ou diretório de trabalho através de um caminho que nomeia uma unidade que não está em sua máquina, um compartilhamento UNC como `\\server\share\file` ou um caminho de automontagem `/net`, enquanto o checkout da sessão está em um disco local. O mesmo [worktree-isolation guard](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) não consegue verificar que tal caminho fica fora do checkout compartilhado, portanto bloqueia a operação. Isolar a sessão em um worktree não levanta o bloqueio. A mensagem nomeia a forma de caminho a usar em vez disso:

```text theme={null}
This write was blocked because the path is network-shaped (a UNC share or /net automount spelling) while this session's checkout is local. Isolating cannot unblock it. If the file is genuinely inside the worktree /path/to/worktree, address it by its local, plainly-spelled path instead.
```

Um comando bloqueado relata a mesma causa para seu diretório de trabalho e termina com `re-run the command from its local, plainly-spelled path`. Antes da v2.1.217, o guard comparava apenas texto de caminho, portanto endereçar um arquivo dentro do checkout através de um caminho UNC ou `/net` não era bloqueado.

**O que fazer:**

* Geralmente nada: Claude tenta novamente com a grafia local que a mensagem pede

### Comando bloqueado pelas verificações de isolamento de worktree

Claude executou um comando Bash, [PowerShell](https://code.claude.com/docs/pt/tools-reference.md#powershell-tool) ou [Monitor](https://code.claude.com/docs/pt/tools-reference.md#monitor-tool) em uma [sessão isolada em um worktree](https://code.claude.com/docs/pt/worktrees.md#how-claude-code-enforces-isolation), e Claude Code recusou-o por uma destas razões:

* O comando seria executado no checkout principal ou em outro worktree. A mensagem diz que seu diretório de trabalho `resolved to the shared checkout` ou `is in a different worktree`.
* Um comando Bash ou Monitor aponta git para o checkout principal.
* Claude Code não consegue verificar a partir do texto de um comando Bash ou Monitor que qualquer git que o comando executa fica dentro do worktree. Um comando que nunca nomeia git ainda pode ser recusado por essa razão, porque expandir uma indireção de variável como `${!name}` ou executar uma substituição de função Bash como `${ command; }` produz um valor em tempo de execução que pode ser um comando em si.

A mensagem diz `is isolated in the worktree <path>, but this command`, seguido pela razão, como um comando cujo texto Claude Code não conseguiu verificar:

```text wrap theme={null}
This session is isolated in the worktree /path/to/worktree, but this command evaluates ${!x@P} arithmetically inside a construct too complex to verify, which can run a command hidden in a variable's value. Refusing to run it — a worktree-isolated session's git operations must target its own worktree. Split it into plain, separate commands and run them from /path/to/worktree.
```

**O que fazer:**

* **Git apontado para o checkout principal, ou texto de comando que não pode ser verificado**: nada. Claude lê a mensagem e reescreve o comando da forma que sua sentença final pede. Se um comando que você pediu continua sendo recusado por causa de uma expansão em seu texto, escreva o valor sinalizado literalmente e execute git como seu próprio comando simples de dentro do worktree
* Para agir no checkout principal propositalmente, execute o comando você mesmo em um terminal fora da sessão

### Esta sessão não tem transcrição salva

Você se conectou a uma sessão que você [moveu para background](https://code.claude.com/docs/pt/agent-view.md#from-inside-a-session) com `←` ou `/background` e que parou antes de executar um turno próprio. Claude Code não conseguiu encontrar a conversa de onde você a moveu, portanto a sessão não tem nada para retomar. A mensagem termina com o comando `claude respawn` para esta sessão:

```text theme={null}
This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.
```

Abrir a mesma linha de sessão na [agent view](https://code.claude.com/docs/pt/agent-view.md) mostra `Press enter again to restart this session fresh` abaixo da lista em vez disso, e um segundo `Enter` na linha reinicia a sessão com uma conversa vazia.

**O que fazer:**

* Para iniciar a sessão parada do zero, execute `claude respawn <id>` com o ID da mensagem, ou pressione `Enter` duas vezes na sua linha na agent view
* Se a sessão terminou uma resposta e você ainda vê essa recusa em uma versão anterior à v2.1.214, uma pasta ilegível em `~/.claude/projects` poderia fazer a varredura de transcrição perder a conversa salva; atualize para v2.1.214 ou posterior, que tolera pastas ilegíveis durante a varredura

### Esta sessão está sendo executada em outro terminal

Você abriu a linha de uma sessão parada na [agent view](https://code.claude.com/docs/pt/agent-view.md), e sua conversa salva já está aberta em outro processo Claude Code ao vivo nesta máquina, portanto Claude Code recusa iniciar um segundo processo que escreveria na mesma transcrição. Qual mensagem você vê depende de [o que mantém a conversa](https://code.claude.com/docs/pt/agent-view.md#opening-a-session-says-the-conversation-is-already-open):

```text theme={null}
Can't open — this session is running in another terminal
This conversation is already open in another running Claude session — use that one, or close it and try again
```

* **`running in another terminal`**: um processo que não é uma sessão em background mantém a conversa, por exemplo uma execução de `claude -p`, ou um terminal onde você a retomou com `claude --resume` ou `/resume`. A linha também mostra `Open in a terminal`.
* **`already open in another running Claude session`**: outra [sessão em background](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process) a mantém.

**O que fazer:**

* Para `running in another terminal`: continue nesse terminal, ou saia desse processo ou deixe-o terminar, e depois tente novamente
* Para `already open in another running Claude session`: use essa sessão, ou pare-a e depois tente novamente

Antes da v2.1.248, apenas a recusa `already open in another running Claude session` existia: uma conversa retomada em um terminal não contava como aberta, e abrir a linha iniciava um segundo processo Claude Code escrevendo na mesma conversa.

### A conversa salva desta sessão não está mais no disco

Você abriu uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md) que terminou enquanto o serviço em background estava desligado, e [limpeza de transcrição](https://code.claude.com/docs/pt/settings-reference.md#cleanupperioddays) desde então removeu sua conversa salva, por exemplo após a máquina estar desligada por semanas. Abrir tal linha normalmente [retoma sua conversa salva](https://code.claude.com/docs/pt/agent-view.md#sessions-show-as-failed-after-shutdown). Sem nada para retomar, Claude Code recusa em vez de re-executar o prompt original da sessão sem perguntar:

```text theme={null}
This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` removes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.
```

`claude attach <id>` imprime este texto. Na agent view, o rodapé é mais curto e termina com `ctrl+x removes the row`.

**O que fazer:**

* Execute `claude rm <id>` para deletar a linha. Quando um dos [casos mantidos](https://code.claude.com/docs/pt/agent-view.md#what-deleting-a-session-removes) se aplica, `claude rm` mantém a linha e o worktree em vez disso e nomeia a razão
* Para executar o prompt original da sessão novamente como uma conversa fresca, execute `claude respawn <id>`

Antes da v2.1.248, abrir tal linha re-executava o prompt original da sessão em vez de recusar, puxando uma tarefa de semanas atrás para o primeiro plano.

### Worktree tem commits que não foram enviados para lugar nenhum

Você tentou deletar uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md#what-deleting-a-session-removes) cujo worktree contém commits que Claude Code não consegue confirmar que estão salvos em outro lugar. `claude rm` diz como proceder:

```text theme={null}
kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”
  2 unpushed commits on “claude/fix-login”: a1b2c3d “Fix login flow” and 1 more. They exist on no remote, so deleting the worktree would lose them.
  push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
```

Quando Claude Code não consegue resumir os commits, a linha de detalhe lê `The worktree has unpushed commits` em vez disso. Na [agent view](https://code.claude.com/docs/pt/agent-view.md), a linha da sessão mostra `not removed` com a mesma razão.

**O que fazer:**

* Para manter os commits, envie-os. Depois que o push os colocar em um branch de rastreamento remoto, como `origin/claude/fix-login`, tente deletar a sessão novamente.
* Se a mensagem oferecer descartar os commits, primeiro certifique-se de que você não precisa do worktree, dos commits nem de quaisquer mudanças sem commit. Depois siga o passo que a mensagem indica: pressione `Ctrl+X` duas vezes na linha da sessão na agent view, ou execute o comando `claude rm <id> --discard-unpushed <commit>@<worktree-id>` que `claude rm` imprimiu. Se Claude Code recusar novamente, siga a nova mensagem.
* Quando a mensagem diz que o worktree também é registrado por outra sessão terminada, deletar novamente não o descarta: envie os commits, depois tente deletar a sessão novamente

Antes da v2.1.268, `claude rm` colocava o resumo de commit na linha `kept` em si. Quando `claude rm` não conseguia resumir os commits, a linha `kept` lia `worktree has commits that are not pushed anywhere` no lugar do resumo.

Antes da v2.1.260, a mensagem não nomeava o branch ou os commits, e não havia uma forma de descartá-los. Você ainda pode deletar a sessão, perdendo as mudanças sem commit mas mantendo o branch e os commits. Execute `git worktree remove --force --force <path>` com o caminho que a recusa imprimiu, depois `claude rm <id>`. O Git precisa de `--force` duas vezes para um worktree bloqueado.

### Processo host do terminal morreu

Cada terminal de [sessão em background](https://code.claude.com/docs/pt/agent-view.md) é executado em um processo host sob o serviço em background, e esse processo morreu enquanto o serviço ainda mantinha sua conexão, portanto a sessão não pôde ser alcançada.

No Linux e WSL, o serviço em background verifica cada processo host a cada poucos segundos, marca a sessão como falha quando o processo saiu mas sua conexão com o serviço nunca fechou, e mostra a razão em sua linha na [agent view](https://code.claude.com/docs/pt/agent-view.md#read-session-state):

```text theme={null}
terminal host process died — press Enter to restart
```

Do shell, `claude attach <id>` reinicia uma sessão já marcada como falha por um host morto, e caso contrário imprime a causa e sai:

```text theme={null}
Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.
```

A conversa está salva de qualquer forma.

Uma linha executando um [comando shell](https://code.claude.com/docs/pt/agent-view.md#run-a-shell-command) em vez disso mostra `terminal host process died — its output is gone; the command was not run again`, e `claude attach` imprime `This command's terminal host process died — its output is gone and the command was not run again`. Claude Code nunca re-executa o comando para você.

**O que fazer:**

* Na agent view, pressione `Enter` na linha falha; a sessão reinicia em um novo processo host e a conversa retoma
* Do shell, execute `claude attach <id>` novamente. Claude Code imprime `Session <id>'s terminal host died — restarting it on a fresh one…` e reabre a sessão
* Você não consegue reiniciar uma linha de comando shell dessa forma; despache o comando novamente para re-executá-lo

Antes da v2.1.247, um processo host morto poderia passar em cada verificação de vivacidade que o serviço em background executava, portanto abrir a sessão mostrava `opening… · esc to cancel` indefinidamente e `claude attach <id>` esperava sem relatar um erro.

### Sessão não está respondendo

Você abriu uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md) e o serviço em background aceitou a abertura, mas nenhuma saída chegou por cerca de dez segundos, portanto Claude Code conclui que o processo retransmitindo o terminal da sessão não consegue entregar saída, e encerra a tentativa em vez de esperar.

Na agent view, Claude Code oferece um reinício no rodapé:

```text theme={null}
Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).
```

Do shell, `claude attach <id>` imprime a causa e sai:

```text theme={null}
Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).
```

Claude Code nunca reinicia uma linha executando um [comando shell](https://code.claude.com/docs/pt/agent-view.md#run-a-shell-command) para você, porque um reinício executaria o comando novamente.

**O que fazer:**

* Na agent view, pressione `Enter` na mesma linha novamente. Claude Code para o processo que não responde e reinicia a sessão, e a conversa retoma. Nada é parado sem esse segundo pressionamento
* Do shell, execute `claude stop <id>`, depois `claude attach <id>`
* Para uma linha de comando shell, pressione `Ctrl+X` na agent view ou execute `claude stop <id>` para pará-la; despache o comando novamente para re-executá-lo

### Sessão foi parada enquanto o respawn estava em voo

Você abriu uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md) cujo processo não estava em execução, e enquanto Claude Code estava reiniciando-a, outro processo Claude Code a parou, por exemplo `claude stop` em outro terminal. Claude Code mantém a sessão parada:

```text theme={null}
Session <id> was stopped while the respawn was in flight
```

Abrir uma sessão que você acabou de despachar, enquanto seu processo ainda está iniciando, espera pelo processo em vez disso. Antes da v2.1.246, abri-la naquele momento poderia pará-la e mostrar essa mensagem.

**O que fazer:**

* Se você não parou a sessão, abra sua linha novamente na agent view ou execute `claude respawn <id>` para reiniciá-la
* Se você a parou você mesmo, nada permanece a fazer: a sessão fica parada

### Agente de sessão não está mais disponível

Você retomou uma sessão que estava executando um [agente customizado](https://code.claude.com/docs/pt/sub-agents.md#invoke-subagents-explicitly), iniciado com `--agent` ou a configuração `agent`, e Claude Code não encontrou um agente com esse nome. Ele procura no diretório original da sessão primeiro, quando você [confiou naquele workspace](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust), depois no diretório de onde você retoma. A sessão ainda retoma, mas com as ferramentas padrão, portanto as restrições de ferramenta do agente não se aplicam mais:

```text theme={null}
This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.
```

O aviso nomeia apenas os diretórios que Claude Code procurou, e aparece na conversa retomada se você acordar uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md), executar `/resume` ou `claude --resume`, ou retomar em [modo não interativo](https://code.claude.com/docs/pt/headless.md), onde também vai para stderr. Sessões usando `--input-format stream-json` não o mostram, porque o Agent SDK fornece agentes após a inicialização.

Claude Code não salva o fallback na sessão, portanto o aviso se repete em cada retomada até você agir. O agente `claude` integrado não aciona o aviso, já que fazer fallback para o conjunto de ferramentas padrão não muda nada para ele. Antes da v2.1.216, Claude Code silenciosamente continuava como o agente padrão, e a busca cobria apenas o diretório de onde você retomava, portanto um agente com escopo de projeto era perdido em qualquer retomada de outro diretório.

**O que fazer:**

* Re-crie o arquivo de agente em `.claude/agents/<name>.md` no projeto da sessão, ou em `~/.claude/agents/<name>.md` para um agente pessoal, depois retome novamente
* Ou retome com `--agent <name>` nomeando um agente que existe, para executar a sessão como esse agente em vez disso
* Se o agente tem escopo de projeto e você não confiou no diretório original da sessão, execute Claude Code lá uma vez, aceite o diálogo de confiança, depois retome novamente

### Esta sessão reiniciou depois que seu próximo despertar do /loop estava previsto

Um [`/loop` autorregulado](https://code.claude.com/docs/pt/scheduled-tasks#let-claude-choose-the-interval) em uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md) parou. O processo da sessão terminou enquanto o loop estava esperando seu próximo despertar, e esse despertar venceu antes que o [próximo processo](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process) da sessão iniciasse. O despertar perdido não dispara com atraso. O aviso diz quão atrasado o despertar estava quando a sessão reiniciou:

```text theme={null}
This session restarted 12m after its next /loop wakeup was due, so that wakeup will not fire. The loop stays stopped until Claude schedules it again: reply to continue it.
```

Antes da v2.1.295, o loop parava nessa situação sem um aviso.

**O que fazer:**

* Para continuar o loop, [responda à sessão](https://code.claude.com/docs/pt/agent-view.md#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
* Se você terminou com o loop, não faça nada. Ele já parou

### No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder

A [sessão em background](https://code.claude.com/docs/pt/agent-view.md) que mostra esta mensagem não está usando seu [gateway de LLM](https://code.claude.com/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:

```text wrap theme={null}
No 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.
```

Enquanto você está conectado à sessão, o aviso sob seu prompt mostra a forma curta `No LLM gateway: opened from another folder · respawn from ~/project`.

Você 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](https://code.claude.com/docs/pt/agent-view.md#llm-gateway).

**O que fazer:**

* **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](https://code.claude.com/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.
* **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.
  * O gateway chega à sessão apenas quando o [supervisor](https://code.claude.com/docs/pt/agent-view.md#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`](https://code.claude.com/docs/pt/agent-view#dispatch-fails-with-could-not-resolve-authentication-method), depois execute o comando respawn novamente.

Antes 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.

### Erros do launcher CLAUDE\_CODE\_PROCESS\_WRAPPER

[`CLAUDE_CODE_PROCESS_WRAPPER`](https://code.claude.com/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:

```text theme={null}
CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
```

Um launcher que inicia mas sai sem se substituir por Claude Code falha a sessão que estava iniciando, e a linha da sessão na agent view relata que o launcher `must exec, not daemonize`, seguido por qualquer coisa que o launcher imprimiu. Uma sessão que não consegue iniciar ou alcançar o serviço em background por causa do launcher relata o problema do launcher como a razão dentro de `Couldn't reach the background service (...)`.

**O que fazer:**

* Defina a variável para o caminho absoluto de um executável que termina chamando `exec "$@"`. Veja [o contrato do launcher](https://code.claude.com/docs/pt/corporate-launcher.md#the-launcher-contract) para o contrato completo
* Verifique `/status`, que mostra o comando de inicialização resolvido em sua entrada Self-exec e avisa quando o serviço em background em execução não corresponde a ele, ou execute `claude daemon status` de um shell
* Após corrigir o valor no bloco `env` de [settings](https://code.claude.com/docs/pt/corporate-launcher.md#set-up-the-launcher), reinicie o serviço em background com `claude daemon stop --any` para que o próximo despacho inicie um envolvido

### EUNKNOWN ao iniciar uma sessão em background

Windows recusou iniciar um programa com um código de erro que não tem nome padrão, portanto a falha aparece como `EUNKNOWN`. O gatilho usual é uma política de restrição de software, como Group Policy ou AppLocker, bloqueando o programa sendo iniciado. O erro aparece quando você inicia uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md) com `/background` ou `claude --bg`:

```text theme={null}
Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'
```

Em algumas contas a mensagem diz `daemon` no lugar de `background service`.

Em uma instalação npm, um `EUNKNOWN` que aparece enquanto `npm install -g @anthropic-ai/claude-code` está substituindo o binário tem a mesma causa que [`EACCES` durante uma reinstalação](#eacces-when-starting-a-background-session) e limpa quando você tenta novamente após a instalação terminar.

Claude Code inicia o serviço em background através do PowerShell para que o serviço sobreviva ao fechamento do terminal, usando PowerShell 7 quando está instalado e Windows PowerShell 5.1 caso contrário. Quando nenhum PowerShell consegue executar, Claude Code inicia o serviço diretamente em vez disso, portanto uma política que bloqueia apenas PowerShell não causa esse erro.

Antes da v2.1.212, Claude Code usava apenas Windows PowerShell 5.1 para iniciar o serviço, portanto qualquer máquina onde Group Policy bloqueava PowerShell 5.1 falhava com `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, mesmo com PowerShell 7 instalado.

**O que fazer:**

* Se a mensagem lê `Couldn't start the session`, atualize para v2.1.212 ou posterior. Em versões anteriores você também pode executar `claude daemon run` em um terminal separado primeiro, depois iniciar a sessão em background novamente. Esse comando executa o serviço em background no primeiro plano do terminal, portanto o serviço dura apenas enquanto esse terminal fica aberto.
* Se uma instalação npm estava substituindo o binário, espere por ela terminar, depois inicie a sessão em background novamente
* Se o erro aparece em v2.1.212 ou posterior enquanto nenhuma instalação npm está em execução, verifique com seu administrador Windows se uma política de restrição bloqueia o executável Claude Code
* Se o serviço em background para quando você fecha o terminal, Claude Code o iniciou sem PowerShell. Instale PowerShell 7, ou peça ao seu administrador para desbloquear PowerShell, para que o serviço possa sobreviver ao terminal.

### EACCES ao iniciar uma sessão em background

Claude Code não conseguiu executar seu próprio binário para iniciar o [serviço em background](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process) que hospeda sessões em background. Em uma instalação npm, isso geralmente significa que `npm install -g @anthropic-ai/claude-code` estava substituindo o binário naquele momento, se você o executou ou o [auto-updater](https://code.claude.com/docs/pt/setup.md#auto-updates) fez. O erro aparece quando você abre uma sessão da [agent view](https://code.claude.com/docs/pt/agent-view.md):

```text theme={null}
Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'
```

Quando você inicia uma sessão com `/background` ou `claude --bg`, a mesma razão aparece dentro de `Couldn't reach the background service (...)`. Durante a mesma janela de reinstalação o erro pode nomear outro código em vez disso, como `ENOENT` ou `ENOEXEC`, ou `EUNKNOWN` ou `EPERM` no Windows; um `EUNKNOWN` que persiste através de tentativas tem uma [causa diferente](#eunknown-when-starting-a-background-session).

Em uma instalação npm, Claude Code espera a reinstalação terminar e tenta novamente por conta própria: até dez segundos, e até dois minutos enquanto uma instalação npm de Claude Code está visivelmente ainda em execução na máquina, o que cobre outro processo Claude Code baixando uma atualização. Quando a instalação dura mais que essa espera, a falha nomeia a atualização em vez do código de erro simples:

```text theme={null}
Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes
```

Antes da v2.1.257, a espera parava em dez segundos em cada caso, portanto esse erro aparecia enquanto outro processo Claude Code ainda estava baixando uma atualização. Antes da v2.1.246, Claude Code falhava imediatamente, sem esperar.

**O que fazer:**

* Espere alguns segundos, depois abra a sessão ou despache novamente. Quando a mensagem diz que Claude Code está sendo atualizado, tente novamente após a atualização terminar.
* Se o erro persiste enquanto nenhuma instalação npm está em execução, seu usuário não consegue executar o binário instalado. Verifique suas permissões e as de seu diretório, ou reinstale Claude Code.

### Serviço em background saiu antes de se tornar alcançável

O processo que Claude Code iniciou como o [serviço em background](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process) saiu antes de aceitar conexões, portanto Claude Code não conseguiu abrir sua sessão. Quando o serviço imprimiu um erro antes de sair, a razão entre parênteses dá o código de saída ou sinal e a primeira linha que o serviço imprimiu, que nomeia o que o parou:

```text theme={null}
Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'
```

Quando você abre uma sessão da [agent view](https://code.claude.com/docs/pt/agent-view.md), a mesma razão segue `Couldn't start the background service —`. Quando o serviço não imprimiu nada antes de sair, a mensagem diz `nothing on stderr` em vez disso.

Claude Code relata a falha com a linha de erro do serviço. Antes da v2.1.246, a falha aparecia apenas após uma espera de 45 segundos, como `background service did not become reachable within 45s`, sem a linha de erro do serviço.

Duas razões citadas têm causas conhecidas:

* `Error: claude native binary not installed.`: uma instalação npm estava substituindo o binário Claude Code naquele momento, portanto o serviço executou o placeholder do npm em vez disso. Tente novamente após a instalação terminar; se a linha persiste sem nenhuma instalação em execução, [complete a instalação npm](https://code.claude.com/docs/pt/troubleshoot-install.md#native-binary-not-found-after-npm-install). Antes da v2.1.257, uma auto-atualização npm do macOS produzia essa falha em cada início durante a janela de instalação.
* `nothing on stderr` com código de saída 1, em cada início, no Windows: `daemon.lock` nomeia um processo que Claude Code não consegue sinalizar nem provar que se foi, portanto cada novo serviço conclui que outro mantém o lock e sai. Um lock cujo escritor Claude Code consegue provar que se foi é substituído por conta própria e não produz essa falha. Quando a falha se repete em cada início, delete `~/.claude/daemon.lock`, depois abra a sessão ou despache novamente. Antes da v2.1.257, tal lock bloqueava cada início até você deletar o arquivo.

**O que fazer:**

* Se a mensagem cita uma linha, corrija o que ela nomeia, depois abra a sessão ou despache novamente. A próxima tentativa inicia o serviço novamente
* Execute `claude daemon status` para verificar se um serviço está em execução agora

### Diretório de trabalho não existe mais ao iniciar uma sessão em background

O diretório em que você iniciou uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md) foi removido enquanto a sessão estava iniciando. Claude Code não inicia a sessão, e a mensagem nomeia o diretório faltante:

```text theme={null}
Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)
```

Antes da v2.1.257, a sessão parecia iniciar e depois mostrava na agent view como uma linha falha com a mesma razão.

Antes da v2.1.281, essa mensagem também aparecia quando o diretório já estava desaparecido antes de você iniciar a sessão. Esse caso relata [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).

**O que fazer:**

* Recrie o diretório que a mensagem nomeia, ou despache de um diretório que existe, depois tente novamente

### Esta sessão bifurcada não pôde ser iniciada

Você [bifurcou uma sessão do Remote Control](https://code.claude.com/docs/pt/remote-control.md#fork-a-session-from-your-browser) a partir do claude.ai, e Claude Code não conseguiu concluir a inicialização da [sessão em background](https://code.claude.com/docs/pt/agent-view.md) que executa o fork na sua máquina. Este aviso aparece na transcrição da sessão bifurcada:

```text theme={null}
This forked session could not be started. Fork the conversation again to retry.
```

A sessão que você bifurcou continua em execução.

**O que fazer:**

* Volte à sessão que você bifurcou e bifurque-a novamente assim que a sessão estiver ociosa

### Workspace não confiável ao despachar uma sessão em background

Você iniciou ou reiniciou uma [sessão em background](https://code.claude.com/docs/pt/agent-view.md) em um diretório que você não [confiou](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust), e o diálogo de confiança de workspace não conseguiu aparecer para perguntar. Claude Code não inicia a sessão:

```text theme={null}
Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.
```

De um terminal no diretório da sessão própria, o mesmo comando mostra o diálogo de confiança em vez disso e inicia a sessão uma vez que você aceita. Esta mensagem aparece onde nenhum diálogo pode, como em um script, ou quando você reinicia uma sessão de um diretório diferente do seu próprio.

Duas variantes nomeiam uma causa diferente:

* **`The home directory is trusted one session at a time`**: o diretório da sessão é seu diretório home. Claude Code nunca salva confiança para o diretório home, portanto aceitar o diálogo lá em uma sessão anterior não conta.
* **`<path> could not be resolved on disk`**: Claude Code não conseguiu encontrar o diretório da sessão no disco.

Antes da v2.1.286, no Windows, essa mensagem também podia aparecer em um diretório que você já tinha confiado, se seu registro de confiança foi salvo com o caminho em uma capitalização de letras diferente. Atualize para v2.1.286 ou posterior.

**O que fazer:**

* Execute `claude` no diretório que a mensagem nomeia e aceite o diálogo de confiança, depois execute o comando novamente
* Para a mensagem de diretório home, execute o comando de um terminal no seu diretório home para que o diálogo possa aparecer, ou inicie a sessão de um diretório de projeto em vez disso
* Para a mensagem `could not be resolved on disk`, recrie o diretório, ou inicie uma nova sessão de um diretório que existe

## Erros de wrapper e IDE

Esses erros vêm do programa que iniciou o Claude Code para você, como uma extensão de IDE ou uma aplicação [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), em vez de virem do próprio Claude Code.

### Subprocess initialization did not complete within 60000ms

Esse erro significa que um processo do Claude Code iniciado pela [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) ou por uma aplicação Agent SDK não informou a tempo que estava pronto. A extensão ou aplicação então o interrompeu. Em uma conversa no VS Code, o erro começa com `Claude Code did not finish starting`, por exemplo:

```text theme={null}
Claude Code did not finish starting: it did not answer in time. The output logs ("View output logs") show how far it got. Slow plugins, MCP servers, hooks, disks or network can each cause this.
```

Nos logs de saída da extensão, na sua tela de login e em uma aplicação Agent SDK, o erro aparece de forma diferente. Ele começa com `Subprocess initialization did not complete within` e o limite de tempo, e depois mostra o que o Claude Code relatou, por exemplo:

```text theme={null}
Subprocess initialization did not complete within 60000ms. Claude Code did not answer the initialize request and reported no SessionStart or Setup hook running. Slow plugins, MCP servers, hooks that Claude Code does not report, disks or network can each cause this.
```

**O que fazer:**

* Para tentar novamente no VS Code, envie uma mensagem. Se o erro apareceu enquanto você fazia login, selecione o método de login novamente.
* Para ver até onde o Claude Code chegou, clique em **View output logs** abaixo do erro de uma conversa ou execute **Claude Code: Show Logs** na Command Palette. Inclua as entradas em torno da linha `Subprocess initialization` ao [relatar o problema](https://github.com/anthropics/claude-code/issues).
* Para verificar sua rede, consulte [Configuração de rede](https://code.claude.com/docs/pt/network-config.md). Se a mensagem pedir que você verifique seu login ou autenticação, consulte [Login e autenticação](https://code.claude.com/docs/pt/troubleshoot-install.md#login-and-authentication).
* Se a mensagem disser que hooks [SessionStart](https://code.claude.com/docs/pt/hooks.md#sessionstart) ou [Setup](https://code.claude.com/docs/pt/hooks.md#setup) não haviam terminado, [verifique quanto tempo os seus levam para executar](https://code.claude.com/docs/pt/hooks.md#debug-hooks). No VS Code, os primeiros 10 minutos em que o Claude Code relata esses hooks em execução não contam para o limite de 60 segundos. Faça um hook lento terminar mais cedo, reduza o [`timeout`](https://code.claude.com/docs/pt/hooks#common-fields) de um hook não assíncrono ou [remova o hook](https://code.claude.com/docs/pt/hooks.md#disable-or-remove-hooks).
* Se sua aplicação Agent SDK chama [`startup()`](https://code.claude.com/docs/pt/agent-sdk/typescript#startup), defina `initializeTimeoutMs` com um valor longo o suficiente para toda a inicialização, ou deixe-o sem definir para que até 10 minutos de tempo de hook relatado não sejam contados.

Antes da extensão VS Code v2.1.304 e do TypeScript Agent SDK v0.3.304, todo o tempo de hooks contava para o limite. Com o limite padrão, a mensagem continha `Subprocess initialization did not complete within 60000ms — check authentication and network connectivity`. Se você vir essa mensagem, atualize a extensão ou o SDK.

### Claude Code process exited with code N

O processo `claude` subjacente saiu com um código diferente de zero. O código de saída por si só não diz o que falhou: o erro real está na saída do próprio processo, que o wrapper anexa quando capturou alguma coisa e caso contrário mantém em seus logs.

```text theme={null}
Error: Claude Code process exited with code 1
```

No Windows, a compilação nativa pode sair com o código `4294967295` logo após um turno ser concluído. Quando essa saída ocorre em um limite de turno, sem mensagem aguardando e sem tarefa em segundo plano em execução, a [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) fecha a sessão silenciosamente em vez de mostrar esse erro. Sua próxima mensagem retoma a conversa.

Antes da v2.1.273, a extensão mostrava o erro para essa saída em cada limite de turno, mesmo que nada fosse perdido.

**O que fazer:**

* No VS Code, siga o link **View output logs** mostrado com o erro para ver a falha subjacente
* Em uma aplicação Agent SDK, capture o erro em torno de seu loop de mensagens. As entradas em [Saída do processo CLI](https://code.claude.com/docs/pt/agent-sdk/troubleshooting.md#cli-process-exit) cobrem o que seu código recebe em cada linguagem SDK.
* Execute `claude` em um terminal no mesmo projeto. A falha geralmente se reproduz lá com sua mensagem de erro real, que você pode então procurar nesta página.
* Execute `claude doctor` em um terminal para verificar a instalação e configuração

### Could not locate the Claude CLI on PATH

A [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) mostra esse erro no Windows quando você abre Claude Code no terminal integrado, o shell do terminal é PowerShell e a extensão não consegue encontrar o executável `claude` instalado no PATH. A extensão se recusa a iniciar Claude Code até encontrar o `claude` instalado no PATH.

```text theme={null}
Failed to run Claude Code: Error: Could not locate the Claude CLI on PATH. Launching by name in a PowerShell terminal would run a 'claude' from the open folder instead of the installed CLI, so the launch was blocked. Make sure the Claude CLI's install directory is on your system PATH (not only your PowerShell profile), then restart VS Code and try again. VS Code reads PATH when it starts, so PATH changes take effect only after a restart.
```

**O que fazer:**

* Abra uma nova janela PowerShell fora do VS Code e execute `where.exe claude`. Se não imprimir um caminho, a CLI não está no seu PATH: adicione seu diretório de instalação seguindo [Verifique seu PATH](https://code.claude.com/docs/pt/troubleshoot-install.md#verify-your-path). Se imprimir um caminho, a entrada vem de seu perfil PowerShell ou de uma mudança de PATH que o VS Code ainda não captou; os próximos dois passos cobrem esses casos.
* Defina a entrada PATH como uma variável de ambiente de usuário ou sistema, não em seu perfil PowerShell. A extensão não executa seu perfil, portanto uma edição de PATH que existe apenas lá nunca a alcança.
* Reinicie o VS Code após alterar PATH. A extensão verifica o PATH que o VS Code capturou na inicialização, portanto uma mudança de PATH entra em vigor apenas após uma reinicialização.

### The Claude Code program for this computer could not be found

A [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) procurou a cópia do Claude Code incluída nela e não encontrou nenhuma feita para o seu computador. A mensagem indica o build de que seu computador precisa:

```text theme={null}
The Claude Code program for this computer, the Linux (linux-x64) build, could not be found.
```

**O que fazer:**

* Se a mensagem disser qual build a extensão contém, você tem o pacote da extensão para outra plataforma: instale o pacote feito para o build que a mensagem indica
* Se a mensagem não disser qual build a extensão contém, reinstale a extensão Claude Code pela visualização Extensions do seu editor
* Ou, em qualquer um dos casos, defina [`claudeCode.claudeProcessWrapper`](https://code.claude.com/docs/pt/vs-code#extension-settings) para um binário `claude` instalado separadamente

Antes da v2.1.290, isso aparecia como `Unsupported platform: <platform>-<arch>. No compatible Claude Code binary found.`

### The connection to Claude Code ended before this message completed

A [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) enviou sua mensagem para o processo `claude`, e a conexão terminou sem um erro antes do processo reconhecer ou concluir. A extensão não consegue dizer se a mensagem foi processada, portanto pede que você a envie novamente:

```text theme={null}
The connection to Claude Code ended before this message completed — it may not have been processed, so please send it again.
```

**O que fazer:**

* Envie a mensagem novamente. A próxima mensagem inicia um novo processo `claude` que retoma a conversa.
* Se se repetir, execute `claude` em um terminal no mesmo projeto. Uma falha que continua encerrando o processo geralmente se reproduz lá com sua mensagem de erro real.

## Avisos e erros de Rewind

Estas mensagens vêm de uma restauração de código [`/rewind`](https://code.claude.com/docs/pt/checkpointing). `Restored the code, but skipped N files` é um aviso de que Claude Code pulou alguns caminhos. `No files were restored` é um erro que significa que nada foi restaurado.

### Restored the code, but skipped files

Uma restauração de código `/rewind` pulou um ou mais caminhos rastreados em vez de escrever ou deletar através deles. Claude Code pula um caminho quando:

* é, ou se tornou, um symlink, hard link ou outro arquivo não-regular
* seu diretório mudou desde o checkpoint
* seu backup não pode ser lido com segurança

Caminhos pulados mantêm seu conteúdo atual. Antes da v2.1.216, `/rewind` escrevia e deletava através de links em caminhos rastreados e não relatava uma restauração parcial.

```text theme={null}
Restored the code, but skipped 2 files: the tracked path is (or became) a link or other non-regular file, its directory changed since the checkpoint, or its backup could not be safely read. Skipped files were left untouched — run with --debug for the paths.
```

**O que fazer:**

* Identifique quais arquivos foram pulados para que você possa lidar com cada um com as etapas abaixo. A mensagem fornece apenas uma contagem; o log de debug em `~/.claude/debug/<session-id>.txt` nomeia cada caminho pulado conforme a restauração é executada, então ative o log de debug com `/debug` antes de sua próxima restauração. No macOS ou Linux, você pode encontrar os links diretamente: `find . -type l` para symlinks e `find . -type f -links +1` para arquivos hard-linked.
* Se um arquivo pulado é um link que você criou propositalmente, como um arquivo de configuração gerenciado por um gerenciador de dotfiles ou um arquivo hard-linked por ferramentas como pnpm, o rewind deixou seu conteúdo intacto. Para desfazer as alterações da sessão nele, peça a Claude para reverter a edição ou edite o arquivo você mesmo
* Se você não criou o link, inspecione o caminho antes de confiar em seu conteúdo

### No files were restored

Claude Code mostra esta mensagem quando você restaura código com [`/rewind`](https://code.claude.com/docs/pt/checkpointing) e não consegue restaurar nenhum dos arquivos naquele checkpoint. Para cada arquivo, ou o backup que Claude Code salvou antes de editá-lo está faltando, ou Claude Code não conseguiu escrever ou deletar o arquivo.

```text theme={null}
Failed to restore the code:
No files were restored: 1 file failed (backup missing, or the file could not be updated)
```

Claude Code deleta os backups de uma sessão na [retention sweep](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically), por padrão cerca de 30 dias após a sessão salvar um pela última vez. Se você retomar uma sessão depois disso, `/rewind` ainda lista seus checkpoints, mas reverter para um deles pode falhar com este erro. Se a mensagem também disser `N paths were skipped for link safety`, veja [Restored the code, but skipped files](#restored-the-code-but-skipped-files) para esses caminhos.

Quando você faz fork de uma sessão, por exemplo com [`--fork-session`](https://code.claude.com/docs/pt/cli-reference#cli-flags) ou [`/branch`](https://code.claude.com/docs/pt/sessions#branch-a-session), Claude Code copia os backups da sessão original para o fork. Quando Claude Code não consegue copiar um backup, por exemplo porque o disco está cheio, esse backup está faltando no fork. Reverter para um checkpoint que precisa dele pode falhar com este erro.

**O que fazer:**

* Desfaça as alterações de outra forma: peça a Claude para reverter suas edições ou restaure os arquivos do controle de versão. Quando os backups se foram, executar `/rewind` novamente falha da mesma forma.
* Se Claude Code não conseguiu escrever ou deletar um arquivo, corrija o que bloqueia a escrita, como permissões de arquivo, então execute `/rewind` novamente.
* Para manter backups por mais tempo em futuras sessões, aumente [`cleanupPeriodDays`](https://code.claude.com/docs/pt/settings-reference#cleanupperioddays).

Antes da v2.1.260, Claude Code pulava silenciosamente arquivos cujos backups estavam faltando, e o rewind parecia ter sucesso.

## Avisos de salvamento de sessão

Claude Code mostra estes avisos em uma linha persistente abaixo da caixa de entrada quando não está salvando sua transcrição de sessão. A sessão continua funcionando de qualquer forma; os avisos informam que a sessão pode estar faltando em [`--resume`](https://code.claude.com/docs/pt/sessions) mais tarde.

### Falhas nas gravações de transcrição

Claude Code salva a transcrição em disco conforme você trabalha, e suas gravações no [arquivo de transcrição](https://code.claude.com/docs/pt/sessions.md#where-transcripts-are-stored) estão falhando. A mensagem nomeia a causa com o código de erro subjacente, por exemplo um disco cheio:

```text theme={null}
Transcript writes are failing (disk full — ENOSPC) · recent messages may not be saved for resume
```

O aviso aparece em diferentes pontos dependendo do erro:

* Na primeira falha para condições que não se limpam por conta própria: um disco cheio, uma cota de disco excedida, um sistema de arquivos somente leitura, um caminho acima do limite de comprimento do sistema de arquivos, ou, em macOS e Linux, um erro de permissão
* Após falhas repetidas abrangendo pelo menos um minuto para tudo mais, incluindo erros de permissão no Windows, onde uma verificação de antivírus pode falhar em uma única gravação que depois é bem-sucedida na tentativa novamente

Antes da v2.1.217, Claude Code descartava as gravações com falha sem um aviso, e um `--resume` posterior faltando mensagens recentes era o primeiro sinal.

**O que fazer:**

* Corrija a condição que o código de erro nomeia: libere espaço em disco para `ENOSPC`; aumente ou limpe a cota para `EDQUOT`; restaure o acesso de escrita para o local da transcrição para `EACCES`, `EPERM`, ou `EROFS`
* O aviso se limpa por conta própria na próxima gravação bem-sucedida; nenhuma reinicialização é necessária
* Mensagens enviadas enquanto o aviso estava sendo exibido ainda podem estar faltando quando você retomar a sessão mais tarde

### Salvamento de transcrição está desativado porque CLAUDE\_CODE\_SKIP\_PROMPT\_HISTORY está definido

Esta sessão começou com [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/pt/env-vars) definido, então Claude Code não escreve nenhuma transcrição ou histórico de prompt para ela:

```text theme={null}
Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set · --resume will not find this session; if unintended, unset it and restart
```

A variável é uma exclusão intencional para sessões de script efêmeras, mas também pode chegar a uma sessão através de um perfil de shell, um script wrapper, ou um processo pai que a exportou.

**O que fazer:**

* Se você definiu a variável propositalmente, nenhuma ação é necessária; o aviso confirma que a sessão não aparecerá em `--resume`, `--continue`, ou histórico de seta para cima
* Se você não fez, remova a variável do shell ou script que inicia `claude`, depois inicie uma nova sessão. Mensagens da sessão atual não são salvas retroativamente.

### Salvamento de transcrição está desativado por causa de um marcador CLAUDE\_CODE\_CHILD\_SESSION herdado

Claude Code define [`CLAUDE_CODE_CHILD_SESSION`](https://code.claude.com/docs/pt/env-vars) nos subprocessos que ele gera, e trata uma sessão interativa que o herda como aninhada: Claude Code não salva nenhuma transcrição para ela, então sessões que o próprio Claude inicia não preenchem sua lista de `--resume`. Este aviso significa que sua sessão atual herdou o marcador:

```text theme={null}
Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker · restart with CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 to keep future transcripts
```

O aviso é esperado quando você executou `claude` de dentro de outra sessão de Claude Code; ele sinaliza uma classificação incorreta quando o marcador vazou através de um intermediário de longa duração, por exemplo um terminal, sessão `screen`, ou inicializador que uma sessão de Claude Code originalmente iniciou.

Dentro do tmux, Claude Code detecta um marcador que chegou através do ambiente global do servidor tmux e continua salvando, então este aviso não aparece para esse caso.

**O que fazer:**

* Se você iniciou esta sessão de dentro de outra sessão de Claude Code propositalmente, nenhuma ação é necessária
* Se esta é uma sessão de nível superior, saia e reinicie com [`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`](https://code.claude.com/docs/pt/env-vars) definido. O salvamento se aplica a partir da reinicialização, então mensagens enviadas antes dela não são salvas.
* Para corrigir futuras inicializações do mesmo terminal ou inicializador, remova `CLAUDE_CODE_CHILD_SESSION` de seu ambiente

## Avisos de configuração

Para 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:

* **Linha abaixo do banner de inicialização**: alguns avisos sobre [regras de permissão](https://code.claude.com/docs/pt/permissions.md), como [`⚠ Deny rule Bsh matches no tool · check for typos`](#matches-no-tool)
* **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.

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) com saída de texto, fora de uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md), procure os avisos de inicialização em stderr.

Antes 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.

### Claude Code saiu após um erro de interface irrecuperável

Claude Code imprime esta mensagem quando sai porque sua interface de terminal atingiu um erro do qual não pode se recuperar, em qualquer renderizador. A segunda frase aparece apenas quando o erro aconteceu enquanto o renderizador de [tela cheia](https://code.claude.com/docs/pt/fullscreen.md) estava iniciando:

```text theme={null}
Claude Code exited after an unrecoverable interface error (<error>). It happened while the fullscreen renderer was starting, so the next launch will use the classic renderer (CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 forces that any time).
```

**O que fazer:**

* Inicie Claude Code novamente. Para retomar a conversa, execute `claude --resume` no mesmo diretório.
* Se a mensagem nomear o renderizador de tela cheia, [Renderização de tela cheia](https://code.claude.com/docs/pt/fullscreen.md#fullscreen-renderer-didnt-finish-starting) diz o que o próximo lançamento faz, o que depende de como você ativou tela cheia e como tentar tela cheia novamente ou manter o renderizador clássico.

Antes da v2.1.236, Claude Code saía sem imprimir uma mensagem após este tipo de erro.

### As descrições do agente excedem o limite de 15.0k tokens

Claude Code mostra este aviso como um aviso de inicialização na visualização de conversa em vez de em stderr. As descrições combinadas de seus [subagentes](https://code.claude.com/docs/pt/sub-agents.md), exceto os integrados, excedem 15.000 tokens conforme Claude Code as estima. Cada agente conta seu nome mais seu frontmatter `description`. Claude Code carrega cada agente independentemente de o total estar acima do limite, então o aviso não muda o que é carregado.

```text theme={null}
Agent descriptions are over the 15.0k-token limit (~16.2k tokens) · ask Claude to trim agent descriptions in .claude/agents/
```

**O que fazer:**

* Encurte o frontmatter `description` de seus arquivos de agente, ou peça a Claude para aparar para você.
* Remova arquivos de agente que você não usa mais.

### Hook precisa de aspas em torno de um caminho com espaço

Esta notificação na visualização de conversa significa que o script de um hook não foi executado porque seu caminho tem um espaço e não está entre aspas. Esse hook é um hook [`asyncRewake`](https://code.claude.com/docs/pt/hooks#run-hooks-in-the-background) em forma de shell. Em seu `command`, um interpretador como `python3` é seguido por um placeholder de caminho sem aspas, e o caminho resolvido contém um espaço.

A notificação começa com o nome do evento do hook e nomeia o script:

```text theme={null}
Stop hook needs quotes around a path with a space (check.py)
```

**O que fazer:**

* No `command` do hook que executa o script que a notificação nomeia, coloque o caminho entre aspas duplas. Em um arquivo JSON, escreva-o como `"command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/check.py\""`.

### Instruction file not loaded

Este aviso na visualização de conversa de uma sessão interativa significa que um [arquivo de memória](https://code.claude.com/docs/pt/memory.md#how-claude-md-files-load) que existe não foi carregado. Uma restrição de leitura está em vigor.

```text theme={null}
Instruction file not loaded (a Read deny rule covers it):
path: .claude/rules/shared.md
```

O texto entre parênteses nomeia o motivo, por exemplo:

* **`a Read deny rule covers it`**: uma [regra deny](https://code.claude.com/docs/pt/permissions.md#read-and-edit) de `Read` corresponde ao caminho do arquivo conforme escrito ou ao local para onde um link nele leva
* **`it's read from outside your working directories, where reads are blocked`**: o arquivo se resolve fora dos [diretórios de trabalho](https://code.claude.com/docs/pt/settings-reference.md#permissions-blockreadsoutsideworkingdirectories) enquanto [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/pt/settings-reference#permissions-blockreadsoutsideworkingdirectories) está ativado
* **`where it leads couldn't be worked out`**: por exemplo, o arquivo é um link que leva de volta a si mesmo, diretamente ou através de outros links

Quando o próprio arquivo de memória de um subdiretório não pode ser carregado enquanto Claude trabalha com arquivos ali, as mesmas linhas aparecem na conversa durante o turno. Quando mais arquivos são retidos do que as linhas nomeiam, uma linha final conta o resto, como `and 3 more instruction files not loaded`.

**O que fazer:**

* Nada, se a restrição for intencional: a sessão é executada sem as instruções desse arquivo.
* Para carregar um arquivo retido porque `a Read deny rule covers it`, [remova ou restrinja essa regra](https://code.claude.com/docs/pt/permissions.md#manage-permissions). Depois inicie uma nova sessão.
* Para carregar um arquivo retido porque `it's read from outside your working directories, where reads are blocked`, mova-o ou o destino de seu link para dentro dos diretórios de trabalho. Depois inicie uma nova sessão.
* Para carregar um arquivo retido porque `where it leads couldn't be worked out`, verifique se o arquivo é um link que leva de volta a si mesmo. Se for, aponte o link para um arquivo que existe ou coloque um arquivo regular em seu lugar. Depois inicie uma nova sessão.

Antes da v2.1.292, o aviso nomeava o arquivo no final da mesma linha, após o motivo.

### Uma skill, comando ou workflow não foi carregado porque seu nome é reservado

Uma pasta de skill, um frontmatter `name`, um arquivo ou subpasta em `.claude/commands/`, ou um [workflow salvo](https://code.claude.com/docs/pt/workflows.md#save-the-workflow-for-reuse) usa o nome `anthropic-skills` ou um nome que começa com `anthropic-skills:`. Claude Code [reserva esse nome para skills sincronizadas de claude.ai](https://code.claude.com/docs/pt/skills.md#names-reserved-for-synced-skills) e não carrega esse item.

Claude Code mostra este aviso como um aviso de inicialização na visualização de conversa em vez de em stderr:

```text theme={null}
Not loaded: rename .claude/skills/anthropic-skills, then restart — its name uses "anthropic-skills", a name reserved for the skills synced from your claude.ai account
```

O aviso nomeia o que mudar para o primeiro item que recusou: uma pasta ou arquivo para renomear, uma linha `name:` para editar, ou um workflow para renomear. Quando mais de um item foi recusado, o aviso termina com uma contagem como `· 2 more`, e o [log de depuração](https://code.claude.com/docs/pt/debug-your-config.md) nomeia cada um.

**O que fazer:**

* Renomeie o item que o aviso nomeia, ou edite a linha `name:` para a qual aponta, depois reinicie a sessão.

Antes da v2.1.282, Claude Code carregava skills e comandos com esses nomes.

### Nome de skill ou comando recusado

Este aviso de inicialização significa que Claude Code recusou o nome de pelo menos uma [skill ou comando personalizado](https://code.claude.com/docs/pt/skills.md), então ela não foi carregada ou foi carregada sem seu campo `name`:

```text theme={null}
1 skill or command name refused: run with --debug to see which ([names]), rename, then restart — a name may not hold hidden, direction-changing or blank-like characters, < or >, or be over 256 characters
```

* **Não carregada**: Claude Code recusou o nome pelo qual uma skill ou comando é conhecido, como o nome do seu diretório ou o nome ou subpasta de um arquivo de comando. Ela não aparece no menu `/` e Claude não pode invocá-la. Sua linha no log de depuração diz `<name> is not offered`.
* **Campo `name` ignorado**: Claude Code recusou o `name` do frontmatter de uma skill. A skill ainda é carregada, mas o menu `/` não mostra o valor de `name` e digitá-lo não invoca a skill. Sua linha no log de depuração diz `<name value> is not shown for <skill>`.

**O que fazer:**

* Inicie Claude Code com `claude --debug` a partir do seu shell e pesquise `[names]` no [log de depuração](https://code.claude.com/docs/pt/debug-your-config.md). Cada nome que o aviso conta tem uma linha lá. A linha escreve alguns caracteres ocultos como códigos, como `\u{200B}` para um espaço de largura zero, para que você possa ver onde estão.
* Remova os [caracteres que um nome de skill não pode conter](https://code.claude.com/docs/pt/skills.md#characters-a-skill-name-cant-hold) renomeando a pasta ou o arquivo ou editando a linha `name:`, ou encurte um nome com mais de 256 caracteres. Depois reinicie a sessão, a menos que o arquivo esteja em um diretório que Claude Code [monitora quanto a alterações](https://code.claude.com/docs/pt/skills.md#live-change-detection). Para uma skill de um plugin que você não escreveu, peça ao autor do plugin para renomeá-la.

### O espaço de trabalho não foi confiável

Claude Code encontrou regras `permissions.allow` ou entradas `permissions.additionalDirectories` no `.claude/settings.json` ou `.claude/settings.local.json` do projeto e não as aplicou, porque [as regras de permissão do projeto requerem confiança do espaço de trabalho](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust). A contagem, o nome da configuração e o arquivo nomeado na mensagem variam com sua configuração. As regras `deny` e `ask` não são afetadas.

```text theme={null}
Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.
```

**O que fazer:**

* Execute `claude` no diretório e aceite a caixa de diálogo de confiança. [Regras de permissão do projeto e confiança do espaço de trabalho](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust) diz qual pasta essa aceitação cobre.
* No [modo não interativo](https://code.claude.com/docs/pt/headless.md) com `-p`, nenhuma caixa de diálogo é mostrada. Defina a entrada `hasTrustDialogAccepted` em `~/.claude.json` usando a chave `projects` exata que a mensagem imprime.
* Se a mensagem nomear `.claude/settings.local.json` e você iniciou Claude Code fora de um repositório git ou em seu diretório inicial, atualize para v2.1.200 ou posterior. As versões 2.1.196 a 2.1.199 tratavam seu próprio `.claude/settings.local.json` como fornecido pelo repositório nesses espaços de trabalho. Na v2.1.207 e posterior, atualizar não é suficiente fora de um repositório git se você não confiou na pasta: determinar que uma pasta não está dentro de um repositório executa git, e Claude Code executa essa verificação apenas depois que você aceita a caixa de diálogo de confiança, então use a primeira etapa. Seu diretório inicial e qualquer outro [diretório inicial de configuração](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust) estão isentos e não esperam pela caixa de diálogo. Consulte [Regras de permissão do projeto e confiança do espaço de trabalho](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust).

### O diretório de trabalho é um caminho de rede

Claude 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.

Você vê esta mensagem quando executa `/add-dir` com um caminho de rede:

```text theme={null}
\\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).
```

Quando, 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).

Os caminhos que Claude Code recusa desta forma incluem:

* Compartilhamentos UNC como `\\server\share`
* Caminhos de montagem automática como `/net/<host>`, a menos que você tenha iniciado Claude Code de um diretório sob a montagem automática desse host. Leituras sob essa montagem automática ainda passam pela [verificação de caminho de rede](https://code.claude.com/docs/pt/permissions.md#network-paths).
* Caminhos locais que alcançam um local de rede através de um link simbólico ou junção

Letras de unidade mapeadas e caminhos `\\wsl$` não contam como caminhos de rede.

**O que fazer:**

* No Windows, mapeie o compartilhamento para uma letra de unidade e passe a unidade na inicialização. No PowerShell, por exemplo, execute `net use Z: \\server\share` e depois `claude --add-dir Z:\`.
* No macOS ou Linux, monte o compartilhamento em um caminho local e adicione esse caminho.
* Se o caminho estiver em `permissions.additionalDirectories`, remova-o do arquivo de configurações que o lista.

Antes da v2.1.257, Claude Code aceitava um caminho de rede acessível como diretório de trabalho.

### Falha ao carregar configurações gerenciadas remotamente

Sua sessão é elegível para [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md), mas Claude Code não conseguiu buscá-las ou não conseguiu aplicar o que o servidor retornou, então mostra este aviso em sessões interativas e na aba Code do Claude Desktop.

A causa entre parênteses nomeia o que falhou, como `network error`, `request timed out` ou `authentication rejected (401)`. A causa `no setting in the server response could be applied as written` significa que o servidor respondeu mas nenhuma das configurações que retornou passou na [validação](https://code.claude.com/docs/pt/server-managed-settings.md#invalid-entries-in-delivered-settings). Antes da v2.1.282, esta causa lia `server returned invalid settings`.

O resto da linha diz qual política a sessão executa:

* **Configurações em cache de uma busca anterior bem-sucedida**: Claude Code executa a sessão nessa política em cache, exceto as [variáveis de ambiente retidas](https://code.claude.com/docs/pt/server-managed-settings.md#fetch-and-caching-behavior), e a linha lê `using cached policy`.
* **Nenhuma configuração em cache a aplicar**: Claude Code executa a sessão sem configurações gerenciadas pelo servidor, e a linha lê `no remote policy applied`. Por exemplo, a máquina ainda não buscou as configurações, ou as buscou pela última vez há mais de [24 horas](https://code.claude.com/docs/pt/server-managed-settings.md#fetch-and-caching-behavior).

Na aba Code, o aviso aparece como uma linha na conversa quando você envia uma mensagem, e uma nova linha aparece quando o estado da busca muda. Três mensagens relacionadas aparecem da mesma forma:

* `Remote managed settings are still loading`: a busca ainda estava em execução quando a sessão prosseguiu
* `Remote managed settings did not load`: a busca terminou sem resposta
* `Remote managed settings have now loaded`: as configurações foram carregadas após um desses avisos, e o resto da linha diz se uma política remota se aplica

**O que fazer:**

* Aja sobre a causa que a mensagem nomeia: para uma causa de rede, verifique se esta máquina pode alcançar `api.anthropic.com`; para uma causa de autenticação, verifique seu login com `/status`
* Para `no setting in the server response could be applied as written`, peça ao seu administrador para corrigir as configurações no servidor
* Execute `/status` ou `claude doctor` para o diagnóstico completo

Antes da v2.1.248, Claude Code relatava uma busca de configurações falhada apenas no log de depuração.

### Claude Code não conseguiu carregar as configurações da sua organização

Sua sessão não foi iniciada porque as configurações da sua organização, incluindo suas [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md), precisam ser carregadas primeiro e Claude Code não conseguiu carregá-las. Por exemplo:

```text theme={null}
Claude Code couldn't reach Anthropic to load your organization's settings (could not connect). <Organization name> requires them before a session can start.
```

Se a mensagem estiver em uma caixa de diálogo intitulada `Claude Code can't start this session yet`, a caixa de diálogo se fecha e a sessão inicia assim que as configurações são carregadas.

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) e em [sessões em segundo plano](https://code.claude.com/docs/pt/agent-view.md), Claude Code imprime a mensagem e sai com status 1 em vez disso.

**O que fazer:**

* **`could not connect` ou `the reply came from a network proxy, not Anthropic`**: verifique sua conexão de rede e, em uma rede corporativa, peça à equipe de TI para permitir HTTPS para `api.anthropic.com/api/claude_code/policy_limits` e `api.anthropic.com/api/claude_code/settings`. Depois selecione **Retry now** ou execute seu comando novamente.
* **`timed out`, `Anthropic returned an error` ou `Anthropic asked it to retry shortly`**: deixe a caixa de diálogo tentar novamente ou execute seu comando novamente mais tarde. Verifique [status.anthropic.com](https://status.anthropic.com) se isso continuar acontecendo.
* **`still loading` ou `couldn't verify your sign-in with Anthropic yet`**: deixe a caixa de diálogo tentar novamente ou execute seu comando novamente. Se a mensagem de login continuar voltando, faça login novamente executando `claude auth login` no seu shell.
* **`Your Claude session has expired`**: o login armazenado nesta máquina não é mais válido, então tentar novamente não ajudará. Na caixa de diálogo, selecione **Sign in again** para fechar Claude Code; depois, no seu shell, execute `claude auth login`, que funciona mesmo enquanto as sessões não podem iniciar.
* **`none of the settings the server returned could be applied as written`**: peça ao seu administrador para corrigir as [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md#invalid-entries-in-delivered-settings) da organização e depois tente novamente.

### As configurações gerenciadas não foram aprovadas

As [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md) de sua organização incluem configurações que precisam de sua aprovação, e você recusou a [caixa de diálogo de aprovação de segurança](https://code.claude.com/docs/pt/server-managed-settings.md#security-approval-dialogs), então Claude Code sai sem aplicá-las:

```text theme={null}
Managed settings were not approved; exiting without applying them.
```

**O que fazer:**

* Inicie Claude Code novamente e aprove a caixa de diálogo para continuar sob as configurações de sua organização. Uma caixa de diálogo recusada não é lembrada, então aparece novamente na próxima inicialização.
* Se você não tiver certeza sobre uma configuração que a caixa de diálogo lista, pergunte a quem mantém as configurações gerenciadas de sua organização antes de aprovar

### As configurações gerenciadas precisam de sua aprovação

As [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md) de sua organização incluem configurações que precisam de sua aprovação na [caixa de diálogo de aprovação de segurança](https://code.claude.com/docs/pt/server-managed-settings.md#security-approval-dialogs). O comando `claude plugin` que você executou não conseguiu ler do teclado, então não pôde mostrar essa caixa de diálogo. Isso acontece quando você encaminha ou redireciona a entrada dele e, no macOS e Linux, ele também não consegue abrir `/dev/tty`. O comando parou antes de fazer qualquer alteração:

```text theme={null}
Your organization's managed settings need your approval, which couldn't be asked for here. Run `claude` in a terminal and approve them, then run this command again.
```

**O que fazer:**

* Execute `claude` em um terminal e aprove as configurações quando a caixa de diálogo aparecer, depois execute o mesmo comando `claude plugin` novamente. Claude Code mantém a aprovação e as configurações aprovadas em seu [diretório de configuração](https://code.claude.com/docs/pt/server-managed-settings.md#approval-memory). Se o comando que parou foi executado como outro usuário ou com `CLAUDE_CONFIG_DIR` definido, execute `claude` da mesma forma para que ambos usem o mesmo diretório.

### As configurações gerenciadas bloqueiam o modelo padrão

As [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) de sua organização bloqueiam o modelo para o qual a opção Padrão se resolve e cada modelo para o qual poderia fazer downgrade. Uma sessão que começaria na opção Padrão sai na inicialização em vez de executar um modelo bloqueado. Qual mensagem você vê depende da configuração que o bloqueia. Quando uma lista [`deniedModels`](https://code.claude.com/docs/pt/model-config#block-specific-models-or-versions) o bloqueia, a mensagem lê:

```text theme={null}
Claude Code can't start: your organization's managed settings block the default model (claude-opus-5-5) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".
```

Quando uma lista `availableModels` com [`availableModelsMatch`](https://code.claude.com/docs/pt/settings-reference#availablemodelsmatch) definido como `"exact"` a omite, a mensagem lê:

```text theme={null}
Claude Code can't start: your organization allows only the models listed in "availableModels", and none of them can be used as the default model (claude-opus-5-5 isn't listed). Ask your administrator to update "availableModels".
```

**O que fazer:**

* Se você administra as configurações, adicione um modelo que seus usuários possam executar a `availableModels`, ou estreite as entradas `deniedModels` que bloqueiam cada fallback. [Bloquear modelos ou versões específicas](https://code.claude.com/docs/pt/model-config.md#block-specific-models-or-versions) descreve como a opção Padrão faz downgrade
* Se você não as administra, envie a mensagem ao seu administrador. Seus próprios arquivos de configurações não podem ampliar uma lista `availableModels` ou `deniedModels` gerenciada

### As configurações gerenciadas não permitem este provedor de API

As [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) de sua organização definem uma lista [`allowedProviders`](https://code.claude.com/docs/pt/settings-reference#allowedproviders), e o provedor de API da sessão não está nela ou a sessão usa um endpoint que não está fixado da forma que essa entrada requer. Claude Code recusa na inicialização, antes de um login, ou quando a sessão próxima contata a API. A mensagem começa com os provedores permitidos:

```text theme={null}
Your organization's managed settings allow Claude Code to use: Anthropic API, Amazon Bedrock.
```

Quando a lista está vazia, a mensagem lê em vez disso:

```text theme={null}
Your organization's managed settings allow Claude Code to use no API provider at all (allowedProviders is an empty list), so it cannot start on this machine.
```

Quando cada entrada é não reconhecida, o parêntese lê `(allowedProviders lists only unrecognized entries)` em vez disso.

**O que fazer:**

* Siga as etapas `To continue:` da mensagem
* Se você administra as configurações, as linhas da mensagem começando com `Admins:` nomeiam a entrada a adicionar ou o valor a fixar, e a entrada [`allowedProviders`](https://code.claude.com/docs/pt/settings-reference#allowedproviders) diz qual bloco `env` da fonte pode fixá-lo

### O servidor MCP é bloqueado pela política gerenciada da empresa

Você selecionou **Reconnect** em um servidor em `/mcp`, ou ativou um servidor desabilitado novamente lá, e uma configuração que [restringe servidores MCP](https://code.claude.com/docs/pt/managed-mcp.md) bloqueia esse servidor. Claude Code recusa conectá-lo e mostra:

```text theme={null}
MCP server <name> is blocked by enterprise managed policy
```

Qualquer uma dessas configurações pode produzir a mensagem:

* Uma entrada [`deniedMcpServers`](https://code.claude.com/docs/pt/managed-mcp#policy-based-control-with-allowlists-and-denylists) que corresponde ao servidor, incluindo uma em seu próprio `~/.claude/settings.json` ou no `.claude/settings.json` do projeto
* Uma lista [`allowedMcpServers`](https://code.claude.com/docs/pt/managed-mcp#policy-based-control-with-allowlists-and-denylists) que o servidor não corresponde
* [`strictPluginOnlyCustomization`](https://code.claude.com/docs/pt/settings-reference#strictpluginonlycustomization) com `mcp` bloqueado, que bloqueia servidores configurados em `~/.claude.json` e `.mcp.json`
* [`disableClaudeAiConnectors`](https://code.claude.com/docs/pt/mcp#disable-claude-ai-connectors), quando o servidor é um conector claude.ai

**O que fazer:**

* Verifique seus próprios arquivos de configurações de usuário e projeto para uma dessas configurações e altere ou remova-a
* Se nenhuma de suas próprias configurações explicar o bloqueio, pergunte ao seu administrador qual configuração gerenciada bloqueia o servidor

Antes da v2.1.257, **Reconnect** e re-habilitar em `/mcp` poderiam conectar um servidor que uma atualização de política no meio da sessão bloqueou.

### O nome do servidor MCP é reservado

Esta mensagem nomeia um de seus servidores MCP, cujo nome está entre aqueles que Claude Code reserva, como os nomes de seus servidores integrados:

```text theme={null}
"workspace" is a reserved MCP server name and was not loaded
```

**O que fazer:**

* Renomeie o servidor onde você o define, por exemplo de `workspace` para `my-workspace`
* Para outros nomes reservados a evitar, consulte [Avisos de configuração de MCP](https://code.claude.com/docs/pt/mcp.md#configuration-warnings)

### O documento de configurações gerenciadas não pôde ser analisado

Sua organização implanta [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), e um dos documentos implantados está presente mas não pode ser analisado como um objeto JSON, então Claude Code sai com código 1 na inicialização em vez de executar sem a política que o documento carrega. A linha nomeia a fonte falhada antes da mensagem:

```text theme={null}
/Library/Application Support/ClaudeCode/managed-settings.json: Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.
```

A fonte é uma de:

* O caminho do arquivo `managed-settings.json` ou um arquivo drop-in sob `managed-settings.d`
* O perfil de preferências gerenciadas do macOS, `per-user managed preferences` ou `device-level managed preferences`
* O valor do registro do Windows, `Registry: HKLM\SOFTWARE\Policies\ClaudeCode\Settings`

[Encontre entradas que Claude Code descartou](https://code.claude.com/docs/pt/managed-settings.md#find-entries-claude-code-dropped) lista o que torna cada fonte não analisável.

Claude Code recusa iniciar mesmo quando outra fonte de administrador entrega uma política válida. Você vê este erro em sessões interativas, `claude -p`, sessões do Agent SDK, [sessões em segundo plano](https://code.claude.com/docs/pt/agent-view.md) e a maioria dos subcomandos, `claude doctor` incluído. A recusa falha fechada propositalmente: as configurações em um documento que Claude Code não pode analisar não podem ser aplicadas, e iniciar mesmo assim executaria sessões sem os controles da organização.

Um problema de esquema em um documento analisável não produz este erro. [Encontre entradas que Claude Code descartou](https://code.claude.com/docs/pt/managed-settings.md#find-entries-claude-code-dropped) cobre o que Claude Code faz com um.

Quando um diretório `managed-settings.d/` existe mas não pode ser listado, Claude Code relata `Managed settings drop-in directory could not be read:` seguido pelo erro subjacente. [Encontre entradas que Claude Code descartou](https://code.claude.com/docs/pt/managed-settings.md#find-entries-claude-code-dropped) cobre quando uma falha de leitura sai na inicialização.

**O que fazer:**

* Se você administra a máquina, corrija o documento nomeado para que seja analisado como um objeto JSON, ou remova o arquivo, perfil ou valor do registro. Um `managed-settings.json` vazio conta como `{}` e não bloqueia o lançamento.
* Se não, peça ao seu administrador para corrigir o documento implantado. Nada em seus próprios arquivos de configurações causa ou limpa este erro.

### Não foi possível ler as configurações de política gerenciada

Sua organização implanta [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), e uma das fontes implantadas existe mas não pôde ser lida, por um motivo como um erro de E/S em vez do sistema operacional negar a leitura. Sem outra fonte de administrador fornecendo uma política, Claude Code sai na inicialização em vez de executar sem a política que a fonte pode carregar:

```text theme={null}
Unable to read managed policy settings.
This machine may require organization login enforcement, but the policy file failed to load.
Contact your administrator.

Detail: <source>: <reason>
```

No mesmo estado, fluxos de login, solicitações de API de uma sessão que já está em execução, e o servidor [`claude gateway`](https://code.claude.com/docs/pt/claude-apps-gateway) são recusados com uma variante da primeira linha que nomeia [`allowedProviders`](https://code.claude.com/docs/pt/settings-reference#allowedproviders).

Uma leitura que o sistema operacional negou, como em um arquivo somente raiz, não produz esta saída: [a sessão inicia sem as políticas dessa fonte](https://code.claude.com/docs/pt/managed-settings.md#find-entries-claude-code-dropped). Para uma fonte que não pode ser analisada, Claude Code sai com [uma mensagem diferente nomeando a fonte](#managed-settings-document-could-not-be-parsed).

**O que fazer:**

* Se você administra a máquina, corrija o problema que a linha `Detail:` nomeia para que a fonte implantada possa ser lida, ou remova a fonte
* Se não, envie a mensagem ao seu administrador. Nada em seus próprios arquivos de configurações causa ou limpa este erro

Antes da v2.1.285, apenas sessões conectadas com credenciais claude.ai ou Claude Console saíram com esta mensagem, e uma leitura que o sistema operacional negou a produziu também.

### Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded

Este bloco de stderr de uma execução `-p` significa que uma fonte de [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) contém uma entrada de hook que Claude Code não consegue carregar. Esse hook não é executado e, quando uma linha lista o campo `hooks` da fonte como ignorado, nenhum dos hooks dessa fonte é executado.

Cada linha nomeia a fonte, o campo quando houver um, e o problema, como um `type` de hook desconhecido ou um hook declarado fora da chave `hooks`:

```text theme={null}
Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded; fix or remove each entry:
  <source> (<field>): <message>
```

**O que fazer:**

* Se você administra a fonte, corrija ou remova cada entrada que o bloco lista. [Configuração de hooks](https://code.claude.com/docs/pt/hooks.md#configuration) mostra o formato que Claude Code espera sob `hooks`.
* Se a fonte de uma linha for `parent managed settings`, o aplicativo que iniciou Claude Code passou essa entrada como [configurações pai](https://code.claude.com/docs/pt/managed-settings.md#parent-settings-from-embedding-hosts), então relate-a ao desenvolvedor desse aplicativo
* Caso contrário, envie o bloco ao seu administrador

Antes da v2.1.300, uma execução `-p` listava este caso sob o cabeçalho `Managed settings failed to load; policies from the failed source are NOT in effect:`.

### otelHeadersHelper falhou

Claude Code mostra este aviso como uma notificação na interface do terminal, uma vez por sessão interativa, quando o script [`otelHeadersHelper`](https://code.claude.com/docs/pt/settings-reference#otelheadershelper) falha ou imprime saída que não atende aos [requisitos do script](https://code.claude.com/docs/pt/monitoring-usage.md#script-requirements).

Enquanto o script continua falhando, as exportações falham e seu backend de telemetria não recebe nada da sessão.

O texto após `See /status:` diz o que falhou, como o código de saída do script seguido por sua saída de erro:

```text theme={null}
otelHeadersHelper failed; telemetry is not being exported. See /status: exited 1: token service unreachable
```

**O que fazer:**

* Execute `/status` para ler o detalhe da falha.
* Corrija o script para que saia com 0 em 30 segundos e imprima um objeto JSON de valores de cabeçalho de string em stdout. Consulte [requisitos do script](https://code.claude.com/docs/pt/monitoring-usage.md#script-requirements).
* Se sua organização implanta o script através de [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), peça a quem as mantém para corrigi-lo.

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) com `-p`, a mesma falha aparece em stderr como `otelHeadersHelper failed (OpenTelemetry export headers unavailable): <error>` em vez disso.

### headersHelper não executado

Claude Code conectou um servidor MCP com seus `headers` estáticos sozinhos e pulou o [`headersHelper`](https://code.claude.com/docs/pt/mcp#use-dynamic-headers-for-custom-authentication) do servidor, porque o auxiliar é um comando shell e a pasta não tem confiança salva. Uma pasta obtém confiança salva quando você define sua entrada em `~/.claude.json` manualmente ou, fora de seu diretório inicial, quando você aceita a caixa de diálogo de confiança para ela em uma sessão interativa. Consulte [Confie em uma pasta antes de seu headersHelper ser executado](https://code.claude.com/docs/pt/mcp.md#trust-a-folder-before-its-headershelper-runs) para ver quais servidores essa verificação se aplica.

Claude Code escreve esta linha no [modo não interativo](https://code.claude.com/docs/pt/headless.md) apenas, uma vez por servidor. Em uma sessão interativa, escreve a mesma recusa no log de depuração.

```text theme={null}
MCP server 'internal-api': headersHelper not run — this workspace has no persisted trust; accept the trust dialog here once interactively, or set projects["/Users/you/project"].hasTrustDialogAccepted in /Users/you/.claude.json.
```

A chave `projects` que a mensagem imprime é a pasta [Regras de permissão do projeto e confiança do espaço de trabalho](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust) diz que Claude Code a chave na confiança. Aceitar a caixa de diálogo de confiança para uma pasta pai não satisfaz a verificação, e uma sessão `-p` ou SDK também não satisfaz.

**O que fazer:**

* Execute `claude` na pasta que a mensagem nomeia, aceite a caixa de diálogo de confiança, então execute seu comando `-p` ou SDK novamente
* Defina a entrada `hasTrustDialogAccepted` em `~/.claude.json` você mesmo, usando a chave `projects` exata que a mensagem imprime
* Se você iniciou a sessão em seu diretório inicial, trabalhe a partir de um diretório de projeto que você confiou. Quando você aceita a caixa de diálogo de confiança em seu diretório inicial, Claude Code mantém essa confiança apenas para a sessão atual.

### Regra Tool(content) malformada

Uma [regra de permissão](https://code.claude.com/docs/pt/permissions.md#permission-rule-syntax) em um de seus arquivos de configurações não tem a forma `Tool` ou `Tool(content)`, por exemplo porque o texto segue o parêntese de fechamento ou um dos parênteses está faltando. Claude Code pula a regra e a lista na caixa de diálogo de configurações inválidas quando uma sessão interativa inicia, e na saída de [`claude doctor`](https://code.claude.com/docs/pt/debug-your-config#check-resolved-settings):

```text theme={null}
Invalid permission rule "Bash(ls) x" was skipped: Malformed Tool(content) rule. Rules take the form Tool or Tool(content) and must end at the closing ")"; parentheses inside the content are literal
```

**O que fazer:**

* No arquivo de configurações listado com a mensagem, reescreva a regra para que termine em seu parêntese de fechamento, por exemplo `Bash(ls *)` em vez de `Bash(ls) x`
* Deixe os parênteses dentro do conteúdo como estão. Eles são literais, então uma regra como `Edit(./Finance (2024)/**)` é válida sem escape

Antes da v2.1.260, Claude Code relatava uma regra com parênteses não correspondentes como `Mismatched parentheses`.

### Matches no tool · check for typos

Esta linha abaixo do banner de inicialização nomeia uma [regra de permissão](https://code.claude.com/docs/pt/permissions.md) 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:

```text theme={null}
⚠ Deny rule Bsh matches no tool · check for typos
```

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) com saída de texto, Claude Code imprime o aviso em stderr em sua forma mais longa:

```text theme={null}
Permission deny rule "Bsh" matches no known tool — check for typos.
```

**O que fazer:**

* Corrija o nome da ferramenta na regra, por exemplo `Bash` em vez de `Bsh`. Consulte os nomes canônicos na [referência de ferramentas](https://code.claude.com/docs/pt/tools-reference.md).
* 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`.
* Se os detalhes disserem `From enterprise managed settings`, encaminhe a linha a quem mantém suas [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), já que você não pode alterar essa regra por conta própria.

Em uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) 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.305, uma sessão interativa imprimia a forma mais longa em stderr na inicialização em vez de mostrar a linha.

### Não é correspondido pelas verificações de permissão de arquivo

Claude Code encontrou uma [regra de permissão](https://code.claude.com/docs/pt/permissions.md#read-and-edit) `Write`, `NotebookEdit`, `MultiEdit` ou `Glob` com um caminho em um de seus [arquivos de configurações](https://code.claude.com/docs/pt/settings.md#where-settings-live), em [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), 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.

* **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:

  ```text theme={null}
  ⚠ Deny rule Write(docs/**) never matches · use Edit(docs/**)
  ```

  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.
* **[Modo não interativo](https://code.claude.com/docs/pt/headless.md) com saída de texto**: o aviso completo em stderr nomeia a regra, sua fonte entre parênteses e a substituição a escrever:

  ```text theme={null}
  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).
  ```
* **[Sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md), 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`.

**O que fazer:**

* 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.
* Exceto em `--allowedTools`, onde Claude Code aceita uma regra `Glob` sem aviso, substitua as regras `Glob(path)` por `Read(path)`.
* 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.
* Deixe as regras de nome de ferramenta simples como `Write` ou `Glob` sozinhas. Claude Code as corresponde no [nível de ferramenta](https://code.claude.com/docs/pt/permissions.md#match-all-uses-of-a-tool) e não avisa sobre elas.
* 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.

Antes 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.

### Tem um curinga antes do resto do comando

Claude 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](https://code.claude.com/docs/pt/settings.md#where-settings-live), em [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), 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](https://code.claude.com/docs/pt/permissions.md#wildcard-patterns) mostra as regras de correspondência.

O 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](https://code.claude.com/docs/pt/headless.md) com saída de texto, o aviso em stderr nomeia a regra e sua fonte entre parênteses:

```text theme={null}
Permission 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 *)).
```

Em 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:

```text theme={null}
⚠ Allow rule Bash(git -C * status *) allows any option at its * · use an exact value
```

Para descobrir onde a regra está definida, execute `/permissions` na sessão e selecione a regra.

**O que fazer:**

* Substitua o `*` antes do subcomando pelo valor exato que você quer dizer: `Bash(git checkout main)` em vez de `Bash(git * main)`.
* 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.
* 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.
* 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.

Em uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) 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.

Antes da v2.1.305, uma sessão interativa imprimia o aviso completo em stderr em vez de mostrar uma linha.

### Negar Bash também desativa a ferramenta PowerShell

Você removeu a ferramenta Bash inteira, por exemplo com `--disallowedTools Bash` ou com uma [regra deny](https://code.claude.com/docs/pt/permissions.md#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](https://code.claude.com/docs/pt/tools-reference.md#bash-deny-rules-also-turn-off-the-powershell-tool), então a sessão inicia sem nenhuma ferramenta de shell.

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) 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):

```text theme={null}
Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.
```

**O que fazer:**

* Para que Claude use PowerShell, defina [`CLAUDE_CODE_USE_POWERSHELL_TOOL`](https://code.claude.com/docs/pt/env-vars) como `1` em seu ambiente ou no bloco `env` de um arquivo de configurações, como [Ativar a ferramenta PowerShell](https://code.claude.com/docs/pt/tools-reference.md#enable-the-powershell-tool) mostra. A ferramenta PowerShell então permanece ativada junto com sua regra deny de Bash.
* Para bloquear comandos específicos em vez da ferramenta inteira, substitua a entrada `Bash` simples por regras com escopo como `Bash(git push *)` no mesmo arquivo de configurações ou flag. Claude mantém a ferramenta Bash, e a ferramenta PowerShell permanece desativada até que você também defina a variável ou adicione uma [regra de permissão `PowerShell`](https://code.claude.com/docs/pt/permissions#powershell) com escopo.

Em uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) 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.

Antes da v2.1.305, uma sessão interativa também imprimia o aviso em stderr na inicialização.

### crossSessionInbound deve ser um de accept, hold, refuse

Um arquivo de configurações define [`crossSessionInbound`](https://code.claude.com/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ê:

```text theme={null}
"crossSessionInbound" must be one of "accept", "hold", "refuse"; received "reject". This value was ignored; while it is present, cross-session messages are held for your approval instead of being delivered. Set it to one of the values above.
```

Em [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), Claude Code trata o valor não reconhecido como `refuse`, o valor mais restritivo, e o aviso diz que as mensagens entre sessões são rejeitadas até que um administrador corrija. Para como a retenção se combina com valores em seus outros arquivos de configurações, consulte [`crossSessionInbound`](https://code.claude.com/docs/pt/settings-reference#crosssessioninbound).

**O que fazer:**

* Defina a chave para `"accept"`, `"hold"` ou `"refuse"`, ou remova-a
* Quando o aviso nomear configurações gerenciadas, peça ao administrador para corrigir o valor

Antes da v2.1.248, Claude Code ignorava um valor não reconhecido sem aviso.

### ANTHROPIC\_FOUNDRY\_RESOURCE deve ser um nome de recurso do Foundry

Você definiu [`ANTHROPIC_FOUNDRY_RESOURCE`](https://code.claude.com/docs/pt/env-vars) como algo diferente de um nome de recurso simples do [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md), como a URL do endpoint ou seu nome de host. Claude Code recusou o valor antes de enviar uma requisição. A mensagem aparece no lugar da resposta de Claude, não como um aviso de inicialização:

```text theme={null}
API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name (2-64 letters, digits and hyphens, not starting or ending with a hyphen, such as my-resource), not a URL or host name. To use a full URL, set ANTHROPIC_FOUNDRY_BASE_URL instead.
```

**O que fazer:**

* Defina `ANTHROPIC_FOUNDRY_RESOURCE` apenas como o nome do recurso e reinicie Claude Code. Para o endpoint `https://my-resource.services.ai.azure.com/anthropic`, o nome é `my-resource`.
* Para fornecer a URL completa do endpoint, defina [`ANTHROPIC_FOUNDRY_BASE_URL`](https://code.claude.com/docs/pt/env-vars) como a URL e remova `ANTHROPIC_FOUNDRY_RESOURCE`, depois reinicie Claude Code. Claude Code aceita apenas uma das duas variáveis.

### O limite de 200K não é aplicado

Você definiu [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](https://code.claude.com/docs/pt/env-vars), que normalmente faz [auto-compactação](https://code.claude.com/docs/pt/model-config.md#default-auto-compact-thresholds) manter sessões em modelos de contexto 1M em uma janela de 200K, mas nenhum limite de compactação limita esta sessão em ou abaixo de 200K, então a conversa pode crescer além disso.

```text theme={null}
CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it. To enforce it, set CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 (or the autoCompactWindow setting).
```

Claude Code aplica o limite de 200K por conta própria para cada modelo que reconhece como tendo uma janela nativa de 1M, e para IDs de modelo que não reconhece, ele compacta na janela que assume. O aviso aparece quando outra configuração derrota essa aplicação:

* O ID do modelo não é um que Claude Code reconhece, como um alias de [gateway LLM](https://code.claude.com/docs/pt/llm-gateway), e você definiu [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](https://code.claude.com/docs/pt/env-vars) ou aumentou a janela assumida além de 200K com [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/pt/env-vars). Neste caso, a mensagem também oferece `or update to a Claude Code version that recognizes <model>` como um remédio.
* Um beta `context-1m` solicitado através de [`ANTHROPIC_BETAS`](https://code.claude.com/docs/pt/env-vars) ou o flag [`--betas`](https://code.claude.com/docs/pt/cli-reference#cli-flags) ainda pede à API a janela de 1M em um modelo que aceita esse beta, enquanto nada compacta a sessão em 200K

**O que fazer:**

* Defina [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](https://code.claude.com/docs/pt/env-vars), ou a configuração [`autoCompactWindow`](https://code.claude.com/docs/pt/settings-reference#autocompactwindow) para `200000`, para que a auto-compactação compacte no limite de 200K
* 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.
* 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

No [modo não interativo](https://code.claude.com/docs/pt/headless.md) com saída de texto, este aviso aparece em stderr. Em uma sessão interativa, em uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md), 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`.

Antes da v2.1.305, uma sessão interativa imprimia o aviso em stderr na inicialização.

### ID de modelo não reconhecido em uma solicitação

Claude Code enviou uma solicitação para um ID de modelo que sua versão de Claude Code não reconhece, e não encontrou nenhuma entrada [`modelOverrides`](https://code.claude.com/docs/pt/model-config#override-model-ids-per-version) que mapeie esse ID para um modelo que reconhece. Claude Code ainda envia a solicitação com o ID conforme você o configurou, e não sai ou muda de modelos.

```text theme={null}
[claude-code:unrecognized_model] {"model":"my-proxy-model","query_source":"sdk"}
```

Em um script ou arnês que lê stderr, corresponda ao prefixo `[claude-code:unrecognized_model]`. Após o prefixo e um espaço, Claude Code escreve um objeto JSON de uma linha. Claude Code pode adicionar campos a ele em uma versão posterior, então ignore qualquer campo que você não espera. Ele escreve pelo menos estes dois:

* `model`: a string do modelo conforme você a configurou
* `query_source`: o caminho da requisição que usou o modelo. Por exemplo, o valor é `sdk` para a conversa principal de uma execução `-p` e começa com `agent:` para um subagente.

Claude Code escreve a linha em um de dois lugares, dependendo de como você a executa:

* No [modo não interativo](https://code.claude.com/docs/pt/headless.md) com `-p`, Claude Code escreve em stderr sob cada `--output-format`, para que você possa analisar stdout sem filtrar a linha
* Em uma sessão interativa ou uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md), Claude Code escreve no log de depuração; execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`

Claude Code escreve a linha uma vez por ID de modelo por processo. Escreve uma linha separada para cada ID não reconhecido adicional, como um que um [subagente](https://code.claude.com/docs/pt/sub-agents.md#choose-a-model) ou uma [funcionalidade em segundo plano](https://code.claude.com/docs/pt/model-config.md#environment-variables) usa.

Claude Code não escreve a linha para IDs de provedor que resolve para um modelo que reconhece, como IDs Amazon Bedrock `us.anthropic.claude-...`, IDs da plataforma de agentes do Google Cloud com um sufixo de versão `@`, e nomes de implantação do Microsoft Foundry que contêm um ID de modelo Claude. Claude Code verifica o modelo atrás de um [ARN de perfil de inferência de aplicação](https://code.claude.com/docs/pt/amazon-bedrock.md#map-each-model-version-to-an-inference-profile) do Amazon Bedrock em vez do próprio ARN. Escreve nenhuma linha para um ARN que não pode resolver, como um digitado incorretamente.

**O que fazer:**

* Se você definiu o ID propositalmente, como um alias de [gateway LLM](https://code.claude.com/docs/pt/llm-gateway), adicione uma entrada [`modelOverrides`](https://code.claude.com/docs/pt/model-config#override-model-ids-per-version) ao seu [arquivo de configurações](https://code.claude.com/docs/pt/settings.md#where-settings-live) com o ID como seu valor. Use um ID de modelo Anthropic como a chave, não um alias de família como `opus`. Para `my-proxy-model` da linha de exemplo, adicione esta entrada:

  ```json theme={null}
  {
    "modelOverrides": {
      "claude-opus-4-6": "my-proxy-model"
    }
  }
  ```

  Claude Code então trata `my-proxy-model` como `claude-opus-4-6` e para de escrever a linha.

* Se o ID nomeia um modelo mais novo que sua versão de Claude Code, execute `claude update`

* Se o ID é um erro de digitação, corrija-o em qualquer um dos [lugares onde você pode definir um modelo](https://code.claude.com/docs/pt/model-config.md#setting-your-model) ou [variáveis de alias](https://code.claude.com/docs/pt/model-config.md#environment-variables) que o contém. Se `query_source` começa com `agent:`, corrija-o onde você define o [modelo do subagente](https://code.claude.com/docs/pt/sub-agents.md#choose-a-model).

Antes da v2.1.233, Claude Code não escrevia nenhuma linha quando enviava uma solicitação para um ID de modelo que não reconhecia.

### Entradas allow do sandbox são ignoradas sob um bloqueio gerenciado

Este aviso em `/status` e `claude doctor` significa que as configurações gerenciadas definem [`allowManagedReadPathsOnly`](https://code.claude.com/docs/pt/settings-reference#sandbox-filesystem-allowmanagedreadpathsonly) ou [`allowManagedDomainsOnly`](https://code.claude.com/docs/pt/settings-reference#sandbox-network-allowmanageddomainsonly), então as entradas [`allowRead`](https://code.claude.com/docs/pt/settings-reference#sandbox-filesystem-allowread) ou [`allowedDomains`](https://code.claude.com/docs/pt/settings-reference#sandbox-network-alloweddomains) no arquivo que ele nomeia não se aplicam:

```text wrap theme={null}
sandbox.filesystem.allowRead is ignored — managed settings set allowManagedReadPathsOnly, so only allowRead paths from managed settings are honored. The 3 entries in /home/you/.claude/settings.json will NOT apply (see https://code.claude.com/docs/en/settings#sandbox-settings).
```

Para o bloqueio de rede, o aviso nomeia `sandbox.network.allowedDomains` e `allowManagedDomainsOnly`, e diz `only allowed domains (and WebFetch domain rules) from managed settings are honored`.

**O que fazer:**

* Você não precisa agir sobre o aviso
* Se você precisa desses caminhos ou domínios e as configurações gerenciadas de sua organização definem o bloqueio, peça ao seu administrador para adicioná-los a essas configurações. O aviso permanece até que você também remova as entradas do arquivo nomeado.
* Para limpar o aviso, remova as entradas do arquivo nomeado. Para um arquivo que você compartilha, como o `.claude/settings.json` de um projeto, você pode deixar as entradas para colegas de equipe sem o bloqueio e deixar o aviso aparecendo.

### Sandbox mask files left behind at write-deny paths

Este aviso em `claude doctor` e `/status` lista arquivos de máscara: arquivos de espaço reservado de 0 bytes e somente leitura em caminhos nos quais o [sandbox](https://code.claude.com/docs/pt/sandboxing.md) nega escritas. Ele aparece no Linux e no WSL2 quando o sandboxing está habilitado com o isolamento de sistema de arquivos ativado. Exclua-os a partir do seu shell assim que nenhuma sessão de Claude Code estiver aberta no projeto que os contém.

O sandbox cria um espaço reservado enquanto um comando em sandbox é executado e o remove quando o comando termina. Um deles fica para trás em casos como estes:

* A sessão é encerrada à força antes de o comando terminar, por exemplo por SIGKILL
* Você sai da sessão enquanto um comando em sandbox ainda está em execução, como um em segundo plano

Em `claude doctor`, o aviso diz:

```text theme={null}
- Sandbox mask files left behind at write-deny paths: /home/you/project/.claude/settings.local.json
  Fix: A session leaves one where it was killed, or where it exited while a sandboxed command was still running. Remove each with `rm <path>` while no other Claude Code session is running in that project — a 0-byte read-only file where a settings file belongs makes "Yes, and don't ask again" fail to save, and the sandbox binds it read-only again on every start
```

**O que fazer:**

* Saia de todas as sessões de Claude Code abertas no projeto que contém os arquivos listados, incluindo qualquer sessão em que `/status` mostrou o aviso, e depois trabalhe a partir do seu shell. Um espaço reservado que o sandbox de outra sessão ainda está usando é uma parte ativa da proteção de escrita dessa sessão
* No seu shell, exclua cada arquivo listado com `rm` e confirme se `rm` perguntar sobre um arquivo protegido contra escrita. O aviso nomeia até três arquivos e conta o resto, então execute `claude doctor` novamente após excluir até que o aviso não apareça mais
* Se uma escolha de permissão que você salvou com "Sim, e não pergunte novamente" não ficou, salve-a novamente após deletar o espaço reservado.

Antes da v2.1.309, o aviso dizia `Stale sandbox mask files left by a killed session`.

Antes da v2.1.257, `claude doctor` não sinalizava esses arquivos; versões anteriores deixam os mesmos espaços reservados para trás quando uma sessão é morta.

### Two Claude Code config files exist

Claude Code está usando o primeiro arquivo que esta mensagem nomeia, então o que está no segundo arquivo não está em vigor. O primeiro é `.config.json`, um nome mais antigo para [`.claude.json`](https://code.claude.com/docs/pt/claude-directory#ce-claude-json). A mensagem inclui uma verificação de qual arquivo contém sua configuração:

```text wrap theme={null}
Two Claude Code config files exist: this run uses /home/you/.claude/.config.json, not /home/you/.claude.json. The file with the higher count here is usually yours, and this prints nothing else from them: grep -c -E '"(hasCompletedOnboarding|mcpServers)"' "/home/you/.claude/.config.json" "/home/you/.claude.json". To end this: if several hosts share this home, first get every host to version 2.1.319 or later, since an older one can write a moved .config.json back. Then stop your Claude processes on every host, move aside the one you do not want, and start none until no host lists it.
```

No Windows, `The one with hasCompletedOnboarding or mcpServers in it is usually yours.` substitui a frase com o comando `grep`.

**O que fazer:**

**1. Encontre o arquivo que contém sua configuração**

* **No Windows**: abra os dois arquivos e veja qual deles contém `hasCompletedOnboarding` ou `mcpServers`
* **Em outras plataformas**: no seu shell, execute o comando `grep` da mensagem e veja qual arquivo tem a contagem mais alta

**2. Atualize todos os hosts que compartilham o diretório pessoal**

Se vários hosts compartilham este diretório pessoal, primeiro atualize Claude Code em todos os hosts para a versão que a mensagem nomeia ou posterior.

**3. Pare Claude Code**

Pare seus processos de Claude Code em todos os hosts.

**4. Mova o arquivo que você não quer**

Mova o arquivo que você não quer para fora de sua pasta. Mova-o em vez de excluí-lo, para que você possa colocá-lo de volta.

**5. Aguarde antes de iniciar Claude Code novamente**

Não inicie Claude Code em nenhum host até que nenhum host ainda liste o arquivo movido em seu caminho antigo.

A mensagem para assim que um dos dois arquivos deixa de existir.

### Make this change again later: \~/.claude.json could not be updated

Este aviso em stderr significa que uma alteração em [`~/.claude.json`](https://code.claude.com/docs/pt/claude-directory#ce-claude-json), como um login ou uma resposta a um prompt de confiança, não foi salva no arquivo:

```text theme={null}
Make this change again later: /home/user/.claude.json could not be updated, so it applies to this session only.
```

**O que fazer:**

* Faça a alteração novamente em uma sessão posterior. Por exemplo, execute `/login` novamente ou responda ao prompt de confiança novamente.

## As respostas parecem ter qualidade inferior ao usual

Se as respostas do Claude parecerem menos capazes do que você espera, mas nenhum erro for exibido, a causa geralmente é o estado da conversa em vez do modelo em si. Claude Code não muda silenciosamente versões de modelo. Ele pode mudar para um modelo de fallback nestes casos:

* Um [`--fallback-model`](https://code.claude.com/docs/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição
* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível, ou sua conta [perde acesso a ele durante a sessão](https://code.claude.com/docs/pt/amazon-bedrock.md#when-a-model-is-disabled-mid-session)
* [Fallback automático de modelo](https://code.claude.com/docs/pt/model-config.md#automatic-model-fallback) nos modelos Fable, Opus 5.5, Sonnet 5.5 e Opus 5 move a sessão para o modelo de fallback da categoria sinalizada, quando essa categoria tem um. Um aviso aparece na transcrição

A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](https://code.claude.com/docs/pt/model-config.md) explica quando cada fallback se aplica.

Verifique estes primeiro:

* **Seleção de modelo**: execute `/model` para confirmar que você está no modelo que espera. Uma escolha anterior de `/model` ou uma variável de ambiente `ANTHROPIC_MODEL` pode ter você em um modelo menor do que pretendia.
* **Nível de esforço**: execute `/effort` para verificar o nível de raciocínio atual e aumentá-lo para depuração difícil ou trabalho de design. Os padrões variam por modelo, então verifique antes de assumir que você está abaixo do máximo. Veja [Ajustar nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) para padrões por modelo e o atalho `ultrathink`.
* **Pressão de contexto**: execute `/context` para ver o quão cheio está a janela. Se estiver próximo da capacidade, execute `/compact` em um ponto natural ou `/clear` para começar do zero. Veja [Explorar a janela de contexto](https://code.claude.com/docs/pt/context-window.md) para como auto-compact afeta turnos anteriores.
* **Instruções obsoletas**: arquivos `CLAUDE.md` grandes ou desatualizados e definições de ferramentas MCP consomem contexto e podem orientar respostas. A verificação `/doctor` sinaliza arquivos de memória superdimensionados e extensões não utilizadas, e `/context` mostra o uso de tokens de ferramentas MCP. Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos que sinalizava arquivos de memória superdimensionados e definições de subagente.

Quando uma resposta sai errada, retroceder geralmente funciona melhor do que responder com correções. Pressione Esc duas vezes ou execute `/rewind` para voltar antes do turno ruim, depois reformule o prompt com mais especificidades. Corrigir na thread mantém a tentativa errada no contexto, o que pode ancorar respostas posteriores a ela. Veja [Checkpointing](https://code.claude.com/docs/pt/checkpointing.md).

Se a qualidade ainda parecer inadequada após verificar o acima, execute `/feedback` e descreva o que você esperava versus o que obteve. O feedback enviado desta forma inclui a transcrição da conversa, que é a forma mais rápida para a Anthropic diagnosticar uma regressão real. Veja [Relatar um erro](#report-an-error) se `/feedback` não estiver disponível em seu ambiente.

Se Claude avisar sobre uma injeção de prompt suspeita, ou recusar uma solicitação por causa de uma injeção suspeita, e o texto que o aviso nomeia for contexto que Claude Code adiciona à conversa automaticamente em vez de conteúdo de arquivo ou web, execute `claude update` e tente novamente. Se o aviso se repetir após atualizar, [relate-o](#report-an-error) em vez de colar o conteúdo sinalizado de volta no prompt. Antes da v2.1.201, Sonnet 5 recusava algumas solicitações da mesma forma.

## Relatar um erro

Para erros de componentes que esta página não cobre, consulte o guia relevante:

* Servidor MCP falhou ao conectar ou autenticar: [MCP](https://code.claude.com/docs/pt/mcp.md)
* Script de hook falhou ou bloqueou uma ferramenta: [Debug hooks](https://code.claude.com/docs/pt/hooks.md#debug-hooks)
* Permissão negada ou erros do sistema de arquivos durante a instalação: [Solucionar problemas de instalação e login](https://code.claude.com/docs/pt/troubleshoot-install.md)

Se um erro não estiver listado aqui ou a correção sugerida não ajudar:

* 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](https://code.claude.com/docs/pt/authentication.md). 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.
* 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)
* 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
* Verifique [status.claude.com](https://status.claude.com) para incidentes ativos
* Pesquise [problemas existentes](https://github.com/anthropics/claude-code/issues) no GitHub
