Documentation 2026-09-30 23:00 UTC to 2026-10-01 05:00 UTC

106| [Disable claude.ai sync](/docs/pt/settings-reference#syncclaudeaiskills) | Impedir que Claude Code carregue os [skills](/docs/pt/skills#how-synced-skills-behave) e [plugins](/docs/pt/plugins/loading#synced-plugins) que seus desenvolvedores habilitam em claude.ai. Se você desativar Skills para sua organização em claude.ai, Claude Code interrompe a sincronização de ambos, e na v2.1.273 ou posterior também remove os que já sincronizou. Para interromper um sem desativar Skills, defina sua chave como `false` nas configurações gerenciadas | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |106| [Disable claude.ai sync](/docs/pt/settings-reference#syncclaudeaiskills) | Impedir que Claude Code carregue os [skills](/docs/pt/skills#how-synced-skills-behave) e [plugins](/docs/pt/plugins/loading#synced-plugins) que seus desenvolvedores habilitam em claude.ai. Se você desativar Skills para sua organização em claude.ai, Claude Code interrompe a sincronização de ambos, e na v2.1.273 ou posterior também remove os que já sincronizou. Para interromper um sem desativar Skills, defina sua chave como `false` nas configurações gerenciadas | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |

107| [Hook restrictions](/docs/pt/settings-reference#allowmanagedhooksonly) | Restringir quais hooks são executados e restringir URLs de hook HTTP; consulte [o que é executado em `allowManagedHooksOnly`](/docs/pt/settings-reference#what-runs-under-allowmanagedhooksonly) para a lista completa de efeitos | `allowManagedHooksOnly`, `allowedHttpHookUrls` |107| [Hook restrictions](/docs/pt/settings-reference#allowmanagedhooksonly) | Restringir quais hooks são executados e restringir URLs de hook HTTP; consulte [o que é executado em `allowManagedHooksOnly`](/docs/pt/settings-reference#what-runs-under-allowmanagedhooksonly) para a lista completa de efeitos | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

108| [Login enforcement](/docs/pt/settings-reference#forceloginmethod) | Restringir login a um método específico ou organização Anthropic. A restrição de método se aplica na extensão VS Code, Agent SDK, `claude setup-token` e `/install-github-app`, e a tela de login interativa do terminal, acessada por `/login` ou onboarding de primeira execução, pré-seleciona o método sem aplicá-lo; Claude Code verifica a organização para logins de conta claude.ai no terminal, extensão VS Code e Agent SDK, e não verifica para logins do Claude Console ou para entrada de [gateway](/docs/pt/claude-apps-gateway). Antes da v2.1.212, apenas logins de terminal aplicavam qualquer chave. Quando definido, sessões autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` são bloqueadas na inicialização; sessões de provedor de nuvem não são afetadas a menos que uma dessas credenciais, ou uma chave de API salva por um login anterior do Claude Console, também esteja presente | `forceLoginMethod`, `forceLoginOrgUUID` |108| [Login enforcement](/docs/pt/settings-reference#forceloginmethod) | Restringir login a um método específico ou organização Anthropic. A restrição de método se aplica na extensão VS Code, Agent SDK, `claude setup-token` e `/install-github-app`, e a tela de login interativa do terminal, acessada por `/login` ou onboarding de primeira execução, pré-seleciona o método sem aplicá-lo; Claude Code verifica a organização para logins de conta claude.ai no terminal, extensão VS Code e Agent SDK, e não verifica para logins do Claude Console ou para entrada de [gateway](/docs/pt/claude-apps-gateway). Antes da v2.1.212, apenas logins de terminal aplicavam qualquer chave. Quando definido, sessões autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` são bloqueadas na inicialização; sessões de provedor de nuvem não são afetadas a menos que uma dessas credenciais, ou uma chave de API salva por um login anterior do Claude Console, também esteja presente | `forceLoginMethod`, `forceLoginOrgUUID` |

109| [Provider restrictions](/docs/pt/settings-reference#allowedproviders) | Limitar quais provedores de API uma máquina pode usar. Uma sessão em um provedor que não está listado é recusada na inicialização, no login e quando próximo contata a API. Requer Claude Code v2.1.285 ou posterior | `allowedProviders` |

109| [Disable agent view](/docs/pt/agent-view#how-background-sessions-are-hosted) | Desativar `claude agents`, `--bg`, `/background` e o supervisor sob demanda | `disableAgentView` |110| [Disable agent view](/docs/pt/agent-view#how-background-sessions-are-hosted) | Desativar `claude agents`, `--bg`, `/background` e o supervisor sob demanda | `disableAgentView` |

110| [Configure the corporate launcher](/docs/pt/corporate-launcher) | Prefixar o [supervisor de agente de fundo](/docs/pt/agent-view#how-background-sessions-are-hosted), seus workers e os [outros processos de fundo cobertos](/docs/pt/corporate-launcher#what-the-launcher-covers) com um launcher corporativo obrigatório em vez de desativar a visualização de agente | `processWrapper` |111| [Configure the corporate launcher](/docs/pt/corporate-launcher) | Prefixar o [supervisor de agente de fundo](/docs/pt/agent-view#how-background-sessions-are-hosted), seus workers e os [outros processos de fundo cobertos](/docs/pt/corporate-launcher#what-the-launcher-covers) com um launcher corporativo obrigatório em vez de desativar a visualização de agente | `processWrapper` |

111| [Model restrictions](/docs/pt/model-config#restrict-model-selection) | `availableModels` filtra quais modelos aparecem no seletor. Adicionar `enforceAvailableModels` também restringe o modelo padrão selecionado automaticamente. Consulte [surface coverage](/docs/pt/model-config#surface-coverage) para saber como essa configuração alcança a CLI, web e IDE | `availableModels`, `enforceAvailableModels` |112| [Model restrictions](/docs/pt/model-config#restrict-model-selection) | `availableModels` filtra quais modelos aparecem no seletor. Adicionar `enforceAvailableModels` também restringe o modelo padrão selecionado automaticamente. Consulte [surface coverage](/docs/pt/model-config#surface-coverage) para saber como essa configuração alcança a CLI, web e IDE | `availableModels`, `enforceAvailableModels` |

2885 2885 

2886**Nome da ferramenta:** `Bash`2886**Nome da ferramenta:** `Bash`

2887 2887 

2888Para o que define o limite do primeiro plano, veja [Limites de tempo limite e saída](/docs/pt/tools-reference#timeout-and-output-limits). Para o limite de tempo em segundo plano, veja [Comandos em segundo plano](/docs/pt/tools-reference#background-commands).2888Para o que define o limite do primeiro plano, veja [Limites de tempo limite e saída](/docs/pt/tools-reference#timeout-and-output-limits). Para o limite de tempo em segundo plano, veja [Limite de tempo para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands).

2889 2889 

2890**Entrada:**2890**Entrada:**

2891 2891 

716| `reloadOutputStyles()` | Re-lê [estilos de saída](/docs/pt/output-styles) do disco, para que um arquivo de estilo que você adiciona ou edita no meio da sessão fique disponível para a sessão em execução. Resolve com um [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) listando os nomes de estilo disponíveis após o recarregamento. Requer Agent SDK v0.3.261 ou posterior |716| `reloadOutputStyles()` | Re-lê [estilos de saída](/docs/pt/output-styles) do disco, para que um arquivo de estilo que você adiciona ou edita no meio da sessão fique disponível para a sessão em execução. Resolve com um [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) listando os nomes de estilo disponíveis após o recarregamento. Requer Agent SDK v0.3.261 ou posterior |

717| `accountInfo()` | Retorna informações de conta |717| `accountInfo()` | Retorna informações de conta |

718| `reconnectMcpServer(serverName)` | Reconectar um servidor MCP por nome. Se o nome também corresponder a uma entrada em um arquivo de configurações como `.mcp.json` ou `~/.claude.json`, Claude Code reconecta o servidor que você configurou através de [`mcpServers`](#options) ou `setMcpServers()`, não a entrada do arquivo de configurações. Essa ordem de resolução requer Claude Code v2.1.257 ou posterior |718| `reconnectMcpServer(serverName)` | Reconectar um servidor MCP por nome. Se o nome também corresponder a uma entrada em um arquivo de configurações como `.mcp.json` ou `~/.claude.json`, Claude Code reconecta o servidor que você configurou através de [`mcpServers`](#options) ou `setMcpServers()`, não a entrada do arquivo de configurações. Essa ordem de resolução requer Claude Code v2.1.257 ou posterior |

719| `toggleMcpServer(serverName, enabled)` | Ativar ou desativar um servidor MCP por nome, com a mesma resolução de nome que `reconnectMcpServer()`. Desativar desconecta o servidor |719| `toggleMcpServer(serverName, enabled)` | Ativar ou desativar um servidor MCP por nome, com a mesma resolução de nome que `reconnectMcpServer()`. Desativar um servidor stdio, SSE ou HTTP o desconecta e remove suas ferramentas; para um servidor que você adicionou no meio da sessão com `setMcpServers()`, a remoção de ferramentas requer Claude Code v2.1.285 ou posterior |

720| `setMcpServers(servers)` | Substituir dinamicamente o conjunto de servidores MCP para esta sessão. Resolve com um [`McpSetServersResult`](#mcpsetserversresult) nomeando quais servidores foram adicionados e removidos, e quaisquer erros |720| `setMcpServers(servers)` | Substituir dinamicamente o conjunto de servidores MCP para esta sessão. Resolve com um [`McpSetServersResult`](#mcpsetserversresult) nomeando quais servidores foram adicionados e removidos, e quaisquer erros |

721| `readMcpResource(serverName, uri)` | *Alfa.* Lê um recurso MCP Apps `ui://` de um servidor MCP conectado para que sua aplicação possa renderizar um widget de ferramenta. Resolve com um [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Requer TypeScript Agent SDK v0.3.280 ou posterior |721| `readMcpResource(serverName, uri)` | *Alfa.* Lê um recurso MCP Apps `ui://` de um servidor MCP conectado para que sua aplicação possa renderizar um widget de ferramenta. Resolve com um [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Requer TypeScript Agent SDK v0.3.280 ou posterior |

722| `streamInput(stream)` | Transmitir mensagens de entrada para a consulta para conversas multi-turno |722| `streamInput(stream)` | Transmitir mensagens de entrada para a consulta para conversas multi-turno |

1821```typescript theme={null}1821```typescript theme={null}

1822type SDKStartupFailureReason =1822type SDKStartupFailureReason =

1823 | "org_pin_api_key_conflict"1823 | "org_pin_api_key_conflict"

1824 | "provider_not_allowed"

1824 | "org_verify_failed"1825 | "org_verify_failed"

1825 | "org_pin_mismatch"1826 | "org_pin_mismatch"

1826 | "managed_settings_invalid"1827 | "managed_settings_invalid"

1843| Valor | O que parou a sessão |1844| Valor | O que parou a sessão |

1844| :- | :- |1845| :- | :- |

1845| `org_pin_api_key_conflict` | Configurações gerenciadas [requerem um login de gateway de primeira parte ou Cloud](/docs/pt/authentication#restrict-login-to-your-organization), e uma chave de API Anthropic, token de autenticação ou `apiKeyHelper` está configurado em vez disso |1846| `org_pin_api_key_conflict` | Configurações gerenciadas [requerem um login de gateway de primeira parte ou Cloud](/docs/pt/authentication#restrict-login-to-your-organization), e uma chave de API Anthropic, token de autenticação ou `apiKeyHelper` está configurado em vez disso |

1847| `provider_not_allowed` | Configurações gerenciadas [listam os provedores de API que esta máquina pode usar](/docs/pt/settings-reference#allowedproviders), e a sessão está configurada para um provedor que não está listado, ou para um endpoint que as configurações não fixam. Requer Claude Code v2.1.285 ou posterior |

1846| `org_verify_failed` | A organização do login não conseguiu ser verificada contra o pin, por exemplo, por causa de uma falha de rede ou um token revogado |1848| `org_verify_failed` | A organização do login não conseguiu ser verificada contra o pin, por exemplo, por causa de uma falha de rede ou um token revogado |

1847| `org_pin_mismatch` | O login pertence a uma organização que o pin não permite |1849| `org_pin_mismatch` | O login pertence a uma organização que o pin não permite |

1848| `managed_settings_invalid` | Configurações de política gerenciada não conseguiram ser lidas, o pin não nomeia nenhuma organização, ou [restrições de modelo gerenciadas](/docs/pt/errors#managed-settings-block-the-default-model) não deixam nenhum modelo permitido para a opção Padrão |1850| `managed_settings_invalid` | Configurações de política gerenciada não conseguiram ser lidas, o pin não nomeia nenhuma organização, ou [restrições de modelo gerenciadas](/docs/pt/errors#managed-settings-block-the-default-model) não deixam nenhum modelo permitido para a opção Padrão |

3185};3187};

3186```3188```

3187 3189 

3188Executa comandos Bash com timeout opcional e execução em background. O diretório de trabalho persiste entre comandos, incluindo comandos executados em turnos posteriores de uma sessão multi-turno; o estado do shell, como variáveis de ambiente exportadas, não persiste. Para os limites sobre quais mudanças de diretório são mantidas, veja [O que persiste entre comandos](/docs/pt/tools-reference#what-persists-between-commands). Para o que define o limite de foreground, veja [Timeout e limites de saída](/docs/pt/tools-reference#timeout-and-output-limits). Para o limite de tempo em background, veja [Comandos em background](/docs/pt/tools-reference#background-commands).3190Executa comandos Bash com timeout opcional e execução em background. O diretório de trabalho persiste entre comandos, incluindo comandos executados em turnos posteriores de uma sessão multi-turno; o estado do shell, como variáveis de ambiente exportadas, não persiste. Para os limites sobre quais mudanças de diretório são mantidas, veja [O que persiste entre comandos](/docs/pt/tools-reference#what-persists-between-commands). Para o que define o limite de foreground, veja [Timeout e limites de saída](/docs/pt/tools-reference#timeout-and-output-limits). Para o limite de tempo em background, veja [Limite de tempo para comandos em background](/docs/pt/tools-reference#time-limit-for-background-commands).

3189 3191 

3190<h3 id="monitor">3192<h3 id="monitor">

3191 Monitor3193 Monitor

4089 4091 

4090`timedOutAfterMs` é o tempo limite em milissegundos, definido quando o comando atingiu seu tempo limite e passou para o segundo plano em vez de começar lá explicitamente. `backgroundCwdHint` é definido quando o comando em segundo plano continha um builtin de mudança de diretório como `cd`, `pushd`, `popd` ou `chdir`, e observa que o diretório de trabalho da sessão não mudou. Ambos os campos requerem Claude Code v2.1.210 ou posterior.4092`timedOutAfterMs` é o tempo limite em milissegundos, definido quando o comando atingiu seu tempo limite e passou para o segundo plano em vez de começar lá explicitamente. `backgroundCwdHint` é definido quando o comando em segundo plano continha um builtin de mudança de diretório como `cd`, `pushd`, `popd` ou `chdir`, e observa que o diretório de trabalho da sessão não mudou. Ambos os campos requerem Claude Code v2.1.210 ou posterior.

4091 4093 

4092Quando um subagente em execução em primeiro plano possui um comando em segundo plano, o comando [termina quando a execução desse subagente termina](/docs/pt/tools-reference#background-commands). Claude Code define `backgroundEndsWithFinalResponse` como `true` em tais comandos e omite o campo quando o comando sobrevive ao turno, como comandos iniciados pela conversa principal ou por subagentes em segundo plano fazem. O campo requer Claude Code v2.1.227 ou posterior.4094Quando um subagente em execução em primeiro plano possui um comando em segundo plano, o comando [termina quando a execução desse subagente termina](/docs/pt/tools-reference#when-a-background-command-stops). Claude Code define `backgroundEndsWithFinalResponse` como `true` em tais comandos e omite o campo quando o comando sobrevive ao turno, como comandos iniciados pela conversa principal ou por subagentes em segundo plano fazem. O campo requer Claude Code v2.1.227 ou posterior.

4093 4095 

4094Claude Code define `gitOperation.commit.branch` para o branch nomeado na linha de resumo do commit do git e o omite para um commit feito em um HEAD desanexado. O campo requer Agent SDK v0.3.227 ou posterior. Claude Code relata um comando `gh pr reopen` como a ação PR `reopened`, que requer Agent SDK v0.3.234 ou posterior.4096Claude Code define `gitOperation.commit.branch` para o branch nomeado na linha de resumo do commit do git e o omite para um commit feito em um HEAD desanexado. O campo requer Agent SDK v0.3.227 ou posterior. Claude Code relata um comando `gh pr reopen` como a ação PR `reopened`, que requer Agent SDK v0.3.234 ou posterior.

4095 4097 

8 8 

9Agent view, aberto com `claude agents`, é uma tela para todas as suas sessões em background: o que está em execução, o que precisa de sua entrada e o que está concluído. Despache novas sessões, observe seu estado rapidamente em vez de rolar pelos transcritos e intervenha apenas quando uma precisar de você. Cada sessão em background é uma conversa completa do Claude Code que continua em execução sem um terminal anexado, então você pode abri-la, responder e sair sempre que quiser.9Agent view, aberto com `claude agents`, é uma tela para todas as suas sessões em background: o que está em execução, o que precisa de sua entrada e o que está concluído. Despache novas sessões, observe seu estado rapidamente em vez de rolar pelos transcritos e intervenha apenas quando uma precisar de você. Cada sessão em background é uma conversa completa do Claude Code que continua em execução sem um terminal anexado, então você pode abri-la, responder e sair sempre que quiser.

10 10 

11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="Agent view em um terminal: o cabeçalho mostra Claude Code v2.1.140, o modelo, o diretório de trabalho e uma contagem de resumo. As sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído, com uma entrada de despacho na parte inferior e um rodapé de dicas de atalhos de teclado." width="1772" height="780" data-path="images/agent-view-light.png" />11<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-light.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=d6905012bee31f3e6b3920b09c05dd02" className="dark:hidden" alt="Agent view em um terminal. Uma linha no topo conta as sessões aguardando entrada, trabalhando e concluídas. Quatro sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído. Cada linha mostra o nome da sessão, seu status ou pergunta mais recente e um horário. Na parte inferior há uma entrada para descrever uma nova tarefa e uma linha de dicas de atalhos de teclado." width="1872" height="680" data-path="images/agent-view-light.png" />

12 12 

13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="Agent view em um terminal: o cabeçalho mostra Claude Code v2.1.140, o modelo, o diretório de trabalho e uma contagem de resumo. As sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído, com uma entrada de despacho na parte inferior e um rodapé de dicas de atalhos de teclado." width="1772" height="780" data-path="images/agent-view-dark.png" />13<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-dark.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=fc3c195bfc57e313ced1f1beb36cee93" className="hidden dark:block" alt="Agent view em um terminal. Uma linha no topo conta as sessões aguardando entrada, trabalhando e concluídas. Quatro sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído. Cada linha mostra o nome da sessão, seu status ou pergunta mais recente e um horário. Na parte inferior há uma entrada para descrever uma nova tarefa e uma linha de dicas de atalhos de teclado." width="1872" height="680" data-path="images/agent-view-dark.png" />

14 14 

15Use agent view quando você tiver várias tarefas independentes que Claude pode trabalhar sem você observar cada passo. Despache uma correção de bug, uma revisão de pull request e uma investigação de teste instável como três linhas, continue trabalhando em outra janela e verifique quando uma linha mostrar que precisa de você ou tem um resultado.15Use agent view quando você tiver várias tarefas independentes que Claude pode trabalhar sem você observar cada passo. Despache uma correção de bug, uma revisão de pull request e uma investigação de teste instável como três linhas, continue trabalhando em outra janela e verifique quando uma linha mostrar que precisa de você ou tem um resultado.

16 16 

384 384 

385Aliases de modelo como `opus` não atuam como fixações, e nem um ID de modelo que Claude Code não reconhece, como um ARN de perfil de inferência de aplicação.385Aliases de modelo como `opus` não atuam como fixações, e nem um ID de modelo que Claude Code não reconhece, como um ARN de perfil de inferência de aplicação.

386 386 

387Quando essas verificações encontram um modelo que sua conta não pode invocar, Claude Code lembra a recusa nesta máquina por até um dia, e durante esse tempo inicia ignorando o modelo lembrado sem perguntar ao Amazon Bedrock novamente. Claude Code verifica uma recusa lembrada de um modelo padrão atual novamente na inicialização uma vez que dez minutos tenham passado desde a última verificação, portanto um padrão que seu administrador reativa volta. Para desativar a memória, defina [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/pt/env-vars).

388 

389<h3 id="when-a-model-is-disabled-mid-session">

390 Quando um modelo é desabilitado durante a sessão

391</h3>

392 

393Se sua conta perder acesso ao modelo em que sua sessão está sendo executada, por exemplo porque um administrador o desabilita em sua conta Amazon Bedrock, Claude Code muda a sessão para outro modelo em vez de falhar em cada solicitação, e mostra `Switched to <fallback> because <model> is not available`. Ele tenta os mesmos modelos que o fallback de inicialização: versões anteriores do mesmo nível primeiro e, para uma sessão Opus sem nenhuma versão Opus disponível, o modelo Sonnet padrão.

394 

395A mudança se aplica apenas a um nível que você não fixou, a mesma condição que o fallback de inicialização. Uma sessão em uma versão específica que você escolheu, ou em um [ARN de perfil de inferência de aplicação](#map-each-model-version-to-an-inference-profile), mantém seu modelo e, sem uma cadeia de fallback de modelo, a solicitação falha em vez disso. Em [modo automático](/docs/pt/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code muda apenas para um modelo que o modo automático suporta no Amazon Bedrock. Se nenhum desses modelos também estiver disponível, a solicitação falha com [falha de autenticação AWS](/docs/pt/errors#aws-authentication-failed) e uma dica para ativar o modelo.

396 

397Uma [cadeia de fallback de modelo](/docs/pt/model-config#fallback-model-chains) que você configura substitui a mudança de nível: nessas recusas Claude Code muda para seu fallback configurado em vez disso. Para fazer com que solicitações recusadas falhem em vez de mudar, defina [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/pt/env-vars). Uma cadeia de fallback que você configurou ainda muda nessas recusas; remova a cadeia também se quiser que cada solicitação recusada falhe.

398 

387<h2 id="cross-region-inference-profile-prefixes">399<h2 id="cross-region-inference-profile-prefixes">

388 Prefixos de perfil de inferência entre regiões400 Prefixos de perfil de inferência entre regiões

389</h2>401</h2>

194* **Sessões do provedor de nuvem como Amazon Bedrock**: bloqueadas apenas enquanto uma credencial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper`, ou uma chave de API salva por um login anterior do Claude Console, ainda estiver presente na máquina. Remova-a e a sessão inicia. Essas sessões autenticam contra seu provedor de nuvem, cujas políticas de acesso as governam194* **Sessões do provedor de nuvem como Amazon Bedrock**: bloqueadas apenas enquanto uma credencial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper`, ou uma chave de API salva por um login anterior do Claude Console, ainda estiver presente na máquina. Remova-a e a sessão inicia. Essas sessões autenticam contra seu provedor de nuvem, cujas políticas de acesso as governam

195* **[Perfil Anthropic ou credenciais de federação](#anthropic-profiles-and-federation-credentials)**: não bloqueadas a menos que uma credencial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper`, ou uma chave de API salva por um login anterior do Claude Console, também esteja presente na máquina. As chaves não verificam a qual organização o perfil pertence195* **[Perfil Anthropic ou credenciais de federação](#anthropic-profiles-and-federation-credentials)**: não bloqueadas a menos que uma credencial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper`, ou uma chave de API salva por um login anterior do Claude Console, também esteja presente na máquina. As chaves não verificam a qual organização o perfil pertence

196 196 

197<h3 id="restrict-which-api-providers-a-machine-may-use">

198 Restrinja quais provedores de API uma máquina pode usar

199</h3>

200 

201[`allowedProviders`](/docs/pt/settings-reference#allowedproviders) em [configurações gerenciadas](/docs/pt/managed-settings) lista quais serviços uma máquina gerenciada pode alcançar Claude através, como a API Anthropic, Amazon Bedrock ou um gateway LLM. Complementa `forceLoginMethod` e `forceLoginOrgUUID`, que governam qual conta uma sessão usa quando fala com Anthropic. Requer Claude Code v2.1.285 ou posterior.

202 

203```json managed-settings.json theme={null}

204{

205 "forceLoginMethod": "claudeai",

206 "forceLoginOrgUUID": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],

207 "allowedProviders": ["anthropic", "bedrock"]

208}

209```

210 

211Com este arquivo, um desenvolvedor conectado à sua organização claude.ai ou configurado para Amazon Bedrock inicia normalmente. Uma sessão configurada para qualquer outro provedor é recusada na inicialização, e uma sessão em execução que muda para um é recusada em sua próxima solicitação. [Managed settings don't allow this API provider](/docs/pt/errors#managed-settings-dont-allow-this-api-provider) mostra cada mensagem.

212 

213* **Permita um gateway LLM ou proxy**: liste `"customEndpoint"` e defina a URL do gateway no bloco `env` gerenciado da mesma fonte. A [referência de configurações](/docs/pt/settings-reference#allowedproviders) lista cada valor e diz quais variáveis de endpoint precisam de um pino `env` gerenciado.

214* **Implante em máquinas gerenciadas**: coloque a lista na fonte gerenciada que carrega o resto de sua política. A nota [Scope](/docs/pt/settings-reference#allowedproviders) da entrada diz como uma lista gerenciada pelo servidor se combina com ela.

215* **Apenas configurações gerenciadas pelo servidor**: uma lista que você define apenas em [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) alcança apenas sessões que buscam as configurações de sua organização, então trate-a como uma conveniência para máquinas que você não consegue alcançar com gerenciamento de dispositivos, não como aplicação. [Platform availability](/docs/pt/server-managed-settings#platform-availability) lista quais sessões as buscam.

216 

197<h2 id="credential-management">217<h2 id="credential-management">

198 Gerenciamento de credenciais218 Gerenciamento de credenciais

199</h2>219</h2>

84| `--dangerously-skip-permissions` | Pular prompts de permissão. Equivalente a `--permission-mode bypassPermissions`. Veja [modos de permissão](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) para o que isso faz e não faz. Para sessões iniciadas com `--bg`, o modo [persiste quando o supervisor reinicia a sessão](/docs/pt/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | Pular prompts de permissão. Equivalente a `--permission-mode bypassPermissions`. Veja [modos de permissão](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) para o que isso faz e não faz. Para sessões iniciadas com `--bg`, o modo [persiste quando o supervisor reinicia a sessão](/docs/pt/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

85| `--debug` | Ativar modo de depuração com filtragem de categoria opcional, como `--debug='mcp,startup'` ou `--debug='!1p'`. O filtro se vincula apenas na forma `=`; um filtro separado por espaço ativa o modo de depuração sem filtragem | `claude --debug='mcp,startup'` |85| `--debug` | Ativar modo de depuração com filtragem de categoria opcional, como `--debug='mcp,startup'` ou `--debug='!1p'`. O filtro se vincula apenas na forma `=`; um filtro separado por espaço ativa o modo de depuração sem filtragem | `claude --debug='mcp,startup'` |

86| `--debug-file <path>` | Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração. Tem precedência sobre `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |86| `--debug-file <path>` | Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração. Tem precedência sobre `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

87| `--desktop` | Abrir o [aplicativo Claude Desktop](/docs/pt/desktop) no diretório atual e sair sem iniciar uma sessão no terminal. Adicione `--continue` ou `--resume` com um ID de sessão para [abrir essa sessão no Desktop](/docs/pt/desktop#coming-from-the-cli) em vez disso. `--resume` aqui leva apenas um ID de sessão, não um nome ou caminho de transcrição. Não leva prompt e nenhum outro sinalizador exceto `--verbose` e os sinalizadores `--debug`, já que o aplicativo inicia a sessão em si. Disponível em macOS e Windows x64 quando você está conectado com uma assinatura Claude. Requer Claude Code v2.1.285 ou posterior | `claude --desktop` |

87| `--disable-slash-commands` | Desativar todas as skills e comandos para esta sessão | `claude --disable-slash-commands` |88| `--disable-slash-commands` | Desativar todas as skills e comandos para esta sessão | `claude --disable-slash-commands` |

88| `--disallowedTools`, `--disallowed-tools` | Regras de negação. Um nome de ferramenta simples remove as ferramentas correspondentes do contexto do Claude: `"Edit"` remove Edit, `"*"` remove todas as ferramentas e `"mcp__*"` remove todas as ferramentas MCP. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e nega apenas chamadas correspondentes [conforme escrito](/docs/pt/permissions#bash-rule-limits). Uma regra nomeando [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) não pode removê-la enquanto qualquer outra ferramenta permanecer | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |89| `--disallowedTools`, `--disallowed-tools` | Regras de negação. Um nome de ferramenta simples remove as ferramentas correspondentes do contexto do Claude: `"Edit"` remove Edit, `"*"` remove todas as ferramentas e `"mcp__*"` remove todas as ferramentas MCP. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e nega apenas chamadas correspondentes [conforme escrito](/docs/pt/permissions#bash-rule-limits). Uma regra nomeando [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) não pode removê-la enquanto qualquer outra ferramenta permanecer | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

89| `--effort` | Definir o [nível de esforço](/docs/pt/model-config#adjust-effort-level) para a sessão atual. Opções: `low`, `medium`, `high`, `xhigh`, `max` ou `ultracode`. Os níveis disponíveis dependem do modelo. `ultracode` inicia a sessão em esforço `xhigh` com [ultracode](/docs/pt/workflows#let-claude-decide-with-ultracode) ativado e requer Claude Code v2.1.203 ou posterior. Substitui as configurações [`modelSettings`](/docs/pt/settings-reference#modelsettings) e [`effortLevel`](/docs/pt/settings-reference#effortlevel) para esta sessão e não persiste | `claude --effort high` |90| `--effort` | Definir o [nível de esforço](/docs/pt/model-config#adjust-effort-level) para a sessão atual. Opções: `low`, `medium`, `high`, `xhigh`, `max` ou `ultracode`. Os níveis disponíveis dependem do modelo. `ultracode` inicia a sessão em esforço `xhigh` com [ultracode](/docs/pt/workflows#let-claude-decide-with-ultracode) ativado e requer Claude Code v2.1.203 ou posterior. Substitui as configurações [`modelSettings`](/docs/pt/settings-reference#modelsettings) e [`effortLevel`](/docs/pt/settings-reference#effortlevel) para esta sessão e não persiste | `claude --effort high` |

111| `--no-chrome` | Desativar [integração do navegador Chrome](/docs/pt/chrome) para esta sessão | `claude --no-chrome` |112| `--no-chrome` | Desativar [integração do navegador Chrome](/docs/pt/chrome) para esta sessão | `claude --no-chrome` |

112| `--no-session-persistence` | Desativar persistência de sessão para que as sessões não sejam salvas em disco e não possam ser retomadas. Apenas modo print. A variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/pt/env-vars) faz o mesmo em qualquer modo | `claude -p --no-session-persistence "query"` |113| `--no-session-persistence` | Desativar persistência de sessão para que as sessões não sejam salvas em disco e não possam ser retomadas. Apenas modo print. A variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/pt/env-vars) faz o mesmo em qualquer modo | `claude -p --no-session-persistence "query"` |

113| `--output-format` | Especificar formato de saída para modo print (opções: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |114| `--output-format` | Especificar formato de saída para modo print (opções: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

114| `--permission-mode` | Começar em um [modo de permissão](/docs/pt/permission-modes) especificado. Aceita `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` ou `manual` como um alias para `default`. O alias `manual` seleciona o modo de permissão que a UI rotula como Manual e requer Claude Code v2.1.200 ou posterior; `claude --help` o lista no lugar de `default` e ambos os valores funcionam. Substitui `defaultMode` dos arquivos de configuração. Sem este sinalizador ou `--dangerously-skip-permissions`, uma nova sessão inicia no modo de permissão descrito em [qual modo de permissão uma sessão inicia](/docs/pt/permission-modes#which-mode-a-session-starts-in). Para `-p`, isso é `default` quando nada está configurado | `claude --permission-mode plan` |115| `--permission-mode` | Começar em um [modo de permissão](/docs/pt/permission-modes) especificado. Aceita `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` ou `manual` como um alias para `default`. O alias `manual` seleciona o modo de permissão que a UI rotula como Manual e requer Claude Code v2.1.200 ou posterior; `claude --help` o lista no lugar de `default` e ambos os valores funcionam. Substitui `defaultMode` dos arquivos de configuração. Sem este sinalizador ou `--dangerously-skip-permissions`, uma nova sessão inicia no modo de permissão descrito em [qual modo de permissão uma sessão inicia](/docs/pt/permission-modes#which-mode-a-session-starts-in), que também cobre o que uma execução `-p` inicia | `claude --permission-mode plan` |

115| `--permission-prompt-tool` | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo. Claude Code aguarda a conexão do servidor MCP dessa ferramenta antes de executar o primeiro turno, até o tempo limite de inicialização [`MCP_TIMEOUT`](/docs/pt/env-vars), 30 segundos por padrão. <br /><br />A ferramenta de prompt não pode aprovar uma ferramenta MCP marcada como [exigindo interação do usuário](/docs/pt/mcp#require-approval-for-a-specific-tool): Claude Code converte um resultado `allow` para uma em uma negação. Esta restrição requer Claude Code v2.1.199 ou posterior | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |116| `--permission-prompt-tool` | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo. Claude Code aguarda a conexão do servidor MCP dessa ferramenta antes de executar o primeiro turno, até o tempo limite de inicialização [`MCP_TIMEOUT`](/docs/pt/env-vars), 30 segundos por padrão. <br /><br />A ferramenta de prompt não pode aprovar uma ferramenta MCP marcada como [exigindo interação do usuário](/docs/pt/mcp#require-approval-for-a-specific-tool): Claude Code converte um resultado `allow` para uma em uma negação. Esta restrição requer Claude Code v2.1.199 ou posterior | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

116| `--permission-prompts` | Definir quem responde prompts de permissão em modo print. Com o padrão `host`, Claude Code os envia para o host do Agent SDK ou a ferramenta `--permission-prompt-tool`. Passe `none` quando ninguém puder responder, e Claude Code os nega em vez disso. Veja [Desativar prompts de permissão em execuções sem supervisão](/docs/pt/headless#turn-off-permission-prompts-in-unattended-runs). Requer Claude Code v2.1.259 ou posterior | `claude -p --permission-prompts none "query"` |117| `--permission-prompts` | Definir quem responde prompts de permissão em modo print. Com o padrão `host`, Claude Code os envia para o host do Agent SDK ou a ferramenta `--permission-prompt-tool`. Passe `none` quando ninguém puder responder, e Claude Code os nega em vez disso. Veja [Desativar prompts de permissão em execuções sem supervisão](/docs/pt/headless#turn-off-permission-prompts-in-unattended-runs). Requer Claude Code v2.1.259 ou posterior | `claude -p --permission-prompts none "query"` |

117| `--plugin-dir` | Carregar um plugin de um diretório ou arquivo `.zip`, ou vários de uma [pasta de plugins](/docs/pt/plugins/create#load-a-directory-or-archive-for-one-session), apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para mais caminhos: `--plugin-dir A --plugin-dir B.zip`. Passar uma pasta de plugins requer Claude Code v2.1.265 ou posterior | `claude --plugin-dir ./my-plugin` |118| `--plugin-dir` | Carregar um plugin de um diretório ou arquivo `.zip`, ou vários de uma [pasta de plugins](/docs/pt/plugins/create#load-a-directory-or-archive-for-one-session), apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para mais caminhos: `--plugin-dir A --plugin-dir B.zip`. Passar uma pasta de plugins requer Claude Code v2.1.265 ou posterior | `claude --plugin-dir ./my-plugin` |

118| `--plugin-url` | Buscar um arquivo `.zip` de plugin de uma URL apenas para esta sessão. Repita o sinalizador para vários plugins, ou passe URLs separadas por espaço em um único valor entre aspas | `claude --plugin-url https://example.com/plugin.zip` |119| `--plugin-url` | Buscar um arquivo `.zip` de plugin de uma URL apenas para esta sessão. Repita o sinalizador para vários plugins, ou passe URLs separadas por espaço em um único valor entre aspas | `claude --plugin-url https://example.com/plugin.zip` |

119| `--print`, `-p` | Imprimir resposta sem modo interativo (veja [documentação do Agent SDK](/docs/pt/agent-sdk/overview) para detalhes de uso programático) | `claude -p "query"` |120| `--print`, `-p` | Imprimir resposta sem modo interativo (veja [documentação do Agent SDK](/docs/pt/agent-sdk/overview) para detalhes de uso programático). Para `--resume` em uma sessão de fundo que ainda está em execução, veja [Retomar uma sessão](/docs/pt/sessions#resume-a-running-background-session) | `claude -p "query"` |

120| `--prompt-suggestions` | Emitir uma mensagem `prompt_suggestion` com um prompt de usuário previsto após cada turno que gera um; conversas muito curtas podem não produzir nenhum. Requer `--print`, `--output-format stream-json` e `--verbose`. Veja [Sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |121| `--prompt-suggestions` | Emitir uma mensagem `prompt_suggestion` com um prompt de usuário previsto após cada turno que gera um; conversas muito curtas podem não produzir nenhum. Requer `--print`, `--output-format stream-json` e `--verbose`. Veja [Sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

121| `--ref <branch>` | Com `--environment`, basear o checkout da nova sessão em uma ref nomeada em vez de `HEAD` local | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |122| `--ref <branch>` | Com `--environment`, basear o checkout da nova sessão em uma ref nomeada em vez de `HEAD` local | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |

122| `--remote` | Alias descontinuado para `--cloud`, incluindo o formulário de sessão existente | `claude --remote "Fix the login bug"` |123| `--remote` | Alias descontinuado para `--cloud`, incluindo o formulário de sessão existente | `claude --remote "Fix the login bug"` |

124| `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão [Remote Control](/docs/pt/remote-control) gerados automaticamente quando nenhum nome explícito está definido. Padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito | `claude remote-control --remote-control-session-name-prefix dev-box` |125| `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão [Remote Control](/docs/pt/remote-control) gerados automaticamente quando nenhum nome explícito está definido. Padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito | `claude remote-control --remote-control-session-name-prefix dev-box` |

125| `--replay-user-messages` | Re-emitir mensagens do usuário de stdin de volta em stdout para confirmação. Requer `--input-format stream-json` e `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |126| `--replay-user-messages` | Re-emitir mensagens do usuário de stdin de volta em stdout para confirmação. Requer `--input-format stream-json` e `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

126| `--restricted` | Iniciar em modo restrito. Use-o quando um harness de avaliação dirige `claude` em uma máquina compartilhada e Claude Code não deve executar comandos ou ler configurações de usuário e projeto dessa máquina. Claude Code remove as ferramentas integradas que executam comandos ou código, e WebFetch, a menos que você as nomeie individualmente em `--tools`, não através do preset `default`. Também confina as ferramentas de arquivo integradas aos [diretórios de trabalho](/docs/pt/permissions#working-directories), carrega apenas [configurações gerenciadas](/docs/pt/managed-settings) e `--settings`, recusa [`bypassPermissions`](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) e [recusa criar sessões em nuvem](/docs/pt/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Requer Claude Code v2.1.248 ou posterior | `claude --restricted -p "query"` |127| `--restricted` | Iniciar em modo restrito. Use-o quando um harness de avaliação dirige `claude` em uma máquina compartilhada e Claude Code não deve executar comandos ou ler configurações de usuário e projeto dessa máquina. Claude Code remove as ferramentas integradas que executam comandos ou código, e WebFetch, a menos que você as nomeie individualmente em `--tools`, não através do preset `default`. Também confina as ferramentas de arquivo integradas aos [diretórios de trabalho](/docs/pt/permissions#working-directories), carrega apenas [configurações gerenciadas](/docs/pt/managed-settings) e `--settings`, recusa [`bypassPermissions`](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) e [recusa criar sessões em nuvem](/docs/pt/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Requer Claude Code v2.1.248 ou posterior | `claude --restricted -p "query"` |

127| `--resume`, `-r` | Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão. No lugar de um ID, você pode passar o caminho absoluto para o arquivo de [transcrição](/docs/pt/sessions#where-transcripts-are-stored) `.jsonl` de uma sessão. O seletor e a busca por nome incluem sessões que adicionaram este diretório com `/add-dir`. Quando você passa um ID de sessão, Claude Code pesquisa o diretório do projeto atual e seus git worktrees, depois todos os outros projetos nesta máquina. Antes de v2.1.223, a busca de ID cobria apenas o diretório do projeto atual e seus git worktrees. [Sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg` | `claude --resume auth-refactor` |128| `--resume`, `-r` | Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão. No lugar de um ID, você pode passar o caminho absoluto para o arquivo de [transcrição](/docs/pt/sessions#where-transcripts-are-stored) `.jsonl` de uma sessão. O seletor e a busca por nome incluem sessões que adicionaram este diretório com `/add-dir`. Quando você passa um ID de sessão, Claude Code pesquisa o diretório do projeto atual e seus git worktrees, depois todos os outros projetos nesta máquina. Antes de v2.1.223, a busca de ID cobria apenas o diretório do projeto atual e seus git worktrees. [Sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg`. Retomar uma que ainda está em execução [abre essa sessão](/docs/pt/sessions#resume-a-running-background-session) neste terminal através de `claude attach`, e um prompt que você passa na linha de comando vai para ela como seu próximo turno. Antes de v2.1.285, Claude Code recusava e imprimia o comando `claude attach` para executar em vez disso | `claude --resume auth-refactor` |

128| `--safe-mode` | Iniciar com todas as personalizações desativadas para solucionar problemas de uma configuração quebrada: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente, o que difere de [`--bare`](/docs/pt/headless#start-faster-with-bare-mode). A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, linha de status e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Útil para verificar se uma personalização é o que dispara [fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback). Define [`CLAUDE_CODE_SAFE_MODE`](/docs/pt/env-vars) | `claude --safe-mode` |129| `--safe-mode` | Iniciar com todas as personalizações desativadas para solucionar problemas de uma configuração quebrada: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente, o que difere de [`--bare`](/docs/pt/headless#start-faster-with-bare-mode). A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, linha de status e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Útil para verificar se uma personalização é o que dispara [fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback). Define [`CLAUDE_CODE_SAFE_MODE`](/docs/pt/env-vars) | `claude --safe-mode` |

129| `--session-id` | Usar um ID de sessão específico para a conversa (deve ser um UUID válido) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |130| `--session-id` | Usar um ID de sessão específico para a conversa (deve ser um UUID válido) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

130| `--setting-sources` | Lista separada por vírgula de fontes de configuração a carregar (`user`, `project`, `local`). Veja [agent view](/docs/pt/agent-view#what-carries-over-when-you-background) e [agent teams](/docs/pt/agent-teams#context-and-communication) para as sessões que você inicia a partir desta que herdam a lista | `claude --setting-sources user,project` |131| `--setting-sources` | Lista separada por vírgula de fontes de configuração a carregar (`user`, `project`, `local`). Veja [agent view](/docs/pt/agent-view#what-carries-over-when-you-background) e [agent teams](/docs/pt/agent-teams#context-and-communication) para as sessões que você inicia a partir desta que herdam a lista | `claude --setting-sources user,project` |

439 439 

440* **Comandos que Claude executa**: um ambiente na nuvem não define seu próprio timeout de comando, portanto os padrões da ferramenta Bash se aplicam. Claude aguarda 2 minutos por um comando por padrão e pode pedir até 10 minutos.440* **Comandos que Claude executa**: um ambiente na nuvem não define seu próprio timeout de comando, portanto os padrões da ferramenta Bash se aplicam. Claude aguarda 2 minutos por um comando por padrão e pode pedir até 10 minutos.

441 441 

442 Quando um comando atinge seu [timeout](/docs/pt/tools-reference#timeout-and-output-limits), Claude Code [o move para o background](/docs/pt/tools-reference#background-commands) em vez de pará-lo, a menos que o comando comece com `sleep`. Um comando movido dessa forma pode continuar executando por até 30 minutos a mais antes de Claude Code pará-lo em seu [limite de tempo de background](/docs/pt/tools-reference#background-commands). Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `1800000` milissegundos alonga esse limite bem como o padrão de foreground.442 Quando um comando atinge seu [timeout](/docs/pt/tools-reference#timeout-and-output-limits), Claude Code [o move para o background](/docs/pt/tools-reference#foreground-commands-that-move-to-the-background) em vez de pará-lo, a menos que o comando comece com `sleep`. Um comando movido dessa forma pode continuar executando por até 30 minutos a mais antes de Claude Code pará-lo em seu [limite de tempo de background](/docs/pt/tools-reference#time-limit-for-background-commands). Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `1800000` milissegundos alonga esse limite bem como o padrão de foreground.

443* **Hooks SessionStart**: Claude Code cancela um hook `command` após 600 segundos a menos que você defina [`timeout`](/docs/pt/hooks#common-fields), em segundos, na entrada do hook. Claude Code não aplica o timeout em um hook que você executa com [`async: true`](/docs/pt/hooks#run-hooks-in-the-background).443* **Hooks SessionStart**: Claude Code cancela um hook `command` após 600 segundos a menos que você defina [`timeout`](/docs/pt/hooks#common-fields), em segundos, na entrada do hook. Claude Code não aplica o timeout em um hook que você executa com [`async: true`](/docs/pt/hooks#run-hooks-in-the-background).

444* **Script de configuração**: um script que leva mais tempo do que aproximadamente cinco minutos não é armazenado em cache. [Requisitos de script](#script-requirements) cobre como ficar abaixo disso.444* **Script de configuração**: um script que leva mais tempo do que aproximadamente cinco minutos não é armazenado em cache. [Requisitos de script](#script-requirements) cobre como ficar abaixo disso.

445* **Sessões inativas**: após alguns minutos sem atividade, a VM de uma sessão pausa com seus arquivos salvos, e uma VM pausada pode ser recuperada posteriormente. [Defina variáveis de ambiente](#set-environment-variables) descreve o que uma sessão pega em cada caso, e [Environment expired](/docs/pt/claude-code-on-the-web#environment-expired) cobre como reabrir uma sessão cuja VM foi recuperada.445* **Sessões inativas**: após alguns minutos sem atividade, a VM de uma sessão pausa com seus arquivos salvos, e uma VM pausada pode ser recuperada posteriormente. [Defina variáveis de ambiente](#set-environment-variables) descreve o que uma sessão pega em cada caso, e [Environment expired](/docs/pt/claude-code-on-the-web#environment-expired) cobre como reabrir uma sessão cuja VM foi recuperada.

132| `/remote-control` | Disponibilize esta sessão para [Remote Control](/docs/pt/remote-control) de claude.ai. Executá-lo enquanto desconectado imprime que Remote Control requer uma assinatura claude.ai e diz como conectar; antes da v2.1.206 relatava `Unknown command: /remote-control`. Alias: `/rc` |132| `/remote-control` | Disponibilize esta sessão para [Remote Control](/docs/pt/remote-control) de claude.ai. Executá-lo enquanto desconectado imprime que Remote Control requer uma assinatura claude.ai e diz como conectar; antes da v2.1.206 relatava `Unknown command: /remote-control`. Alias: `/rc` |

133| `/remote-env` | Escolha o [ambiente em nuvem](/docs/pt/cloud-environments#select-an-environment-from-the-cli) padrão para sessões em nuvem que você inicia a partir da CLI |133| `/remote-env` | Escolha o [ambiente em nuvem](/docs/pt/cloud-environments#select-an-environment-from-the-cli) padrão para sessões em nuvem que você inicia a partir da CLI |

134| `/rename [name]` | Renomeie a sessão atual e mostre o nome na barra de prompt. Sem um nome, auto-gera um a partir do histórico de conversa. Também disponível em modo não interativo (`-p`); requer Claude Code v2.1.205 ou posterior. De cada superfície de renomeação, incluindo claude.ai e o aplicativo de desktop, Claude Code substitui caracteres de controle e invisíveis no novo nome com espaços e limita o nome a 200 caracteres. Se o nome estiver vazio uma vez que caracteres invisíveis são removidos, Claude Code o rejeita e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. A substituição de caracteres e limite de comprimento requerem Claude Code v2.1.221 ou posterior. Se outra sessão ativa nesta máquina já usar um nome que você passa, Claude Code aplica [uma variante dele](/docs/pt/sessions#name-your-sessions) |134| `/rename [name]` | Renomeie a sessão atual e mostre o nome na barra de prompt. Sem um nome, auto-gera um a partir do histórico de conversa. Também disponível em modo não interativo (`-p`); requer Claude Code v2.1.205 ou posterior. De cada superfície de renomeação, incluindo claude.ai e o aplicativo de desktop, Claude Code substitui caracteres de controle e invisíveis no novo nome com espaços e limita o nome a 200 caracteres. Se o nome estiver vazio uma vez que caracteres invisíveis são removidos, Claude Code o rejeita e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. A substituição de caracteres e limite de comprimento requerem Claude Code v2.1.221 ou posterior. Se outra sessão ativa nesta máquina já usar um nome que você passa, Claude Code aplica [uma variante dele](/docs/pt/sessions#name-your-sessions) |

135| `/resume [session]` | Retome uma conversa por ID ou nome, ou abra o seletor de sessão. [Sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg`; uma que ainda está em execução não pode ser retomada aqui, então anexe-a de `claude agents` ou pare-a lá primeiro. Alias: `/continue` |135| `/resume [session]` | Retome uma conversa por ID ou nome, ou abra o seletor de sessão. [Sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg`. Retomar uma que ainda está em execução, do seletor ou por ID ou nome, [abre essa sessão](/docs/pt/sessions#resume-a-running-background-session): sua conversa atual se move para o fundo e este terminal se anexa à em execução. Pressione `←` em um prompt vazio para retornar à visualização de agente, que também lista a conversa que você deixou. Antes da v2.1.285, Claude Code recusava e dizia para abrir a sessão com `claude attach` ou pará-la primeiro. Alias: `/continue` |

136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias de [`/code-review`](/docs/pt/code-review#review-a-diff-locally): revisa o diff atual, ou um número de PR, branch ou caminho que você passa, como `/review 1234`, e toma os mesmos níveis de esforço e sinalizadores. Sem um nível dado, a revisão reutiliza o último nível `low` através `max` que você digitou; consulte [Revise um diff localmente](/docs/pt/code-review#review-a-diff-locally) para as regras exatas. Para uma revisão em nuvem profunda, use [`/code-review ultra`](/docs/pt/ultrareview). Antes da v2.1.223, `/review` era um comando separado que executava uma revisão de uma única passagem, somente leitura de um pull request GitHub por número, listando PRs abertos para escolher quando executado sem argumento; de v2.1.186 através v2.1.201, executava o mesmo mecanismo multi-agente que `/code-review medium` |136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias de [`/code-review`](/docs/pt/code-review#review-a-diff-locally): revisa o diff atual, ou um número de PR, branch ou caminho que você passa, como `/review 1234`, e toma os mesmos níveis de esforço e sinalizadores. Sem um nível dado, a revisão reutiliza o último nível `low` através `max` que você digitou; consulte [Revise um diff localmente](/docs/pt/code-review#review-a-diff-locally) para as regras exatas. Para uma revisão em nuvem profunda, use [`/code-review ultra`](/docs/pt/ultrareview). Antes da v2.1.223, `/review` era um comando separado que executava uma revisão de uma única passagem, somente leitura de um pull request GitHub por número, listando PRs abertos para escolher quando executado sem argumento; de v2.1.186 através v2.1.201, executava o mesmo mecanismo multi-agente que `/code-review medium` |

137| `/rewind` | Retroceda a conversa e/ou código para um ponto anterior, ou resuma a partir de uma mensagem selecionada. Consulte [checkpointing](/docs/pt/checkpointing). Aliases: `/checkpoint`, `/undo` |137| `/rewind` | Retroceda a conversa e/ou código para um ponto anterior, ou resuma a partir de uma mensagem selecionada. Consulte [checkpointing](/docs/pt/checkpointing). Aliases: `/checkpoint`, `/undo` |

138| `/run` | **[Skill](/docs/pt/skills#bundled-skills).** Inicie e dirija o aplicativo do seu projeto para ver uma mudança funcionando, não apenas passando testes. Consulte [Execute e verifique seu aplicativo](/docs/pt/skills#run-and-verify-your-app) |138| `/run` | **[Skill](/docs/pt/skills#bundled-skills).** Inicie e dirija o aplicativo do seu projeto para ver uma mudança funcionando, não apenas passando testes. Consulte [Execute e verifique seu aplicativo](/docs/pt/skills#run-and-verify-your-app) |

967 967 

968Para mover uma sessão CLI para Desktop, execute `/desktop` no terminal. Claude salva sua sessão e a abre no aplicativo desktop, depois sai do CLI. Este comando está disponível em macOS e Windows x64 quando você está conectado com uma assinatura Claude. Não está disponível com autenticação de chave de API ou em Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.968Para mover uma sessão CLI para Desktop, execute `/desktop` no terminal. Claude salva sua sessão e a abre no aplicativo desktop, depois sai do CLI. Este comando está disponível em macOS e Windows x64 quando você está conectado com uma assinatura Claude. Não está disponível com autenticação de chave de API ou em Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

969 969 

970Do seu shell, [`claude --desktop`](/docs/pt/cli-reference#cli-flags) abre Desktop diretamente sem iniciar uma sessão de terminal. Requer Claude Code v2.1.285 ou posterior e tem os mesmos requisitos de plataforma e login que `/desktop`. Sem outros argumentos, abre Desktop no diretório atual. Para abrir uma sessão CLI existente em Desktop, adicione `--continue` para a conversa mais recente neste diretório, ou `--resume` com o ID da sessão que `/status` mostra:

971 

972```bash theme={null}

973claude --desktop --resume <session-id>

974```

975 

976Claude Code imprime `Opening session <session-id> in Claude Desktop`, a sessão abre no aplicativo e o comando sai. Um nome de sessão não funciona no lugar do ID. Claude Code não move uma sessão que está aberta em outro terminal ou ainda em execução em segundo plano. Se Claude Desktop não estiver instalado, o comando imprime um link de download e sai.

977 

970Você também pode retomar uma sessão CLI de dentro do Desktop com `/resume`. O comando está disponível em sessões locais, não em SSH, WSL ou sessões na nuvem.978Você também pode retomar uma sessão CLI de dentro do Desktop com `/resume`. O comando está disponível em sessões locais, não em SSH, WSL ou sessões na nuvem.

971 979 

972Para continuar uma sessão de terminal em Desktop:980Para continuar uma sessão de terminal em Desktop:

331| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |331| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |

332| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |332| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |

333| `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) |333| `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) |

334| `Your organization's managed settings allow Claude Code to use: <providers>` | [Configuration warnings](#managed-settings-dont-allow-this-api-provider) |

335| `Your organization's managed settings allow Claude Code to use no API provider at all` | [Configuration warnings](#managed-settings-dont-allow-this-api-provider) |

334| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |336| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |

335| `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) |337| `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) |

336| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |338| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

339| `Unable to read managed policy settings` | [Configuration warnings](#unable-to-read-managed-policy-settings) |

337| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |340| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |

338| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |341| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |

339| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |342| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |

3657 Não foi possível abrir Claude Desktop3660 Não foi possível abrir Claude Desktop

3658</h3>3661</h3>

3659 3662 

3660Você executou [`/desktop`](/docs/pt/desktop#coming-from-the-cli), ou seu alias `/app`, e o comando do sistema que Claude Code usa para abrir Claude Desktop falhou. A sessão permanece no terminal.3663Você executou [`/desktop`](/docs/pt/desktop#coming-from-the-cli) ou seu alias `/app` em uma sessão, ou [`claude --desktop`](/docs/pt/cli-reference#cli-flags) em seu shell, e o comando do sistema que Claude Code usa para abrir Claude Desktop falhou. Depois de `/desktop`, a sessão permanece no terminal; `claude --desktop` imprime a mensagem sem o prefixo `Error:` e sai com status 1.

3664 

3665O texto entre parênteses nomeia o comando que falhou, com seu status de saída e a primeira linha de sua saída de erro quando a produziu. No macOS esse comando é `open`, como neste exemplo; no Windows é `rundll32`:

3661 3666 

3662```text theme={null}3667```text theme={null}

3663Error: 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 run /desktop again.3668Error: 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.

3664```3669```

3665 3670 

3666**O que fazer:**3671**O que fazer:**

3667 3672 

3668* Abra Claude Desktop você mesmo, depois execute `/desktop` novamente3673* Abra Claude Desktop você mesmo, depois execute `/desktop` ou `claude --desktop` novamente

3669* Para ler a saída de erro completa desse comando, ative o log de debug com `/debug`, execute `/desktop` novamente e verifique o log de debug3674* Para ler a saída de erro completa do comando que falhou, ative o log de debug com `/debug` e execute `/desktop` novamente, ou execute `claude --desktop --debug-file <path>`, depois verifique o log de debug

3670 3675 

3671Antes da v2.1.275, a mensagem era `Failed to open Claude Desktop. Please try opening it manually.` e não dizia o que falhou.3676Antes da v2.1.285, a mensagem terminava `Open Claude Desktop and run /desktop again.` Antes da v2.1.275, era `Failed to open Claude Desktop. Please try opening it manually.` e não dizia o que falhou.

3672 3677 

3673<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3678<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3674 /terminal-setup deixou seu mapa de teclas Zed inalterado3679 /terminal-setup deixou seu mapa de teclas Zed inalterado

5193* Se você administra as configurações, adicione um modelo que seus usuários possam executar a `availableModels`, ou estreite as entradas `deniedModels` que bloqueiam cada fallback. [Bloquear modelos ou versões específicas](/docs/pt/model-config#block-specific-models-or-versions) descreve como a opção Padrão faz downgrade5198* Se você administra as configurações, adicione um modelo que seus usuários possam executar a `availableModels`, ou estreite as entradas `deniedModels` que bloqueiam cada fallback. [Bloquear modelos ou versões específicas](/docs/pt/model-config#block-specific-models-or-versions) descreve como a opção Padrão faz downgrade

5194* 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` gerenciada5199* 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

5195 5200 

5201<h3 id="managed-settings-dont-allow-this-api-provider">

5202 As configurações gerenciadas não permitem este provedor de API

5203</h3>

5204 

5205As [configurações gerenciadas](/docs/pt/managed-settings) de sua organização definem uma lista [`allowedProviders`](/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:

5206 

5207```text theme={null}

5208Your organization's managed settings allow Claude Code to use: Anthropic API, Amazon Bedrock.

5209```

5210 

5211Quando a lista está vazia, a mensagem lê em vez disso:

5212 

5213```text theme={null}

5214Your 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.

5215```

5216 

5217Quando cada entrada é não reconhecida, o parêntese lê `(allowedProviders lists only unrecognized entries)` em vez disso.

5218 

5219**O que fazer:**

5220 

5221* Siga as etapas `To continue:` da mensagem

5222* 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`](/docs/pt/settings-reference#allowedproviders) diz qual bloco `env` da fonte pode fixá-lo

5223 

5196<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5224<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">

5197 O servidor MCP é bloqueado pela política gerenciada da empresa5225 O servidor MCP é bloqueado pela política gerenciada da empresa

5198</h3>5226</h3>

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

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

5248 5276 

5277<h3 id="unable-to-read-managed-policy-settings">

5278 Não foi possível ler as configurações de política gerenciada

5279</h3>

5280 

5281Sua organização implanta [configurações gerenciadas](/docs/pt/managed-settings), 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:

5282 

5283```text theme={null}

5284Unable to read managed policy settings.

5285This machine may require organization login enforcement, but the policy file failed to load.

5286Contact your administrator.

5287 

5288Detail: <source>: <reason>

5289```

5290 

5291No mesmo estado, fluxos de login, solicitações de API de uma sessão que já está em execução, e o servidor [`claude gateway`](/docs/pt/claude-apps-gateway) são recusados com uma variante da primeira linha que nomeia [`allowedProviders`](/docs/pt/settings-reference#allowedproviders).

5292 

5293Uma 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](/docs/pt/managed-settings#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).

5294 

5295**O que fazer:**

5296 

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

5298* Se não, envie a mensagem ao seu administrador. Nada em seus próprios arquivos de configurações causa ou limpa este erro

5299 

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

5301 

5249<h3 id="otelheadershelper-failed">5302<h3 id="otelheadershelper-failed">

5250 otelHeadersHelper falhou5303 otelHeadersHelper falhou

5251</h3>5304</h3>

5458 As respostas parecem ter qualidade inferior ao usual5511 As respostas parecem ter qualidade inferior ao usual

5459</h2>5512</h2>

5460 5513 

5461Se 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 em três casos específicos:5514Se 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:

5462 5515 

5463* Um [`--fallback-model`](/docs/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição5516* Um [`--fallback-model`](/docs/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição

5464* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível5517* 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](/docs/pt/amazon-bedrock#when-a-model-is-disabled-mid-session)

5465* [Fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) no Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 e Opus 5 move a sessão para o modelo de fallback da categoria sinalizada, quando essa categoria tem um, e mostra um aviso na transcrição5518* [Fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) no Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 e Opus 5 move a sessão para o modelo de fallback da categoria sinalizada, quando essa categoria tem um, e mostra um aviso na transcrição

5466 5519 

5467A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](/docs/pt/model-config) explica quando cada fallback se aplica.5520A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](/docs/pt/model-config) explica quando cada fallback se aplica.

293 293 

294Aliases de modelo como `opus` não atuam como fixações, e nem um ID de modelo que Claude Code não reconhece.294Aliases de modelo como `opus` não atuam como fixações, e nem um ID de modelo que Claude Code não reconhece.

295 295 

296Quando essas verificações encontram um modelo que seu projeto não pode invocar, Claude Code lembra a recusa nesta máquina por até um dia, e inicia durante esse tempo pulando o modelo lembrado sem perguntar à Plataforma de Agentes novamente. Claude Code verifica uma recusa lembrada de um modelo padrão atual novamente na inicialização uma vez que dez minutos tenham passado desde a última verificação, então um padrão que seu administrador reativa volta. Para desativar a memória, defina [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/pt/env-vars).

297 

298<h3 id="when-a-model-is-disabled-mid-session">

299 Quando um modelo é desativado durante a sessão

300</h3>

301 

302Se seu projeto perder acesso ao modelo em que sua sessão está sendo executada, por exemplo porque um administrador o desativa no [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), Claude Code muda a sessão para outro modelo em vez de falhar em cada solicitação, e mostra `Switched to <fallback> because <model> is not available`. Ele tenta os mesmos modelos que o fallback de inicialização: versões anteriores do mesmo nível primeiro e, para uma sessão Opus sem nenhuma versão Opus disponível, o modelo Sonnet padrão.

303 

304A mudança se aplica apenas a um nível que você não fixou, a mesma condição que o fallback de inicialização. Uma sessão em uma versão específica que você escolheu mantém seu modelo e, sem uma cadeia de modelo fallback, a solicitação falha em vez disso. No [modo automático](/docs/pt/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code muda apenas para um modelo que o modo automático suporta na Plataforma de Agentes. Se nenhum desses modelos estiver disponível também, a solicitação falha.

305 

306Uma [cadeia de modelo fallback](/docs/pt/model-config#fallback-model-chains) que você configura substitui a mudança de nível: nessas recusas Claude Code muda para seu fallback configurado em vez disso. Para fazer com que solicitações recusadas falhem em vez de mudar, defina [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/pt/env-vars). Uma cadeia de fallback que você configurou ainda muda nessas recusas; remova a cadeia também se quiser que cada solicitação recusada falhe.

307 

296<h2 id="iam-configuration">308<h2 id="iam-configuration">

297 Configuração de IAM309 Configuração de IAM

298</h2>310</h2>

296 Aprovar ferramentas automaticamente296 Aprovar ferramentas automaticamente

297</h3>297</h3>

298 298 

299Use `--allowedTools` para permitir que Claude use certas ferramentas sem solicitar. Este exemplo executa um conjunto de testes e corrige falhas, permitindo que Claude execute comandos Bash e leia/edite arquivos sem pedir permissão:299Use `--allowedTools` para permitir que Claude use certas ferramentas sem solicitar. Listar `Read` e `Edit` permite que Claude leia e edite arquivos sem pedir permissão. Listar `Bash` faz o mesmo para comandos de shell, exceto em uma execução que começa em [modo auto](/docs/pt/permission-modes#how-auto-mode-evaluates-actions), onde Claude Code descarta uma entrada `Bash` simples como uma regra de permissão ampla e o modo auto avalia cada comando em vez disso. Este exemplo executa um conjunto de testes e corrige falhas com essas três ferramentas listadas:

300 300 

301```bash theme={null}301```bash theme={null}

302claude -p "Run the test suite and fix any failures" \302claude -p "Run the test suite and fix any failures" \

303 --allowedTools "Bash,Read,Edit"303 --allowedTools "Bash,Read,Edit"

304```304```

305 305 

306Para definir uma linha de base para toda a sessão em vez de listar ferramentas individuais, passe um [modo de permissão](/docs/pt/permission-modes). Para `-p`, o [modo de permissão inicial integrado](/docs/pt/permission-modes#which-mode-a-session-starts-in) é Manual em todos os planos, então passe o modo de permissão que você deseja:306Para definir uma linha de base para toda a sessão em vez de listar ferramentas individuais, passe um [modo de permissão](/docs/pt/permission-modes). Uma execução onde nada define um modo de permissão toma o [modo de permissão inicial integrado](/docs/pt/permission-modes#which-mode-a-session-starts-in), que pode ser `auto`, então passe o que você deseja:

307 307 

308* **`auto`**: passe `--permission-mode auto` para ter um classificador revisar a maioria das ações em vez de você308* **`auto`**: passe `--permission-mode auto` para ter um classificador revisar a maioria das ações em vez de você

309* **`dontAsk`**: Claude Code nega qualquer chamada que de outra forma solicitaria, o que é útil para execuções de CI bloqueadas. Ações que não precisam de aprovação no modo Manual ainda são executadas, como leituras de arquivo em seus diretórios de trabalho e o [conjunto de comandos somente leitura](/docs/pt/permissions#read-only-commands), e também ações que suas entradas `--allowedTools` ou regras `permissions.allow` cobrem. `AskUserQuestion`, ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) são negadas mesmo quando uma regra de permissão corresponde309* **`dontAsk`**: Claude Code nega qualquer chamada que de outra forma solicitaria, o que é útil para execuções de CI bloqueadas. Ações que não precisam de aprovação no modo Manual ainda são executadas, como leituras de arquivo em seus diretórios de trabalho e o [conjunto de comandos somente leitura](/docs/pt/permissions#read-only-commands), e também ações que suas entradas `--allowedTools` ou regras `permissions.allow` cobrem. `AskUserQuestion`, ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) são negadas mesmo quando uma regra de permissão corresponde

1938| :- | :- |1938| :- | :- |

1939| `permissionDecision` | `"allow"` pula o prompt de permissão, exceto para as [ações que nenhum modo auto-aprova](/docs/pt/permission-modes#actions-no-mode-auto-approves) e para `AskUserQuestion` e `ExitPlanMode`, que precisam de [`updatedInput` emparelhado com ele](#allow-with-updatedinput). `"deny"` impede a chamada de ferramenta. `"ask"` solicita ao usuário para confirmar. `"defer"` sai graciosamente para que a ferramenta possa ser retomada mais tarde. [Regras de negação e pergunta](/docs/pt/permissions#manage-permissions) ainda são avaliadas independentemente do que o hook retorna |1939| `permissionDecision` | `"allow"` pula o prompt de permissão, exceto para as [ações que nenhum modo auto-aprova](/docs/pt/permission-modes#actions-no-mode-auto-approves) e para `AskUserQuestion` e `ExitPlanMode`, que precisam de [`updatedInput` emparelhado com ele](#allow-with-updatedinput). `"deny"` impede a chamada de ferramenta. `"ask"` solicita ao usuário para confirmar. `"defer"` sai graciosamente para que a ferramenta possa ser retomada mais tarde. [Regras de negação e pergunta](/docs/pt/permissions#manage-permissions) ainda são avaliadas independentemente do que o hook retorna |

1940| `permissionDecisionReason` | Para `"ask"`, mostrado ao usuário mas não ao Claude. Para `"deny"`, mostrado ao Claude. Para `"allow"` e `"defer"`, escrito apenas no [log de depuração](#debug-hooks) |1940| `permissionDecisionReason` | Para `"ask"`, mostrado ao usuário mas não ao Claude. Para `"deny"`, mostrado ao Claude. Para `"allow"` e `"defer"`, escrito apenas no [log de depuração](#debug-hooks) |

1941| `updatedInput` | Modifica os parâmetros de entrada da ferramenta antes da execução. Substitui o objeto de entrada inteiro, então inclua campos inalterados junto com os modificados. Claude Code avalia regras de permissão e a elegibilidade de [colocação em segundo plano automático](/docs/pt/tools-reference#background-commands) de um comando Bash contra a entrada que seu hook retorna, não a entrada que Claude enviou. Combine com `"allow"` para auto-aprovar, ou `"ask"` para mostrar a entrada modificada ao usuário. Para `"defer"`, ignorado |1941| `updatedInput` | Modifica os parâmetros de entrada da ferramenta antes da execução. Substitui o objeto de entrada inteiro, então inclua campos inalterados junto com os modificados. Claude Code avalia regras de permissão e a elegibilidade de [colocação em segundo plano automático](/docs/pt/tools-reference#foreground-commands-that-move-to-the-background) de um comando Bash contra a entrada que seu hook retorna, não a entrada que Claude enviou. Combine com `"allow"` para auto-aprovar, ou `"ask"` para mostrar a entrada modificada ao usuário. Para `"defer"`, ignorado |

1942| `additionalContext` | String adicionada ao contexto do Claude junto com o resultado da ferramenta. Ignorado quando `permissionDecision` é `"defer"`. Veja [Adicionar contexto para Claude](#add-context-for-claude) |1942| `additionalContext` | String adicionada ao contexto do Claude junto com o resultado da ferramenta. Ignorado quando `permissionDecision` é `"defer"`. Veja [Adicionar contexto para Claude](#add-context-for-claude) |

1943 1943 

1944Quando vários hooks PreToolUse retornam decisões diferentes, a precedência é `deny` > `defer` > `ask` > `allow`.1944Quando vários hooks PreToolUse retornam decisões diferentes, a precedência é `deny` > `defer` > `ask` > `allow`.

346* Solicitar ao Claude Code que execute um comando em segundo plano346* Solicitar ao Claude Code que execute um comando em segundo plano

347* Pressionar `Ctrl+B` para mover uma invocação regular da ferramenta Bash para o segundo plano. Usuários de Tmux devem pressionar `Ctrl+B` duas vezes devido à chave de prefixo do tmux.347* Pressionar `Ctrl+B` para mover uma invocação regular da ferramenta Bash para o segundo plano. Usuários de Tmux devem pressionar `Ctrl+B` duas vezes devido à chave de prefixo do tmux.

348 348 

349Quando um comando atinge seu tempo limite antes de terminar, Claude Code o move automaticamente [para o segundo plano](/docs/pt/tools-reference#background-commands) em vez de interrompê-lo, a menos que o comando comece com `sleep`. Para alterar quanto tempo os comandos são executados antes disso acontecer, defina as [variáveis de ambiente de tempo limite do Bash](/docs/pt/tools-reference#timeout-and-output-limits).349Quando um comando atinge seu tempo limite antes de terminar, Claude Code o move automaticamente [para o segundo plano](/docs/pt/tools-reference#foreground-commands-that-move-to-the-background) em vez de interrompê-lo, a menos que o comando comece com `sleep`. Se você desativou tarefas em segundo plano com [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/pt/env-vars#variables) ou iniciando em [modo bare](/docs/pt/headless#start-faster-with-bare-mode), o comando para em seu tempo limite. Para alterar o tempo limite, defina as [variáveis de ambiente de tempo limite do Bash](/docs/pt/tools-reference#timeout-and-output-limits).

350 350 

351**Recursos principais:**351**Recursos principais:**

352 352 

358* No macOS e Linux, Claude Code encerra as tarefas em segundo plano em execução quando o sistema operacional sinaliza pressão de memória crítica, desde que a sessão tenha ficado ociosa por pelo menos 30 minutos e nenhuma volta ou subagente esteja em execução. Requer Claude Code v2.1.193 ou posterior358* No macOS e Linux, Claude Code encerra as tarefas em segundo plano em execução quando o sistema operacional sinaliza pressão de memória crítica, desde que a sessão tenha ficado ociosa por pelo menos 30 minutos e nenhuma volta ou subagente esteja em execução. Requer Claude Code v2.1.193 ou posterior

359 * O [log de depuração](/docs/pt/debug-your-config) diz por que as tarefas foram interrompidas, ou por que um evento de pressão as deixou em execução359 * O [log de depuração](/docs/pt/debug-your-config) diz por que as tarefas foram interrompidas, ou por que um evento de pressão as deixou em execução

360 * Defina [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/pt/env-vars) como `1` para desativar paradas por pressão de memória360 * Defina [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/pt/env-vars) como `1` para desativar paradas por pressão de memória

361* Comandos Bash e PowerShell em segundo plano têm um limite de tempo, contado a partir do momento em que o comando entra em segundo plano: 30 minutos, ou o `timeout` que Claude solicita quando inicia um comando em segundo plano, até um máximo de 2 horas. Um comando que se move para o segundo plano enquanto é executado, por exemplo com `Ctrl+B`, recebe 30 minutos a partir da mudança. Quando um comando atinge seu limite, Claude Code o interrompe e diz a Claude por quê, e Claude pode iniciá-lo novamente com um `timeout` mais longo se o trabalho ainda precisar dele. Duas variáveis de ambiente aumentam os limites, em milissegundos, e nenhuma delas pode encurtá-los:361* Comandos Bash e PowerShell em segundo plano têm um limite de tempo, contado a partir do momento em que o comando entra em segundo plano: 30 minutos, ou o `timeout` que Claude solicita quando inicia um comando em segundo plano, até um máximo de 2 horas. Um comando que se move para o segundo plano enquanto é executado, por exemplo com `Ctrl+B`, recebe 30 minutos a partir da mudança. Quando um comando atinge seu limite, Claude Code o interrompe e diz a Claude por quê, e Claude pode iniciá-lo novamente com um `timeout` mais longo se o trabalho ainda precisar dele. Para aumentar os limites, veja [Aumentar o limite de tempo para comandos em segundo plano](/docs/pt/tools-reference#raise-the-time-limit-for-background-commands) na referência de ferramentas

362 * Defina [`BASH_DEFAULT_TIMEOUT_MS`](/docs/pt/env-vars) acima de `1800000` para substituir o padrão de 30 minutos por esse valor, para comandos movidos também362* Um comando em segundo plano que um [subagente](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) em primeiro plano iniciou termina quando a execução desse subagente termina, independentemente de ter terminado, falhado ou sido interrompido; veja [Quando um comando em segundo plano para](/docs/pt/tools-reference#when-a-background-command-stops) na referência de ferramentas

363 * Defina [`BASH_MAX_TIMEOUT_MS`](/docs/pt/env-vars) acima de `7200000` para aumentar o máximo de 2 horas. Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `7200000` aumenta-o da mesma forma

364* Um comando em segundo plano que um [subagente](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) em primeiro plano iniciou termina quando a execução desse subagente termina, independentemente de ter terminado, falhado ou sido interrompido; veja [Comandos em segundo plano](/docs/pt/tools-reference#background-commands) na referência de ferramentas

365 363 

366Para desabilitar toda a funcionalidade de tarefas em segundo plano, defina a variável de ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` como `1`. Veja [Variáveis de ambiente](/docs/pt/env-vars) para detalhes.364Para desabilitar toda a funcionalidade de tarefas em segundo plano, defina a variável de ambiente [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/pt/env-vars#variables) como `1`. Iniciar em [modo bare](/docs/pt/headless#start-faster-with-bare-mode) também desativa.

367 365 

368**Comandos comuns colocados em segundo plano:**366**Comandos comuns colocados em segundo plano:**

369 367 

45 45 

46[Implantar um gateway LLM para sua organização](/docs/pt/llm-gateway-rollout) percorre cada etapa e mostra os arquivos de configuração para distribuir em cada uma. O gateway é uma parte da configuração da organização; para aplicação de política, visibilidade de uso e decisões de tratamento de dados, consulte [Configurar Claude Code para sua organização](/docs/pt/admin-setup).46[Implantar um gateway LLM para sua organização](/docs/pt/llm-gateway-rollout) percorre cada etapa e mostra os arquivos de configuração para distribuir em cada uma. O gateway é uma parte da configuração da organização; para aplicação de política, visibilidade de uso e decisões de tratamento de dados, consulte [Configurar Claude Code para sua organização](/docs/pt/admin-setup).

47 47 

48Para fazer um gateway alcançado através de `ANTHROPIC_BASE_URL` o único destino que uma máquina gerenciada pode usar, defina [`allowedProviders`](/docs/pt/settings-reference#allowedproviders) como `["customEndpoint"]` no mesmo arquivo de configurações gerenciadas e coloque a `ANTHROPIC_BASE_URL` do gateway nesse bloco `env` do arquivo. Claude Code então recusa uma sessão apontada para qualquer outro lugar, incluindo diretamente para Anthropic ou para o próprio proxy de um desenvolvedor, e aceita `ANTHROPIC_BASE_URL` apenas com o valor que você definir lá. Para um gateway alcançado através de uma variável de endpoint específica do provedor, como `ANTHROPIC_BEDROCK_BASE_URL`, a entrada `allowedProviders` diz qual variável fixar. Requer Claude Code v2.1.285 ou posterior.

49 

48<h2 id="subscriptions-and-gateways">50<h2 id="subscriptions-and-gateways">

49 Assinaturas e gateways51 Assinaturas e gateways

50</h2>52</h2>

199 199 

200As [chaves de login do gateway](#choose-a-delivery-mechanism) seguem uma regra separada. Claude Code nunca as lê de configurações gerenciadas pelo servidor, então enquanto configurações gerenciadas pelo servidor são a fonte selecionada, a fonte de administrador com classificação mais alta na máquina que carrega uma chave de política ainda as fornece. Um valor em uma fonte de administrador classificada abaixo daquela, ou no registro HKCU, é ignorado.200As [chaves de login do gateway](#choose-a-delivery-mechanism) seguem uma regra separada. Claude Code nunca as lê de configurações gerenciadas pelo servidor, então enquanto configurações gerenciadas pelo servidor são a fonte selecionada, a fonte de administrador com classificação mais alta na máquina que carrega uma chave de política ainda as fornece. Um valor em uma fonte de administrador classificada abaixo daquela, ou no registro HKCU, é ignorado.

201 201 

202[`allowedProviders`](/docs/pt/settings-reference#allowedproviders) tem sua própria regra: a nota Scope da entrada diz como uma lista definida na máquina se combina com uma gerenciada pelo servidor. Requer Claude Code v2.1.285 ou posterior.

203 

202Quando uma fonte de administrador define `allowManagedMcpServersOnly` ou uma lista `allowedMcpServers` e esse valor não é o que está em vigor, `/status` e `claude doctor` nomeiam essa fonte e chave.204Quando uma fonte de administrador define `allowManagedMcpServersOnly` ou uma lista `allowedMcpServers` e esse valor não é o que está em vigor, `/status` e `claude doctor` nomeiam essa fonte e chave.

203 205 

204<h3 id="compose-every-managed-source">206<h3 id="compose-every-managed-source">

353* Um arquivo de configurações gerenciadas vazio conta como `{}`.355* Um arquivo de configurações gerenciadas vazio conta como `{}`.

354* Um valor malformado na chave de registro HKCU gravável pelo usuário nunca bloqueia o lançamento. Claude Code o relata como um aviso em `/status` e `claude doctor` em vez disso.356* Um valor malformado na chave de registro HKCU gravável pelo usuário nunca bloqueia o lançamento. Claude Code o relata como um aviso em `/status` e `claude doctor` em vez disso.

355 357 

356Se um arquivo de configurações gerenciadas, arquivo drop-in ou diretório `managed-settings.d/` não puder ser lido e nenhuma fonte de administrador fornecer uma política, sessões conectadas com credenciais claude.ai ou Claude Console saem na inicialização com uma mensagem para contatar um administrador.358Quando um arquivo de configurações gerenciadas, arquivo drop-in, diretório `managed-settings.d/`, perfil MDM ou valor de registro HKLM existe mas não pode ser lido, e nenhuma fonte de administrador fornece uma política, o que acontece depende do motivo da falha de leitura:

359 

360* Se o sistema operacional negou a leitura, por exemplo em um arquivo somente raiz, cada sessão inicia sem as políticas dessa fonte. `/status` e `claude doctor` registram a falha, e uma execução com `-p` também a imprime para stderr.

361* Para qualquer outra falha de leitura, como um erro de E/S, cada sessão sai na inicialização com [uma mensagem para contatar um administrador](/docs/pt/errors#unable-to-read-managed-policy-settings).

357 362 

358Para encontrar uma entrada descartada, procure em um de três lugares:363Para encontrar uma entrada descartada, procure em um de três lugares:

359 364 

387| Campo | Comportamento quando presente mas inválido |392| Campo | Comportamento quando presente mas inválido |

388| :- | :- |393| :- | :- |

389| `allowedMcpServers` | Aplicado como uma lista de permissões vazia até que o valor seja corrigido, portanto nenhum servidor MCP que os usuários adicionem é admitido. Servidores que sua organização entrega através de [`managedMcpServers`](/docs/pt/settings-reference#managedmcpservers) ainda carregam, e servidores `managed-mcp.json` carregam por [Como um servidor é avaliado](/docs/pt/managed-mcp#how-a-server-is-evaluated). Uma entrada individual inválida é removida e o subconjunto válido é aplicado. |394| `allowedMcpServers` | Aplicado como uma lista de permissões vazia até que o valor seja corrigido, portanto nenhum servidor MCP que os usuários adicionem é admitido. Servidores que sua organização entrega através de [`managedMcpServers`](/docs/pt/settings-reference#managedmcpservers) ainda carregam, e servidores `managed-mcp.json` carregam por [Como um servidor é avaliado](/docs/pt/managed-mcp#how-a-server-is-evaluated). Uma entrada individual inválida é removida e o subconjunto válido é aplicado. |

395| [`allowedProviders`](/docs/pt/settings-reference#allowedproviders) | Aplicado como uma lista de permissões vazia até que o valor seja corrigido, portanto cada provedor de API é recusado e Claude Code não inicia na máquina. Se apenas uma entrada individual não for um nome de provedor conhecido, Claude Code descarta e relata essa entrada e aplica o resto. |

390| `allowedHttpHookUrls` | Claude Code aplica uma [lista de permissões](/docs/pt/settings-reference#allowedhttphookurls) gerenciada vazia até que você corrija o valor, portanto um hook HTTP é executado apenas se outro arquivo de configurações listar sua URL. Se apenas uma entrada individual for inválida, Claude Code remove essa entrada e aplica o resto. |396| `allowedHttpHookUrls` | Claude Code aplica uma [lista de permissões](/docs/pt/settings-reference#allowedhttphookurls) gerenciada vazia até que você corrija o valor, portanto um hook HTTP é executado apenas se outro arquivo de configurações listar sua URL. Se apenas uma entrada individual for inválida, Claude Code remove essa entrada e aplica o resto. |

391| `httpHookAllowedEnvVars` | Claude Code aplica uma [lista de permissões](/docs/pt/settings-reference#httphookallowedenvvars) gerenciada vazia até que você corrija o valor, portanto uma variável de cabeçalho é interpolada apenas se outro arquivo de configurações a nomear. Se apenas uma entrada individual for inválida, Claude Code remove essa entrada e aplica o resto. |397| `httpHookAllowedEnvVars` | Claude Code aplica uma [lista de permissões](/docs/pt/settings-reference#httphookallowedenvvars) gerenciada vazia até que você corrija o valor, portanto uma variável de cabeçalho é interpolada apenas se outro arquivo de configurações a nomear. Se apenas uma entrada individual for inválida, Claude Code remove essa entrada e aplica o resto. |

392| `allowedChannelPlugins` | Claude Code aplica uma lista de permissões vazia até que você corrija o valor, portanto nenhum plugin de canal passado para `--channels` é admitido. Se apenas uma entrada individual for inválida, ele remove essa entrada e aplica o resto. |398| `allowedChannelPlugins` | Claude Code aplica uma lista de permissões vazia até que você corrija o valor, portanto nenhum plugin de canal passado para `--channels` é admitido. Se apenas uma entrada individual for inválida, ele remove essa entrada e aplica o resto. |

437 443 

438A maioria delas são bloqueios: o valor que um bloqueio governa, como regras de permissão ou `sandbox.network.allowedDomains`, é uma chave ordinária que qualquer nível pode definir, e o bloqueio diz ao Claude Code para honrar apenas o valor gerenciado.444A maioria delas são bloqueios: o valor que um bloqueio governa, como regras de permissão ou `sandbox.network.allowedDomains`, é uma chave ordinária que qualquer nível pode definir, e o bloqueio diz ao Claude Code para honrar apenas o valor gerenciado.

439 445 

440A tabela cobre os controles de permissão, plugin e entrega. Para qualquer chave não listada aqui, a coluna Escopo da [referência de configurações](/docs/pt/settings-reference#all-settings) diz se é apenas gerenciada; as chaves apenas gerenciadas restantes lá incluem a URL de login do gateway, versão, navegador, simulador móvel, host SSH, sessão local do Desktop, caminho binário da sandbox, preço do modelo, restrição de modelo e controles CLAUDE.md.446A tabela cobre os controles de permissão, plugin e entrega. Para qualquer chave não listada aqui, a coluna Escopo da [referência de configurações](/docs/pt/settings-reference#all-settings) diz se é apenas gerenciada.

441 447 

442| Configuração | Descrição |448| Configuração | Descrição |

443| :- | :- |449| :- | :- |

321 321 

322* **Espaço em branco oculto**: Claude Code avisa quando um valor de configuração MCP carrega espaço em branco oculto à esquerda ou à direita, que frequentemente vem de colar um token com uma quebra de linha à direita. Claude Code verifica `command`, `url`, cada entrada `args`, e os valores e nomes de chave sob `env` e `headers`. Claude Code mostra o aviso na saída de `claude mcp list` e em `/mcp`, nomeando os campos afetados sem ecoar seus valores, por exemplo `Leading or trailing whitespace in: headers.Authorization`. Claude Code não aparenta o espaço em branco e usa os valores exatamente como escritos, portanto edite a configuração para removê-lo.322* **Espaço em branco oculto**: Claude Code avisa quando um valor de configuração MCP carrega espaço em branco oculto à esquerda ou à direita, que frequentemente vem de colar um token com uma quebra de linha à direita. Claude Code verifica `command`, `url`, cada entrada `args`, e os valores e nomes de chave sob `env` e `headers`. Claude Code mostra o aviso na saída de `claude mcp list` e em `/mcp`, nomeando os campos afetados sem ecoar seus valores, por exemplo `Leading or trailing whitespace in: headers.Authorization`. Claude Code não aparenta o espaço em branco e usa os valores exatamente como escritos, portanto edite a configuração para removê-lo.

323* **Mesmo nome em mais de um escopo**: se você definir o mesmo nome de servidor em mais de um [escopo](#mcp-installation-scopes) com endpoints diferentes, Claude Code avisa sobre o conflito na saída de `claude mcp list` e em `/mcp`. Claude Code armazena logins OAuth por endpoint, portanto quando você autentica a definição que carrega em um projeto, você ainda precisa fazer login separadamente em um projeto onde uma definição diferente carrega. Mantenha o endpoint que você quer e remova os outros com `claude mcp remove <name> --scope <scope>`. No aviso, Claude Code cita o endpoint de cada escopo como escrito em sua configuração, com referências [`${VAR}`](#environment-variable-expansion-in-mcp-json) não expandidas, portanto nunca mostra um valor resolvido como uma chave de API.323* **Mesmo nome em mais de um escopo**: se você definir o mesmo nome de servidor em mais de um [escopo](#mcp-installation-scopes) com endpoints diferentes, Claude Code avisa sobre o conflito na saída de `claude mcp list` e em `/mcp`. Claude Code armazena logins OAuth por endpoint, portanto quando você autentica a definição que carrega em um projeto, você ainda precisa fazer login separadamente em um projeto onde uma definição diferente carrega. Mantenha o endpoint que você quer e remova os outros com `claude mcp remove <name> --scope <scope>`. No aviso, Claude Code cita o endpoint de cada escopo como escrito em sua configuração, com referências [`${VAR}`](#environment-variable-expansion-in-mcp-json) não expandidas, portanto nunca mostra um valor resolvido como uma chave de API.

324* **Nomes reservados**: Claude Code reserva os nomes de seus servidores integrados, incluindo `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview`, e `Claude Browser`. Se sua configuração definir um servidor com um nome reservado, Claude Code o pula no tempo de carregamento e mostra um aviso pedindo que você o renomeie. `claude mcp add` rejeita um nome reservado com um erro. `Claude Preview` e `Claude Browser` ambos nomeiam o servidor integrado que o [painel de visualização do aplicativo de desktop Claude Code](/docs/pt/desktop#preview-your-app) usa. Antes da v2.1.205, `Claude Browser` não era reservado, portanto um servidor configurado pelo usuário poderia se registrar sob esse nome.324* **Nomes reservados**: Claude Code reserva os nomes de seus servidores integrados, incluindo `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview`, e `Claude Browser`. Se sua configuração definir um servidor com um nome reservado, Claude Code o pula no tempo de carregamento e mostra um aviso pedindo que você o renomeie. `claude mcp add` rejeita um nome reservado com um erro. `Claude Preview` e `Claude Browser` ambos nomeiam o servidor integrado que o [painel de visualização do aplicativo de desktop Claude Code](/docs/pt/desktop#preview-your-app) usa.

325* **Variável de ambiente ausente**: se uma referência [`${VAR}`](#environment-variable-expansion-in-mcp-json) na configuração de um servidor nomeia uma variável que não está definida e não tem `:-default`, Claude Code avisa na saída de `claude mcp list` e em `/mcp`, nomeando a variável, e ainda carrega o servidor com o texto `${VAR}` não expandido. Defina a variável ou adicione um fallback `${VAR:-default}`. Em uma URL remota do servidor e `headers`, algumas variáveis de credenciais [leem como vazias](#credential-variables-that-read-as-empty) em vez disso, sem aviso.325* **Variável de ambiente ausente**: se uma referência [`${VAR}`](#environment-variable-expansion-in-mcp-json) na configuração de um servidor nomeia uma variável que não está definida e não tem `:-default`, Claude Code avisa na saída de `claude mcp list` e em `/mcp`, nomeando a variável, e ainda carrega o servidor com o texto `${VAR}` não expandido. Defina a variável ou adicione um fallback `${VAR:-default}`. Em uma URL remota do servidor e `headers`, algumas variáveis de credenciais [leem como vazias](#credential-variables-that-read-as-empty) em vez disso, sem aviso.

326 326 

327<h4 id="tool-availability">327<h4 id="tool-availability">

553 553 

554Os servidores de plugin aparecem em `/mcp` com indicadores mostrando que vêm de plugins.554Os servidores de plugin aparecem em `/mcp` com indicadores mostrando que vêm de plugins.

555 555 

556Para um servidor stdio de um plugin, `claude mcp get` imprime `Command: stdio`, uma linha `Args:` vazia, e cada variável de ambiente como `NAME=[REDACTED]`. Os valores são ocultados porque podem carregar credenciais.

557 

556**Nomes de ferramentas MCP de plugin**:558**Nomes de ferramentas MCP de plugin**:

557 559 

558As ferramentas de um servidor MCP agrupado em plugin incluem tanto o nome do plugin quanto a chave do servidor em seu nome chamável. A forma completa é `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, onde qualquer caractere fora de `A-Z`, `a-z`, `0-9`, `_`, e `-` é substituído por `_`. Para o servidor `database-tools` agrupado em um plugin nomeado `my-plugin`, uma ferramenta `query` é chamável como:560As ferramentas de um servidor MCP agrupado em plugin incluem tanto o nome do plugin quanto a chave do servidor em seu nome chamável. A forma completa é `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, onde qualquer caractere fora de `A-Z`, `a-z`, `0-9`, `_`, e `-` é substituído por `_`. Para o servidor `database-tools` agrupado em um plugin nomeado `my-plugin`, uma ferramenta `query` é chamável como:

360 360 

361 O que acontece a seguir diz onde o problema está:361 O que acontece a seguir diz onde o problema está:

362 362 

363 * O comando inicia e aguarda entrada: o servidor em si funciona. Execute `claude mcp get <name>` e confirme que o comando mostrado lá corresponde ao que você acabou de executar. Se o comando mostrado diferir do que você digitou, você provavelmente omitiu o separador `--` antes do comando do servidor. Remova o servidor e readicione-o com `--` no lugar. Se você escreveu `.mcp.json` à mão, verifique sua sintaxe e localização.363 * O comando inicia e aguarda entrada: o servidor em si funciona.

364 

365 Execute `claude mcp get <name>` e confirme que o comando mostrado lá corresponde ao que você acabou de executar. Se o comando mostrado diferir do que você digitou, você provavelmente omitiu o separador `--` antes do comando do servidor. Remova o servidor e readicione-o com `--` no lugar. Se você escreveu `.mcp.json` à mão, verifique sua sintaxe e localização. Antes da v2.1.285, `claude mcp get` não imprimia nenhuma linha `Command` para uma entrada stdio salva sem um campo `type`, como uma entrada `.mcp.json` escrita à mão. Nessas versões, execute `claude mcp list` em vez disso, que imprime a linha de comando de qualquer forma.

364 * O comando erros: a mensagem nomeia o que está faltando, como Node.js ou um navegador.366 * O comando erros: a mensagem nomeia o que está faltando, como Node.js ou um navegador.

365 </Accordion>367 </Accordion>

366 368 

521 Cadeias de modelo de fallback521 Cadeias de modelo de fallback

522</h3>522</h3>

523 523 

524Quando o modelo primário está sobrecarregado, indisponível ou retorna outro erro de servidor não repetível, Claude Code pode alternar para um modelo de fallback em vez de falhar na solicitação. Autenticação, faturamento, limite de taxa, tamanho de solicitação e erros de transporte, e uma [negação pela verificação de política da sua organização](/docs/pt/errors#automatic-retries), nunca acionam uma alternância; esses seguem sua manipulação normal de repetição e erro.524Quando o modelo primário está sobrecarregado, indisponível ou retorna outro erro de servidor não repetível, Claude Code pode alternar para um modelo de fallback em vez de falhar na solicitação. Autenticação, faturamento, limite de taxa, tamanho de solicitação e erros de transporte, e uma [negação pela verificação de política da sua organização](/docs/pt/errors#automatic-retries), nunca acionam uma alternância; esses seguem sua manipulação normal de repetição e erro. Ele alterna quando [Amazon Bedrock](/docs/pt/amazon-bedrock#when-a-model-is-disabled-mid-session) ou [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai#when-a-model-is-disabled-mid-session) recusa um modelo que sua conta não pode invocar, o que Claude Code trata como o modelo estar indisponível em vez de um erro de autenticação.

525 525 

526Configure um ou mais modelos de fallback e Claude Code os tenta em ordem, mostrando um aviso quando alterna. A alternância dura apenas para o turno atual, portanto sua próxima mensagem tenta o modelo primário primeiro novamente. Claude Code limita cadeias a três modelos após remoção de duplicatas e ignora entradas extras.526Configure um ou mais modelos de fallback e Claude Code os tenta em ordem, mostrando um aviso quando alterna. A alternância dura apenas para o turno atual, portanto sua próxima mensagem tenta o modelo primário primeiro novamente. Claude Code limita cadeias a três modelos após remoção de duplicatas e ignora entradas extras.

527 527 

1430* `error.type`: por que Claude Code parou a sessão. Presente apenas em eventos `refused`:1430* `error.type`: por que Claude Code parou a sessão. Presente apenas em eventos `refused`:

1431 * `"helper_failed"`: uma [execução de auxiliar de política falhou](/docs/pt/settings-reference#helper-failures)1431 * `"helper_failed"`: uma [execução de auxiliar de política falhou](/docs/pt/settings-reference#helper-failures)

1432 * `"policy_invalid"`: as configurações gerenciadas contêm um erro que para Claude Code de iniciar, ou uma fonte de admin falhou em carregar, então Claude Code não pode verificar a imposição de login da organização1432 * `"policy_invalid"`: as configurações gerenciadas contêm um erro que para Claude Code de iniciar, ou uma fonte de admin falhou em carregar, então Claude Code não pode verificar a imposição de login da organização

1433 * `"provider_not_allowed"`: a sessão usaria um provedor de API, ou enviaria o tráfego de um provedor para um host, que a lista [`allowedProviders`](/docs/pt/settings-reference#allowedproviders) gerenciada não permite. Requer Claude Code v2.1.285 ou posterior

1433 * `"consent_rejected"`: o usuário rejeitou o [diálogo de aprovação de segurança](/docs/pt/server-managed-settings#security-approval-dialogs) para configurações gerenciadas pelo servidor1434 * `"consent_rejected"`: o usuário rejeitou o [diálogo de aprovação de segurança](/docs/pt/server-managed-settings#security-approval-dialogs) para configurações gerenciadas pelo servidor

1434 * `"force_refresh_failed"`: a busca de configurações que [`forceRemoteSettingsRefresh`](/docs/pt/settings-reference#forceremotesettingsrefresh) requer falhou1435 * `"force_refresh_failed"`: a busca de configurações que [`forceRemoteSettingsRefresh`](/docs/pt/settings-reference#forceremotesettingsrefresh) requer falhou

1435 * `"gateway_rejected"`: um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) respondeu ao carregamento de configurações gerenciadas com HTTP 4031436 * `"gateway_rejected"`: um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) respondeu ao carregamento de configurações gerenciadas com HTTP 403

86| Como você executa Claude Code | Modo de permissão inicial integrado |86| Como você executa Claude Code | Modo de permissão inicial integrado |

87| :- | :- |87| :- | :- |

88| Qualquer arquivo de configurações define `disableAutoMode` como `"disable"` | `default` |88| Qualquer arquivo de configurações define `disableAutoMode` como `"disable"` | `default` |

89| `claude -p` ou o [Agent SDK](/docs/pt/agent-sdk/permissions) | `default` |89| `claude -p` ou o [Agent SDK Python](/docs/pt/agent-sdk/python#claudeagentoptions) sem `permission_mode` | `default` em sessões que [buscam sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching). Em sessões que não buscam, como em um provedor de terceiros ou com telemetria desativada, `auto` com Claude Code v2.1.285 ou posterior e `default` em versões anteriores |

90| Em um terminal ou através da [extensão VS Code](/docs/pt/vs-code) | `auto` com Claude Code v2.1.283 ou posterior; em versões anteriores, `auto` em planos Pro, Max ou Team em sessões que [buscam sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching), e `default` caso contrário |90| Em um terminal ou através da [extensão VS Code](/docs/pt/vs-code) | `auto` com Claude Code v2.1.283 ou posterior; em versões anteriores, `auto` em planos Pro, Max ou Team em sessões que [buscam sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching), e `default` caso contrário |

91 91 

92Em sua [primeira sessão após uma instalação ou upgrade](/docs/pt/env-vars#first-session-after-an-install-or-upgrade), Claude Code pode escolher o modo de permissão inicial antes de seus sinalizadores de recurso chegarem. Essa sessão pode iniciar em um modo de permissão diferente do que a tabela fornece, e sua próxima sessão corresponde à tabela.92Em sua [primeira sessão após uma instalação ou upgrade](/docs/pt/env-vars#first-session-after-an-install-or-upgrade), Claude Code pode escolher o modo de permissão inicial antes de seus sinalizadores de recurso chegarem. Essa sessão pode iniciar em um modo de permissão diferente do que a tabela fornece, e sua próxima sessão corresponde à tabela.

98* Em um terminal, uma vez, no topo da sessão98* Em um terminal, uma vez, no topo da sessão

99* Na extensão VS Code, como um cartão na tela de nova conversa que permanece até você descartá-lo99* Na extensão VS Code, como um cartão na tela de nova conversa que permanece até você descartá-lo

100 100 

101Nos planos Pro, Max e Team, se seu `~/.claude/settings.json` define um `defaultMode` diferente de `auto` e nenhum outro arquivo de configurações define um, suas sessões continuam iniciando nesse modo. Claude Code pergunta uma vez, no terminal ou na extensão VS Code, se você quer alterar a configuração para modo automático. Se você recusar, sua configuração permanece como está.101Se seu `~/.claude/settings.json` define um `defaultMode` diferente de `auto` e nenhum outro arquivo de configurações define um, suas sessões continuam iniciando nesse modo. Nos planos Pro, Max e Team, e em sessões que [não buscam sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching), Claude Code pergunta uma vez, no terminal ou na extensão VS Code, se você quer alterar a configuração para modo automático. Se você recusar, sua configuração permanece como está.

102 102 

103<h3 id="start-in-a-different-mode">103<h3 id="start-in-a-different-mode">

104 Inicie em um modo de permissão diferente104 Inicie em um modo de permissão diferente

322 Modo automático no Bedrock, Agent Platform ou Foundry322 Modo automático no Bedrock, Agent Platform ou Foundry

323</h3>323</h3>

324 324 

325No [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) e sessões [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectadas, o modo automático está disponível por padrão. Com Claude Code v2.1.283 ou posterior, também é o [modo de permissão inicial integrado](#which-mode-a-session-starts-in) para sessões de terminal interativo e [VS Code](/docs/pt/vs-code). Para escolher o modo de permissão inicial você mesmo, defina `permissions.defaultMode` conforme [Iniciar em um modo de permissão diferente](#start-in-a-different-mode) descreve, ou escolha um modo de permissão do indicador de modo da extensão VS Code.325No [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) e sessões [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectadas, o modo automático está disponível por padrão. Quando nada mais define um modo de permissão, também é o [modo de permissão inicial integrado](#which-mode-a-session-starts-in), nas versões que a seção anterior lista. Para escolher o modo de permissão inicial você mesmo, defina `permissions.defaultMode` conforme [Iniciar em um modo de permissão diferente](#start-in-a-different-mode) descreve, ou escolha um modo de permissão do indicador de modo da extensão VS Code.

326 326 

327Apenas Claude Sonnet 5 ou posterior, Opus 4.7 ou posterior e os modelos Fable são suportados nesses provedores. Em qualquer outro modelo, a sessão inicia em Manual em vez disso.327Apenas Claude Sonnet 5 ou posterior, Opus 4.7 ou posterior e os modelos Fable são suportados nesses provedores. Em qualquer outro modelo, a sessão inicia em Manual em vez disso.

328 328 

554 <Accordion title="Custo e latência">554 <Accordion title="Custo e latência">

555 O classificador executa em Claude Sonnet 5 por padrão em vez de em sua seleção `/model`. Um modelo classificador que a Anthropic configura no servidor tem precedência sobre esse padrão. Quando o modelo de sua sessão é Claude Sonnet 4.6, ou quando [`availableModels`](/docs/pt/model-config#restrict-model-selection) exclui Sonnet 5, o classificador executa no modelo de sua sessão em vez disso, ou em um modelo Opus quando a sessão executa em um [modelo Fable](/docs/pt/model-config#work-with-fable); em provedores diferentes da API Anthropic, esse fallback Opus é o modelo Opus padrão do provedor.555 O classificador executa em Claude Sonnet 5 por padrão em vez de em sua seleção `/model`. Um modelo classificador que a Anthropic configura no servidor tem precedência sobre esse padrão. Quando o modelo de sua sessão é Claude Sonnet 4.6, ou quando [`availableModels`](/docs/pt/model-config#restrict-model-selection) exclui Sonnet 5, o classificador executa no modelo de sua sessão em vez disso, ou em um modelo Opus quando a sessão executa em um [modelo Fable](/docs/pt/model-config#work-with-fable); em provedores diferentes da API Anthropic, esse fallback Opus é o modelo Opus padrão do provedor.

556 556 

557 A primeira solicitação de modo automático da sessão valida o padrão Sonnet 5: se a solicitação for bem-sucedida, Sonnet 5 permanece o modelo classificador da sessão, e se falhar porque o modelo não está disponível, a sessão usa o fallback em vez disso. Depois que essa validação se resolve, o modelo do classificador não muda para a sessão.557 A primeira solicitação de modo automático da sessão valida o padrão Sonnet 5: se a solicitação for bem-sucedida, Sonnet 5 permanece o modelo classificador da sessão, e se falhar porque o modelo não está disponível, a sessão usa o fallback em vez disso.

558 558 

559 Em planos Enterprise e em contas que usam a API Claude, [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry, chamadas do classificador contam para seu uso de token. Cada verificação envia uma porção da transcrição mais a ação pendente, adicionando uma volta antes da execução. Leituras e edições de diretório de trabalho fora de caminhos protegidos pulam o classificador, portanto a sobrecarga vem principalmente de comandos de shell e operações de rede. Onde o servidor revisa as ações como parte das solicitações de modelo da sessão, não há chamadas do classificador separadas para contar; consulte [Revisão do classificador no servidor](#server-side-classifier-review).559 Em planos Enterprise e em contas que usam a API Claude, [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry, chamadas do classificador contam para seu uso de token. Cada verificação envia uma porção da transcrição mais a ação pendente, adicionando uma volta antes da execução. Leituras e edições de diretório de trabalho fora de caminhos protegidos pulam o classificador, portanto a sobrecarga vem principalmente de comandos de shell e operações de rede. Onde o servidor revisa as ações como parte das solicitações de modelo da sessão, não há chamadas do classificador separadas para contar; consulte [Revisão do classificador no servidor](#server-side-classifier-review).

560 560 

29Cada subcomando compartilha estes códigos de saída, argumentos de plugin e valores de escopo:29Cada subcomando compartilha estes códigos de saída, argumentos de plugin e valores de escopo:

30 30 

31* **Códigos de saída**: `0` em caso de sucesso e `1` em caso de falha. `validate` adiciona saída `2` para um erro inesperado, e `eval` adiciona os códigos listados em [sua seção](#plugin-eval).31* **Códigos de saída**: `0` em caso de sucesso e `1` em caso de falha. `validate` adiciona saída `2` para um erro inesperado, e `eval` adiciona os códigos listados em [sua seção](#plugin-eval).

32* **Argumentos de plugin**: um argumento `<plugin>` é um `name` de plugin ou `name@marketplace`. Quando dois marketplaces oferecem o mesmo nome, use a forma qualificada.32* **Argumentos de plugin**: um argumento `<plugin>` é um `name` de plugin ou `name@marketplace`. Quando dois marketplaces oferecem o mesmo nome, use a forma qualificada. `configure` aceita apenas a forma qualificada.

33* **Escopos**: `--scope` aceita `user`, `project` ou `local`, e nomeia o arquivo de configurações que o comando escreve. `update` também aceita `managed`.33* **Escopos**: `--scope` aceita `user`, `project` ou `local`, e nomeia o arquivo de configurações que o comando escreve. `update` também aceita `managed`.

34 34 

35<h3 id="plugin-init">35<h3 id="plugin-init">

87| Flag | Descrição |87| Flag | Descrição |

88| :- | :- |88| :- | :- |

89| `-s, --scope <scope>` | Escopo de instalação: `user`, `project` ou `local`. Padrão é `user` |89| `-s, --scope <scope>` | Escopo de instalação: `user`, `project` ou `local`. Padrão é `user` |

90| `--config <key=value>` | Defina uma opção [`userConfig`](/docs/pt/plugins/manifest-reference) que o manifesto do plugin declara. Repita a flag para cada opção. Requer Claude Code v2.1.147 ou posterior |90| `--config <key=value>` | Defina uma opção [`userConfig`](/docs/pt/plugins/manifest-reference) que o manifesto do plugin declara. Repita a flag para cada opção. Requer Claude Code v2.1.147 ou posterior. Uma chave escrita como `<server>.<key>` define uma configuração que um [servidor MCP empacotado](/docs/pt/plugins/components#include-a-packaged-mcpb-server) declara em sua própria `user_config`, para um arquivo de pacote enviado dentro do plugin. A forma `<server>.<key>` requer Claude Code v2.1.285 ou posterior |

91| `-y, --yes` | Aceite o comando de instalação exibido sem o prompt `Run this command now?`. Ignorado quando o comando é executado dentro de uma sessão Claude Code, como da ferramenta Bash ou um hook. Requer Claude Code v2.1.229 ou posterior |91| `-y, --yes` | Aceite o comando de instalação exibido sem o prompt `Run this command now?`. Ignorado quando o comando é executado dentro de uma sessão Claude Code, como da ferramenta Bash ou um hook. Requer Claude Code v2.1.229 ou posterior |

92| `--accept-command <sha256>` | Aceite o comando de instalação exibido cujo `sha256` uma execução anterior [`--json`](#plugin-json-result) relatou em `shownCommand`, no lugar de `-y`. Não pode ser combinado com `-y`. Veja [Aceitar um comando de instalação exibido](#accept-a-displayed-install-command). Requer Claude Code v2.1.271 ou posterior |92| `--accept-command <sha256>` | Aceite o comando de instalação exibido cujo `sha256` uma execução anterior [`--json`](#plugin-json-result) relatou em `shownCommand`, no lugar de `-y`. Não pode ser combinado com `-y`. Veja [Aceitar um comando de instalação exibido](#accept-a-displayed-install-command). Requer Claude Code v2.1.271 ou posterior |

93| `--json` | Imprima o resultado como um objeto JSON na última linha de stdout em vez da mensagem legível por humanos, para uso em scripts. Veja [Formato de resultado JSON](#plugin-json-result). Requer Claude Code v2.1.268 ou posterior |93| `--json` | Imprima o resultado como um objeto JSON na última linha de stdout em vez da mensagem legível por humanos, para uso em scripts. Veja [Formato de resultado JSON](#plugin-json-result). Requer Claude Code v2.1.268 ou posterior |

299| :- | :- |299| :- | :- |

300| `--json` | Imprima a lista como JSON |300| `--json` | Imprima a lista como JSON |

301| `--available` | Também liste plugins que seus marketplaces oferecem que você não instalou. Não tem efeito sem `--json` |301| `--available` | Também liste plugins que seus marketplaces oferecem que você não instalou. Não tem efeito sem `--json` |

302| `--data-size [plugin]` | Meça o [diretório de dados salvos](#what-an-uninstall-deletes-and-keeps) de cada plugin instalado, ou apenas o do plugin nomeado, dado como `name@marketplace`. Não tem efeito sem `--json`. Se o nome não tem registro de instalação, o comando imprime `--data-size names a plugin that is not installed` e sai com `1` em vez de imprimir a lista. Requer Claude Code v2.1.285 ou posterior |

302 303 

303Claude Code agrupa a saída legível por humanos por como cada plugin carrega:304Claude Code agrupa a saída legível por humanos por como cada plugin carrega:

304 305 

330| `notes` | array of strings | Avisos de autoria para um plugin que carregou e funciona |331| `notes` | array of strings | Avisos de autoria para um plugin que carregou e funciona |

331| `errorDetails` | array of objects | Um objeto por entrada `errors`, fornecendo seu `type` de diagnóstico e os nomes aos quais se refere, como o plugin, marketplace, servidor ou arquivo. Requer Claude Code v2.1.268 ou posterior |332| `errorDetails` | array of objects | Um objeto por entrada `errors`, fornecendo seu `type` de diagnóstico e os nomes aos quais se refere, como o plugin, marketplace, servidor ou arquivo. Requer Claude Code v2.1.268 ou posterior |

332| `noteDetails` | array of objects | Os mesmos objetos de detalhe para cada entrada `notes`. Requer Claude Code v2.1.268 ou posterior |333| `noteDetails` | array of objects | Os mesmos objetos de detalhe para cada entrada `notes`. Requer Claude Code v2.1.268 ou posterior |

334| `hasUserConfig` | boolean | Presente e `true` quando o plugin carregou e seu manifesto declara opções [`userConfig`](/docs/pt/plugins/manifest-reference#user-configuration). Ausente para um plugin que falhou ao carregar, qualquer que seja seu manifesto declare. Valores salvos nunca são incluídos. Requer Claude Code v2.1.285 ou posterior |

335| `projectEnabled` | boolean | Se o `.claude/settings.json` compartilhado do projeto ativa o plugin. Apenas installs de marketplace. Requer Claude Code v2.1.285 ou posterior |

336| `dataDirSize` | object | Com `--data-size`, o tamanho do [diretório de dados salvos](#what-an-uninstall-deletes-and-keeps) do plugin como `bytes` e `human`; ausente quando o diretório está faltando ou vazio. Apenas installs de marketplace. Requer Claude Code v2.1.285 ou posterior |

337| `dataDirUnreadable` | boolean | Com `--data-size`, `true` quando o diretório de dados salvos existe mas não conseguiu ser medido. Apenas installs de marketplace. Requer Claude Code v2.1.285 ou posterior |

333 338 

334Com `--json --available`, Claude Code imprime um objeto em vez de um array. Seu campo `installed` contém o array de objetos de plugin instalado, e seu campo `available` contém um objeto por plugin de marketplace não instalado com os campos abaixo.339Com `--json --available`, Claude Code imprime um objeto em vez de um array. Seu campo `installed` contém o array de objetos de plugin instalado, e seu campo `available` contém um objeto por plugin de marketplace não instalado com os campos abaixo.

335 340 

373 378 

374Para um plugin que não está carregado, Claude Code imprime ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` e sai com `1`.379Para um plugin que não está carregado, Claude Code imprime ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` e sai com `1`.

375 380 

381<h3 id="plugin-configure">

382 plugin configure

383</h3>

384 

385Mostre as opções [`userConfig`](/docs/pt/plugins/manifest-reference#user-configuration) de um plugin instalado e quais estão definidas, ou salve valores canalizados em stdin. Requer Claude Code v2.1.285 ou posterior.

386 

387```bash theme={null}

388claude plugin configure <plugin>

389```

390 

391| Flag | Descrição |

392| :- | :- |

393| `--values-stdin` | Leia valores de opção de stdin como um objeto JSON de strings de linha única e salve-os. Opções que você deixa de fora mantêm seus valores salvos |

394| `--json` | Imprima o resultado como um objeto JSON em stdout. Sem `--values-stdin`, o objeto carrega o `schema` e `choices` das opções, seus `inputs` iniciais, e os nomes de opções `configured` e `unconfigured`. Com `--values-stdin`, carrega os nomes de opções `saved` e, quando conseguem ser lidos novamente, os nomes `unconfigured` |

395 

396Sem flags, o comando lista cada opção com até três rótulos: `required` ou `optional`, depois `sensitive` para uma opção que o manifesto declara sensível, depois `set` ou `not set`. Não imprime valores salvos. Com `--json`, a saída inclui os valores salvos de opções que não são sensíveis, e nunca o texto de uma sensível.

397 

398Para salvar valores, escreva-os em um arquivo como um objeto JSON que mapeia chaves de opção para valores de string, depois passe o arquivo em stdin. Substitua `formatter@my-marketplace` pelo id do seu próprio plugin conforme `claude plugin list` o mostra. Este exemplo define uma opção nomeada `api_url` de um arquivo `values.json` que contém `{"api_url": "https://example.com"}`:

399 

400```bash theme={null}

401claude plugin configure formatter@my-marketplace --values-stdin < values.json

402```

403 

404Claude Code valida cada valor contra o tipo declarado da opção e imprime `Configuration saved. Restart Claude Code to apply it.` Se você passar uma chave que o manifesto não declara, ou um valor que falha na validação, o comando não salva nada, imprime `Failed to save configuration:` com o motivo, e sai com `1`. Com `--json`, um valor recusado também imprime um objeto em stdout cujo campo `refused` carrega a `message` e, quando uma opção é culpada, sua chave `option`.

405 

406Passe o id completo `name@marketplace` do plugin, conforme `claude plugin list` o mostra. `configure` não aceita um `name` simples. Quando nenhum plugin carregado tem esse id, o comando imprime `No installed plugin has the id "<plugin>".` e sai com `1`.

407 

408Para as configurações de um servidor MCP empacotado, veja [`plugin install --config`](#plugin-install) ou o item **Configure** em `/plugin`.

409 

376<h3 id="plugin-prune">410<h3 id="plugin-prune">

377 plugin prune411 plugin prune

378</h3>412</h3>

868 868 

869O servidor usa seu nome do `name` no manifesto do pacote.869O servidor usa seu nome do `name` no manifesto do pacote.

870 870 

871Um manifesto próprio do pacote pode declarar configurações que o servidor precisa do usuário em um bloco `user_config`. Um servidor agrupado com uma configuração obrigatória que não tem valor salvo não inicia. A aba **Errors** de `/plugin` mostra `Bundled MCP server "<name>" was not started: it needs configuration`.

872 

873Os usuários fornecem os valores de uma de duas maneiras:

874 

875* **Em `/plugin`**: selecione o plugin na aba **Installed** e escolha **Configure**

876* **Na instalação, a partir do shell**: passe [`--config <server>.<key>=<value>`](/docs/pt/plugins/cli-reference#plugin-install) para `claude plugin install`. Requer Claude Code v2.1.285 ou posterior, e funciona apenas para um pacote empacotado dentro do plugin.

877 

871Para transportes e autenticação, consulte [MCP](/docs/pt/mcp#plugin-provided-mcp-servers).878Para transportes e autenticação, consulte [MCP](/docs/pt/mcp#plugin-provided-mcp-servers).

872 879 

873<h3 id="lsp-servers">880<h3 id="lsp-servers">

1071 Quando o diálogo de configuração aparece1078 Quando o diálogo de configuração aparece

1072</h3>1079</h3>

1073 1080 

1074O diálogo aparece apenas na interface interativa `/plugin`. Ele abre para qualquer opção que ainda não está definida quando o usuário faz qualquer um dos seguintes:1081O diálogo faz parte da interface interativa `/plugin`. Quando o usuário faz qualquer um dos seguintes, ele abre para qualquer opção que ainda não está definida:

1075 1082 

1076* Instala o plugin em `/plugin`1083* Instala o plugin em `/plugin`

1077* Executa `/plugin install <plugin>@<marketplace>` dentro de uma sessão1084* Executa `/plugin install <plugin>@<marketplace>` dentro de uma sessão

1079 1086 

1080Para abrir o mesmo diálogo a qualquer momento, o usuário executa `/plugin configure <plugin>@<marketplace>`.1087Para abrir o mesmo diálogo a qualquer momento, o usuário executa `/plugin configure <plugin>@<marketplace>`.

1081 1088 

1082O comando shell `claude plugin install` nunca solicita valores `userConfig`. Para definir valores do shell, passe cada um como `--config KEY=VALUE`. Quando opções permanecem indefinidas, o comando imprime uma linha `userConfig options not yet set` que nomeia ambas as formas de defini-las. [O diálogo `userConfig` nunca aparece](/docs/pt/plugins/troubleshooting#the-userconfig-dialog-never-appears) cita a linha.1089O diálogo Manage plugins da extensão VS Code [Manage plugins dialog](/docs/pt/vs-code#install-plugins) solicita opções não definidas como um formulário após uma instalação, e um ícone de engrenagem na linha do plugin abre o formulário novamente com todas as opções.

1090 

1091O comando shell `claude plugin install` nunca solicita valores `userConfig`. Para definir valores do shell, passe cada um como `--config KEY=VALUE` quando você instalar, ou redirecione um objeto JSON para [`claude plugin configure --values-stdin`](/docs/pt/plugins/cli-reference#plugin-configure) depois.

1092 

1093Quando opções permanecem indefinidas, `claude plugin install` imprime uma linha `userConfig options not yet set`. Para o texto exato da linha, consulte [O diálogo `userConfig` nunca aparece](/docs/pt/plugins/troubleshooting#the-userconfig-dialog-never-appears).

1083 1094 

1084Para os campos de opção, onde cada valor é armazenado, como um componente referencia um valor salvo e quais campos rejeitam `${user_config.*}`, consulte [Configuração do usuário](/docs/pt/plugins/manifest-reference#user-configuration).1095Para os campos de opção, onde cada valor é armazenado, como um componente referencia um valor salvo e quais campos rejeitam `${user_config.*}`, consulte [Configuração do usuário](/docs/pt/plugins/manifest-reference#user-configuration).

1085 1096 

72 A última frase do resumo diz se o plugin é utilizável nesta sessão:72 A última frase do resumo diz se o plugin é utilizável nesta sessão:

73 73 

74 * **Active now**: `Plugin is now active.` Nenhuma recarga é necessária.74 * **Active now**: `Plugin is now active.` Nenhuma recarga é necessária.

75 * **Active, but a server needs setup**: `Plugin is now active.` é seguido por `Its bundled MCP server needs configuration before it can start`. O [servidor MCP empacotado](/docs/pt/plugins/components#include-a-packaged-mcpb-server) do plugin não pode iniciar até que você defina suas opções. Selecione o plugin na aba **Installed** em `/plugin` e escolha **Configure** para definir as opções do servidor.

75 * **Reload needed**: `Run /reload-plugins to activate.` O painel fecha e o Claude Code executa essa recarga para você. Se a recarga [invalidasse o cache de prompt](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin), ela avisa e deixa o plugin pendente. Execute `/reload-plugins --force` para ativá-lo mesmo assim, o que custa uma solicitação sem cache.76 * **Reload needed**: `Run /reload-plugins to activate.` O painel fecha e o Claude Code executa essa recarga para você. Se a recarga [invalidasse o cache de prompt](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin), ela avisa e deixa o plugin pendente. Execute `/reload-plugins --force` para ativá-lo mesmo assim, o que custa uma solicitação sem cache.

76 * **Load failed**: `The plugin couldn't be loaded`. Abra a aba **Errors** em `/plugin` para saber o motivo e depois veja [Após instalação: plugin não funcionando](/docs/pt/plugins/troubleshooting#plugin-installed-but-not-working).77 * **Load failed**: `The plugin couldn't be loaded`. Abra a aba **Errors** em `/plugin` para saber o motivo e depois veja [Após instalação: plugin não funcionando](/docs/pt/plugins/troubleshooting#plugin-installed-but-not-working).

77 </Step>78 </Step>

248Um marketplace privado é um em um repositório que você precisa de credenciais para clonar, no GitHub ou em qualquer outro host git. Você o adiciona com o mesmo comando `/plugin marketplace add` ou `claude plugin marketplace add` que um público. O Claude Code o clona com as credenciais git já em sua máquina e nunca solicita, então cada forma de conexão tem um requisito:249Um marketplace privado é um em um repositório que você precisa de credenciais para clonar, no GitHub ou em qualquer outro host git. Você o adiciona com o mesmo comando `/plugin marketplace add` ou `claude plugin marketplace add` que um público. O Claude Code o clona com as credenciais git já em sua máquina e nunca solicita, então cada forma de conexão tem um requisito:

249 250 

250* **HTTPS**: seus ajudantes de credencial git se aplicam, então o acesso que você configurou com `gh auth login`, o Keychain do macOS ou `git-credential-store` funciona. Prompts interativos são suprimidos, então um host que você nunca autenticou falha em vez de pedir uma senha.251* **HTTPS**: seus ajudantes de credencial git se aplicam, então o acesso que você configurou com `gh auth login`, o Keychain do macOS ou `git-credential-store` funciona. Prompts interativos são suprimidos, então um host que você nunca autenticou falha em vez de pedir uma senha.

251* **SSH**: o host já deve estar em seu arquivo `known_hosts` e a chave deve funcionar sem um prompt de frase-passe, porque os prompts de impressão digital do host e frase-passe também são suprimidos.252* **SSH**: o host já deve estar em seu arquivo `known_hosts` e a chave deve funcionar sem um prompt de frase-passe. Se sua configuração git nomeia um programa SSH em `GIT_SSH_COMMAND`, `GIT_SSH` ou `core.sshCommand` da sua configuração git, o Claude Code executa esse programa.

252* **Atalho GitHub `owner/repo`**: o Claude Code verifica se sua chave SSH autentica em `github.com`, depois clona sobre SSH se fizer e sobre HTTPS se não fizer. Defina [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/pt/env-vars#variables) para pular essa verificação e sempre clonar sobre HTTPS.253* **Atalho GitHub `owner/repo`**: o Claude Code verifica se sua chave SSH autentica em `github.com`, depois clona sobre SSH se fizer e sobre HTTPS se não fizer. Defina [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/pt/env-vars#variables) para pular essa verificação e sempre clonar sobre HTTPS.

253 254 

254As mesmas credenciais se aplicam quando você executa `/plugin install`, `/plugin marketplace update` e `claude plugin update`.255As mesmas credenciais se aplicam quando você executa `/plugin install`, `/plugin marketplace update` e `claude plugin update`.

288 289 

289* Digite para filtrar por nome ou descrição.290* Digite para filtrar por nome ou descrição.

290* Pressione **Space** para habilitar ou desabilitar o plugin selecionado, e **f** para favoritá-lo.291* Pressione **Space** para habilitar ou desabilitar o plugin selecionado, e **f** para favoritá-lo.

291* Pressione **Enter** para abrir os detalhes de um plugin. O menu lá oferece **Disable plugin** ou **Enable plugin**, **Update now** e **Uninstall**. Plugins que aceitam configurações também oferecem **Configure options**.292* Pressione **Enter** para abrir os detalhes de um plugin.

293 

294Um menu de detalhes de plugin oferece **Disable plugin** ou **Enable plugin**, **Update now** e **Uninstall**. Dois itens adicionais aparecem para plugins que aceitam configurações, e um plugin pode mostrar ambos:

295 

296* **Configure options**: mostrado quando o manifesto do plugin declara opções [`userConfig`](/docs/pt/plugins/manifest-reference#user-configuration). Abre o diálogo para essas opções

297* **Configure**: mostrado quando o plugin inclui um [servidor MCP empacotado](/docs/pt/plugins/components#include-a-packaged-mcpb-server). Define as configurações `user_config` próprias desse servidor

292 298 

293A aba também pode mostrar plugins em escopo **Managed**. Sua organização os instalou através de [configurações gerenciadas](/docs/pt/settings#settings-files), e você não pode habilitá-los, desabilitá-los ou desinstalá-los aqui.299A aba também pode mostrar plugins em escopo **Managed**. Sua organização os instalou através de [configurações gerenciadas](/docs/pt/settings#settings-files), e você não pode habilitá-los, desabilitá-los ou desinstalá-los aqui.

294 300 

201 201 

202Uma adição bem-sucedida imprime `Successfully added marketplace: <name>`.202Uma adição bem-sucedida imprime `Successfully added marketplace: <name>`.

203 203 

204<h3 id="invalid-git-url">

205 `Invalid git URL`

206</h3>

207 

208Você adicionou um marketplace, instalou um plugin ou executou uma atualização a partir de um endereço git, e o comando falhou com `Invalid git URL` em sua mensagem.

209 

210Claude Code verifica cada endereço git antes de executar git. Ele recusa um endereço cujo protocolo não suporta. Ele também recusa um endereço que git poderia ler como nomeando um servidor ou pasta diferente do que o endereço mostra.

211 

212O texto após o endereço nomeia o que mudar. Reescreva o endereço como a mensagem diz e execute o comando novamente.

213 

214Uma recusa que em vez disso diz `is blocked by enterprise policy` vem das configurações da sua organização. Veja [Marketplace source is blocked by enterprise policy](#marketplace-source-is-blocked-by-enterprise-policy).

215 

204<h3 id="path-does-not-exist">216<h3 id="path-does-not-exist">

205 `Path does not exist: <path>`217 `Path does not exist: <path>`

206</h3>218</h3>

410 422 

411`claude plugin install` no seu shell imprime uma mensagem diferente. Para um plugin já instalado no escopo de destino, imprime `Plugin "<name>@<marketplace>" is already installed (scope: user)` e sai com 0. Se seu diretório de cache está faltando, o mesmo comando o re-baixa.423`claude plugin install` no seu shell imprime uma mensagem diferente. Para um plugin já instalado no escopo de destino, imprime `Plugin "<name>@<marketplace>" is already installed (scope: user)` e sai com 0. Se seu diretório de cache está faltando, o mesmo comando o re-baixa.

412 424 

425<h3 id="plugin-would-share-its-folder">

426 `"<plugin>" was not installed: it would share its folder with "<other>"`

427</h3>

428 

429Você instalou um plugin através de `claude plugin install`, `/plugin`, ou uma sugestão de instalação em uma sessão, e Claude Code o recusou com esta linha, ou com `would share its saved data with`.

430 

431O id do plugin recusado e o id de um plugin instalado mapeiam para a mesma pasta no disco: eles são os mesmos uma vez que `.` e `@` são escritos como `-`. No macOS e Windows, ids que diferem apenas em maiúsculas mapeiam para a mesma pasta também. Instalar ambos colocaria os arquivos de um plugin na pasta do outro, então Claude Code recusa e o plugin instalado mantém seus arquivos.

432 

433A mensagem nomeia a saída:

434 

435* **O outro plugin está instalado**: a mensagem diz `Only one of the two can be installed.` e nomeia o comando `claude plugin uninstall`, ou o passo de desinstalação em `/plugin`, que remove o outro plugin. Execute-o, depois instale novamente. Para o que a desinstalação remove, veja [What an uninstall deletes and keeps](/docs/pt/plugins/cli-reference#what-an-uninstall-deletes-and-keeps).

436* **Ambos os ids chegam em uma instalação**, como um plugin e uma dependência que ele precisa: nenhuma ordem de instalação ajuda. Apenas um mantenedor do marketplace que lista os dois plugins pode corrigi-lo, renomeando um deles. Quando os dois vêm de marketplaces diferentes, um mantenedor de qualquer um deles pode.

437 

413<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">

414 `This plugin uses a source type your Claude Code version does not support`439 `This plugin uses a source type your Claude Code version does not support`

415</h3>440</h3>

790* **`URL is unset or invalid`**: uma opção `${user_config.*}` que a URL usa não está definida. Execute `/plugin configure <plugin>` para defini-la815* **`URL is unset or invalid`**: uma opção `${user_config.*}` que a URL usa não está definida. Execute `/plugin configure <plugin>` para defini-la

791* **`has an invalid MCP url`** ou **`headersHelper for MCP server '<server>' references ${user_config.*}`**: a configuração do próprio plugin está em falta. Corrija a `url` ou `headersHelper` em sua configuração MCP do plugin, ou relate ao autor do plugin se o plugin não é seu. O caso `headersHelper` tem sua própria entrada em [plugin command references user\_config](/docs/pt/errors#plugin-command-references-user-config)816* **`has an invalid MCP url`** ou **`headersHelper for MCP server '<server>' references ${user_config.*}`**: a configuração do próprio plugin está em falta. Corrija a `url` ou `headersHelper` em sua configuração MCP do plugin, ou relate ao autor do plugin se o plugin não é seu. O caso `headersHelper` tem sua própria entrada em [plugin command references user\_config](/docs/pt/errors#plugin-command-references-user-config)

792 817 

818<h4 id="bundled-mcp-server-name-was-not-started-it-needs-configuration">

819 `Bundled MCP server "<name>" was not started: it needs configuration`

820</h4>

821 

822O plugin inclui o servidor como um [bundle MCPB](/docs/pt/plugins/components#include-a-packaged-mcpb-server) que declara `user_config`, e uma configuração obrigatória não tem valor salvo ainda ou um valor salvo falha na validação do próprio bundle, então Claude Code pula o início do servidor. O resto do plugin funciona.

823 

824Selecione o plugin na aba **Installed** do `/plugin` e escolha **Configure** para fornecer os valores. Depois que você salvar, `/plugin` mostra `Configuration saved.` e fecha, e Claude Code recarrega plugins conforme descrito em [Gerenciar plugins instalados](/docs/pt/plugins/install#manage-installed-plugins). O servidor inicia uma vez que esse reload se aplica. Antes da v2.1.285, Claude Code pulava o servidor sem mostrar esta linha.

825 

793<h4 id="server-is-configured-but-never-connects">826<h4 id="server-is-configured-but-never-connects">

794 Server is configured but never connects827 Server is configured but never connects

795</h4>828</h4>

934 967 

935Seu plugin declara opções `userConfig`, mas nenhum diálogo de configuração aparece quando você o instala.968Seu plugin declara opções `userConfig`, mas nenhum diálogo de configuração aparece quando você o instala.

936 969 

937A instalação interativa mostra o diálogo, e o comando de shell leva os valores como sinalizadores em vez disso:970Se a instalação solicita os valores depende de onde você a executa:

938 971 

939* **`/plugin install` em uma sessão, ou a aba Discover em `/plugin`**: o diálogo é parte desta instalação interativa972* **`/plugin install` em uma sessão, ou a aba Discover em `/plugin`**: o diálogo é parte desta instalação interativa

973* **O diálogo Manage plugins da extensão VS Code**: solicita opções não definidas como um formulário após a instalação. Antes da v2.1.285, instalar lá não mostrava formulário de opções, então defina os valores a partir de uma sessão de terminal com `/plugin configure <plugin>@<marketplace>`

940* **`claude plugin install` no seu shell**: nunca pede valores `userConfig`. Salva qualquer valor `--config KEY=VALUE` que você passa, e quando opções permanecem não definidas imprime `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Quando qualquer uma das opções não definidas é obrigatória, `(M required)` segue `not yet set`.974* **`claude plugin install` no seu shell**: nunca pede valores `userConfig`. Salva qualquer valor `--config KEY=VALUE` que você passa, e quando opções permanecem não definidas imprime `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Quando qualquer uma das opções não definidas é obrigatória, `(M required)` segue `not yet set`.

941 975 

942Se você instalou a partir do shell, passe os valores com `--config`, um sinalizador por opção:976Se você instalou a partir do shell, passe os valores com `--config`, um sinalizador por opção:

945claude plugin install my-plugin@my-marketplace --config api_url=https://example.com979claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

946```980```

947 981 

948Quando cada opção está definida, a saída de instalação não carrega nenhuma linha `not yet set`. Para abrir o diálogo depois em vez disso, execute `/plugin configure my-plugin@my-marketplace` em uma sessão.982Quando cada opção está definida, a saída de instalação não carrega nenhuma linha `not yet set`.

983 

984Para abrir o diálogo depois em vez disso, execute `/plugin configure my-plugin@my-marketplace` em uma sessão. A partir do shell, [`claude plugin configure`](/docs/pt/plugins/cli-reference#plugin-configure) mostra quais opções ainda estão não definidas e salva valores canalizados em stdin. Requer Claude Code v2.1.285 ou posterior.

949 985 

950Se você passar uma chave `--config` que o manifesto não declara, o plugin ainda instala, e o comando imprime `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` seguido pelas chaves que o plugin declara.986Se você passar uma chave `--config` que o manifesto não declara, o plugin ainda instala, e o comando imprime `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` seguido pelas chaves que o plugin declara.

951 987 

988Para um plugin que envia um [arquivo de pacote MCPB](/docs/pt/plugins/components#include-a-packaged-mcpb-server) declarando `user_config` próprio, a mensagem lê `isn't declared in this plugin's userConfig or by its bundled MCP servers.` em vez disso, e as chaves conhecidas incluem as chaves desse servidor, escritas `<server>.<key>`. Um pacote que o manifesto referencia por URL não é lido no tempo de instalação, então suas chaves não estão listadas e a mensagem diz para configurá-lo em `/plugin`. Definir chaves `<server>.<key>` requer Claude Code v2.1.285 ou posterior.

989 

952<h3 id="claude-plugin-validate-reports-errors">990<h3 id="claude-plugin-validate-reports-errors">

953 `claude plugin validate` reports errors991 `claude plugin validate` reports errors

954</h3>992</h3>

163 Exceções por chave entre fontes gerenciadas163 Exceções por chave entre fontes gerenciadas

164</h3>164</h3>

165 165 

166Três tipos de chaves são exceções à regra de não mesclagem:166Essas chaves são exceções à regra de não mesclagem:

167 167 

168* **Chaves de bloqueio entre fontes**: um pequeno conjunto de chaves, como os bloqueios da lista de permissão de sandbox, [listadas na página de configurações gerenciadas](/docs/pt/managed-settings#precedence-within-the-managed-tier). O Claude Code as honra quando qualquer fonte gerenciada controlada por administrador as define; o nível de registro HKCU gravável pelo usuário é excluído.168* **Chaves de bloqueio entre fontes**: um pequeno conjunto de chaves, como os bloqueios da lista de permissão de sandbox, [listadas na página de configurações gerenciadas](/docs/pt/managed-settings#precedence-within-the-managed-tier). O Claude Code as honra quando qualquer fonte gerenciada controlada por administrador as define; o nível de registro HKCU gravável pelo usuário é excluído.

169 169 

171* **O bloco `env`**: além da unidade de telemetria e variáveis de roteamento emparelhadas com uma chave de credencial, ambas cobertas abaixo, ele se mescla por chave entre as fontes controladas por administrador. Para cada variável de ambiente, a fonte de prioridade mais alta que a define vence, e as fontes de administrador inferiores preenchem variáveis que as fontes superiores deixam não definidas. Uma entrada `env` gerenciada pelo endpoint, portanto, se aplica sempre que a configuração gerenciada pelo servidor deixa essa variável não definida, ou enquanto um valor de servidor em cache para ela é [retido pendente de confirmação do servidor](#fetch-and-caching-behavior). Requer Claude Code v2.1.223 ou posterior. Antes da v2.1.223, o Claude Code aplica apenas o bloco `env` da fonte selecionada.171* **O bloco `env`**: além da unidade de telemetria e variáveis de roteamento emparelhadas com uma chave de credencial, ambas cobertas abaixo, ele se mescla por chave entre as fontes controladas por administrador. Para cada variável de ambiente, a fonte de prioridade mais alta que a define vence, e as fontes de administrador inferiores preenchem variáveis que as fontes superiores deixam não definidas. Uma entrada `env` gerenciada pelo endpoint, portanto, se aplica sempre que a configuração gerenciada pelo servidor deixa essa variável não definida, ou enquanto um valor de servidor em cache para ela é [retido pendente de confirmação do servidor](#fetch-and-caching-behavior). Requer Claude Code v2.1.223 ou posterior. Antes da v2.1.223, o Claude Code aplica apenas o bloco `env` da fonte selecionada.

172 * **Unidade de telemetria**: as chaves do exportador `OTEL_EXPORTER_OTLP_*`, os toggles de captura de conteúdo `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` e as variáveis de rastreamento beta `ENABLE_BETA_TRACING_DETAILED` e `BETA_TRACING_ENDPOINT` seguem a fonte mais alta que define qualquer uma delas como uma unidade. Uma fonte que entrega a chave de credencial `otelHeadersHelper` também reclama a unidade, mas coloca essas variáveis apenas quando é a fonte selecionada: uma fonte que não é selecionada mas entrega a chave não contribui com nenhuma delas e ainda bloqueia fontes inferiores de preenchê-las. De qualquer forma, um endpoint do exportador de uma fonte nunca pode ser emparelhado com credenciais de outra.172 * **Unidade de telemetria**: as chaves do exportador `OTEL_EXPORTER_OTLP_*`, os toggles de captura de conteúdo `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` e as variáveis de rastreamento beta `ENABLE_BETA_TRACING_DETAILED` e `BETA_TRACING_ENDPOINT` seguem a fonte mais alta que define qualquer uma delas como uma unidade. Uma fonte que entrega a chave de credencial `otelHeadersHelper` também reclama a unidade, mas coloca essas variáveis apenas quando é a fonte selecionada: uma fonte que não é selecionada mas entrega a chave não contribui com nenhuma delas e ainda bloqueia fontes inferiores de preenchê-las. De qualquer forma, um endpoint do exportador de uma fonte nunca pode ser emparelhado com credenciais de outra.

173 * **Roteamento emparelhado com credencial**: uma fonte que emparelha variáveis de roteamento com uma chave de credencial somente de fonte selecionada, como `apiKeyHelper` ou `otelHeadersHelper`, contribui com essas variáveis de roteamento apenas quando vence o slot.173 * **Roteamento emparelhado com credencial**: uma fonte que emparelha variáveis de roteamento com uma chave de credencial somente de fonte selecionada, como `apiKeyHelper` ou `otelHeadersHelper`, contribui com essas variáveis de roteamento apenas quando vence o slot.

174* **`allowedProviders`**: uma lista definida na máquina e uma lista gerenciada pelo servidor se combinam conforme [a nota de Escopo dessa entrada](/docs/pt/settings-reference#allowedproviders) afirma. Requer Claude Code v2.1.285 ou posterior

174* **Chaves de login do gateway**: o Claude Code nunca lê [`forceLoginGatewayUrl`](/docs/pt/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/pt/settings-reference#gatewayinternalnetworks) ou o valor `"gateway"` de [`forceLoginMethod`](/docs/pt/settings-reference#forceloginmethod) das configurações gerenciadas pelo servidor, portanto um valor lá não se aplica nem oculta um definido em uma política MDM ou arquivo de configurações gerenciadas. A entrada [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) diz qual fonte de administrador na máquina as fornece.175* **Chaves de login do gateway**: o Claude Code nunca lê [`forceLoginGatewayUrl`](/docs/pt/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/pt/settings-reference#gatewayinternalnetworks) ou o valor `"gateway"` de [`forceLoginMethod`](/docs/pt/settings-reference#forceloginmethod) das configurações gerenciadas pelo servidor, portanto um valor lá não se aplica nem oculta um definido em uma política MDM ou arquivo de configurações gerenciadas. A entrada [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) diz qual fonte de administrador na máquina as fornece.

175 176 

176<h3 id="fetch-and-caching-behavior">177<h3 id="fetch-and-caching-behavior">

29 29 

30`claude --continue` abre uma [sessão em background](/docs/pt/agent-view) que foi concluída, mas não uma que ainda está em execução; abrir sessões em background concluídas requer Claude Code v2.1.257 ou posterior. Se sua conversa mais recente for uma que você [moveu para o background](/docs/pt/agent-view#send-the-session-to-the-background) e ainda estiver em execução lá, Claude Code sai com `Your most recent conversation is running in the background` e o ID dessa sessão. Anexe à sessão a partir de [`claude agents`](/docs/pt/agent-view#attach-to-a-session), ou execute `claude --resume` para escolher outra.30`claude --continue` abre uma [sessão em background](/docs/pt/agent-view) que foi concluída, mas não uma que ainda está em execução; abrir sessões em background concluídas requer Claude Code v2.1.257 ou posterior. Se sua conversa mais recente for uma que você [moveu para o background](/docs/pt/agent-view#send-the-session-to-the-background) e ainda estiver em execução lá, Claude Code sai com `Your most recent conversation is running in the background` e o ID dessa sessão. Anexe à sessão a partir de [`claude agents`](/docs/pt/agent-view#attach-to-a-session), ou execute `claude --resume` para escolher outra.

31 31 

32<span id="resume-a-running-background-session" />

33 

34Quando a conversa que você retoma com `claude --resume` ou `/resume` pertence a uma [sessão em background](/docs/pt/agent-view) que ainda está em execução, Claude Code abre a sessão em execução em si. Com `--bg` na linha de comando, a retomada é um [dispatch em background](/docs/pt/agent-view#from-your-shell) em vez disso. Antes da v2.1.285, Claude Code recusava e dizia para você abrir a sessão com `claude attach <id>`, ou para parar com `claude stop <id>` primeiro.

35 

36* **Do seu shell**: `claude --resume <session>` executa [`claude attach`](/docs/pt/agent-view#attach-to-a-session) nessa sessão no mesmo terminal em vez de carregar a transcrição em si. Um prompt que você passa na linha de comando, como em `claude --resume <session> "check the tests too"`, vai para a sessão como seu próximo turno primeiro, e Claude Code imprime `Sent your prompt to the background session (<id>); opening it…` antes de anexar. `claude -p --resume <session> "prompt"` digitado em um terminal faz o mesmo, portanto `-p` não mantém essa execução não interativa.

37 

38 Claude Code não abre a sessão quando a linha de comando tem qualquer um destes:

39 

40 * Entrada ou saída canalizada ou redirecionada

41 * Flags que configuram a sessão, como `--permission-mode`, `--model` ou `--settings`

42 * Flags que leem a saída, como `--output-format json` ou `--json-schema`

43 * Flags que limitam ou rebobinham a execução, como `--max-turns` ou `--max-budget-usd`

44 

45 Com qualquer um destes, ou quando [agent view está desativado](/docs/pt/agent-view#turn-off-agent-view), Claude Code não envia nada e sai com status 1, imprimindo que a sessão está em execução no background junto com o comando `claude attach <id>` que a abre, ou dizendo para você encontrá-la em `claude agents` quando não conseguir determinar o ID. Adicione `--fork-session` para retomar uma cópia da conversa em vez disso. Para continuar a conversa em si em uma sessão sua, com suas flags aplicadas, execute `claude stop <id>` e depois repita o comando.

46 

47 Um prompt que começa com `/` ou `!` não é enviado, e nem é qualquer prompt enquanto a sessão aguarda sua resposta a uma pergunta. Em ambos os casos Claude Code não abre a sessão, e a mensagem inclui `Your prompt was not sent to it` com o motivo.

48* **De dentro de uma sessão**: `/resume` move sua conversa atual para o background e anexa este terminal à sessão em execução, imprimindo `Opening "<title>", running in the background (<id>)`. Pressione `←` em um prompt vazio para retornar à agent view, que também lista a conversa que você deixou. Quando a conversa atual não consegue se mover para o background, por exemplo porque você já está anexado a uma sessão em background ou a persistência de sessão está desativada, `/resume` imprime o comando `claude attach` para executar em vez disso.

49 

32Você pode executar `claude --resume <session-id>` de qualquer diretório: Claude Code procura o ID no diretório do projeto atual e seus git worktrees primeiro, depois em todos os outros projetos nesta máquina, para que encontre uma sessão que começou em outro lugar ou se moveu com [`/cd`](/docs/pt/commands). A busca entre projetos resolve o ID apenas quando exatamente um outro projeto contém uma transcrição com mensagens para ele, portanto uma duplicata copiada manualmente faz Claude Code relatar não encontrado em vez de retomar uma cópia arbitrária. Se nenhuma sessão armazenada corresponder ao ID, Claude Code relata `No conversation found with session ID: <session-id>`. Antes da v2.1.223, a busca parava no diretório do projeto atual e seus git worktrees, portanto você tinha que retomar do diretório em que a sessão trabalhou por último.50Você pode executar `claude --resume <session-id>` de qualquer diretório: Claude Code procura o ID no diretório do projeto atual e seus git worktrees primeiro, depois em todos os outros projetos nesta máquina, para que encontre uma sessão que começou em outro lugar ou se moveu com [`/cd`](/docs/pt/commands). A busca entre projetos resolve o ID apenas quando exatamente um outro projeto contém uma transcrição com mensagens para ele, portanto uma duplicata copiada manualmente faz Claude Code relatar não encontrado em vez de retomar uma cópia arbitrária. Se nenhuma sessão armazenada corresponder ao ID, Claude Code relata `No conversation found with session ID: <session-id>`. Antes da v2.1.223, a busca parava no diretório do projeto atual e seus git worktrees, portanto você tinha que retomar do diretório em que a sessão trabalhou por último.

33 51 

34<h3 id="what-a-resumed-session-restores">52<h3 id="what-a-resumed-session-restores">

35 O que uma sessão retomada restaura53 O que uma sessão retomada restaura

36</h3>54</h3>

37 55 

38Uma sessão retomada restaura a conversa junto com o estado salvo nela:56Quando Claude Code carrega uma conversa de sua transcrição, a sessão retomada restaura a conversa junto com o estado salvo nela:

39 57 

40* Histórico de conversa: o histórico completo, incluindo chamadas de ferramentas e resultados. Uma ferramenta que ainda estava em execução quando o processo anterior terminou, por exemplo em uma falha, não termina ou executa novamente quando você retoma. Claude vê a chamada marcada como interrompida antes de seu resultado ser registrado e é instruído a verificar se ela teve efeito antes de executá-la novamente, a menos que [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/pt/env-vars#variables) esteja definido. Antes da v2.1.281, Claude Code descartava a chamada interrompida da conversa ou a mostrava a Claude como uma que você interrompeu.58* Histórico de conversa: o histórico completo, incluindo chamadas de ferramentas e resultados. Uma ferramenta que ainda estava em execução quando o processo anterior terminou, por exemplo em uma falha, não termina ou executa novamente quando você retoma. Claude vê a chamada marcada como interrompida antes de seu resultado ser registrado e é instruído a verificar se ela teve efeito antes de executá-la novamente, a menos que [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/pt/env-vars#variables) esteja definido. Antes da v2.1.281, Claude Code descartava a chamada interrompida da conversa ou a mostrava a Claude como uma que você interrompeu.

41* Modelo: a sessão continua no modelo que estava usando. O modelo não é restaurado quando foi descontinuado ou não é permitido por `availableModels`, quando uma flag `--model` ou uma variável de ambiente da família `ANTHROPIC_MODEL` escolhe um no lançamento, ou em provedores que usam IDs de implantação específicos do provedor, como [Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry](/docs/pt/third-party-integrations); veja [configuração de modelo](/docs/pt/model-config#setting-your-model) para a ordem de resolução.59* Modelo: a sessão continua no modelo que estava usando. O modelo não é restaurado quando foi descontinuado ou não é permitido por `availableModels`, quando uma flag `--model` ou uma variável de ambiente da família `ANTHROPIC_MODEL` escolhe um no lançamento, ou em provedores que usam IDs de implantação específicos do provedor, como [Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry](/docs/pt/third-party-integrations); veja [configuração de modelo](/docs/pt/model-config#setting-your-model) para a ordem de resolução.

51 Modo de permissão ao retomar69 Modo de permissão ao retomar

52</h4>70</h4>

53 71 

54Qual modo de permissão Claude Code inicia uma sessão retomada depende de como você retoma:72Qual modo de permissão Claude Code inicia uma sessão retomada depende de como você retoma. Os casos abaixo se aplicam quando Claude Code carrega a conversa de sua transcrição; quando você [abre uma sessão em background que ainda está em execução](#resume-a-running-background-session) em vez disso, essa sessão mantém o modo de permissão em que está.

55 73 

56* Terminal: `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` quando o nome corresponde a uma sessão, sem `-p`. Claude Code restaura o modo de permissão em que a sessão estava, exceto nos casos da tabela. Passe `--permission-mode` ou `--dangerously-skip-permissions` para substituir o modo restaurado.74* Terminal: `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` quando o nome corresponde a uma sessão, sem `-p`. Claude Code restaura o modo de permissão em que a sessão estava, exceto nos casos da tabela. Passe `--permission-mode` ou `--dangerously-skip-permissions` para substituir o modo restaurado.

57* Não interativo: `claude -p --resume` ou `claude -p --continue`. Claude Code inicia a execução no modo de permissão em que uma nova execução `claude -p` iniciaria, exceto que uma sessão que terminou em modo de plano retoma em modo de plano sob as [condições abaixo](#resume-in-plan-mode-with-p).75* Não interativo: `claude -p --resume` ou `claude -p --continue`. Claude Code inicia a execução no modo de permissão em que uma nova execução `claude -p` iniciaria, exceto que uma sessão que terminou em modo de plano retoma em modo de plano sob as [condições abaixo](#resume-in-plan-mode-with-p).

599| [`allowedChannelPlugins`](#allowedchannelplugins) | Substitua a lista de permissões padrão de [plugins de canal](/docs/pt/channels#restrict-which-channel-plugins-can-run) que podem enviar mensagens | Plugins e skills | Managed |599| [`allowedChannelPlugins`](#allowedchannelplugins) | Substitua a lista de permissões padrão de [plugins de canal](/docs/pt/channels#restrict-which-channel-plugins-can-run) que podem enviar mensagens | Plugins e skills | Managed |

600| [`allowedHttpHookUrls`](#allowedhttphookurls) | Limite quais URLs os [hooks HTTP](/docs/pt/hooks) podem atingir | Hooks e automação | Any file |600| [`allowedHttpHookUrls`](#allowedhttphookurls) | Limite quais URLs os [hooks HTTP](/docs/pt/hooks) podem atingir | Hooks e automação | Any file |

601| [`allowedMcpServers`](#allowedmcpservers) | Lista de permissões de quais [servidores MCP](/docs/pt/mcp) os usuários podem adicionar | MCP | Any file |601| [`allowedMcpServers`](#allowedmcpservers) | Lista de permissões de quais [servidores MCP](/docs/pt/mcp) os usuários podem adicionar | MCP | Any file |

602| [`allowedProviders`](#allowedproviders) | Limite quais [provedores de API](/docs/pt/third-party-integrations) uma máquina pode usar | Autenticação e provedores | Managed |

602| [`allowManagedHooksOnly`](#allowmanagedhooksonly) | Execute apenas os [hooks](/docs/pt/hooks) que sua organização implanta | Hooks e automação | Managed |603| [`allowManagedHooksOnly`](#allowmanagedhooksonly) | Execute apenas os [hooks](/docs/pt/hooks) que sua organização implanta | Hooks e automação | Managed |

603| [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) | Faça a lista de permissões de [MCP](/docs/pt/mcp) gerenciada ser a única que se aplica | MCP | Managed |604| [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) | Faça a lista de permissões de [MCP](/docs/pt/mcp) gerenciada ser a única que se aplica | MCP | Managed |

604| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Faça as [configurações gerenciadas](/docs/pt/managed-settings) serem a única fonte de [regras de permissão](/docs/pt/permissions#managed-settings) | Configurações de permissão | Managed |605| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Faça as [configurações gerenciadas](/docs/pt/managed-settings) serem a única fonte de [regras de permissão](/docs/pt/permissions#managed-settings) | Configurações de permissão | Managed |

5879 5880 

5880Forneça credenciais através de scripts auxiliares e, para organizações, force um método de login ou organização. Veja [Autenticação](/docs/pt/authentication).5881Forneça credenciais através de scripts auxiliares e, para organizações, force um método de login ou organização. Veja [Autenticação](/docs/pt/authentication).

5881 5882 

5883<h3 id="allowedproviders">

5884 `allowedProviders`

5885</h3>

5886 

5887Liste os serviços através dos quais uma máquina pode acessar Claude, como a API Anthropic, Amazon Bedrock ou um gateway LLM. Uma sessão em um provedor que não está listado é recusada na inicialização, no login e quando ele próximo contata a API, portanto mudar para um provedor não listado no meio da sessão também é recusado. A [mensagem de recusa](/docs/pt/errors#managed-settings-dont-allow-this-api-provider) nomeia o que selecionou o provedor e os passos para continuar. Requer Claude Code v2.1.285 ou posterior.

5888 

5889* **Escopo**: [`Gerenciado`](#scopes). Uma lista que as fontes de admin próprias da máquina definem, políticas MDM e arquivos de configurações gerenciadas, continua se aplicando quando configurações gerenciadas por servidor também entregam uma: uma sessão pode então usar apenas os provedores em ambas as listas, portanto uma lista gerenciada por servidor pode estreitar o que a máquina permite mas nunca ampliá-lo. Qual `allowedProviders` da fonte da máquina conta segue [como Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources). Uma lista entregue apenas através de configurações gerenciadas por servidor alcança apenas as sessões que [buscam configurações gerenciadas por servidor](/docs/pt/server-managed-settings#platform-availability).

5890* **Tipo**: array de strings, cada uma de:

5891 * `"anthropic"`: a API Anthropic no host próprio da Anthropic, através de um login claude.ai ou Console ou uma chave API. Emparelhe-a com [`forceLoginMethod`](#forceloginmethod) ou [`forceLoginOrgUUID`](#forceloginorguuid) para também restringir o login

5892 * `"bedrock"`: [Amazon Bedrock](/docs/pt/amazon-bedrock)

5893 * `"vertex"`: [Plataforma de Agente do Google Cloud](/docs/pt/google-vertex-ai), anteriormente Vertex AI

5894 * `"foundry"`: [Microsoft Foundry](/docs/pt/microsoft-foundry)

5895 * `"anthropicAws"`: [Claude Platform on AWS](/docs/pt/claude-platform-on-aws)

5896 * `"mantle"`: o endpoint [Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) do Amazon Bedrock. Uma sessão que [executa Mantle junto com a API Invoke](/docs/pt/amazon-bedrock#run-mantle-alongside-the-invoke-api) usa ambos os provedores, portanto liste `"bedrock"` e `"mantle"` juntos para ela

5897 * `"customEndpoint"`: a API Anthropic ou a API de um provedor de nuvem enviada para outro host, como um [gateway LLM](/docs/pt/llm-gateway) nomeado por `ANTHROPIC_BASE_URL`, uma variável `ANTHROPIC_*_BASE_URL` do provedor, ou um valor `ANTHROPIC_FOUNDRY_RESOURCE` que não é um nome de recurso simples. Claude Code o admite apenas para o valor exato que um bloco [`env`](#env) gerenciado fixa

5898 * `"gateway"`: um login de [gateway na nuvem](/docs/pt/claude-apps-gateway)

5899* **Padrão**: não definido, portanto qualquer provedor pode ser usado

5900 

5901```json managed-settings.json theme={null}

5902{

5903 "allowedProviders": ["anthropic", "bedrock"]

5904}

5905```

5906 

5907A entrada de cada provedor de nuvem significa o próprio serviço desse provedor, incluindo seus endpoints regionais, FIPS e privados.

5908 

5909Uma entrada que Claude Code não reconhece como um nome de provedor é descartada e relatada, e o resto da lista permanece aplicado. Com uma lista vazia, ou uma cujas entradas são todas não reconhecidas, Claude Code recusa cada provedor e não inicia na máquina.

5910 

5911<h4 id="endpoints-that-need-a-pin-in-managed-env">

5912 Endpoints que precisam de um pin no `env` gerenciado

5913</h4>

5914 

5915Um pin é um valor de variável de endpoint definido em um bloco [`env`](#env) gerenciado. Quando uma sessão envia o tráfego de um provedor para algum lugar diferente do serviço próprio desse provedor, Claude Code o admite apenas se o valor da sessão for o mesmo que o pin. Estes endpoints precisam de um:

5916 

5917* **Sessões `"customEndpoint"`**: a variável que nomeia o host, como `ANTHROPIC_BASE_URL`

5918* **Amazon Bedrock**: as variáveis `AWS_ENDPOINT_URL`, `AWS_ENDPOINT_URL_BEDROCK` e `AWS_ENDPOINT_URL_BEDROCK_RUNTIME` do SDK AWS quando apontam para fora do próprio serviço Bedrock. A sessão permanece sob `"bedrock"` em vez de `"customEndpoint"`

5919* **URL de login de um gateway**: a sessão permanece sob `"gateway"`, e [`forceLoginGatewayUrl`](#forcelogingatewayurl) também conta como o pin

5920 

5921Quais blocos `env` contam como pins depende de onde a lista é definida:

5922 

5923* **Uma fonte de administrador na máquina define uma lista**: apenas os blocos `env` das fontes de administrador próprias da máquina contam

5924* **Apenas configurações gerenciadas por servidor definem uma lista**: um valor `env` nessas configurações gerenciadas por servidor também conta

5925 

5926A lista não julga as variáveis de credencial e tenancy de um provedor de nuvem ou o caminho de rede, como `HTTPS_PROXY` e configurações de certificado. Defina-as para a frota no bloco `env` gerenciado.

5927 

5882<h3 id="apikeyhelper">5928<h3 id="apikeyhelper">

5883 `apiKeyHelper`5929 `apiKeyHelper`

5884</h3>5930</h3>

6401| :- | :- | :- |6447| :- | :- | :- |

6402| Listas | Combina entradas de todas as fontes | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) e outras chaves de lista |6448| Listas | Combina entradas de todas as fontes | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) e outras chaves de lista |

6403| Bloqueios | Aplica o valor mais rigoroso que qualquer fonte define. Quando nenhuma fonte define um valor rigoroso, aplica um valor mais flexível apenas da fonte mais alta | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly), [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) e outros bloqueios booleanos ou enum |6449| Bloqueios | Aplica o valor mais rigoroso que qualquer fonte define. Quando nenhuma fonte define um valor rigoroso, aplica um valor mais flexível apenas da fonte mais alta | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly), [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) e outros bloqueios booleanos ou enum |

6404| Listas de restrição | Pega a lista inteira da fonte mais alta que a define, sem adicionar entradas de fontes inferiores. Quando a fonte mais alta não define uma, pega inteira da próxima fonte abaixo | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) e a cadeia [`fallbackModel`](#fallbackmodel) |6450| Listas de restrição | Pega a lista inteira da fonte mais alta que a define, sem adicionar entradas de fontes inferiores. Quando a fonte mais alta não define uma, pega inteira da próxima fonte abaixo | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`allowedProviders`](#allowedproviders), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) e a cadeia [`fallbackModel`](#fallbackmodel) |

6405| Valores tomados inteiros | Pega o valor inteiro da fonte mais alta que o define, sem combinar entradas ou campos de fontes inferiores. Quando a fonte mais alta não o define, pega inteiro da próxima fonte abaixo | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |6451| Valores tomados inteiros | Pega o valor inteiro da fonte mais alta que o define, sem combinar entradas ou campos de fontes inferiores. Quando a fonte mais alta não o define, pega inteiro da próxima fonte abaixo | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |

6406| Servidores MCP fornecidos | Combina os nomes de servidor de todas as fontes. Quando duas fontes definem o mesmo nome, aplica a entrada inteira da fonte mais alta | [`managedMcpServers`](#managedmcpservers) |6452| Servidores MCP fornecidos | Combina os nomes de servidor de todas as fontes. Quando duas fontes definem o mesmo nome, aplica a entrada inteira da fonte mais alta | [`managedMcpServers`](#managedmcpservers) |

6407| Lê apenas da fonte de prioridade mais alta | Lê a chave apenas da fonte de prioridade mais alta que carrega uma chave de política, então o valor de uma fonte inferior é ignorado mesmo quando a fonte mais alta não define nenhum | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), os valores `"claudeai"` e `"console"` de [`forceLoginMethod`](#forceloginmethod), [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |6453| Lê apenas da fonte de prioridade mais alta | Lê a chave apenas da fonte de prioridade mais alta que carrega uma chave de política, então o valor de uma fonte inferior é ignorado mesmo quando a fonte mais alta não define nenhum | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), os valores `"claudeai"` e `"console"` de [`forceLoginMethod`](#forceloginmethod), [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |

6415* **[`policyHelper`](#policyhelper)**: Claude Code a honra apenas quando a fonte mais alta que carrega uma chave de política é uma política MDM ou um arquivo de configurações gerenciadas, então sob configurações gerenciadas pelo servidor ela não se aplica.6461* **[`policyHelper`](#policyhelper)**: Claude Code a honra apenas quando a fonte mais alta que carrega uma chave de política é uma política MDM ou um arquivo de configurações gerenciadas, então sob configurações gerenciadas pelo servidor ela não se aplica.

6416* **[`modelOverrides`](#modeloverrides)**: emparelha com `availableModels`. Claude Code pega `modelOverrides` da fonte mais alta que a define, a menos que uma fonte mais alta defina `availableModels` sem `modelOverrides`. Nesse caso, ele ignora `modelOverrides` de todas as fontes.6462* **[`modelOverrides`](#modeloverrides)**: emparelha com `availableModels`. Claude Code pega `modelOverrides` da fonte mais alta que a define, a menos que uma fonte mais alta defina `availableModels` sem `modelOverrides`. Nesse caso, ele ignora `modelOverrides` de todas as fontes.

6417* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) e o valor `"gateway"` de [`forceLoginMethod`](#forceloginmethod)**: Claude Code nunca lê nenhum deles de configurações gerenciadas pelo servidor, então um valor lá não se aplica nem oculta um definido em uma política MDM ou arquivo de configurações gerenciadas. Entre as fontes de administrador na máquina, apenas a fonte classificada mais alta que carrega uma chave de política as fornece, independentemente de configurações gerenciadas pelo servidor também estarem presentes.6463* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) e o valor `"gateway"` de [`forceLoginMethod`](#forceloginmethod)**: Claude Code nunca lê nenhum deles de configurações gerenciadas pelo servidor, então um valor lá não se aplica nem oculta um definido em uma política MDM ou arquivo de configurações gerenciadas. Entre as fontes de administrador na máquina, apenas a fonte classificada mais alta que carrega uma chave de política as fornece, independentemente de configurações gerenciadas pelo servidor também estarem presentes.

6464* **[`allowedProviders`](#allowedproviders)**: após a regra da tabela, a lista da própria máquina ainda limita o resultado, conforme a nota de Escopo da entrada afirma.

6418 6465 

6419Para confirmar quais fontes se combinaram em uma máquina, execute `/status` e [leia a linha `Setting sources`](/docs/pt/managed-settings#read-the-source-in-/status).6466Para confirmar quais fontes se combinaram em uma máquina, execute `/status` e [leia a linha `Setting sources`](/docs/pt/managed-settings#read-the-source-in-/status).

6420 6467 

740 740 

741* **Diretório de trabalho**: Claude Code executa cada comando no diretório de trabalho atual do shell da sessão. Esse diretório se move quando Claude executa `cd`. Use [`${CLAUDE_SKILL_DIR}` ou `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) em caminhos que devem ser resolvidos da mesma forma sempre.741* **Diretório de trabalho**: Claude Code executa cada comando no diretório de trabalho atual do shell da sessão. Esse diretório se move quando Claude executa `cd`. Use [`${CLAUDE_SKILL_DIR}` ou `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) em caminhos que devem ser resolvidos da mesma forma sempre.

742* **stderr**: com o shell `bash` padrão, Claude Code mescla stderr em stdout. Qualquer coisa que o comando escreva em stderr aparece no texto injetado.742* **stderr**: com o shell `bash` padrão, Claude Code mescla stderr em stdout. Qualquer coisa que o comando escreva em stderr aparece no texto injetado.

743* **Timeout**: cada comando é executado sob o [timeout](/docs/pt/tools-reference#timeout-and-output-limits) padrão de 2 minutos da ferramenta Bash. Quando a ferramenta Bash [move um comando com timeout para o background](/docs/pt/tools-reference#background-commands), a skill ainda é renderizada. O texto injetado relata a mudança e nomeia a tarefa em background e o arquivo coletando a saída do comando. Quando o comando é um que a ferramenta Bash nunca coloca automaticamente em background, Claude Code o mata no timeout. Essa falha [aborta a invocação](#when-an-injected-command-fails).743* **Timeout**: cada comando é executado sob o [timeout](/docs/pt/tools-reference#timeout-and-output-limits) padrão de 2 minutos da ferramenta Bash. Quando a ferramenta Bash [move um comando com timeout para o background](/docs/pt/tools-reference#foreground-commands-that-move-to-the-background), a skill ainda é renderizada. O texto injetado relata a mudança e nomeia a tarefa em background e o arquivo coletando a saída do comando. Quando o comando é um que a ferramenta Bash nunca coloca automaticamente em background, Claude Code o mata no timeout. Essa falha [aborta a invocação](#when-an-injected-command-fails).

744* **Tamanho da saída**: saída além do limite inline da ferramenta Bash chega como um caminho de arquivo mais uma visualização curta, não texto truncado. [Output limits](/docs/pt/tools-reference#output-limits) cobre o limite e como ajustar cada limite.744* **Tamanho da saída**: saída além do limite inline da ferramenta Bash chega como um caminho de arquivo mais uma visualização curta, não texto truncado. [Output limits](/docs/pt/tools-reference#output-limits) cobre o limite e como ajustar cada limite.

745 745 

746A ferramenta PowerShell aplica o mesmo comportamento de timeout, backgrounding e output-ceiling aos comandos que executa. Veja a seção [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) para seus detalhes.746A ferramenta PowerShell aplica o mesmo comportamento de timeout, backgrounding e output-ceiling aos comandos que executa. Veja a seção [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) para seus detalhes.

20Aqui está um exemplo de uma [linha de status de múltiplas linhas](#display-multiple-lines) que exibe informações do git na primeira linha e uma barra de contexto codificada por cores na segunda.20Aqui está um exemplo de uma [linha de status de múltiplas linhas](#display-multiple-lines) que exibe informações do git na primeira linha e uma barra de contexto codificada por cores na segunda.

21 21 

22<Frame>22<Frame>

23 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Uma linha de status de múltiplas linhas mostrando nome do modelo, diretório, ramificação git na primeira linha, e uma barra de progresso de uso de contexto com custo e duração na segunda linha" width="776" height="212" data-path="images/statusline-multiline.png" />23 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Uma linha de status de múltiplas linhas mostrando nome do modelo, diretório, ramificação git na primeira linha, e uma barra de progresso de uso de contexto com custo e duração na segunda linha" width="1224" height="262" data-path="images/statusline-multiline.png" />

24</Frame>24</Frame>

25 25 

26Esta página orienta você sobre [configurar uma linha de status básica](#set-up-a-status-line), explica [como os dados fluem](#how-status-lines-work) do Claude Code para seu script, lista [todos os campos que você pode exibir](#available-data) e fornece [exemplos prontos para usar](#examples) para padrões comuns como status do git, rastreamento de custos e barras de progresso.26Esta página orienta você sobre [configurar uma linha de status básica](#set-up-a-status-line), explica [como os dados fluem](#how-status-lines-work) do Claude Code para seu script, lista [todos os campos que você pode exibir](#available-data) e fornece [exemplos prontos para usar](#examples) para padrões comuns como status do git, rastreamento de custos e barras de progresso.

93Estes exemplos usam scripts Bash, que funcionam no macOS e Linux. No Windows, consulte [Configuração do Windows](#windows-configuration) para exemplos de PowerShell e Git Bash.93Estes exemplos usam scripts Bash, que funcionam no macOS e Linux. No Windows, consulte [Configuração do Windows](#windows-configuration) para exemplos de PowerShell e Git Bash.

94 94 

95<Frame>95<Frame>

96 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-quickstart.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=696445e59ca0059213250651ad23db6b" alt="Uma linha de status mostrando nome do modelo, diretório e porcentagem de contexto" width="726" height="164" data-path="images/statusline-quickstart.png" />96 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-quickstart.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=88a7eab9c1038dd098ee8e284d96b7e6" alt="Uma linha de status mostrando nome do modelo, diretório e porcentagem de contexto" width="1224" height="224" data-path="images/statusline-quickstart.png" />

97</Frame>97</Frame>

98 98 

99<Steps>99<Steps>

444Exiba o modelo atual e o uso da janela de contexto com uma barra de progresso visual. Cada script lê JSON de stdin, extrai o campo `used_percentage` e constrói uma barra de 10 caracteres onde blocos preenchidos (▓) representam o uso:444Exiba o modelo atual e o uso da janela de contexto com uma barra de progresso visual. Cada script lê JSON de stdin, extrai o campo `used_percentage` e constrói uma barra de 10 caracteres onde blocos preenchidos (▓) representam o uso:

445 445 

446<Frame>446<Frame>

447 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-context-window-usage.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=15b58ab3602f036939145dde3165c6f7" alt="Uma linha de status mostrando nome do modelo e uma barra de progresso com porcentagem" width="448" height="152" data-path="images/statusline-context-window-usage.png" />447 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-context-window-usage.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f3918a549912dc47e90f2b69e68bc847" alt="Uma linha de status mostrando nome do modelo e uma barra de progresso com porcentagem" width="1224" height="224" data-path="images/statusline-context-window-usage.png" />

448</Frame>448</Frame>

449 449 

450<CodeGroup>450<CodeGroup>

513Mostre a ramificação git com indicadores codificados por cores para arquivos preparados e modificados. Este script usa [códigos de escape ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) para cores de terminal: `\033[32m` é verde, `\033[33m` é amarelo e `\033[0m` redefine para padrão.513Mostre a ramificação git com indicadores codificados por cores para arquivos preparados e modificados. Este script usa [códigos de escape ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) para cores de terminal: `\033[32m` é verde, `\033[33m` é amarelo e `\033[0m` redefine para padrão.

514 514 

515<Frame>515<Frame>

516 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-git-context.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e656f34f90d1d9a1d0e220988914345f" alt="Uma linha de status mostrando modelo, diretório, ramificação git e indicadores coloridos para arquivos preparados e modificados" width="742" height="178" data-path="images/statusline-git-context.png" />516 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-git-context.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f13c190724d9ec7188c17cd2f98b7bf4" alt="Uma linha de status mostrando modelo, diretório, ramificação git e indicadores coloridos para arquivos preparados e modificados" width="1224" height="224" data-path="images/statusline-git-context.png" />

517</Frame>517</Frame>

518 518 

519Cada script verifica se o diretório atual é um repositório git, conta arquivos preparados e modificados e exibe indicadores codificados por cores:519Cada script verifica se o diretório atual é um repositório git, conta arquivos preparados e modificados e exibe indicadores codificados por cores:

611Cada script formata o custo como moeda e converte milissegundos em minutos e segundos:611Cada script formata o custo como moeda e converte milissegundos em minutos e segundos:

612 612 

613<Frame>613<Frame>

614 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-cost-tracking.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e3444a51fe6f3440c134bd5f1f08ad29" alt="Uma linha de status mostrando nome do modelo, custo da sessão e duração" width="588" height="180" data-path="images/statusline-cost-tracking.png" />614 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-cost-tracking.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=925f7024c3b38be0f0eca63564bfb52f" alt="Uma linha de status mostrando nome do modelo, custo da sessão e duração" width="1224" height="224" data-path="images/statusline-cost-tracking.png" />

615</Frame>615</Frame>

616 616 

617<CodeGroup>617<CodeGroup>

672Seu script pode exibir múltiplas linhas para criar uma exibição mais rica.672Seu script pode exibir múltiplas linhas para criar uma exibição mais rica.

673 673 

674<Frame>674<Frame>

675 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Uma linha de status de múltiplas linhas mostrando nome do modelo, diretório, ramificação git na primeira linha, e uma barra de progresso de uso de contexto com custo e duração na segunda linha" width="776" height="212" data-path="images/statusline-multiline.png" />675 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Uma linha de status de múltiplas linhas mostrando nome do modelo, diretório, ramificação git na primeira linha, e uma barra de progresso de uso de contexto com custo e duração na segunda linha" width="1224" height="262" data-path="images/statusline-multiline.png" />

676</Frame>676</Frame>

677 677 

678Este exemplo combina várias técnicas: cores baseadas em limite (verde abaixo de 70%, amarelo 70-89%, vermelho 90%+), uma barra de progresso e informações de ramificação git. Cada instrução `print` ou `echo` cria uma linha separada:678Este exemplo combina várias técnicas: cores baseadas em limite (verde abaixo de 70%, amarelo 70-89%, vermelho 90%+), uma barra de progresso e informações de ramificação git. Cada instrução `print` ou `echo` cria uma linha separada:

781Este exemplo cria um link clicável para seu repositório GitHub. Mantenha Cmd (macOS) ou Ctrl (Windows/Linux) pressionado e clique para abrir o link em seu navegador.781Este exemplo cria um link clicável para seu repositório GitHub. Mantenha Cmd (macOS) ou Ctrl (Windows/Linux) pressionado e clique para abrir o link em seu navegador.

782 782 

783<Frame>783<Frame>

784 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-links.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=4bcc6e7deb7cf52f41ab85a219b52661" alt="Uma linha de status mostrando um link clicável para um repositório GitHub" width="726" height="198" data-path="images/statusline-links.png" />784 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-links.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=4778a144a28cb498c99d5fa018bb374a" alt="Uma linha de status mostrando um link clicável para um repositório GitHub" width="1224" height="224" data-path="images/statusline-links.png" />

785</Frame>785</Frame>

786 786 

787Cada script obtém a URL remota do git, converte o formato SSH para HTTPS e envolve o nome do repositório em códigos de escape OSC 8. A versão Bash usa `printf '%b'` que interpreta escapes de barra invertida de forma mais confiável que `echo -e` em diferentes shells:787Cada script obtém a URL remota do git, converte o formato SSH para HTTPS e envolve o nome do repositório em códigos de escape OSC 8. A versão Bash usa `printf '%b'` que interpreta escapes de barra invertida de forma mais confiável que `echo -e` em diferentes shells:

253 253 

254As equipes de segurança podem configurar permissões gerenciadas para o que Claude Code é e não é permitido fazer, o que não pode ser substituído pela configuração local. [Saiba mais](/docs/pt/security).254As equipes de segurança podem configurar permissões gerenciadas para o que Claude Code é e não é permitido fazer, o que não pode ser substituído pela configuração local. [Saiba mais](/docs/pt/security).

255 255 

256Para limitar quais dessas opções de implantação uma máquina gerenciada pode usar, defina [`allowedProviders`](/docs/pt/settings-reference#allowedproviders) nas configurações gerenciadas. Por exemplo, `["bedrock"]` permite Amazon Bedrock e nada mais; uma frota Bedrock que também ativa o endpoint Mantle lista `"mantle"` também. A entrada diz quais variáveis de endpoint também precisam de um pin `env` gerenciado. Requer Claude Code v2.1.285 ou posterior.

257 

256<h3 id="leverage-mcp-for-integrations">258<h3 id="leverage-mcp-for-integrations">

257 Usar MCP para integrações259 Usar MCP para integrações

258</h3>260</h3>

159 * Se `cd` sair desses diretórios, Claude Code redefine para o diretório do projeto e anexa `Shell cwd was reset to <dir>` ao resultado da ferramenta.159 * Se `cd` sair desses diretórios, Claude Code redefine para o diretório do projeto e anexa `Shell cwd was reset to <dir>` ao resultado da ferramenta.

160 * Para desabilitar esse carregamento de forma que cada comando Bash comece no diretório do projeto, defina `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.160 * Para desabilitar esse carregamento de forma que cada comando Bash comece no diretório do projeto, defina `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.

161* Variáveis de ambiente não persistem. Um `export` em um comando não estará disponível no próximo.161* Variáveis de ambiente não persistem. Um `export` em um comando não estará disponível no próximo.

162* Aliases e funções de shell definidas no arquivo de inicialização do seu shell estão disponíveis. No início da sessão, Claude Code carrega `~/.zshrc`, `~/.bashrc`, ou `~/.profile` dependendo do seu shell, captura os aliases, funções e opções de shell resultantes e os aplica a cada comando Bash.162* Aliases e funções de shell definidas no seu arquivo de inicialização de shell estão disponíveis. No início da sessão, Claude Code carrega `~/.zshrc`, `~/.bashrc`, ou `~/.profile` dependendo do seu shell, captura os aliases, funções e opções de shell resultantes e os aplica a cada comando Bash.

163 163 

164Ative seu virtualenv ou ambiente conda antes de iniciar Claude Code. Para fazer variáveis de ambiente persistirem entre comandos Bash, defina [`CLAUDE_ENV_FILE`](/docs/pt/env-vars) para um script de shell antes de iniciar Claude Code, ou use um [hook SessionStart](/docs/pt/hooks#persist-environment-variables) para preenchê-lo dinamicamente.164Ative seu virtualenv ou ambiente conda antes de iniciar Claude Code. Para fazer variáveis de ambiente persistirem entre comandos Bash, defina [`CLAUDE_ENV_FILE`](/docs/pt/env-vars) para um script de shell antes de iniciar Claude Code, ou use um [hook SessionStart](/docs/pt/hooks#persist-environment-variables) para preenchê-lo dinamicamente.

165 165 

167 Limites de timeout e saída167 Limites de timeout e saída

168</h3>168</h3>

169 169 

170Cada comando é executado sob um timeout, e Claude o gerencia: quando quer mais tempo do que o padrão para um comando, ele passa o parâmetro `timeout` com essa chamada. Você nunca define um timeout por comando.170Cada comando é executado sob um timeout, e Claude o gerencia: quando precisa de mais tempo do que o padrão para um comando, ele passa o parâmetro `timeout` com essa chamada. Você nunca define um timeout por comando.

171 171 

172Duas [variáveis de ambiente](/docs/pt/env-vars) controlam o que Claude obtém para um comando que é executado em primeiro plano:172Duas [variáveis de ambiente](/docs/pt/env-vars) controlam o que Claude obtém para um comando que é executado em primeiro plano:

173 173 

174* `BASH_DEFAULT_TIMEOUT_MS` — o padrão quando Claude não passa timeout; dois minutos por padrão174* `BASH_DEFAULT_TIMEOUT_MS` — o padrão quando Claude não passa timeout; dois minutos por padrão

175* `BASH_MAX_TIMEOUT_MS` — com o padrão, define o limite máximo que limita o que Claude solicita: o limite efetivo é o maior dos dois, dez minutos por padrão175* `BASH_MAX_TIMEOUT_MS` — com o padrão, define o limite máximo que limita o que Claude solicita: o limite efetivo é o maior dos dois, dez minutos por padrão

176 176 

177Para um comando que Claude inicia em segundo plano, `timeout` define por quanto tempo o comando pode ser executado lá, com o padrão e máximo separados descritos em [Comandos em segundo plano](#background-commands). A [ferramenta PowerShell](#powershell-tool) segue as mesmas regras de timeout e lê as mesmas duas variáveis.177Para um comando que Claude inicia em segundo plano, `timeout` define por quanto tempo o comando pode ser executado lá, com o padrão e máximo separados descritos em [Limite de tempo para comandos em segundo plano](#time-limit-for-background-commands). A [ferramenta PowerShell](#powershell-tool) segue as mesmas regras de timeout e lê as mesmas duas variáveis.

178 178 

179<h4 id="output-limits">179<h4 id="output-limits">

180 Limites de saída180 Limites de saída

185| Resultado | O que Claude obtém |185| Resultado | O que Claude obtém |

186| :- | :- |186| :- | :- |

187| Válido | Inline até aproximadamente 30.000 caracteres por padrão; além disso, o caminho de um arquivo salvo no diretório da sessão e truncado após 64 MiB, mais uma visualização de até os primeiros 2.000 caracteres, e Claude lê ou pesquisa o arquivo quando precisa do resto |187| Válido | Inline até aproximadamente 30.000 caracteres por padrão; além disso, o caminho de um arquivo salvo no diretório da sessão e truncado após 64 MiB, mais uma visualização de até os primeiros 2.000 caracteres, e Claude lê ou pesquisa o arquivo quando precisa do resto |

188| Falha | Inline até aproximadamente 10.000 caracteres; além disso, um trecho de cabeça e cauda desse tamanho cortado da janela de releitura, sem caminho de arquivo |188| Falha | Inline até aproximadamente 10.000 caracteres; além disso, um trecho de cabeçalho e cauda desse tamanho cortado da janela de releitura, sem caminho de arquivo |

189 189 

190Um comando que sai com código 1 conta como um resultado válido para a ferramenta Bash apenas quando Claude Code reconhece o código de saída 1 como um resultado benigno para esse comando: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test`, e `[`, mais `git diff` e `git grep`. Todo outro comando que sai com código 1 conta como uma falha, mesmo quando o código de saída 1 é um resultado informacional benigno: sem correspondências para `pgrep` e `jq -e`, arquivos que diferem para `cmp`.190Um comando que sai com código 1 conta como um resultado válido para a ferramenta Bash apenas quando Claude Code reconhece o código de saída 1 como um resultado benigno para esse comando: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test`, e `[`, mais `git diff` e `git grep`. Todo outro comando que sai com código 1 conta como uma falha, mesmo quando o código de saída 1 é um resultado informacional benigno: sem correspondências para `pgrep` e `jq -e`, arquivos que diferem para `cmp`.

191 191 

192[`BASH_MAX_OUTPUT_LENGTH`](/docs/pt/env-vars) define quantos caracteres de saída Claude Code relê do arquivo de trabalho para o resultado de um comando: 30.000 por padrão, até um limite máximo de 150.000. Aumente quando seus comandos rotineiramente ultrapassam essa janela, como um build verboso ou um log de suite de testes completo. Aumentá-lo amplia a janela de releitura, que também é a janela de onde um trecho de comando com falha é cortado. Não aumenta os limites inline: um resultado válido acima do limite inline chega como um caminho de arquivo mais visualização independentemente dessa variável.192[`BASH_MAX_OUTPUT_LENGTH`](/docs/pt/env-vars) define quantos caracteres de saída Claude Code relê do arquivo de trabalho para o resultado de um comando: 30.000 por padrão, até um limite máximo de 150.000. Aumente quando seus comandos rotineiramente ultrapassarem essa janela, como um build verboso ou um log de suite de testes completo. Aumentá-lo amplia a janela de releitura, que também é a janela de onde um trecho de comando com falha é cortado. Não aumenta os limites inline: um resultado válido acima do limite inline chega como um caminho de arquivo mais visualização independentemente dessa variável.

193 193 

194Para alterar quanto de um resultado válido Claude recebe inline, defina a configuração [`bashOutputMaxChars`](/docs/pt/settings-reference#bashoutputmaxchars) em vez disso, até 128.000 caracteres. Ela dimensiona o limite inline e a janela de releitura juntos, e Claude Code então ignora `BASH_MAX_OUTPUT_LENGTH`. Requer Claude Code v2.1.261 ou posterior.194Para alterar quanto de um resultado válido Claude recebe inline, defina a configuração [`bashOutputMaxChars`](/docs/pt/settings-reference#bashoutputmaxchars) em vez disso, até 128.000 caracteres. Ele dimensiona o limite inline e a janela de releitura juntos, e Claude Code então ignora `BASH_MAX_OUTPUT_LENGTH`. Requer Claude Code v2.1.261 ou posterior.

195 195 

196<h3 id="background-commands">196<h3 id="background-commands">

197 Comandos em segundo plano197 Comandos em segundo plano

198</h3>198</h3>

199 199 

200Para processos de longa duração, como servidores de desenvolvimento ou builds de observação, Claude pode definir `run_in_background: true` para iniciar o comando como uma tarefa em segundo plano e continuar trabalhando enquanto é executado. Liste e interrompa tarefas em segundo plano com `/tasks`. Depois que você interromper uma lá, ou de um cliente conectado como o aplicativo de desktop, Claude continua em vez de esperar. Se um subagentos iniciou o comando, é esse subagentos que continua.200Para processos de longa duração, como servidores de desenvolvimento ou builds de observação, Claude pode definir `run_in_background: true` para iniciar o comando como uma tarefa em segundo plano e continuar trabalhando enquanto é executado. Liste e interrompa tarefas em segundo plano com `/tasks`. Depois de interromper uma lá, ou de um cliente conectado como o aplicativo de desktop, Claude continua em vez de esperar. Se um subagentos iniciou o comando, é esse subagentos que continua.

201 201 

202Um comando que um [subagentos em primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) iniciou para quando a execução desse subagentos termina, independentemente de ter terminado, falhado ou sido interrompido. Um comando que a conversa principal ou um subagentos em segundo plano iniciou continua sendo executado após uma resposta final, até sair, ser interrompido ou atingir seu limite de tempo. No modo não interativo com a flag `-p`, [comandos em segundo plano terminam logo após o resultado final da execução](/docs/pt/headless#background-tasks-at-exit).202<h4 id="when-a-background-command-stops">

203 Quando um comando em segundo plano para

204</h4>

205 

206Um comando que um [subagentos em primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) iniciou para quando a execução desse subagentos termina, quer tenha terminado, falhado ou sido interrompido. Um comando que a conversa principal ou um subagentos em segundo plano iniciou continua sendo executado após uma resposta final, até sair, ser interrompido ou atingir seu [limite de tempo](#time-limit-for-background-commands). No modo não interativo com a flag `-p`, [comandos em segundo plano terminam logo após o resultado final da execução](/docs/pt/headless#background-tasks-at-exit).

207 

208<h4 id="time-limit-for-background-commands">

209 Limite de tempo para comandos em segundo plano

210</h4>

203 211 

204Comandos Bash e PowerShell em segundo plano têm um limite de tempo, contado a partir do momento em que o comando entra em segundo plano:212Comandos Bash e PowerShell em segundo plano têm um limite de tempo, contado a partir do momento em que o comando entra em segundo plano:

205 213 

206* Um comando que Claude inicia em segundo plano obtém 30 minutos, ou o `timeout` que Claude passa com `run_in_background`, até um máximo de 2 horas214* Um comando que Claude inicia em segundo plano obtém 30 minutos, ou o `timeout` que Claude passa com `run_in_background`, até um máximo de 2 horas

207* Um comando que começa em primeiro plano e depois se move para segundo plano, por exemplo com `Ctrl+B` ou em seu timeout, obtém 30 minutos a partir da mudança215* Um comando que começa em primeiro plano e depois se move para segundo plano, por exemplo com `Ctrl+B` ou em seu timeout, obtém 30 minutos a partir da mudança

208 216 

217Quando um comando em segundo plano atinge seu limite de tempo, Claude Code o interrompe e diz a Claude por quê, e Claude pode iniciar o comando novamente com um `timeout` mais longo se o trabalho ainda precisar. O aviso de parada lê `Background command "<description>" was stopped after reaching its background time limit`.

218 

219<h4 id="raise-the-time-limit-for-background-commands">

220 Aumente o limite de tempo para comandos em segundo plano

221</h4>

222 

209Duas [variáveis de ambiente](/docs/pt/env-vars) aumentam esses limites, para comandos Bash e PowerShell igualmente. Ambas usam milissegundos, e nenhuma pode encurtar um limite: um valor mais baixo deixa o padrão de 30 minutos e o máximo de 2 horas em vigor.223Duas [variáveis de ambiente](/docs/pt/env-vars) aumentam esses limites, para comandos Bash e PowerShell igualmente. Ambas usam milissegundos, e nenhuma pode encurtar um limite: um valor mais baixo deixa o padrão de 30 minutos e o máximo de 2 horas em vigor.

210 224 

211* Defina `BASH_DEFAULT_TIMEOUT_MS` acima de `1800000` para substituir o padrão de 30 minutos por esse valor, tanto para comandos que Claude inicia sem um `timeout` quanto para comandos movidos225* Defina `BASH_DEFAULT_TIMEOUT_MS` acima de `1800000` para substituir o padrão de 30 minutos por esse valor, tanto para comandos que Claude inicia sem um `timeout` quanto para comandos movidos

212* Defina `BASH_MAX_TIMEOUT_MS` acima de `7200000` para aumentar o máximo de 2 horas para esse valor. Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `7200000` aumenta o máximo da mesma forma226* Defina `BASH_MAX_TIMEOUT_MS` acima de `7200000` para aumentar o máximo de 2 horas para esse valor. Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `7200000` aumenta o máximo da mesma forma

213 227 

214Quando um comando em segundo plano atinge seu limite de tempo, Claude Code o interrompe e diz a Claude por quê, e Claude pode iniciar o comando novamente com um `timeout` mais longo se o trabalho ainda precisar. O aviso de parada lê `Background command "<description>" was stopped after reaching its background time limit`.228<h4 id="foreground-commands-that-move-to-the-background">

229 Comandos em primeiro plano que se movem para segundo plano

230</h4>

215 231 

216Quando um comando em primeiro plano atinge seu timeout sem terminar, Claude Code o move para segundo plano em vez de interrompê-lo, a menos que o comando comece com `sleep`. O limite de tempo de um comando movido é contado a partir da mudança, e um comando movido de um subagentos em primeiro plano ainda para quando a execução desse subagentos termina.232Quando um comando em primeiro plano atinge seu timeout sem terminar, Claude Code o move para segundo plano em vez de interrompê-lo, a menos que o comando comece com `sleep`. O [limite de tempo](#time-limit-for-background-commands) de um comando movido é contado a partir da mudança, e um comando movido de um subagentos em primeiro plano ainda para quando a execução desse subagentos termina.

217 233 

218Definir [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/pt/env-vars#variables) desabilita o auto-backgrounding junto com o resto da funcionalidade de tarefas em segundo plano.234Definir [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/pt/env-vars#variables) desabilita o auto-backgrounding junto com o resto da funcionalidade de tarefas em segundo plano.

219 235 

220O resultado de um comando movido para segundo plano indica o que aconteceu:236O resultado de um comando movido para segundo plano declara o que aconteceu:

221 237 

222* Quando o timeout dispara a mudança, o resultado relata explicitamente: `Command did not complete within its 120s timeout and was moved to the background`, com os segundos correspondendo ao timeout que se aplicava, seguido pela ID da tarefa e o caminho do arquivo para o qual a saída está sendo escrita.238* Quando o timeout dispara a mudança, o resultado relata explicitamente: `Command did not complete within its 120s timeout and was moved to the background`, com os segundos correspondendo ao timeout que se aplicava, seguido pela ID da tarefa e o caminho do arquivo para o qual a saída está sendo escrita.

223* Um `cd`, `pushd`, `popd`, ou `chdir` dentro de um comando que é movido para segundo plano nunca é mantido: o resultado afirma `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, então Claude não age em uma mudança de diretório que não aconteceu.239* Um `cd`, `pushd`, `popd`, ou `chdir` dentro de um comando que é movido para segundo plano nunca é mantido: o resultado declara `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, então Claude não age em uma mudança de diretório que não aconteceu.

224 240 

225<h3 id="memory-limit-on-linux-and-wsl">241<h3 id="memory-limit-on-linux-and-wsl">

226 Limite de memória em Linux e WSL242 Limite de memória no Linux e WSL

227</h3>243</h3>

228 244 

229Em Linux e WSL, defina [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/pt/env-vars#variables) para um tamanho como `4G` para limitar a memória que comandos Bash, PowerShell e [Monitor](#monitor-tool) podem usar, para que um build descontrolado não consuma a memória que o resto da sessão precisa. Requer Claude Code v2.1.233 ou posterior. Antes de v2.1.246, comandos da ferramenta Monitor eram executados fora do limite.245No Linux e WSL, defina [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/pt/env-vars#variables) para um tamanho como `4G` para limitar a memória que comandos Bash, PowerShell e [Monitor](#monitor-tool) podem usar, para que um build descontrolado não consuma a memória que o resto da sessão precisa. Requer Claude Code v2.1.233 ou posterior. Antes de v2.1.246, comandos da ferramenta Monitor eram executados fora do limite.

230 246 

231* Escreva o tamanho como um número de bytes ou com um sufixo `K`, `M`, `G`, ou `T`. Defina `0`, `off`, `false`, `no`, ou `none` para desativar o limite. Claude Code ignora qualquer outro valor que não consiga ler como um tamanho, como `4e9`.247* Escreva o tamanho como um número de bytes ou com um sufixo `K`, `M`, `G`, ou `T`. Defina `0`, `off`, `false`, `no`, ou `none` para desativar o limite. Claude Code ignora qualquer outro valor que não consiga ler como um tamanho, como `4e9`.

232* Claude Code conta todos os comandos Bash, PowerShell e Monitor de uma sessão contra o único limite, não cada comando por si só.248* Claude Code conta todos os comandos Bash, PowerShell e Monitor de uma sessão contra o único limite, não cada comando por si só.

247 263 

248* **Nomes desconhecidos**: Claude Code ignora nomes que não reconhece264* **Nomes desconhecidos**: Claude Code ignora nomes que não reconhece

249* **Bash, PowerShell e Monitor**: Claude Code mantém comandos Bash, PowerShell e Monitor tool sob o limite seja qual for sua lista265* **Bash, PowerShell e Monitor**: Claude Code mantém comandos Bash, PowerShell e Monitor tool sob o limite seja qual for sua lista

250* **Variável não definida**: Claude Code pega o conjunto de outros tipos limitados da configuração que Anthropic entrega do servidor, e esse conjunto pode mudar ao longo do tempo, então defina a variável quando você precisa de um conjunto que não muda266* **Variável não definida**: Claude Code pega o conjunto de outros tipos limitados da configuração que Anthropic entrega do servidor, e esse conjunto pode mudar ao longo do tempo, então defina a variável quando precisar de um conjunto que não mude

251* **Hooks com permissão**: mesmo com cada tipo limitado, Claude Code exclui do limite um hook que pode bloquear ou alterar o resultado de uma ação, e qualquer servidor MCP que tal hook chama, então o kernel matando um hook com permissão não pode permitir a ação que estava bloqueando267* **Hooks com permissão**: mesmo com cada tipo limitado, Claude Code exclui do limite um hook que pode bloquear ou alterar o resultado de uma ação, e qualquer servidor MCP que tal hook chama, então o kernel matando um hook com permissão não pode permitir a ação que estava bloqueando

252 268 

253<h2 id="edit-tool-behavior">269<h2 id="edit-tool-behavior">

58 58 

59 * **Activity Bar**: clique no ícone Spark na barra lateral esquerda para abrir a lista de sessões. Clique em qualquer sessão para abri-la no seu [local preferido](#extension-settings), ou inicie uma nova. Este ícone está sempre visível na Activity Bar.59 * **Activity Bar**: clique no ícone Spark na barra lateral esquerda para abrir a lista de sessões. Clique em qualquer sessão para abri-la no seu [local preferido](#extension-settings), ou inicie uma nova. Este ícone está sempre visível na Activity Bar.

60 * **Command Palette**: `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux), digite "Claude Code" e selecione uma opção como "Open in New Tab"60 * **Command Palette**: `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux), digite "Claude Code" e selecione uma opção como "Open in New Tab"

61 * **Status Bar**: se você definiu [`preferredLocation`](#extension-settings) como `sidebar`, ou abriu Claude com **Claude Code: Open in Side Bar**, clique em **✻ Claude Code** no canto inferior direito da janela. Isso funciona mesmo quando nenhum arquivo está aberto.61 * **Status Bar**: clique em **✻ Claude Code** no canto inferior direito da janela. Isso funciona mesmo quando nenhum arquivo está aberto.

62 62 

63 Você pode arrastar o painel Claude para reposicioná-lo em qualquer lugar no VS Code. Veja [Personalize seu fluxo de trabalho](#customize-your-workflow) para detalhes.63 Você pode arrastar o painel Claude para reposicioná-lo em qualquer lugar no VS Code. Veja [Personalize seu fluxo de trabalho](#customize-your-workflow) para detalhes.

64 </Step>64 </Step>

362 362 

363Na aba Plugins:363Na aba Plugins:

364 364 

365* **Plugins instalados** aparecem no topo com interruptores de alternância para ativá-los ou desativá-los365* **Plugins instalados** aparecem no topo com interruptores de alternância para ativá-los ou desativá-los.

366 * Se você desativar um plugin que o arquivo `.claude/settings.json` compartilhado do seu projeto ativa, a extensão pergunta primeiro: **Desativar para mim** o desativa apenas para você, enquanto **Desativar para todos** altera o arquivo compartilhado.

366* **Plugins disponíveis** de seus marketplaces configurados aparecem abaixo367* **Plugins disponíveis** de seus marketplaces configurados aparecem abaixo

367* Pesquise para filtrar plugins por nome ou descrição368* Pesquise para filtrar plugins por nome ou descrição

368* Clique em **Instalar** em qualquer plugin disponível369* Clique em **Instalar** em qualquer plugin disponível

373* **Instalar para este projeto**: compartilhado com colaboradores do projeto (escopo de projeto)374* **Instalar para este projeto**: compartilhado com colaboradores do projeto (escopo de projeto)

374* **Instalar localmente**: apenas para você, apenas neste repositório (escopo local)375* **Instalar localmente**: apenas para você, apenas neste repositório (escopo local)

375 376 

377Após a conclusão da instalação, um formulário solicita qualquer uma das [opções de configuração](/docs/pt/plugins/components#user-configuration) do plugin que ainda não estão definidas. Para revisar ou alterar as opções posteriormente, clique no ícone de engrenagem na linha do plugin.

378 

379Os campos de texto sensíveis são mascarados, e um segredo que você salvou anteriormente mostra **(inalterado)**. Deixe o campo em branco para manter o valor salvo.

380 

381Depois de salvar as alterações, as sessões abertas recarregam seus plugins e o diálogo mostra **Reinicie Claude para aplicar alterações de plugin**.

382 

383<h3 id="uninstall-plugins">

384 Desinstalar plugins

385</h3>

386 

387Cada linha instalada nomeia o [escopo](/docs/pt/plugins/install#choose-an-install-scope) em que está instalada. Para desinstalar essa instalação, clique no ícone de lixeira da linha. Um ícone de lixeira esmaecido marca uma linha que você não pode desinstalar deste workspace, como um plugin que sua organização gerencia ou um instalado para outro projeto.

388 

389A extensão pergunta primeiro em dois casos:

390 

391* **Um plugin que o arquivo `.claude/settings.json` compartilhado do seu projeto ativa**: escolha **Desativar para mim**, que mantém o plugin instalado para seus colaboradores, ou **Desinstalar para todos**, que remove a instalação do projeto com [`--keep-data`](/docs/pt/plugins/cli-reference#what-an-uninstall-deletes-and-keeps), para que o diretório de dados salvos do plugin permaneça. Se você já desativou o plugin para si mesmo, o ícone de lixeira remove sua própria instalação sem a pergunta.

392* **Caso contrário, a última instalação de um plugin com dados salvos**: escolha se deseja manter ou excluir os dados; **Manter** é o padrão

393 

376<h3 id="share-a-plugin-install-link">394<h3 id="share-a-plugin-install-link">

377 Compartilhar um link de instalação de plugin395 Compartilhar um link de instalação de plugin

378</h3>396</h3>

407 425 

408* Digite um repositório GitHub, URL ou caminho local para adicionar um novo marketplace426* Digite um repositório GitHub, URL ou caminho local para adicionar um novo marketplace

409* Clique no ícone de atualização para atualizar a lista de plugins de um marketplace427* Clique no ícone de atualização para atualizar a lista de plugins de um marketplace

410* Clique no ícone de lixeira para remover um marketplace428* Clique no ícone de lixeira para remover um marketplace. Removê-lo [desinstala todos os plugins que você instalou dele](/docs/pt/plugins/install#manage-marketplaces), portanto uma confirmação nomeia esses plugins primeiro

429 

430As alterações de plugin que você faz no diálogo se aplicam imediatamente às sessões Claude Code abertas naquela janela VS Code.

411 431 

412As alterações de plugin que você faz no diálogo se aplicam imediatamente às sessões Claude Code abertas naquela janela VS Code. Se a sessão a partir da qual você abriu o diálogo não conseguir recarregar seus plugins, o diálogo oferece tentar novamente ou reiniciar Claude naquela sessão.432Se a sessão a partir da qual você abriu o diálogo não conseguir recarregar seus plugins, o diálogo oferece tentar novamente ou reiniciar Claude naquela sessão.

413 433 

414<Note>434<Note>

415 O gerenciamento de plugins no VS Code usa os mesmos comandos CLI sob o capô. Plugins e marketplaces que você configura na extensão também estão disponíveis na CLI, e vice-versa.435 O gerenciamento de plugins no VS Code usa os mesmos comandos CLI sob o capô. Plugins e marketplaces que você configura na extensão também estão disponíveis na CLI, e vice-versa.

7904. **Desabilite extensões conflitantes**: Desabilite temporariamente outras extensões de IA (Cline, Continue, etc.)8104. **Desabilite extensões conflitantes**: Desabilite temporariamente outras extensões de IA (Cline, Continue, etc.)

7915. **Verifique a confiança do workspace**: A extensão não funciona em Modo Restrito8115. **Verifique a confiança do workspace**: A extensão não funciona em Modo Restrito

792 812 

793Alternativamente, se você definiu [`preferredLocation`](#extension-settings) como `sidebar`, ou abriu Claude com **Claude Code: Open in Side Bar**, clique em "✻ Claude Code" na **Status Bar** (canto inferior direito). Isso funciona mesmo sem um arquivo aberto. Você também pode usar a **Paleta de Comandos** (`Cmd+Shift+P` / `Ctrl+Shift+P`) e digitar "Claude Code".813Alternativamente, clique em **✻ Claude Code** na **Status Bar** no canto inferior direito da janela. Isso funciona mesmo sem um arquivo aberto. Você também pode usar a **Paleta de Comandos** (`Cmd+Shift+P` / `Ctrl+Shift+P`) e digitar "Claude Code".

794 814 

795<h3 id="cmd-esc-does-nothing-on-macos">815<h3 id="cmd-esc-does-nothing-on-macos">

796 Cmd+Esc não faz nada no macOS816 Cmd+Esc não faz nada no macOS