Documentation 2026-11-10 21:57 UTC to 2026-11-11 22:59 UTC

96| [Managed policy CLAUDE.md](https://code.claude.com/docs/pt/memory.md#deploy-organization-wide-claude-md) | Orientação comportamental para o Claude em toda a organização, em vez de uma regra aplicada pelo cliente | Arquivo no caminho da política gerenciada |96| [Managed policy CLAUDE.md](https://code.claude.com/docs/pt/memory.md#deploy-organization-wide-claude-md) | Orientação comportamental para o Claude em toda a organização, em vez de uma regra aplicada pelo cliente | Arquivo no caminho da política gerenciada |

97| [MCP server control](https://code.claude.com/docs/pt/managed-mcp.md) | Restringir quais servidores MCP os usuários podem adicionar ou conectar, implantar um conjunto fixo, ou fornecer servidores remotos para cada usuário ao lado dos seus próprios | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers`, ou um arquivo `managed-mcp.json` implantado |97| [MCP server control](https://code.claude.com/docs/pt/managed-mcp.md) | Restringir quais servidores MCP os usuários podem adicionar ou conectar, implantar um conjunto fixo, ou fornecer servidores remotos para cada usuário ao lado dos seus próprios | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers`, ou um arquivo `managed-mcp.json` implantado |

98| [Plugin marketplace control](https://code.claude.com/docs/pt/plugins/org.md#restrict-what-users-can-install) | Restringir quais fontes de marketplace os usuários podem adicionar e a partir das quais podem instalar, e rejeitar as flags da CLI que carregam plugins, agents e servidores MCP para uma única execução. Bloquear [fontes de plugin `command`](https://code.claude.com/docs/pt/plugins/marketplace-reference#command-plugin-source), e adicionar à allowlist os marketplaces cujos plugins podem ser sugeridos no terminal | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |98| [Plugin marketplace control](https://code.claude.com/docs/pt/plugins/org.md#restrict-what-users-can-install) | Restringir quais fontes de marketplace os usuários podem adicionar e a partir das quais podem instalar, e rejeitar as flags da CLI que carregam plugins, agents e servidores MCP para uma única execução. Bloquear [fontes de plugin `command`](https://code.claude.com/docs/pt/plugins/marketplace-reference#command-plugin-source), e adicionar à allowlist os marketplaces cujos plugins podem ser sugeridos no terminal | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |

99| [Customization lockdown](https://code.claude.com/docs/pt/settings-reference.md#strictpluginonlycustomization) | Bloquear skills, agents, hooks e servidores MCP de fontes de usuário e projeto, para que possam vir apenas de plugins ou configurações gerenciadas. Bloquear skills também interrompe os [skills que seus desenvolvedores habilitam em claude.ai](https://code.claude.com/docs/pt/skills.md#where-synced-skills-load) de sincronização | `strictPluginOnlyCustomization` |99| [Customization lockdown](https://code.claude.com/docs/pt/settings-reference.md#strictpluginonlycustomization) | Bloquear skills, agents, hooks e servidores MCP de fontes de usuário e projeto. Bloquear skills também impede que as [skills que seus desenvolvedores habilitam em claude.ai](https://code.claude.com/docs/pt/skills.md#where-synced-skills-load) sejam sincronizadas | `strictPluginOnlyCustomization` |

100| [Disable claude.ai sync](https://code.claude.com/docs/pt/settings-reference.md#syncclaudeaiskills) | Impedir que Claude Code carregue os [skills](https://code.claude.com/docs/pt/skills.md#how-synced-skills-behave) e [plugins](https://code.claude.com/docs/pt/plugins/loading.md#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` |100| [Disable claude.ai sync](https://code.claude.com/docs/pt/settings-reference.md#syncclaudeaiskills) | Impedir que Claude Code carregue os [skills](https://code.claude.com/docs/pt/skills.md#how-synced-skills-behave) e [plugins](https://code.claude.com/docs/pt/plugins/loading.md#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` |

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

102| [Login enforcement](https://code.claude.com/docs/pt/settings-reference.md#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](https://code.claude.com/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` |102| [Login enforcement](https://code.claude.com/docs/pt/settings-reference.md#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](https://code.claude.com/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` |

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> A ferramenta advisor é experimental e requer a API Anthropic. Não está disponível no Amazon Bedrock, Claude Platform on AWS, na plataforma de agentes do Google Cloud ou no Microsoft Foundry. O comportamento, preços e disponibilidade podem mudar.11> A ferramenta advisor é experimental e requer a API Anthropic ou o [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md). No Claude Platform on AWS, ela requer Claude Code v2.1.300 ou posterior. Não está disponível no Amazon Bedrock, na plataforma de agentes do Google Cloud ou no Microsoft Foundry. O comportamento, preços e disponibilidade podem mudar.

12 12 

13A ferramenta advisor permite que Claude consulte um segundo modelo, tipicamente mais forte, em momentos-chave durante uma tarefa, como antes de se comprometer com uma abordagem, quando preso em um erro recorrente, ou antes de declarar uma tarefa concluída. O advisor recebe a conversa completa, incluindo cada chamada de ferramenta e resultado, e retorna orientação que Claude aplica antes de continuar.13A ferramenta advisor permite que Claude consulte um segundo modelo, tipicamente mais forte, em momentos-chave durante uma tarefa, como antes de se comprometer com uma abordagem, quando preso em um erro recorrente, ou antes de declarar uma tarefa concluída. O advisor recebe a conversa completa, incluindo cada chamada de ferramenta e resultado, e retorna orientação que Claude aplica antes de continuar.

14 14 

174 174 

175## Requisitos175## Requisitos

176 176 

177A ferramenta advisor requer todos os seguintes:177* **Provedor**: a API Anthropic ou [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md), não Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. No Claude Platform on AWS, o advisor requer Claude Code v2.1.300 ou posterior.

178 178* **Gateway de LLM**: através de um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) configurado com `ANTHROPIC_BASE_URL`, a disponibilidade depende de o gateway encaminhar a requisição intacta para a API Anthropic. Se o gateway ou seu upstream não reconhecer a ferramenta advisor, consulte [Nova tentativa automática e encaminhamento de erro](https://code.claude.com/docs/pt/llm-gateway-protocol.md#automatic-retry-and-error-forwarding) para saber como Claude Code responde.

179* **Apenas API Anthropic**: o advisor é uma ferramenta executada no servidor. Não está disponível no Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ou Microsoft Foundry. Através de um [LLM gateway](https://code.claude.com/docs/pt/llm-gateway) configurado com `ANTHROPIC_BASE_URL`, a disponibilidade depende se o gateway encaminha a solicitação intacta para a API Anthropic. Se o gateway ou seu upstream não reconhecer a ferramenta advisor, consulte [Retry automático e encaminhamento de erro](https://code.claude.com/docs/pt/llm-gateway-protocol.md#automatic-retry-and-error-forwarding) para saber como Claude Code responde.

180* **Modelo principal suportado**: Fable, Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, Haiku 4.5 ou Haiku 5.5. Consulte [Escolher um modelo advisor](#choose-an-advisor-model) para saber quais advisors cada um aceita.179* **Modelo principal suportado**: Fable, Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, Haiku 4.5 ou Haiku 5.5. Consulte [Escolher um modelo advisor](#choose-an-advisor-model) para saber quais advisors cada um aceita.

181* **Busca de feature-flag**: Claude Code ativa o advisor através de um feature flag que busca da Anthropic. Em uma sessão onde uma variável que desativa a busca de flag está definida, como `DISABLE_TELEMETRY`, o advisor permanece desativado. Consulte [Recursos que precisam de busca de feature-flag](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching).180* **Busca de feature flag**: a menos que você esteja no Claude Platform on AWS, o advisor precisa de uma feature flag buscada da Anthropic. Uma sessão com uma variável que desativa a busca, como `DISABLE_TELEMETRY`, não tem essa flag. Para verificar sua sessão, consulte [quais sessões pulam a busca ou iniciam sem a flag](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching).

182 181 

183## Desativar o advisor182## Desativar o advisor

184 183 

220 220 

221> [!NOTE]221> [!NOTE]

222>222>

223> `effort` troca latência e custo de token por profundidade de raciocínio dentro de cada resposta. [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) é um recurso separado que produz blocos `thinking` na saída, e o campo `display` em `ThinkingConfig` para [Python](https://code.claude.com/docs/pt/agent-sdk/python.md#thinkingconfig) ou [TypeScript](https://code.claude.com/docs/pt/agent-sdk/typescript.md#thinkingconfig) controla se você recebe seu texto. Eles são independentes: você pode definir `effort: "low"` com extended thinking habilitado, ou `effort: "max"` sem ele.223> `effort` troca latência e custo de token por profundidade de raciocínio dentro de cada resposta. [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) produz blocos `thinking` na saída, e o campo `display` em `ThinkingConfig` para [Python](https://code.claude.com/docs/pt/agent-sdk/python.md#thinkingconfig) ou [TypeScript](https://code.claude.com/docs/pt/agent-sdk/typescript.md#thinkingconfig) controla se você recebe seu texto.

224 224 

225Use esforço mais baixo para agentes que fazem tarefas simples e bem definidas, como listar arquivos ou executar um único grep, para reduzir custo e latência. Defina `effort` nas opções de nível superior `query()` para a [sessão](https://code.claude.com/docs/pt/sub-agents.md#choose-an-effort-level), ou por subagente com o campo `effort` em [`AgentDefinition`](https://code.claude.com/docs/pt/agent-sdk/subagents#agentdefinition-configuration) para sobrescrever o nível da sessão.225Use esforço mais baixo para agentes que fazem tarefas simples e bem definidas, como listar arquivos ou executar um único grep, para reduzir custo e latência. Defina `effort` nas opções de nível superior `query()` para a [sessão](https://code.claude.com/docs/pt/sub-agents.md#choose-an-effort-level), ou por subagente com o campo `effort` em [`AgentDefinition`](https://code.claude.com/docs/pt/agent-sdk/subagents#agentdefinition-configuration) para sobrescrever o nível da sessão.

226 226 

227Depois que você anexa a identidade de usuário final, estes eventos se tornam uma trilha de auditoria por usuário que você pode encaminhar para uma plataforma de Security Information and Event Management (SIEM):227Depois que você anexa a identidade de usuário final, estes eventos se tornam uma trilha de auditoria por usuário que você pode encaminhar para uma plataforma de Security Information and Event Management (SIEM):

228 228 

229* `tool_decision` e `tool_result`: cada chamada de ferramenta, se ela foi permitida ou negada, e seu resultado229* `tool_decision` e `tool_result`: cada chamada de ferramenta, se ela foi permitida ou negada, e seu resultado

230* `safety_event`: qual verificação recusou uma chamada de ferramenta ou exigiu um prompt de permissão para ela, como uma regra de permissão ou o classificador do modo auto. Algumas chamadas [não têm evento de segurança](https://code.claude.com/docs/pt/monitoring-usage.md#calls-without-a-safety-event). Requer Claude Code v2.1.307 ou posterior

231* `mcp_server_connection`: conexões com servidores MCP e falhas de conexão230* `mcp_server_connection`: conexões com servidores MCP e falhas de conexão

232* `permission_mode_changed`: alterações do modo de permissão231* `permission_mode_changed`: alterações do modo de permissão

233 232 

234Esses eventos são exportados como registros de log nomeados com um prefixo `claude_code.`, como `claude_code.safety_event`. Consulte [Auditar eventos de segurança](https://code.claude.com/docs/pt/monitoring-usage.md#audit-security-events) na referência de Monitoring para a lista completa de eventos relevantes para segurança e os atributos que cada um carrega.233Esses eventos são exportados como registros de log nomeados com um prefixo `claude_code.`, como `claude_code.tool_decision`. Consulte [Auditar eventos de segurança](https://code.claude.com/docs/pt/monitoring-usage.md#audit-security-events) na referência de Monitoring para a lista completa de eventos relevantes para segurança e os atributos que cada um carrega.

235 234 

236## Controlar dados sensíveis em exportações235## Controlar dados sensíveis em exportações

237 236 

240| Variable | Adiciona |239| Variable | Adiciona |

241| - | - |240| - | - |

242| `OTEL_LOG_USER_PROMPTS=1` | Texto de prompt em eventos `claude_code.user_prompt` e no span `claude_code.interaction` |241| `OTEL_LOG_USER_PROMPTS=1` | Texto de prompt em eventos `claude_code.user_prompt` e no span `claude_code.interaction` |

243| `OTEL_LOG_TOOL_DETAILS=1` | Argumentos de entrada de ferramenta, como caminhos de arquivo, comandos de shell e padrões de pesquisa em eventos `claude_code.tool_result`, e nomes reais de agente, skill, plugin e servidor MCP nas [métricas de custo e token](https://code.claude.com/docs/pt/monitoring-usage.md#cost-counter). A regra integrada que o classificador do modo auto indicou ao bloquear uma chamada, como [`classifier_category`](https://code.claude.com/docs/pt/monitoring-usage#tool-decision-event) nos eventos `claude_code.tool_decision` e `claude_code.safety_event` |242| `OTEL_LOG_TOOL_DETAILS=1` | Argumentos de entrada de ferramenta, como caminhos de arquivo, comandos de shell e padrões de pesquisa em eventos `claude_code.tool_result`, e nomes reais de agente, skill, plugin e servidor MCP nas [métricas de custo e token](https://code.claude.com/docs/pt/monitoring-usage.md#cost-counter). A regra integrada que o classificador do modo auto indicou ao bloquear uma chamada, como [`classifier_category`](https://code.claude.com/docs/pt/monitoring-usage#tool-decision-event) nos eventos `claude_code.tool_decision` |

244| `OTEL_LOG_TOOL_CONTENT=1` | Um evento de span [`tool.output`](https://code.claude.com/docs/pt/monitoring-usage#tool-output-span-event) em `claude_code.tool` com conteúdos de arquivo, saída de Bash e o que ferramentas MCP, WebFetch e WebSearch retornam, truncado em 60 KB por padrão, configurável via `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, que requer Claude Code v2.1.214 ou posterior. Resultados de ferramentas MCP, WebFetch e WebSearch requerem Claude Code v2.1.283 ou posterior. Requer que [rastreamento](#read-agent-traces) esteja ativado. Os atributos de span carregam conteúdo de ferramenta sob [seus próprios gates](https://code.claude.com/docs/pt/monitoring-usage.md#new-context-gates) |243| `OTEL_LOG_TOOL_CONTENT=1` | Um evento de span [`tool.output`](https://code.claude.com/docs/pt/monitoring-usage#tool-output-span-event) em `claude_code.tool` com conteúdos de arquivo, saída de Bash e o que ferramentas MCP, WebFetch e WebSearch retornam, truncado em 60 KB por padrão, configurável via `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, que requer Claude Code v2.1.214 ou posterior. Resultados de ferramentas MCP, WebFetch e WebSearch requerem Claude Code v2.1.283 ou posterior. Requer que [rastreamento](#read-agent-traces) esteja ativado. Os atributos de span carregam conteúdo de ferramenta sob [seus próprios gates](https://code.claude.com/docs/pt/monitoring-usage.md#new-context-gates) |

245| `OTEL_LOG_RAW_API_BODIES` | JSON completo de solicitação e resposta da API Anthropic Messages como eventos de log `claude_code.api_request_body` e `claude_code.api_response_body`. Defina como `1` para corpos inline truncados em 60 KB por padrão, ou `file:<dir>` para corpos não truncados em disco com um caminho `body_ref` no evento. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura o limite de truncamento inline, e requer Claude Code v2.1.214 ou posterior. Os corpos incluem todo o histórico de conversa e têm conteúdo de pensamento estendido redatado. Ativar isso implica consentimento para tudo que as três variáveis acima revelariam |244| `OTEL_LOG_RAW_API_BODIES` | JSON completo de solicitação e resposta da API Anthropic Messages como eventos de log `claude_code.api_request_body` e `claude_code.api_response_body`. Defina como `1` para corpos inline truncados em 60 KB por padrão, ou `file:<dir>` para corpos não truncados em disco com um caminho `body_ref` no evento. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura o limite de truncamento inline, e requer Claude Code v2.1.214 ou posterior. Os corpos incluem todo o histórico de conversa e têm conteúdo de pensamento estendido redatado. Ativar isso implica consentimento para tudo que as três variáveis acima revelariam |

246 245 

1383| :- | :- | :- |1383| :- | :- | :- |

1384| `adaptive` | `type`, `display` | Claude decide adaptativamente quando pensar |1384| `adaptive` | `type`, `display` | Claude decide adaptativamente quando pensar |

1385| `enabled` | `type`, `budget_tokens`, `display` | Ativar pensamento com um orçamento de token específico |1385| `enabled` | `type`, `budget_tokens`, `display` | Ativar pensamento com um orçamento de token específico |

1386| `disabled` | `type` | Desabilitar pensamento |1386| `disabled` | `type` | Desativar o pensamento [onde o modelo e o provedor permitem](https://code.claude.com/docs/pt/model-config.md#where-you-cant-turn-thinking-off) |

1387 1387 

1388O campo `display` opcional controla se o texto de pensamento é retornado `"summarized"` ou `"omitted"`. No Claude Opus 4.7 e posterior, o padrão da API é `"omitted"`, então defina `"summarized"` para receber conteúdo de pensamento em saídas [`ThinkingBlock`](#thinkingblock). Em provedores como Amazon Bedrock e Google Cloud's Agent Platform, Claude Code não repassa `display` para modelos anteriores que reconhece. Esses são Opus 4.6, Sonnet 4.6, Haiku 4.5 e modelos anteriores, que usam seu próprio padrão.1388O campo `display` opcional controla se o texto de pensamento é retornado `"summarized"` ou `"omitted"`. No Claude Opus 4.7 e posterior, o padrão da API é `"omitted"`, então defina `"summarized"` para receber conteúdo de pensamento em saídas [`ThinkingBlock`](#thinkingblock). Em provedores como Amazon Bedrock e Google Cloud's Agent Platform, Claude Code não repassa `display` para modelos anteriores que reconhece. Esses são Opus 4.6, Sonnet 4.6, Haiku 4.5 e modelos anteriores, que usam seu próprio padrão.

1389 1389 

664| `rewindFiles(userMessageId, options?)` | Restaura os arquivos ao estado em que estavam na mensagem de usuário especificada. Passe `{ dryRun: true }` para visualizar as alterações. Requer `enableFileCheckpointing: true`. Consulte [Checkpointing de arquivos](https://code.claude.com/docs/pt/agent-sdk/file-checkpointing.md) |664| `rewindFiles(userMessageId, options?)` | Restaura os arquivos ao estado em que estavam na mensagem de usuário especificada. Passe `{ dryRun: true }` para visualizar as alterações. Requer `enableFileCheckpointing: true`. Consulte [Checkpointing de arquivos](https://code.claude.com/docs/pt/agent-sdk/file-checkpointing.md) |

665| `setPermissionMode()` | Altera o modo de permissão (disponível apenas no modo de entrada por streaming) |665| `setPermissionMode()` | Altera o modo de permissão (disponível apenas no modo de entrada por streaming) |

666| `setModel()` | Altera o modelo (disponível apenas no modo de entrada por streaming). Passar `undefined` ou a string `"default"` redefine para o [modelo padrão do Claude Code](https://code.claude.com/docs/pt/model-config.md). Uma sessão no modo `auto` [muda para o modo `default`](https://code.claude.com/docs/pt/agent-sdk/permissions#auto-mode-auto) se o novo modelo não suportar o modo auto |666| `setModel()` | Altera o modelo (disponível apenas no modo de entrada por streaming). Passar `undefined` ou a string `"default"` redefine para o [modelo padrão do Claude Code](https://code.claude.com/docs/pt/model-config.md). Uma sessão no modo `auto` [muda para o modo `default`](https://code.claude.com/docs/pt/agent-sdk/permissions#auto-mode-auto) se o novo modelo não suportar o modo auto |

667| `setMaxThinkingTokens()` | *Obsoleto:* use a opção `thinking` em vez disso. Altera o máximo de tokens de pensamento. Passar `null` redefine o pensamento para o padrão da sessão: um valor que sobrescreve no meio da sessão é limpo, e o pensamento permanece desativado em sessões que o têm desabilitado |667| `setMaxThinkingTokens()` | *Obsoleto:* Use a opção `thinking` em vez disso. Altera o máximo de tokens de pensamento. Passe `null` para desfazer chamadas anteriores e restaurar a opção `thinking` ou `maxThinkingTokens` com a qual a sessão foi iniciada |

668| `applyFlagSettings(settings)` | Mescla configurações na camada de configurações de flag da sessão em tempo de execução (disponível apenas no modo de entrada por streaming). Consulte [`applyFlagSettings()`](#applyflagsettings) |668| `applyFlagSettings(settings)` | Mescla configurações na camada de configurações de flag da sessão em tempo de execução (disponível apenas no modo de entrada por streaming). Consulte [`applyFlagSettings()`](#applyflagsettings) |

669| `updateSettings(source, settings)` | Grava uma chave permitida no arquivo de configurações locais do projeto ou no seu arquivo de configurações de usuário, para que o valor persista em sessões posteriores. Consulte [`updateSettings()`](#updatesettings). Requer o TypeScript SDK v0.3.257 ou posterior, que inclui o Claude Code v2.1.257 |669| `updateSettings(source, settings)` | Grava uma chave permitida no arquivo de configurações locais do projeto ou no seu arquivo de configurações de usuário, para que o valor persista em sessões posteriores. Consulte [`updateSettings()`](#updatesettings). Requer o TypeScript SDK v0.3.257 ou posterior, que inclui o Claude Code v2.1.257 |

670| `initializationResult()` | Retorna o resultado completo da inicialização, incluindo comandos suportados, modelos, informações da conta e configuração de estilo de saída |670| `initializationResult()` | Retorna o resultado completo da inicialização, incluindo comandos suportados, modelos, informações da conta e configuração de estilo de saída |

5432type ThinkingConfig =5432type ThinkingConfig =

5433 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)5433 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)

5434 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget5434 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget

5435 | { type: "disabled" }; // No extended thinking5435 | { type: "disabled" }; // Turn thinking off where the model and provider allow it

5436```5436```

5437 5437 

5438Para `disabled`, consulte [onde não é possível desativar o pensamento](https://code.claude.com/docs/pt/model-config.md#where-you-cant-turn-thinking-off).

5439 

5438O campo opcional `display` controla se o texto de pensamento é retornado como `"summarized"` ou `"omitted"`. No Claude Opus 4.7 e posteriores, o padrão da API é `"omitted"`, então defina `"summarized"` para receber conteúdo de pensamento em blocos `thinking`. Em provedores como o Amazon Bedrock e o Agent Platform do Google Cloud, o Claude Code não repassa `display` para os modelos anteriores que ele reconhece. Esses são o Opus 4.6, o Sonnet 4.6, o Haiku 4.5 e modelos anteriores, que usam o seu padrão.5440O campo opcional `display` controla se o texto de pensamento é retornado como `"summarized"` ou `"omitted"`. No Claude Opus 4.7 e posteriores, o padrão da API é `"omitted"`, então defina `"summarized"` para receber conteúdo de pensamento em blocos `thinking`. Em provedores como o Amazon Bedrock e o Agent Platform do Google Cloud, o Claude Code não repassa `display` para os modelos anteriores que ele reconhece. Esses são o Opus 4.6, o Sonnet 4.6, o Haiku 4.5 e modelos anteriores, que usam o seu padrão.

5439 5441 

5440### `SpawnedProcess`5442### `SpawnedProcess`

169 169 

170Quando a lista é [agrupada por diretório](#organize-the-list), o resumo abre com o estado da sessão como uma palavra colorida, como `Needs input · double jump or wall climb?`. No agrupamento de estado padrão, o cabeçalho do grupo já nomeia o estado, então a linha mostra apenas o resumo.170Quando a lista é [agrupada por diretório](#organize-the-list), o resumo abre com o estado da sessão como uma palavra colorida, como `Needs input · double jump or wall climb?`. No agrupamento de estado padrão, o cabeçalho do grupo já nomeia o estado, então a linha mostra apenas o resumo.

171 171 

172O resumo de fim de turno e cada reescrita de meio de turno são uma requisição curta de Haiku-class através de seu provedor normal, cobrada e tratada sob os mesmos [termos de uso de dados](https://code.claude.com/docs/pt/data-usage.md) que a sessão em si. As atualizações de 15 segundos entre reescritas de modelo reutilizam a saída da própria sessão e não enviam uma requisição. Em um provedor de terceiros ou gateway sem um modelo Haiku-class configurado, a requisição usa o modelo principal da sessão em vez disso; defina [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/pt/model-config#environment-variables) para escolher um.172#### Custo dos resumos de linha

173 

174O resumo de fim de turno e cada reescrita de meio de turno são uma requisição curta através de seu provedor normal, cobrada e tratada sob os mesmos [termos de uso de dados](https://code.claude.com/docs/pt/data-usage.md) que a sessão em si. Em um provedor de terceiros ou gateway, os resumos usam o modelo que você define em [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/pt/model-config#environment-variables). Quando ela não está definida, eles usam o modelo do seu provedor para tarefas em segundo plano: veja [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#4-pin-model-versions), [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md#5-pin-model-versions), [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md#4-pin-model-versions) ou seu [gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#requests-and-defaults-by-connection-method).

173 175 

174### Status de pull request176### Status de pull request

175 177 

128 128 

129### Ferramentas do navegador no modo de planejamento129### Ferramentas do navegador no modo de planejamento

130 130 

131No [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode), um prompt de permissão aparece antes de Claude gravar um GIF, abrir uma nova aba ou executar um atalho. Em uma sessão interativa da CLI, se o [modo de bypass de permissões estiver disponível](https://code.claude.com/docs/pt/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) e a [busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching) estiver desativada, essas chamadas são executadas sem um prompt.131No [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode), um prompt de permissão aparece antes de Claude gravar um GIF ou abrir uma nova aba. Em uma sessão interativa da CLI, se o [modo de bypass de permissões estiver disponível](https://code.claude.com/docs/pt/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) e a [busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching) estiver desativada, essas chamadas são executadas sem um prompt.

132 132 

133Uma chamada `tabs_context_mcp` também solicita quando define `createIfEmpty`, e o mesmo ocorre com uma chamada `browser_batch` que inclui qualquer uma dessas ações.133Uma chamada `tabs_context_mcp` também solicita quando define `createIfEmpty`, e o mesmo ocorre com uma chamada `browser_batch` que inclui qualquer uma dessas ações.

134 134 

313>313>

314> `gatewayInternalNetworks` é para redes internas que acontecem de ser numeradas a partir de espaço de endereço público. Não torna seguro expor um gateway para a internet: um gateway confiável pode enviar configurações que executam comandos em máquinas de desenvolvedores.314> `gatewayInternalNetworks` é para redes internas que acontecem de ser numeradas a partir de espaço de endereço público. Não torna seguro expor um gateway para a internet: um gateway confiável pode enviar configurações que executam comandos em máquinas de desenvolvedores.

315>315>

316> Mantenha o gateway inacessível de fora de sua rede com suas regras de firewall ou balanceador de carga. Defina o [`access_control.allow_cidrs`](https://code.claude.com/docs/pt/claude-apps-gateway-config#http-tuning) do gateway para os mesmos blocos que você declara aqui, então o gateway em si recusa clientes de qualquer outro lugar. Atrás de um balanceador de carga ou ingress, defina `listen.trusted_proxies` para esse front end também, porque o gateway de outra forma corresponde `allow_cidrs` contra o próprio endereço do front end em vez do desenvolvedor.316> Mantenha o gateway inacessível de fora de sua rede com suas regras de firewall ou balanceador de carga. Defina o [`access_control.allow_cidrs`](https://code.claude.com/docs/pt/claude-apps-gateway-config#http-tuning) do gateway para os mesmos blocos que você declara aqui. Se um balanceador de carga ou ingress [pertence a `listen.trusted_proxies`](https://code.claude.com/docs/pt/claude-apps-gateway-config#listen), liste-o lá também, porque o gateway de outra forma corresponde `allow_cidrs` contra o próprio endereço do front end em vez do endereço do desenvolvedor.

317 317 

318Adicione a chave à mesma fonte de configurações gerenciadas que as chaves de login: o arquivo de configurações gerenciadas, perfil MDM ou política de registro. Claude Code a ignora em configurações de usuário, projeto e gerenciadas pelo servidor.318Adicione a chave à mesma fonte de configurações gerenciadas que as chaves de login: o arquivo de configurações gerenciadas, perfil MDM ou política de registro. Claude Code a ignora em configurações de usuário, projeto e gerenciadas pelo servidor.

319 319 

59| `port` | Não | Porta de bind. Padrão `8080`. |59| `port` | Não | Porta de bind. Padrão `8080`. |

60| `public_url` | A menos que `host` seja loopback | A origem `https://` visível externamente, usada para montar o `redirect_uri` do IdP e os metadados de descoberta. Obrigatório sempre que `host` não for um endereço de loopback, seja o TLS terminado em um proxy como um ALB, Ingress ou Cloud Run, seja no próprio gateway por meio de `tls`, porque o gateway nunca deriva sua própria origem dos cabeçalhos `X-Forwarded-*`; eles podem ser falsificados pelo cliente. A inicialização falha sem ele. `trusted_proxies`, abaixo, rege apenas a resolução do IP do cliente. Também é obrigatório para ativar a [telemetria](#telemetry), porque o gateway monta a partir desta URL o endpoint OTLP que envia aos clientes. |60| `public_url` | A menos que `host` seja loopback | A origem `https://` visível externamente, usada para montar o `redirect_uri` do IdP e os metadados de descoberta. Obrigatório sempre que `host` não for um endereço de loopback, seja o TLS terminado em um proxy como um ALB, Ingress ou Cloud Run, seja no próprio gateway por meio de `tls`, porque o gateway nunca deriva sua própria origem dos cabeçalhos `X-Forwarded-*`; eles podem ser falsificados pelo cliente. A inicialização falha sem ele. `trusted_proxies`, abaixo, rege apenas a resolução do IP do cliente. Também é obrigatório para ativar a [telemetria](#telemetry), porque o gateway monta a partir desta URL o endpoint OTLP que envia aos clientes. |

61| `tls.cert` / `tls.key` | Não | Caminhos PEM, caso o próprio gateway termine o TLS |61| `tls.cert` / `tls.key` | Não | Caminhos PEM, caso o próprio gateway termine o TLS |

62| `trusted_proxies` | Não | CIDRs ou IPs dos balanceadores de carga à frente do gateway. Quando definido, o gateway confia em `X-Forwarded-For` somente vindo desses pares e registra o IP real do cliente para rate limiting por IP e auditoria. Equivalente ao `set_real_ip_from` do nginx. Entradas de `X-Forwarded-For` escritas como `ipv4:port` ou `[ipv6]:port`, como alguns balanceadores de carga fazem, são lidas descartando a porta. Um endereço IPv6 com uma porta anexada e sem colchetes pode ser lido como um endereço diferente ou nem ser lido, então desative a opção de porta em qualquer proxy que escreva nesse formato. |62| `trusted_proxies` | Não | CIDRs ou IPs dos frontends confiáveis. Quando definido, o gateway confia em `X-Forwarded-For` apenas desses pares e registra o IP real do cliente para o rate limit por IP e para auditoria. |

63 

64Liste um frontend em `trusted_proxies` somente se a última entrada de `X-Forwarded-For` que ele repassa for uma que nenhum desenvolvedor escreveu. Não liste nenhum endereço ou intervalo a partir do qual os desenvolvedores se conectam. Um frontend que acrescenta o endereço de cada conexão que recebe se qualifica. Um que repassa o cabeçalho como os desenvolvedores o enviam não se qualifica.

65 

66Entradas de `X-Forwarded-For` escritas como `ipv4:port` ou `[ipv6]:port`, como alguns balanceadores de carga fazem, são lidas com a porta descartada. Um endereço IPv6 com uma porta acrescentada e sem colchetes pode ser lido como um endereço diferente ou não ser lido. Desative a opção de porta em qualquer proxy que escreva essa forma.

63 67 

64### `oidc`68### `oidc`

65 69 

1659 1663 

1660Ambos os sinais usam o endereço do cliente conforme resolvido pelo gateway. Se um balanceador de carga, port-forward ou túnel retransmite o tráfego e não está listado em `listen.trusted_proxies`, o gateway vê o endereço do intermediário, que geralmente é privado, então nem o aviso em tempo de execução nem uma lista de permissões privada capturam o tráfego retransmitido por ele.1664Ambos os sinais usam o endereço do cliente conforme resolvido pelo gateway. Se um balanceador de carga, port-forward ou túnel retransmite o tráfego e não está listado em `listen.trusted_proxies`, o gateway vê o endereço do intermediário, que geralmente é privado, então nem o aviso em tempo de execução nem uma lista de permissões privada capturam o tráfego retransmitido por ele.

1661 1665 

1662Por trás de um front end desse tipo, defina primeiro [`listen.trusted_proxies`](#listen) para que o gateway veja os endereços reais dos clientes e, de qualquer forma, mantenha o gateway e tudo o que está à frente dele inacessíveis a partir da internet pública.1666Se o intermediário [pertence a `listen.trusted_proxies`](#listen), liste-o ali. De qualquer forma, mantenha o gateway e tudo o que está à frente dele inacessíveis pela internet pública.

1663 1667 

1664### `load_test_mode`1668### `load_test_mode`

1665 1669 

131 131 

132O sign-in é limitado por taxa por endereço IP do cliente, e os padrões se adequam a uma pequena equipe. Cada endereço recebe 30 inícios de sign-in e 10 envios de código a cada 10 minutos. Uma implantação para milhares de desenvolvedores pode atingir esses limites na primeira manhã, por uma de duas razões:132O sign-in é limitado por taxa por endereço IP do cliente, e os padrões se adequam a uma pequena equipe. Cada endereço recebe 30 inícios de sign-in e 10 envios de código a cada 10 minutos. Uma implantação para milhares de desenvolvedores pode atingir esses limites na primeira manhã, por uma de duas razões:

133 133 

134* **O gateway não consegue ver além do seu balanceador de carga.** Sem [`listen.trusted_proxies`](https://code.claude.com/docs/pt/claude-apps-gateway-config#listen), cada desenvolvedor parece vir do endereço do balanceador de carga e compartilha um limite. Defina-o antes de qualquer outra coisa. O gateway registra um aviso na primeira vez que ignora um cabeçalho `X-Forwarded-For`.134* **O gateway não consegue ver além do seu balanceador de carga.** Sem [`listen.trusted_proxies`](https://code.claude.com/docs/pt/claude-apps-gateway-config#listen), cada desenvolvedor parece vir do endereço do balanceador de carga e compartilha um limite. O gateway registra um aviso em log na primeira vez que ignora um cabeçalho `X-Forwarded-For`. Se o balanceador de carga [deve constar em `listen.trusted_proxies`](https://code.claude.com/docs/pt/claude-apps-gateway-config#listen), liste-o antes de alterar qualquer outra coisa. Se os desenvolvedores ainda compartilharem um único endereço, aumente [`rate_limits`](https://code.claude.com/docs/pt/claude-apps-gateway-config#http-tuning).

135* **Muitos desenvolvedores compartilham alguns endereços de saída NAT ou VPN.** Eles compartilham os limites desses endereços mesmo quando `trusted_proxies` está correto. Aumente [`rate_limits`](https://code.claude.com/docs/pt/claude-apps-gateway-config#http-tuning) para se adequar.135* **Muitos desenvolvedores compartilham alguns endereços de saída NAT ou VPN.** Eles compartilham os limites desses endereços mesmo quando `trusted_proxies` está correto. Aumente [`rate_limits`](https://code.claude.com/docs/pt/claude-apps-gateway-config#http-tuning) para se adequar.

136 136 

137Para dimensionar `max`, divida os desenvolvedores pelos endereços de saída que eles compartilham. Estime quantos desses fazem sign-in dentro de um período `window_seconds`, que é 10 minutos por padrão. Depois dobre para cobrir tentativas novamente e desenvolvedores que fazem sign-in tanto para Claude Code quanto para Claude Desktop.137Para dimensionar `max`, divida os desenvolvedores pelos endereços de saída que eles compartilham. Estime quantos desses fazem sign-in dentro de um período `window_seconds`, que é 10 minutos por padrão. Depois dobre para cobrir tentativas novamente e desenvolvedores que fazem sign-in tanto para Claude Code quanto para Claude Desktop.

418| A inicialização mostra `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | O build do Claude Code instalado é anterior ao suporte de gateway | Peça ao desenvolvedor para atualizar Claude Code para uma versão que inclua suporte de Cloud gateway |418| A inicialização mostra `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | O build do Claude Code instalado é anterior ao suporte de gateway | Peça ao desenvolvedor para atualizar Claude Code para uma versão que inclua suporte de Cloud gateway |

419| A inicialização sai com `Administrator policy requires a Cloud gateway sign-in on this machine` | O ambiente do desenvolvedor define `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN`, suas configurações configuram um [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper), ou uma chave de API de um login anterior do Claude Console ainda está salva | Peça ao desenvolvedor para limpar cada um que se aplica: desdefina a variável, remova a entrada `apiKeyHelper`, ou execute `claude auth logout` para remover a chave salva. Uma sessão que seleciona um provedor de nuvem com `CLAUDE_CODE_USE_*` então inicia sem login; para todas as outras sessões, peça para iniciar `claude` e fazer login com `/login`. Veja também [Administrator policy requires a Cloud gateway sign-in](https://code.claude.com/docs/pt/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in). |419| A inicialização sai com `Administrator policy requires a Cloud gateway sign-in on this machine` | O ambiente do desenvolvedor define `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN`, suas configurações configuram um [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper), ou uma chave de API de um login anterior do Claude Console ainda está salva | Peça ao desenvolvedor para limpar cada um que se aplica: desdefina a variável, remova a entrada `apiKeyHelper`, ou execute `claude auth logout` para remover a chave salva. Uma sessão que seleciona um provedor de nuvem com `CLAUDE_CODE_USE_*` então inicia sem login; para todas as outras sessões, peça para iniciar `claude` e fazer login com `/login`. Veja também [Administrator policy requires a Cloud gateway sign-in](https://code.claude.com/docs/pt/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in). |

420| A inicialização ou `/login` relata `Claude Code may not be enabled for your organization` após um 403 no carregamento de configurações gerenciadas | O gateway, ou algo na frente dele, respondeu à requisição `/managed/settings` com 403. A rota de configurações do próprio gateway nunca responde com 403. O status vem das verificações de IP [`access_control`](https://code.claude.com/docs/pt/claude-apps-gateway-config#http-tuning) ou de um proxy ou WAF na frente do gateway. O log de auditoria registra uma negação de verificação de IP como `access.denied` com o motivo. O desenvolvedor permanece conectado. | Verifique o log de auditoria para `access.denied` no momento da falha e corrija as listas `access_control` ou o front end, depois peça ao desenvolvedor para iniciar `claude` novamente |420| A inicialização ou `/login` relata `Claude Code may not be enabled for your organization` após um 403 no carregamento de configurações gerenciadas | O gateway, ou algo na frente dele, respondeu à requisição `/managed/settings` com 403. A rota de configurações do próprio gateway nunca responde com 403. O status vem das verificações de IP [`access_control`](https://code.claude.com/docs/pt/claude-apps-gateway-config#http-tuning) ou de um proxy ou WAF na frente do gateway. O log de auditoria registra uma negação de verificação de IP como `access.denied` com o motivo. O desenvolvedor permanece conectado. | Verifique o log de auditoria para `access.denied` no momento da falha e corrija as listas `access_control` ou o front end, depois peça ao desenvolvedor para iniciar `claude` novamente |

421| CLI `/login`: `The gateway is limiting sign-in attempts right now`, ou `Request failed with status code 429` em versões mais antigas. A página `/device` pode mostrar `Too many attempts` para desenvolvedores que não tentaram antes | O rate limit de login por IP foi atingido. Ou `listen.trusted_proxies` não cobre o balanceador de carga, então cada desenvolvedor compartilha seu endereço, ou muitos desenvolvedores compartilham um endereço de saída NAT ou VPN. Eventos de auditoria com `result: rate_limited` mostram o mesmo um ou poucos valores `client_ip`. | Defina `listen.trusted_proxies` para os intervalos de origem do balanceador de carga primeiro, depois aumente `rate_limits` se desenvolvedores ainda compartilharem endereços. Veja [Large rollouts](#large-rollouts). |421| CLI `/login`: `The gateway is limiting sign-in attempts right now`, ou `Request failed with status code 429` em versões mais antigas. A página `/device` pode mostrar `Too many attempts` para desenvolvedores que não tentaram antes | O rate limit de login por IP foi atingido. Ou `listen.trusted_proxies` não cobre o balanceador de carga, então cada desenvolvedor compartilha seu endereço, ou muitos desenvolvedores compartilham um endereço de saída NAT ou VPN. Eventos de auditoria com `result: rate_limited` mostram o mesmo um ou poucos valores `client_ip`. | Se o balanceador de carga [pertence a `listen.trusted_proxies`](https://code.claude.com/docs/pt/claude-apps-gateway-config#listen), liste-o primeiro. Depois aumente `rate_limits` se desenvolvedores ainda compartilharem endereços. Veja [Large rollouts](#large-rollouts). |

422| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | O nome do host do gateway resolve para pelo menos um endereço IP público. Claude Code verifica cada endereço resolvido e requer que todos sejam privados. Uma causa comum é um nome dual-stack onde uma família resolve para um endereço público, incluindo balanceadores de carga dual-stack internos da AWS, que retornam endereços AAAA de intervalo público. | Faça com que o nome do gateway resolva apenas para endereços privados nas máquinas dos desenvolvedores. Para um nome dual-stack, remova o registro de intervalo público ou sirva um nome DNS separado apenas para interno. Veja o [pré-requisito de rede privada](https://code.claude.com/docs/pt/claude-apps-gateway#prerequisites). Se o endereço é espaço público que sua organização possui e usa internamente, [declare esse bloco](https://code.claude.com/docs/pt/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) em vez disso. |422| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | O nome do host do gateway resolve para pelo menos um endereço IP público. Claude Code verifica cada endereço resolvido e requer que todos sejam privados. Uma causa comum é um nome dual-stack onde uma família resolve para um endereço público, incluindo balanceadores de carga dual-stack internos da AWS, que retornam endereços AAAA de intervalo público. | Faça com que o nome do gateway resolva apenas para endereços privados nas máquinas dos desenvolvedores. Para um nome dual-stack, remova o registro de intervalo público ou sirva um nome DNS separado apenas para interno. Veja o [pré-requisito de rede privada](https://code.claude.com/docs/pt/claude-apps-gateway#prerequisites). Se o endereço é espaço público que sua organização possui e usa internamente, [declare esse bloco](https://code.claude.com/docs/pt/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) em vez disso. |

423| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | Um `HTTPS_PROXY` ou `HTTP_PROXY` se aplica ao host do gateway e o nome do host do proxy resolve para um endereço público. Um proxy cujo host resolve apenas para endereços privados é permitido e não dispara esse erro | Adicione o host do gateway a `NO_PROXY` na máquina do desenvolvedor para que a conexão seja direta, ou use um proxy cujo nome do host resolve para endereços privados. A mensagem nomeia a entrada exata `NO_PROXY` a adicionar |423| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | Um `HTTPS_PROXY` ou `HTTP_PROXY` se aplica ao host do gateway e o nome do host do proxy resolve para um endereço público. Um proxy cujo host resolve apenas para endereços privados é permitido e não dispara esse erro | Adicione o host do gateway a `NO_PROXY` na máquina do desenvolvedor para que a conexão seja direta, ou use um proxy cujo nome do host resolve para endereços privados. A mensagem nomeia a entrada exata `NO_PROXY` a adicionar |

424| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | O gateway está em um bloco declarado em [`gatewayInternalNetworks`](https://code.claude.com/docs/pt/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), e a máquina do desenvolvedor o alcançou de um endereço fora desse bloco: um pool de endereços VPN, um segmento NAT de container ou WSL2, ou uma rede que não é sua | Peça ao desenvolvedor para executar `/login` do SO host em sua rede. Se o endereço mostrado também é espaço público da sua organização, substitua a entrada do gateway por um bloco que cubra ambos, até `/8`; uma segunda entrada sobreposta é recusada. Se nenhum bloco cobrir ambos, veja [Escolher um endereço para o gateway](#choose-an-address-for-the-gateway) |424| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | O gateway está em um bloco declarado em [`gatewayInternalNetworks`](https://code.claude.com/docs/pt/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), e a máquina do desenvolvedor o alcançou de um endereço fora desse bloco: um pool de endereços VPN, um segmento NAT de container ou WSL2, ou uma rede que não é sua | Peça ao desenvolvedor para executar `/login` do SO host em sua rede. Se o endereço mostrado também é espaço público da sua organização, substitua a entrada do gateway por um bloco que cubra ambos, até `/8`; uma segunda entrada sobreposta é recusada. Se nenhum bloco cobrir ambos, veja [Escolher um endereço para o gateway](#choose-an-address-for-the-gateway) |

36 36 

37Cada sessão na nuvem é executada em um [ambiente em nuvem](https://code.claude.com/docs/pt/cloud-environments.md), a configuração salva que controla acesso à rede, variáveis de ambiente e scripts de configuração.37Cada sessão na nuvem é executada em um [ambiente em nuvem](https://code.claude.com/docs/pt/cloud-environments.md), a configuração salva que controla acesso à rede, variáveis de ambiente e scripts de configuração.

38 38 

39* **Seu primeiro ambiente**: se você ainda não tem um, o onboarding configura um ambiente **Default** com [acesso à rede **Trusted**](https://code.claude.com/docs/pt/cloud-environments.md#access-levels), criando-o para você ou pedindo que você o crie. Veja [O ambiente Default](https://code.claude.com/docs/pt/cloud-environments.md#the-default-environment) para saber qual desses acontece no seu plano39* **Seu primeiro ambiente**: se você ainda não tem um, o onboarding configura um ambiente **Default** com [acesso à rede **Limited**](https://code.claude.com/docs/pt/cloud-environments.md#access-levels). Veja [O ambiente Default](https://code.claude.com/docs/pt/cloud-environments.md#the-default-environment) para saber como isso funciona no seu plano

40* **Qual ambiente uma sessão usa**: veja [O ambiente Default](https://code.claude.com/docs/pt/cloud-environments.md#the-default-environment) para saber como as sessões escolhem um ambiente quando você tem mais de um40* **Qual ambiente uma sessão usa**: veja [O ambiente Default](https://code.claude.com/docs/pt/cloud-environments.md#the-default-environment) para saber como as sessões escolhem um ambiente quando você tem mais de um

41* **Alterar o que as sessões podem acessar ou executar na inicialização**: veja [Configurar ambientes em nuvem](https://code.claude.com/docs/pt/cloud-environments.md)41* **Alterar o que as sessões podem acessar ou executar na inicialização**: veja [Configurar ambientes em nuvem](https://code.claude.com/docs/pt/cloud-environments.md)

42* **O que vem instalado sem nenhuma configuração**: veja [Ferramentas instaladas](https://code.claude.com/docs/pt/cloud-environments.md#installed-tools)42* **O que vem instalado sem nenhuma configuração**: veja [Ferramentas instaladas](https://code.claude.com/docs/pt/cloud-environments.md#installed-tools)

146* **Memória automática**: a varredura não deleta os arquivos de memória no diretório de [memória automática](https://code.claude.com/docs/pt/memory.md#auto-memory) de um projeto, `projects/<project>/memory/`. Claude Code remove esse diretório apenas se ele esteve vazio durante todo o período de retenção. Antes da v2.1.228, a varredura tratava pastas dentro do diretório de memória como dados de sessão e podia deletar arquivos antigos sob ele.146* **Memória automática**: a varredura não deleta os arquivos de memória no diretório de [memória automática](https://code.claude.com/docs/pt/memory.md#auto-memory) de um projeto, `projects/<project>/memory/`. Claude Code remove esse diretório apenas se ele esteve vazio durante todo o período de retenção. Antes da v2.1.228, a varredura tratava pastas dentro do diretório de memória como dados de sessão e podia deletar arquivos antigos sob ele.

147* **Transcrições de Claude Desktop e Cowork**: Claude Code mantém a transcrição de uma sessão que você iniciou ou continuou mais recentemente em Claude Desktop ou Cowork em qualquer idade. Para dar a essas transcrições um limite de idade, defina [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/pt/settings-reference#desktopsessioncleanupperioddays). Requer Claude Code v2.1.248 ou posterior; versões anteriores as deletam após `cleanupPeriodDays`.147* **Transcrições de Claude Desktop e Cowork**: Claude Code mantém a transcrição de uma sessão que você iniciou ou continuou mais recentemente em Claude Desktop ou Cowork em qualquer idade. Para dar a essas transcrições um limite de idade, defina [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/pt/settings-reference#desktopsessioncleanupperioddays). Requer Claude Code v2.1.248 ou posterior; versões anteriores as deletam após `cleanupPeriodDays`.

148 148 

149 Em vez disso, Claude Code deleta essas transcrições após `cleanupPeriodDays` em qualquer um destes casos:149 Em vez disso, Claude Code deleta essas transcrições após `cleanupPeriodDays` em casos como estes:

150 150 

151 * [Configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) definem `cleanupPeriodDays`151 * [Configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) definem `cleanupPeriodDays`

152 * A [configuração HIPAA se aplica às suas sessões](https://code.claude.com/docs/pt/hipaa-setup.md#check-how-developers-sign-in-and-connect)152 * A [configuração HIPAA se aplica às suas sessões](https://code.claude.com/docs/pt/hipaa-setup.md#check-how-developers-sign-in-and-connect)

170* **Linux**: `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, ou a mesma forma sob `$TMPDIR` quando seu sistema define um170* **Linux**: `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, ou a mesma forma sob `$TMPDIR` quando seu sistema define um

171* **Windows**: `%TEMP%\claude\<project>\<session-id>\scratchpad\`171* **Windows**: `%TEMP%\claude\<project>\<session-id>\scratchpad\`

172 172 

173`<project>` é o caminho do seu diretório de trabalho com cada caractere que não seja letra ou dígito substituído por `-`, como `-Users-you-my-project`. Se você definir [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/pt/env-vars), a árvore se move sob esse diretório em vez disso. Hooks recebem o caminho da sessão atual como [`scratchpad_dir`](https://code.claude.com/docs/pt/hooks#common-input-fields).173`<project>` é o caminho do seu diretório de trabalho com cada caractere que não seja letra ou dígito substituído por `-`, como `-Users-you-my-project`. No Windows, `<project>` é um hash de 16 caracteres dessa string, como `73295dabccd14c56`. Em uma sessão do aplicativo Desktop, pode ser a própria string. Para obter o caminho exato, pergunte a Claude. Se você definir [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/pt/env-vars), a árvore se move sob esse diretório em vez disso. Hooks recebem o caminho da sessão atual como [`scratchpad_dir`](https://code.claude.com/docs/pt/hooks#common-input-fields).

174 174 

175Arquivos do bloco de notas duram enquanto a transcrição da sessão: a [varredura de retenção](#cleaned-up-automatically) deleta o diretório quando deleta a transcrição, e [`claude purge`](#clear-local-data) não toca no diretório temporário. Como o diretório fica sob a localização temporária do sistema, seu sistema operacional também pode limpá-lo, como na reinicialização. Para manter algo que Claude escreveu lá, peça a Claude para movê-lo para seu projeto.175Arquivos do bloco de notas duram enquanto a transcrição da sessão: a [varredura de retenção](#cleaned-up-automatically) deleta o diretório quando deleta a transcrição, e [`claude purge`](#clear-local-data) não toca no diretório temporário. Como o diretório fica sob a localização temporária do sistema, seu sistema operacional também pode limpá-lo, como na reinicialização. Para manter algo que Claude escreveu lá, peça a Claude para movê-lo para seu projeto.

176 176 

8 8 

9Claude Platform on AWS é a API Claude operada pela Anthropic com autenticação AWS, controle de acesso IAM e faturamento do AWS Marketplace. As solicitações chegam diretamente à API da Anthropic, portanto você obtém os mesmos modelos e recursos de API que a [Claude API](https://platform.claude.com/docs) no mesmo cronograma de lançamento. Você se autentica com credenciais AWS ou uma chave de API do workspace, e paga através do AWS Marketplace.9Claude Platform on AWS é a API Claude operada pela Anthropic com autenticação AWS, controle de acesso IAM e faturamento do AWS Marketplace. As solicitações chegam diretamente à API da Anthropic, portanto você obtém os mesmos modelos e recursos de API que a [Claude API](https://platform.claude.com/docs) no mesmo cronograma de lançamento. Você se autentica com credenciais AWS ou uma chave de API do workspace, e paga através do AWS Marketplace.

10 10 

11Os recursos do lado do cliente que Claude Code ativa através do serviço de sinalizadores de recursos da Anthropic estão desativados por padrão, e a [ferramenta advisor](https://code.claude.com/docs/pt/advisor.md) não está disponível. Consulte a [matriz de disponibilidade de recursos](https://code.claude.com/docs/pt/feature-availability.md#summary-by-provider) para obter a lista completa.

12 

13Use este guia para apontar Claude Code para um workspace que você já provisionou através do Claude Platform on AWS. Para a assinatura AWS e configuração do workspace que vem antes disso, consulte a [documentação do Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).11Use este guia para apontar Claude Code para um workspace que você já provisionou através do Claude Platform on AWS. Para a assinatura AWS e configuração do workspace que vem antes disso, consulte a [documentação do Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).

14 12 

15> [!NOTE]13> [!NOTE]

16>14>

17> Assinar através do AWS Marketplace provisiona uma nova organização Anthropic vinculada à sua conta AWS. Esta organização é separada de qualquer organização que você já tenha com a Anthropic, e as credenciais não são transferidas entre elas. Use o ID do workspace e as chaves de API da organização vinculada ao AWS, não de uma conta Claude Console pré-existente.15> Assinar através do AWS Marketplace provisiona uma nova organização Anthropic vinculada à sua conta AWS. Esta organização é separada de qualquer organização que você já tenha com a Anthropic, e as credenciais não são transferidas entre elas. Use o ID do workspace e as chaves de API da organização vinculada ao AWS, não de uma conta Claude Console pré-existente.

18 16 

17Alguns recursos do Claude Code não estão disponíveis ou funcionam de forma diferente no Claude Platform on AWS. Consulte a [matriz de disponibilidade de recursos](https://code.claude.com/docs/pt/feature-availability.md#summary-by-provider) e os [recursos que precisam da busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching).

18 

19## Pré-requisitos19## Pré-requisitos

20 20 

21Antes de configurar Claude Code, você precisa de:21Antes de configurar Claude Code, você precisa de:

37 37 

38**Default** não carrega nenhuma configuração própria:38**Default** não carrega nenhuma configuração própria:

39 39 

40* [Acesso à rede **Trusted**](#access-levels): as sessões alcançam registros de pacotes e outros [domínios na lista de permissões](#default-allowed-domains), e nada mais através da rede da sessão.40* [Acesso à rede **Limited**](#access-levels): as sessões alcançam registros de pacotes e outros [domínios na allowlist](#default-allowed-domains).

41* Nenhuma outra configuração: **Default** não define variáveis de ambiente ou script de configuração, portanto as sessões começam apenas com as [ferramentas pré-instaladas](#installed-tools).41* Nenhuma outra configuração: **Default** não define variáveis de ambiente ou script de configuração, portanto as sessões começam apenas com as [ferramentas pré-instaladas](#installed-tools).

42 42 

43Com apenas **Default** disponível, cada sessão é executada nele. Quando você tem mais de um ambiente, as sessões escolhem um por superfície:43Com apenas **Default** disponível, cada sessão é executada nele. Quando você tem mais de um ambiente, as sessões escolhem um por superfície:

198 198 

199## Acesso à rede199## Acesso à rede

200 200 

201Cada ambiente define um nível de acesso à rede, que controla as conexões de saída que suas sessões podem fazer. O nível padrão, **Trusted**, permite registros de pacotes e outros [domínios na lista de permissões](#default-allowed-domains); **Custom** usa sua própria lista de domínios.201Cada ambiente define um nível de acesso à rede, que controla as conexões de saída que suas sessões podem fazer. Um novo ambiente começa em **Limited** com **Allow package managers** marcado, portanto suas sessões alcançam registros de pacotes e outros [domínios na allowlist](#default-allowed-domains).

202 202 

203Para alterar o acesso à rede de um ambiente, [abra-o para edição](#configure-your-environment) e use o seletor **Network access** no diálogo. Um [ambiente compartilhado](#organization-shared-environments) abre como somente leitura lá, portanto um Owner altera seu acesso à rede a partir da página **Cloud environments** nas [configurações de administrador](https://claude.ai/admin-settings). O controle que abre o seletor aparece nas superfícies do aplicativo listadas em [O ambiente Default](#the-default-environment) e no [editor de tarefas agendadas na nuvem](https://code.claude.com/docs/pt/routines.md#environments-and-network-access). Os ambientes pessoais não têm uma página separada nas configurações de sua conta claude.ai.203Para alterar o acesso à rede de um ambiente, [abra-o para edição](#configure-your-environment) e use o seletor **Network access** no diálogo. Um [ambiente compartilhado](#organization-shared-environments) abre como somente leitura lá, portanto um Owner altera seu acesso à rede a partir da página **Cloud environments** nas [configurações de administrador](https://claude.ai/admin-settings). O controle que abre o seletor aparece nas superfícies do aplicativo listadas em [O ambiente Default](#the-default-environment) e no [editor de tarefas agendadas na nuvem](https://code.claude.com/docs/pt/routines.md#environments-and-network-access). Os ambientes pessoais não têm uma página separada nas configurações de sua conta claude.ai.

204 204 

210 210 

211### Níveis de acesso211### Níveis de acesso

212 212 

213O campo **Network access** no [diálogo de ambiente](#configure-your-environment) usa um de quatro níveis:213O campo **Network access** no [diálogo de ambiente](#configure-your-environment) usa um de três níveis:

214 214 

215| Nível | Conexões de saída |215| Nível | Conexões de saída |

216| :- | :- |216| :- | :- |

217| **None** | Sem acesso à rede de saída através da rede da sessão |217| **None** | Sem acesso à rede de saída através da rede da sessão |

218| **Trusted** | [Domínios na lista de permissões](#default-allowed-domains) apenas: registros de pacotes, GitHub, SDKs na nuvem |218| **Limited** | A [allowlist padrão](#default-allowed-domains) de registros de pacotes, GitHub e SDKs na nuvem enquanto **Allow package managers** estiver marcado, mais quaisquer [domínios que você listar](#allow-specific-domains). Veja [como é uma requisição bloqueada](https://code.claude.com/docs/pt/errors.md#host-not-allowed-in-a-cloud-session). |

219| **Full** | Qualquer domínio |219| **Full** | Qualquer domínio |

220| **Custom** | Sua própria lista de permissões, opcionalmente incluindo os padrões |

221 220 

222Qualquer que seja o nível que você escolha, as sessões ainda podem alcançar estes, porque cada um usa um caminho que não passa pela lista de permissões de rede da sessão:221Qualquer que seja o nível que você escolha, as sessões ainda podem alcançar estes, porque cada um usa um caminho que não passa pela lista de permissões de rede da sessão:

223 222 

226* Os hosts que você listou nos [segredos de rede](#add-network-secrets) do ambiente, exceto os [hosts que nunca recebem o segredo](#requests-that-never-get-the-credential)225* Os hosts que você listou nos [segredos de rede](#add-network-secrets) do ambiente, exceto os [hosts que nunca recebem o segredo](#requests-that-never-get-the-credential)

227* A API Anthropic, para as próprias solicitações do Claude Code, até mesmo em **None**, conforme observado em [Segurança e isolamento](https://code.claude.com/docs/pt/claude-code-on-the-web.md#security-and-isolation)226* A API Anthropic, para as próprias solicitações do Claude Code, até mesmo em **None**, conforme observado em [Segurança e isolamento](https://code.claude.com/docs/pt/claude-code-on-the-web.md#security-and-isolation)

228 227 

228Um ambiente salvo como **Trusted** ou **Custom** continua alcançando os mesmos hosts e abre desta forma:

229 

230* **Salvo como Trusted**: abre como **Limited** com **Allow package managers** marcado

231* **Salvo como Custom**: abre como **Limited** com sua lista **Allowed domains** e **Allow package managers** conforme você os definiu, ou como **Full** se a lista continha um `*` isolado

232 

229### Permita domínios específicos233### Permita domínios específicos

230 234 

231Para permitir domínios que não estão na lista Trusted, selecione **Custom** nas configurações de acesso à rede do ambiente, depois liste um domínio por linha no campo **Allowed domains**. Este exemplo permite três hosts que um projeto interno pode precisar.235Para permitir domínios que não estão na [allowlist padrão](#default-allowed-domains), selecione **Limited** no seletor **Network access** do ambiente, depois liste um domínio por linha no campo **Allowed domains**. Um `*.` inicial corresponde a cada subdomínio. Este exemplo permite três hosts que um projeto interno pode precisar.

232 236 

233```text theme={null}237```text theme={null}

234api.example.com238api.example.com

236registry.example.com240registry.example.com

237```241```

238 242 

239As sessões neste ambiente agora podem alcançar `api.example.com`, qualquer subdomínio de `internal.example.com` e `registry.example.com`, e nenhum outro domínio através da rede da sessão. [Tráfego do GitHub](#github-proxy), [tráfego do conector MCP](#network-access) e requisições para os hosts dos [segredos de rede](#add-network-secrets) do ambiente, exceto os [hosts que nunca recebem o segredo](#requests-that-never-get-the-credential), não passam por essa allowlist. Um `*.` inicial corresponde a cada subdomínio. Para manter também os [domínios Trusted](#default-allowed-domains), marque **Also include default list of common package managers**; deixe desmarcado para permitir apenas o que você listar.243Enquanto **Allow package managers** estiver marcado, as sessões neste ambiente alcançam a [allowlist padrão](#default-allowed-domains), bem como os domínios que você listar. Desmarque a caixa de seleção para deixar a allowlist padrão de fora. [Tráfego do GitHub](#github-proxy), [tráfego do conector MCP](#network-access) e requisições para os hosts dos [segredos de rede](#add-network-secrets) do ambiente, exceto os [hosts que nunca recebem o segredo](#requests-that-never-get-the-credential), não passam por essa allowlist.

240 244 

241Se sua organização usa [artefatos](https://code.claude.com/docs/pt/artifacts.md#availability), você não precisa de `*.frame.claudeusercontent.com` na lista para as sessões lerem. Quando a lista deixa esse host de fora, Claude Code lê o conteúdo do artefato através da conexão da sessão com a Anthropic em vez disso. Mantenha o host em uma lista de permissões em duas situações:245Se sua organização usa [artefatos](https://code.claude.com/docs/pt/artifacts.md#availability), você não precisa de `*.frame.claudeusercontent.com` na lista para as sessões lerem. Quando a lista deixa esse host de fora, Claude Code lê o conteúdo do artefato através da conexão da sessão com a Anthropic em vez disso. Mantenha o host em uma lista de permissões em duas situações:

242 246 

243* **Sessões neste ambiente abrem artefatos públicos de outra organização**: Claude Code busca aqueles do host diretamente, portanto adicione-o a esta lista.247* **Sessões neste ambiente abrem artefatos públicos de outra organização**: Claude Code busca aqueles do host diretamente, portanto adicione-o a esta lista.

244* **Você está configurando a CLI local ou um executor auto-hospedado**: mantenha o host nessa lista de permissões. Veja [requisitos de acesso à rede](https://code.claude.com/docs/pt/network-config.md#network-access-requirements) e os [requisitos de rede](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#network-requirements) auto-hospedados.248* **Você está configurando a CLI local ou um executor auto-hospedado**: mantenha o host nessa lista de permissões. Veja [requisitos de acesso à rede](https://code.claude.com/docs/pt/network-config.md#network-access-requirements) e os [requisitos de rede](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#network-requirements) auto-hospedados.

245 249 

246Cada ambiente tem sua própria lista de domínios permitidos; não há uma lista de permissões no nível da organização que os administradores possam enviar para os ambientes de cada membro. Nenhuma [configuração gerenciada pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md) adiciona domínios à lista de permissões de rede do ambiente. Para dar a um time uma lista padrão, um Owner pode criar um [ambiente compartilhado pela organização](#organization-shared-environments) com acesso à rede **Custom** e essa lista.250Cada ambiente tem sua própria lista de domínios permitidos; não há uma allowlist no nível da organização que os administradores possam enviar para os ambientes de cada membro. Nenhuma [configuração gerenciada pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md) adiciona domínios à allowlist de rede de um ambiente também. Para dar a um time uma lista padrão, um Owner pode criar um [ambiente compartilhado pela organização](#organization-shared-environments) com acesso à rede **Limited** e essa lista.

247 251 

248### Proxy do GitHub252### Proxy do GitHub

249 253 

255* **Escopo do repositório**: o proxy atende requisições da API do GitHub para os repositórios anexados à sessão. Uma requisição de API para outro repositório recebe um 403 cuja mensagem começa com `GitHub access to` e contém `is not enabled for this session`. Um arquivo compactado do código-fonte que você busca por meio de uma URL `github.com/{owner}/{repo}/archive/` ou `codeload.github.com` recebe esse mesmo 403 quando o repositório não está anexado, mesmo que seja público.259* **Escopo do repositório**: o proxy atende requisições da API do GitHub para os repositórios anexados à sessão. Uma requisição de API para outro repositório recebe um 403 cuja mensagem começa com `GitHub access to` e contém `is not enabled for this session`. Um arquivo compactado do código-fonte que você busca por meio de uma URL `github.com/{owner}/{repo}/archive/` ou `codeload.github.com` recebe esse mesmo 403 quando o repositório não está anexado, mesmo que seja público.

256* **Restrições de GraphQL**: o proxy rejeita requisições ao endpoint de GraphQL do GitHub com um 403 cuja mensagem começa com `GitHub GraphQL is not available from Claude Code sessions` e nomeia o fallback REST, `gh api repos/{owner}/{repo}/...`. Os subcomandos `gh` que usam GraphQL, como `gh pr` e `gh issue`, recebem o mesmo 403. A restrição se aplica a cada requisição através do proxy independentemente das credenciais que você fornece, portanto um `GH_TOKEN` que você define recebe o mesmo 403. Claude não pode alcançar APIs do GitHub que existem apenas em GraphQL, como Projects v2, através do proxy.260* **Restrições de GraphQL**: o proxy rejeita requisições ao endpoint de GraphQL do GitHub com um 403 cuja mensagem começa com `GitHub GraphQL is not available from Claude Code sessions` e nomeia o fallback REST, `gh api repos/{owner}/{repo}/...`. Os subcomandos `gh` que usam GraphQL, como `gh pr` e `gh issue`, recebem o mesmo 403. A restrição se aplica a cada requisição através do proxy independentemente das credenciais que você fornece, portanto um `GH_TOKEN` que você define recebe o mesmo 403. Claude não pode alcançar APIs do GitHub que existem apenas em GraphQL, como Projects v2, através do proxy.

257 261 

258Os arquivos confirmados de repositórios públicos chegam através de `raw.githubusercontent.com`, que o [proxy de segurança](#security-proxy) manipula em vez disso. Esse domínio está na [lista Trusted](#default-allowed-domains) padrão, portanto esses arquivos permanecem acessíveis a menos que o [nível de acesso](#access-levels) do ambiente os exclua.262Os arquivos confirmados de repositórios públicos chegam através de `raw.githubusercontent.com`, que o [proxy de segurança](#security-proxy) manipula em vez disso. Esse domínio está na [allowlist padrão](#default-allowed-domains), portanto esses arquivos permanecem acessíveis desde que o [acesso à rede](#access-levels) do ambiente permita essa lista.

259 263 

260### Proxy de segurança264### Proxy de segurança

261 265 

391service redis-server start395service redis-server start

392```396```

393 397 

394Docker está disponível para executar serviços em contêiner. Peça a Claude para executar `docker compose up` para iniciar os serviços do seu projeto. O acesso à rede para puxar imagens segue o [nível de acesso](#access-levels) do seu ambiente, e os [padrões Trusted](#default-allowed-domains) incluem Docker Hub e outros registros comuns.398Docker está disponível para executar serviços em contêiner. Peça a Claude para executar `docker compose up` para iniciar os serviços do seu projeto. O acesso à rede para puxar imagens segue o [nível de acesso](#access-levels) do seu ambiente, e a [allowlist padrão](#default-allowed-domains) inclui Docker Hub e outros registros comuns.

395 399 

396Se suas imagens forem grandes ou lentas para puxar, adicione `docker compose pull` ou `docker compose build` ao seu [script de configuração](#setup-scripts). O [cache do ambiente](#environment-caching) mantém as imagens puxadas, portanto cada nova sessão as tem no disco. O cache armazena apenas arquivos, não processos em execução, portanto Claude ainda inicia os contêineres cada sessão.400Se suas imagens forem grandes ou lentas para puxar, adicione `docker compose pull` ou `docker compose build` ao seu [script de configuração](#setup-scripts). O [cache do ambiente](#environment-caching) mantém as imagens puxadas, portanto cada nova sessão as tem no disco. O cache armazena apenas arquivos, não processos em execução, portanto Claude ainda inicia os contêineres cada sessão.

397 401 

445 449 

446* **Saia com zero**: se o script sair com não-zero, a sessão [falha ao iniciar](https://code.claude.com/docs/pt/web-quickstart.md#setup-script-failed) ou inicia sem aquilo que o script não conseguiu instalar. Anexe `|| true` a comandos não críticos para que uma falha de instalação intermitente não faça o script falhar.450* **Saia com zero**: se o script sair com não-zero, a sessão [falha ao iniciar](https://code.claude.com/docs/pt/web-quickstart.md#setup-script-failed) ou inicia sem aquilo que o script não conseguiu instalar. Anexe `|| true` a comandos não críticos para que uma falha de instalação intermitente não faça o script falhar.

447* **Termine em cinco minutos**: mantenha o tempo de execução total do script em aproximadamente cinco minutos para que o [cache do ambiente](#environment-caching) possa ser construído. Quando a configuração leva mais tempo do que isso, o ambiente não é armazenado em cache. Execute instalações independentes em paralelo com `&` e `wait`, e mova qualquer download único que não se encaixe em um [hook SessionStart](#setup-scripts-vs-sessionstart-hooks) que o inicie em segundo plano. Se novas sessões travam ou expiram durante a configuração, veja [Novas sessões travam ou expiram durante a configuração](https://code.claude.com/docs/pt/web-quickstart.md#new-sessions-hang-or-time-out-during-setup).451* **Termine em cinco minutos**: mantenha o tempo de execução total do script em aproximadamente cinco minutos para que o [cache do ambiente](#environment-caching) possa ser construído. Quando a configuração leva mais tempo do que isso, o ambiente não é armazenado em cache. Execute instalações independentes em paralelo com `&` e `wait`, e mova qualquer download único que não se encaixe em um [hook SessionStart](#setup-scripts-vs-sessionstart-hooks) que o inicie em segundo plano. Se novas sessões travam ou expiram durante a configuração, veja [Novas sessões travam ou expiram durante a configuração](https://code.claude.com/docs/pt/web-quickstart.md#new-sessions-hang-or-time-out-during-setup).

448* **Acesso à rede para instalações**: as instalações de pacotes precisam alcançar registros. O nível **Trusted** padrão cobre [registros de pacotes comuns](#default-allowed-domains) incluindo npm, PyPI, RubyGems e crates.io; com acesso à rede **None**, as instalações falham.452* **Acesso à rede para instalações**: as instalações de pacotes precisam alcançar registros. O nível **Limited** padrão com **Allow package managers** marcado cobre [registros de pacotes comuns](#default-allowed-domains) incluindo npm, PyPI, RubyGems e crates.io. Com acesso à rede **None**, as instalações falham.

449* **As variáveis do ambiente ainda não estão definidas**: o script é executado antes de a sessão definir as [variáveis de ambiente](#set-environment-variables) do ambiente. Defina no próprio script qualquer valor de que o script precise.453* **As variáveis do ambiente ainda não estão definidas**: o script é executado antes de a sessão definir as [variáveis de ambiente](#set-environment-variables) do ambiente. Defina no próprio script qualquer valor de que o script precise.

450 454 

451### Cache do ambiente455### Cache do ambiente

541* **Um repositório por sessão**: em um ambiente hospedado pela Anthropic, uma sessão com vários repositórios não carrega hooks de nenhum `.claude/settings.json` do repositório, portanto um hook SessionStart que você define lá não é executado. Instale dependências para essas sessões com um [script de configuração](#setup-scripts) em vez disso. Para um ambiente auto-hospedado, veja [quais configurações do repositório se aplicam](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).545* **Um repositório por sessão**: em um ambiente hospedado pela Anthropic, uma sessão com vários repositórios não carrega hooks de nenhum `.claude/settings.json` do repositório, portanto um hook SessionStart que você define lá não é executado. Instale dependências para essas sessões com um [script de configuração](#setup-scripts) em vez disso. Para um ambiente auto-hospedado, veja [quais configurações do repositório se aplicam](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories).

542* **Não nas threads na nuvem de um projeto**: uma thread na nuvem em um [projeto](https://code.claude.com/docs/pt/claude-projects.md#what-threads-pick-up-from-your-repositories) não executa hooks do `.claude/settings.json` de um repositório, qualquer que seja o número de repositórios. Em um ambiente hospedado pela Anthropic, instale dependências para threads com um [script de configuração](#setup-scripts). Em um ambiente auto-hospedado, use um hook nas [configurações do host do executor](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories) em vez disso.546* **Não nas threads na nuvem de um projeto**: uma thread na nuvem em um [projeto](https://code.claude.com/docs/pt/claude-projects.md#what-threads-pick-up-from-your-repositories) não executa hooks do `.claude/settings.json` de um repositório, qualquer que seja o número de repositórios. Em um ambiente hospedado pela Anthropic, instale dependências para threads com um [script de configuração](#setup-scripts). Em um ambiente auto-hospedado, use um hook nas [configurações do host do executor](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories) em vez disso.

543* **Sem escopo apenas na nuvem**: os hooks são executados em sessões locais e na nuvem. Para pular a execução local, saia cedo a menos que a variável de ambiente `CLAUDE_CODE_REMOTE` seja `true`, da forma que o [script de instalação de dependência](#install-dependencies-with-a-sessionstart-hook) faz.547* **Sem escopo apenas na nuvem**: os hooks são executados em sessões locais e na nuvem. Para pular a execução local, saia cedo a menos que a variável de ambiente `CLAUDE_CODE_REMOTE` seja `true`, da forma que o [script de instalação de dependência](#install-dependencies-with-a-sessionstart-hook) faz.

544* **Requer acesso à rede**: os comandos de instalação precisam alcançar registros de pacotes. Se seu ambiente usa acesso à rede **None**, esses hooks falham. A [lista de permissões padrão](#default-allowed-domains) em **Trusted** cobre npm, PyPI, RubyGems e crates.io.548* **Requer acesso à rede**: os comandos de instalação precisam alcançar registros de pacotes. Se seu ambiente usa acesso à rede **None**, esses hooks falham. No nível **Limited** padrão com **Allow package managers** marcado, a [allowlist padrão](#default-allowed-domains) cobre npm, PyPI, RubyGems e crates.io.

545* **Compatibilidade de proxy**: em ambientes hospedados pela Anthropic, todo o tráfego de saída passa por um [proxy de segurança](#security-proxy), e alguns gerenciadores de pacotes não funcionam corretamente com isso; Bun é um exemplo conhecido. Em um [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#default-deny-egress), o tráfego de saída vai através de seu próprio limite de rede em vez disso.549* **Compatibilidade de proxy**: em ambientes hospedados pela Anthropic, todo o tráfego de saída passa por um [proxy de segurança](#security-proxy), e alguns gerenciadores de pacotes não funcionam corretamente com isso; Bun é um exemplo conhecido. Em um [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#default-deny-egress), o tráfego de saída vai através de seu próprio limite de rede em vez disso.

546* **Adiciona latência de inicialização**: os hooks são executados cada vez que uma sessão é iniciada ou retomada, ao contrário dos scripts de configuração que se beneficiam do [cache do ambiente](#environment-caching). Mantenha os scripts de instalação rápidos pulando o trabalho que já foi feito, da forma que o [script de instalação de dependência](#install-dependencies-with-a-sessionstart-hook) faz.550* **Adiciona latência de inicialização**: os hooks são executados cada vez que uma sessão é iniciada ou retomada, ao contrário dos scripts de configuração que se beneficiam do [cache do ambiente](#environment-caching). Mantenha os scripts de instalação rápidos pulando o trabalho que já foi feito, da forma que o [script de instalação de dependência](#install-dependencies-with-a-sessionstart-hook) faz.

547 551 

549 553 

550## Domínios permitidos padrão554## Domínios permitidos padrão

551 555 

552Com acesso à rede **Trusted**, as sessões podem alcançar os seguintes domínios por padrão. Os domínios marcados com `*` indicam correspondência de subdomínio curinga, portanto `*.gcr.io` permite qualquer subdomínio de `gcr.io`.556Quando **Allow package managers** está marcado no acesso à rede **Limited**, como acontece em um novo ambiente, as sessões podem alcançar os seguintes domínios. Os domínios marcados com `*` indicam correspondência de subdomínio curinga, portanto `*.gcr.io` permite qualquer subdomínio de `gcr.io`.

553 557 

554> [accordion] Serviços Anthropic558> [accordion] Serviços Anthropic

555>559>

65| `/bug [report]` | Relate um bug ou compartilhe sua conversa. Você escolhe quanto histórico de sessão incluir e confirma em uma tela de consentimento antes de qualquer coisa ser enviada. Quando você está conectado ao Anthropic em uma conexão de primeira parte, o relatório vai para Anthropic; em um provedor de terceiros, ou sem credenciais Anthropic, Claude Code escreve o relatório em um [arquivo local sob `~/.claude/feedback-bundles/`](https://code.claude.com/docs/pt/data-usage#telemetry-services) que você encaminha você mesmo. Na [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md#use-the-prompt-box), `/bug` abre o diálogo de feedback próprio da extensão; requer Claude Code v2.1.229 ou posterior. Quando você o executa enquanto Claude está respondendo, Claude Code abre o diálogo imediatamente. Antes da v2.1.232, Claude Code enfileirava o comando até que o turno terminasse. Alias: `/share`. Antes da v2.1.212, `/bug` e `/share` eram aliases de `/feedback` |65| `/bug [report]` | Relate um bug ou compartilhe sua conversa. Você escolhe quanto histórico de sessão incluir e confirma em uma tela de consentimento antes de qualquer coisa ser enviada. Quando você está conectado ao Anthropic em uma conexão de primeira parte, o relatório vai para Anthropic; em um provedor de terceiros, ou sem credenciais Anthropic, Claude Code escreve o relatório em um [arquivo local sob `~/.claude/feedback-bundles/`](https://code.claude.com/docs/pt/data-usage#telemetry-services) que você encaminha você mesmo. Na [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md#use-the-prompt-box), `/bug` abre o diálogo de feedback próprio da extensão; requer Claude Code v2.1.229 ou posterior. Quando você o executa enquanto Claude está respondendo, Claude Code abre o diálogo imediatamente. Antes da v2.1.232, Claude Code enfileirava o comando até que o turno terminasse. Alias: `/share`. Antes da v2.1.212, `/bug` e `/share` eram aliases de `/feedback` |

66| `/cd <path>` | Mova esta sessão para um novo diretório de trabalho, mantendo a conversa. Digite um caminho parcial para ver sugestões de diretório correspondentes; pressione `Tab` para aceitar uma. Para o que Claude Code aplica do novo diretório assim que você se move, e como `/cd` difere de `/add-dir`, consulte [Mova a sessão para outro diretório](https://code.claude.com/docs/pt/permissions.md#move-the-session-to-another-directory) |66| `/cd <path>` | Mova esta sessão para um novo diretório de trabalho, mantendo a conversa. Digite um caminho parcial para ver sugestões de diretório correspondentes; pressione `Tab` para aceitar uma. Para o que Claude Code aplica do novo diretório assim que você se move, e como `/cd` difere de `/add-dir`, consulte [Mova a sessão para outro diretório](https://code.claude.com/docs/pt/permissions.md#move-the-session-to-another-directory) |

67| `/chrome` | Configure as configurações de [Claude em Chrome](https://code.claude.com/docs/pt/chrome.md) |67| `/chrome` | Configure as configurações de [Claude em Chrome](https://code.claude.com/docs/pt/chrome.md) |

68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Carregue material de referência de [Claude API](https://platform.claude.com/docs/en/api/overview) e [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) para a linguagem do seu projeto. Também ativa automaticamente quando seu código importa `anthropic` ou `@anthropic-ai/sdk`. Para o que cada subcomando faz e a versão que requer, consulte [Trabalhe em projetos Claude API](https://code.claude.com/docs/pt/skills.md#work-on-claude-api-projects) |68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|latency-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Carregue material de referência de [Claude API](https://platform.claude.com/docs/en/api/overview) e [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) para a linguagem do seu projeto. Também ativa automaticamente quando seu código importa `anthropic` ou `@anthropic-ai/sdk`. Para o que cada subcomando faz e a versão que requer, consulte [Trabalhe em projetos Claude API](https://code.claude.com/docs/pt/skills.md#work-on-claude-api-projects) |

69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Tenha Claude executar uma tarefa no seu navegador, como testar uma página, preencher um formulário ou ler logs do console, através de [Claude em Chrome](https://code.claude.com/docs/pt/chrome.md). Disponível quando a integração do Chrome está ativada para a sessão, por exemplo com `claude --chrome`, ou quando Claude Code pode oferecer [instalar a extensão](https://code.claude.com/docs/pt/chrome.md#install-the-extension-when-claude-asks) |69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Tenha Claude executar uma tarefa no seu navegador, como testar uma página, preencher um formulário ou ler logs do console, através de [Claude em Chrome](https://code.claude.com/docs/pt/chrome.md). Disponível quando a integração do Chrome está ativada para a sessão, por exemplo com `claude --chrome`, ou quando Claude Code pode oferecer [instalar a extensão](https://code.claude.com/docs/pt/chrome.md#install-the-extension-when-claude-asks) |

70| `/clear [name]` | Inicie uma nova conversa com contexto vazio. Passe um nome para rotular a conversa anterior no seletor `/resume`. Para liberar contexto enquanto continua a mesma conversa, use `/compact` em vez disso. Retome a conversa anterior com `/resume`, ou, no mesmo processo Claude Code, restaure-a do [menu de retrocesso da entrada de sessão anterior](https://code.claude.com/docs/pt/checkpointing.md#rewind-past-a-cleared-conversation). Aliases: `/reset`, `/new` |70| `/clear [name]` | Inicie uma nova conversa com contexto vazio. Passe um nome para rotular a conversa anterior no seletor `/resume`. Para liberar contexto enquanto continua a mesma conversa, use `/compact` em vez disso. Retome a conversa anterior com `/resume`, ou, no mesmo processo Claude Code, restaure-a do [menu de retrocesso da entrada de sessão anterior](https://code.claude.com/docs/pt/checkpointing.md#rewind-past-a-cleared-conversation). Aliases: `/reset`, `/new` |

71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Revise o diff atual, ou um número de PR, branch ou caminho que você passa, para bugs de correção. Dependendo do seu modelo e nível de esforço, a revisão também cobre oportunidades de limpeza. Passe `--fix` para que Claude aplique as descobertas, `--comment` para postá-las no GitHub PR ou GitLab merge request, ou `ultra` para executar uma [revisão na nuvem](https://code.claude.com/docs/pt/ultrareview.md) profunda. Postar em um GitLab merge request requer Claude Code v2.1.257 ou posterior. Com `ultra` em um alvo de PR `github.com`, passe `--post` para pré-selecionar [postando as descobertas concluídas no PR](https://code.claude.com/docs/pt/ultrareview.md#post-findings-to-the-pull-request) no diálogo de inicialização; `--post` requer Claude Code v2.1.227 ou posterior. Consulte [Revise localmente com `/code-review`](https://code.claude.com/docs/pt/code-review-local) para os níveis de esforço, direcionamento e como se relaciona com `/simplify`. Alias: `/review` |71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Revise o diff atual, ou um número de PR, branch ou caminho que você passa, para bugs de correção. Dependendo do seu modelo e nível de esforço, a revisão também cobre oportunidades de limpeza. Passe `--fix` para que Claude aplique as descobertas, `--comment` para postá-las no GitHub PR ou GitLab merge request, ou `ultra` para executar uma [revisão na nuvem](https://code.claude.com/docs/pt/ultrareview.md) profunda. Postar em um GitLab merge request requer Claude Code v2.1.257 ou posterior. Com `ultra` em um alvo de PR `github.com`, passe `--post` para pré-selecionar [postando as descobertas concluídas no PR](https://code.claude.com/docs/pt/ultrareview.md#post-findings-to-the-pull-request) no diálogo de inicialização; `--post` requer Claude Code v2.1.227 ou posterior. Consulte [Revise localmente com `/code-review`](https://code.claude.com/docs/pt/code-review-local) para os níveis de esforço, direcionamento e como se relaciona com `/simplify`. Alias: `/review` |

466claude --worktree feature-auth466claude --worktree feature-auth

467```467```

468 468 

469Execute o mesmo comando com um nome diferente em um segundo terminal para iniciar uma sessão paralela isolada. Em um repositório sem commits, o comando falha com `Failed to resolve base branch "HEAD": git rev-parse failed`. Consulte [Worktrees](https://code.claude.com/docs/pt/worktrees.md) para limpeza, `.worktreeinclude` e suporte a VCS não-git. Para monitorar sessões paralelas de uma tela em vez de terminais separados, consulte [agentes em segundo plano](https://code.claude.com/docs/pt/agent-view.md).469Execute o mesmo comando com um nome diferente em um segundo terminal para iniciar uma sessão paralela isolada. Consulte [Worktrees](https://code.claude.com/docs/pt/worktrees.md) para limpeza, `.worktreeinclude` e suporte a VCS não-git. Para monitorar sessões paralelas de uma tela em vez de terminais separados, consulte [agentes em segundo plano](https://code.claude.com/docs/pt/agent-view.md).

470 470 

471## Planejar antes de editar471## Planejar antes de editar

472 472 

19 19 

20## O que sobrevive à compactação20## O que sobrevive à compactação

21 21 

22Quando uma sessão longa é compactada, Claude Code resume o histórico de conversa para caber na janela de contexto. A partir da v2.1.198, a requisição de resumo herda a configuração de [pensamento estendido](https://code.claude.com/docs/pt/model-config.md#extended-thinking) da sua sessão, portanto ela raciocina com o pensamento habilitado quando sua sessão o tem habilitado e permanece desativado caso contrário. O pensamento afeta apenas como o resumo é produzido; suas configurações de sessão permanecem inalteradas depois. O que acontece com cada tipo de conteúdo depende de como foi carregado:22Quando uma sessão longa é compactada, Claude Code resume o histórico de conversa para caber na janela de contexto.

23 23 

24| Mecanismo | Após compactação |24| Mecanismo | Após compactação |

25| :- | :- |25| :- | :- |

243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Defina como `1` para desativar as [skills](https://code.claude.com/docs/pt/skills.md) e os workflows incluídos com o Claude Code: skills e workflows incluídos são removidos completamente, enquanto comandos integrados como `/init` continuam podendo ser digitados, mas ficam ocultos do modelo. O `/doctor` continua podendo ser digitado, como os comandos integrados; oculte-o com `DISABLE_DOCTOR_COMMAND` em vez disso. Skills de plugins, `.claude/skills/` e `.claude/commands/` não são afetadas. Equivalente à configuração [`disableBundledSkills`](https://code.claude.com/docs/pt/settings-reference#disablebundledskills) |243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Defina como `1` para desativar as [skills](https://code.claude.com/docs/pt/skills.md) e os workflows incluídos com o Claude Code: skills e workflows incluídos são removidos completamente, enquanto comandos integrados como `/init` continuam podendo ser digitados, mas ficam ocultos do modelo. O `/doctor` continua podendo ser digitado, como os comandos integrados; oculte-o com `DISABLE_DOCTOR_COMMAND` em vez disso. Skills de plugins, `.claude/skills/` e `.claude/commands/` não são afetadas. Equivalente à configuração [`disableBundledSkills`](https://code.claude.com/docs/pt/settings-reference#disablebundledskills) |

244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Para hosts que incorporam o Claude Code e fornecem suas próprias orientações de navegador. Defina como `1` para manter as ferramentas de navegador do [Claude in Chrome](https://code.claude.com/docs/pt/chrome.md) disponíveis enquanto omite a seção do Chrome do system prompt e a [skill incluída](https://code.claude.com/docs/pt/skills.md#bundled-skills) `/claude-in-chrome`. No VS Code, a extensão na v2.1.314 ou posterior também deixa as instruções do Claude in Chrome fora das mensagens de uma sessão. Requer Claude Code v2.1.257 ou posterior |244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Para hosts que incorporam o Claude Code e fornecem suas próprias orientações de navegador. Defina como `1` para manter as ferramentas de navegador do [Claude in Chrome](https://code.claude.com/docs/pt/chrome.md) disponíveis enquanto omite a seção do Chrome do system prompt e a [skill incluída](https://code.claude.com/docs/pt/skills.md#bundled-skills) `/claude-in-chrome`. No VS Code, a extensão na v2.1.314 ou posterior também deixa as instruções do Claude in Chrome fora das mensagens de uma sessão. Requer Claude Code v2.1.257 ou posterior |

245| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Defina como `1` para impedir o carregamento de quaisquer arquivos de memória CLAUDE.md no contexto, incluindo arquivos de memória de usuário, de projeto e de memória automática |245| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Defina como `1` para impedir o carregamento de quaisquer arquivos de memória CLAUDE.md no contexto, incluindo arquivos de memória de usuário, de projeto e de memória automática |

246| `CLAUDE_CODE_DISABLE_CRON` | Defina como `1` para desativar as [tarefas agendadas com escopo de sessão](https://code.claude.com/docs/pt/scheduled-tasks.md). A skill `/loop` e as ferramentas de cron ficam indisponíveis e quaisquer tarefas já agendadas param de disparar, incluindo tarefas que já estão em execução no meio da sessão |246| `CLAUDE_CODE_DISABLE_CRON` | Defina como `1` para desativar as [tarefas agendadas com escopo de sessão](https://code.claude.com/docs/pt/scheduled-tasks.md#disable-scheduled-tasks). A skill `/loop` e `CronCreate` ficam indisponíveis e quaisquer tarefas já agendadas param de disparar, incluindo tarefas que já estão em execução no meio da sessão |

247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Defina como `1` para desativar o [limite de tempo e as negações](https://code.claude.com/docs/pt/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes) de `auto` e `bypassPermissions` em remoções de caminhos críticos. Essas remoções então vão para o classificador no modo `auto` e recebem um prompt sem limite de tempo no modo `bypassPermissions` sempre que o Claude Code puder mostrar um. Defina-a no ambiente que inicia o Claude Code, já que o Claude Code ignora uma cópia entregue por meio de um bloco `env` de configurações. Requer Claude Code v2.1.281 ou posterior |247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Defina como `1` para desativar o [limite de tempo e as negações](https://code.claude.com/docs/pt/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes) de `auto` e `bypassPermissions` em remoções de caminhos críticos. Essas remoções então vão para o classificador no modo `auto` e recebem um prompt sem limite de tempo no modo `bypassPermissions` sempre que o Claude Code puder mostrar um. Defina-a no ambiente que inicia o Claude Code, já que o Claude Code ignora uma cópia entregue por meio de um bloco `env` de configurações. Requer Claude Code v2.1.281 ou posterior |

248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Defina como `1` para remover das requisições da API os cabeçalhos de requisição `anthropic-beta` de pré-lançamento, os campos do corpo que os acompanham e os campos beta de schema de ferramentas, como `defer_loading` e `eager_input_streaming`. Use isso quando um gateway proxy rejeitar requisições com um erro `Unexpected value(s)` para o cabeçalho `anthropic-beta` ou um erro `Extra inputs are not permitted`. [Desativar recursos de pré-lançamento](https://code.claude.com/docs/pt/llm-gateway-protocol.md#disable-pre-release-capabilities) lista o que a variável remove, incluindo o [MCP Tool Search](https://code.claude.com/docs/pt/mcp.md#scale-with-mcp-tool-search), e o que o Claude Code continua enviando |248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Defina como `1` para remover das requisições da API os cabeçalhos de requisição `anthropic-beta` de pré-lançamento, os campos do corpo que os acompanham e os campos beta de schema de ferramentas, como `defer_loading` e `eager_input_streaming`. Use isso quando um gateway proxy rejeitar requisições com um erro `Unexpected value(s)` para o cabeçalho `anthropic-beta` ou um erro `Extra inputs are not permitted`. [Desativar recursos de pré-lançamento](https://code.claude.com/docs/pt/llm-gateway-protocol.md#disable-pre-release-capabilities) lista o que a variável remove, incluindo o [MCP Tool Search](https://code.claude.com/docs/pt/mcp.md#scale-with-mcp-tool-search), e o que o Claude Code continua enviando |

249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Defina como `1` para desativar os [subagentes Explore e Plan](https://code.claude.com/docs/pt/sub-agents.md#built-in-subagents) integrados. Em vez disso, o Claude explora com suas ferramentas de busca ou com o subagente de uso geral, e o [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode) lê arquivos diretamente em vez de iniciar agentes Explore e Plan. Subagentes personalizados chamados `Explore` ou `Plan` não são afetados. Para remover todos os tipos de subagente integrados no Agent SDK ou no modo não interativo, use `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` em vez disso. Requer Claude Code v2.1.198 ou posterior |249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Defina como `1` para desativar os [subagentes Explore e Plan](https://code.claude.com/docs/pt/sub-agents.md#built-in-subagents) integrados. Em vez disso, o Claude explora com suas ferramentas de busca ou com o subagente de uso geral, e o [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode) lê arquivos diretamente em vez de iniciar agentes Explore e Plan. Subagentes personalizados chamados `Explore` ou `Plan` não são afetados. Para remover todos os tipos de subagente integrados no Agent SDK ou no modo não interativo, use `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` em vez disso. Requer Claude Code v2.1.198 ou posterior |

250| `CLAUDE_CODE_DISABLE_FAST_MODE` | Defina como `1` para desativar o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) |250| `CLAUDE_CODE_DISABLE_FAST_MODE` | Defina como `1` para desativar o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) |

251| `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` | Defina como `1` para desativar a busca de feature flags. Requer o Claude Code v2.1.319 ou posterior. Com esta variável definida, o [Remote Control](https://code.claude.com/docs/pt/remote-control.md#requirements) e os outros [recursos que precisam da busca de feature flags](#features-that-need-feature-flag-fetching) ficam indisponíveis. O registro de eventos de telemetria permanece ativo, exceto se `DISABLE_TELEMETRY` também estiver definida. O nome antigo, `DISABLE_GROWTHBOOK`, ainda funciona, e é o único que as versões v2.1.124 a v2.1.318 leem |

251| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Defina como `1` para desativar as pesquisas de qualidade de sessão "How is Claude doing?". As pesquisas também são desativadas quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definida, a menos que `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` as reative. Para definir uma taxa de amostragem em vez de desativá-las completamente, use a configuração [`feedbackSurveyRate`](https://code.claude.com/docs/pt/settings-reference#feedbacksurveyrate). Consulte [Pesquisas de qualidade de sessão](https://code.claude.com/docs/pt/data-usage.md#session-quality-surveys) |252| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Defina como `1` para desativar as pesquisas de qualidade de sessão "How is Claude doing?". As pesquisas também são desativadas quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definida, a menos que `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` as reative. Para definir uma taxa de amostragem em vez de desativá-las completamente, use a configuração [`feedbackSurveyRate`](https://code.claude.com/docs/pt/settings-reference#feedbacksurveyrate). Consulte [Pesquisas de qualidade de sessão](https://code.claude.com/docs/pt/data-usage.md#session-quality-surveys) |

252| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Defina como `1` para desativar o [checkpointing](https://code.claude.com/docs/pt/checkpointing.md) de arquivos. O comando `/rewind` não poderá restaurar alterações de código. Sobrescreve a configuração [`fileCheckpointingEnabled`](https://code.claude.com/docs/pt/settings-reference#filecheckpointingenabled) |253| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Defina como `1` para desativar o [checkpointing](https://code.claude.com/docs/pt/checkpointing.md) de arquivos. O comando `/rewind` não poderá restaurar alterações de código. Sobrescreve a configuração [`fileCheckpointingEnabled`](https://code.claude.com/docs/pt/settings-reference#filecheckpointingenabled) |

253| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | Defina como `1` para impedir que o Claude Code expanda [menções com `@`](https://code.claude.com/docs/pt/common-workflows#reference-files-and-directories) de arquivos e diretórios. Em vez disso, o Claude recebe os caminhos mencionados com uma nota para lê-los usando suas ferramentas de arquivo. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.299 ou posterior |254| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | Defina como `1` para impedir que o Claude Code expanda [menções com `@`](https://code.claude.com/docs/pt/common-workflows#reference-files-and-directories) de arquivos e diretórios. Em vez disso, o Claude recebe os caminhos mencionados com uma nota para lê-los usando suas ferramentas de arquivo. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.299 ou posterior |

451| `DISABLE_ERROR_REPORTING` | Defina com qualquer valor não vazio, como `1`, para desativar o relatório de erros. **Defini-la como `0` ou `false` ainda desativa**, diferentemente da maioria das variáveis liga/desliga; remova a definição da variável para reativar o relatório de erros |452| `DISABLE_ERROR_REPORTING` | Defina com qualquer valor não vazio, como `1`, para desativar o relatório de erros. **Defini-la como `0` ou `false` ainda desativa**, diferentemente da maioria das variáveis liga/desliga; remova a definição da variável para reativar o relatório de erros |

452| `DISABLE_EXTRA_USAGE_COMMAND` | Defina como `1` para ocultar o comando `/usage-credits` que permite aos usuários comprar uso adicional além dos rate limits |453| `DISABLE_EXTRA_USAGE_COMMAND` | Defina como `1` para ocultar o comando `/usage-credits` que permite aos usuários comprar uso adicional além dos rate limits |

453| `DISABLE_FEEDBACK_COMMAND` | Defina como `1` para desativar o comando `/feedback` e o [feedback redigido pelo Claude](https://code.claude.com/docs/pt/tools-reference.md#sendfeedback-tool-behavior). Também desativa `/bug` e `/share`, que enviam relatórios pelo mesmo caminho; antes da v2.1.212 eles eram aliases de `/feedback`, portanto o comando era desativado sob todos os nomes. O nome mais antigo `DISABLE_BUG_COMMAND` também é aceito |454| `DISABLE_FEEDBACK_COMMAND` | Defina como `1` para desativar o comando `/feedback` e o [feedback redigido pelo Claude](https://code.claude.com/docs/pt/tools-reference.md#sendfeedback-tool-behavior). Também desativa `/bug` e `/share`, que enviam relatórios pelo mesmo caminho; antes da v2.1.212 eles eram aliases de `/feedback`, portanto o comando era desativado sob todos os nomes. O nome mais antigo `DISABLE_BUG_COMMAND` também é aceito |

454| `DISABLE_GROWTHBOOK` | Defina como `1` ou `true` para desativar a busca de feature flags e usar os padrões do código para todas as flags. Isso torna o [Remote Control](https://code.claude.com/docs/pt/remote-control.md#requirements) e os outros [recursos que precisam da busca de feature flags](#features-that-need-feature-flag-fetching) indisponíveis. Defini-la como `0` ou `false` mantém a busca ativada. O registro em log de eventos de telemetria permanece ativado, a menos que `DISABLE_TELEMETRY` também esteja definida |455| `DISABLE_GROWTHBOOK` | Defina como `1` para desativar a [busca de feature flags](#features-that-need-feature-flag-fetching). Requer Claude Code v2.1.124 ou posterior. Substituída por `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`, que requer v2.1.319 ou posterior: use esse nome, exceto quando uma máquina na v2.1.318 ou anterior ler a configuração. Este nome ainda funciona |

455| `DISABLE_INSTALLATION_CHECKS` | Defina como `1` para desativar avisos de instalação. Use apenas ao gerenciar manualmente o local de instalação, pois isso pode mascarar problemas com instalações padrão |456| `DISABLE_INSTALLATION_CHECKS` | Defina como `1` para desativar avisos de instalação. Use apenas ao gerenciar manualmente o local de instalação, pois isso pode mascarar problemas com instalações padrão |

456| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Defina como `1` para ocultar o comando `/install-github-app`. Já fica oculto ao usar provedores de terceiros (Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry) |457| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Defina como `1` para ocultar o comando `/install-github-app`. Já fica oculto ao usar provedores de terceiros (Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry) |

457| `DISABLE_INTERLEAVED_THINKING` | Defina como `1` para impedir o envio do cabeçalho beta de interleaved-thinking. Útil quando seu gateway de LLM ou provedor não oferece suporte a [pensamento intercalado](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |458| `DISABLE_INTERLEAVED_THINKING` | Defina como `1` para impedir o envio do cabeçalho beta de interleaved-thinking. Útil quando seu gateway de LLM ou provedor não oferece suporte a [pensamento intercalado](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

569 570 

570O Claude Code ativa alguns recursos por meio de feature flags que ele busca na Anthropic. O Claude Code ignora essa busca nestas sessões:571O Claude Code ativa alguns recursos por meio de feature flags que ele busca na Anthropic. O Claude Code ignora essa busca nestas sessões:

571 572 

572* Uma sessão em que você define `DISABLE_GROWTHBOOK`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`; a linha de cada variável na [tabela de variáveis](#variables) informa quais valores desativam a busca573* Uma sessão em que você define `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`; a linha de cada variável na [tabela de variáveis](#variables) informa quais valores desativam a busca

573* Uma sessão em um [provedor de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md), como Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud ou Microsoft Foundry, a menos que uma plataforma host que incorpora o Claude Code defina `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`574* Uma sessão em um [provedor de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md), como Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud ou Microsoft Foundry, a menos que uma plataforma host que incorpora o Claude Code defina `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`

574* Uma sessão do [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway)575* Uma sessão do [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway)

575 576 

576Com a busca desativada, você não pode:577Com a busca desativada, você não pode:

577 578 

578* Usar o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) com `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK` definidos. Para `DISABLE_TELEMETRY` e `DO_NOT_TRACK`, consulte os [requisitos do Remote Control](https://code.claude.com/docs/pt/remote-control.md#requirements)579* Usar o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) com `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](#variables) definidos. Para `DISABLE_TELEMETRY` e `DO_NOT_TRACK`, consulte os [requisitos do Remote Control](https://code.claude.com/docs/pt/remote-control.md#requirements)

579* [Enviar mensagens para sessões além desta máquina](https://code.claude.com/docs/pt/cross-session-messaging.md#message-sessions-on-other-machines) quando o [Remote Control](https://code.claude.com/docs/pt/remote-control.md#requirements) não estiver disponível. O envio de mensagens entre sessões nesta máquina funciona com a busca desativada580* [Enviar mensagens para sessões além desta máquina](https://code.claude.com/docs/pt/cross-session-messaging.md#message-sessions-on-other-machines) quando o [Remote Control](https://code.claude.com/docs/pt/remote-control.md#requirements) não estiver disponível. O envio de mensagens entre sessões nesta máquina funciona com a busca desativada

580* Executar [`claude import` ou o comando `/import`](https://code.claude.com/docs/pt/cli-reference#cli-commands)581* Executar [`claude import` ou o comando `/import`](https://code.claude.com/docs/pt/cli-reference#cli-commands)

581* Executar [`/skill-doctor`](https://code.claude.com/docs/pt/skills#find-unused-skills) ou abrir o relatório dele na aba **Stats** do `/plugin`582* Executar [`/skill-doctor`](https://code.claude.com/docs/pt/skills#find-unused-skills) ou abrir o relatório dele na aba **Stats** do `/plugin`

582* Executar [`/restart`](https://code.claude.com/docs/pt/commands) nos planos Pro, Max e Ultra583* Executar [`/restart`](https://code.claude.com/docs/pt/commands) nos planos Pro, Max e Ultra

583* Sincronizar as [skills](https://code.claude.com/docs/pt/skills.md#where-synced-skills-load) e os [plugins](https://code.claude.com/docs/pt/plugins/loading.md#synced-plugins) habilitados para sua conta do claude.ai nas suas sessões de terminal584* Sincronizar as [skills](https://code.claude.com/docs/pt/skills.md#where-synced-skills-load) e os [plugins](https://code.claude.com/docs/pt/plugins/loading.md#synced-plugins) habilitados para sua conta do claude.ai nas suas sessões de terminal

584* Ativar o [mod You should know](https://code.claude.com/docs/pt/interactive-mode.md#you-should-know-suggestions)585* Ativar o [mod You should know](https://code.claude.com/docs/pt/interactive-mode.md#you-should-know-suggestions)

585* Usar [a ferramenta advisor](https://code.claude.com/docs/pt/advisor.md#requirements)586* Usar [a ferramenta advisor](https://code.claude.com/docs/pt/advisor.md#requirements), exceto no Claude Platform on AWS com o Claude Code v2.1.300 ou posterior

586* Usar [tarefas MCP](https://code.claude.com/docs/pt/mcp.md#mcp-tasks-that-run-on-the-server)587* Usar [tarefas MCP](https://code.claude.com/docs/pt/mcp.md#mcp-tasks-that-run-on-the-server)

587* Ler ou responder a [comentários em um artefato](https://code.claude.com/docs/pt/artifacts.md#collect-comments-on-an-artifact)588* Ler ou responder a [comentários em um artefato](https://code.claude.com/docs/pt/artifacts.md#collect-comments-on-an-artifact)

588* Fazer o Claude ler [o artefato público de outra organização](https://code.claude.com/docs/pt/artifacts.md#read-an-artifact-shared-with-you)589* Fazer o Claude ler [o artefato público de outra organização](https://code.claude.com/docs/pt/artifacts.md#read-an-artifact-shared-with-you)

562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 500 | Atraso inicial em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 32000, para distribuir as novas tentativas por uma janela mais longa quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.292 ou posterior. |562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 500 | Atraso inicial em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 32000, para distribuir as novas tentativas por uma janela mais longa quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.292 ou posterior. |

563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 32000 | Teto em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 64000, para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.296 ou posterior. |563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/pt/env-vars) | 32000 | Teto em milissegundos do backoff entre novas tentativas de uma requisição que a API rejeita com um erro de sobrecarga `529`. Aumente-o, até 64000, para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite de capacidade. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definido como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.296 ou posterior. |

564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars) | 600000 | Tempo em milissegundos que cada tentativa de requisição tem para receber seus cabeçalhos de resposta. Não limita quanto tempo uma resposta de streaming dura depois disso. Aumente-o para redes lentas ou proxies. Para saber como ele limita o prazo de primeiro byte, veja [No response from API](#no-response-from-api). |564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars) | 600000 | Tempo em milissegundos que cada tentativa de requisição tem para receber seus cabeçalhos de resposta. Não limita quanto tempo uma resposta de streaming dura depois disso. Aumente-o para redes lentas ou proxies. Para saber como ele limita o prazo de primeiro byte, veja [No response from API](#no-response-from-api). |

565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/pt/env-vars) | não definido | Limite de reenvios de uma [requisição sem streaming](#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Ao atingir o limite, a requisição falha. Uma resposta do Claude que leva mais tempo que o timeout para ser gerada atinge o timeout novamente a cada reenvio, então defina um número baixo, como `0`, para falhar mais cedo. Cada tentativa sem streaming atinge o timeout após 300 segundos em uma sessão local, ou após `API_TIMEOUT_MS` quando você define um valor positivo. Requer Claude Code v2.1.285 ou posterior. |565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/pt/env-vars) | não definido | Limite de reenvios de uma [requisição sem streaming](#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Ao atingir o limite, a requisição falha. Uma resposta do Claude que leva mais tempo que o timeout para ser gerada atinge o timeout novamente a cada reenvio, então defina um número baixo, como `0`, para falhar mais cedo. Para o timeout de cada tentativa, veja [Quanto tempo uma tentativa sem streaming aguarda](#how-long-a-non-streaming-attempt-waits). Requer Claude Code v2.1.285 ou posterior. |

566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars) | não definido | Prazo em milissegundos para o primeiro byte de resposta de uma requisição de streaming. Requer Claude Code v2.1.242 ou posterior. Para saber como Claude Code escolhe o prazo quando esta variável não está definida, veja [No response from API](#no-response-from-api). |566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars) | não definido | Prazo em milissegundos para o primeiro byte de resposta de uma requisição de streaming. Requer Claude Code v2.1.242 ou posterior. Para saber como Claude Code escolhe o prazo quando esta variável não está definida, veja [No response from API](#no-response-from-api). |

567 567 

568#### Quanto tempo uma tentativa sem streaming aguarda

569 

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

571 

572* **Timeout de requisição**: `API_TIMEOUT_MS` quando você define um valor positivo, caso contrário 300 segundos em uma sessão local.

573* **[Timeout de inatividade do corpo](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs)**: 5 a 6 minutos sem uma resposta, não importa quão alto você defina `API_TIMEOUT_MS`, onde ele é executado e você não o desativou.

574 

568## Erros do servidor575## Erros do servidor

569 576 

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

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

2213 2220 

2214* **Tráfego do GitHub e de conectores**: [operações GitHub](https://code.claude.com/docs/pt/cloud-environments.md#github-proxy) e tráfego do conector MCP usam canais separados, é por isso que podem continuar funcionando enquanto outros hosts são bloqueados2221* **Tráfego do GitHub e de conectores**: [operações GitHub](https://code.claude.com/docs/pt/cloud-environments.md#github-proxy) e tráfego do conector MCP usam canais separados, é por isso que podem continuar funcionando enquanto outros hosts são bloqueados

2215* **Ambiente padrão**: o ambiente **Default** usa acesso **Trusted**, que permite a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) de registros de pacotes, APIs de provedores de nuvem, registros de contêiner, e domínios de desenvolvimento comuns e bloqueia outros domínios nesse caminho2222* **Ambiente padrão**: o ambiente **Default** usa acesso **Limited** com **Allow package managers** marcado. Suas sessões alcançam a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) de registros de pacotes, APIs de provedores de nuvem, registros de contêiner e domínios de desenvolvimento comuns.

2216 2223 

2217**O que fazer:**2224**O que fazer:**

2218 2225 

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

2220 2227 

2221* Abra seu ambiente para edição, ou a partir do [formulário da tarefa agendada na nuvem](https://code.claude.com/docs/pt/routines.md#environments-and-network-access) ou a partir do [seletor de ambiente](https://code.claude.com/docs/pt/cloud-environments.md#configure-your-environment) onde você inicia sessões na nuvem.2228* Abra seu ambiente para edição, ou a partir do [formulário da tarefa agendada na nuvem](https://code.claude.com/docs/pt/routines.md#environments-and-network-access) ou a partir do [seletor de ambiente](https://code.claude.com/docs/pt/cloud-environments.md#configure-your-environment) onde você inicia sessões na nuvem.

2222* No diálogo **Edit cloud environment**, altere **Network access** de **Trusted** para **Custom**, depois adicione o domínio bloqueado a **Allowed domains**. Digite um domínio por linha. Marque **Also include default list of common package managers** para manter a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) junto com seus domínios personalizados. Selecione **Full** em vez disso se você quiser acesso irrestrito.2229* No diálogo **Edit cloud environment**, selecione **Limited** em **Network access**, depois adicione o domínio bloqueado a **Allowed domains**. Digite um domínio por linha. Marque **Allow package managers** para permitir a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) junto com seus próprios domínios. Selecione **Full** em vez disso se você quiser acesso irrestrito.

2223* Clique em **Save changes**. A próxima execução usa a allowlist atualizada. Para uma sessão na nuvem que já está aberta, veja [quando uma mudança de acesso de rede alcança sessões existentes](https://code.claude.com/docs/pt/cloud-environments.md#network-access).2230* Clique em **Save changes**. A próxima execução usa a allowlist atualizada. Para uma sessão na nuvem que já está aberta, veja [quando uma mudança de acesso de rede alcança sessões existentes](https://code.claude.com/docs/pt/cloud-environments.md#network-access).

2224 2231 

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

2342**O que fazer:**2349**O que fazer:**

2343 2350 

2344* **Não autenticado**: a mensagem continua com `: not signed in. Run /login, then retry.` Execute `/login` e envie novamente2351* **Não autenticado**: a mensagem continua com `: not signed in. Run /login, then retry.` Execute `/login` e envie novamente

2345* **Recusa da sua organização**: por exemplo `: Feedback has not been enabled for your organization.` ou `: Feedback collection is not available for organizations with custom data retention policies.` Se a mensagem acrescentar `To report a bug, open an issue`, faça isso em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Depois disso, `/feedback` pode responder que está [desativado pela política da sua organização](#feedback-is-disabled-by-your-organizations-policy) por sete dias. Um rascunho na fila permanece na fila e ainda [expira conforme o previsto](https://code.claude.com/docs/pt/tools-reference.md#discard-or-keep-a-draft)2352* **Recusa da sua organização**: por exemplo `: Feedback has not been enabled for your organization.` ou `: Feedback collection is not available for organizations with custom data retention policies.` `/feedback` pode então responder que está [desativado pela política da sua organização](#feedback-is-disabled-by-your-organizations-policy) por sete dias. Um rascunho na fila permanece na fila e ainda [expira conforme o previsto](https://code.claude.com/docs/pt/tools-reference.md#discard-or-keep-a-draft)

2346* **Credenciais recusadas**: a mensagem continua com `: the sign-in this session uses is not allowed to send feedback` ou `: the server did not accept the credentials this session uses`. Execute `/status` no prompt do Claude Code para ver qual login, token ou chave de API esta sessão envia2353* **Credenciais recusadas**: a mensagem continua com `: the sign-in this session uses is not allowed to send feedback` ou `: the server did not accept the credentials this session uses`. Execute `/status` no prompt do Claude Code para ver qual login, token ou chave de API esta sessão envia

2347* **`(request timed out)` ou `(couldn't reach the service)` logo após `Couldn't send feedback`**: envie o relatório ou o rascunho na fila novamente. O diálogo mantém seu texto, e a mensagem de um rascunho na fila diz `The draft is still queued.` Se outras requisições também estiverem falhando, verifique sua conexão de rede e veja [Unable to connect to API](#unable-to-connect-to-api). Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2354* **`(request timed out)` ou `(couldn't reach the service)` logo após `Couldn't send feedback`**: envie o relatório ou o rascunho na fila novamente. O diálogo mantém seu texto, e a mensagem de um rascunho na fila diz `The draft is still queued.` Se outras requisições também estiverem falhando, verifique sua conexão de rede e veja [Unable to connect to API](#unable-to-connect-to-api). Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

2348* **`(server returned <status>)`, ou nenhum motivo, logo após `Couldn't send feedback`**: o status é o código de resposta do serviço. A própria mensagem do serviço vem depois dele quando foi enviada, como em `(server returned 403: Access Forbidden)`. Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2355* **`(server returned <status>)`, ou nenhum motivo, logo após `Couldn't send feedback`**: o status é o código de resposta do serviço. A própria mensagem do serviço vem depois dele quando foi enviada, como em `(server returned 403: Access Forbidden)`. Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

3492* **`Error: Workspace not trusted. <folder> is your home directory`**: como a confiança para seu diretório pessoal nunca é salva, executar `claude` ali primeiro não ajuda. Execute `claude ultrareview` a partir de um diretório de projeto, depois de executar `claude` ali uma vez para aceitar a caixa de diálogo de confiança, ou acrescente `--trust-workspace`.3499* **`Error: Workspace not trusted. <folder> is your home directory`**: como a confiança para seu diretório pessoal nunca é salva, executar `claude` ali primeiro não ajuda. Execute `claude ultrareview` a partir de um diretório de projeto, depois de executar `claude` ali uma vez para aceitar a caixa de diálogo de confiança, ou acrescente `--trust-workspace`.

3493* **`No answer in time.` seguido de `Error: Workspace not trusted`**: a pergunta `Trust <folder>? [y/N]` ficou sem resposta por 5 minutos. Execute `claude ultrareview` novamente e responda.3500* **`No answer in time.` seguido de `Error: Workspace not trusted`**: a pergunta `Trust <folder>? [y/N]` ficou sem resposta por 5 minutos. Execute `claude ultrareview` novamente e responda.

3494* **`Ultrareview did not start: <folder> is not trusted`**: você recusou na pergunta `Trust <folder>? [y/N]`, por exemplo respondendo `n` ou pressionando Enter. Para iniciar a revisão, execute `claude ultrareview` novamente e responda `y`.3501* **`Ultrareview did not start: <folder> is not trusted`**: você recusou na pergunta `Trust <folder>? [y/N]`, por exemplo respondendo `n` ou pressionando Enter. Para iniciar a revisão, execute `claude ultrareview` novamente e responda `y`.

3495* **``Ultrareview did not start: `--trust-workspace` takes no value``**: algo que não é uma flag vem depois de `--trust-workspace`, como um número de PR ou `false`. Se você não confia na pasta, omita a flag. Para confiar nela durante esta execução, coloque o número do PR ou o branch base antes da flag: `claude ultrareview 1234 --trust-workspace`.3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**: algo que não é uma flag vem depois de `--trust-workspace`, como um número de PR ou `false`. Se você não confia na pasta, omita a flag. Para confiar nela nesta execução, coloque o número do PR ou o branch base antes da flag: `claude ultrareview 1234 --trust-workspace`.

3496 3503 

3497Antes da v2.1.309, `claude ultrareview` não aceitava `--trust-workspace`.3504Antes da v2.1.309, `claude ultrareview` não aceitava `--trust-workspace`.

3498 3505 

3557 3564 

3558* Você não iniciou uma sessão desde a instalação, então o Claude Code ainda não buscou a flag. O primeiro `claude import` pode imprimir isso mesmo quando o recurso está disponível para você.3565* Você não iniciou uma sessão desde a instalação, então o Claude Code ainda não buscou a flag. O primeiro `claude import` pode imprimir isso mesmo quando o recurso está disponível para você.

3559* Você usa o Claude Code por meio do Amazon Bedrock, do Agent Platform do Google Cloud, do Microsoft Foundry ou do Claude Platform on AWS, ou por meio de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway#availability-and-limitations). O Claude Code não busca feature flags nessas sessões, então `claude import` permanece indisponível.3566* Você usa o Claude Code por meio do Amazon Bedrock, do Agent Platform do Google Cloud, do Microsoft Foundry ou do Claude Platform on AWS, ou por meio de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway#availability-and-limitations). O Claude Code não busca feature flags nessas sessões, então `claude import` permanece indisponível.

3560* Você definiu `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` ou [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/pt/env-vars), que desativam a busca de feature flags, então `claude import` permanece indisponível.3567* Você definiu `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/pt/env-vars#variables), `DISABLE_GROWTHBOOK` ou [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/pt/env-vars), que desativam a busca de feature flags, então `claude import` permanece indisponível.

3561 3568 

3562**O que fazer:**3569**O que fazer:**

3563 3570 

6615 6622 

6616**2. Atualize todos os hosts que compartilham o diretório pessoal**6623**2. Atualize todos os hosts que compartilham o diretório pessoal**

6617 6624 

6618Se vários hosts compartilham este diretório pessoal, primeiro atualize Claude Code em todos os hosts para a versão que a mensagem nomeia ou posterior. Uma versão mais antiga pode escrever de volta um `.config.json` movido.6625Se vários hosts compartilham este diretório pessoal, primeiro atualize Claude Code em todos os hosts para a versão que a mensagem nomeia ou posterior.

6619 6626 

6620**3. Pare Claude Code**6627**3. Pare Claude Code**

6621 6628 

112 <td>✓</td>112 <td>✓</td>

113 <td>✓</td>113 <td>✓</td>

114 <td>✗</td>114 <td>✗</td>

115 <td>✗</td>115 <td>✓ (Claude Code v2.1.300 ou posterior)</td>

116 <td>✗</td>116 <td>✗</td>

117 <td>✗</td>117 <td>✗</td>

118 </tr>118 </tr>

221 221 

222> [!NOTE]222> [!NOTE]

223>223>

224> Se você se autenticar através de um [LLM gateway](https://code.claude.com/docs/pt/llm-gateway), a disponibilidade de recursos corresponde ao provedor subjacente para o qual o gateway encaminha, exceto pelos recursos que o Claude Code desativa. Sempre que `ANTHROPIC_BASE_URL` aponta para um host diferente de `api.anthropic.com`, Claude Code desativa recursos como [Remote Control](https://code.claude.com/docs/pt/remote-control.md#requirements) e [server-managed settings](https://code.claude.com/docs/pt/server-managed-settings.md#platform-availability), independentemente do que o gateway encaminha. Alguns recursos exclusivos da Anthropic, como o [Advisor](https://code.claude.com/docs/pt/advisor.md), funcionam apenas se o gateway encaminha solicitações intactas para a API Anthropic.224> Se você se autenticar através de um [LLM gateway](https://code.claude.com/docs/pt/llm-gateway), a disponibilidade de recursos corresponde ao provedor subjacente para o qual o gateway encaminha, exceto pelos recursos que o Claude Code desativa. Sempre que `ANTHROPIC_BASE_URL` aponta para um host diferente de `api.anthropic.com`, Claude Code desativa recursos como [Remote Control](https://code.claude.com/docs/pt/remote-control.md#requirements) e [server-managed settings](https://code.claude.com/docs/pt/server-managed-settings.md#platform-availability), independentemente do que o gateway encaminha. Alguns recursos, como o [Advisor](https://code.claude.com/docs/pt/advisor.md#requirements), funcionam apenas se o gateway encaminha as requisições intactas.

225>225>

226> Para como as solicitações que Claude Code envia diferem entre um gateway no formato Amazon Bedrock ou Agent Platform, um gateway `ANTHROPIC_BASE_URL` e um login de gateway de aplicativos Claude, consulte [comportamento do cliente por método de conexão](https://code.claude.com/docs/pt/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior).226> Para como as solicitações que Claude Code envia diferem entre um gateway no formato Amazon Bedrock ou Agent Platform, um gateway `ANTHROPIC_BASE_URL` e um login de gateway de aplicativos Claude, consulte [comportamento do cliente por método de conexão](https://code.claude.com/docs/pt/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior).

227 227 

244 244 

245> [tab] Claude Platform on AWS245> [tab] Claude Platform on AWS

246>246>

247> **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [fast mode](https://code.claude.com/docs/pt/fast-mode.md), [Advisor](https://code.claude.com/docs/pt/advisor.md), [Channels](https://code.claude.com/docs/pt/channels.md), [GitHub Actions](https://code.claude.com/docs/pt/github-actions.md), o [dashboard de análise](https://code.claude.com/docs/pt/analytics.md), [server-managed settings](https://code.claude.com/docs/pt/server-managed-settings.md) e os [comandos `/design-sync` e `/import`](https://code.claude.com/docs/pt/commands#all-commands).247> **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [fast mode](https://code.claude.com/docs/pt/fast-mode.md), [Channels](https://code.claude.com/docs/pt/channels.md), [GitHub Actions](https://code.claude.com/docs/pt/github-actions.md), o [dashboard de análise](https://code.claude.com/docs/pt/analytics.md), [server-managed settings](https://code.claude.com/docs/pt/server-managed-settings.md) e os [comandos `/design-sync` e `/import`](https://code.claude.com/docs/pt/commands#all-commands).

248>248>

249> **Disponível onde Amazon Bedrock não é:** [web search](https://code.claude.com/docs/pt/tools-reference.md#websearch-tool-behavior).249> **Disponível aqui, mas não no Amazon Bedrock:** [web search](https://code.claude.com/docs/pt/tools-reference.md#websearch-tool-behavior), além do [Advisor](https://code.claude.com/docs/pt/advisor.md) no Claude Code v2.1.300 ou posterior.

250>250>

251> **Suporte parcial:**251> **Suporte parcial:**

252>252>

54 54 

55### Auto mode55### Auto mode

56 56 

57Um [permission mode](#permission-mode) onde um modelo classificador separado revisa ações em vez de você, para que Claude Code execute a maioria delas sem solicitar você. Claude Code ainda solicita você antes de ações que suas regras de solicitação explícita correspondem. O classificador bloqueia escalação de escopo, infraestrutura não confiável e [prompt injection](#prompt-injection). Os resultados de tool são removidos do que ele vê, para que conteúdo hostil em um arquivo ou página web não possa manipulá-lo diretamente.57Um [modo de permissão](#permission-mode) onde um modelo classificador separado revisa ações em vez de você, para que Claude Code execute a maioria delas sem pedir sua confirmação. Claude Code ainda pede sua confirmação antes de ações que correspondem às suas regras ask explícitas. O classificador bloqueia escalação de escopo, infraestrutura não confiável e [injeção de prompt](#prompt-injection).

58 58 

59* **Claude Code v2.1.283 ou posterior**: auto mode é o [built-in starting permission mode](https://code.claude.com/docs/pt/permission-modes.md#which-mode-a-session-starts-in) para sessões interativas de terminal e VS Code59* **Claude Code v2.1.283 ou posterior**: auto mode é o [built-in starting permission mode](https://code.claude.com/docs/pt/permission-modes.md#which-mode-a-session-starts-in) para sessões interativas de terminal e VS Code

60* **Versões anteriores**: auto mode é o modo de permissão inicial integrado apenas nos planos Pro, Max, Ultra e Team60* **Versões anteriores**: auto mode é o modo de permissão inicial integrado apenas nos planos Pro, Max, Ultra e Team

261 261 

262### Prompt injection262### Prompt injection

263 263 

264Instruções hostis incorporadas em um arquivo, página web ou resultado de tool que tentam redirecionar Claude para ações que você nunca pediu. As defesas do Claude Code incluem o sistema de permissões, detecção de injeção de comando e verificação de confiança. [Auto mode](#auto-mode) adiciona uma sonda do lado do servidor que escaneia resultados de tool para conteúdo suspeito e um classificador que revisa ações com resultados de tool removidos, então texto injetado não pode manipulá-lo diretamente.264Instruções hostis incorporadas em um arquivo, página web ou resultado de tool que tentam redirecionar Claude para ações que você não pediu. As defesas do Claude Code incluem o sistema de permissões, detecção de injeção de comando e verificação de confiança. No [modo auto](#auto-mode), uma sonda do lado do servidor escaneia resultados de ferramentas em busca de conteúdo suspeito, e um classificador revisa as ações.

265 265 

266Saiba mais: [Proteja-se contra prompt injection](https://code.claude.com/docs/pt/security.md#protect-against-prompt-injection)266Saiba mais: [Proteja-se contra prompt injection](https://code.claude.com/docs/pt/security.md#protect-against-prompt-injection)

267 267 

2341 2341 

2342#### Anotar um resultado para o classificador do modo auto2342#### Anotar um resultado para o classificador do modo auto

2343 2343 

2344Retorne `classifierContext` para enviar uma nota curta sobre o resultado da chamada de ferramenta ao classificador do [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode), e não ao Claude. O classificador [nunca recebe os próprios resultados das ferramentas](https://code.claude.com/docs/pt/permission-modes.md#how-the-classifier-evaluates-actions), então este campo é a forma suportada de informar algo sobre o que uma chamada retornou antes que ele revise as ações seguintes. O campo requer Claude Code v2.1.236 ou posterior.2344Retorne `classifierContext` para enviar uma nota curta sobre o resultado da chamada de ferramenta ao classificador do [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) em vez de ao Claude. A nota serve para a revisão de ações posteriores pelo classificador. O campo requer Claude Code v2.1.236 ou posterior.

2345 2345 

2346O exemplo abaixo informa ao classificador de onde veio a saída de uma consulta:2346O exemplo abaixo informa ao classificador de onde veio a saída de uma consulta:

2347 2347 

47 47 

48Enquanto uma [variável de credencial de gateway](https://code.claude.com/docs/pt/llm-gateway-connect.md#set-the-credential-variable) ou `apiKeyHelper` está ativa, as solicitações carregam essa credencial no lugar do login de assinatura claude.ai de um desenvolvedor, e os limites de uso da assinatura não se aplicam a elas. Claude Code mantém um login claude.ai salvo na máquina, mas não o envia com essas solicitações. Esse tráfego é cobrado por token para quem quer que possua a credencial que o gateway encaminha, como sua conta Anthropic Console da organização, ou sua conta Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry quando o gateway roteia para lá.48Enquanto uma [variável de credencial de gateway](https://code.claude.com/docs/pt/llm-gateway-connect.md#set-the-credential-variable) ou `apiKeyHelper` está ativa, as solicitações carregam essa credencial no lugar do login de assinatura claude.ai de um desenvolvedor, e os limites de uso da assinatura não se aplicam a elas. Claude Code mantém um login claude.ai salvo na máquina, mas não o envia com essas solicitações. Esse tráfego é cobrado por token para quem quer que possua a credencial que o gateway encaminha, como sua conta Anthropic Console da organização, ou sua conta Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry quando o gateway roteia para lá.

49 49 

50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/llm-gateway-connect#set-the-base-url-and-credential) é a variável que aponta Claude Code para o gateway. Definir apenas essa variável, sem uma credencial de gateway, não substitui a assinatura. As solicitações ainda roteiam através do gateway, mas um login claude.ai salvo permanece como a credencial ativa, então seus limites de uso e cobrança se aplicam. Gateways que passam esse tráfego para Anthropic devem encaminhar a capacidade OAuth em `anthropic-beta`; consulte a [referência de cabeçalhos de solicitação](https://code.claude.com/docs/pt/llm-gateway-protocol.md#request-headers).50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/llm-gateway-connect#set-the-base-url-and-credential) é a variável que aponta Claude Code para o gateway. Definir apenas essa variável, sem uma credencial de gateway, não substitui a assinatura. As solicitações ainda roteiam através do gateway, mas um login claude.ai salvo permanece como a credencial ativa, então seus limites de uso e cobrança se aplicam. Gateways que passam esse tráfego para Anthropic devem encaminhar `Authorization` e a capacidade OAuth em `anthropic-beta`; consulte a [referência de cabeçalhos de solicitação](https://code.claude.com/docs/pt/llm-gateway-protocol.md#request-headers).

51 51 

52## Páginas relacionadas52## Páginas relacionadas

53 53 

40 40 

41| Formato | Selecionado por | Endpoints | Encaminhar inalterado |41| Formato | Selecionado por | Endpoints | Encaminhar inalterado |

42| :- | :- | :- | :- |42| :- | :- | :- | :- |

43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (opcional) | headers de requisição `anthropic-beta` e `anthropic-version` |43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (opcional) | headers de requisição `anthropic-beta` e `anthropic-version`, além de `Authorization` quando um [login do claude.ai](#request-headers) autentica a requisição para a Anthropic |

44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` com `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (opcional) | campos de corpo de requisição `anthropic_beta` e `anthropic_version` |44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` com `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (opcional) | campos de corpo de requisição `anthropic_beta` e `anthropic_version` |

45| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` com `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (opcional) | headers de requisição `anthropic-beta` e `anthropic-version`, e o campo de corpo de requisição `anthropic_version` |45| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` com `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (opcional) | headers de requisição `anthropic-beta` e `anthropic-version`, e o campo de corpo de requisição `anthropic_version` |

46 46 

115 115 

116## Headers de solicitação116## Headers de solicitação

117 117 

118Claude Code inclui esses headers em solicitações de API. Nomes de headers não diferenciam maiúsculas de minúsculas no fio. Encaminhe `anthropic-version` e `anthropic-beta` inalterados, mais `anthropic-workspace-id` quando o upstream é a [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md); o resto o gateway pode consumir para roteamento, atribuição e rastreamento, e não precisa encaminhar.118Claude Code inclui esses headers em requisições de API. Nomes de headers não diferenciam maiúsculas de minúsculas no fio. Encaminhe `anthropic-version` e `anthropic-beta` inalterados, mais `anthropic-workspace-id` quando o upstream é a [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md). Encaminhe também `Authorization` quando seu gateway se autentica na Anthropic com o login claude.ai do desenvolvedor e não com uma chave própria. O resto o gateway pode consumir para roteamento, atribuição e rastreamento, e não precisa encaminhar.

119 119 

120| Header | Descrição |120| Header | Descrição |

121| :- | :- |121| :- | :- |

122| `Authorization`, `x-api-key` | A credencial do gateway do desenvolvedor, em um ou ambos os headers dependendo de qual [variável de credencial](https://code.claude.com/docs/pt/llm-gateway-connect.md#set-the-credential-variable) eles definiram |122| `Authorization`, `x-api-key` | A credencial do gateway do desenvolvedor, em um ou ambos os headers dependendo de qual [variável de credencial](https://code.claude.com/docs/pt/llm-gateway-connect.md#set-the-credential-variable) eles definiram. Com um login claude.ai e sem credencial de gateway, `Authorization` carrega o token do login |

123| `anthropic-version` | Versão da API, atualmente `2023-06-01`. Solicitações no formato Amazon Bedrock e Agent Platform do Google Cloud também carregam o campo de corpo `anthropic_version`, cujo valor é a string de dialeto do provedor, não o valor deste header |123| `anthropic-version` | Versão da API, atualmente `2023-06-01`. Solicitações no formato Amazon Bedrock e Agent Platform do Google Cloud também carregam o campo de corpo `anthropic_version`, cujo valor é a string de dialeto do provedor, não o valor deste header |

124| `anthropic-beta` | Valores de capacidade separados por vírgula para a solicitação. Encaminhe o header verbatim; não faça uma lista de permissões de valores individuais, porque o conjunto muda com lançamentos de Claude Code. Quando o desenvolvedor se autentica com um login claude.ai, que é possível quando `ANTHROPIC_BASE_URL` é definido sem uma variável de credencial de gateway, este header também carrega uma capacidade OAuth que o upstream requer, e removê-lo falha essas solicitações com `401` |124| `anthropic-beta` | Valores de capacidade separados por vírgula para a solicitação. Encaminhe o header verbatim; não faça uma lista de permissões de valores individuais, porque o conjunto muda com lançamentos de Claude Code. Quando o desenvolvedor se autentica com um login claude.ai, que é possível quando `ANTHROPIC_BASE_URL` é definido sem uma variável de credencial de gateway, este header também carrega uma capacidade OAuth que o upstream requer, e removê-lo falha essas solicitações com `401` |

125| `x-claude-code-session-id` | Um identificador único para a sessão atual de Claude Code. Use-o para agregar todas as solicitações de uma sessão sem analisar corpos de solicitação |125| `x-claude-code-session-id` | Um identificador único para a sessão atual de Claude Code. Use-o para agregar todas as solicitações de uma sessão sem analisar corpos de solicitação |

52* **Controles de entrega**: [`policyHelper`](https://code.claude.com/docs/pt/settings-reference#policyhelper), [`wslInheritsWindowsSettings`](https://code.claude.com/docs/pt/settings-reference#wslinheritswindowssettings) e [`managedSourcesBehavior`](https://code.claude.com/docs/pt/settings-reference#managedsourcesbehavior)52* **Controles de entrega**: [`policyHelper`](https://code.claude.com/docs/pt/settings-reference#policyhelper), [`wslInheritsWindowsSettings`](https://code.claude.com/docs/pt/settings-reference#wslinheritswindowssettings) e [`managedSourcesBehavior`](https://code.claude.com/docs/pt/settings-reference#managedsourcesbehavior)

53* **Chaves de login do gateway**: [`forceLoginGatewayUrl`](https://code.claude.com/docs/pt/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/pt/settings-reference#gatewayinternalnetworks) e o valor `"gateway"` de [`forceLoginMethod`](https://code.claude.com/docs/pt/settings-reference#forceloginmethod)53* **Chaves de login do gateway**: [`forceLoginGatewayUrl`](https://code.claude.com/docs/pt/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/pt/settings-reference#gatewayinternalnetworks) e o valor `"gateway"` de [`forceLoginMethod`](https://code.claude.com/docs/pt/settings-reference#forceloginmethod)

54 54 

55Um arquivo de configurações gerenciadas, um perfil MDM ou o console claude.ai aplica uma política a todos que alcança. Para dar a um grupo de desenvolvedores uma política diferente, implante um arquivo ou perfil diferente para esse grupo; o console claude.ai [ainda não pode direcionar um grupo](https://code.claude.com/docs/pt/server-managed-settings.md#current-limitations), enquanto um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway) auto-hospedado entrega configurações gerenciadas por grupo IdP.55Com um arquivo de configurações gerenciadas ou um perfil MDM, todos que ele alcança recebem uma única política. Para dar a um grupo de desenvolvedores uma política diferente, implante um arquivo ou perfil diferente para esse grupo. Em um plano Enterprise, você também pode [dar a cada grupo sua própria configuração](https://code.claude.com/docs/pt/server-managed-settings.md#give-groups-different-settings) nas configurações gerenciadas pelo servidor. Um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway) auto-hospedado entrega configurações gerenciadas por grupo IdP.

56 56 

57Quando mais de um mecanismo entrega uma política para a mesma máquina, Claude Code por padrão usa um e ignora os outros. [Como Claude Code combina fontes gerenciadas](#how-claude-code-combines-managed-sources) fornece a ordem e o opt-in que aplica cada fonte.57Quando mais de um mecanismo entrega uma política para a mesma máquina, Claude Code por padrão usa um e ignora os outros. [Como Claude Code combina fontes gerenciadas](#how-claude-code-combines-managed-sources) fornece a ordem e o opt-in que aplica cada fonte.

58 58 

163 163 

164O formulário inline define a variável para esse único lançamento em Bash ou Zsh. Para mantê-la ativada para cada sessão, adicione-a ao bloco `env` em `~/.claude/settings.json` conforme mostrado em [Defina variáveis de ambiente](https://code.claude.com/docs/pt/env-vars.md#set-environment-variables).164O formulário inline define a variável para esse único lançamento em Bash ou Zsh. Para mantê-la ativada para cada sessão, adicione-a ao bloco `env` em `~/.claude/settings.json` conforme mostrado em [Defina variáveis de ambiente](https://code.claude.com/docs/pt/env-vars.md#set-environment-variables).

165 165 

166Isso carrega `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md` do diretório adicional. `CLAUDE.local.md` é ignorado se você excluir `local` de [`--setting-sources`](https://code.claude.com/docs/pt/cli-reference).166Com a variável definida, Claude Code carrega os arquivos `CLAUDE.md`, `.claude/CLAUDE.md`, `CLAUDE.local.md` e `.claude/rules/*.md` do diretório adicional, exceto regras que definem um [campo `paths`](#path-specific-rules). `CLAUDE.local.md` é ignorado se você excluir `local` de [`--setting-sources`](https://code.claude.com/docs/pt/cli-reference).

167 167 

168### Organize regras com `.claude/rules/`168### Organize regras com `.claude/rules/`

169 169 

168 168 

169Consulte [Model is not a recognized model id](https://code.claude.com/docs/pt/errors.md#model-is-not-a-recognized-model-id) e [Model not found](https://code.claude.com/docs/pt/errors.md#model-not-found) para as mensagens.169Consulte [Model is not a recognized model id](https://code.claude.com/docs/pt/errors.md#model-is-not-a-recognized-model-id) e [Model not found](https://code.claude.com/docs/pt/errors.md#model-not-found) para as mensagens.

170 170 

171Se você definir o modelo com a flag `--model`, a variável de ambiente `ANTHROPIC_MODEL`, ou a configuração `model`, Claude Code não rejeita antecipadamente um valor digitado incorretamente. A sessão é iniciada, e a primeira requisição produz [There's an issue with the selected model](https://code.claude.com/docs/pt/errors.md#theres-an-issue-with-the-selected-model). Na API Anthropic, um valor que não começa com `claude-` e quase corresponde a um nome ou alias de modelo também pode produzir um [aviso de inicialização que o sugere](#fix-a-mistyped-model-name).171Se você definir o modelo com a flag `--model`, a variável de ambiente `ANTHROPIC_MODEL`, ou a configuração `model`, Claude Code não rejeita antecipadamente um valor digitado incorretamente. A sessão é iniciada, e a primeira requisição produz [There's an issue with the selected model](https://code.claude.com/docs/pt/errors.md#theres-an-issue-with-the-selected-model). Na API Anthropic, você pode ver um [aviso que sugere o nome mais próximo](#fix-a-mistyped-model-name) se o valor quase corresponder a um nome ou alias de modelo e não começar com `claude-`.

172 172 

173Quando o modelo solicitado tem uma data de aposentadoria programada ou é automaticamente remapeado para uma versão mais recente, Claude Code mostra um aviso que nomeia o modelo solicitado. Sessões interativas o mostram como um aviso de inicialização. A partir da v2.1.182, o mesmo aviso é escrito em stderr em [modo não interativo](https://code.claude.com/docs/pt/headless.md) ao usar o formato de saída de texto padrão. A verificação também cobre um `model` definido em [frontmatter de subagentes](https://code.claude.com/docs/pt/sub-agents.md). O aviso stderr é suprimido para `--output-format json` e `stream-json`; leia o modelo real do campo `modelUsage` da [mensagem de resultado](https://code.claude.com/docs/pt/headless.md#get-structured-output) em vez disso.173Quando o modelo solicitado tem uma data de aposentadoria programada ou é automaticamente remapeado para uma versão mais recente, Claude Code mostra um aviso que nomeia o modelo solicitado. Sessões interativas o mostram como um aviso de inicialização. A partir da v2.1.182, o mesmo aviso é escrito em stderr em [modo não interativo](https://code.claude.com/docs/pt/headless.md) ao usar o formato de saída de texto padrão. A verificação também cobre um `model` definido em [frontmatter de subagentes](https://code.claude.com/docs/pt/sub-agents.md). O aviso stderr é suprimido para `--output-format json` e `stream-json`; leia o modelo real do campo `modelUsage` da [mensagem de resultado](https://code.claude.com/docs/pt/headless.md#get-structured-output) em vez disso.

174 174 

195}195}

196```196```

197 197 

198#### Corrigir um nome de modelo digitado incorretamente

199 

200Qualquer um destes avisos significa que Claude Code não reconhece o ID de modelo que você definiu, e o ID quase corresponde a um nome ou alias de modelo que ele reconhece:

201 

202```text theme={null}

203⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

204Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

205```

206 

207* **Você digitou o ID incorretamente**: altere-o para a sugestão [onde quer que você defina o modelo](#setting-your-model)

208* **O ID é intencional**: deixe-o como está. A sessão o envia como você o escreveu. Se a janela de contexto que Claude Code assume para ele estiver errada, [corrija a janela](#correct-the-window-for-a-gateway-or-custom-model-id)

209 

198#### Defina um modelo padrão para novas sessões210#### Defina um modelo padrão para novas sessões

199 211 

200Defina `ANTHROPIC_DEFAULT_MODEL=<alias|name>` para escolher o modelo em que suas sessões começam por padrão. Requer Claude Code v2.1.236 ou posterior.212Defina `ANTHROPIC_DEFAULT_MODEL=<alias|name>` para escolher o modelo em que suas sessões começam por padrão. Requer Claude Code v2.1.236 ou posterior.

772| :- | :- |784| :- | :- |

773| Alternar para a sessão atual | Pressione `Option+T` em macOS ou `Alt+T` em Windows e Linux |785| Alternar para a sessão atual | Pressione `Option+T` em macOS ou `Alt+T` em Windows e Linux |

774| Definir o padrão global | Execute `/config` e alterne o modo de pensamento. Salvo como `alwaysThinkingEnabled` em `~/.claude/settings.json` |786| Definir o padrão global | Execute `/config` e alterne o modo de pensamento. Salvo como `alwaysThinkingEnabled` em `~/.claude/settings.json` |

775| Desativar através de uma variável de ambiente | Defina [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/pt/env-vars), que desativa o pensamento na Anthropic API exceto em Opus 5.5, Sonnet 5.5, Haiku 5.5 e modelos Fable. Em [provedores de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md), Claude Code omite o parâmetro `thinking` em vez disso, e modelos de raciocínio adaptativo ainda podem pensar |787| Desativar através de uma variável de ambiente | Defina [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/pt/env-vars) |

788 

789Claude Code recolhe a saída de pensamento por padrão. Pressione `Ctrl+O` para alternar o modo detalhado e ver o raciocínio como texto itálico cinzento. Sessões interativas na Anthropic API recebem blocos de pensamento redigidos por padrão, portanto defina [`showThinkingSummaries: true`](https://code.claude.com/docs/pt/settings-reference#showthinkingsummaries) nas configurações se quiser os resumos completos disponíveis quando expandir. Você é cobrado por todos os tokens de pensamento gerados, mesmo quando recolhidos ou redigidos.

790 

791#### Onde você não pode desativar o pensamento

776 792 

777Você não pode desativar o pensamento em Opus 5.5, Sonnet 5.5, Haiku 5.5 ou nos modelos Fable. O alternador de sessão e a linha `/config` mostram `Thinking can't be turned off` para esses modelos em vez de oferecer a alternância, e um `alwaysThinkingEnabled: false` ou `MAX_THINKING_TOKENS=0` salvo não tem efeito lá. Nesses modelos, o modelo decide por etapa quanto pensar com base no nível de esforço. A configuração salva se aplica novamente quando você alterna para um modelo que a aceita.793Você não pode desativar o pensamento em Opus 5.5, Sonnet 5.5, Haiku 5.5 ou nos modelos Fable. O alternador de sessão e a linha `/config` mostram `Thinking can't be turned off` para esses modelos em vez de oferecer a alternância, e um `alwaysThinkingEnabled: false` ou `MAX_THINKING_TOKENS=0` salvo não tem efeito lá. Nesses modelos, o modelo decide por etapa quanto pensar com base no nível de esforço. A configuração salva se aplica novamente quando você alterna para um modelo que a aceita.

778 794 

779Claude Code recolhe a saída de pensamento por padrão. Pressione `Ctrl+O` para alternar o modo detalhado e ver o raciocínio como texto itálico cinzento. Sessões interativas na Anthropic API recebem blocos de pensamento redigidos por padrão, portanto defina `showThinkingSummaries: true` em [configurações](https://code.claude.com/docs/pt/settings.md) se quiser os resumos completos disponíveis quando expandir. Você é cobrado por todos os tokens de pensamento gerados, mesmo quando recolhidos ou redigidos.795Para interromper ou reduzir o pensamento, use a etapa correspondente ao seu provedor:

796 

797* **Anthropic API**: você pode desativar o pensamento em modelos como `claude-opus-5`, `claude-sonnet-5` e `claude-haiku-4-5`. [Aliases](#model-aliases) como `sonnet` selecionam modelos em que isso não é possível, portanto [defina o modelo](#setting-your-model) pelo seu ID.

798* **[Provedores de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md)**: em provedores como Amazon Bedrock e Microsoft Foundry, modelos com [raciocínio adaptativo](#adaptive-reasoning-and-fixed-thinking-budgets) ainda podem pensar com o pensamento desativado. [Reduza o nível de esforço](#set-the-effort-level) para reduzir o pensamento.

780 799 

781### Contexto estendido800### Contexto estendido

782 801 

900 919 

901Assim que Claude Code reconhecer o ID ou usar a janela que você informou, o aviso deixa de aparecer quando você inicia uma sessão nesse ID.920Assim que Claude Code reconhecer o ID ou usar a janela que você informou, o aviso deixa de aparecer quando você inicia uma sessão nesse ID.

902 921 

903#### Corrigir um nome de modelo digitado incorretamente

904 

905Qualquer um destes avisos significa que Claude Code não reconhece o ID de modelo que você definiu, e o ID quase corresponde à grafia de um nome de modelo ou alias que ele reconhece:

906 

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

911 

912* **Você digitou o ID incorretamente**: altere-o para a sugestão [onde quer que você defina o modelo](#setting-your-model)

913* **O ID é intencional**: deixe-o como está. A sessão o envia como você o escreveu. Se a janela de contexto que Claude Code assume para ele estiver errada, [corrija a janela](#correct-the-window-for-a-gateway-or-custom-model-id)

914 

915#### A quais IDs `CLAUDE_CODE_MAX_CONTEXT_TOKENS` se aplica922#### A quais IDs `CLAUDE_CODE_MAX_CONTEXT_TOKENS` se aplica

916 923 

917Em um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) ou outra implantação personalizada, Claude Code pode assumir uma janela de contexto para o ID do modelo que difere da janela real do modelo, independentemente de resolver ou não o ID para um modelo Claude. Defina [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/pt/env-vars) para a janela que Claude Code deve assumir em vez disso.924Em um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) ou outra implantação personalizada, Claude Code pode assumir uma janela de contexto para o ID do modelo que difere da janela real do modelo, independentemente de resolver ou não o ID para um modelo Claude. Defina [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/pt/env-vars) para a janela que Claude Code deve assumir em vez disso.

710* `skill.name`: Skill ativa para a requisição, definida pela ferramenta Skill ou por um comando `/`, ou herdada por um subagente gerado. Nomes de skills integradas, incluídas, definidas pelo usuário e de plugins do marketplace oficial aparecem literalmente. Nomes de skills de plugins de terceiros são substituídos por `"third-party"`. Ausente quando nenhuma skill está ativa.710* `skill.name`: Skill ativa para a requisição, definida pela ferramenta Skill ou por um comando `/`, ou herdada por um subagente gerado. Nomes de skills integradas, incluídas, definidas pelo usuário e de plugins do marketplace oficial aparecem literalmente. Nomes de skills de plugins de terceiros são substituídos por `"third-party"`. Ausente quando nenhuma skill está ativa.

711* `plugin.name`: Plugin proprietário quando a skill ou o subagente ativo é fornecido por um plugin. Nomes de plugins do marketplace oficial aparecem literalmente. Nomes de plugins de terceiros são substituídos por `"third-party"`. Ausente quando nem a skill nem o subagente têm um plugin proprietário.711* `plugin.name`: Plugin proprietário quando a skill ou o subagente ativo é fornecido por um plugin. Nomes de plugins do marketplace oficial aparecem literalmente. Nomes de plugins de terceiros são substituídos por `"third-party"`. Ausente quando nem a skill nem o subagente têm um plugin proprietário.

712* `marketplace.name`: Marketplace de onde o plugin proprietário foi instalado. Emitido apenas para plugins do marketplace oficial, mesmo com `OTEL_LOG_TOOL_DETAILS=1` definido. Ausente caso contrário.712* `marketplace.name`: Marketplace de onde o plugin proprietário foi instalado. Emitido apenas para plugins do marketplace oficial, mesmo com `OTEL_LOG_TOOL_DETAILS=1` definido. Ausente caso contrário.

713* `mcp_server.name`: Servidor MCP cujo resultado de ferramenta esta requisição consumiu. Nomes de servidores integrados, com proxy do claude.ai e do registro oficial aparecem literalmente. Nomes de servidores configurados pelo usuário são substituídos por `"custom"`. Ausente quando a requisição não consumiu nenhum resultado de ferramenta MCP. Antes da v2.1.222, o Claude Code definia esse atributo em todas as requisições após uma chamada de ferramenta MCP, não apenas nas requisições que consumiam um resultado de ferramenta, portanto painéis que o agregam mostram uma queda após a atualização.713* `mcp_server.name`: Servidor MCP cujo resultado de ferramenta esta requisição consumiu. Os nomes de servidores integrados, com proxy pelo claude.ai e do registro oficial aparecem literalmente. Os nomes de servidores configurados pelo usuário são substituídos por `"custom"`. Ausente quando a requisição não consumiu nenhum resultado de ferramenta MCP. Antes da v2.1.222, o Claude Code definia esse atributo em todas as requisições após uma chamada de ferramenta MCP, não apenas em requisições que consumiam um resultado de ferramenta, portanto os painéis que o agregam mostram uma queda após a atualização.

714* `mcp_tool.name`: Ferramenta MCP cujo resultado esta requisição consumiu, com o mesmo comportamento de ocultação e de versão que `mcp_server.name`. Ausente quando a requisição não consumiu nenhum resultado de ferramenta MCP.714 * A partir da v2.1.312, o nome de um servidor remoto com URL fixa que um plugin do marketplace oficial da Anthropic declara também aparece literalmente, como `plugin_<plugin>_<server>`. Esse nome é substituído por `"custom"` quando a cópia do marketplace do plugin não veio da fonte registrada da Anthropic, como uma montada a partir de um diretório seed em uma sessão na nuvem.

715* `mcp_tool.name`: Ferramenta MCP cujo resultado esta requisição consumiu, com o mesmo comportamento de ocultação e de versão que `mcp_server.name`, exceto que pode exibir `"custom"` quando `mcp_server.name` mostra um nome `plugin_<plugin>_<server>`. Ausente quando a requisição não consumiu nenhum resultado de ferramenta MCP.

715 716 

716#### Contador de tokens717#### Contador de tokens

717 718 

998 * Uma concessão para o restante da sessão, dada em um prompt de permissão anterior na mesma sessão interativa da CLI999 * Uma concessão para o restante da sessão, dada em um prompt de permissão anterior na mesma sessão interativa da CLI

999 * A ferramenta ser inerentemente segura1000 * A ferramenta ser inerentemente segura

1000 1001 

1001 O valor de `source` não indica qual dessas origens correspondeu. Para descobrir qual delas recusou uma chamada, procure o [Evento de segurança](#safety-event) com o mesmo `tool_use_id` e leia seus atributos `category` e `rule_source`. Algumas chamadas recusadas [não têm evento de segurança](#calls-without-a-safety-event).1002 O valor de `source` não indica qual dessas origens correspondeu. Quando `classifier_verdict` está presente, ele fornece o resultado do classificador que decidiu a chamada. Nenhum atributo de `tool_decision` nomeia a regra de permissão ou a configuração que recusou a chamada.

1002 1003 

1003 O Claude Code também informa `"config"` quando a própria requisição do prompt de permissão falha. Por exemplo, essa requisição falha quando o callback [`canUseTool`](https://code.claude.com/docs/pt/agent-sdk/typescript#canusetool) do Agent SDK ou a ferramenta [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags) retorna um resultado inválido, ou quando o stream de entrada é fechado enquanto a requisição está pendente.1004 O Claude Code também informa `"config"` quando a própria requisição do prompt de permissão falha. Por exemplo, essa requisição falha quando o callback [`canUseTool`](https://code.claude.com/docs/pt/agent-sdk/typescript#canusetool) do Agent SDK ou a ferramenta [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags) retorna um resultado inválido, ou quando o stream de entrada é fechado enquanto a requisição está pendente.

1004 * `"hook"`: Um hook `PreToolUse` ou `PermissionRequest` retornou a decisão.1005 * `"hook"`: Um hook `PreToolUse` ou `PermissionRequest` retornou a decisão.

1046 1047 

1047#### Evento de segurança1048#### Evento de segurança

1048 1049 

1049Registrado quando uma verificação recusa uma chamada de ferramenta ou exige um prompt de permissão, exceto para [chamadas sem evento de segurança](#calls-without-a-safety-event). Também registrado quando o [proxy de rede do sandbox](https://code.claude.com/docs/pt/sandboxing.md#network-isolation) recusa uma conexão ou requisição, e quando um hook bloqueia um resultado. Requer Claude Code v2.1.307 ou posterior.1050O Claude Code deixou de enviar `claude_code.safety_event`:

1051 

1052* **v2.1.312 e posteriores**: essas versões não enviam o evento, e nenhuma configuração o ativa

1053* **v2.1.307 a v2.1.311**: uma sessão deixa de enviar o evento na próxima atualização de feature flags. Uma sessão que não [busca feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching), como no Amazon Bedrock, no Agent Platform do Google Cloud ou no Microsoft Foundry, pode continuar a enviá-lo.

1054 

1055Para ver chamadas de ferramenta recusadas, consulte os eventos [`tool_decision`](#tool-decision-event), que mostram que uma chamada foi recusada, mas nem sempre qual verificação a recusou.

1056 

1057Os detalhes do evento aqui descrevem eventos da v2.1.307 à v2.1.311, em que um evento de segurança registra [casos](#safety-event-categories) como estes:

1058 

1059* Uma verificação recusa uma chamada de ferramenta ou exige um prompt de permissão, exceto para [chamadas sem evento de segurança](#calls-without-a-safety-event)

1060* O [proxy de rede do sandbox](https://code.claude.com/docs/pt/sandboxing.md#network-isolation) recusa uma conexão ou requisição

1061* Um hook bloqueia um resultado ou o fim de um turno

1050 1062 

1051O evento é exportado com os outros eventos e não tem uma configuração separada. Os atributos próprios do evento não contêm texto de comandos, caminhos de arquivos, nomes de host nem nomes de servidores e ferramentas MCP. O registro também contém os [atributos padrão](#standard-attributes) que todo evento possui, que podem incluir `workspace.host_paths` e os [atributos de repositório](#repository-attributes). Para ver o comando ou a ferramenta MCP por trás de um evento, defina `OTEL_LOG_TOOL_DETAILS=1` e leia `tool_parameters` no evento `tool_decision` correspondente.1063O evento é exportado com os outros eventos e não tem uma configuração separada. Os atributos próprios do evento não contêm texto de comandos, caminhos de arquivos, nomes de host nem nomes de servidores e ferramentas MCP. O registro também contém os [atributos padrão](#standard-attributes) que todo evento possui, que podem incluir `workspace.host_paths` e os [atributos de repositório](#repository-attributes). Para ver o comando ou a ferramenta MCP por trás de um evento, defina `OTEL_LOG_TOOL_DETAILS=1` e leia `tool_parameters` no evento `tool_decision` correspondente.

1052 1064 

1663 1675 

1664### Mapear questões de segurança para eventos1676### Mapear questões de segurança para eventos

1665 1677 

1678As linhas de `safety_event` se aplicam apenas a uma sessão na v2.1.307 até a v2.1.311 que [ainda envia o evento](#safety-event).

1679 

1666Ao construir regras de detecção, procure o sinal que você deseja monitorar e consulte seu backend para o evento correspondente e atributos:1680Ao construir regras de detecção, procure o sinal que você deseja monitorar e consulte seu backend para o evento correspondente e atributos:

1667 1681 

1668| Sinal | Evento | Atributos-chave |1682| Sinal | Evento | Atributos-chave |

1672| O classificador do modo auto permitiu ou bloqueou uma chamada de ferramenta, ou Claude Code negou a chamada sem um veredito do classificador | [`tool_decision`](#tool-decision-event) onde `classifier_verdict` está presente. Para uma negação sem veredito, `classifier_verdict` é `"no_verdict"` ou `"unavailable"` | `classifier_verdict`, `permission_mode`, `tool_name`; `classifier_category` quando você define `OTEL_LOG_TOOL_DETAILS=1` |1686| O classificador do modo auto permitiu ou bloqueou uma chamada de ferramenta, ou Claude Code negou a chamada sem um veredito do classificador | [`tool_decision`](#tool-decision-event) onde `classifier_verdict` está presente. Para uma negação sem veredito, `classifier_verdict` é `"no_verdict"` ou `"unavailable"` | `classifier_verdict`, `permission_mode`, `tool_name`; `classifier_category` quando você define `OTEL_LOG_TOOL_DETAILS=1` |

1673| Escalação de modo de permissão | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |1687| Escalação de modo de permissão | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |

1674| Em qual modo de permissão cada chamada de ferramenta foi verificada, incluindo chamadas feitas por subagentes | [`tool_decision`](#tool-decision-event) | `permission_mode`, `session.id` |1688| Em qual modo de permissão cada chamada de ferramenta foi verificada, incluindo chamadas feitas por subagentes | [`tool_decision`](#tool-decision-event) | `permission_mode`, `session.id` |

1675| Hook de política bloqueou uma ação | `hook_execution_complete` | `hook_event`, `num_blocking` |1689| Hook de política bloqueou uma ação | `hook_execution_complete`, que não está vinculado a uma chamada nem a `tool_use_id` | `hook_event`, `num_blocking` |

1676| Qual chamada de ferramenta um hook recusou, e qual resultado ou fim de turno um hook bloqueou | [`safety_event`](#safety-event) onde `category` é `"hook"` e `decision` é `"reject"` para uma chamada recusada, ou `category` é `"hook_review"` para um resultado ou fim de turno bloqueado | `category`, `decision`, `hook_event`; `tool_use_id` para uma chamada de ferramenta |1690| Chamada de ferramenta que um hook recusou | [`tool_decision`](#tool-decision-event) onde `decision` é `"reject"` e `source` é `"hook"` | `decision`, `source`, `tool_use_id` |

1691| Qual resultado ou fim de turno um hook bloqueou | [`safety_event`](#safety-event) onde `category` é `"hook_review"` | `category`, `hook_event`; `tool_use_id` para uma chamada de ferramenta |

1677| O proxy de rede do sandbox recusou uma conexão ou requisição de um comando Bash ou PowerShell | [`safety_event`](#safety-event) onde `sandbox_violation_count` está presente e não é `"0"` | `sandbox_violation_count`, `category`, `sandbox_enabled`, `tool_use_id` |1692| O proxy de rede do sandbox recusou uma conexão ou requisição de um comando Bash ou PowerShell | [`safety_event`](#safety-event) onde `sandbox_violation_count` está presente e não é `"0"` | `sandbox_violation_count`, `category`, `sandbox_enabled`, `tool_use_id` |

1678| Login, logout e falha de autenticação | `auth` | `action`, `success`, `error_category` |1693| Login, logout e falha de autenticação | `auth` | `action`, `success`, `error_category` |

1679| Conexão do servidor MCP ou falha | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |1694| Conexão do servidor MCP ou falha | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |

25 25 

26O modo que revisa cada ação é nomeado **Manual** na CLI, em `claude --help`, nas extensões VS Code e JetBrains, e no aplicativo de desktop. Seu valor de configuração é `default`, que é o que hooks e integrações SDK usam. A CLI aceita `manual` como um alias em qualquer lugar onde você digita o valor, por exemplo `claude --permission-mode manual` ou `"defaultMode": "manual"`.26O modo que revisa cada ação é nomeado **Manual** na CLI, em `claude --help`, nas extensões VS Code e JetBrains, e no aplicativo de desktop. Seu valor de configuração é `default`, que é o que hooks e integrações SDK usam. A CLI aceita `manual` como um alias em qualquer lugar onde você digita o valor, por exemplo `claude --permission-mode manual` ou `"defaultMode": "manual"`.

27 27 

28As gravações em [caminhos protegidos](#protected-paths) nunca são auto-aprovadas, exceto no modo `bypassPermissions` e em sessões de modo plan onde permissões de bypass estão disponíveis, significando sessões iniciadas de uma forma que [coloca `bypassPermissions` no ciclo de modo](#switch-permission-modes).28Cada modo tem sua própria regra para gravações em [caminhos protegidos](#protected-paths).

29 29 

30Os modos definem a linha de base. Sobreponha [regras de permissão](https://code.claude.com/docs/pt/permissions.md#manage-permissions) no topo para pré-aprovar ou bloquear ferramentas específicas. Regras de negação bloqueiam em todos os modos, incluindo `bypassPermissions`. Regras de negação e solicitação não se aplicam a [`EndConversation`](https://code.claude.com/docs/pt/tools-reference#endconversation-tool-behavior) enquanto Claude ainda tiver pelo menos uma outra ferramenta que possa chamar. Regras de permissão não têm efeito em `bypassPermissions`.30Os modos definem a linha de base. Sobreponha [regras de permissão](https://code.claude.com/docs/pt/permissions.md#manage-permissions) no topo para pré-aprovar ou bloquear ferramentas específicas. Regras de negação bloqueiam em todos os modos, incluindo `bypassPermissions`. Regras de negação e solicitação não se aplicam a [`EndConversation`](https://code.claude.com/docs/pt/tools-reference#endconversation-tool-behavior) enquanto Claude ainda tiver pelo menos uma outra ferramenta que possa chamar. Regras de permissão não têm efeito em `bypassPermissions`.

31 31 

484* Abertura de um pull request contra um repositório ou organização diferente, criação de fork com `gh repo fork` ou push para um repositório de terceiros, a menos que você tenha nomeado esse alvo externo484* Abertura de um pull request contra um repositório ou organização diferente, criação de fork com `gh repo fork` ou push para um repositório de terceiros, a menos que você tenha nomeado esse alvo externo

485* Conteúdo de um armazenamento local sensível, ou de um arquivo cujo nome, caminho ou tipo o marca como sensível, entrando em um commit, um push, texto de PR ou issue, um gist ou paste ou uma publicação de pacote, a menos que você tenha nomeado tanto a origem quanto o destino. Transcrições de sessão e logs de conversa, pastas ocultas de credenciais e configuração como chaves SSH, credenciais de nuvem, perfis de navegador e histórico de shell, e exportações de dados de usuário contam, e o fato de o repositório ser privado não libera o bloqueio485* Conteúdo de um armazenamento local sensível, ou de um arquivo cujo nome, caminho ou tipo o marca como sensível, entrando em um commit, um push, texto de PR ou issue, um gist ou paste ou uma publicação de pacote, a menos que você tenha nomeado tanto a origem quanto o destino. Transcrições de sessão e logs de conversa, pastas ocultas de credenciais e configuração como chaves SSH, credenciais de nuvem, perfis de navegador e histórico de shell, e exportações de dados de usuário contam, e o fato de o repositório ser privado não libera o bloqueio

486* Escrita em transcrições de sessão de Claude Code, os arquivos de histórico `.jsonl` em `~/.claude/projects/` ou em seu diretório de configuração configurado, seja diretamente ou através de um comando de shell. A regra também cobre as linhas de metadados que Claude Code acrescenta a cada entrada de transcrição para suas próprias verificações. Ler uma transcrição não é bloqueado486* Escrita em transcrições de sessão de Claude Code, os arquivos de histórico `.jsonl` em `~/.claude/projects/` ou em seu diretório de configuração configurado, seja diretamente ou através de um comando de shell. A regra também cobre as linhas de metadados que Claude Code acrescenta a cada entrada de transcrição para suas próprias verificações. Ler uma transcrição não é bloqueado

487* Uma exclusão forçada recursiva como `rm -rf "$VAR"` ou `Remove-Item -Recurse -Force $dir` cujo alvo é uma variável de shell que não é atribuída em nenhum lugar da conversa que o classificador vê, ou um glob enraizado em tal variável. O valor veio apenas de saídas de comando anteriores, que o classificador nunca recebe, então o classificador não consegue verificar o alvo da exclusão segundo as outras regras de exclusão. O bloqueio é liberado quando você nomeia o caminho exato sendo excluído, ou quando Claude executa novamente a exclusão com o caminho literal resolvido escrito no comando. Exclusões cujo alvo o classificador consegue resolver não são afetadas.487* Uma exclusão forçada recursiva como `rm -rf "$VAR"` ou `Remove-Item -Recurse -Force $dir` cujo alvo é uma variável de shell que não é atribuída na conversa que o classificador vê, ou um glob enraizado em tal variável. Sem essa atribuição, o classificador não consegue saber o que o comando excluiria.

488 488 

489 Um glob diretamente sob a variável, como em `rm -rf "$VAR"/*`, é em vez disso um [caminho crítico](#critical-paths). Alvos de `Remove-Item` que são um `*` simples ou terminam em `/*` ou `\*` nunca chegam ao classificador: Claude Code [os nega imediatamente](#remove-item-in-powershell).489 O bloqueio é liberado quando você nomeia o caminho exato sendo excluído, ou quando Claude executa novamente a exclusão com o caminho literal resolvido escrito no comando. Exclusões cujo alvo o classificador consegue resolver não são afetadas.

490 

491 Um glob diretamente sob a variável, como em `rm -rf "$VAR"/*`, é em vez disso um [caminho crítico](#critical-paths). Para um alvo de `Remove-Item` que é um `*` simples ou termina em `/*` ou `\*`, consulte [Remove-Item no PowerShell](#remove-item-in-powershell): Claude Code nega esse comando imediatamente.

490 492 

491Várias dessas categorias dependem de entradas de [ambiente](https://code.claude.com/docs/pt/auto-mode-config.md#define-trusted-infrastructure), como alvos remotos sensíveis e escopos IaC protegidos, que você pode restringir a nomes concretos.493Várias dessas categorias dependem de entradas de [ambiente](https://code.claude.com/docs/pt/auto-mode-config.md#define-trusted-infrastructure), como alvos remotos sensíveis e escopos IaC protegidos, que você pode restringir a nomes concretos.

492 494 

730 732 

731## Caminhos protegidos733## Caminhos protegidos

732 734 

733Gravações em um pequeno conjunto de caminhos nunca são auto-aprovadas, exceto no modo `bypassPermissions` e em sessões de terminal interativo em modo plan com [permissões de bypass](#skip-all-checks-with-bypasspermissions-mode) disponíveis. Isso evita corrupção acidental do estado do repositório e da configuração própria do Claude.735Um pequeno conjunto de caminhos guarda o estado do repositório e a configuração própria do Claude, então cada modo tem sua própria regra para gravações neles:

734 736 

735| Modo | Gravações em caminhos protegidos |737| Modo | Gravações em caminhos protegidos |

736| :- | :- |738| :- | :- |

737| `default`, `acceptEdits` | Solicitado |739| `default`, `acceptEdits` | Solicitado |

738| `plan` | Permitido em sessões de terminal interativo com [permissões de bypass](#skip-all-checks-with-bypasspermissions-mode) disponíveis. Caso contrário, roteado para o classificador quando [modo automático](#eliminate-prompts-with-auto-mode) está disponível durante o planejamento, e solicitado quando não está |740| `plan` | Permitido em sessões de terminal interativo com [permissões de bypass](#skip-all-checks-with-bypasspermissions-mode) disponíveis. Caso contrário, roteado para o classificador quando [modo automático](#eliminate-prompts-with-auto-mode) está disponível durante o planejamento, e solicitado quando não está |

739| `auto` | Roteado para o classificador |741| `auto` | Roteado para o classificador, que decide |

740| `dontAsk` | Negado |742| `dontAsk` | Negado |

741| `bypassPermissions` | Permitido |743| `bypassPermissions` | Permitido |

742 744 

185| `disableSideloadFlags` | Rejeita `--plugin-dir`, `--plugin-url`, `--agents`, a opção `plugins` do Agent SDK e pastas nomeadas na variável [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/pt/env-vars#variables) na inicialização, e também `--mcp-config`, a menos que todos os servidores nele sejam entradas `type: "sdk"` em processo. Recusa pastas de plugin que um aplicativo do Agent SDK adiciona no meio da sessão com [`addPlugins`](https://code.claude.com/docs/pt/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) | Não restringe `.mcp.json`, `claude mcp add` nem servidores fornecidos pelo SDK. Combine-a com [`allowedMcpServers`](https://code.claude.com/docs/pt/managed-mcp) |185| `disableSideloadFlags` | Rejeita `--plugin-dir`, `--plugin-url`, `--agents`, a opção `plugins` do Agent SDK e pastas nomeadas na variável [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/pt/env-vars#variables) na inicialização, e também `--mcp-config`, a menos que todos os servidores nele sejam entradas `type: "sdk"` em processo. Recusa pastas de plugin que um aplicativo do Agent SDK adiciona no meio da sessão com [`addPlugins`](https://code.claude.com/docs/pt/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) | Não restringe `.mcp.json`, `claude mcp add` nem servidores fornecidos pelo SDK. Combine-a com [`allowedMcpServers`](https://code.claude.com/docs/pt/managed-mcp) |

186| `disableCommandPluginSources` | Impede que plugins com uma fonte `command` sejam instalados, atualizados ou carregados. Uma fonte `command` é aquela cujo diretório de plugin é produzido pela execução de um comando na máquina. Quando não definida, assume o valor de `allowManagedHooksOnly` | Não afeta outros tipos de fonte |186| `disableCommandPluginSources` | Impede que plugins com uma fonte `command` sejam instalados, atualizados ou carregados. Uma fonte `command` é aquela cujo diretório de plugin é produzido pela execução de um comando na máquina. Quando não definida, assume o valor de `allowManagedHooksOnly` | Não afeta outros tipos de fonte |

187| `allowManagedHooksOnly` | Restringe quais hooks são executados. Consulte [`allowManagedHooksOnly`](https://code.claude.com/docs/pt/settings-reference#allowmanagedhooksonly) | Não confia em hooks de plugins que os próprios usuários ativam |187| `allowManagedHooksOnly` | Restringe quais hooks são executados. Consulte [`allowManagedHooksOnly`](https://code.claude.com/docs/pt/settings-reference#allowmanagedhooksonly) | Não confia em hooks de plugins que os próprios usuários ativam |

188| `strictPluginOnlyCustomization` | Bloqueia skills, agentes, hooks e servidores MCP que não vêm de um plugin, de configurações gerenciadas ou dos recursos integrados do Claude Code. Também impede que [plugins de diretório de skills](#keep-skills-directory-plugins-loading) sejam carregados. Defina como `true` para abranger os quatro tipos, ou como um array de valores `skills`, `agents`, `hooks` e `mcp`, como `["skills", "hooks"]`, para abranger alguns | Não restringe quais plugins os usuários instalam. Combine-a com `strictKnownMarketplaces` |188| `strictPluginOnlyCustomization` | Bloqueia skills, agentes, hooks e servidores MCP de fontes de usuário e de projeto. Também impede que [plugins de diretório de skills](#keep-skills-directory-plugins-loading) sejam carregados. Defina como `true` para abranger os quatro tipos, ou como um array de valores `skills`, `agents`, `hooks` e `mcp`, como `["skills", "hooks"]`, para abranger alguns | Não restringe quais plugins os usuários instalam, nem rejeita as flags de CLI que carregam plugins, agentes e servidores MCP por sideload. Combine-a com `strictKnownMarketplaces` e `disableSideloadFlags` |

189| `pluginSuggestionMarketplaces` | Marketplaces cujos plugins podem aparecer como sugestões de instalação no terminal. Consulte [Recomendar plugins](#recommend-plugins) | Não afeta as dicas integradas |189| `pluginSuggestionMarketplaces` | Marketplaces cujos plugins podem aparecer como sugestões de instalação no terminal. Consulte [Recomendar plugins](#recommend-plugins) | Não afeta as dicas integradas |

190| `pluginTrustMessage` | Acrescenta seu texto ao aviso de confiança que o `/plugin` mostra antes de um plugin ser instalado | Não altera o texto do próprio aviso |190| `pluginTrustMessage` | Acrescenta seu texto ao aviso de confiança que o `/plugin` mostra antes de um plugin ser instalado | Não altera o texto do próprio aviso |

191| `allowedChannelPlugins` | Substitui a lista padrão de plugins autorizados a enviar mensagens de canal. Requer `channelsEnabled: true` | Consulte [Restringir quais plugins de canal podem ser executados](https://code.claude.com/docs/pt/channels.md#restrict-which-channel-plugins-can-run) |191| `allowedChannelPlugins` | Substitui a lista padrão de plugins autorizados a enviar mensagens de canal. Requer `channelsEnabled: true` | Consulte [Restringir quais plugins de canal podem ser executados](https://code.claude.com/docs/pt/channels.md#restrict-which-channel-plugins-can-run) |

336 336 

337### Assign release channels to user groups337### Assign release channels to user groups

338 338 

339Para executar canais estáveis e de acesso antecipado, hospede dois marketplaces que apontam para refs diferentes dos mesmos plugins. Depois dê a cada grupo de usuários seu próprio marketplace através de configurações gerenciadas por endpoint separadas ou uma política de gateway. As configurações gerenciadas pelo servidor do console de administração [se aplicam a cada usuário na sua organização](https://code.claude.com/docs/pt/server-managed-settings.md#current-limitations), então não podem atribuir configurações diferentes a grupos diferentes.339Para executar canais estáveis e de acesso antecipado, hospede dois marketplaces que apontam para refs diferentes dos mesmos plugins. Depois dê a cada grupo de usuários seu próprio marketplace através de configurações gerenciadas por endpoint separadas ou uma política de gateway. Em um plano Enterprise, você também pode usar configurações gerenciadas pelo servidor do console de administração.

340 340 

341* Implante [configurações gerenciadas por endpoint](https://code.claude.com/docs/pt/managed-settings.md#delivery-mechanisms) separadas, como um arquivo de configurações gerenciadas ou um perfil MDM, para os dispositivos de cada grupo. Para verificar se o arquivo ou perfil por grupo se aplica em um dispositivo que também tem uma fonte de nível de organização, veja [How Claude Code combines managed sources](https://code.claude.com/docs/pt/managed-settings.md#precedence-within-the-managed-tier).341* Implante [configurações gerenciadas por endpoint](https://code.claude.com/docs/pt/managed-settings.md#delivery-mechanisms) separadas, como um arquivo de configurações gerenciadas ou um perfil MDM, para os dispositivos de cada grupo. Para verificar se o arquivo ou perfil por grupo se aplica em um dispositivo que também tem uma fonte de nível de organização, veja [How Claude Code combines managed sources](https://code.claude.com/docs/pt/managed-settings.md#precedence-within-the-managed-tier).

342* Defina uma [política de gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#managed) por grupo. Por padrão, o gateway aplica a primeira política cuja regra de correspondência se encaixa em um usuário, então ordene as políticas para que cada usuário chegue à política do seu grupo. O mapa `extraKnownMarketplaces` dessa política não se mescla com o de qualquer outra política, então liste cada marketplace que o grupo precisa nele, não apenas seu marketplace de canal.342* Defina uma [política de gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#managed) por grupo. Por padrão, o gateway aplica a primeira política cuja regra de correspondência se encaixa em um usuário, então ordene as políticas para que cada usuário chegue à política do seu grupo. O mapa `extraKnownMarketplaces` dessa política não se mescla com o de qualquer outra política, então liste cada marketplace que o grupo precisa nele, não apenas seu marketplace de canal.

343* Em um plano Enterprise, [dê a cada grupo sua própria configuração](https://code.claude.com/docs/pt/server-managed-settings.md#give-groups-different-settings) no console de administração. A configuração de um grupo não se mescla com a de toda a organização, então coloque cada opção de configuração de que o grupo precisa na própria configuração do grupo, incluindo cada marketplace.

343 344 

344Com qualquer mecanismo, o grupo estável recebe esta configuração:345Com qualquer um desses mecanismos, o grupo estável recebe esta configuração:

345 346 

346```json theme={null}347```json theme={null}

347{348{

383 384 

384Estes pedidos de revisões de segurança não têm uma chave dedicada no esquema de configurações atual. Os controles existentes mais próximos são:385Estes pedidos de revisões de segurança não têm uma chave dedicada no esquema de configurações atual. Os controles existentes mais próximos são:

385 386 

386* **Direcionamento por usuário ou por grupo**: cada chave de plugin se aplica a cada usuário que recebe as configurações. As configurações gerenciadas pelo servidor entregam uma configuração por organização. Para política por grupo, use configurações gerenciadas por endpoint separadas ou políticas de gateway, como sob [Assign release channels to user groups](#assign-release-channels-to-user-groups).387* **Direcionamento por usuário ou por grupo**: cada chave de plugin se aplica a cada usuário que recebe as configurações. Para política por grupo, entregue a cada grupo suas próprias configurações, como sob [Assign release channels to user groups](#assign-release-channels-to-user-groups).

387* **Restringindo entradas dentro de um marketplace permitido**: a allowlist corresponde a fontes de marketplace. Para bloquear um plugin de um marketplace permitido, defina-o como `false` em `enabledPlugins` gerenciado.388* **Restringindo entradas dentro de um marketplace permitido**: a allowlist corresponde a fontes de marketplace. Para bloquear um plugin de um marketplace permitido, defina-o como `false` em `enabledPlugins` gerenciado.

388* **Ocultando `/plugin`**: nenhuma chave desativa o comando. O equivalente mais próximo combina uma allowlist nomeando apenas seu marketplace, entradas `enabledPlugins` gerenciadas para os plugins que você fornece, e `disableSideloadFlags`.389* **Ocultando `/plugin`**: nenhuma chave desativa o comando. O equivalente mais próximo combina uma allowlist nomeando apenas seu marketplace, entradas `enabledPlugins` gerenciadas para os plugins que você fornece, e `disableSideloadFlags`.

389* **Controlando `--plugin-dir` através da allowlist**: a allowlist não cobre `--plugin-dir`. `disableSideloadFlags` cobre.390* **Controlando `--plugin-dir` através da allowlist**: a allowlist não cobre `--plugin-dir`. `disableSideloadFlags` cobre.

31>31>

32> **macOS, Linux, WSL:**32> **macOS, Linux, WSL:**

33>33>

34> ```bash theme={null}34> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

35> curl -fsSL https://claude.ai/install.sh | bash35> curl -fsSL https://claude.ai/install.sh | bash

36> ```36> ```

37>37>

39>39>

40> **Windows PowerShell:**40> **Windows PowerShell:**

41>41>

42> ```powershell theme={null}42> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

43> irm https://claude.ai/install.ps1 | iex43> irm https://claude.ai/install.ps1 | iex

44> ```44> ```

45>45>

46> **Windows CMD:**46> **Windows CMD:**

47>47>

48> ```batch theme={null}48> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50> ```50> ```

51>51>

63 63 

64> [tab] Homebrew64> [tab] Homebrew

65>65>

66> ```bash theme={null}66> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

67> brew install --cask claude-code67> brew install --cask claude-code

68> ```68> ```

69>69>

75 75 

76> [tab] WinGet76> [tab] WinGet

77>77>

78> ```powershell theme={null}78> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

79> winget install Anthropic.ClaudeCode79> winget install Anthropic.ClaudeCode

80> ```80> ```

81>81>

257 257 

258| Comando | O que faz | Exemplo |258| Comando | O que faz | Exemplo |

259| - | - | - |259| - | - | - |

260| `/clear` | Limpar histórico de conversa | `/clear` |260| `/clear` | Iniciar uma nova conversa. Retome a anterior com `/resume`. | `/clear` |

261| `/help` | Mostrar comandos disponíveis | `/help` |261| `/help` | Mostrar comandos disponíveis | `/help` |

262| `/exit` ou Ctrl+D duas vezes | Sair do Claude Code | `/exit` |262| `/exit` ou Ctrl+D duas vezes | Sair do Claude Code | `/exit` |

263 263 

33 * Você aponta [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars) para um host diferente de `api.anthropic.com`, como um [gateway LLM](https://code.claude.com/docs/pt/llm-gateway) ou proxy. Desative a variável para usar Remote Control.33 * Você aponta [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/pt/env-vars) para um host diferente de `api.anthropic.com`, como um [gateway LLM](https://code.claude.com/docs/pt/llm-gateway) ou proxy. Desative a variável para usar Remote Control.

34 * Você faz login através de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway) empresarial.34 * Você faz login através de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway) empresarial.

35* **Avaliação de feature-flag**: se você definir uma [variável de ambiente que desativa a avaliação de feature-flag](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching), a disponibilidade de Remote Control depende de qual:35* **Avaliação de feature-flag**: se você definir uma [variável de ambiente que desativa a avaliação de feature-flag](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching), a disponibilidade de Remote Control depende de qual:

36 * Se você definir `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK`, Remote Control não está disponível. Desative a variável onde quer que esteja definida, no seu ambiente de shell ou no bloco `env` de um [arquivo `settings.json`](https://code.claude.com/docs/pt/settings-reference#all-settings), para usar Remote Control.36 * Se você definir `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/pt/env-vars#variables), Remote Control não está disponível. Desative a variável onde quer que esteja definida, no seu ambiente de shell ou no bloco `env` de um [arquivo `settings.json`](https://code.claude.com/docs/pt/settings-reference#all-settings), para usar Remote Control.

37 * Se você definir apenas `DISABLE_TELEMETRY` ou `DO_NOT_TRACK`, Remote Control permanece disponível a menos que sua organização exija [Trusted Devices](#trusted-devices). Se exigir, desative a variável para usar Remote Control. Usar Remote Control com qualquer uma dessas variáveis definidas requer Claude Code v2.1.283 ou posterior, ou v2.1.304 ou posterior no aplicativo Claude Desktop.37 * Se você definir apenas `DISABLE_TELEMETRY` ou `DO_NOT_TRACK`, Remote Control permanece disponível a menos que sua organização exija [Trusted Devices](#trusted-devices). Se exigir, desative a variável para usar Remote Control. Usar Remote Control com qualquer uma dessas variáveis definidas requer Claude Code v2.1.283 ou posterior, ou v2.1.304 ou posterior no aplicativo Claude Desktop.

38* **Confiança do workspace**: em um diretório que você ainda não confiou, `claude remote-control` imprime o que confiar nele ativa e pergunta `Trust <directory>? [y/N]` antes de iniciar. Responder `y` salva a escolha, exceto no seu diretório home, onde a confiança nunca é salva e a pergunta retorna a cada execução. Quando sua entrada ou saída padrão não é um terminal, o comando não pode perguntar e sai com um erro [`Workspace not trusted`](https://code.claude.com/docs/pt/errors#workspace-not-trusted-when-starting-remote-control).38* **Confiança do workspace**: em um diretório que você ainda não confiou, `claude remote-control` imprime o que confiar nele ativa e pergunta `Trust <directory>? [y/N]` antes de iniciar. Responder `y` salva a escolha, exceto no seu diretório home, onde a confiança nunca é salva e a pergunta retorna a cada execução. Quando sua entrada ou saída padrão não é um terminal, o comando não pode perguntar e sai com um erro [`Workspace not trusted`](https://code.claude.com/docs/pt/errors#workspace-not-trusted-when-starting-remote-control).

39 39 

217 217 

218#### Conexão automática com `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` definidos218#### Conexão automática com `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` definidos

219 219 

220Com apenas `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` definidos, suas sessões não se conectam automaticamente por meio do padrão do administrador da sua organização nem do próprio padrão de Claude Code. Se outra coisa torna Remote Control indisponível para você, como `DISABLE_GROWTHBOOK` ou um gateway de LLM, comece por [Requisitos](#requirements).220Com apenas `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` definidos, suas sessões não se conectam automaticamente por meio do padrão do administrador da sua organização nem do próprio padrão de Claude Code. Se outra coisa torna Remote Control indisponível para você, como [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/pt/env-vars#variables) ou um gateway de LLM, comece por [Requisitos](#requirements).

221 221 

222Antes de ativar a conexão automática com apenas `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` definidos, confirme que sua versão do Claude Code atende ao [requisito para essas variáveis](#requirements). Em seguida, verifique se sua organização exige [Trusted Devices](#trusted-devices):222Antes de ativar a conexão automática com apenas `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` definidos, confirme que sua versão do Claude Code atende ao [requisito para essas variáveis](#requirements). Em seguida, verifique se sua organização exige [Trusted Devices](#trusted-devices):

223 223 

458 458 

459Uma [variável de ambiente](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching) que desativa a avaliação de feature flags está definida, e a mensagem completa nomeia a variável que o Claude Code encontrou. Em versões anteriores à 2.1.154, a mesma configuração produz "Remote Control is not yet enabled for your account" em vez disso. O que fazer depende da variável que a mensagem nomeia:459Uma [variável de ambiente](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching) que desativa a avaliação de feature flags está definida, e a mensagem completa nomeia a variável que o Claude Code encontrou. Em versões anteriores à 2.1.154, a mesma configuração produz "Remote Control is not yet enabled for your account" em vez disso. O que fazer depende da variável que a mensagem nomeia:

460 460 

461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK`**: remova a definição da variável onde quer que ela esteja definida, no ambiente do seu shell ou no bloco `env` de um [arquivo `settings.json`](https://code.claude.com/docs/pt/settings-reference#all-settings).461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` ou `DISABLE_GROWTHBOOK`**: remova a definição da variável onde quer que ela esteja definida, no ambiente do seu shell ou no bloco `env` de um [arquivo `settings.json`](https://code.claude.com/docs/pt/settings-reference#all-settings).

462* **`DISABLE_TELEMETRY` ou `DO_NOT_TRACK`**: em um plano Pro, Max, Ultra, Team ou Enterprise com `DISABLE_GROWTHBOOK` não definida, o Remote Control continua disponível com essas variáveis definidas, a menos que sua organização exija [Trusted Devices](#trusted-devices). Se exigir, remova a definição da variável onde quer que ela esteja definida para usar o Remote Control. Da v2.1.154 até a v2.1.282, você vê esta mensagem com qualquer uma dessas variáveis definida, então atualize o Claude Code para uma versão que atenda ao [requisito para essas variáveis](#requirements).462* **`DISABLE_TELEMETRY` ou `DO_NOT_TRACK`**: em um plano Pro, Max, Ultra, Team ou Enterprise com `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` e `DISABLE_GROWTHBOOK` não definidas, o Remote Control continua disponível com essas variáveis definidas, a menos que sua organização exija [Trusted Devices](#trusted-devices). Se exigir, remova a definição da variável onde quer que ela esteja definida para usar o Remote Control. Da v2.1.154 até a v2.1.282, você vê esta mensagem com qualquer uma dessas variáveis definida, então atualize o Claude Code para uma versão que atenda ao [requisito para essas variáveis](#requirements).

463 463 

464### "Remote Control is only available when using Claude via api.anthropic.com"464### "Remote Control is only available when using Claude via api.anthropic.com"

465 465 

111* **Variáveis de ambiente**: forneça valores que Claude pode usar durante cada execução. Elas são [visíveis para qualquer pessoa que use o ambiente](https://code.claude.com/docs/pt/cloud-environments.md#what-carries-over-from-your-setup), portanto, em um ambiente hospedado pela Anthropic, armazene as chaves das APIs que Claude chama durante uma execução como [segredos de rede](https://code.claude.com/docs/pt/cloud-environments.md#add-network-secrets). Essa seção também lista as requisições que nunca recebem um segredo111* **Variáveis de ambiente**: forneça valores que Claude pode usar durante cada execução. Elas são [visíveis para qualquer pessoa que use o ambiente](https://code.claude.com/docs/pt/cloud-environments.md#what-carries-over-from-your-setup), portanto, em um ambiente hospedado pela Anthropic, armazene as chaves das APIs que Claude chama durante uma execução como [segredos de rede](https://code.claude.com/docs/pt/cloud-environments.md#add-network-secrets). Essa seção também lista as requisições que nunca recebem um segredo

112* **Script de configuração**: instale as dependências e ferramentas de que a tarefa precisa. O resultado é [armazenado em cache](https://code.claude.com/docs/pt/cloud-environments.md#environment-caching), portanto o script não é executado novamente em cada sessão112* **Script de configuração**: instale as dependências e ferramentas de que a tarefa precisa. O resultado é [armazenado em cache](https://code.claude.com/docs/pt/cloud-environments.md#environment-caching), portanto o script não é executado novamente em cada sessão

113 113 

114Um ambiente **Default** é fornecido com acesso à rede **Trusted**, que permite apenas a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) de registros de pacotes, APIs de provedores de nuvem, registros de contêineres e domínios de desenvolvimento comuns através da rede da sessão. Os conectores que você adiciona à tarefa alcançam seus serviços através dos servidores da Anthropic, portanto não precisam de alterações na allowlist.114Um ambiente **Default** é fornecido com acesso à rede **Limited** e com **Allow package managers** marcado. Suas execuções alcançam a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains): registros de pacotes, APIs de provedores de nuvem, registros de contêineres e domínios de desenvolvimento comuns. Os conectores que você adiciona à tarefa alcançam seus serviços através dos servidores da Anthropic, portanto não precisam de alterações na allowlist.

115 115 

116Se sua tarefa precisar alcançar seus próprios serviços diretamente, ou um domínio fora dessa lista, edite o [acesso à rede](https://code.claude.com/docs/pt/cloud-environments.md#network-access) do ambiente antes de executar. Para usar um ambiente separado, [crie um](https://code.claude.com/docs/pt/cloud-environments.md#configure-your-environment) primeiro.116Se sua tarefa precisar alcançar seus próprios serviços diretamente, ou um domínio fora dessa lista, edite o [acesso à rede](https://code.claude.com/docs/pt/cloud-environments.md#network-access) do ambiente antes de executar. Para usar um ambiente separado, [crie um](https://code.claude.com/docs/pt/cloud-environments.md#configure-your-environment) primeiro.

117 117 

431 431 

432Cada tarefa agendada usa um [ambiente na nuvem](https://code.claude.com/docs/pt/cloud-environments.md) que controla o acesso à rede, as variáveis de ambiente e os scripts de configuração. A tarefa herda a política de rede do ambiente em cada execução.432Cada tarefa agendada usa um [ambiente na nuvem](https://code.claude.com/docs/pt/cloud-environments.md) que controla o acesso à rede, as variáveis de ambiente e os scripts de configuração. A tarefa herda a política de rede do ambiente em cada execução.

433 433 

434O ambiente **Default** usa acesso à rede **Trusted**, que permite apenas a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) através da rede da sessão. Requisições nesse caminho para hosts fora da allowlist falham com `403` e `x-deny-reason: host_not_allowed`. O tráfego dos conectores MCP é roteado através dos servidores da Anthropic, e não por esse caminho, portanto os conectores que você adiciona à tarefa funcionam sem adicionar seus hosts a **Allowed domains**. Remova os conectores de que você não precisa em [Conectores](#connectors).434O ambiente **Default** usa acesso **Limited** com **Allow package managers** marcado, portanto suas execuções alcançam a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains). Uma requisição para um host bloqueado falha com `403` e `x-deny-reason: host_not_allowed`. O tráfego dos conectores MCP é roteado através dos servidores da Anthropic, portanto os conectores que você adiciona à tarefa funcionam sem adicionar seus hosts a **Allowed domains**. Remova os conectores de que você não precisa em [Conectores](#connectors).

435 435 

436Para permitir domínios adicionais em um dos seus próprios ambientes, siga estas etapas. Um [ambiente compartilhado pela organização](https://code.claude.com/docs/pt/cloud-environments.md#organization-shared-environments) é aberto como somente leitura aqui, portanto um Owner altera seu acesso à rede na página **Cloud environments** em [configurações de administração](https://claude.ai/admin-settings).436Para permitir domínios adicionais em um dos seus próprios ambientes, siga estas etapas. Um [ambiente compartilhado pela organização](https://code.claude.com/docs/pt/cloud-environments.md#organization-shared-environments) é aberto como somente leitura aqui, portanto um Owner altera seu acesso à rede na página **Cloud environments** em [configurações de administração](https://claude.ai/admin-settings).

437 437 

447 447 

448Passe o mouse sobre o ambiente na lista e clique no ícone de configurações que aparece à direita.448Passe o mouse sobre o ambiente na lista e clique no ícone de configurações que aparece à direita.

449 449 

450**4. Alterar o nível de acesso à rede**450**4. Adicionar os domínios**

451 451 

452Na caixa de diálogo **Edit cloud environment**, altere **Network access** para **Custom** e insira seus domínios em **Allowed domains**. Marque **Also include default list of common package managers** para manter a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) junto com seus domínios personalizados. Em vez disso, selecione **Full** para acesso irrestrito.452Na caixa de diálogo **Edit cloud environment**, selecione **Limited** em **Network access** e insira seus domínios em **Allowed domains**. Marque **Allow package managers** para permitir a [allowlist padrão](https://code.claude.com/docs/pt/cloud-environments.md#default-allowed-domains) junto com seus próprios domínios. Em vez disso, selecione **Full** para acesso irrestrito.

453 453 

454**5. Salvar**454**5. Salvar**

455 455 

6 6 

7> Compare as opções de sandbox do Claude Code: a ferramenta Bash em sandbox integrada, runtime sandbox, dev containers, Docker e VMs. Escolha o isolamento certo para seu modelo de ameaça.7> Compare as opções de sandbox do Claude Code: a ferramenta Bash em sandbox integrada, runtime sandbox, dev containers, Docker e VMs. Escolha o isolamento certo para seu modelo de ameaça.

8 8 

9Isolar o Claude Code limita o que uma sessão pode ler, escrever e alcançar na rede. Isso é mais importante quando você deixa o Claude trabalhar com menos prompts de permissão, executá-lo sem supervisão ou apontá-lo para código que você não confia completamente.9Isolar o Claude Code limita o que uma sessão pode ler, escrever e alcançar na rede. Isso é mais importante quando você deixa o Claude trabalhar com menos prompts de permissão ou o executa sem supervisão.

10 10 

11O Claude Code pode ser executado em vários tipos de ambientes isolados, variando de um sandbox leve por comando a uma máquina virtual completamente separada. Esta página compara-os pelo que isolam e pelo que exigem, ajuda você a escolher um para seu modelo de ameaça e mostra como impor essa escolha em toda uma organização.11O Claude Code pode ser executado em vários tipos de ambientes isolados, variando de um sandbox leve por comando a uma máquina virtual completamente separada. Esta página compara-os pelo que isolam e pelo que exigem, ajuda você a escolher um para seu modelo de ameaça e mostra como impor essa escolha em toda uma organização.

12 12 

44| Reduzir prompts de permissão durante o trabalho diário em sua própria máquina | A [sandboxed Bash tool](https://code.claude.com/docs/pt/sandboxing.md), configurada com `/sandbox` |44| Reduzir prompts de permissão durante o trabalho diário em sua própria máquina | A [sandboxed Bash tool](https://code.claude.com/docs/pt/sandboxing.md), configurada com `/sandbox` |

45| Deixar o Claude trabalhar sem supervisão com `--dangerously-skip-permissions` ou modo automático | O [dev container](https://code.claude.com/docs/pt/devcontainer.md) pré-configurado, qualquer container ou VM, ou o [sandbox runtime](#sandbox-runtime) |45| Deixar o Claude trabalhar sem supervisão com `--dangerously-skip-permissions` ou modo automático | O [dev container](https://code.claude.com/docs/pt/devcontainer.md) pré-configurado, qualquer container ou VM, ou o [sandbox runtime](#sandbox-runtime) |

46| Isolar servidores MCP e hooks bem como Bash, sem Docker | O sandbox runtime |46| Isolar servidores MCP e hooks bem como Bash, sem Docker | O sandbox runtime |

47| Trabalhar em um repositório não confiável | Uma máquina virtual dedicada, ou uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) se você tiver uma assinatura Claude; GitHub não é necessário quando você inicia com `claude --cloud` |

48| Padronizar um ambiente sandbox em toda uma equipe | O [dev container](https://code.claude.com/docs/pt/devcontainer.md) pré-configurado, copiado para seu repositório |47| Padronizar um ambiente sandbox em toda uma equipe | O [dev container](https://code.claude.com/docs/pt/devcontainer.md) pré-configurado, copiado para seu repositório |

49| Usar Claude Code de um dispositivo sem configuração local | Uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), que requer uma assinatura Claude, e uma conta GitHub conectada para clonar um repositório GitHub |48| Usar Claude Code de um dispositivo sem configuração local | Uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), que requer uma assinatura Claude, e uma conta GitHub conectada para clonar um repositório GitHub |

50| Exigir isolamento para cada desenvolvedor em sua organização | [Enforce isolation across an organization](#enforce-isolation-across-an-organization) |49| Exigir isolamento para cada desenvolvedor em sua organização | [Enforce isolation across an organization](#enforce-isolation-across-an-organization) |

157 156 

158## Virtual machine157## Virtual machine

159 158 

160Uma máquina virtual dedicada fornece a separação mais forte, com seu próprio kernel e, em implantações em nuvem ou microVM, seu próprio hardware virtualizado. As opções incluem instâncias em nuvem, hipervisores locais e microVMs como Firecracker. Use esta abordagem quando você está avaliando código não confiável, quando sua política de segurança exige separação no nível do kernel entre o agente e o host, ou quando nenhuma abordagem no nível do host atende aos seus requisitos de conformidade.159Uma máquina virtual dedicada fornece a separação mais forte, com seu próprio kernel e, em implantações em nuvem ou microVM, seu próprio hardware virtualizado. As opções incluem instâncias em nuvem, hipervisores locais e microVMs como Firecracker. Use esta abordagem quando sua política de segurança exige separação no nível do kernel entre o agente e o host, ou quando nenhuma abordagem no nível do host atende aos seus requisitos de conformidade.

161 160 

162[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) fornece uma microVM com seu próprio daemon Docker e sincronização de workspace, que pode executar Claude Code em qualquer host com Docker Sandboxes instalado. É um produto gratuito e independente do Docker que não requer Docker Desktop.161[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) fornece uma microVM com seu próprio daemon Docker e sincronização de workspace, que pode executar Claude Code em qualquer host com Docker Sandboxes instalado. É um produto gratuito e independente do Docker que não requer Docker Desktop.

163 162 

739 739 

740O sandbox não é executado no Windows nativo, portanto com `failIfUnavailable` definido, o Claude Code encerra na inicialização nessas máquinas. Se sua frota inclui hosts Windows, você pode:740O sandbox não é executado no Windows nativo, portanto com `failIfUnavailable` definido, o Claude Code encerra na inicialização nessas máquinas. Se sua frota inclui hosts Windows, você pode:

741 741 

742* **Entregar a configuração por sistema operacional**: implante-a através do seu MDM ou como um [arquivo de configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md#delivery-mechanisms) apenas em máquinas macOS e Linux. As [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md#current-limitations) se aplicam a todos os usuários da organização742* **Entregar a configuração por sistema operacional**: implante-a através do seu MDM ou como um [arquivo de configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md#delivery-mechanisms) apenas em máquinas macOS e Linux. As [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md#give-groups-different-settings) seguem o membro, não o dispositivo.

743* **Mover usuários Windows para um ambiente suportado**: faça com que executem o Claude Code dentro do WSL2 ou de um container743* **Mover usuários Windows para um ambiente suportado**: faça com que executem o Claude Code dentro do WSL2 ou de um container

744 744 

745### Impeça que desenvolvedores ampliem a política745### Impeça que desenvolvedores ampliem a política

92* cuidar do pull request do branch atual: comentários de revisão, execuções de CI falhadas, conflitos de mesclagem92* cuidar do pull request do branch atual: comentários de revisão, execuções de CI falhadas, conflitos de mesclagem

93* executar passes de limpeza, como caças a bugs ou simplificação quando nada mais está pendente93* executar passes de limpeza, como caças a bugs ou simplificação quando nada mais está pendente

94 94 

95Claude não inicia novas iniciativas fora desse escopo, e ações irreversíveis como envio ou exclusão apenas prosseguem quando continuam algo que a transcrição já autorizou.95Cada execução passa pelas [verificações de permissão](https://code.claude.com/docs/pt/permissions.md) da sua sessão antes de enviar ou excluir qualquer coisa.

96 

97Um `/loop` simples executa este prompt em um [intervalo escolhido dinamicamente](#let-claude-choose-the-interval):

96 98 

97```text theme={null}99```text theme={null}

98/loop100/loop

99```101```

100 102 

101Um `/loop` simples executa este prompt em um [intervalo escolhido dinamicamente](#let-claude-choose-the-interval). Adicione um intervalo, por exemplo `/loop 15m`, para executá-lo em um cronograma fixo. Para substituir o prompt integrado pelo seu próprio padrão, consulte [Personalize o prompt padrão com loop.md](#customize-the-default-prompt-with-loop-md).103Adicione um intervalo, por exemplo `/loop 15m`, para executá-lo em um cronograma fixo. Para substituir o prompt integrado pelo seu próprio padrão, consulte [Personalize o prompt padrão com loop.md](#customize-the-default-prompt-with-loop-md).

102 104 

103### Personalize o prompt padrão com loop.md105### Personalize o prompt padrão com loop.md

104 106 

227 229 

228## Desabilite tarefas agendadas com escopo de sessão230## Desabilite tarefas agendadas com escopo de sessão

229 231 

230Defina `CLAUDE_CODE_DISABLE_CRON=1` em seu ambiente para desabilitar o agendador completamente. As ferramentas cron e `/loop` ficam indisponíveis e qualquer tarefa já agendada para de ser acionada. Consulte [Variáveis de ambiente](https://code.claude.com/docs/pt/env-vars.md) para a lista completa de sinalizadores de desabilitação.232Defina `CLAUDE_CODE_DISABLE_CRON=1` em seu ambiente para desabilitar o agendador completamente. `CronCreate` e `/loop` ficam indisponíveis e qualquer tarefa já agendada para de ser acionada. Enquanto o arquivo `.claude/scheduled_tasks.json` do projeto contiver tarefas, `CronList` e `CronDelete` permanecem disponíveis, para que você ainda possa pedir ao Claude que as liste ou cancele. Consulte [Variáveis de ambiente](https://code.claude.com/docs/pt/env-vars.md) para a lista completa de flags de desabilitação.

231 233 

232## Limitações234## Limitações

233 235 

183 183 

184* **Um repositório para o qual a sessão faz push de resultados**: o runner falha a sessão, e em uma saída diferente de zero exibe a cauda do stderr do script para o usuário. Escreva o motivo no stderr como uma única linha curta, escreva-a por último e então saia com código diferente de zero. Não imprima segredos no stderr e remova `set -x` antes de implantar o hook.184* **Um repositório para o qual a sessão faz push de resultados**: o runner falha a sessão, e em uma saída diferente de zero exibe a cauda do stderr do script para o usuário. Escreva o motivo no stderr como uma única linha curta, escreva-a por último e então saia com código diferente de zero. Não imprima segredos no stderr e remova `set -x` antes de implantar o hook.

185 185 

186 Se o `couldn't find remote ref` do git aparecer aproximadamente nos últimos 4 KB do stderr do hook, o runner relata um branch excluído em vez disso. A mensagem de erro da sessão então diz que o branch não existe mais no remoto e pede ao usuário que o restaure. Se esse branch existir, consulte [Uma sessão falha com `no longer exists on the remote` ou `couldn't find remote ref`](https://code.claude.com/docs/pt/self-hosted-environments-deploy#no-longer-exists-on-the-remote).186 Se o `couldn't find remote ref` do git aparecer aproximadamente nos últimos 4 KB do stderr do hook, o runner relata um branch ausente em vez disso. Se esse branch existir, consulte [Uma sessão falha com `couldn't be found in the remote repository` ou `couldn't find remote ref`](https://code.claude.com/docs/pt/self-hosted-environments-deploy#no-longer-exists-on-the-remote).

187* **Um repositório que a sessão apenas lê**, como um repositório adicionado a uma sessão em execução: o runner o pula e continua com os repositórios restantes. O runner publica um passo `Skipped` para a sessão e remove o que o hook deixou no caminho de checkout.187* **Um repositório que a sessão apenas lê**, como um repositório adicionado a uma sessão em execução: o runner o pula e continua com os repositórios restantes. O runner publica um passo `Skipped` para a sessão e remove o que o hook deixou no caminho de checkout.

188 188 

189 Quando o passo `Skipped` menciona o checkout hook, encontre o detalhe da falha na linha `[runner:warn] checkout hook failed` no log do runner. Quando o passo diz que uma ref de origem `no longer exists on remote`, consulte [Uma sessão falha com `no longer exists on the remote` ou `couldn't find remote ref`](https://code.claude.com/docs/pt/self-hosted-environments-deploy#no-longer-exists-on-the-remote). Se pular deixa a sessão sem nenhum repositório, o runner falha a sessão mesmo assim.189 Quando o passo `Skipped` menciona o checkout hook, encontre o detalhe da falha na linha `[runner:warn] checkout hook failed` no log do runner. Quando o passo diz que uma ref de origem `no longer exists on remote`, consulte [Uma sessão falha com `couldn't be found in the remote repository` ou `couldn't find remote ref`](https://code.claude.com/docs/pt/self-hosted-environments-deploy#no-longer-exists-on-the-remote). Se pular deixa a sessão sem nenhum repositório, o runner falha a sessão mesmo assim.

190 190 

191Quando o hook é bem-sucedido, o runner remove o caminho de checkout após a sessão terminar.191Quando o hook é bem-sucedido, o runner remove o caminho de checkout após a sessão terminar.

192 192 

638 638 

639* O [arquivo MCP gerenciado](https://code.claude.com/docs/pt/managed-mcp.md) de escopo enterprise em seu caminho padrão do sistema: `/etc/claude-code/managed-mcp.json` em hosts de runner Linux, `/Library/Application Support/ClaudeCode/managed-mcp.json` em hosts macOS. Use-o para frotas restritas em que apenas servidores listados pelo administrador podem ser carregados. Consulte [controle exclusivo com managed-mcp.json](https://code.claude.com/docs/pt/managed-mcp.md#exclusive-control-with-managed-mcp-json) para as regras de precedência. Quando esse arquivo está no host do runner, o Claude Code ignora os servidores MCP que o plano de controle da Anthropic entrega a uma sessão, incluindo conectores do claude.ai, e os nomeia em um aviso no stderr do processo filho da sessão, que o runner registra no nível de log `debug`. Antes da v2.1.229, essas sessões encerravam na inicialização com `You cannot dynamically configure MCP servers when an enterprise MCP config is present`.639* O [arquivo MCP gerenciado](https://code.claude.com/docs/pt/managed-mcp.md) de escopo enterprise em seu caminho padrão do sistema: `/etc/claude-code/managed-mcp.json` em hosts de runner Linux, `/Library/Application Support/ClaudeCode/managed-mcp.json` em hosts macOS. Use-o para frotas restritas em que apenas servidores listados pelo administrador podem ser carregados. Consulte [controle exclusivo com managed-mcp.json](https://code.claude.com/docs/pt/managed-mcp.md#exclusive-control-with-managed-mcp-json) para as regras de precedência. Quando esse arquivo está no host do runner, o Claude Code ignora os servidores MCP que o plano de controle da Anthropic entrega a uma sessão, incluindo conectores do claude.ai, e os nomeia em um aviso no stderr do processo filho da sessão, que o runner registra no nível de log `debug`. Antes da v2.1.229, essas sessões encerravam na inicialização com `You cannot dynamically configure MCP servers when an enterprise MCP config is present`.

640* A chave [`managedMcpServers`](https://code.claude.com/docs/pt/settings-reference#managedmcpservers) nas [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) no host do runner: fornece servidores HTTP e SSE sem assumir controle exclusivo, de modo que os servidores das outras fontes ainda são carregados. Requer o Claude Code v2.1.259 ou posterior.640* A chave [`managedMcpServers`](https://code.claude.com/docs/pt/settings-reference#managedmcpservers) nas [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) no host do runner: fornece servidores HTTP e SSE sem assumir controle exclusivo, de modo que os servidores das outras fontes ainda são carregados. Requer o Claude Code v2.1.259 ou posterior.

641* `<repo>/.mcp.json`: escopo de projeto. Fora de uma thread de [projeto](https://code.claude.com/docs/pt/claude-projects.md#what-threads-pick-up-from-your-repositories), faça commit do arquivo no repositório, e seus servidores são aprovados automaticamente em sessões na nuvem. Em uma sessão com vários repositórios, [no máximo o arquivo de um repositório é carregado](#repository-settings-in-sessions-with-several-repositories).641* `<repo>/.mcp.json`: escopo de projeto. Fora de uma thread de [projeto](https://code.claude.com/docs/pt/claude-projects.md#what-threads-pick-up-from-your-repositories), faça commit do arquivo no repositório, e seus servidores são aprovados automaticamente em sessões na nuvem. Em uma sessão com vários repositórios, [no máximo o arquivo de um repositório é carregado](#repository-settings-in-sessions-with-several-repositories). Com [`--trust-workspace false`](https://code.claude.com/docs/pt/self-hosted-environments-reference#runner-cli-flags), as sessões ignoram os servidores do arquivo, exceto quando configurações que não fazem parte dos commits do repositório os aprovam, como [`enabledMcpjsonServers`](https://code.claude.com/docs/pt/settings-reference#enabledmcpjsonservers) no `~/.claude/settings.json` do host. Requer o Claude Code v2.1.319 ou posterior.

642* Um arquivo [`--mcp-config`](https://code.claude.com/docs/pt/cli-reference#cli-flags) do seu script wrapper: acrescente a flag depois de `"$@"`, como em `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`. Para manter os servidores desse arquivo em execução quando os servidores entregues à sessão forem atualizados no meio da sessão, faça com que seu wrapper passe o [ambiente completo](#wrapper-scripts) para o processo filho, como o `exec` faz. Antes da v2.1.299, os servidores stdio, HTTP e SSE desse arquivo eram encerrados na primeira atualização desse tipo que não os nomeasse.642* Um arquivo [`--mcp-config`](https://code.claude.com/docs/pt/cli-reference#cli-flags) do seu script wrapper: acrescente a flag depois de `"$@"`, como em `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`. Para manter os servidores desse arquivo em execução quando os servidores entregues à sessão forem atualizados no meio da sessão, faça com que seu wrapper passe o [ambiente completo](#wrapper-scripts) para o processo filho, como o `exec` faz. Antes da v2.1.299, os servidores stdio, HTTP e SSE desse arquivo eram encerrados na primeira atualização desse tipo que não os nomeasse.

643 643 

644Quando a entrega de conectores está habilitada para sua organização, o plano de controle da Anthropic entrega os conectores que você configurou no claude.ai para sessões criadas interativamente por meio de configuração MCP fornecida pelo servidor, roteada através de `api.anthropic.com`. Sessões criadas programaticamente, como [despachos pela CLI](https://code.claude.com/docs/pt/self-hosted-environments-testing.md#run-the-test-loop), não recebem a entrega de conectores; forneça servidores MCP a elas por meio de qualquer uma das outras fontes listadas nesta seção. O token OAuth do processo filho não carrega um escopo para buscar conectores diretamente, então o processo filho não tenta fazer essa busca por conta própria; a entrega é conduzida pelo servidor.644Quando a entrega de conectores está habilitada para sua organização, o plano de controle da Anthropic entrega os conectores que você configurou no claude.ai para sessões criadas interativamente por meio de configuração MCP fornecida pelo servidor, roteada através de `api.anthropic.com`. Sessões criadas programaticamente, como [despachos pela CLI](https://code.claude.com/docs/pt/self-hosted-environments-testing.md#run-the-test-loop), não recebem a entrega de conectores; forneça servidores MCP a elas por meio de qualquer uma das outras fontes listadas nesta seção. O token OAuth do processo filho não carrega um escopo para buscar conectores diretamente, então o processo filho não tenta fazer essa busca por conta própria; a entrega é conduzida pelo servidor.

908 908 

909Em qualquer outra sessão com vários repositórios, o Claude Code lê as configurações de projeto do diretório em que a sessão inicia, então no máximo o `.claude/settings.json` de um repositório tem efeito como configurações de projeto. Um hook definido no arquivo de outro repositório não é executado, uma regra deny nele não se aplica, e seu `env` não é definido.909Em qualquer outra sessão com vários repositórios, o Claude Code lê as configurações de projeto do diretório em que a sessão inicia, então no máximo o `.claude/settings.json` de um repositório tem efeito como configurações de projeto. Um hook definido no arquivo de outro repositório não é executado, uma regra deny nele não se aplica, e seu `env` não é definido.

910 910 

911* **`--capacity 1`, o padrão, com o checkout integrado**: a sessão inicia no primeiro repositório de sua lista de repositórios. O `.claude/settings.json` desse repositório tem efeito como configurações de projeto e seu `.mcp.json` é carregado, e os dos outros repositórios não.911* **`--capacity 1`, o padrão, com o checkout integrado**: a sessão inicia no primeiro repositório de sua lista de repositórios. O `.claude/settings.json` desse repositório tem efeito como configurações de projeto e seu [`.mcp.json`](#mcp-servers) é carregado, e os dos outros repositórios não.

912* **Um `--capacity` acima de um, ou um [hook `checkout`](#checkout)**: a sessão inicia em um diretório por sessão que contém os checkouts. Nenhum `.claude/settings.json` de repositório tem efeito como configurações de projeto, nenhum `.mcp.json` de repositório é carregado, e [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/pt/hooks#reference-scripts-by-path) em um comando de hook é esse diretório, não um checkout.912* **Um `--capacity` acima de um, ou um [hook `checkout`](#checkout)**: a sessão inicia em um diretório por sessão que contém os checkouts. Nenhum `.claude/settings.json` de repositório tem efeito como configurações de projeto, nenhum `.mcp.json` de repositório é carregado, e [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/pt/hooks#reference-scripts-by-path) em um comando de hook é esse diretório, não um checkout.

913 913 

914O `CLAUDE.md` de cada repositório é carregado onde quer que a sessão inicie. Fora de uma thread de projeto, suas skills também são carregadas. O runner passa cada repositório para o Claude Code como um [diretório adicional](https://code.claude.com/docs/pt/permissions.md#additional-directories-grant-file-access-not-configuration), então o Claude Code também lê as chaves `enabledPlugins` e `extraKnownMarketplaces` do `.claude/settings.json` de cada repositório.914O `CLAUDE.md` de cada repositório é carregado onde quer que a sessão inicie. Fora de uma thread de projeto, suas skills também são carregadas. O runner passa cada repositório para o Claude Code como um [diretório adicional](https://code.claude.com/docs/pt/permissions.md#additional-directories-grant-file-access-not-configuration), então o Claude Code também lê as chaves `enabledPlugins` e `extraKnownMarketplaces` do `.claude/settings.json` de cada repositório.

916* **O runner registra linhas `Poll failed` contendo `rejecting the malformed poll response`**: o runner recebeu uma resposta de work-poll cujo corpo não é o JSON esperado da fila. Uma causa é um proxy interceptador ou um portal cativo respondendo com sua própria página. Se o runner se conecta através de um proxy, configure o proxy para passar as respostas de `api.anthropic.com` inalteradas.916* **O runner registra linhas `Poll failed` contendo `rejecting the malformed poll response`**: o runner recebeu uma resposta de work-poll cujo corpo não é o JSON esperado da fila. Uma causa é um proxy interceptador ou um portal cativo respondendo com sua própria página. Se o runner se conecta através de um proxy, configure o proxy para passar as respostas de `api.anthropic.com` inalteradas.

917 917 

918 O runner rejeita a resposta malformada, a contabiliza sob o tipo `transport` da [métrica](https://code.claude.com/docs/pt/self-hosted-environments-reference.md#prometheus-metrics) `claude_code_self_hosted_runner_poll_errors_total` e tenta novamente no cronograma de poll com falha descrito em [Ciclo de vida da sessão](https://code.claude.com/docs/pt/self-hosted-environments#session-lifecycle). O runner continua servindo suas sessões ativas. Antes da v2.1.246, o runner lia tal resposta como uma fila de trabalho vazia, o que poderia encerrar suas sessões ativas ou fazer com que ele saísse.918 O runner rejeita a resposta malformada, a contabiliza sob o tipo `transport` da [métrica](https://code.claude.com/docs/pt/self-hosted-environments-reference.md#prometheus-metrics) `claude_code_self_hosted_runner_poll_errors_total` e tenta novamente no cronograma de poll com falha descrito em [Ciclo de vida da sessão](https://code.claude.com/docs/pt/self-hosted-environments#session-lifecycle). O runner continua servindo suas sessões ativas. Antes da v2.1.246, o runner lia tal resposta como uma fila de trabalho vazia, o que poderia encerrar suas sessões ativas ou fazer com que ele saísse.

919* **Uma sessão falha com `no longer exists on the remote` ou `couldn't find remote ref`**: o runner interpreta o `couldn't find remote ref` do git como um branch excluído. O branch ainda pode existir. Procure por ele no seu host git, exatamente com o nome que aparece na mensagem, e então verifique cada causa que se aplica:919* **Uma sessão falha com `couldn't be found in the remote repository` ou `couldn't find remote ref`**: procure o branch no seu host git. Pesquise exatamente pelo nome que aparece na mensagem.

920 920 

921 * **O branch não existe mais**: restaure-o, como a mensagem pede.921 O erro da sessão inclui `Retrying will fail the same way until you fix the missing branch described below.` Quando o erro nomeia o branch, o texto sob `Last output before exit:` diz:

922 

923 ```text theme={null}

924 The branch '<ref>' couldn't be found in the remote repository <repo>. If it was never pushed, push it. If it was deleted after a merge, restore it from its pull request. Then send a new message, or start a new session from a branch that has been pushed. (couldn't find remote ref)

925 ```

926 

927 * **O branch não está no host**: envie-o (push) se ele nunca foi enviado, ou restaure-o a partir do seu pull request se ele foi excluído após um merge.

922 * **O branch existe e você não administra o runner**: envie ao administrador do runner a mensagem completa e informe que o branch existe.928 * **O branch existe e você não administra o runner**: envie ao administrador do runner a mensagem completa e informe que o branch existe.

923 * **O branch existe e o runner tem um hook `checkout`**: um comando git no seu hook pode imprimir `couldn't find remote ref` em stderr antes de o hook sair com um código diferente de zero. Encontre esse comando e corrija a ref que ele solicita ou o remoto do qual ele busca. O runner passa ao seu hook a revisão que a sessão solicitou como [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/pt/self-hosted-environments-configuration#checkout).929 * **O branch existe e o runner tem um hook `checkout`**: um comando git no seu hook pode imprimir `couldn't find remote ref` em stderr antes de o hook sair com um código diferente de zero. Encontre esse comando e corrija a ref que ele solicita ou o remoto do qual ele busca. O runner passa ao seu hook a revisão que a sessão solicitou como [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/pt/self-hosted-environments-configuration#checkout).

924 * **O branch existe e o runner não tem um hook `checkout`**: o próprio runner busca o branch. Se um [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks) se aplicar ao repositório, confirme que o host para o qual ele reescreve tem o branch com o mesmo nome e envie o branch para lá se não tiver.930 * **O branch existe e o runner não tem um hook `checkout`**: o próprio runner busca o branch. Se um [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks) se aplicar ao repositório, confirme que o host para o qual ele reescreve tem o branch com o mesmo nome e envie o branch para lá se não tiver.

925 * **O branch existe e o runner é anterior à v2.1.301**: atualize o runner conforme descrito em [Fixe a versão](#pin-the-version), para que uma falha diferente mostre seu próprio erro. Antes da v2.1.301, outras falhas com `couldn't find remote ref` na saída de erro também eram relatadas como um branch excluído.931 * **O branch existe e o runner é anterior à v2.1.301**: atualize o runner conforme descrito em [Fixe a versão](#pin-the-version), para que uma falha diferente mostre seu próprio erro. Antes da v2.1.301, outras falhas com `couldn't find remote ref` na saída de erro também eram relatadas como um branch excluído.

926 932 

927 Depois que o runner for atualizado ou a causa for corrigida, tente novamente a sessão ou inicie uma nova. Se nenhuma dessas verificações encontrar a causa, [relate um problema](#report-an-issue).933 Depois que o runner for atualizado ou a causa for corrigida, envie uma nova mensagem à sessão ou inicie uma nova sessão a partir de um branch que tenha sido enviado. Se nenhuma dessas verificações encontrar a causa, [relate um problema](#report-an-issue). Antes da v2.1.314, a mensagem dizia que o branch `no longer exists on the remote`. Siga as mesmas verificações para essa mensagem.

928 934 

929 Para a fonte para a qual a sessão envia resultados, um branch excluído faz a sessão falhar. Para uma fonte git que a sessão apenas lê, o runner pula essa fonte e continua nas restantes. O runner faz a sessão falhar quando pular a deixaria sem nenhum repositório. Antes da v2.1.228, tal sessão começava em um diretório vazio.935 Para a fonte para a qual a sessão envia resultados, um branch excluído faz a sessão falhar. Para uma fonte git que a sessão apenas lê, o runner pula essa fonte e continua nas restantes. O runner faz a sessão falhar quando pular a deixaria sem nenhum repositório. Antes da v2.1.228, tal sessão começava em um diretório vazio.

930* **O Claude Tag às vezes não publica sua resposta no Slack**: o lembrete de resposta é um [hook que o plano de controle fornece](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled). Confirme que o runner é o Claude Code v2.1.229 ou posterior com `claude --version`, já que runners mais antigos ignoram os hooks fornecidos; confirme que `python3 --version` é bem-sucedido dentro da imagem do runner, já que os hooks executam `python3`; e confirme que nenhum arquivo de configurações desativa os hooks, seja `disableAllHooks` em `managed-settings.json`, no `~/.claude/settings.json` do usuário do runner ou no `.claude/settings.json` ou `.claude/settings.local.json` do repositório, ou `allowManagedHooksOnly` ou um [`strictPluginOnlyCustomization`](https://code.claude.com/docs/pt/settings-reference#strictpluginonlycustomization) que abranja hooks nas configurações gerenciadas.936* **O Claude Tag às vezes não publica sua resposta no Slack**: o lembrete de resposta é um [hook que o plano de controle fornece](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled). Confirme que o runner é o Claude Code v2.1.229 ou posterior com `claude --version`, já que runners mais antigos ignoram os hooks fornecidos; confirme que `python3 --version` é bem-sucedido dentro da imagem do runner, já que os hooks executam `python3`; e confirme que nenhum arquivo de configurações desativa os hooks, seja `disableAllHooks` em `managed-settings.json`, no `~/.claude/settings.json` do usuário do runner ou no `.claude/settings.json` ou `.claude/settings.local.json` do repositório, ou `allowManagedHooksOnly` ou um [`strictPluginOnlyCustomization`](https://code.claude.com/docs/pt/settings-reference#strictpluginonlycustomization) que abranja hooks nas configurações gerenciadas.

125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | Por quanto tempo o runner aguarda, depois que uma sessão atinge seu limite de `--kill-session-after-min`, que um turno em execução termine ou que a liberação seja concluída, antes de encerrar a sessão |125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | Por quanto tempo o runner aguarda, depois que uma sessão atinge seu limite de `--kill-session-after-min`, que um turno em execução termine ou que a liberação seja concluída, antes de encerrar a sessão |

126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | Limite máximo de quanto tempo o runner considera uma sessão ocupada para a drenagem de `--drain-wait-sec` depois que um turno termina, enquanto o processo da sessão informa o fim do turno à Anthropic. `0` ou um valor inutilizável volta ao padrão, portanto a retenção não pode ser desativada. Requer Claude Code v2.1.275 ou posterior. |126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | Limite máximo de quanto tempo o runner considera uma sessão ocupada para a drenagem de `--drain-wait-sec` depois que um turno termina, enquanto o processo da sessão informa o fim do turno à Anthropic. `0` ou um valor inutilizável volta ao padrão, portanto a retenção não pode ser desativada. Requer Claude Code v2.1.275 ou posterior. |

127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | Por quanto tempo o runner aguarda que o sistema operacional entregue `SIGKILL` a um processo filho travado em I/O ininterruptível antes de ele próprio encerrar. Tem como valor mínimo `--post-session-hook-timeout-sec` mais 15 segundos, e mais 30 quando `--push-outcome-on-release` está definido, de modo que o mínimo efetivo é de 75 segundos com os valores padrão. |127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | Por quanto tempo o runner aguarda que o sistema operacional entregue `SIGKILL` a um processo filho travado em I/O ininterruptível antes de ele próprio encerrar. Tem como valor mínimo `--post-session-hook-timeout-sec` mais 15 segundos, e mais 30 quando `--push-outcome-on-release` está definido, de modo que o mínimo efetivo é de 75 segundos com os valores padrão. |

128| `CLAUDE_RUNNER_DISABLE_RENEWAL_WARNING` | não definida | Quando `1`, o runner não publica `The server has refused to renew this session's access to the model` em uma sessão. Após cada recusa, ele aguarda até a próxima renovação agendada para solicitar novamente. Requer Claude Code v2.1.319 ou posterior. |

128| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | Profundidade do git fetch para clones novos. Defina um número inteiro positivo, ou `full` ou `0` para um fetch completo. Para um clone que já está no workspace, consulte [Reutilizar um checkout pré-aquecido](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout). |129| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | Profundidade do git fetch para clones novos. Defina um número inteiro positivo, ou `full` ou `0` para um fetch completo. Para um clone que já está no workspace, consulte [Reutilizar um checkout pré-aquecido](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout). |

129| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | Por quanto tempo em milissegundos, por tentativa, um git fetch pode aguardar seus primeiros dados enquanto os próprios números de progresso do servidor git continuam aumentando, como quando o servidor prepara o pack para um repositório grande. `0` ou `off` desativa a espera: esse fetch é então interrompido após dois minutos sem dados. Qualquer outro número inteiro é restringido ao intervalo entre `120000` e `1800000`, de 2 a 30 minutos. Requer Claude Code v2.1.295 ou posterior. |130| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | Por quanto tempo em milissegundos, por tentativa, um git fetch pode aguardar seus primeiros dados enquanto os próprios números de progresso do servidor git continuam aumentando, como quando o servidor prepara o pack para um repositório grande. `0` ou `off` desativa a espera: esse fetch é então interrompido após dois minutos sem dados. Qualquer outro número inteiro é restringido ao intervalo entre `120000` e `1800000`, de 2 a 30 minutos. Requer Claude Code v2.1.295 ou posterior. |

130| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | não definida | Quando `1`, ignora a verificação da presença de `.git` após a execução de um hook `checkout`. Defina isso quando seu hook materializar uma fonte que não seja git. |131| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | não definida | Quando `1`, ignora a verificação da presença de `.git` após a execução de um hook `checkout`. Defina isso quando seu hook materializar uma fonte que não seja git. |

135 136 

136Filhos de sessão enviam telemetria operacional para Anthropic a menos que você a desative. Nenhum código ou conteúdo de repositório é enviado. Defina variáveis de telemetria no processo do executor; o executor as re-afirma após aplicar variáveis de ambiente fornecidas pelo servidor, então a configuração do operador sempre tem precedência.137Filhos de sessão enviam telemetria operacional para Anthropic a menos que você a desative. Nenhum código ou conteúdo de repositório é enviado. Defina variáveis de telemetria no processo do executor; o executor as re-afirma após aplicar variáveis de ambiente fornecidas pelo servidor, então a configuração do operador sempre tem precedência.

137 138 

138Um controle é específico para ambientes auto-hospedados: `CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` opta por métricas operacionais Datadog, que estão desligadas por padrão em ambientes auto-hospedados. Os controles gerais de telemetria Claude Code, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_ERROR_REPORTING` e `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, se aplicam a filhos de sessão conforme documentado na [referência de variável de ambiente](https://code.claude.com/docs/pt/env-vars.md). `DISABLE_GROWTHBOOK` é relacionado mas diferente: definir `DISABLE_GROWTHBOOK=1` desabilita a busca de sinalizador de recurso, e a telemetria permanece ativada a menos que `DISABLE_TELEMETRY` também esteja definido.139Um controle é específico para ambientes auto-hospedados: `CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` opta por métricas operacionais Datadog, que estão desligadas por padrão em ambientes auto-hospedados. Os controles gerais de telemetria Claude Code, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_ERROR_REPORTING` e `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, se aplicam a filhos de sessão conforme documentado na [referência de variável de ambiente](https://code.claude.com/docs/pt/env-vars.md). [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/pt/env-vars#variables) é relacionado mas diferente: definir `CLAUDE_CODE_DISABLE_FEATURE_FLAGS=1` desabilita a busca de sinalizador de recurso, e a telemetria permanece ativada a menos que `DISABLE_TELEMETRY` também esteja definido. `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` requer Claude Code v2.1.319 ou posterior.

139 140 

140`CLAUDE_CODE_ENABLE_TELEMETRY` não está relacionado: habilita a exportação OpenTelemetry para seu próprio coletor, conforme descrito em [Monitoring](https://code.claude.com/docs/pt/monitoring-usage.md), e não controla a análise da Anthropic.141`CLAUDE_CODE_ENABLE_TELEMETRY` não está relacionado: habilita a exportação OpenTelemetry para seu próprio coletor, conforme descrito em [Monitoring](https://code.claude.com/docs/pt/monitoring-usage.md), e não controla a análise da Anthropic.

141 142 

108 108 

109Em uma sessão em execução, `/status` mostra a mesma linha após uma busca com falha e, para algumas causas de busca pulada, como uma variável de provedor de terceiros ou um `ANTHROPIC_BASE_URL` personalizado exportado no shell do usuário.109Em uma sessão em execução, `/status` mostra a mesma linha após uma busca com falha e, para algumas causas de busca pulada, como uma variável de provedor de terceiros ou um `ANTHROPIC_BASE_URL` personalizado exportado no shell do usuário.

110 110 

111### Dar configurações diferentes a grupos

112 

113Em um plano Enterprise, você pode dar a cada grupo de membros sua própria configuração em vez de uma única configuração para toda a organização. Se sua organização tiver o [HIPAA habilitado](https://code.claude.com/docs/pt/hipaa-setup.md), as configurações de grupo ainda não estão disponíveis. Cada grupo já deve existir, seja sincronizado a partir do seu provedor de identidade por meio de SCIM ou como um grupo personalizado que você gerencia no console de administração.

114 

115Cada membro recebe no máximo uma configuração, a mesma em todos os dispositivos:

116 

117* **Um membro de um grupo com uma configuração**: a configuração com a classificação mais alta entre seus grupos

118* **Qualquer outra pessoa**, incluindo um membro cujo único grupo com uma configuração foi excluído: a configuração geral (catch-all), se você definir uma

119 

120As configurações não são mescladas entre si nem com a configuração de toda a organização, portanto cada uma deve conter todas as opções de configuração que você deseja que esse grupo tenha. Para aplicar uma restrição a todos os membros, coloque-a em todas as configurações de grupo e na configuração geral.

121 

122Os membros continuam recebendo a configuração de toda a organização até o último destes passos, para que você possa preparar e testar tudo primeiro:

123 

124**1. Adicionar uma configuração para cada grupo**

125 

126Em [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code), clique em **Add configuration**, escolha o grupo e escolha um ponto de partida. Para flexibilizar a política de um grupo, escolha um grupo que seu provedor de identidade sincroniza, para que ninguém possa se adicionar a ele no console de administração.

127 

128Para manter o que os membros têm hoje e alterar algumas opções de configuração, comece a partir de uma cópia da configuração de toda a organização. Edite a configuração e salve-a.

129 

130**2. Definir a configuração geral**

131 

132Clique em **Set** em **Everyone else** e adicione o JSON para os membros que não correspondem a nenhuma configuração de grupo. Para deixá-los com o que têm hoje, cole a configuração de toda a organização. Se você pular este passo, as sessões locais deles não recebem configurações gerenciadas pelo servidor, e quaisquer [configurações gerenciadas pelo endpoint](https://code.claude.com/docs/pt/managed-settings.md#delivery-mechanisms) no dispositivo ainda se aplicam.

133 

134**3. Classificar os grupos**

135 

136Arraste as configurações para ordená-las. Um membro de vários grupos recebe apenas a configuração com a classificação mais alta, então coloque seus grupos mais restritivos ou mais específicos no topo.

137 

138**4. Verificar quem recebe o quê**

139 

140Em **Check effective settings**, na parte inferior da página, pesquise um membro para ver qual configuração ele receberia. Verifique um membro de cada grupo, um membro de vários grupos e um membro que não corresponde a nenhuma configuração de grupo.

141 

142**5. Mudar para o modo baseado em grupos**

143 

144Clique em **Switch to group-based configurations** no banner na parte superior da página e confirme. Os membros recebem suas configurações em cerca de uma hora, exceto as [chaves que se aplicam apenas na próxima inicialização](#fetch-and-caching-behavior). Para voltar, mude para o modo de toda a organização no mesmo banner: a configuração de toda a organização volta a se aplicar, se você tiver uma, e suas configurações de grupo são mantidas.

145 

146Os limites de modelo de um grupo valem apenas em sessões locais. Sessões na nuvem e sessões remotas do Cowork usam a lista [`availableModels`](https://code.claude.com/docs/pt/model-config#restrict-model-selection) da configuração geral. Se você não definir uma configuração geral, ela vem da configuração de toda a organização, mesmo depois de você mudar para o modo baseado em grupos. Se você deixar a chave fora da configuração geral, os membros não são limitados por essa lista nessas sessões.

147 

148Se você usar a configuração de um grupo para definir para onde as requisições de API vão, isso se aplica apenas ao Claude Code, não a outras ferramentas que chamam a API.

149 

111### Controle de acesso150### Controle de acesso

112 151 

113Os seguintes papéis podem gerenciar configurações gerenciadas pelo servidor:152Os seguintes papéis podem gerenciar configurações gerenciadas pelo servidor:

115* **Primary Owner**154* **Primary Owner**

116* **Owner**155* **Owner**

117 156 

118Restrinja o acesso a pessoal confiável, pois as alterações de configurações se aplicam a todos os usuários da organização.157Restrinja o acesso a pessoal confiável, pois as alterações de configurações podem se aplicar a todos os usuários da organização.

119 158 

120### Configurações apenas gerenciadas159### Configurações apenas gerenciadas

121 160 

125 164 

126As configurações gerenciadas pelo servidor têm as seguintes limitações:165As configurações gerenciadas pelo servidor têm as seguintes limitações:

127 166 

128* As configurações se aplicam uniformemente a todos os usuários da organização. Configurações por grupo ainda não são suportadas.167* Em um plano Team, as configurações se aplicam uniformemente a todos os usuários da organização. [Configurações de grupo](#give-groups-different-settings) exigem um plano Enterprise.

129* Você não pode distribuir um arquivo [`managed-mcp.json`](https://code.claude.com/docs/pt/managed-mcp) através de configurações gerenciadas pelo servidor. Entregue as chaves de política `allowedMcpServers` e `deniedMcpServers` lá em vez disso. No Claude Code v2.1.259 ou posterior, você também pode fornecer servidores remotos com [`managedMcpServers`](https://code.claude.com/docs/pt/managed-mcp#provide-servers-through-managed-settings), que aceita apenas servidores `http` e `sse` e não assume controle exclusivo da forma que o arquivo faz.168* Você não pode distribuir um arquivo [`managed-mcp.json`](https://code.claude.com/docs/pt/managed-mcp) através de configurações gerenciadas pelo servidor. Entregue as chaves de política `allowedMcpServers` e `deniedMcpServers` lá em vez disso. No Claude Code v2.1.259 ou posterior, você também pode fornecer servidores remotos com [`managedMcpServers`](https://code.claude.com/docs/pt/managed-mcp#provide-servers-through-managed-settings), que aceita apenas servidores `http` e `sse` e não assume controle exclusivo da forma que o arquivo faz.

130 169 

131 Claude Code lê um `managed-mcp.json` implantado em seu [caminho do sistema](https://code.claude.com/docs/pt/managed-mcp.md#exclusive-control-with-managed-mcp-json) separadamente da camada de configurações gerenciadas, portanto, o arquivo ainda se aplica quando as configurações gerenciadas pelo servidor estão em vigor.170 Claude Code lê um `managed-mcp.json` implantado em seu [caminho do sistema](https://code.claude.com/docs/pt/managed-mcp.md#exclusive-control-with-managed-mcp-json) separadamente da camada de configurações gerenciadas, portanto, o arquivo ainda se aplica quando as configurações gerenciadas pelo servidor estão em vigor.

245* `cleanupPeriodDays` encurta a retenção de transcrições de sessão e outros dados locais para sete dias245* `cleanupPeriodDays` encurta a retenção de transcrições de sessão e outros dados locais para sete dias

246* `companyAnnouncements` mostra uma mensagem na inicialização246* `companyAnnouncements` mostra uma mensagem na inicialização

247 247 

248Os administradores implantam um arquivo como este como `managed-settings.json`, ou o mesmo JSON através de MDM ou [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Um arquivo implantado se aplica a cada máquina ou conta que alcança. Para dar a um grupo valores diferentes, implante um arquivo ou perfil diferente para esse grupo, já que [as configurações gerenciadas pelo servidor não suportam política por grupo ainda](https://code.claude.com/docs/pt/server-managed-settings.md#current-limitations).248Os administradores implantam um arquivo como este como `managed-settings.json`, ou o mesmo JSON através de MDM ou [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Um arquivo implantado se aplica a cada máquina ou conta que alcança. Para dar a um grupo valores diferentes, implante um arquivo ou perfil diferente para esse grupo. Em um plano Enterprise, você pode, em vez disso, [dar ao grupo sua própria configuração](https://code.claude.com/docs/pt/server-managed-settings.md#give-groups-different-settings) nas configurações gerenciadas pelo servidor.

249 249 

250> [tab] Arquivo de configurações copiável250> [tab] Arquivo de configurações copiável

251>251>

91| `managed-agents-secure [<agent-id>]` | Leia as configurações de um Managed Agent e relate onde elas correspondem ao guia [Proteja sua implantação de Managed Agents](https://platform.claude.com/docs/en/managed-agents/secure-deployment) ou diferem dele. Requer a [CLI `ant`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 ou posterior |91| `managed-agents-secure [<agent-id>]` | Leia as configurações de um Managed Agent e relate onde elas correspondem ao guia [Proteja sua implantação de Managed Agents](https://platform.claude.com/docs/en/managed-agents/secure-deployment) ou diferem dele. Requer a [CLI `ant`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 ou posterior |

92| `prompt-audit` | Sinalize instruções escritas para modelos mais antigos em seus prompts, skills e descrições de ferramentas e proponha correções como um diff | v2.1.221 ou posterior |92| `prompt-audit` | Sinalize instruções escritas para modelos mais antigos em seus prompts, skills e descrições de ferramentas e proponha correções como um diff | v2.1.221 ou posterior |

93| `cost-optimize` | Perfil onde o gasto da Claude API do seu projeto vai e proponha economias de opções como prompt caching, redução de tokens de entrada e saída desnecessários, processamento em lote, esforço e escolha de modelo, uma alteração por vez | v2.1.247 ou posterior |93| `cost-optimize` | Perfil onde o gasto da Claude API do seu projeto vai e proponha economias de opções como prompt caching, redução de tokens de entrada e saída desnecessários, processamento em lote, esforço e escolha de modelo, uma alteração por vez | v2.1.247 ou posterior |

94| `latency-optimize` | Descubra onde o tempo é gasto no seu código Claude API existente e proponha alterações que reduzam o tempo que as pessoas esperam | v2.1.319 ou posterior |

94| `build-eval` | Construa um conjunto de avaliação para seu aplicativo alimentado por Claude | v2.1.259 ou posterior |95| `build-eval` | Construa um conjunto de avaliação para seu aplicativo alimentado por Claude | v2.1.259 ou posterior |

95| `hillclimb` | Melhore iterativamente seu aplicativo em relação a uma avaliação existente | v2.1.259 ou posterior |96| `hillclimb` | Melhore iterativamente seu aplicativo em relação a uma avaliação existente | v2.1.259 ou posterior |

96| `preserved-thinking-migration` | Encontre as edições que sua integração faz em turnos anteriores, seu prompt do sistema ou sua lista de ferramentas que invalidam blocos de [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking), meça quanto raciocínio cada um descarta e proponha correções uma de cada vez, remensurando após cada alteração | v2.1.282 ou posterior |97| `preserved-thinking-migration` | Encontre as edições que sua integração faz em turnos anteriores, seu prompt do sistema ou sua lista de ferramentas que invalidam blocos de [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking), meça quanto raciocínio cada um descarta e proponha correções uma de cada vez, remensurando após cada alteração | v2.1.282 ou posterior |

197O limite de tempo é contado a partir do momento em que o comando entra em segundo plano:197O limite de tempo é contado a partir do momento em que o comando entra em segundo plano:

198 198 

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

200* Um comando que começa em primeiro plano e depois se move para segundo plano, por exemplo em seu timeout, obtém 30 minutos a partir da mudança200* Um comando que começa em primeiro plano e depois se move para segundo plano em seu timeout obtém 30 minutos a partir da mudança

201 201 

202Em uma execução com a flag `-p` cujo prompt você passa como texto em vez de com `--input-format stream-json`, ambos os padrões são de 10 minutos em vez de 30, porque a execução [aguarda os comandos em segundo plano após seu resultado](https://code.claude.com/docs/pt/headless.md#background-tasks-at-exit).202Em uma execução com a flag `-p` cujo prompt você passa como texto em vez de com `--input-format stream-json`, ambos os padrões são de 10 minutos em vez de 30, porque a execução [aguarda os comandos em segundo plano após seu resultado](https://code.claude.com/docs/pt/headless.md#background-tasks-at-exit).

203 203 

399 399 

400Se o recarregamento interrompeu o Claude no meio de uma etapa, o Claude continua essa etapa quando a conversa volta, e um aviso no chat marca a continuação. Requer o Claude Code v2.1.274 ou posterior. Se a etapa foi interrompida há mais de uma hora ou se a sessão estiver aberta em outro lugar, a conversa volta ociosa.400Se o recarregamento interrompeu o Claude no meio de uma etapa, o Claude continua essa etapa quando a conversa volta, e um aviso no chat marca a continuação. Requer o Claude Code v2.1.274 ou posterior. Se a etapa foi interrompida há mais de uma hora ou se a sessão estiver aberta em outro lugar, a conversa volta ociosa.

401 401 

402Quando um aviso no chat incluir `plan mode is now off, so Claude did not continue on its own`, a etapa foi interrompida no modo de planejamento. Para continuar planejando, selecione **Plan** no indicador de modo antes de enviar sua próxima mensagem.

403 

402#### Desative a continuação após um recarregamento404#### Desative a continuação após um recarregamento

403 405 

404Para impedir que o Claude continue uma etapa interrompida após um recarregamento, abra a [configuração Continue After Reload](vscode://settings/claudeCode.continueAfterReload) e desmarque-a.406Para impedir que o Claude continue uma etapa interrompida após um recarregamento, abra a [configuração Continue After Reload](vscode://settings/claudeCode.continueAfterReload) e desmarque-a.

626 628 

627## Comandos e atalhos do VS Code629## Comandos e atalhos do VS Code

628 630 

629Para abrir a Paleta de Comandos, pressione `Cmd+Shift+P` no Mac ou `Ctrl+Shift+P` no Windows/Linux. Digite "Claude Code" ali para ver todos os comandos do VS Code disponíveis para a extensão Claude Code.631Para abrir a Paleta de Comandos, pressione `Cmd+Shift+P` no Mac ou `Ctrl+Shift+P` no Windows/Linux. Digite "Claude Code" ali para ver os comandos da extensão na Paleta de Comandos.

630 632 

631Alguns atalhos dependem de qual painel está "em foco" (recebendo a entrada do teclado). Quando seu cursor está em um arquivo de código, o editor está em foco. Quando seu cursor está na caixa de prompt do Claude, o Claude está em foco. Use `Cmd+Esc` / `Ctrl+Esc` para alternar entre eles.633Alguns atalhos dependem de qual painel está "em foco" (recebendo a entrada do teclado). Quando seu cursor está em um arquivo de código, o editor está em foco. Quando seu cursor está na caixa de prompt do Claude, o Claude está em foco. Use `Cmd+Esc` / `Ctrl+Esc` para alternar entre eles.

632 634 

651| Rename Session Tab | - | Renomeia a sessão na aba ativa do Claude. Requer Claude Code v2.1.257 ou posterior |653| Rename Session Tab | - | Renomeia a sessão na aba ativa do Claude. Requer Claude Code v2.1.257 ou posterior |

652| Add Session Tab to Group | - | Adiciona a sessão na aba ativa do Claude a um [grupo de sessões](#organize-sessions-into-groups) que você escolher ou criar. Requer Claude Code v2.1.257 ou posterior |654| Add Session Tab to Group | - | Adiciona a sessão na aba ativa do Claude a um [grupo de sessões](#organize-sessions-into-groups) que você escolher ou criar. Requer Claude Code v2.1.257 ou posterior |

653| Mark Session as Unread | - | Marca a sessão na aba ativa do Claude como não lida na lista de sessões. Requer Claude Code v2.1.257 ou posterior |655| Mark Session as Unread | - | Marca a sessão na aba ativa do Claude como não lida na lista de sessões. Requer Claude Code v2.1.257 ou posterior |

656| `claude-vscode.toggleDictation` | `Cmd+D` (Mac) / `Ctrl+D` (Windows/Linux) | Inicia ou interrompe o [ditado por voz](https://code.claude.com/docs/pt/voice-dictation.md). O atalho requer que o Claude esteja em foco. Este comando não está na Paleta de Comandos |

654| Show Logs | - | Visualiza os logs de depuração da extensão |657| Show Logs | - | Visualiza os logs de depuração da extensão |

655| Logout | - | Sai da sua conta Anthropic |658| Logout | - | Sai da sua conta Anthropic |

656 659 

80* **Pro, Max e Ultra**: você recebe automaticamente um ambiente chamado **Default**.80* **Pro, Max e Ultra**: você recebe automaticamente um ambiente chamado **Default**.