SpyBara
Go Premium

Documentation 2026-10-03 23:57 UTC to 2026-10-04 09:58 UTC

33 files changed +604 −487. View all changes and history on the product overview
2026
Sun 4 10:59 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59

agent-view.md +5 −2

Details

347 347 

348Para combinar filtros, comece com `a:`, `s:`, `n:` ou `o:` e adicione mais, separados por espaços. A lista mostra as sessões que correspondem a todos eles. Por exemplo, `s:blocked a:reviewer` lista as sessões `reviewer` que estão aguardando você.348Para combinar filtros, comece com `a:`, `s:`, `n:` ou `o:` e adicione mais, separados por espaços. A lista mostra as sessões que correspondem a todos eles. Por exemplo, `s:blocked a:reviewer` lista as sessões `reviewer` que estão aguardando você.

349 349 

350Enquanto um filtro está ativo, os grupos que você recolheu se expandem para mostrar suas correspondências e a primeira correspondência é selecionada, então pressionar `Enter` a abre. Limpe a entrada para remover o filtro, e esses grupos se recolhem novamente.350Enquanto um filtro está ativo, os grupos que você recolheu se expandem para mostrar suas correspondências e uma correspondência é selecionada, então pressionar `Enter` a abre. Limpe a entrada para remover o filtro, e esses grupos se recolhem novamente.

351 351 

352<h3 id="keyboard-shortcuts">352<h3 id="keyboard-shortcuts">

353 Atalhos de teclado353 Atalhos de teclado


369| `Tab` | Em uma entrada vazia, procurar todos os subagents. Caso contrário, aplicar a sugestão destacada |369| `Tab` | Em uma entrada vazia, procurar todos os subagents. Caso contrário, aplicar a sugestão destacada |

370| `Ctrl+S` | Alternar agrupamento entre estado e diretório |370| `Ctrl+S` | Alternar agrupamento entre estado e diretório |

371| `Ctrl+T` | Fixar ou desafixar a sessão selecionada |371| `Ctrl+T` | Fixar ou desafixar a sessão selecionada |

372| `Ctrl+F` | Encontrar sessões por nome, com o [filtro `n:`](#filter-sessions) |

373| `Alt+↑` / `Alt+↓` | Ir para o cabeçalho de grupo anterior ou seguinte |

372| `Ctrl+R` | Renomear a sessão selecionada |374| `Ctrl+R` | Renomear a sessão selecionada |

373| `Ctrl+G` | Abrir o prompt de despacho em seu `$VISUAL` ou `$EDITOR` |375| `Ctrl+G` | Abrir o prompt de despacho em seu `$VISUAL` ou `$EDITOR` |

374| `Ctrl+J` | Inserir uma nova linha na entrada de despacho |376| `Ctrl+J` | Inserir uma nova linha na entrada de despacho |


378| `Ctrl+C` | Limpar a entrada; pressione duas vezes para sair |380| `Ctrl+C` | Limpar a entrada; pressione duas vezes para sair |

379| `?` | Mostrar todos os atalhos |381| `?` | Mostrar todos os atalhos |

380 382 

381`Ctrl+S`, `Ctrl+T` e `Ctrl+G` seguem seu [`keybindings.json`](/docs/pt/keybindings). Rebind ou unbind `Ctrl+S` e `Ctrl+T` com as ações `agents:switchView` e `agents:togglePin` no [contexto `Agents`](/docs/pt/keybindings#agents-actions), e `Ctrl+G` através da vinculação `chat:externalEditor` do contexto `Chat`. Os outros atalhos na tabela não podem ser revinculados.383Os atalhos que têm uma ação no [contexto `Agents`](/docs/pt/keybindings#agents-actions) seguem seu [`keybindings.json`](/docs/pt/keybindings). O mesmo vale para `Ctrl+G`, através da vinculação `chat:externalEditor` do contexto `Chat`.

382 384 

383<h2 id="dispatch-new-agents">385<h2 id="dispatch-new-agents">

384 Despachar novos agentes386 Despachar novos agentes


1087 1089 

1088| Versão | Mudança |1090| Versão | Mudança |

1089| - | - |1091| - | - |

1092| v2.1.288 | `Ctrl+F` encontra sessões pelo nome, e `Alt+↑` / `Alt+↓` saltam entre os cabeçalhos de grupo. Ambos, e `Ctrl+R`, podem ser [reatribuídos](/docs/pt/keybindings#agents-actions). |

1090| v2.1.287 | O [filtro `n:<text>`](#filter-sessions) encontra sessões pelo nome ou pelo primeiro prompt. Enquanto qualquer filtro estiver ativo, os grupos que você recolheu se expandem para mostrar suas correspondências e a primeira correspondência é selecionada, então `Enter` a abre. |1093| v2.1.287 | O [filtro `n:<text>`](#filter-sessions) encontra sessões pelo nome ou pelo primeiro prompt. Enquanto qualquer filtro estiver ativo, os grupos que você recolheu se expandem para mostrar suas correspondências e a primeira correspondência é selecionada, então `Enter` a abre. |

1091| v2.1.287 | Um comando enviado como uma [resposta pela espiada](#peek-and-reply) é executado quando o turno atual da sessão termina, incluindo os comandos que são executados assim que você os digita no próprio prompt de uma sessão. Uma resposta que seja exatamente `/stop` para a sessão imediatamente. |1094| v2.1.287 | Um comando enviado como uma [resposta pela espiada](#peek-and-reply) é executado quando o turno atual da sessão termina, incluindo os comandos que são executados assim que você os digita no próprio prompt de uma sessão. Uma resposta que seja exatamente `/stop` para a sessão imediatamente. |

1092| v2.1.281 | Uma restrição [`--setting-sources`](/docs/pt/cli-reference#cli-flags) [se estende](#what-carries-over-when-you-background) para uma sessão que você coloca em background com `←` ou `/bg` e para as sessões que você despacha a partir de agent view. Antes desta versão, a sessão gerada carregava todas as fontes de configurações. |1095| v2.1.281 | Uma restrição [`--setting-sources`](/docs/pt/cli-reference#cli-flags) [se estende](#what-carries-over-when-you-background) para uma sessão que você coloca em background com `←` ou `/bg` e para as sessões que você despacha a partir de agent view. Antes desta versão, a sessão gerada carregava todas as fontes de configurações. |

artifacts.md +3 −1

Details

156 Deixar Claude responder a comentários por conta própria156 Deixar Claude responder a comentários por conta própria

157</h3>157</h3>

158 158 

159Depois que sua sessão publica um artefato, Claude Code observa esse artefato em busca de comentários enquanto a sessão é executada. Quando alguém que pode editar o artefato envia um comentário para Claude, ele chega à sua sessão imediatamente, e Claude pode ler a thread e responder sem você pedir.159Depois que sua sessão publica um artefato, Claude Code observa esse artefato em busca de comentários. Quando alguém que pode editar o artefato envia um comentário para Claude, ele chega à sua sessão imediatamente, e Claude pode ler a thread e responder sem você pedir.

160 160 

161Você precisa do Claude Code v2.1.228 ou posterior. Se você desativou a [busca de feature-flag](/docs/pt/env-vars#features-that-need-feature-flag-fetching), Claude Code não observa comentários.161Você precisa do Claude Code v2.1.228 ou posterior. Se você desativou a [busca de feature-flag](/docs/pt/env-vars#features-that-need-feature-flag-fetching), Claude Code não observa comentários.

162 162 


174* **Pare a tarefa em `/tasks`**: Claude para de responder nesse artefato até você pedir a ele para retomar as respostas lá. Publicar o artefato novamente não inicia as respostas novamente, e a parada ainda se aplica quando você retoma a sessão mais tarde.174* **Pare a tarefa em `/tasks`**: Claude para de responder nesse artefato até você pedir a ele para retomar as respostas lá. Publicar o artefato novamente não inicia as respostas novamente, e a parada ainda se aplica quando você retoma a sessão mais tarde.

175* **Pressione `Ctrl+X Ctrl+K` duas vezes em 3 segundos**: o atalho que [para cada subagente de fundo em execução](/docs/pt/interactive-mode#general-controls) também para Claude de responder em cada artefato pelo resto da sessão. Pedir a Claude para retomar as respostas não desfaz essa parada.175* **Pressione `Ctrl+X Ctrl+K` duas vezes em 3 segundos**: o atalho que [para cada subagente de fundo em execução](/docs/pt/interactive-mode#general-controls) também para Claude de responder em cada artefato pelo resto da sessão. Pedir a Claude para retomar as respostas não desfaz essa parada.

176 176 

177Uma observação que Claude Code iniciou por conta própria pode terminar depois que o artefato passa várias horas sem atividade. Para iniciar a observação novamente, publique o artefato novamente ou peça a Claude para observá-lo.

178 

177Se o serviço que entrega comentários ficar indisponível ou parar de responder, Claude Code continua tentando se reconectar por um tempo, depois para de observar cada artefato que sua sessão estava observando.179Se o serviço que entrega comentários ficar indisponível ou parar de responder, Claude Code continua tentando se reconectar por um tempo, depois para de observar cada artefato que sua sessão estava observando.

178 180 

179<h2 id="pull-live-data-with-mcp-connectors">181<h2 id="pull-live-data-with-mcp-connectors">

Details

261 Conectar desenvolvedores261 Conectar desenvolvedores

262</h2>262</h2>

263 263 

264Os desenvolvedores se conectam de seus próprios laptops com um sign-in de navegador, usando sua conta de trabalho corporativa. Eles não precisam de uma conta claude.ai, uma chave de API ou uma assinatura, porque as solicitações para o modelo passam pelo gateway usando a credencial upstream da organização. A conexão é orientada pelas [configurações gerenciadas no lado do cliente](/docs/pt/claude-apps-gateway-config#client-side-managed-settings) que você envia via MDM, então não há configuração manual no lado do desenvolvedor; esta seção cobre o que o administrador configura.264Os desenvolvedores se conectam de seus próprios laptops com um sign-in de navegador, usando sua conta de trabalho corporativa. Eles não precisam de uma conta claude.ai, uma chave de API ou uma assinatura, porque as requisições para o modelo passam pelo gateway usando a credencial upstream da organização. A conexão é orientada pelas [configurações gerenciadas no lado do cliente](/docs/pt/claude-apps-gateway-config#client-side-managed-settings) que você envia via MDM, então não há configuração manual no lado do desenvolvedor; esta seção cobre o que o administrador configura.

265 265 

266A CLI coloca a impressão digital do certificado TLS folha do gateway na primeira conexão e a fixa por nome de host. Ela verifica esse pino novamente durante o sign-in, em atualizações de sessão silenciosas e em buscas de configurações gerenciadas, enquanto solicitações de inferência usam validação TLS padrão sem o pino. Solicitações roteadas através de um proxy HTTPS pulam a verificação de pino, então adicione o host do gateway a `NO_PROXY` para mantê-las diretas.266A CLI coloca a impressão digital do certificado TLS folha do gateway na primeira conexão e a fixa por nome de host. Ela verifica esse pino novamente durante o sign-in, em atualizações de sessão silenciosas e em buscas de configurações gerenciadas, enquanto requisições de inferência usam validação TLS padrão sem o pino. Requisições roteadas através de um proxy HTTPS pulam a verificação de pino, então adicione o host do gateway a `NO_PROXY` para mantê-las diretas.

267 267 

268Publique a impressão digital SHA-256 esperada junto com a URL do gateway para que os desenvolvedores tenham algo para comparar. O prompt `/login` mostra os primeiros 16 caracteres da impressão digital como hexadecimal minúsculo sem dois-pontos. Para imprimir a impressão digital completa nesse formato a partir do arquivo de certificado, execute:268Publique a impressão digital SHA-256 esperada junto com a URL do gateway para que os desenvolvedores tenham algo para comparar. O prompt `/login` mostra os primeiros 16 caracteres da impressão digital como hexadecimal minúsculo sem dois-pontos. Para imprimir a impressão digital completa nesse formato a partir do arquivo de certificado, execute:

269 269 


277 277 

278A confirmação requer Claude Code v2.1.275 ou posterior na máquina do desenvolvedor; um cliente abaixo dessa versão ignora o campo. O servidor do gateway no binário `claude` não retorna o campo, então seus sign-ins são concluídos sem a confirmação.278A confirmação requer Claude Code v2.1.275 ou posterior na máquina do desenvolvedor; um cliente abaixo dessa versão ignora o campo. O servidor do gateway no binário `claude` não retorna o campo, então seus sign-ins são concluídos sem a confirmação.

279 279 

280Uma vez que o desenvolvedor faz login, o [seletor de modelo](/docs/pt/model-config) mostra os modelos na lista de permissões `availableModels` do desenvolvedor. As configurações gerenciadas se aplicam na inicialização e atualizam a cada hora, e a telemetria é roteada para seu coletor.280Uma vez que o desenvolvedor faz login, o [seletor de modelo](/docs/pt/model-config) mostra os modelos na allowlist `availableModels` do desenvolvedor. As configurações gerenciadas se aplicam na inicialização e atualizam a cada hora, e a telemetria é roteada para seu coletor.

281 281 

282As sessões são atualizadas silenciosamente antes da expiração de `ttl_hours`. Quando uma atualização falha após desprovisionamento de IdP, Claude Code solicita que o desenvolvedor faça login novamente.282As sessões são atualizadas silenciosamente antes da expiração de `ttl_hours`. Quando uma atualização falha após desprovisionamento de IdP, Claude Code solicita que o desenvolvedor faça login novamente.

283 283 


285 Defina a URL do gateway285 Defina a URL do gateway

286</h3>286</h3>

287 287 

288Três chaves vão no arquivo de [configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms) por SO que você implanta via MDM ou diretamente no disco. `forceLoginMethod` e `forceLoginGatewayUrl` abrem `/login` diretamente na tela **Cloud gateway** com a URL preenchida, e `parentSettingsBehavior: "merge"` permite que Claude Desktop entregue a lista de permissões de egresso do gateway para as sessões Claude Code que ele inicia, explicado em [Entregar política para sessões Claude Desktop](#deliver-policy-to-claude-desktop-sessions):288Três chaves vão no arquivo de [configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms) por SO que você implanta via MDM ou diretamente no disco. `forceLoginMethod` e `forceLoginGatewayUrl` abrem `/login` diretamente na tela **Cloud gateway** com a URL preenchida, e `parentSettingsBehavior: "merge"` permite que Claude Desktop entregue a allowlist de egresso do gateway para as sessões Claude Code que ele inicia, explicado em [Entregar política para sessões Claude Desktop](#deliver-policy-to-claude-desktop-sessions):

289 289 

290```json theme={null}290```json theme={null}

291{291{


303 Permitir um gateway em espaço de endereço público que você possui303 Permitir um gateway em espaço de endereço público que você possui

304</h3>304</h3>

305 305 

306Algumas organizações numerem sua rede interna a partir de um bloco IPv4 público que possuem, como o espaço de endereço próprio de uma operadora ou um `/8` legado, então seu gateway não pode ter um endereço privado. Liste esses blocos na configuração gerenciada `gatewayInternalNetworks`. `/login` então aceita um gateway dentro de um bloco listado quando a máquina do desenvolvedor se conecta a ele a partir de um endereço dentro do mesmo bloco. Isso requer Claude Code v2.1.268 ou posterior na máquina do desenvolvedor; versões anteriores ignoram a chave e aplicam a regra de endereço privado.306Algumas organizações numeram sua rede interna a partir de um bloco IPv4 público que possuem, como o espaço de endereço próprio de uma operadora ou um `/8` legado, então seu gateway não pode ter um endereço privado. Liste esses blocos na configuração gerenciada `gatewayInternalNetworks`. `/login` então aceita um gateway dentro de um bloco listado quando a máquina do desenvolvedor se conecta a ele a partir de um endereço dentro do mesmo bloco. Isso requer Claude Code v2.1.268 ou posterior na máquina do desenvolvedor; versões anteriores ignoram a chave e aplicam a regra de endereço privado.

307 307 

308<Warning>308<Warning>

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


348 Entregar política para sessões Claude Desktop348 Entregar política para sessões Claude Desktop

349</h3>349</h3>

350 350 

351Claude Desktop executa suas abas Cowork e Code, mais a aba Chat quando você a habilita, em sessões Claude Code incorporadas e envia suas solicitações de modelo através do gateway. Ele passa política para cada uma dessas sessões, construída a partir da configuração que o gateway serve em `/user/bootstrap`: a lista de permissões de modelo, ferramentas desabilitadas e lista de permissões de egresso derivada do bloco `cli` da política correspondente, mais a [sobreposição `desktop`](/docs/pt/claude-apps-gateway-config#claude-desktop-overlay).351Claude Desktop executa suas abas Cowork e Code, mais a aba Chat quando você a habilita, em sessões Claude Code incorporadas e envia suas requisições de modelo através do gateway. Ele passa política para cada uma dessas sessões, construída a partir da configuração que o gateway serve em `/user/bootstrap`: a allowlist de modelos, ferramentas desabilitadas e allowlist de egresso derivada do bloco `cli` da política correspondente, mais a [sobreposição `desktop`](/docs/pt/claude-apps-gateway-config#claude-desktop-overlay).

352 352 

353Outras chaves `cli`, como hooks, `env` e regras de permissão com escopo como `Bash(npm *)`, alcançam apenas clientes que fazem login através de `/login`. Claude Desktop lê a URL do gateway de sua própria configuração gerenciada e faz login com seu próprio fluxo, separado das chaves `forceLoginMethod` e `forceLoginGatewayUrl` em [Defina a URL do gateway](#set-the-gateway-url).353Outras chaves `cli`, como hooks, `env` e regras de permissão com escopo como `Bash(npm *)`, alcançam apenas clientes que fazem login através de `/login`. Claude Desktop lê a URL do gateway de sua própria configuração gerenciada e faz login com seu próprio fluxo, separado das chaves `forceLoginMethod` e `forceLoginGatewayUrl` em [Defina a URL do gateway](#set-the-gateway-url).

354 354 


358 Quais máquinas precisam da aceitação358 Quais máquinas precisam da aceitação

359</h4>359</h4>

360 360 

361Máquinas que executam apenas Claude Desktop precisam dela. Claude Desktop aplica a lista de modelos e a lista de ferramentas desabilitadas às sessões incorporadas em si, mas a lista de permissões de egresso as alcança apenas como configurações pai, na forma de regras de domínio `WebFetch` e regras de rede sandbox. Sem a aceitação, essas sessões são executadas sem a restrição de egresso, e nada o avisa. O gateway ainda rejeita solicitações de inferência para modelos que a política não concede.361Máquinas que executam apenas Claude Desktop precisam dela. Claude Desktop aplica a lista de modelos e a lista de ferramentas desabilitadas às sessões incorporadas em si, mas a allowlist de egresso as alcança apenas como configurações pai, na forma de regras de domínio `WebFetch` e regras de rede sandbox. Sem a aceitação, essas sessões são executadas sem a restrição de egresso, e nada o avisa. O gateway ainda rejeita requisições de inferência para modelos que a política não concede.

362 362 

363Uma lista de permissões de marketplace de plugin também alcança sessões incorporadas apenas como configurações pai. Quando você desativa marketplaces de plugin adicionados pelo usuário na configuração gerenciada do Claude Desktop, Claude Desktop 2.16120.0 ou posterior oculta marketplaces que sua organização não provisionou e recusa instalações deles. Para impedir que sessões incorporadas carreguem plugins já instalados desses marketplaces, ele envia uma lista `strictKnownMarketplaces` como configurações pai. Sem a aceitação, Claude Code ignora essa lista, e esses plugins continuam carregando.363Uma allowlist de marketplace de plugin também alcança sessões incorporadas apenas como configurações pai. Quando você desativa marketplaces de plugin adicionados pelo usuário na configuração gerenciada do Claude Desktop, Claude Desktop 2.16120.0 ou posterior oculta marketplaces que sua organização não provisionou e recusa instalações deles. Para impedir que sessões incorporadas carreguem plugins já instalados desses marketplaces, ele envia uma lista `strictKnownMarketplaces` como configurações pai. Sem a aceitação, Claude Code ignora essa lista, e esses plugins continuam carregando.

364 364 

365Máquinas onde desenvolvedores fazem login através de `/login` não precisam dela; cada sessão Claude Code busca sua política do gateway.365Máquinas onde desenvolvedores fazem login através de `/login` não precisam dela; cada sessão Claude Code busca sua política do gateway.

366 366 


392 392 

393Uma vez que você implante `parentSettingsBehavior: "merge"`, qualquer processo host que inicie Claude Code pode fornecer configurações pai, não apenas Claude Desktop mas também um aplicativo Agent SDK ou uma extensão IDE.393Uma vez que você implante `parentSettingsBehavior: "merge"`, qualquer processo host que inicie Claude Code pode fornecer configurações pai, não apenas Claude Desktop mas também um aplicativo Agent SDK ou uma extensão IDE.

394 394 

395Claude Code filtra configurações pai contra uma lista de permissões de chaves restritivas, mas algumas chaves permitidas podem conceder acesso em vez de restringir. A menos que você defina os bloqueios `allowManaged*Only`, regras de permissão de acesso e listas de permissões de sandbox fornecidas pelo host ainda se aplicam. As regras de negação e pergunta da sua política permanecem em vigor de qualquer forma; [elas são avaliadas antes de qualquer regra de acesso](/docs/pt/permissions#manage-permissions).395Claude Code filtra configurações pai contra uma allowlist de chaves restritivas, mas algumas chaves permitidas podem conceder acesso em vez de restringir. A menos que você defina os bloqueios `allowManaged*Only`, regras de permissão de acesso e allowlists de sandbox fornecidas pelo host ainda se aplicam. As regras de negação e pergunta da sua política permanecem em vigor de qualquer forma; [elas são avaliadas antes de qualquer regra de acesso](/docs/pt/permissions#manage-permissions).

396 396 

397Claude Code encaminha entradas [`sandbox.credentials`](/docs/pt/settings-reference#sandbox-credentials) fornecidas pelo pai em forma reduzida:397Claude Code encaminha entradas [`sandbox.credentials`](/docs/pt/settings-reference#sandbox-credentials) fornecidas pelo pai em forma reduzida:

398 398 

399* **Entradas `deny`**: encaminhadas apenas com seu `path` ou `name` e o modo.399* **Entradas `deny`**: encaminhadas apenas com seu `path` ou `name` e o modo.

400* **Entradas de arquivo com [`mode: mask`](/docs/pt/sandboxing#mask-credential-files)**: encaminhadas apenas com sentinela, como uma máscara de arquivo inteiro cujo `injectHosts` é a lista vazia, então o proxy nunca substitui o valor real por uma entrada fornecida pelo pai em qualquer plataforma. Todos os campos de mascaramento estruturado também são descartados, então um padrão de extração fornecido pelo pai não pode deslocar uma máscara mais rigorosa que outra fonte define para o mesmo caminho.400* **Entradas de arquivo com [`mode: mask`](/docs/pt/sandboxing#mask-credential-files)**: encaminhadas apenas com sentinela, como uma máscara de arquivo inteiro cujo `injectHosts` é a lista vazia, então o proxy nunca substitui o valor real por uma entrada fornecida pelo pai em qualquer plataforma. Todos os campos de mascaramento estruturado também são descartados, então um padrão de extração fornecido pelo pai não pode deslocar uma máscara mais rigorosa que outra fonte define para o mesmo caminho.

401* **Entradas `envVars` com `mode: mask`**: não encaminhadas. `deny` é a única restrição que o canal pai pode expressar através de entradas `envVars`.401* **Entradas `envVars` com `mode: mask`**: não encaminhadas. `deny` é a única restrição que o canal pai pode expressar através de entradas `envVars`.

402* **[`awsPairs` e `sigv4`](/docs/pt/sandboxing#re-sign-aws-requests)**: encaminhadas apenas restrição. De `sigv4`, apenas valores `deny` são mantidos, e um pai que define um bloco `sigv4` em tudo fixa todas as três formas de solicitação, `streaming`, `presigned` e `sigv4a`, para `deny`. Um par `awsPairs` nunca é encaminhado em uma forma que possa re-assinar; um par que nomeia uma das variáveis AWS convencionais é substituído por uma entrada inerte que mantém o emparelhamento automático de `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` e `AWS_SESSION_TOKEN` suprimido.402* **[`awsPairs` e `sigv4`](/docs/pt/sandboxing#re-sign-aws-requests)**: encaminhadas apenas como restrição. De `sigv4`, apenas valores `deny` são mantidos, e um pai que define um bloco `sigv4` em tudo fixa todas as três formas de requisição, `streaming`, `presigned` e `sigv4a`, para `deny`. Um par `awsPairs` nunca é encaminhado em uma forma que possa re-assinar; um par que nomeia uma das variáveis AWS convencionais é substituído por uma entrada inerte que mantém o emparelhamento automático de `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` e `AWS_SESSION_TOKEN` suprimido.

403 403 

404<h4 id="deploy-the-locks">404<h4 id="deploy-the-locks">

405 Implante os bloqueios405 Implante os bloqueios

406</h4>406</h4>

407 407 

408Para manter configurações pai tão próximas de apenas restrição quanto o filtro suporta, adicione todos os cinco bloqueios `allowManaged*Only` e as listas de permissões que eles governam às mesmas fontes que a aceitação de mesclagem:408Para manter configurações pai tão próximas de apenas restrição quanto o filtro suporta, adicione todos os cinco bloqueios `allowManaged*Only` e as allowlists que eles governam às mesmas fontes que a aceitação de mesclagem:

409 409 

410```json theme={null}410```json theme={null}

411{411{


430}430}

431```431```

432 432 

433Uma política do SO, como uma política de registro HKLM ou um plist de preferências gerenciadas, supera esse arquivo, então entregue o trecho inteiro através dela em vez do arquivo. As configurações gerenciadas remotas do gateway superam as fontes de política do SO e arquivo mas alcançam apenas clientes conectados. Espelhe os bloqueios, as listas de permissões e a aceitação de mesclagem no bloco [`cli`](/docs/pt/claude-apps-gateway-config#managed) da política e mantenha esse arquivo implantado, porque máquinas que nunca se conectam, incluindo aquelas que executam apenas Claude Desktop, obtêm sua política apenas do arquivo.433Uma política do SO, como uma política de registro HKLM ou um plist de preferências gerenciadas, supera esse arquivo, então entregue o trecho inteiro através dela em vez do arquivo. As configurações gerenciadas remotas do gateway superam as fontes de política do SO e arquivo mas alcançam apenas clientes conectados. Espelhe os bloqueios, as allowlists e a aceitação de mesclagem no bloco [`cli`](/docs/pt/claude-apps-gateway-config#managed) da política e mantenha esse arquivo implantado, porque máquinas que nunca se conectam, incluindo aquelas que executam apenas Claude Desktop, obtêm sua política apenas do arquivo.

434 434 

435<h4 id="lock-behavior-across-sources">435<h4 id="lock-behavior-across-sources">

436 Comportamento de bloqueio entre fontes436 Comportamento de bloqueio entre fontes

437</h4>437</h4>

438 438 

439Definir um bloqueio não restringe os outros; cada chave é documentada na [referência de configurações](/docs/pt/settings-reference#all-settings). De uma fonte de administrador abaixo do vencedor, os dois bloqueios de sandbox ainda se aplicam, e `allowManagedPermissionRulesOnly` ainda bloqueia regras de acesso fornecidas pelo pai e `additionalDirectories`. No Claude Code v2.1.273 ou posterior, o bloqueio de servidor MCP também se aplica de uma fonte abaixo do vencedor, e enquanto estiver ativado, a lista gerenciada `allowedMcpServers` vem da fonte de administrador de prioridade mais alta que define uma.439Definir um bloqueio não restringe os outros; cada chave é documentada na [referência de configurações](/docs/pt/settings-reference#all-settings).

440 

441De uma fonte de administrador abaixo do vencedor, os dois bloqueios de sandbox ainda se aplicam, e `allowManagedPermissionRulesOnly` ainda bloqueia regras de acesso fornecidas pelo pai e `additionalDirectories`. No Claude Code v2.1.273 ou posterior, o bloqueio de servidor MCP também se aplica de uma fonte abaixo do vencedor, e enquanto estiver ativado, a lista gerenciada `allowedMcpServers` vem da fonte de administrador de prioridade mais alta que define uma.

440 442 

441O bloqueio de hooks e o efeito de `allowManagedPermissionRulesOnly` nas regras próprias do desenvolvedor precisam da fonte vencedora por padrão; sob a aceitação de mesclagem `managedSourcesBehavior` em [como Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources), Claude Code aplica o valor mais rigoroso que qualquer fonte define para cada bloqueio. Em frotas [`policyHelper`](/docs/pt/settings-reference#policyhelper), Claude Code lê os bloqueios apenas da saída do helper.443O bloqueio de hooks e o efeito de `allowManagedPermissionRulesOnly` nas regras próprias do desenvolvedor precisam da fonte vencedora por padrão; sob a aceitação de mesclagem `managedSourcesBehavior` em [como Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources), Claude Code aplica o valor mais rigoroso que qualquer fonte define para cada bloqueio. Em frotas [`policyHelper`](/docs/pt/settings-reference#policyhelper), Claude Code lê os bloqueios apenas da saída do helper.

442 444 

443Cada bloqueio faz Claude Code ignorar as entradas próprias do desenvolvedor para essa configuração, então inclua as listas de permissões da sua organização ao lado dos bloqueios:445Cada bloqueio faz Claude Code ignorar as entradas próprias do desenvolvedor para essa configuração, então inclua as allowlists da sua organização ao lado dos bloqueios:

444 446 

445* **Domínios de rede**: bloquear com uma lista de domínios gerenciados vazia bloqueia todo o tráfego de saída em sandbox.447* **Domínios de rede**: bloquear com uma lista de domínios gerenciados vazia bloqueia todo o tráfego de saída em sandbox.

446* **Servidores MCP**: bloquear sem `allowedMcpServers` em qualquer fonte de administrador ou nas configurações fornecidas pelo pai carrega cada servidor que `deniedMcpServers` não bloqueia.448* **Servidores MCP**: bloquear sem `allowedMcpServers` em qualquer fonte de administrador ou nas configurações fornecidas pelo pai carrega cada servidor que `deniedMcpServers` não bloqueia.


450 Configurações que os bloqueios não cobrem452 Configurações que os bloqueios não cobrem

451</h4>453</h4>

452 454 

453Seis configurações fornecidas pelo pai passam pelo filtro mesmo com todos os cinco bloqueios definidos. Sob a configuração padrão de primeiro vencedor, o valor de administrador que bloqueia o do pai é aquele na fonte de administrador de prioridade mais alta, exceto para `allowedMcpServers` enquanto o [bloqueio de servidor MCP](#lock-behavior-across-sources) está ativado. Sob a aceitação de mesclagem `managedSourcesBehavior`, [como Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) diz qual valor da fonte se aplica em vez disso.455Estas configurações fornecidas pelo pai passam pelo filtro mesmo com todos os cinco bloqueios definidos:

454 456 

455* **`forceLoginOrgUUID`**: Claude Code honra um valor fornecido pelo pai quando a fonte de administrador de prioridade mais alta não define um UUID de organização. O sign-in do gateway não verifica essa chave. Um UUID de organização na fonte de administrador de prioridade mais alta bloqueia o valor do pai e é aquele que Claude Code aplica.457* **`forceLoginOrgUUID`**: Claude Code honra um valor fornecido pelo pai quando a fonte de administrador de prioridade mais alta não define um UUID de organização. O sign-in do gateway não verifica essa chave. Um UUID de organização na fonte de administrador de prioridade mais alta bloqueia o valor do pai e é aquele que Claude Code aplica.

456* **`allowedMcpServers`**: Claude Code honra uma lista de permissões fornecida pelo pai quando nenhuma lista de administrador está em vigor. `allowManagedMcpServersOnly` não a bloqueia, porque o bloqueio aplica qualquer lista que vença como o valor gerenciado, incluindo uma lista fornecida pelo pai quando nenhuma fonte de administrador fornece uma lista. Uma lista na fonte de administrador de prioridade mais alta bloqueia a do pai e é a lista que Claude Code aplica, então defina `allowedMcpServers` lá, ao lado do bloqueio. Antes da v2.1.223, um valor para qualquer chave em qualquer fonte de administrador bloqueava a do pai.458* **`allowedMcpServers`**: Claude Code honra uma allowlist fornecida pelo pai quando nenhuma lista de administrador está em vigor. `allowManagedMcpServersOnly` não a bloqueia, porque o bloqueio aplica qualquer lista que vença como o valor gerenciado, incluindo uma lista fornecida pelo pai quando nenhuma fonte de administrador fornece uma lista. Uma lista na fonte de administrador de prioridade mais alta bloqueia a do pai e é a lista que Claude Code aplica, então defina `allowedMcpServers` lá, ao lado do bloqueio. Antes da v2.1.223, um valor para qualquer chave em qualquer fonte de administrador bloqueava a do pai.

457* **`availableModels`**: Claude Code honra uma lista de modelos fornecida pelo pai quando a fonte gerenciada vencedora não define uma. Se sua frota restringe modelos, defina `availableModels` na fonte vencedora.459* **`availableModels`**: Claude Code honra uma lista de modelos fornecida pelo pai quando a fonte gerenciada vencedora não define uma. Se sua frota restringe modelos, defina `availableModels` na fonte vencedora.

458* **`strictKnownMarketplaces`**: Claude Code honra uma lista de permissões de marketplace de plugin fornecida pelo pai quando a fonte gerenciada vencedora não define uma. Claude Desktop 2.16120.0 ou posterior envia uma quando sua configuração gerenciada desativa marketplaces de plugin adicionados pelo usuário. Se sua frota restringe marketplaces, defina `strictKnownMarketplaces` na fonte vencedora. Requer Claude Code v2.1.282 ou posterior.460* **`allowedProviders`**: Claude Code honra uma allowlist de provedores de API fornecida pelo pai quando a fonte gerenciada vencedora não define uma. Se sua frota restringe quais provedores de API os desenvolvedores podem usar, defina `allowedProviders` na fonte vencedora. Requer Claude Code v2.1.285 ou posterior.

461* **`strictKnownMarketplaces`**: Claude Code honra uma allowlist de marketplace de plugin fornecida pelo pai quando a fonte gerenciada vencedora não define uma. Claude Desktop 2.16120.0 ou posterior envia uma quando sua configuração gerenciada desativa marketplaces de plugin adicionados pelo usuário. Se sua frota restringe marketplaces, defina `strictKnownMarketplaces` na fonte vencedora. Requer Claude Code v2.1.282 ou posterior.

459* **`blockedMarketplaces`**: uma lista de bloqueio de marketplace fornecida pelo pai passa e adiciona a qualquer lista de bloqueio que uma fonte gerenciada define, já que uma lista de bloqueio pode apenas restringir ainda mais. Requer Claude Code v2.1.282 ou posterior.462* **`blockedMarketplaces`**: uma lista de bloqueio de marketplace fornecida pelo pai passa e adiciona a qualquer lista de bloqueio que uma fonte gerenciada define, já que uma lista de bloqueio pode apenas restringir ainda mais. Requer Claude Code v2.1.282 ou posterior.

460* **`strictPluginOnlyCustomization`**: essa chave passa pelo filtro independentemente de qualquer bloqueio, e faz Claude Code ignorar a customização própria do desenvolvedor, incluindo hooks protetores. Nenhum bloqueio a bloqueia.463* **`strictPluginOnlyCustomization`**: essa chave passa pelo filtro independentemente de qualquer bloqueio, e faz Claude Code ignorar a customização própria do desenvolvedor, incluindo hooks protetores. Nenhum bloqueio a bloqueia.

461 464 

465Sob a configuração padrão de primeiro vencedor, um valor de administrador bloqueia o do pai apenas quando está na fonte de administrador de prioridade mais alta, exceto para `allowedMcpServers` enquanto o [bloqueio de servidor MCP](#lock-behavior-across-sources) está ativado. Sob a aceitação de mesclagem `managedSourcesBehavior`, [como Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) diz qual valor da fonte se aplica em vez disso.

466 

462<h3 id="connect-claude-desktop">467<h3 id="connect-claude-desktop">

463 Conectar Claude Desktop468 Conectar Claude Desktop

464</h3>469</h3>


467 472 

468Claude Desktop faz o desenvolvedor fazer login através do provedor de identidade do gateway com o mesmo passo de SSO do navegador, então busca sua configuração do gateway em vez de da Anthropic. O acesso a modelos e a política seguem as mesmas regras por grupo que a CLI. Um desenvolvedor que usa tanto a CLI quanto Claude Desktop faz login em cada um separadamente; a sessão do gateway não é compartilhada entre eles.473Claude Desktop faz o desenvolvedor fazer login através do provedor de identidade do gateway com o mesmo passo de SSO do navegador, então busca sua configuração do gateway em vez de da Anthropic. O acesso a modelos e a política seguem as mesmas regras por grupo que a CLI. Um desenvolvedor que usa tanto a CLI quanto Claude Desktop faz login em cada um separadamente; a sessão do gateway não é compartilhada entre eles.

469 474 

470Uma vez conectado, Claude Desktop envia solicitações de modelo de cada aba habilitada através do gateway. Ele mostra as abas Cowork e Code por padrão. Para ativar também a aba Chat, defina `chatTabEnabled` para `true` na [configuração gerenciada](https://claude.com/docs/third-party/claude-desktop/configuration) do Claude Desktop, ou no bloco [`desktop`](/docs/pt/claude-apps-gateway-config#claude-desktop-overlay) da política em um gateway executando Claude Code v2.1.227 ou posterior.475Uma vez conectado, Claude Desktop envia requisições de modelo de cada aba habilitada através do gateway. Ele mostra as abas Cowork e Code por padrão. Para ativar também a aba Chat, defina `chatTabEnabled` para `true` na [configuração gerenciada](https://claude.com/docs/third-party/claude-desktop/configuration) do Claude Desktop, ou no bloco [`desktop`](/docs/pt/claude-apps-gateway-config#claude-desktop-overlay) da política em um gateway executando Claude Code v2.1.227 ou posterior.

471 476 

472<h3 id="ci-pipelines-and-remote-machines">477<h3 id="ci-pipelines-and-remote-machines">

473 Pipelines de CI e máquinas remotas478 Pipelines de CI e máquinas remotas


485 490 

486Estas garantias se aplicam a cada sessão conectada através de `/login`. As sessões incorporadas que Claude Desktop inicia obtêm sua política conforme descrito em [Entregar política para sessões Claude Desktop](#deliver-policy-to-claude-desktop-sessions), e o ponto de telemetria diz para onde suas exportações vão.491Estas garantias se aplicam a cada sessão conectada através de `/login`. As sessões incorporadas que Claude Desktop inicia obtêm sua política conforme descrito em [Entregar política para sessões Claude Desktop](#deliver-policy-to-claude-desktop-sessions), e o ponto de telemetria diz para onde suas exportações vão.

487 492 

488* **Acesso a modelos**: solicitações para modelos que a política não concede retornam 400, e o seletor `/model` é filtrado para a lista de permissões `availableModels` da política. Defina [`enforceAvailableModels: true`](/docs/pt/model-config#default-model-behavior) na política para que a opção Padrão resolva para um modelo dentro de `availableModels` em vez de para o padrão integrado do Claude Code; sem isso, Padrão permanece selecionável e é rejeitado no tempo de solicitação se esse modelo não for concedido.493* **Acesso a modelos**: requisições para modelos que a política não concede retornam 400, e o seletor `/model` é filtrado para a allowlist `availableModels` da política. Defina [`enforceAvailableModels: true`](/docs/pt/model-config#default-model-behavior) na política para que a opção Padrão resolva para um modelo dentro de `availableModels` em vez de para o padrão integrado do Claude Code; sem isso, Padrão permanece selecionável e é rejeitado no tempo de requisição se esse modelo não for concedido.

489* **Destino de telemetria**: em sessões conectadas através de `/login`, a CLI envia suas exportações OTLP/HTTP para o gateway em vez de para um `OTEL_EXPORTER_OTLP_ENDPOINT` definido localmente, a menos que uma política [nomeie seu coletor como o endpoint](/docs/pt/claude-apps-gateway-config#export-directly-to-your-collector). O gateway retransmite as exportações que recebe para os destinos em [`telemetry.forward_to`](/docs/pt/claude-apps-gateway-config#telemetry).494* **Destino de telemetria**: em sessões conectadas através de `/login`, a CLI envia suas exportações OTLP/HTTP para o gateway em vez de para um `OTEL_EXPORTER_OTLP_ENDPOINT` definido localmente, a menos que uma política [nomeie seu coletor como o endpoint](/docs/pt/claude-apps-gateway-config#export-directly-to-your-collector). O gateway retransmite as exportações que recebe para os destinos em [`telemetry.forward_to`](/docs/pt/claude-apps-gateway-config#telemetry).

490 * Nas sessões incorporadas que [Claude Desktop inicia](#connect-claude-desktop), a CLI envia suas exportações para o `OTEL_EXPORTER_OTLP_ENDPOINT` configurado. A CLI anexa o token de sessão do gateway àquelas exportações apenas quando esse endpoint aponta para o próprio gateway.495 * Nas sessões incorporadas que [Claude Desktop inicia](#connect-claude-desktop), a CLI envia suas exportações para o `OTEL_EXPORTER_OTLP_ENDPOINT` configurado. A CLI anexa o token de sessão do gateway àquelas exportações apenas quando esse endpoint aponta para o próprio gateway.

491 * Sem destino configurado para um sinal, o gateway o aceita e descarta.496 * Sem destino configurado para um sinal, o gateway o aceita e descarta.

492 * Se você já coleta telemetria Claude Code diretamente, adicione seu coletor como um destino `forward_to`, ou nomeie-o em uma política para pular a retransmissão.497 * Se você já coleta telemetria Claude Code diretamente, adicione seu coletor como um destino `forward_to`, ou nomeie-o em uma política para pular a retransmissão.

493* **Credenciais**: o token do gateway é a única credencial da sessão. [Perfis Anthropic](/docs/pt/authentication#anthropic-profiles-and-federation-credentials) e qualquer login anterior de claude.ai são ignorados enquanto conectado, então os desenvolvedores não precisam fazer logout de claude.ai primeiro. Para uma credencial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` configurada, veja [A política do administrador requer um sign-in Cloud gateway](/docs/pt/errors#administrator-policy-requires-a-cloud-gateway-sign-in).498* **Credenciais**: o token do gateway é a única credencial da sessão. [Perfis Anthropic](/docs/pt/authentication#anthropic-profiles-and-federation-credentials) e qualquer login anterior de claude.ai são ignorados enquanto conectado, então os desenvolvedores não precisam fazer logout de claude.ai primeiro. Para uma credencial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` configurada, ou uma chave de API salva por um login anterior no Claude Console, veja [A política do administrador requer um sign-in Cloud gateway](/docs/pt/errors#administrator-policy-requires-a-cloud-gateway-sign-in).

494* **Configurações gerenciadas**: chaves bloqueadas não podem ser substituídas localmente. A CLI aplica a política na inicialização e aplica mudanças em cada sondagem horária, além das [mudanças que se aplicam apenas no próximo lançamento](/docs/pt/server-managed-settings#fetch-and-caching-behavior).499* **Configurações gerenciadas**: chaves bloqueadas não podem ser substituídas localmente. A CLI aplica a política na inicialização e aplica mudanças em cada sondagem horária, além das [mudanças que se aplicam apenas no próximo lançamento](/docs/pt/server-managed-settings#fetch-and-caching-behavior).

495* **Inicialização com o gateway inacessível**: sessões conectadas saem na inicialização com um erro após cerca de 10 segundos em vez de iniciar sem suas configurações.500* **Inicialização com o gateway inacessível**: sessões conectadas saem na inicialização com um erro após cerca de 10 segundos em vez de iniciar sem suas configurações.

496* **Inicialização após o gateway encerrar a sessão**: veja [Aplicar falha fechada na inicialização](/docs/pt/server-managed-settings#enforce-fail-closed-startup) para quais lançamentos abrem desconectados do gateway e quais saem quando o gateway responde com um `401`.501* **Inicialização após o gateway encerrar a sessão**: veja [Aplicar falha fechada na inicialização](/docs/pt/server-managed-settings#enforce-fail-closed-startup) para quais lançamentos abrem desconectados do gateway e quais saem quando o gateway responde com um `401`.

497* **Desprovisionamento**: uma sessão cujo usuário é desabilitado no IdP expira dentro de `ttl_hours` quando a próxima atualização falha.502* **Desprovisionamento**: uma sessão cujo usuário é desabilitado no IdP expira dentro de `ttl_hours` quando a próxima atualização falha.

498* **Sign-out**: `/logout` deleta a credencial do gateway da máquina do desenvolvedor.503* **Sign-out**: `/logout` deleta a credencial do gateway da máquina do desenvolvedor.

499 * Quando o documento de descoberta do gateway anuncia um `revocation_endpoint` no esquema, host e porta próprios da URL do gateway, `/logout` também envia os tokens armazenados para esse endpoint para que o gateway possa encerrar a sessão em seu lado. A solicitação é melhor esforço, então o sign-out é concluído na máquina do desenvolvedor independentemente de o endpoint responder. A revogação requer Claude Code v2.1.275 ou posterior na máquina do desenvolvedor.504 * Quando o documento de descoberta do gateway anuncia um `revocation_endpoint` no esquema, host e porta próprios da URL do gateway, `/logout` também envia os tokens armazenados para esse endpoint para que o gateway possa encerrar a sessão em seu lado. A requisição é melhor esforço, então o sign-out é concluído na máquina do desenvolvedor independentemente de o endpoint responder. A revogação requer Claude Code v2.1.275 ou posterior na máquina do desenvolvedor.

500 * O servidor do gateway no binário `claude` não anuncia nenhum, então um sign-out dele encerra a sessão na máquina do desenvolvedor apenas. Para forçar sessões para fora no lado do servidor, veja [Rotação de segredo JWT](/docs/pt/claude-apps-gateway-deploy#jwt-secret-rotation).505 * O servidor do gateway no binário `claude` não anuncia nenhum, então um sign-out dele encerra a sessão na máquina do desenvolvedor apenas. Para forçar sessões para fora no lado do servidor, veja [Rotação de segredo JWT](/docs/pt/claude-apps-gateway-deploy#jwt-secret-rotation).

501 506 

502<h3 id="what-the-organization-can-see">507<h3 id="what-the-organization-can-see">

Details

12 12 

13Uma sessão em nuvem é uma sessão Claude Code que é executada em infraestrutura em nuvem em vez de em sua máquina. Por padrão, ela é executada em infraestrutura que a Anthropic gerencia, ou no [ambiente auto-hospedado](/docs/pt/self-hosted-environments) da sua organização quando roteada para lá. A sessão continua em execução depois que você fecha seu laptop, e você pode verificá-la ou direcioná-la a partir de qualquer dispositivo.13Uma sessão em nuvem é uma sessão Claude Code que é executada em infraestrutura em nuvem em vez de em sua máquina. Por padrão, ela é executada em infraestrutura que a Anthropic gerencia, ou no [ambiente auto-hospedado](/docs/pt/self-hosted-environments) da sua organização quando roteada para lá. A sessão continua em execução depois que você fecha seu laptop, e você pode verificá-la ou direcioná-la a partir de qualquer dispositivo.

14 14 

15Para permitir que as sessões na nuvem clonem seu código do GitHub e enviem branches, conecte o GitHub com um dos [métodos de conexão do GitHub](#github-authentication-options). Se o seu repositório estiver no GitLab, Bitbucket ou outro host, consulte [Restrições de plataforma](#limitations) para saber o que funciona.

16 

15Você pode iniciar uma sessão em nuvem a partir de qualquer uma dessas superfícies:17Você pode iniciar uma sessão em nuvem a partir de qualquer uma dessas superfícies:

16 18 

17* **Navegador**: [claude.ai/code](https://claude.ai/code), também chamado Claude Code na web19* **Navegador**: [claude.ai/code](https://claude.ai/code), também chamado Claude Code na web


20* **Terminal**: [`claude --cloud`](#from-terminal-to-cloud)22* **Terminal**: [`claude --cloud`](#from-terminal-to-cloud)

21* **Rotinas**: [execuções agendadas e acionadas](/docs/pt/routines) cada uma é executada como uma sessão em nuvem23* **Rotinas**: [execuções agendadas e acionadas](/docs/pt/routines) cada uma é executada como uma sessão em nuvem

22 24 

23Para que Claude inicie e acompanhe muitas sessões em nuvem para um corpo de trabalho, use um [projeto](/docs/pt/claude-projects). Uma sessão em seu terminal, seu IDE, ou o aplicativo Desktop com **Local** selecionado é executada em sua própria máquina. Para direcionar uma dessas sessões locais a partir do seu telefone ou navegador, use [Controle Remoto](/docs/pt/remote-control).25Depois de configurar tudo, use esta página para mover trabalho entre seu terminal e a nuvem, gerenciar e compartilhar sessões, ativar a correção automática de pull requests e solucionar problemas.

24 

25<Tip>

26 Novo em sessões em nuvem? Comece com [Começar](/docs/pt/web-quickstart) para conectar sua conta GitHub e enviar sua primeira tarefa.

27</Tip>

28 26 

29Esta página cobre:27<Note>

28 Estes casos são abordados em outras páginas:

30 29 

31* [Ambientes em nuvem](#cloud-environments): onde as sessões são executadas e onde configurar isso30 * **Iniciar sua primeira sessão na nuvem**: [Começar com sessões na nuvem](/docs/pt/web-quickstart) conecta o GitHub e percorre uma tarefa no navegador

32* [Opções de autenticação do GitHub](#github-authentication-options): duas maneiras de conectar o GitHub31 * **Muitas sessões na nuvem para um corpo de trabalho**: um [projeto](/docs/pt/claude-projects) faz com que Claude as inicie e acompanhe para você

33* [Mover tarefas entre terminal e nuvem](#move-tasks-between-terminal-and-cloud) com `--cloud` e `--teleport`32 * **Direcionar uma sessão local a partir de outro dispositivo**: sessões em seu terminal, IDE ou no aplicativo Desktop com **Local** selecionado são executadas em sua máquina, e o [Remote Control](/docs/pt/remote-control) permite que você as acesse a partir do seu telefone ou navegador

34* [Trabalhar com sessões](#work-with-sessions): modos de permissão, revisão, compartilhamento, arquivamento, exclusão33</Note>

35* [Corrigir automaticamente pull requests](#auto-fix-pull-requests): responder automaticamente a falhas de CI e comentários de revisão

36* [Segurança e isolamento](#security-and-isolation): como as sessões são isoladas

37* [Limitações](#limitations): limites de taxa e restrições de plataforma

38 34 

39<h2 id="cloud-environments">35<h2 id="cloud-environments">

40 Ambientes em nuvem36 Ambientes em nuvem

41</h2>37</h2>

42 38 

43Cada sessão em nuvem é executada em um [ambiente em nuvem](/docs/pt/cloud-environments), a configuração salva que controla acesso à rede, variáveis de ambiente e scripts de configuração. Se você ainda não tem um ambiente, o onboarding configura um ambiente **Default** com [acesso à rede **Trusted**](/docs/pt/cloud-environments#access-levels), criando-o para você ou pedindo que você o crie. Veja [O ambiente Default](/docs/pt/cloud-environments#the-default-environment) para saber qual desses acontece no seu plano e como as sessões escolhem um ambiente quando você tem mais de um.39Cada sessão na nuvem é executada em um [ambiente em nuvem](/docs/pt/cloud-environments), a configuração salva que controla acesso à rede, variáveis de ambiente e scripts de configuração.

44 40 

45Os mesmos ambientes se aplicam em qualquer lugar que você inicie uma sessão em nuvem: a web, o terminal, [Claude Tag](https://claude.com/docs/claude-tag/overview), [routines](/docs/pt/routines) e os aplicativos móvel e Desktop. As sessões de canal Claude Tag usam apenas ambientes no nível da organização, seja [ambientes compartilhados](/docs/pt/cloud-environments#organization-shared-environments) ou [ambientes auto-hospedados](/docs/pt/self-hosted-environments).41* **Seu primeiro ambiente**: se você ainda não tem um, o onboarding configura um ambiente **Default** com [acesso à rede **Trusted**](/docs/pt/cloud-environments#access-levels), criando-o para você ou pedindo que você o crie. Veja [O ambiente Default](/docs/pt/cloud-environments#the-default-environment) para saber qual desses acontece no seu plano

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

47Veja [Configurar ambientes em nuvem](/docs/pt/cloud-environments) para alterar o que um ambiente permite, definir variáveis ou adicionar um script de configuração, e [Ferramentas instaladas](/docs/pt/cloud-environments#installed-tools) para o que as sessões incluem sem nenhuma configuração.43* **Alterar o que as sessões podem acessar ou executar na inicialização**: veja [Configurar ambientes em nuvem](/docs/pt/cloud-environments)

44* **O que vem instalado sem nenhuma configuração**: veja [Ferramentas instaladas](/docs/pt/cloud-environments#installed-tools)

48 45 

49<h2 id="github-authentication-options">46<h2 id="github-authentication-options">

50 Opções de autenticação do GitHub47 Opções de autenticação do GitHub


57| **GitHub App** | Autorize o Claude GitHub App durante [onboarding na web](/docs/pt/web-quickstart) | Qualquer repositório público e repositórios privados nos quais o Claude GitHub App está instalado | Onboarding no navegador; equipes que desejam [Auto-fix](#auto-fix-pull-requests) |54| **GitHub App** | Autorize o Claude GitHub App durante [onboarding na web](/docs/pt/web-quickstart) | Qualquer repositório público e repositórios privados nos quais o Claude GitHub App está instalado | Onboarding no navegador; equipes que desejam [Auto-fix](#auto-fix-pull-requests) |

58| **`/web-setup`** | Execute `/web-setup` em seu terminal para enviar seu token CLI `gh` local para sua conta Claude | Qualquer repositório que seu token `gh` possa acessar, independentemente de o Claude GitHub App estar instalado | Desenvolvedores individuais que já usam `gh` |55| **`/web-setup`** | Execute `/web-setup` em seu terminal para enviar seu token CLI `gh` local para sua conta Claude | Qualquer repositório que seu token `gh` possa acessar, independentemente de o Claude GitHub App estar instalado | Desenvolvedores individuais que já usam `gh` |

59 56 

60A instalação do Claude GitHub App em um repositório também habilita [Auto-fix](#auto-fix-pull-requests) para pull requests nele.57Estes recursos dependem de o Claude GitHub App estar instalado no repositório:

61 58 

62As threads em um [projeto](/docs/pt/claude-projects) precisam que o Claude GitHub App esteja instalado em cada repositório que elas clonam, independentemente do método com o qual você se conectou. Consulte [Configurar acesso ao GitHub](/docs/pt/claude-projects#set-up-github-access).59* **Auto-fix**: a instalação do Claude GitHub App em um repositório também habilita [Auto-fix](#auto-fix-pull-requests) para pull requests nele

60* **Projetos**: as threads em um [projeto](/docs/pt/claude-projects) precisam que o Claude GitHub App esteja instalado em cada repositório que elas clonam, independentemente do método com o qual você se conectou. Consulte [Configurar acesso ao GitHub](/docs/pt/claude-projects#set-up-github-access)

63 61 

64Em ambientes hospedados pela Anthropic, suas credenciais do GitHub permanecem criptografadas nos servidores da Anthropic e nunca entram na VM de uma sessão. As operações do GitHub da VM passam pelo [proxy do GitHub](/docs/pt/cloud-environments#github-proxy), que anexa a credencial no lado do servidor.62Em ambientes hospedados pela Anthropic, suas credenciais do GitHub permanecem criptografadas nos servidores da Anthropic e nunca entram na VM de uma sessão. As operações do GitHub da VM passam pelo [proxy do GitHub](/docs/pt/cloud-environments#github-proxy), que anexa a credencial no lado do servidor.

65 63 

66Para saber como `/schedule` verifica o acesso ao repositório antes de criar uma routine, consulte [Repositórios e permissões de branch](/docs/pt/routines#repositories-and-branch-permissions). Consulte [Conectar a partir do seu terminal](/docs/pt/web-quickstart#connect-from-your-terminal) para o passo a passo de `/web-setup`, incluindo o que `/web-setup` armazena e como removê-lo.64Consulte [Conectar a partir do seu terminal](/docs/pt/web-quickstart#connect-from-your-terminal) para o passo a passo de `/web-setup`, incluindo o que `/web-setup` armazena e como removê-lo.

67 

68Quick web setup é uma configuração de organização que permite que membros conectem o GitHub com `/web-setup`, pula o prompt de instalação do Claude GitHub App durante o onboarding do navegador e faz com que o onboarding do navegador crie o [ambiente **Default**](/docs/pt/cloud-environments#the-default-environment) para eles em vez de mostrar o formulário de ambiente. Nos planos Team e Enterprise está desabilitado por padrão, o que oculta `/web-setup`. Um [Owner](/docs/pt/server-managed-settings#access-control) o ativa com o toggle **Quick web setup** em [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code).

69 65 

70<Note>66<Note>

71 Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado não podem usar `/web-setup` ou outros recursos de sessão em nuvem.67 Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado não podem usar `/web-setup` ou outros recursos de sessão em nuvem.

72</Note>68</Note>

73 69 

70<h3 id="quick-web-setup-for-team-and-enterprise">

71 Quick web setup para Team e Enterprise

72</h3>

73 

74Quick web setup é uma configuração de organização que remove etapas da configuração do GitHub e do ambiente dos membros. Nos planos Team e Enterprise, ela está desabilitada por padrão.

75 

76Veja o que muda para os membros quando ela está ativada:

77 

78* **`/web-setup`**: os membros podem conectar o GitHub com `/web-setup`. Enquanto a configuração estiver desativada, o comando fica oculto

79* **Prompt do GitHub App**: o onboarding no navegador pula o prompt de instalação do Claude GitHub App

80* **Primeiro ambiente**: o onboarding no navegador cria o [ambiente **Default**](/docs/pt/cloud-environments#the-default-environment) para os membros em vez de mostrar o formulário de ambiente

81 

82Um [Owner](/docs/pt/server-managed-settings#access-control) a ativa com o toggle **Quick web setup** em [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code).

83 

74<h2 id="move-tasks-between-terminal-and-cloud">84<h2 id="move-tasks-between-terminal-and-cloud">

75 Mover tarefas entre terminal e nuvem85 Mover tarefas entre terminal e nuvem

76</h2>86</h2>


78Esses fluxos de trabalho exigem o [Claude Code CLI](/docs/pt/quickstart) conectado à mesma conta claude.ai. Você pode iniciar novas sessões na nuvem a partir do seu terminal, ou puxar sessões na nuvem para seu terminal para continuar localmente. As sessões na nuvem persistem mesmo se você fechar seu laptop, e você pode monitorá-las de qualquer lugar, incluindo o aplicativo móvel Claude.88Esses fluxos de trabalho exigem o [Claude Code CLI](/docs/pt/quickstart) conectado à mesma conta claude.ai. Você pode iniciar novas sessões na nuvem a partir do seu terminal, ou puxar sessões na nuvem para seu terminal para continuar localmente. As sessões na nuvem persistem mesmo se você fechar seu laptop, e você pode monitorá-las de qualquer lugar, incluindo o aplicativo móvel Claude.

79 89 

80<Note>90<Note>

81 A partir da CLI, a transferência de sessão é unidirecional: você pode puxar sessões na nuvem para seu terminal com `--teleport`, mas não pode enviar uma sessão de terminal existente para a nuvem. O sinalizador `--cloud` com uma descrição de tarefa cria uma nova sessão na nuvem para seu repositório atual; com `-p` e um ID de sessão ou URL claude.ai/code, ele [enfileira uma mensagem nessa sessão existente](/docs/pt/claude-code-on-the-web#send-follow-ups-from-the-cli). O [aplicativo Desktop](/docs/pt/desktop#continue-in-another-surface) fornece um menu **Continue in** que pode enviar uma sessão local para a nuvem.91 A partir da CLI, a transferência de sessão é unidirecional: você pode puxar sessões na nuvem para seu terminal com `--teleport`, mas não pode enviar uma sessão de terminal existente para a nuvem. A flag `--cloud` com uma descrição de tarefa cria uma nova sessão na nuvem para seu repositório atual; com `-p` e um ID de sessão ou URL claude.ai/code, ela [enfileira uma mensagem nessa sessão existente](/docs/pt/claude-code-on-the-web#send-follow-ups-from-the-cli). O [aplicativo Desktop](/docs/pt/desktop#continue-in-another-surface) pode enviar uma sessão local da sua aba Code para a nuvem a partir do seu menu **Open in**.

82</Note>92</Note>

83 93 

84<h3 id="from-terminal-to-cloud">94<h3 id="from-terminal-to-cloud">


173 Enviar acompanhamentos a partir da CLI183 Enviar acompanhamentos a partir da CLI

174</h3>184</h3>

175 185 

176Depois que uma sessão na nuvem está em execução, onde quer que seja executada, envie uma mensagem de acompanhamento a partir da CLI `claude` em qualquer máquina onde você esteja conectado com `claude auth login`. A CLI autentica com suas credenciais de conta Anthropic e não envia nenhum estado de sessão local, portanto o comando não precisa ser executado a partir da máquina que iniciou a sessão, e é o mesmo em cada shell, incluindo PowerShell.186Depois que uma sessão na nuvem está em execução, onde quer que seja executada, envie uma mensagem de acompanhamento a partir da CLI `claude` em qualquer máquina onde você esteja conectado com `claude auth login`. A CLI autentica com suas credenciais de conta Anthropic e não envia nenhum estado de sessão local, portanto o comando não precisa ser executado a partir da máquina que iniciou a sessão.

177 187 

178O comando publica uma mensagem e sai:188O comando publica uma mensagem e sai:

179 189 


189 `--cloud` requer uma conta Anthropic. Não está disponível quando Claude Code é configurado para Amazon Bedrock, Google Cloud's Agent Platform ou outro provedor de terceiros. Um [gateway LLM](/docs/pt/llm-gateway) configurado apenas através de `ANTHROPIC_BASE_URL` não conta como um provedor de terceiros para esta verificação, mas você ainda precisa se conectar com `claude auth login`. A política `allow_remote_sessions` da sua organização também deve estar habilitada. Um Owner pode ativá-la nas configurações de administrador do Claude Code em claude.ai/admin-settings/claude-code.199 `--cloud` requer uma conta Anthropic. Não está disponível quando Claude Code é configurado para Amazon Bedrock, Google Cloud's Agent Platform ou outro provedor de terceiros. Um [gateway LLM](/docs/pt/llm-gateway) configurado apenas através de `ANTHROPIC_BASE_URL` não conta como um provedor de terceiros para esta verificação, mas você ainda precisa se conectar com `claude auth login`. A política `allow_remote_sessions` da sua organização também deve estar habilitada. Um Owner pode ativá-la nas configurações de administrador do Claude Code em claude.ai/admin-settings/claude-code.

190</Note>200</Note>

191 201 

192<h4 id="output-and-errors">202<h4 id="output">

193 Saída e erros203 Saída

194</h4>204</h4>

195 205 

196Com sucesso, o comando imprime o ID da sessão e um link para visualizar a sessão:206Com sucesso, o comando imprime o ID da sessão e um link para visualizar a sessão:


203 213 

204Passe `--output-format json` para um resultado legível por máquina: `{ok, session_id, url}` com sucesso, ou `{ok: false, session_id, error}` quando o envio falha, por exemplo quando a sessão está ausente ou arquivada. Erros de configuração, como um provedor não suportado ou uma política organizacional desabilitada, são impressos em stderr sem JSON. `--output-format stream-json` não é suportado com `--cloud <session-id>`.214Passe `--output-format json` para um resultado legível por máquina: `{ok, session_id, url}` com sucesso, ou `{ok: false, session_id, error}` quando o envio falha, por exemplo quando a sessão está ausente ou arquivada. Erros de configuração, como um provedor não suportado ou uma política organizacional desabilitada, são impressos em stderr sem JSON. `--output-format stream-json` não é suportado com `--cloud <session-id>`.

205 215 

206A CLI prefixos erros com `Error: `. Uma entrega com falha é envolvida como `failed to send message to cloud session <id>: <reason>`.216Se o envio falhar, consulte [Erros ao enviar para uma sessão na nuvem](#errors-when-sending-to-a-cloud-session).

207 

208| Mensagem | O que significa |

209| - | - |

210| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code é configurado para um provedor de terceiros. A mensagem nomeia o provedor com o rótulo que sua configuração usa, como `Amazon Bedrock` ou `Google Vertex AI`. Remova a configuração desse provedor, por exemplo, desconfigurar `CLAUDE_CODE_USE_BEDROCK`, e conecte-se com uma conta Anthropic (`claude auth login`). |

211| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | A política organizacional `allow_remote_sessions` está desativada. |

212| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code não conseguiu buscar a política da sua organização, portanto recusa o envio em vez de assumir que as sessões na nuvem são permitidas. Verifique sua conexão de rede e tente novamente. |

213| `Attaching to an existing cloud session is not enabled for your account.` | Você executou `--cloud <session-id>` sem `-p`. Envie a mensagem com `claude -p "your message" --cloud <session-id>`. |

214| `Session not found: <id>` | O ID ou URL não corresponde a uma sessão que você pode acessar. Verifique-o em relação à URL claude.ai/code da sessão. |

215| `cloud session <id> is archived and cannot accept new messages` | A sessão foi arquivada. Inicie uma nova sessão em vez disso. |

216 217 

217<h3 id="from-cloud-to-terminal">218<h3 id="from-cloud-to-terminal">

218 Da nuvem para o terminal219 Da nuvem para o terminal


239| Requisito | Detalhes |240| Requisito | Detalhes |

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

241| Estado git limpo | Seu diretório de trabalho não deve ter alterações não confirmadas. Teleport solicita que você guarde as alterações se necessário. |242| Estado git limpo | Seu diretório de trabalho não deve ter alterações não confirmadas. Teleport solicita que você guarde as alterações se necessário. |

242| Repositório correto | Você deve executar `--teleport` a partir de um checkout do mesmo repositório, não de um fork. Se você executá-lo a partir de um checkout de um repositório diferente, Claude Code mostra um erro que nomeia tanto o repositório da sessão quanto o seu checkout. Antes de v2.1.219, o erro não nomeava o repositório do seu checkout. Se Claude Code não conseguir analisar seu remoto em um nome de host, por exemplo um alias de host SSH como `git@work:owner/repo.git`, ele pede que você confirme e aceita o checkout quando o proprietário do remoto e o nome do repositório correspondem ao repositório da sessão. |243| Repositório correto | Você deve executar `--teleport` a partir de um checkout do mesmo repositório, não de um fork. Se você executá-lo a partir de um checkout de um repositório diferente, Claude Code mostra um erro que nomeia tanto o repositório da sessão quanto o do seu checkout. Se Claude Code não conseguir analisar seu remoto em um nome de host, por exemplo um alias de host SSH como `git@work:owner/repo.git`, ele pede que você confirme e aceita o checkout quando o proprietário do remoto e o nome do repositório correspondem ao repositório da sessão. |

243| Ramificação disponível | A ramificação da sessão na nuvem deve ter sido enviada para o remoto. Teleport busca e faz checkout automaticamente. |244| Ramificação disponível | A ramificação da sessão na nuvem deve ter sido enviada para o remoto. Teleport busca e faz checkout automaticamente. |

244| Mesma conta | Você deve estar autenticado na mesma conta claude.ai usada na sessão na nuvem. |245| Mesma conta | Você deve estar autenticado na mesma conta claude.ai usada na sessão na nuvem. |

245 246 


249 `--teleport` não está disponível250 `--teleport` não está disponível

250</h4>251</h4>

251 252 

252Teleport requer autenticação de assinatura claude.ai. Se você estiver autenticado via chave de API, execute `/login` para se conectar com sua conta claude.ai. Se o erro nomear seu provedor, as sessões na nuvem não estão disponíveis através de provedores de terceiros; consulte a [tabela de erros](#output-and-errors). Se você já estiver conectado via claude.ai e `--teleport` ainda não estiver disponível, sua organização pode ter desabilitado as sessões na nuvem.253Teleport requer autenticação de assinatura claude.ai. Encontre o caso que corresponde ao seu:

254 

255* **Você está autenticado via chave de API**: execute `/login` para se conectar com sua conta claude.ai em vez disso

256* **O erro nomeia seu provedor**: as sessões na nuvem não estão disponíveis através de provedores de terceiros. Consulte a [tabela de erros](#errors-when-sending-to-a-cloud-session)

257* **Você já está conectado via claude.ai**: sua organização pode ter desabilitado as sessões na nuvem

253 258 

254<h2 id="work-with-sessions">259<h2 id="work-with-sessions">

255 Trabalhar com sessões260 Trabalhar com sessões


257 262 

258As sessões aparecem na barra lateral em claude.ai/code. De lá, você pode revisar alterações, compartilhar com colegas de equipe, arquivar trabalho concluído ou excluir sessões permanentemente.263As sessões aparecem na barra lateral em claude.ai/code. De lá, você pode revisar alterações, compartilhar com colegas de equipe, arquivar trabalho concluído ou excluir sessões permanentemente.

259 264 

260<h3 id="take-back-a-queued-message">265<h3 id="permission-modes-in-cloud-sessions">

261 Recuperar uma mensagem enfileirada266 Modos de permissão em sessões na nuvem

262</h3>267</h3>

263 268 

264Se você enviar uma mensagem enquanto Claude está trabalhando, a mensagem fica enfileirada até que Claude a leia. Para recuperar uma mensagem enfileirada, clique no ✕ nela. O texto retorna à caixa de mensagem para que você possa editá-lo ou enviar algo diferente.269Você escolhe o [modo de permissão](/docs/pt/permission-modes) de uma sessão na nuvem no [menu suspenso de modo](/docs/pt/permission-modes#switch-permission-modes), tanto quando você cria a tarefa quanto enquanto a sessão é executada.

265 270 

266Se Claude já tiver lido a mensagem, ela permanece na conversa.271Claude Code retoma uma sessão no modo de permissão em que ela estava quando você faz qualquer uma destas ações:

272 

273* Reabre uma sessão cujo [ambiente hospedado pela Anthropic expirou](#environment-expired)

274* Envia uma mensagem para uma sessão que um executor auto-hospedado [liberou enquanto estava ocioso](/docs/pt/self-hosted-environments-reference#runner-cli-flags)

275 

276<h3 id="review-changes">

277 Revisar alterações

278</h3>

279 

280Cada sessão mostra um indicador de diff com linhas adicionadas e removidas, como `+42 -18`. Selecione-o para abrir a visualização de diff, deixe comentários inline em linhas específicas e envie-os para Claude com sua próxima mensagem.

281 

282A visualização de diff compara as alterações da sessão em relação ao seu branch base por padrão. Para comparar com qualquer outro branch no repositório, selecione **Compare against** e escolha um.

283 

284Claude Code calcula esses diffs a partir do conteúdo bruto do blob git, portanto os drivers de diff e filtros `textconv` configurados no repositório não se aplicam.

285 

286Estas etapas são abordadas em outros lugares:

287 

288* **O passo a passo completo, incluindo criação de PR**: consulte [Revisar e iterar](/docs/pt/web-quickstart#review-and-iterate)

289* **Fazer Claude monitorar o PR para falhas de CI e comentários de revisão automaticamente**: consulte [Corrigir automaticamente pull requests](#auto-fix-pull-requests)

267 290 

268<h3 id="manage-context">291<h3 id="manage-context">

269 Gerenciar contexto292 Gerenciar contexto

270</h3>293</h3>

271 294 

272As sessões em nuvem suportam [comandos integrados](/docs/pt/commands) que produzem saída de texto. Comandos que só funcionam na interface do terminal, como `/plugin` ou `/resume`, não estão disponíveis. Comandos que abrem um seletor ou painel no terminal se comportam de forma diferente nas sessões em nuvem:295As sessões na nuvem suportam [comandos integrados](/docs/pt/commands) que produzem saída de texto. Comandos que só funcionam na interface do terminal, como `/plugin` ou `/resume`, não estão disponíveis. Comandos que abrem um seletor ou painel no terminal se comportam de forma diferente nas sessões na nuvem:

273 296 

274* **`/model`, `/effort`, `/color` e `/rename`**: passe o valor como um argumento, por exemplo `/model sonnet`, em vez de abrir o seletor do terminal ou controle deslizante. Os formulários de argumento exigem Claude Code v2.1.205 ou posterior no ambiente da sessão e seguem as [notas de disponibilidade](/docs/pt/commands#all-commands) de cada comando.297* **`/model`, `/effort`, `/color` e `/rename`**: passe o valor como um argumento, por exemplo `/model sonnet`, em vez de abrir o seletor do terminal ou controle deslizante. Os formulários de argumento exigem Claude Code v2.1.205 ou posterior no ambiente da sessão e seguem as [notas de disponibilidade](/docs/pt/commands#all-commands) de cada comando.

275* **`/fast`**: alterna o [modo rápido](/docs/pt/fast-mode#use-fast-mode-in-cloud-sessions) para a sessão quando o modo rápido está [disponível em sua conta](/docs/pt/fast-mode#requirements). Requer Claude Code v2.1.271 ou posterior no ambiente da sessão.298* **`/fast`**: alterna o [modo rápido](/docs/pt/fast-mode#use-fast-mode-in-cloud-sessions) para a sessão quando o modo rápido está [disponível em sua conta](/docs/pt/fast-mode#requirements). Requer Claude Code v2.1.271 ou posterior no ambiente da sessão.

276* **`/config`**: no seu navegador em claude.ai/code, abre a seção Claude Code de suas configurações em vez de definir um valor, e o texto após o comando, incluindo `key=value`, é ignorado. Para alterar uma configuração para uma sessão em nuvem, defina uma [variável de ambiente](/docs/pt/cloud-environments#set-environment-variables) no ambiente, ou em uma sessão com um repositório, confirme a chave no `.claude/settings.json` desse repositório. [Configurações em sessões em nuvem](/docs/pt/settings#settings-in-cloud-sessions) lista o que cada sessão lê.299* **`/config`**: no seu navegador em claude.ai/code, abre a seção Claude Code de suas configurações em vez de definir um valor, e o texto após o comando, incluindo `key=value`, é ignorado. Para alterar uma configuração para uma sessão na nuvem, defina uma [variável de ambiente](/docs/pt/cloud-environments#set-environment-variables) no ambiente, ou em uma sessão com um repositório, faça commit da chave no `.claude/settings.json` desse repositório. [Configurações em sessões na nuvem](/docs/pt/settings#settings-in-cloud-sessions) lista o que cada sessão lê.

277 300 

278Para gerenciamento de contexto especificamente:301Para gerenciamento de contexto especificamente:

279 302 

280| Comando | Funciona em sessões em nuvem | Notas |303| Comando | Funciona em sessões na nuvem | Notas |

281| :- | :- | :- |304| :- | :- | :- |

282| `/compact` | Sim | Resume a conversa para liberar contexto. Aceita instruções de foco opcionais como `/compact keep the test output` |305| `/compact` | Sim | Resume a conversa para liberar contexto. Aceita instruções de foco opcionais como `/compact keep the test output` |

283| `/context` | Sim | Mostra o que está atualmente na janela de contexto |306| `/context` | Sim | Mostra o que está atualmente na janela de contexto |

284| `/clear` | Não | Inicie uma nova sessão na barra lateral |307| `/clear` | Não | Inicie uma nova sessão na barra lateral |

285 308 

286A compactação automática é executada automaticamente quando a janela de contexto se aproxima da capacidade. As sessões em nuvem definem [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/pt/env-vars) por si só, portanto a compactação é acionada no meio da [janela de compactação automática](/docs/pt/model-config#set-the-auto-compact-window) em vez de quando a janela se enche. Esse valor substitui um que você adiciona em suas [variáveis de ambiente](/docs/pt/cloud-environments#set-environment-variables), portanto adicionar a variável lá não altera quando a compactação é acionada.309A compactação automática é executada automaticamente quando a janela de contexto se aproxima da capacidade. As sessões na nuvem definem [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/pt/env-vars) por si só, portanto a compactação é acionada no meio da [janela de compactação automática](/docs/pt/model-config#set-the-auto-compact-window) em vez de quando a janela se enche. Esse valor sobrescreve um que você adiciona em suas [variáveis de ambiente](/docs/pt/cloud-environments#set-environment-variables), portanto adicionar a variável lá não altera quando a compactação é acionada.

287 310 

288Para alterar a janela de compactação automática, defina [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/pt/env-vars) em suas variáveis de ambiente, ou execute [`/autocompact`](/docs/pt/commands#all-commands) com uma contagem de tokens em uma sessão onde a variável não está definida.311Para alterar a janela de compactação automática, defina [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/pt/env-vars) em suas variáveis de ambiente, ou execute [`/autocompact`](/docs/pt/commands#all-commands) com uma contagem de tokens em uma sessão onde a variável não está definida.

289 312 


291 314 

292[Equipes de agentes](/docs/pt/agent-teams) estão desativadas por padrão, mas podem ser habilitadas adicionando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` às suas [variáveis de ambiente](/docs/pt/cloud-environments#set-environment-variables).315[Equipes de agentes](/docs/pt/agent-teams) estão desativadas por padrão, mas podem ser habilitadas adicionando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` às suas [variáveis de ambiente](/docs/pt/cloud-environments#set-environment-variables).

293 316 

294<h3 id="permission-modes-in-cloud-sessions">317<h3 id="take-back-a-queued-message">

295 Modos de permissão em sessões em nuvem318 Recuperar uma mensagem enfileirada

296</h3>

297 

298Você escolhe o [modo de permissão](/docs/pt/permission-modes) de uma sessão em nuvem no [menu suspenso de modo](/docs/pt/permission-modes#switch-permission-modes), tanto quando você cria a tarefa quanto enquanto a sessão é executada. Quando você reabre uma sessão cujo [ambiente hospedado pela Anthropic expirou](#environment-expired), ou envia uma mensagem para uma sessão que um executor auto-hospedado [liberou enquanto estava ocioso](/docs/pt/self-hosted-environments-reference#runner-cli-flags), Claude Code retoma a sessão no modo de permissão em que estava.

299 

300<h3 id="review-changes">

301 Revisar alterações

302</h3>319</h3>

303 320 

304Cada sessão mostra um indicador de diff com linhas adicionadas e removidas, como `+42 -18`. Selecione-o para abrir a visualização de diff, deixe comentários inline em linhas específicas e envie-os para Claude com sua próxima mensagem.321Se você enviar uma mensagem enquanto Claude está trabalhando, a mensagem fica enfileirada até que Claude a leia. Para recuperar uma mensagem enfileirada, clique no ✕ nela. O texto retorna à caixa de mensagem para que você possa editá-lo ou enviar algo diferente.

305 

306A visualização de diff compara as alterações da sessão em relação ao seu branch base por padrão. Para comparar com qualquer outro branch no repositório, selecione **Compare against** e escolha um.

307 

308Claude Code calcula esses diffs, incluindo os diffs por arquivo mostrados conforme Claude edita, a partir do conteúdo bruto do blob git, portanto os drivers de diff e filtros `textconv` configurados no repositório não se aplicam. Para um arquivo em um repositório que não é um dos checkouts da própria sessão, como um clonado dentro do workspace durante a sessão, o diff por arquivo mostra a edição de Claude em si em vez de uma comparação git.

309 322 

310Consulte [Revisar e iterar](/docs/pt/web-quickstart#review-and-iterate) para o passo a passo completo, incluindo criação de PR. Para fazer Claude monitorar o PR para falhas de CI e comentários de revisão automaticamente, consulte [Corrigir automaticamente pull requests](#auto-fix-pull-requests).323Se Claude já tiver lido a mensagem, ela permanece na conversa.

311 324 

312<h3 id="share-sessions">325<h3 id="share-sessions">

313 Compartilhar sessões326 Compartilhar sessões


319 Compartilhar de uma conta Enterprise ou Team332 Compartilhar de uma conta Enterprise ou Team

320</h4>333</h4>

321 334 

322Para contas Enterprise e Team, as duas opções de visibilidade são **Private** e **Team**. A visibilidade de Team torna a sessão visível para outros membros de sua organização claude.ai. As sessões do [Claude no Slack](/docs/pt/slack) são compartilhadas automaticamente com visibilidade de Team.335O compartilhamento funciona da seguinte forma para contas Enterprise e Team:

323 336 

324A verificação de acesso ao repositório está habilitada por padrão, com base na conta do GitHub conectada à conta do destinatário. O nome de exibição de sua conta é visível para todos os destinatários com acesso.337* **Opções de visibilidade**: **Private** e **Team**. A visibilidade de Team torna a sessão visível para outros membros de sua organização claude.ai

338* **Acesso ao repositório**: a verificação está habilitada por padrão, com base na conta do GitHub conectada à conta do destinatário

339* **Seu nome**: o nome de exibição de sua conta é visível para todos os destinatários com acesso

340* **Sessões do Slack**: as sessões do [Claude no Slack](/docs/pt/slack) são compartilhadas automaticamente com visibilidade de Team

325 341 

326<h4 id="share-from-a-max-or-pro-account">342<h4 id="share-from-a-max-or-pro-account">

327 Compartilhar de uma conta Max ou Pro343 Compartilhar de uma conta Max ou Pro

328</h4>344</h4>

329 345 

330Para contas Max e Pro, as duas opções de visibilidade são **Private** e **Public**. A visibilidade Public torna a sessão visível para qualquer usuário conectado a claude.ai.346O compartilhamento funciona da seguinte forma para contas Max e Pro:

331 347 

332Verifique sua sessão para conteúdo sensível antes de compartilhar. As sessões podem conter código e credenciais de repositórios privados do GitHub. A verificação de acesso ao repositório não está habilitada por padrão.348* **Opções de visibilidade**: **Private** e **Public**. A visibilidade Public torna a sessão visível para qualquer usuário conectado a claude.ai

349* **Acesso ao repositório**: a verificação não está habilitada por padrão

350* **Conteúdo sensível**: verifique sua sessão antes de compartilhar. As sessões podem conter código e credenciais de repositórios privados do GitHub

333 351 

334Para exigir que os destinatários tenham acesso ao repositório ou para ocultar seu nome de sessões compartilhadas, vá para [**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code).352Para exigir que os destinatários tenham acesso ao repositório ou para ocultar seu nome de sessões compartilhadas, vá para [**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code).

335 353 


421 Unable to get organization UUID439 Unable to get organization UUID

422</h3>440</h3>

423 441 

424`claude --cloud` e `claude --teleport` requerem entrada com uma conta claude.ai. Se você autenticar com uma chave de API, ou seus detalhes de conta armazenados estão obsoletos, esses comandos falham com `Unable to get organization UUID` ou uma mensagem de que a autenticação de chave de API não é suficiente. Com autenticação de chave de API ou detalhes de conta obsoletos, executar `claude --teleport` sem um ID de sessão mostra `Error loading Claude Code sessions` no seletor de sessão em vez de qualquer mensagem, e a mesma correção se aplica.442`claude --cloud` e `claude --teleport` requerem entrada com uma conta claude.ai. Se você autenticar com uma chave de API, ou se seus detalhes de conta armazenados estiverem obsoletos, você verá uma destas mensagens:

425 443 

426Execute `/login` para entrar com sua conta claude.ai, depois tente novamente o comando. Se o erro nomear seu provedor em vez disso, veja a [tabela de erros](#output-and-errors): as sessões em nuvem não estão disponíveis através de provedores de terceiros.444* `Unable to get organization UUID`

445* Uma mensagem de que a autenticação com chave de API não é suficiente

446* `Error loading Claude Code sessions` no seletor de sessão, quando você executa `claude --teleport` sem um ID de sessão

447 

448Execute `/login` para entrar com sua conta claude.ai, depois tente novamente o comando. Se o erro nomear seu provedor em vez disso, veja a [tabela de erros](#errors-when-sending-to-a-cloud-session): as sessões na nuvem não estão disponíveis através de provedores de terceiros.

427 449 

428<h3 id="remote-control-session-expired-or-access-denied">450<h3 id="remote-control-session-expired-or-access-denied">

429 Remote Control session expired or access denied451 Remote Control session expired or access denied


435* Confirme que você está conectado à mesma conta que possui a sessão457* Confirme que você está conectado à mesma conta que possui a sessão

436* Se você ver `Remote Control may not be available for this organization`, um Owner não habilitou as sessões em nuvem para sua organização458* Se você ver `Remote Control may not be available for this organization`, um Owner não habilitou as sessões em nuvem para sua organização

437 459 

460<h3 id="errors-when-sending-to-a-cloud-session">

461 Erros ao enviar para uma sessão na nuvem

462</h3>

463 

464Esses erros vêm da execução de `claude` com [`--cloud <session-id>`](#send-follow-ups-from-the-cli), com ou sem `-p`. O CLI prefixa os erros com `Error: `. Uma entrega com falha é envolvida como `failed to send message to cloud session <id>: <reason>`.

465 

466| Mensagem | O que significa |

467| - | - |

468| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code está configurado para um provedor de terceiros. A mensagem nomeia o provedor com o rótulo que sua configuração usa, como `Amazon Bedrock` ou `Google Vertex AI`. Remova a configuração desse provedor, por exemplo removendo a definição de `CLAUDE_CODE_USE_BEDROCK`, e entre com uma conta Anthropic (`claude auth login`). |

469| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | A política da organização `allow_remote_sessions` está desativada. |

470| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code não conseguiu obter a política da sua organização, então recusa o envio em vez de presumir que as sessões na nuvem são permitidas. Verifique sua conexão de rede e tente novamente. |

471| `Attaching to an existing cloud session is not enabled for your account.` | Você executou `--cloud <session-id>` sem `-p`. Envie a mensagem com `claude -p "your message" --cloud <session-id>`. |

472| `Session not found: <id>` | O ID ou URL não corresponde a uma sessão que você pode acessar. Compare-o com o URL claude.ai/code da sessão. |

473| `cloud session <id> is archived and cannot accept new messages` | A sessão foi arquivada. Inicie uma nova sessão em vez disso. |

474 

438<h3 id="environment-expired">475<h3 id="environment-expired">

439 Environment expired476 Environment expired

440</h3>477</h3>

441 478 

442As sessões em nuvem param após um período de inatividade e a VM da sessão é recuperada. Uma sessão é considerada inativa enquanto aguarda você aprovar uma chamada de ferramenta [MCP connector](/docs/pt/cloud-environments#network-access) ou entrar em um servidor MCP, e pode expirar durante essa espera.479As sessões em nuvem param após um período de inatividade e a VM da sessão é recuperada. Uma sessão é considerada inativa enquanto aguarda você aprovar uma chamada de ferramenta [MCP connector](/docs/pt/cloud-environments#network-access) ou entrar em um servidor MCP, e pode expirar durante essa espera.

443 480 

444Reabra a sessão de [claude.ai/code](https://claude.ai/code) para provisionar uma VM fresca com seu histórico de conversa restaurado. O trabalho em segundo plano que ainda estava em execução quando a VM foi recuperada, como subagentes e comandos shell, não é restaurado.481Reabra a sessão de [claude.ai/code](https://claude.ai/code) para provisionar uma VM nova:

482 

483* **Restaurado**: seu histórico de conversa

484* **Não restaurado**: trabalho em segundo plano que ainda estava em execução quando a VM foi recuperada, como subagentes e comandos shell

445 485 

446<h2 id="limitations">486<h2 id="limitations">

447 Limitações487 Limitações

Details

1455| `managed-settings.json` | Nível do sistema, varia por SO | Configurações impostas pela empresa que você não pode substituir, exceto por [exceções limitadas](/docs/pt/settings#security-keys-where-the-stricter-value-applies). Veja [onde salvar o arquivo](/docs/pt/managed-settings#deploy-a-managed-settings-file) e [qual fonte gerenciada Claude Code usa](/docs/pt/managed-settings#precedence-within-the-managed-tier). |1455| `managed-settings.json` | Nível do sistema, varia por SO | Configurações impostas pela empresa que você não pode substituir, exceto por [exceções limitadas](/docs/pt/settings#security-keys-where-the-stricter-value-applies). Veja [onde salvar o arquivo](/docs/pt/managed-settings#deploy-a-managed-settings-file) e [qual fonte gerenciada Claude Code usa](/docs/pt/managed-settings#precedence-within-the-managed-tier). |

1456| `CLAUDE.local.md` | Raiz do projeto | Suas preferências privadas para este projeto, carregadas junto com CLAUDE.md. Crie manualmente e adicione a `.gitignore`. |1456| `CLAUDE.local.md` | Raiz do projeto | Suas preferências privadas para este projeto, carregadas junto com CLAUDE.md. Crie manualmente e adicione a `.gitignore`. |

1457| `AGENTS.md` | Raiz do projeto, `.claude/`, ou qualquer diretório | Instruções do projeto que você escreve para agentes de codificação de IA. Claude Code pode [carregá-lo](/docs/pt/memory#agents-md) por conta própria ou junto com `CLAUDE.md`. |1457| `AGENTS.md` | Raiz do projeto, `.claude/`, ou qualquer diretório | Instruções do projeto que você escreve para agentes de codificação de IA. Claude Code pode [carregá-lo](/docs/pt/memory#agents-md) por conta própria ou junto com `CLAUDE.md`. |

1458| Plugins instalados | `~/.claude/plugins` | Marketplaces clonados, versões de plugins instalados, o registro de instalação `installed_plugins.json` e dados por plugin, gerenciados por comandos `claude plugin`. Plugins [sincronizados da sua conta claude.ai](/docs/pt/plugins/loading#synced-plugins) são baixados em `~/.claude/plugins/synced/`. Para um plugin instalado de um marketplace com [fonte `command`](/docs/pt/plugins/marketplace-reference#command-plugin-source) em modo de link, Claude Code armazena links aqui em vez de uma cópia, e os arquivos do plugin permanecem no diretório que o comando imprime. Uma fonte `command` requer Claude Code v2.1.229 ou posterior. Um plugin listado por caminho relativo em um marketplace de diretório local também [carrega no local](/docs/pt/plugins/loading#find-plugins-on-disk) de seu diretório de origem em vez de uma cópia em cache. Veja [cache de plugins](/docs/pt/plugins/loading#find-plugins-on-disk) para saber como versões órfãs são limpas. |1458| Plugins instalados | `~/.claude/plugins` | Marketplaces clonados, versões de plugins instalados, o registro de instalação `installed_plugins.json` e dados por plugin, gerenciados por comandos `claude plugin`. Plugins [sincronizados da sua conta claude.ai](/docs/pt/plugins/loading#synced-plugins) são baixados em `~/.claude/plugins/synced/`. Para um plugin instalado de um marketplace com [fonte `command`](/docs/pt/plugins/marketplace-reference#command-plugin-source) em modo de link, Claude Code armazena links aqui em vez de uma cópia, e os arquivos do plugin permanecem no diretório que o comando imprime. Uma fonte `command` requer Claude Code v2.1.229 ou posterior. Um plugin listado por caminho relativo em um marketplace que você adicionou a partir de um caminho local também [carrega no local](/docs/pt/plugins/loading#find-plugins-on-disk) a partir de seu diretório de origem, em vez de a partir de uma cópia em cache. Veja [cache de plugins](/docs/pt/plugins/loading#find-plugins-on-disk) para saber como versões órfãs são limpas. |

1459 1459 

1460`~/.claude` também contém dados que Claude Code escreve conforme você trabalha: transcrições, histórico de prompts, snapshots de arquivos, caches e logs. Veja [dados da aplicação](#application-data) abaixo.1460`~/.claude` também contém dados que Claude Code escreve conforme você trabalha: transcrições, histórico de prompts, snapshots de arquivos, caches e logs. Veja [dados da aplicação](#application-data) abaixo.

1461 1461 

Details

26 26 

27* **Fluxos CLI como `/web-setup`**: criam **Default** para você27* **Fluxos CLI como `/web-setup`**: criam **Default** para você

28* **Integração web em Pro e Max**: cria **Default** para você28* **Integração web em Pro e Max**: cria **Default** para você

29* **Integração web em Team e Enterprise**: mostra um formulário **Criar seu primeiro ambiente na nuvem** a menos que um Proprietário tenha ativado [Configuração rápida da web](/docs/pt/claude-code-on-the-web#github-authentication-options); mantenha os padrões do formulário e clique em **Criar e concluir** para obter o mesmo ambiente **Default**29* **Integração web em Team e Enterprise**: mostra um formulário **Criar seu primeiro ambiente na nuvem** a menos que um Proprietário tenha ativado [Configuração rápida da web](/docs/pt/claude-code-on-the-web#quick-web-setup-for-team-and-enterprise); mantenha os padrões do formulário e clique em **Criar e concluir** para obter o mesmo ambiente **Default**

30 30 

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

32 32 

Details

192Qualquer um desses mostra o texto completo:192Qualquer um desses mostra o texto completo:

193 193 

194* Pressione `Ctrl+O` para abrir o [visualizador de transcrição](/docs/pt/interactive-mode#transcript-viewer) e ler o texto completo sob o nome da sessão do remetente.194* Pressione `Ctrl+O` para abrir o [visualizador de transcrição](/docs/pt/interactive-mode#transcript-viewer) e ler o texto completo sob o nome da sessão do remetente.

195* Na [renderização em tela cheia](/docs/pt/fullscreen#use-the-mouse), clique em uma linha de prévia que omite parte da mensagem para expandi-la no local.

195* Em uma sessão iniciada com [`--verbose`](/docs/pt/cli-reference#cli-flags), Claude Code mostra o texto completo em vez da prévia.196* Em uma sessão iniciada com [`--verbose`](/docs/pt/cli-reference#cli-flags), Claude Code mostra o texto completo em vez da prévia.

196 197 

197A prévia encurta apenas o que você vê. Se você a expande ou não, Claude lê a mensagem completa.198A prévia encurta apenas o que você vê. Se você a expande ou não, Claude lê a mensagem completa.

desktop.md +11 −11

Details

410 Assistir tarefas em segundo plano410 Assistir tarefas em segundo plano

411</h3>411</h3>

412 412 

413O painel de tarefas mostra o trabalho em segundo plano em execução dentro da sessão atual: subagents, comandos shell em segundo plano e [workflows dinâmicos](/docs/pt/workflows). Abra-o no menu **Views** ou arraste-o para seu layout.413O painel de tarefas mostra o trabalho em segundo plano em execução dentro da sessão atual: subagentes, comandos shell em segundo plano e [workflows dinâmicos](/docs/pt/workflows). Abra-o no menu **Views** ou arraste-o para seu layout.

414 414 

415Clique em qualquer entrada para ver sua saída no painel de subagent ou pará-la. Para ver o que outras sessões estão fazendo, use a [barra lateral](#work-in-parallel-with-sessions), ou peça a Claude para [verificar nelas para você](#work-across-sessions).415Clique em qualquer entrada para ver sua saída no painel de subagente ou pará-la. Para ver o que outras sessões estão fazendo, use a [barra lateral](#work-in-parallel-with-sessions), ou peça a Claude para [verificar nelas para você](#work-across-sessions).

416 416 

417<h3 id="work-across-sessions">417<h3 id="work-across-sessions">

418 Trabalhar entre sessões418 Trabalhar entre sessões

419</h3>419</h3>

420 420 

421Claude pode listar suas outras sessões da aba Code, ler o que cada uma tem feito e enviar mensagens entre elas. Pergunte em linguagem natural: "qual sessão tocou na refatoração de autenticação?", "o que a sessão de API concluiu?" ou "diga à sessão de pagamentos que o schema mudou". Você também pode pedir a Claude para renomear ou arquivar uma sessão. Claude arquiva uma sessão da mesma forma que o ícone de arquivo da barra lateral faz, então peça a ela para limpar sessões cujos PRs foram mesclados.421Claude pode listar suas outras sessões da aba Code, ler o que cada uma tem feito e enviar mensagens entre elas. Pergunte em linguagem natural: "qual sessão tocou na refatoração de autenticação?", "o que a sessão de API concluiu?" ou "diga à sessão de pagamentos que o esquema mudou". Você também pode pedir a Claude para renomear ou arquivar uma sessão. Claude arquiva uma sessão da mesma forma que o ícone de arquivo da barra lateral faz, então peça a ela para limpar sessões cujos PRs foram mesclados.

422 422 

423Através desta superfície, Claude vê apenas as sessões que o aplicativo desktop executa por si mesmo: local, [SSH](#ssh-sessions) e sessões [WSL](/docs/pt/desktop-wsl) na aba Code. Claude não vê sessões em nuvem, ou sessões que você iniciou do CLI do terminal ou da extensão VS Code, mesmo em worktrees do mesmo projeto, então com nove worktrees de terminal abertos e duas sessões desktop, Claude respondendo em uma delas relata a outra sessão desktop. Claude nunca lista a sessão de que você está perguntando. Por padrão, ele vê as 20 sessões mais recentemente ativas e pula sessões arquivadas a menos que você peça por elas. [Mensagens entre sessões](/docs/pt/cross-session-messaging) permite separadamente que Claude envie mensagens para [suas outras sessões Claude Code](/docs/pt/cross-session-messaging#see-which-sessions-claude-can-reach), incluindo sessões de terminal.423Através desta superfície, Claude vê apenas as sessões que o aplicativo desktop executa por si mesmo: local, [SSH](#ssh-sessions) e sessões [WSL](/docs/pt/desktop-wsl) na aba Code. Claude não vê sessões na nuvem, ou sessões que você iniciou do CLI do terminal ou da extensão VS Code, mesmo em worktrees do mesmo projeto, então com nove worktrees de terminal abertos e duas sessões desktop, Claude respondendo em uma delas relata a outra sessão desktop. Claude nunca lista a sessão de que você está perguntando. Por padrão, ele vê as 20 sessões mais recentemente ativas e pula sessões arquivadas a menos que você peça por elas. [Mensagens entre sessões](/docs/pt/cross-session-messaging) permite separadamente que Claude envie mensagens para [suas outras sessões Claude Code](/docs/pt/cross-session-messaging#see-which-sessions-claude-can-reach), incluindo sessões de terminal.

424 424 

425Quando Claude envia uma mensagem para outra sessão através desta superfície, Claude Code a mostra lá como um card rotulado com o título da sessão de envio e um link de volta, para que você sempre possa dizer de onde uma mensagem veio. Se a sessão receptora está no meio de uma tarefa, Claude Code segura a mensagem e Claude a lê uma vez que o trabalho atual termina. O Claude receptor pode responder, e Claude Code entrega a resposta de volta através desta superfície. Claude não pode entregar a uma sessão arquivada e avisa você quando uma mensagem não passa.425Quando Claude envia uma mensagem para outra sessão através desta superfície, Claude Code a mostra lá como um card rotulado com o título da sessão de envio e um link de volta, para que você sempre possa dizer de onde uma mensagem veio. Se a sessão receptora está no meio de uma tarefa, Claude Code segura a mensagem e Claude a lê uma vez que o trabalho atual termina. O Claude receptor pode responder, e Claude Code entrega a resposta de volta através desta superfície. Claude não pode entregar a uma sessão arquivada e avisa você quando uma mensagem não passa.

426 426 


437 Executar tarefas de longa duração na nuvem437 Executar tarefas de longa duração na nuvem

438</h3>438</h3>

439 439 

440Para grandes refatorações, suites de teste, migrações ou outras tarefas de longa duração, selecione **Cloud** em vez de **Local** ao iniciar uma sessão. Sessões em nuvem são executadas na infraestrutura gerenciada pela Anthropic por padrão e continuam mesmo se você fechar o aplicativo ou desligar seu computador. Verifique a qualquer momento para ver o progresso ou direcionar Claude em uma direção diferente. Você também pode monitorar sessões em nuvem de [claude.ai/code](https://claude.ai/code) ou do [aplicativo Claude mobile](/docs/pt/mobile).440Para grandes refatorações, suites de teste, migrações ou outras tarefas de longa duração, selecione **Cloud** em vez de **Local** ao iniciar uma sessão. Sessões na nuvem são executadas na infraestrutura gerenciada pela Anthropic por padrão e continuam mesmo se você fechar o aplicativo ou desligar seu computador. Verifique a qualquer momento para ver o progresso ou direcionar Claude em uma direção diferente. Você também pode monitorar sessões na nuvem de [claude.ai/code](https://claude.ai/code) ou do [aplicativo Claude mobile](/docs/pt/mobile).

441 441 

442Sessões em nuvem também suportam múltiplos repositórios. Depois de selecionar um ambiente em nuvem, clique no botão **+** ao lado do repositório selecionado para adicionar mais repositórios à sessão. Cada repo obtém seu próprio seletor de branch. Isso é útil para tarefas que abrangem múltiplas bases de código, como atualizar uma biblioteca compartilhada e seus consumidores.442Sessões na nuvem também suportam múltiplos repositórios. Depois de selecionar um ambiente em nuvem, clique no botão **+** ao lado do repositório selecionado para adicionar mais repositórios à sessão. Cada repo obtém seu próprio seletor de branch. Isso é útil para tarefas que abrangem múltiplas bases de código, como atualizar uma biblioteca compartilhada e seus consumidores.

443 443 

444Veja [Use Claude Code na nuvem](/docs/pt/claude-code-on-the-web) para mais sobre como sessões em nuvem funcionam. Quando um corpo de trabalho precisa de muitas sessões em nuvem, selecione **Projects** na barra lateral para criar um [projeto](/docs/pt/claude-projects), onde Claude inicia e rastreia as sessões para você de uma conversa.444Veja [Use Claude Code na nuvem](/docs/pt/claude-code-on-the-web) para mais sobre como sessões na nuvem funcionam. Quando um corpo de trabalho precisa de muitas sessões na nuvem, selecione **Projects** na barra lateral para criar um [projeto](/docs/pt/claude-projects), onde Claude inicia e rastreia as sessões para você de uma conversa.

445 445 

446<h3 id="continue-in-another-surface">446<h3 id="continue-in-another-surface">

447 Continuar em outra superfície447 Continuar em outra superfície

448</h3>448</h3>

449 449 

450O menu **Continue in**, acessível do ícone VS Code no canto inferior direito da barra de ferramentas da sessão, permite que você mova sua sessão para outra superfície:450Para continuar uma sessão em outro lugar, abra o menu da sessão a partir do acento circunflexo ao lado do título da sessão ou a partir da linha da sessão na barra lateral e, em seguida, selecione **Open in**:

451 451 

452* **Claude Code on the Web**: envia sua sessão local para continuar executando na nuvem. Desktop envia seu branch, gera um resumo da conversa e cria uma nova sessão em nuvem com o contexto completo. Você pode então escolher arquivar a sessão local ou mantê-la. Isso requer uma árvore de trabalho limpa e não está disponível para sessões SSH.452* Selecione **Cloud** para continuar a sessão como uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), com sua conversa transferida como um resumo. Antes de você confirmar, a caixa de diálogo informa se seus arquivos também são movidos e se esta sessão será arquivada quando a sessão na nuvem estiver pronta. Você não pode mover dessa forma uma sessão executada via [SSH](#ssh-sessions) ou no [WSL](/docs/pt/desktop-wsl).

453* **Your IDE**: abre seu projeto em um IDE suportado no diretório de trabalho atual.453* Selecione um editor instalado ou seu gerenciador de arquivos para abrir nele a pasta da sessão no disco.

454 454 

455<h3 id="sessions-from-dispatch">455<h3 id="sessions-from-dispatch">

456 Sessões do Dispatch456 Sessões do Dispatch


739 739 

740[Extended thinking](/docs/pt/model-config#extended-thinking) está ativado por padrão, o que melhora o desempenho em tarefas de raciocínio complexo mas usa tokens adicionais. Na API Anthropic, defina `MAX_THINKING_TOKENS` para `0` no editor de ambiente local para desativar o thinking; isso não tem efeito em Opus 5.5, Sonnet 5.5 ou nos modelos Fable, que sempre usam extended thinking. Com o thinking desativado na API Anthropic, Claude Code envia esforço `high` em vez de um nível superior para modelos que você sabe [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como Opus 5.740[Extended thinking](/docs/pt/model-config#extended-thinking) está ativado por padrão, o que melhora o desempenho em tarefas de raciocínio complexo mas usa tokens adicionais. Na API Anthropic, defina `MAX_THINKING_TOKENS` para `0` no editor de ambiente local para desativar o thinking; isso não tem efeito em Opus 5.5, Sonnet 5.5 ou nos modelos Fable, que sempre usam extended thinking. Com o thinking desativado na API Anthropic, Claude Code envia esforço `high` em vez de um nível superior para modelos que você sabe [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como Opus 5.

741 741 

742Em modelos com [adaptive reasoning](/docs/pt/model-config#adjust-effort-level), valores de `MAX_THINKING_TOKENS` diferentes de `0` são ignorados porque adaptive reasoning controla a profundidade do thinking. Em Opus 4.6 e Sonnet 4.6, defina `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` para `1` para usar um orçamento de thinking fixo; modelos Fable, Sonnet 5 e posterior, e Opus 4.7 e posterior sempre usam adaptive reasoning e não têm modo de orçamento fixo.742Em modelos com [adaptive reasoning](/docs/pt/model-config#adjust-effort-level), Claude Code ignora o número em si em um valor positivo de `MAX_THINKING_TOKENS`, porque o adaptive reasoning controla a profundidade do pensamento. Em Opus 4.6 e Sonnet 4.6, defina `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` para `1` para usar um orçamento de pensamento fixo; modelos Fable, Sonnet 5 e posterior, e Opus 4.7 e posterior sempre usam adaptive reasoning e não têm modo de orçamento fixo.

743 743 

744<h4 id="local-sessions-on-managed-devices">744<h4 id="local-sessions-on-managed-devices">

745 Local sessions on managed devices745 Local sessions on managed devices

Details

135 135 

136**Coloque Claude em um cronograma.** Configure [scheduled tasks](/docs/pt/desktop-scheduled-tasks) para executar Claude automaticamente em uma base recorrente: uma revisão de código diária todas as manhãs, uma auditoria de dependência semanal, ou um briefing que extrai de suas ferramentas conectadas.136**Coloque Claude em um cronograma.** Configure [scheduled tasks](/docs/pt/desktop-scheduled-tasks) para executar Claude automaticamente em uma base recorrente: uma revisão de código diária todas as manhãs, uma auditoria de dependência semanal, ou um briefing que extrai de suas ferramentas conectadas.

137 137 

138**Escale quando estiver pronto.** Abra [sessões paralelas](/docs/pt/desktop#work-in-parallel-with-sessions) na barra lateral para trabalhar em várias tarefas ao mesmo tempo, opcionalmente cada uma em seu próprio Git worktree, e abra o [painel de tarefas](/docs/pt/desktop#watch-background-tasks) para observar os subagentes e comandos em segundo plano que uma sessão está executando. Abra um [chat lateral](/docs/pt/desktop#ask-a-side-question-without-derailing-the-session) para fazer uma pergunta sem descarrilar a thread principal. Envie [trabalho de longa duração para a nuvem](/docs/pt/desktop#run-long-running-tasks-in-the-cloud) para que continue mesmo se você fechar o aplicativo, ou [continue uma sessão na web ou no seu IDE](/docs/pt/desktop#continue-in-another-surface) se uma tarefa levar mais tempo do que o esperado. [Conecte ferramentas externas](/docs/pt/desktop#extend-claude-code) como GitHub, Slack e Linear para reunir seu fluxo de trabalho.138**Escale quando estiver pronto.** Abra [sessões paralelas](/docs/pt/desktop#work-in-parallel-with-sessions) na barra lateral para trabalhar em várias tarefas ao mesmo tempo, opcionalmente cada uma em seu próprio Git worktree, e abra o [painel de tarefas](/docs/pt/desktop#watch-background-tasks) para observar os subagentes e comandos em segundo plano que uma sessão está executando. Abra um [chat lateral](/docs/pt/desktop#ask-a-side-question-without-derailing-the-session) para fazer uma pergunta sem descarrilar a thread principal. Envie [trabalho de longa duração para a nuvem](/docs/pt/desktop#run-long-running-tasks-in-the-cloud) para que continue mesmo se você fechar o aplicativo, ou [mova para a nuvem uma sessão que você já iniciou](/docs/pt/desktop#continue-in-another-surface) se uma tarefa levar mais tempo do que o esperado. [Conecte ferramentas externas](/docs/pt/desktop#extend-claude-code) como GitHub, Slack e Linear para reunir seu fluxo de trabalho.

139 139 

140<h2 id="what’s-next">140<h2 id="what’s-next">

141 O que vem a seguir141 O que vem a seguir

env-vars.md +282 −279

Details

124 Variáveis124 Variáveis

125</h2>125</h2>

126 126 

127Variáveis numéricas, como timeouts, orçamentos de tokens e contagens de novas tentativas, aceitam notação científica e grafias com separador de dígitos, além de dígitos simples, exceto quando a linha da variável indica que ela aceita apenas dígitos simples. Por exemplo, o Claude Code lê `2e3` como 2000 e `64_000` como 64000. Antes da v2.1.211, essas grafias podiam definir silenciosamente um valor muito menor, como `1e6` definindo um timeout de 1.127Variáveis numéricas, como timeouts, orçamentos de tokens e contagens de novas tentativas, aceitam notação científica e grafias com separador de dígitos, além de dígitos simples, exceto quando a linha de uma variável indica que ela aceita apenas dígitos simples. Por exemplo, o Claude Code lê `2e3` como 2000 e `64_000` como 64000. Antes da v2.1.211, essas grafias podiam definir silenciosamente um valor muito menor, como `1e6` definindo um timeout como 1.

128 128 

129<Note>129<Note>

130 Para variáveis que ativam ou desativam um comportamento, defina `1`, `true`, `yes` ou `on` para ativá-lo e `0`, `false`, `no` ou `off` para desativá-lo, com qualquer combinação de maiúsculas e minúsculas.130 Para variáveis que ativam ou desativam um comportamento, defina `1`, `true`, `yes` ou `on` para ativá-lo e `0`, `false`, `no` ou `off` para desativá-lo, com qualquer combinação de maiúsculas e minúsculas.

131 131 

132 Algumas variáveis verificam apenas se você as definiu, então qualquer valor não vazio, incluindo `0`, ativa o comportamento, e você o desativa removendo a definição da variável ou definindo-a com um valor vazio. Estas variáveis funcionam dessa forma:132 Algumas variáveis leem apenas se você as definiu ou não, então qualquer valor não vazio, incluindo `0`, ativa o comportamento, e você desativa o comportamento removendo a definição da variável ou definindo-a com um valor vazio. Estas variáveis funcionam dessa forma:

133 133 

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`135 * `DISABLE_TELEMETRY`


138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

139 * `IS_DEMO`139 * `IS_DEMO`

140 140 

141 Uma outra variável tem sua própria regra: `FORCE_HYPERLINK` lê um número, então apenas `0` a desativa. A linha de cada variável também informa sua própria regra.141 Uma outra variável tem sua própria regra: `FORCE_HYPERLINK` lê um número, então apenas `0` a desativa. A linha de cada variável também indica sua própria regra.

142</Note>142</Note>

143 143 

144| Variável | Finalidade |144| Variável | Finalidade |

145| :- | :- |145| :- | :- |

146| `ANTHROPIC_API_KEY` | Chave de API enviada como cabeçalho `X-Api-Key`. Quando definida, essa chave é usada em vez da sua assinatura Claude Pro, Max, Team ou Enterprise, mesmo que você tenha feito login. No modo não interativo (`-p`), a chave é sempre usada quando presente. No modo interativo, você precisa aprovar a chave uma vez antes que ela sobrescreva sua assinatura. Para usar sua assinatura em vez disso, execute `unset ANTHROPIC_API_KEY` |146| `ANTHROPIC_API_KEY` | Chave de API enviada como cabeçalho `X-Api-Key`. Quando definida, essa chave é usada no lugar da sua assinatura Claude Pro, Max, Team ou Enterprise, mesmo que você esteja logado. No modo não interativo (`-p`), a chave é sempre usada quando presente. No modo interativo, você é solicitado a aprovar a chave uma vez antes que ela sobrescreva sua assinatura. Para usar sua assinatura em vez disso, execute `unset ANTHROPIC_API_KEY` |

147| `ANTHROPIC_AUTH_TOKEN` | Valor personalizado para o cabeçalho `Authorization` (o valor definido aqui receberá o prefixo `Bearer `) |147| `ANTHROPIC_AUTH_TOKEN` | Valor personalizado para o cabeçalho `Authorization` (o valor que você definir aqui será prefixado com `Bearer `) |

148| `ANTHROPIC_AWS_API_KEY` | Chave de API do workspace para o [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), gerada no AWS Console. Enviada como `x-api-key` e tem precedência sobre o AWS SigV4 |148| `ANTHROPIC_AWS_API_KEY` | Chave de API de workspace para [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), gerada no AWS Console. Enviada como `x-api-key` e tem precedência sobre o AWS SigV4 |

149| `ANTHROPIC_AWS_BASE_URL` | Sobrescreve a URL do endpoint do [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Use para regiões personalizadas ou ao rotear por meio de um [gateway de LLM](/docs/pt/llm-gateway). O padrão é `https://aws-external-anthropic.{region}.api.aws`. O Claude Code resolve a região com a [mesma precedência usada no Amazon Bedrock](/docs/pt/amazon-bedrock#3-configure-claude-code) |149| `ANTHROPIC_AWS_BASE_URL` | Sobrescreve a URL do endpoint do [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Use para regiões personalizadas ou ao rotear por meio de um [gateway de LLM](/docs/pt/llm-gateway). O padrão é `https://aws-external-anthropic.{region}.api.aws`. O Claude Code resolve a região com a [mesma precedência usada no Amazon Bedrock](/docs/pt/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | Obrigatória para o [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Enviada em toda requisição como o cabeçalho `anthropic-workspace-id` |150| `ANTHROPIC_AWS_WORKSPACE_ID` | Obrigatório para o [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Enviado em toda requisição como o cabeçalho `anthropic-workspace-id` |

151| `ANTHROPIC_BASE_URL` | Sobrescreve o endpoint da API para rotear requisições por meio de um proxy ou gateway. Quando definida como um host que não é first-party, o [MCP Tool Search](/docs/pt/mcp#scale-with-mcp-tool-search) fica desativado por padrão. Defina `ENABLE_TOOL_SEARCH=true` se seu proxy encaminhar blocos `tool_reference`. A partir da v2.1.196, o [Remote Control](/docs/pt/remote-control#requirements) fica desativado quando esta variável aponta para um host diferente de `api.anthropic.com`, correspondendo ao seu comportamento no Amazon Bedrock, no Google Cloud's Agent Platform e no Microsoft Foundry |151| `ANTHROPIC_BASE_URL` | Sobrescreve o endpoint da API para rotear requisições por meio de um proxy ou gateway. Quando definido com um host que não é próprio da Anthropic, o [MCP Tool Search](/docs/pt/mcp#scale-with-mcp-tool-search) fica desativado por padrão. Defina `ENABLE_TOOL_SEARCH=true` se o seu proxy encaminhar blocos `tool_reference`. A partir da v2.1.196, o [Remote Control](/docs/pt/remote-control#requirements) fica desativado quando isso aponta para um host diferente de `api.anthropic.com`, correspondendo ao seu comportamento no Amazon Bedrock, no Google Cloud's Agent Platform e no Microsoft Foundry |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Sobrescreve a URL do endpoint do Amazon Bedrock. Use para endpoints personalizados do Amazon Bedrock ou ao rotear por meio de um [gateway de LLM](/docs/pt/llm-gateway). Consulte [Amazon Bedrock](/docs/pt/amazon-bedrock) |152| `ANTHROPIC_BEDROCK_BASE_URL` | Sobrescreve a URL do endpoint do Amazon Bedrock. Use para endpoints personalizados do Amazon Bedrock ou ao rotear por meio de um [gateway de LLM](/docs/pt/llm-gateway). Consulte [Amazon Bedrock](/docs/pt/amazon-bedrock) |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sobrescreve a URL do endpoint Mantle do Amazon Bedrock. Consulte [Endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sobrescreve a URL do endpoint do Amazon Bedrock Mantle. Consulte [Endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Prefixo do perfil de inferência entre regiões (`us`, `eu`, `apac`, `jp`, `au` ou `global`) que o Claude Code tenta primeiro em vez daquele derivado da região da AWS. Ignorada em regiões do AWS GovCloud. Requer Claude Code v2.1.224 ou posterior. Consulte [Amazon Bedrock](/docs/pt/amazon-bedrock#cross-region-inference-profile-prefixes) |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Prefixo do perfil de inferência entre regiões (`us`, `eu`, `apac`, `jp`, `au` ou `global`) que o Claude Code tenta primeiro em vez daquele derivado da região da AWS. Ignorado em regiões do AWS GovCloud. Requer Claude Code v2.1.224 ou posterior. Consulte [Amazon Bedrock](/docs/pt/amazon-bedrock#cross-region-inference-profile-prefixes) |

155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Nível de serviço](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) do Amazon Bedrock (`default`, `flex` ou `priority`). Enviado como o cabeçalho `X-Amzn-Bedrock-Service-Tier`. Consulte [Amazon Bedrock](/docs/pt/amazon-bedrock#service-tiers) |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Nível de serviço](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) do Amazon Bedrock (`default`, `flex` ou `priority`). Enviado como o cabeçalho `X-Amzn-Bedrock-Service-Tier`. Consulte [Amazon Bedrock](/docs/pt/amazon-bedrock#service-tiers) |

156| `ANTHROPIC_BETAS` | Lista separada por vírgulas de valores adicionais do cabeçalho `anthropic-beta` a incluir nas requisições à API. O Claude Code já envia os cabeçalhos beta de que precisa; use esta variável para aderir a um [beta da Anthropic API](https://platform.claude.com/docs/en/api/beta-headers) antes que o Claude Code adicione suporte nativo. Diferentemente da [flag `--betas`](/docs/pt/cli-reference#cli-flags), que exige autenticação por chave de API, esta variável funciona com todos os métodos de autenticação, incluindo a assinatura do Claude.ai |156| `ANTHROPIC_BETAS` | Lista separada por vírgulas de valores adicionais do cabeçalho `anthropic-beta` a incluir nas requisições de API. O Claude Code já envia os cabeçalhos beta de que precisa; use isso para aderir a um [beta da API da Anthropic](https://platform.claude.com/docs/en/api/beta-headers) antes que o Claude Code adicione suporte nativo. Diferentemente da [flag `--betas`](/docs/pt/cli-reference#cli-flags), que requer autenticação por chave de API, esta variável funciona com todos os métodos de autenticação, incluindo a assinatura do Claude.ai |

157| `ANTHROPIC_CUSTOM_HEADERS` | Cabeçalhos personalizados a adicionar às requisições (formato `Name: Value`, separados por nova linha para múltiplos cabeçalhos). Se um nome ou valor contiver um caractere que um cabeçalho HTTP não pode transportar, como uma aspa curva ou um espaço de largura zero, a requisição falha com um erro que identifica o par pela posição. Requer Claude Code v2.1.227 ou posterior. [Invalid request header value](/docs/pt/errors#invalid-request-header-value) lista o conjunto exato de caracteres e onde a verificação é executada. Um valor que define um cabeçalho de credencial, organização ou tenant, roteamento ou comportamento da API, como `Authorization` ou `Host`, conta como uma [configuração que precisa de aprovação](/docs/pt/server-managed-settings#environment-variables-and-the-approval-dialog) quando entregue por configurações gerenciadas pelo servidor. A partir das configurações de projeto ou locais, esse valor segue as [regras sobre quando os valores de `env` se aplicam](/docs/pt/settings-reference#when-claude-code-applies-env-values) |157| `ANTHROPIC_CUSTOM_HEADERS` | Cabeçalhos personalizados a adicionar às requisições (formato `Name: Value`, separados por nova linha para vários cabeçalhos). Se um nome ou valor contiver um caractere que um cabeçalho HTTP não pode transportar, como aspas curvas ou um espaço de largura zero, a requisição falha com um erro que identifica o par pela posição. Requer Claude Code v2.1.227 ou posterior. [Invalid request header value](/docs/pt/errors#invalid-request-header-value) lista o conjunto exato de caracteres e onde a verificação é executada. Um valor que define um cabeçalho de credencial, organização ou tenant, roteamento ou comportamento da API, como `Authorization` ou `Host`, conta como uma [configuração que precisa de aprovação](/docs/pt/server-managed-settings#environment-variables-and-the-approval-dialog) quando as configurações gerenciadas pelo servidor o entregam. A partir das configurações de projeto ou locais, esse valor segue as [regras de quando os valores de `env` se aplicam](/docs/pt/settings-reference#when-claude-code-applies-env-values) |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID do modelo a adicionar como uma entrada personalizada no seletor `/model`. Use esta variável para tornar selecionável um modelo não padrão ou específico de gateway sem substituir os aliases integrados. Consulte [Configuração de modelo](/docs/pt/model-config#add-a-custom-model-option) |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID do modelo a adicionar como uma entrada personalizada no seletor `/model`. Use isso para tornar selecionável um modelo não padrão ou específico de gateway sem substituir os aliases integrados. Consulte [Configuração de modelo](/docs/pt/model-config#add-a-custom-model-option) |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrição exibida para a entrada de modelo personalizado no seletor `/model`. O padrão é `Custom model (<model-id>)` quando não definida |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrição exibida para a entrada de modelo personalizado no seletor `/model`. O padrão é `Custom model (<model-id>)` quando não definida |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nome exibido para a entrada de modelo personalizado no seletor `/model`. Quando não definida, a entrada mostra o nome do modelo se o Claude Code [reconhecer o ID](/docs/pt/model-config#customize-pinned-model-display-and-capabilities), e o ID do modelo caso contrário |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nome exibido para a entrada de modelo personalizado no seletor `/model`. Quando não definido, a entrada mostra o nome do modelo se o Claude Code [reconhecer o ID](/docs/pt/model-config#customize-pinned-model-display-and-capabilities), e o ID do modelo caso contrário |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [recursos](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo personalizado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [capacidades](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo personalizado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID do modelo para o qual o alias `fable` é resolvido, e o ID que o Claude Code reconhece como um modelo Fable para o [fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) em provedores terceirizados. Consulte [Configuração de modelo](/docs/pt/model-config#environment-variables) |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID do modelo para o qual o alias `fable` é resolvido, e o ID que o Claude Code reconhece como um modelo Fable para o [fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) em provedores de terceiros. Consulte [Configuração de modelo](/docs/pt/model-config#environment-variables) |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Descrição exibida para o modelo Fable fixado no seletor `/model`. Quando não definida, a linha mostra uma descrição padrão que começa com `Custom Fable model`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Descrição exibida para o modelo Fable fixado no seletor `/model`. Quando não definida, a linha mostra uma descrição padrão que começa com `Custom Fable model`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome exibido para o modelo Fable fixado no seletor `/model`. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome exibido para o modelo Fable fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [recursos](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo Fable fixado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [capacidades](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo Fable fixado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID do modelo para o qual o alias `haiku` é resolvido, também usado para [funcionalidades em segundo plano](/docs/pt/costs#background-token-usage). Consulte [Configuração de modelo](/docs/pt/model-config#environment-variables) |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID do modelo para o qual o alias `haiku` é resolvido, também usado para [funcionalidades em segundo plano](/docs/pt/costs#background-token-usage). Consulte [Configuração de modelo](/docs/pt/model-config#environment-variables) |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Descrição exibida para o modelo Haiku fixado no seletor `/model`. Quando não definida, a linha mostra uma descrição padrão que começa com `Custom Haiku model`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Descrição exibida para o modelo Haiku fixado no seletor `/model`. Quando não definida, a linha mostra uma descrição padrão que começa com `Custom Haiku model`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome exibido para o modelo Haiku fixado no seletor `/model`. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome exibido para o modelo Haiku fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [recursos](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo Haiku fixado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [capacidades](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo Haiku fixado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

170| `ANTHROPIC_DEFAULT_MODEL` | Modelo com o qual novas sessões iniciam por padrão. Requer Claude Code v2.1.236 ou posterior. Consulte [Definir um modelo padrão para novas sessões](/docs/pt/model-config#set-a-default-model-for-new-sessions) |170| `ANTHROPIC_DEFAULT_MODEL` | Modelo com o qual novas sessões começam por padrão. Requer Claude Code v2.1.236 ou posterior. Consulte [Definir um modelo padrão para novas sessões](/docs/pt/model-config#set-a-default-model-for-new-sessions) |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID do modelo para o qual o alias `opus` é resolvido, e que o `opusplan` usa enquanto o modo de planejamento está ativo. Consulte [Configuração de modelo](/docs/pt/model-config#environment-variables) |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID do modelo para o qual o alias `opus` é resolvido, e que o `opusplan` usa enquanto o Plan Mode está ativo. Consulte [Configuração de modelo](/docs/pt/model-config#environment-variables) |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrição exibida para o modelo Opus fixado no seletor `/model`. Quando não definida, a linha mostra uma descrição padrão que começa com `Custom Opus model`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrição exibida para o modelo Opus fixado no seletor `/model`. Quando não definida, a linha mostra uma descrição padrão que começa com `Custom Opus model`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome exibido para o modelo Opus fixado no seletor `/model`. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome exibido para o modelo Opus fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [recursos](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo Opus fixado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [capacidades](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo Opus fixado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID do modelo para o qual o alias `sonnet` é resolvido, e que o `opusplan` usa quando o modo de planejamento não está ativo. Consulte [Configuração de modelo](/docs/pt/model-config#environment-variables) |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID do modelo para o qual o alias `sonnet` é resolvido, e que o `opusplan` usa quando o Plan Mode não está ativo. Consulte [Configuração de modelo](/docs/pt/model-config#environment-variables) |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Descrição exibida para o modelo Sonnet fixado no seletor `/model`. Quando não definida, a linha mostra uma descrição padrão que começa com `Custom Sonnet model`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Descrição exibida para o modelo Sonnet fixado no seletor `/model`. Quando não definida, a linha mostra uma descrição padrão que começa com `Custom Sonnet model`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome exibido para o modelo Sonnet fixado no seletor `/model`. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome exibido para o modelo Sonnet fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [recursos](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo Sonnet fixado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [capacidades](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo Sonnet fixado suporta, por exemplo `effort,thinking`. Consulte [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_FEDERATION_RULE_ID` | ID da regra de federação para [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Quando você a define junto com `ANTHROPIC_ORGANIZATION_ID`, o Claude Code seleciona credenciais de federação, que têm prioridade sobre sua credencial do `/login`. Consulte [precedência de autenticação](/docs/pt/authentication#authentication-precedence) |179| `ANTHROPIC_FEDERATION_RULE_ID` | ID da regra de federação para [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Quando você a define junto com `ANTHROPIC_ORGANIZATION_ID`, o Claude Code seleciona credenciais de federação, que têm prioridade sobre sua credencial de `/login`. Consulte [precedência de autenticação](/docs/pt/authentication#authentication-precedence) |

180| `ANTHROPIC_FOUNDRY_API_KEY` | Chave de API para autenticação no Microsoft Foundry (consulte [Microsoft Foundry](/docs/pt/microsoft-foundry)) |180| `ANTHROPIC_FOUNDRY_API_KEY` | Chave de API para autenticação no Microsoft Foundry (consulte [Microsoft Foundry](/docs/pt/microsoft-foundry)) |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Token bearer para autenticação no Microsoft Foundry, como um token de acesso do Microsoft Entra. O Claude Code o envia como o cabeçalho `Authorization: Bearer`. Tem precedência sobre `ANTHROPIC_FOUNDRY_API_KEY` e sobre a cadeia de credenciais padrão do Azure. Consulte [Microsoft Foundry](/docs/pt/microsoft-foundry). Requer Claude Code v2.1.203 ou posterior |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Token bearer para autenticação no Microsoft Foundry, como um token de acesso do Microsoft Entra. O Claude Code o envia como o cabeçalho `Authorization: Bearer`. Tem precedência sobre `ANTHROPIC_FOUNDRY_API_KEY` e sobre a cadeia de credenciais padrão do Azure. Consulte [Microsoft Foundry](/docs/pt/microsoft-foundry). Requer Claude Code v2.1.203 ou posterior |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | URL base completa do recurso do Microsoft Foundry (por exemplo, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (consulte [Microsoft Foundry](/docs/pt/microsoft-foundry)) |182| `ANTHROPIC_FOUNDRY_BASE_URL` | URL base completa do recurso do Microsoft Foundry (por exemplo, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (consulte [Microsoft Foundry](/docs/pt/microsoft-foundry)) |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome do recurso do Microsoft Foundry (por exemplo, `my-resource`). O Claude Code [recusa uma URL ou um nome de host](/docs/pt/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Obrigatória se `ANTHROPIC_FOUNDRY_BASE_URL` não estiver definida (consulte [Microsoft Foundry](/docs/pt/microsoft-foundry)) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome do recurso do Microsoft Foundry (por exemplo, `my-resource`). O Claude Code [recusa uma URL ou nome de host](/docs/pt/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Obrigatório se `ANTHROPIC_FOUNDRY_BASE_URL` não estiver definida (consulte [Microsoft Foundry](/docs/pt/microsoft-foundry)) |

184| `ANTHROPIC_MODEL` | Nome da configuração de modelo a usar (consulte [Configuração de modelo](/docs/pt/model-config#environment-variables)) |184| `ANTHROPIC_MODEL` | Nome da configuração de modelo a usar (consulte [Configuração de modelo](/docs/pt/model-config#environment-variables)) |

185| `ANTHROPIC_ORGANIZATION_ID` | ID da organização para [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Defina-a junto com `ANTHROPIC_FEDERATION_RULE_ID`. Consulte [precedência de autenticação](/docs/pt/authentication#authentication-precedence) |185| `ANTHROPIC_ORGANIZATION_ID` | ID da organização para [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Defina-a junto com `ANTHROPIC_FEDERATION_RULE_ID`. Consulte [precedência de autenticação](/docs/pt/authentication#authentication-precedence) |

186| `ANTHROPIC_PROFILE` | Nome do perfil da Anthropic com o qual autenticar, como um criado por [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) ou ao [entrar em uma conta do Console sem uma chave de API](/docs/pt/authentication#sign-in-without-an-api-key). Consulte [precedência de autenticação](/docs/pt/authentication#authentication-precedence) |186| `ANTHROPIC_PROFILE` | Nome do perfil da Anthropic com o qual autenticar, como um criado por [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) ou ao [entrar em uma conta do Console sem uma chave de API](/docs/pt/authentication#sign-in-without-an-api-key). Consulte [precedência de autenticação](/docs/pt/authentication#authentication-precedence) |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DESCONTINUADA] Nome do [modelo da classe Haiku para tarefas em segundo plano](/docs/pt/costs) |187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DESCONTINUADO] Nome do [modelo da classe Haiku para tarefas em segundo plano](/docs/pt/costs) |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sobrescreve a região da AWS para o modelo da classe Haiku ao usar o Amazon Bedrock ou o Amazon Bedrock Mantle. No Amazon Bedrock, isso só tem efeito quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou a descontinuada `ANTHROPIC_SMALL_FAST_MODEL` também está definida, já que, caso contrário, o Amazon Bedrock executa tarefas em segundo plano no [modelo Sonnet padrão ou no modelo principal](/docs/pt/amazon-bedrock#4-pin-model-versions) na região da sessão |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sobrescreve a região da AWS para o modelo da classe Haiku ao usar o Amazon Bedrock ou o Amazon Bedrock Mantle. No Amazon Bedrock, isso só tem efeito quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou a descontinuada `ANTHROPIC_SMALL_FAST_MODEL` também está definida, pois, caso contrário, o Amazon Bedrock executa tarefas em segundo plano no [modelo Sonnet padrão ou no modelo principal](/docs/pt/amazon-bedrock#4-pin-model-versions) na região da sessão |

189| `ANTHROPIC_VERTEX_BASE_URL` | Sobrescreve a URL do endpoint do Google Cloud's Agent Platform. Use para endpoints personalizados do Google Cloud's Agent Platform ou ao rotear por meio de um [gateway de LLM](/docs/pt/llm-gateway). Consulte [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) |189| `ANTHROPIC_VERTEX_BASE_URL` | Sobrescreve a URL do endpoint do Google Cloud's Agent Platform. Use para endpoints personalizados do Google Cloud's Agent Platform ou ao rotear por meio de um [gateway de LLM](/docs/pt/llm-gateway). Consulte [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID do projeto do GCP ao qual as requisições do Google Cloud's Agent Platform são endereçadas. Consulte [Configurar credenciais do GCP](/docs/pt/google-vertex-ai#3-configure-gcp-credentials) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID do projeto GCP ao qual as requisições do Google Cloud's Agent Platform são endereçadas. Consulte [Configurar credenciais do GCP](/docs/pt/google-vertex-ai#3-configure-gcp-credentials) |

191| `ANTHROPIC_WORKSPACE_ID` | ID do workspace para [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Defina-a quando sua regra de federação tiver escopo em mais de um workspace, para que a troca de token saiba qual workspace usar como destino |191| `ANTHROPIC_WORKSPACE_ID` | ID do workspace para [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Defina-a quando sua regra de federação tiver escopo para mais de um workspace, para que a troca de tokens saiba qual workspace usar como destino |

192| `API_FORCE_IDLE_TIMEOUT` | Sobrescreve o timeout de inatividade do corpo de 5 minutos que aborta uma resposta de modelo via streaming quando nenhum byte chega. Defina como `0` para desativar o timeout, por exemplo quando um [gateway](/docs/pt/llm-gateway) lento ou um modelo local pausa por mais de 5 minutos entre chunks, ou `1` para mantê-lo ativo para todos os provedores. Quando não definida, o timeout fica ativo em provedores diferentes da Anthropic API direta, do [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) e do Amazon Bedrock com `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` definida. Os [watchdogs de stream](/docs/pt/network-config#streaming-idle-watchdogs) são executados independentemente dele e abortam uma longa pausa silenciosa mesmo quando você define `0` aqui |192| `API_FORCE_IDLE_TIMEOUT` | Sobrescreve o timeout de inatividade do corpo de 5 minutos que aborta uma resposta de modelo por streaming quando nenhum byte chega. Defina como `0` para desativar o timeout, por exemplo quando um [gateway](/docs/pt/llm-gateway) lento ou um modelo local pausa por mais de 5 minutos entre chunks, ou `1` para mantê-lo ativo para todos os provedores. Quando não definida, o timeout fica ativo em provedores diferentes da API direta da Anthropic, do [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) e do Amazon Bedrock com `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` definida. Os [watchdogs de stream](/docs/pt/network-config#streaming-idle-watchdogs) funcionam independentemente dele e abortam uma longa pausa silenciosa mesmo quando você define `0` aqui |

193| `API_TIMEOUT_MS` | Timeout para requisições à API em milissegundos (padrão: 600000, ou 10 minutos; máximo: 2147483647). Aumente-o quando as requisições atingirem o timeout em redes lentas ou ao rotear por meio de um proxy. Valores acima do máximo causam overflow no timer subjacente e fazem as requisições falharem imediatamente |193| `API_TIMEOUT_MS` | Timeout para requisições de API em milissegundos (padrão: 600000, ou 10 minutos; máximo: 2147483647). Aumente-o quando as requisições atingirem o timeout em redes lentas ou ao rotear por meio de um proxy. Valores acima do máximo causam overflow no timer subjacente e fazem as requisições falharem imediatamente |

194| `AWS_BEARER_TOKEN_BEDROCK` | Chave de API do Amazon Bedrock para autenticação (consulte [Chaves de API do Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |194| `AWS_BEARER_TOKEN_BEDROCK` | Chave de API do Amazon Bedrock para autenticação (consulte [Chaves de API do Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

195| `BASH_DEFAULT_TIMEOUT_MS` | Timeout padrão para um comando em primeiro plano das ferramentas Bash ou PowerShell, em milissegundos (padrão: 120000, ou 2 minutos). Um padrão maior que 30 minutos também se torna o [limite de tempo padrão para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands) em sessões não supervisionadas. O limite de tempo em segundo plano requer Claude Code v2.1.285 ou posterior |195| `BASH_DEFAULT_TIMEOUT_MS` | Timeout padrão para um comando das ferramentas Bash ou PowerShell em primeiro plano, em milissegundos (padrão: 120000, ou 2 minutos). Um padrão maior que 30 minutos também se torna o [limite de tempo padrão para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands) em sessões não supervisionadas. O limite de tempo em segundo plano requer Claude Code v2.1.285 ou posterior |

196| `BASH_MAX_OUTPUT_LENGTH` | Número máximo de caracteres da saída do bash que o Claude Code lê de volta no resultado de um comando (padrão: 30000; máximo: 150000). Se você definir a configuração [`bashOutputMaxChars`](/docs/pt/settings-reference#bashoutputmaxchars), o Claude Code ignora esta variável. Consulte [Limites de saída](/docs/pt/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Número máximo de caracteres da saída do bash que o Claude Code lê de volta no resultado de um comando (padrão: 30000; máximo: 150000). Se você definir a configuração [`bashOutputMaxChars`](/docs/pt/settings-reference#bashoutputmaxchars), o Claude Code ignora esta variável. Consulte [Limites de saída](/docs/pt/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Timeout máximo que o modelo pode definir para um comando em primeiro plano das ferramentas Bash ou PowerShell, em milissegundos (padrão: 600000, ou 10 minutos). O teto efetivo é o maior valor entre este e `BASH_DEFAULT_TIMEOUT_MS`. Um teto efetivo maior que 2 horas também se torna o [limite de tempo para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands) máximo em sessões não supervisionadas. O limite de tempo em segundo plano requer Claude Code v2.1.285 ou posterior |197| `BASH_MAX_TIMEOUT_MS` | Timeout máximo que o modelo pode definir para um comando das ferramentas Bash ou PowerShell em primeiro plano, em milissegundos (padrão: 600000, ou 10 minutos). O teto efetivo é o maior entre este valor e `BASH_DEFAULT_TIMEOUT_MS`. Um teto efetivo maior que 2 horas também se torna o [limite de tempo máximo para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands) em sessões não supervisionadas. O limite de tempo em segundo plano requer Claude Code v2.1.285 ou posterior |

198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP para [tracing beta detalhado](/docs/pt/monitoring-usage#traces-beta): com `ENABLE_BETA_TRACING_DETAILED=1`, logs e traces vão para lá em vez de para os exportadores configurados. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP para [rastreamento beta detalhado](/docs/pt/monitoring-usage#traces-beta): com `ENABLE_BETA_TRACING_DETAILED=1`, logs e traces vão para ele em vez dos exportadores configurados. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Defina como `1` para forçar o [`claude --cloud`](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github) a empacotar e enviar seu repositório local em vez de cloná-lo a partir do remoto |199| `CCR_FORCE_BUNDLE` | Defina como `1` para forçar o [`claude --cloud`](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github) a empacotar e enviar seu repositório local em vez de cloná-lo a partir do remoto |

200| `CLAUDECODE` | Definida como `1` em subprocessos que o Claude Code inicia (ferramentas Bash e PowerShell, sessões do tmux, comandos de [hook](/docs/pt/hooks), comandos de [linha de status](/docs/pt/statusline), subprocessos de [servidor MCP](/docs/pt/mcp) stdio). As extensões de IDE também a definem em seus terminais integrados. Use para detectar quando um script está sendo executado dentro de um subprocesso iniciado pelo Claude Code. Para verificar se o processo atual foi iniciado diretamente por uma chamada de ferramenta ou hook, e não dentro de um servidor MCP stdio que o Claude Code iniciou, use `CLAUDE_CODE_CHILD_SESSION` em vez disso |200| `CLAUDECODE` | Definida como `1` em subprocessos que o Claude Code inicia (ferramentas Bash e PowerShell, sessões tmux, comandos de [hook](/docs/pt/hooks), comandos de [linha de status](/docs/pt/statusline), subprocessos de [servidor MCP](/docs/pt/mcp) stdio). As extensões de IDE também a definem em seus terminais integrados. Use para detectar quando um script está sendo executado dentro de um subprocesso iniciado pelo Claude Code. Para verificar se o processo atual foi iniciado diretamente por uma chamada de ferramenta ou hook, e não dentro de um servidor MCP stdio que o Claude Code iniciou, use `CLAUDE_CODE_CHILD_SESSION` em vez disso |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Quantos milissegundos antes da continuação automática a contagem regressiva na tela aparece em uma caixa de diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondida. Padrão `20000` (20 segundos), limitado ao timeout de continuação automática. Não tem efeito a menos que a continuação automática esteja ativada; consulte a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Requer Claude Code v2.1.198 ou posterior |201| `CLAUDE_AFK_COUNTDOWN_MS` | Quantos milissegundos antes da continuação automática a contagem regressiva na tela aparece em um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondido. Padrão `20000` (20 segundos), limitado ao timeout da continuação automática. Não tem efeito a menos que a continuação automática esteja ativada; consulte a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Requer Claude Code v2.1.198 ou posterior |

202| `CLAUDE_AFK_TIMEOUT_MS` | Quantos milissegundos de inatividade antes que uma caixa de diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondida continue automaticamente sem você. A continuação automática vem desativada por padrão; ative-a com a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout). Esta variável é uma substituição para demonstrações e testes automatizados: quando definida, tem precedência sobre essa configuração e ativa a continuação automática mesmo quando a configuração não está definida ou é `never`. Definir `0` não desativa o timeout; fecha a caixa de diálogo imediatamente. Na v2.1.198 e na v2.1.199, a continuação automática vinha ativada por padrão com um timeout de `60000` (60 segundos). Requer Claude Code v2.1.198 ou posterior |202| `CLAUDE_AFK_TIMEOUT_MS` | Quantos milissegundos de inatividade antes que um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondido continue automaticamente sem você. A continuação automática fica desativada por padrão; ative-a com a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout). Esta variável é uma substituição para demonstrações e testes automatizados: quando definida, tem precedência sobre essa configuração e ativa a continuação automática mesmo quando a configuração não está definida ou é `never`. Definir `0` não desativa o timeout; fecha o diálogo imediatamente. Nas v2.1.198 e v2.1.199, a continuação automática ficava ativada por padrão com um timeout de `60000` (60 segundos). Requer Claude Code v2.1.198 ou posterior |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Defina como `1` para desativar todos os tipos de [subagente](/docs/pt/sub-agents) integrados, como Explore e Plan. Aplica-se apenas no modo não interativo (a flag `-p`). Útil para usuários do SDK que querem começar do zero. Isso também remove o `general-purpose`, o subagente que o Claude Code executa quando uma chamada da ferramenta Agent omite `subagent_type`. Essa chamada então falha com [`subagent_type is required`](/docs/pt/errors#subagent-type-is-required) |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Defina como `1` para desativar todos os tipos de [subagente](/docs/pt/sub-agents) integrados, como Explore e Plan. Aplica-se apenas no modo não interativo (a flag `-p`). Útil para usuários do SDK que desejam começar do zero. Isso também remove `general-purpose`, o subagente que o Claude Code executa quando uma chamada da ferramenta Agent omite `subagent_type`. Essa chamada então falha com [`subagent_type is required`](/docs/pt/errors#subagent-type-is-required) |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Defina como `1` para omitir o prefixo `mcp__<server>__` nos nomes de ferramentas de servidores MCP criados pelo SDK. As ferramentas usam seus nomes originais. Apenas para uso do SDK |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Defina como `1` para omitir o prefixo `mcp__<server>__` nos nomes de ferramentas de servidores MCP criados pelo SDK. As ferramentas usam seus nomes originais. Apenas para uso com o SDK |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout de travamento em milissegundos para subagentes. Padrão `600000` (10 minutos); se você aumentar `CLAUDE_STREAM_IDLE_TIMEOUT_MS` enquanto o watchdog de stream está ativo, o padrão aumenta junto, conforme descrito em [Lidar com respostas lentas ou travadas da API](/docs/pt/agent-sdk/typescript#handle-slow-or-stalled-api-responses). O timer é reiniciado a cada evento de progresso de streaming; se nenhum progresso chegar dentro da janela, o Claude Code aborta o subagente e informa o travamento ao pai |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout de travamento em milissegundos para subagentes. Padrão `600000` (10 minutos); se você aumentar `CLAUDE_STREAM_IDLE_TIMEOUT_MS` enquanto o watchdog de stream está ativo, o padrão aumenta junto, conforme descrito em [Lidar com respostas de API lentas ou travadas](/docs/pt/agent-sdk/typescript#handle-slow-or-stalled-api-responses). O timer é reiniciado a cada evento de progresso do streaming; se nenhum progresso chegar dentro da janela, o Claude Code aborta o subagente e relata o travamento ao pai |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Define a porcentagem (1-100) da janela de compactação automática na qual a compactação automática é acionada. Use valores menores, como `50`, para compactar mais cedo; a variável não pode elevar o limite, então valores acima da porcentagem padrão são ignorados. Aplica-se apenas em sessões que [compactam antes do limite de contexto do modelo](/docs/pt/model-config#context-window-and-auto-compaction). Aplica-se tanto às conversas principais quanto aos subagentes |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Define a porcentagem (1-100) da janela de compactação automática na qual a compactação automática é acionada. Use valores menores, como `50`, para compactar mais cedo; a variável não pode aumentar o limite, então valores acima da porcentagem padrão são ignorados. Aplica-se apenas em sessões que [compactam antes do limite de contexto do modelo](/docs/pt/model-config#context-window-and-auto-compaction). Aplica-se tanto às conversas principais quanto aos subagentes |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Defina como `1` para forçar a ativação do envio automático para segundo plano de tarefas de agente de longa duração. Quando ativada, os subagentes são movidos para segundo plano após serem executados por aproximadamente dois minutos. Também ativa o [envio automático para segundo plano de chamadas longas de ferramentas MCP](/docs/pt/mcp#automatic-backgrounding-of-long-tool-calls) no modo não interativo no Claude Code v2.1.212 ou posterior |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Defina como `1` para forçar a ativação do envio automático para segundo plano de tarefas de agente de longa duração. Quando ativado, os subagentes são movidos para segundo plano após executarem por aproximadamente dois minutos. Também ativa o [envio automático para segundo plano de chamadas longas de ferramentas MCP](/docs/pt/mcp#automatic-backgrounding-of-long-tool-calls) no modo não interativo no Claude Code v2.1.212 ou posterior |

208| `CLAUDE_AX_PREPARK_MS` | No [modo de leitor de tela](/docs/pt/accessibility), quantos milissegundos o Claude Code espera antes de escrever uma linha nova ou alterada. Padrão `0`, então o Claude Code não espera. Antes da v2.1.287, o padrão era `50`. O Claude Code limita a espera a `5000`. Requer Claude Code v2.1.233 ou posterior |208| `CLAUDE_AX_PREPARK_MS` | No [modo de leitor de tela](/docs/pt/accessibility), quantos milissegundos o Claude Code espera antes de escrever uma linha nova ou alterada. Padrão `0`, então o Claude Code não espera. Antes da v2.1.287, o padrão era `50`. O Claude Code limita a espera a `5000`. Requer Claude Code v2.1.233 ou posterior |

209| `CLAUDE_AX_SCREEN_READER` | Defina como `1` para renderizar uma saída adequada a leitores de tela: texto plano sem bordas decorativas ou animações. Defina como `0` para forçar a desativação do modo de leitor de tela mesmo quando [`axScreenReader`](/docs/pt/settings-reference#axscreenreader) for `true`. A flag [`--ax-screen-reader`](/docs/pt/cli-reference#cli-flags) tem precedência. Requer Claude Code v2.1.181 ou posterior |209| `CLAUDE_AX_SCREEN_READER` | Defina como `1` para renderizar uma saída amigável para leitores de tela: texto simples sem bordas decorativas ou animações. Defina como `0` para forçar a desativação do modo de leitor de tela mesmo quando [`axScreenReader`](/docs/pt/settings-reference#axscreenreader) for `true`. A flag [`--ax-screen-reader`](/docs/pt/cli-reference#cli-flags) tem precedência. Requer Claude Code v2.1.181 ou posterior |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | No [modo de leitor de tela](/docs/pt/accessibility), quantos milissegundos o Claude Code retém a primeira renderização da interface após a linha de confirmação de inicialização, para que seu leitor de tela possa falar a linha por completo antes que uma nova saída a interrompa. Padrão `3000`. Defina `0` para renderizar imediatamente. O Claude Code limita a retenção a `600000` (10 minutos). Seu primeiro pressionamento de tecla encerra a retenção antecipadamente. Requer Claude Code v2.1.217 ou posterior |210| `CLAUDE_AX_STARTUP_QUIET_MS` | No [modo de leitor de tela](/docs/pt/accessibility), por quantos milissegundos o Claude Code retém a primeira renderização da interface após a linha de confirmação de inicialização, para que seu leitor de tela possa falar a linha por completo antes que uma nova saída a interrompa. Padrão `3000`. Defina `0` para renderizar imediatamente. O Claude Code limita a retenção a `600000` (10 minutos). Seu primeiro pressionamento de tecla encerra a retenção antecipadamente. Requer Claude Code v2.1.217 ou posterior |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Retorna ao diretório de trabalho original após cada comando Bash ou PowerShell na sessão principal |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Retorna ao diretório de trabalho original após cada comando Bash ou PowerShell na sessão principal |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout em milissegundos para o watchdog de inatividade de streaming em nível de bytes; quando definida, tem precedência sobre `CLAUDE_STREAM_IDLE_TIMEOUT_MS` para esse watchdog e deixa o watchdog em nível de eventos inalterado. O Claude Code restringe esta variável a um valor entre 10 segundos e 30 minutos. Requer Claude Code v2.1.210 ou posterior |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout em milissegundos para o watchdog de inatividade de streaming em nível de bytes; quando definida, tem precedência sobre `CLAUDE_STREAM_IDLE_TIMEOUT_MS` para esse watchdog e deixa o watchdog em nível de eventos inalterado. O Claude Code restringe esta variável a um valor entre 10 segundos e 30 minutos. Requer Claude Code v2.1.210 ou posterior |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | Caminho para um arquivo que uma ferramenta externa, como um listener de bloqueio de tela, cria quando você desbloqueia a tela e exclui quando você a bloqueia. Enquanto o arquivo existir, o Claude Code ignora as [notificações push móveis do Remote Control](/docs/pt/remote-control#mobile-push-notifications), então você deixa de receber pushes enquanto usa ativamente o computador. Quando o arquivo está ausente ou ilegível, as notificações são enviadas normalmente. O Claude Code verifica o arquivo uma vez por evento que aciona um push, em vez de consultá-lo periodicamente. Requer Claude Code v2.1.181 ou posterior |213| `CLAUDE_CLIENT_PRESENCE_FILE` | Caminho para um arquivo que uma ferramenta externa, como um listener de bloqueio de tela, cria quando você desbloqueia a tela e exclui quando você a bloqueia. Enquanto o arquivo existir, o Claude Code omite as [notificações push móveis do Remote Control](/docs/pt/remote-control#mobile-push-notifications), para que você deixe de receber pushes enquanto estiver usando ativamente o computador. Quando o arquivo está ausente ou ilegível, as notificações são enviadas normalmente. O Claude Code verifica o arquivo uma vez por evento que dispara um push, em vez de consultá-lo periodicamente. Requer Claude Code v2.1.181 ou posterior |

214| `CLAUDE_CODE_ACCESSIBILITY` | Defina como `1` para manter o cursor nativo do terminal visível e desativar o indicador de cursor com texto invertido. Permite que ampliadores de tela, como o Zoom do macOS, acompanhem a posição do cursor |214| `CLAUDE_CODE_ACCESSIBILITY` | Defina como `1` para manter o cursor nativo do terminal visível e desativar o indicador de cursor com texto invertido. Permite que ampliadores de tela, como o Zoom do macOS, acompanhem a posição do cursor |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Defina como `1` para carregar arquivos de memória de diretórios especificados com `--add-dir`. Carrega `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Por padrão, diretórios adicionais não carregam arquivos de memória |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Defina como `1` para carregar arquivos de memória de diretórios especificados com `--add-dir`. Carrega `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Por padrão, diretórios adicionais não carregam arquivos de memória |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Defina como `1` para redesenhar a tela inteira a cada quadro na [renderização em tela cheia](/docs/pt/fullscreen) em vez de enviar atualizações incrementais. Use isso se o modo de tela cheia mostrar fragmentos de texto desatualizados ou fora do lugar. O Claude Code ativa isso automaticamente para sessões em segundo plano e para a [visualização de agentes](/docs/pt/agent-view) no Windows |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Defina como `1` para redesenhar a tela inteira a cada quadro na [renderização em tela cheia](/docs/pt/fullscreen) em vez de enviar atualizações incrementais. Use isso se o modo de tela cheia mostrar fragmentos de texto desatualizados ou fora do lugar. O Claude Code ativa isso automaticamente para sessões em segundo plano e para a [visualização de agentes](/docs/pt/agent-view) no Windows |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro de [esforço](/docs/pt/model-config#adjust-effort-level) em toda requisição, mesmo quando o Claude Code não reconhece o ID do modelo como compatível com esforço. Use isso ao rotear por meio de um [gateway de LLM](/docs/pt/llm-gateway) ou provedor terceirizado que serve modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo os modelos Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, continuam excluídos para que as requisições não falhem |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro de [esforço](/docs/pt/model-config#adjust-effort-level) em toda requisição, mesmo quando o Claude Code não reconhece o ID do modelo como compatível com esforço. Use isso ao rotear por meio de um [gateway de LLM](/docs/pt/llm-gateway) ou provedor de terceiros que disponibiliza modelos com identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo os modelos Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, continuam excluídos para que as requisições não falhem |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper)) |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper)) |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Defina como `0` para impedir que o Claude Code abra o navegador automaticamente quando um novo [artefato](/docs/pt/artifacts#create-an-artifact) é publicado |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Defina como `0` para impedir que o Claude Code abra o navegador automaticamente quando um novo [artefato](/docs/pt/artifacts#create-an-artifact) for publicado |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Defina como `0` para impedir que o Claude leia e responda a [comentários em um artefato](/docs/pt/artifacts#collect-comments-on-an-artifact). Não tem efeito quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [desativou os artefatos](/docs/pt/artifacts#availability). Requer Claude Code v2.1.221 ou posterior |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Defina como `0` para impedir que o Claude leia e responda a [comentários em um artefato](/docs/pt/artifacts#collect-comments-on-an-artifact). Não tem efeito quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` tiver [desativado os artefatos](/docs/pt/artifacts#availability). Requer Claude Code v2.1.221 ou posterior |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Defina como `0` para impedir que o Claude [responda por conta própria aos comentários enviados a ele](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own). Requer Claude Code v2.1.228 ou posterior |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Defina como `0` para impedir que o Claude [responda por conta própria aos comentários enviados a ele](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own). Requer Claude Code v2.1.228 ou posterior |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Defina como `0` para omitir o [bloco de atribuição](/docs/pt/llm-gateway-protocol#system-prompt-attribution-block), que contém a versão do cliente e uma impressão digital do prompt, do início do system prompt. O cache em uma conexão direta com a Anthropic API não é afetado em nenhum dos casos. Em algumas configurações de conexão direta, o Claude Code mantém o bloco nas requisições do classificador do [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) mesmo quando você define `0`. Em [Bloco de atribuição do system prompt](/docs/pt/llm-gateway-protocol#system-prompt-attribution-block), verifique quais conexões e credenciais isso abrange. Antes da v2.1.181, o bloco incluía um token por requisição em URLs base personalizadas e em conexões do Microsoft Foundry, então, nessas versões, defina-a como `0` quando seu gateway de LLM fizer cache com base no corpo da requisição ou encaminhar requisições para um provedor terceirizado, ou quando você se conectar diretamente ao Microsoft Foundry |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Defina como `0` para omitir o [bloco de atribuição](/docs/pt/llm-gateway-protocol#system-prompt-attribution-block), que contém a versão do cliente e uma impressão digital do prompt, do início do system prompt. O cache em uma conexão direta com a API da Anthropic não é afetado em nenhum dos casos. Em algumas configurações de conexão direta, o Claude Code mantém o bloco nas requisições do classificador do [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) mesmo quando você define `0`. Em [Bloco de atribuição do system prompt](/docs/pt/llm-gateway-protocol#system-prompt-attribution-block), verifique quais conexões e credenciais isso abrange. Antes da v2.1.181, o bloco incluía um token por requisição em URLs base personalizadas e conexões do Microsoft Foundry; portanto, nessas versões, defina-a como `0` quando seu gateway de LLM fizer cache com base no corpo da requisição ou encaminhar requisições para um provedor de terceiros, ou quando você se conectar diretamente ao Microsoft Foundry |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` está ativada, segundos entre os lembretes ao Claude para verificar [subagentes em segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) que ainda estão em execução. Aceita apenas um inteiro simples de `1` a `86400`; qualquer outro valor ou grafia é lido como não definido. Quando não definida, não há lembretes de verificação. Requer Claude Code v2.1.248 ou posterior |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Removida na v2.1.283. Use `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` em vez disso |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Define a [janela de compactação automática](/docs/pt/model-config#set-the-auto-compact-window) em tokens, de `100000` a `1000000`. Aceita apenas um inteiro simples, como `500000`: um valor como `500k` é lido como `500` e ajustado ao mínimo de 100K. A janela efetiva também é limitada à janela de contexto do modelo. Tem precedência sobre o comando `/autocompact`, a flag `--autocompact` e a configuração `autoCompactWindow`. O `used_percentage` da linha de status sempre mede em relação à janela de contexto completa do modelo, então, depois que esta variável é definida, essa porcentagem não indica mais quando a compactação será executada |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Define a [janela de compactação automática](/docs/pt/model-config#set-the-auto-compact-window) em tokens, de `100000` a `1000000`. Aceita apenas um inteiro simples, como `500000`: um valor como `500k` é lido como `500` e restringido ao mínimo de 100K. A janela efetiva também é limitada à janela de contexto do modelo. Tem precedência sobre o comando `/autocompact`, a flag `--autocompact` e a configuração `autoCompactWindow`. O `used_percentage` da linha de status sempre mede em relação à janela de contexto completa do modelo, então, uma vez que esta variável esteja definida, essa porcentagem não indica mais quando a compactação será executada |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sobrescreve a [conexão automática com a IDE](/docs/pt/vs-code). Por padrão, o Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de uma IDE compatível. Defina como `false` para impedir isso. Defina como `true` para forçar uma tentativa de conexão quando a detecção automática falhar, como quando o tmux oculta o terminal pai. Tem precedência sobre a configuração global [`autoConnectIde`](/docs/pt/settings-reference#autoconnectide) |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sobrescreve a [conexão automática com a IDE](/docs/pt/vs-code). Por padrão, o Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de uma IDE compatível. Defina como `false` para impedir isso. Defina como `true` para forçar uma tentativa de conexão quando a detecção automática falhar, como quando o tmux oculta o terminal pai. Tem precedência sobre a configuração global [`autoConnectIde`](/docs/pt/settings-reference#autoconnectide) |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controla se o Claude Code pede ao servidor para [revisar as ações do modo auto](/docs/pt/permission-modes#server-side-classifier-review). Defina como `0` para usar as próprias requisições de classificador do Claude Code em vez disso. Em uma conexão direta com a Anthropic API, requer v2.1.281 ou posterior. A seção vinculada lista quais sessões consultam o servidor quando a variável não está definida, e a partir de qual versão. Requer Claude Code v2.1.271 ou posterior |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controla se o Claude Code pede ao servidor para [revisar as ações do modo auto](/docs/pt/permission-modes#server-side-classifier-review). Defina como `0` para usar as próprias requisições de classificador do Claude Code em vez disso. Em uma conexão direta com a API da Anthropic, requer v2.1.281 ou posterior. A seção vinculada lista quais sessões consultam o servidor quando a variável não está definida, e a partir de qual versão. Requer Claude Code v2.1.271 ou posterior |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo em milissegundos que o Claude Code espera a cadeia padrão de provedores de credenciais da AWS produzir credenciais antes que a requisição falhe com [`AWS default-chain credential resolve timed out`](/docs/pt/errors#aws-default-chain-credential-resolve-timed-out) (padrão: `60000`). Aumente-o quando uma etapa da sua cadeia legitimamente precisar de mais tempo, como um login SSO baseado em navegador com MFA por meio de um wrapper como `aws-vault`. Aplica-se sempre que o Claude Code assina com a cadeia padrão: [Amazon Bedrock](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) e o [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint). Requer Claude Code v2.1.207 ou posterior |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo em milissegundos que o Claude Code espera para que a cadeia de provedores de credenciais padrão da AWS produza credenciais antes que a requisição falhe com [`AWS default-chain credential resolve timed out`](/docs/pt/errors#aws-default-chain-credential-resolve-timed-out) (padrão: `60000`). Aumente-o quando uma etapa da sua cadeia legitimamente precisar de mais tempo, como um login SSO pelo navegador com MFA por meio de um wrapper como o `aws-vault`. Aplica-se sempre que o Claude Code assina com a cadeia padrão: [Amazon Bedrock](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) e o [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint). Requer Claude Code v2.1.207 ou posterior |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Defina como `0` para desativar o [diff dos arquivos alterados enquanto um comando Bash era executado](/docs/pt/hooks#bash), ou `1` para registrá-lo em todos os modos de permissão. Tem precedência sobre a configuração [`bashEditDiffEnabled`](/docs/pt/settings-reference#basheditdiffenabled). Requer Claude Code v2.1.269 ou posterior |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Defina como `0` para desativar o [diff dos arquivos que mudaram enquanto um comando Bash era executado](/docs/pt/hooks#bash), ou `1` para registrá-lo em todos os modos de permissão. Tem precedência sobre a configuração [`bashEditDiffEnabled`](/docs/pt/settings-reference#basheditdiffenabled). Requer Claude Code v2.1.269 ou posterior |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Defina como `0` para fazer uma sessão não interativa informar um status ocioso ao seu host ao final de cada turno, mesmo enquanto ainda há trabalho em segundo plano em execução. Por padrão, a sessão continua informando um status de execução após o fim do turno enquanto trabalho em segundo plano, como um agente em segundo plano ou uma execução de [workflow](/docs/pt/workflows), ainda está ativo. Isso evita que um host que monitora o status, como uma lista de sessões remotas, anuncie que o Claude está aguardando sua entrada no meio do trabalho. Comandos de shell em segundo plano, como um servidor de desenvolvimento, não mantêm o status de execução. O padrão de status de execução e a opção de desativação com `0` exigem Claude Code v2.1.269 ou posterior; em versões anteriores, defina `1` para manter o status de execução |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Defina como `0` para fazer uma sessão não interativa relatar um status ocioso ao seu host ao fim de cada turno, mesmo enquanto o trabalho em segundo plano ainda estiver em execução. Por padrão, a sessão continua relatando um status de execução após o fim do turno enquanto um trabalho em segundo plano, como um agente em segundo plano ou uma execução de [workflow](/docs/pt/workflows), ainda estiver ativo. Isso impede que um host que monitora o status, como uma lista de sessões remotas, anuncie que o Claude está aguardando sua entrada no meio do trabalho. Comandos de shell em segundo plano, como um servidor de desenvolvimento, não mantêm o status de execução. O padrão de status de execução e a opção de desativação com `0` requerem Claude Code v2.1.269 ou posterior; em versões anteriores, defina `1` para manter o status de execução |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Definida automaticamente nos subprocessos da ferramenta Bash e de [comandos de hook](/docs/pt/hooks) enquanto a sessão tem uma conexão ativa do [Remote Control](/docs/pt/remote-control), e removida quando a conexão termina. O valor é o ID da sessão no formato `session_`, o mesmo identificador que aparece na URL `claude.ai/code` da sessão, para que um script possa criar um link de volta para a sessão que o executou. Requer Claude Code v2.1.199 ou posterior. Em [sessões na nuvem](/docs/pt/claude-code-on-the-web), leia `CLAUDE_CODE_REMOTE_SESSION_ID` em vez disso |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Definida automaticamente em subprocessos da ferramenta Bash e de [comandos de hook](/docs/pt/hooks) enquanto a sessão tem uma conexão ativa de [Remote Control](/docs/pt/remote-control), e removida quando a conexão termina. O valor é o ID da sessão no formato `session_`, o mesmo identificador que aparece na URL `claude.ai/code` da sessão, para que um script possa criar um link de volta para a sessão que o executou. Requer Claude Code v2.1.199 ou posterior. Em [sessões na nuvem](/docs/pt/claude-code-on-the-web), leia `CLAUDE_CODE_REMOTE_SESSION_ID` em vez disso |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Defina como `0` para fazer o Claude Code ler o byte `0x08`, também escrito `^H`, como Backspace simples, ou `1` para lê-lo como Ctrl+Backspace. Qualquer um dos valores substitui o padrão da plataforma. Por padrão, o Claude Code o lê como Ctrl+Backspace no Windows, exceto quando `TERM_PROGRAM` é `mintty` ou `TERM` é `cygwin`, e como Backspace simples no macOS e no Linux. Defina `0` em um terminal do Windows em que [o Backspace exclui uma palavra inteira](/docs/pt/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Defina como `0` para fazer o Claude Code ler o byte `0x08`, também escrito `^H`, como Backspace simples, ou `1` para lê-lo como Ctrl+Backspace. Qualquer um dos valores substitui o padrão da plataforma. Por padrão, o Claude Code o lê como Ctrl+Backspace no Windows, exceto quando `TERM_PROGRAM` é `mintty` ou `TERM` é `cygwin`, e como Backspace simples no macOS e no Linux. Defina `0` em um terminal Windows em que o [Backspace exclui uma palavra inteira](/docs/pt/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

232| `CLAUDE_CODE_CERT_STORE` | Lista separada por vírgulas de fontes de certificados de CA para conexões TLS. `bundled` é o conjunto de CAs da Mozilla distribuído com o Claude Code. `system` é o repositório de confiança do sistema operacional, lido apenas em runtimes com `tls.getCACertificates`: o binário nativo, ou Node 22.15 ou posterior para instalações via npm. Consulte [Repositório de certificados de CA](/docs/pt/network-config#ca-certificate-store). O padrão é `bundled,system` |232| `CLAUDE_CODE_CERT_STORE` | Lista separada por vírgulas de fontes de certificados de CA para conexões TLS. `bundled` é o conjunto de CAs da Mozilla distribuído com o Claude Code. `system` é o repositório de confiança do sistema operacional, lido apenas em runtimes com `tls.getCACertificates`: o binário nativo, ou Node 22.15 ou posterior para instalações via npm. Consulte [Repositório de certificados de CA](/docs/pt/network-config#ca-certificate-store). O padrão é `bundled,system` |

233| `CLAUDE_CODE_CHILD_SESSION` | Definida como `1` em subprocessos que o Claude Code inicia por meio das ferramentas Bash, PowerShell e Monitor, em comandos de [hook](/docs/pt/hooks) e em comandos de [linha de status](/docs/pt/statusline). Não é definida para subprocessos de [servidor MCP](/docs/pt/mcp) stdio, que são de longa duração e sobrevivem à sessão que os iniciou. Diferentemente de `CLAUDECODE`, esta só é definida pelo próprio Claude Code quando ele inicia um subprocesso, e não por extensões de IDE, então ela distingue de forma confiável uma sessão aninhada de um `claude` de nível superior iniciado em um terminal integrado à IDE. Uma TUI interativa `claude` aninhada iniciada dessa forma é automaticamente excluída de `--resume`, `--continue`, do histórico da seta para cima e da lista `claude agents`. Sessões não interativas `claude -p` continuam sendo persistidas. Defina `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` para sobrescrever essa exclusão. Requer Claude Code v2.1.172 ou posterior |233| `CLAUDE_CODE_CHILD_SESSION` | Definida como `1` em subprocessos que o Claude Code inicia por meio das ferramentas Bash, PowerShell e Monitor, comandos de [hook](/docs/pt/hooks) e comandos de [linha de status](/docs/pt/statusline). Não é definida para subprocessos de [servidor MCP](/docs/pt/mcp) stdio, que são de longa duração e sobrevivem à sessão que os iniciou. Diferentemente de `CLAUDECODE`, esta é definida apenas pelo próprio Claude Code quando ele inicia um subprocesso, e não pelas extensões de IDE, então distingue de forma confiável uma sessão aninhada de um `claude` de nível superior iniciado em um terminal integrado da IDE. Uma TUI `claude` interativa aninhada iniciada dessa forma é automaticamente excluída de `--resume`, `--continue`, do histórico da seta para cima e da lista `claude agents`. Sessões não interativas `claude -p` ainda são persistidas. Defina `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` para sobrescrever essa exclusão. Requer Claude Code v2.1.172 ou posterior |

234| `CLAUDE_CODE_CLIENT_CERT` | Caminho para o arquivo de certificado do cliente para autenticação mTLS |234| `CLAUDE_CODE_CLIENT_CERT` | Caminho para o arquivo de certificado do cliente para autenticação mTLS |

235| `CLAUDE_CODE_CLIENT_KEY` | Caminho para o arquivo de chave privada do cliente para autenticação mTLS |235| `CLAUDE_CODE_CLIENT_KEY` | Caminho para o arquivo de chave privada do cliente para autenticação mTLS |

236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Frase secreta para a CLAUDE\_CODE\_CLIENT\_KEY criptografada (opcional) |236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Frase secreta para a CLAUDE\_CODE\_CLIENT\_KEY criptografada (opcional) |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Removida na v2.1.186 e agora sem efeito. Anteriormente definia um timeout separado para a fase de conexão, TLS e cabeçalhos de resposta de uma requisição de streaming à API. Use `API_TIMEOUT_MS` para o timeout por requisição. Para a fase de cabeçalhos de resposta de uma requisição de streaming, consulte `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Removida na v2.1.186 e agora não tem efeito. Anteriormente, definia um timeout separado para a fase de conexão, TLS e cabeçalhos de resposta de uma requisição de API por streaming. Use `API_TIMEOUT_MS` para o timeout por requisição. Para a fase de cabeçalhos de resposta de uma requisição por streaming, consulte `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sobrescreve o caminho do arquivo de log de depuração. Apesar do nome, este é um caminho de arquivo, não um diretório. Requer que o modo de depuração seja ativado separadamente via `--debug`, `/debug` ou a variável de ambiente `DEBUG`: definir apenas esta variável não ativa o log. A flag [`--debug-file`](/docs/pt/cli-reference#cli-flags) faz as duas coisas de uma vez. O padrão é `~/.claude/debug/<session-id>.txt` |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sobrescreve o caminho do arquivo de log de depuração. Apesar do nome, este é um caminho de arquivo, não um diretório. Requer que o modo de depuração seja ativado separadamente via `--debug`, `/debug` ou a variável de ambiente `DEBUG`: definir apenas esta variável não ativa o registro em log. A flag [`--debug-file`](/docs/pt/cli-reference#cli-flags) faz as duas coisas ao mesmo tempo. O padrão é `~/.claude/debug/<session-id>.txt` |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Nível mínimo de log gravado no arquivo de log de depuração. Valores: `verbose`, `debug` (padrão), `info`, `warn`, `error`. Defina como `verbose` para incluir diagnósticos de alto volume, como a saída completa do comando da linha de status, ou aumente para `error` para reduzir o ruído |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Nível mínimo de log gravado no arquivo de log de depuração. Valores: `verbose`, `debug` (padrão), `info`, `warn`, `error`. Defina como `verbose` para incluir diagnósticos de alto volume, como a saída completa do comando da linha de status, ou aumente para `error` para reduzir o ruído |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Defina como `1` para desativar o suporte à [janela de contexto de 1M](/docs/pt/model-config#extended-context). Quando definida, as variantes de modelo de 1M ficam indisponíveis no seletor de modelos, e o Claude Code limita as sessões em modelos com uma janela nativa de 1M, como o [Sonnet 5.5](/docs/pt/model-config#sonnet-5-5-and-sonnet-5-context-window) e os modelos Fable, a uma janela de 200K; consulte [Contexto estendido](/docs/pt/model-config#extended-context) para saber como essa limitação é aplicada. Útil para ambientes corporativos com requisitos de conformidade. Para sua função na correção da janela para um ID de modelo `[1m]` não reconhecido, consulte [Corrigir a janela para um gateway ou ID de modelo personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Defina como `1` para desativar o suporte à [janela de contexto de 1M](/docs/pt/model-config#extended-context). Quando definida, as variantes de modelo de 1M ficam indisponíveis no seletor de modelos, e o Claude Code restringe sessões em modelos com uma janela nativa de 1M, como o [Sonnet 5.5](/docs/pt/model-config#sonnet-5-5-and-sonnet-5-context-window) e os modelos Fable, a uma janela de 200K; consulte [Contexto estendido](/docs/pt/model-config#extended-context) para ver como essa restrição é aplicada. Útil para ambientes corporativos com requisitos de conformidade. Para seu papel na correção da janela para um ID de modelo `[1m]` não reconhecido, consulte [Corrigir a janela para um ID de modelo de gateway ou personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Defina como `1` para desativar o [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level) no Opus 4.6 e no Sonnet 4.6 e recorrer ao orçamento fixo de pensamento controlado por `MAX_THINKING_TOKENS`. Não tem efeito nos [modelos Fable](/docs/pt/model-config#extended-thinking), no Sonnet 5 e posteriores, ou no Opus 4.7 e posteriores, que sempre usam raciocínio adaptativo |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Defina como `1` para desativar o [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level) no Opus 4.6 e no Sonnet 4.6 e recorrer ao orçamento fixo de pensamento controlado por `MAX_THINKING_TOKENS`. Não tem efeito nos [modelos Fable](/docs/pt/model-config#extended-thinking), no Sonnet 5 e posteriores, ou no Opus 4.7 e posteriores, que sempre usam raciocínio adaptativo |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Defina como `1` para impedir que o Claude Code mescle por chave os blocos `env` das [configurações gerenciadas](/docs/pt/managed-settings#precedence-within-the-managed-tier) entre as fontes de administrador, de modo que apenas o bloco `env` inteiro da fonte de maior prioridade se aplique, como antes da v2.1.223. 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.223 ou posterior |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Defina como `1` para impedir que o Claude Code mescle os blocos `env` das [configurações gerenciadas](/docs/pt/managed-settings#precedence-within-the-managed-tier) por chave entre as fontes de administrador, de modo que apenas o bloco `env` inteiro da fonte de maior prioridade se aplique, como antes da v2.1.223. Defina-a no ambiente que inicia o Claude Code, pois o Claude Code ignora uma cópia entregue por meio de um bloco `env` de configurações. Requer Claude Code v2.1.223 ou posterior |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Defina como `1` para desativar a [ferramenta advisor](/docs/pt/advisor). O comando `/advisor` fica indisponível, qualquer `advisorModel` configurado é ignorado e a flag `--advisor` é aceita, mas não tem efeito, então scripts existentes que a passam continuam funcionando sem erros |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Defina como `1` para desativar a [ferramenta advisor](/docs/pt/advisor). O comando `/advisor` fica indisponível, qualquer `advisorModel` configurado é ignorado, e a flag `--advisor` é aceita, mas não tem efeito, para que scripts existentes que a passam continuem funcionando sem erros |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Defina como `1` para desativar os [agentes em segundo plano e a visualização de agentes](/docs/pt/agent-view): `claude agents`, `--bg`, `/background` e o supervisor sob demanda. Equivalente à configuração [`disableAgentView`](/docs/pt/settings-reference#disableagentview) |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Defina como `1` para desativar os [agentes em segundo plano e a visualização de agentes](/docs/pt/agent-view): `claude agents`, `--bg`, `/background` e o supervisor sob demanda. Equivalente à configuração [`disableAgentView`](/docs/pt/settings-reference#disableagentview) |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desativar a [renderização em tela cheia](/docs/pt/fullscreen) e usar o renderizador clássico da tela principal. A conversa permanece no scrollback nativo do seu terminal, para que `Cmd+f` e o modo de cópia do tmux funcionem normalmente. Tem precedência sobre `CLAUDE_CODE_NO_FLICKER` e a configuração [`tui`](/docs/pt/settings-reference#tui). Você também pode alternar com `/tui default`. Não se aplica a sessões em segundo plano abertas a partir da [visualização de agentes](/docs/pt/agent-view), que sempre usam renderização em tela cheia |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desativar a [renderização em tela cheia](/docs/pt/fullscreen) e usar o renderizador clássico da tela principal. A conversa permanece no histórico de rolagem nativo do seu terminal, para que `Cmd+f` e o modo de cópia do tmux funcionem normalmente. Tem precedência sobre `CLAUDE_CODE_NO_FLICKER` e a configuração [`tui`](/docs/pt/settings-reference#tui). Você também pode alternar com `/tui default`. Não se aplica a sessões em segundo plano abertas a partir da [visualização de agentes](/docs/pt/agent-view), que sempre usam renderização em tela cheia |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Defina como `1` para desativar a ferramenta [Artifact](/docs/pt/artifacts), que publica a saída da sessão como uma página web privada no claude.ai. Depois de defini-la, nenhum arquivo de configurações reativa a ferramenta. Para desativar a ferramenta a partir de um arquivo de configurações, defina [`enableArtifact`](/docs/pt/settings-reference#enableartifact) como `false`; a chave descontinuada [`disableArtifact`](/docs/pt/settings-reference#disableartifact) também a desativa |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Defina como `1` para desativar a ferramenta [Artifact](/docs/pt/artifacts), que publica a saída da sessão como uma página web privada no claude.ai. Depois que você a define, nenhum arquivo de configuração reativa a ferramenta. Para desativar a ferramenta a partir de um arquivo de configuração, defina [`enableArtifact`](/docs/pt/settings-reference#enableartifact) como `false`; a chave descontinuada [`disableArtifact`](/docs/pt/settings-reference#disableartifact) também a desativa |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Defina como `1` para desativar o processamento de anexos. Menções a arquivos com a sintaxe `@` são enviadas como texto simples em vez de serem expandidas para o conteúdo do arquivo |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Defina como `1` para desativar o processamento de anexos. Menções de arquivos com a sintaxe `@` são enviadas como texto simples em vez de serem expandidas para o conteúdo do arquivo |

248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Defina como `1` para fazer um processo do Claude Code executar ele mesmo seu comando [`gcpAuthRefresh`](/docs/pt/settings-reference#gcpauthrefresh) ou [`awsAuthRefresh`](/docs/pt/settings-reference#awsauthrefresh) em vez de esperar enquanto outro processo o executa. Requer Claude Code v2.1.286 ou posterior |248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Defina como `1` para fazer um processo do Claude Code executar ele mesmo seu comando [`gcpAuthRefresh`](/docs/pt/settings-reference#gcpauthrefresh) ou [`awsAuthRefresh`](/docs/pt/settings-reference#awsauthrefresh) em vez de esperar enquanto outro processo o executa. Requer Claude Code v2.1.286 ou posterior |

249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Defina como `1` para desativar a [memória automática](/docs/pt/memory#auto-memory). Defina como `0` para forçar a ativação da memória automática mesmo quando o modo `--bare` ou [`autoMemoryEnabled: false`](/docs/pt/settings-reference#automemoryenabled) a desativaria. Quando desativada, o Claude não cria nem carrega arquivos de memória automática |249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Defina como `1` para desativar a [memória automática](/docs/pt/memory#auto-memory). Defina como `0` para forçar a ativação da memória automática mesmo quando o modo `--bare` ou [`autoMemoryEnabled: false`](/docs/pt/settings-reference#automemoryenabled) a desativaria. Quando desativada, o Claude não cria nem carrega arquivos de memória automática |

250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para desativar toda a funcionalidade de tarefas em segundo plano, incluindo o parâmetro `run_in_background` nas ferramentas Bash e de subagente, o envio automático para segundo plano e o atalho Ctrl+B |250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para desativar toda a funcionalidade de tarefas em segundo plano, incluindo o parâmetro `run_in_background` nas ferramentas Bash e de subagente, o envio automático para segundo plano e o atalho Ctrl+B |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Defina como `1` para impedir que o Claude Code trate uma resposta de streaming do [Amazon Bedrock](/docs/pt/amazon-bedrock) com um cabeçalho `Content-Type` ausente ou vazio como o stream de eventos binário do Amazon Bedrock. Por padrão, o Claude Code presume que um gateway removeu o cabeçalho de uma resposta que, fora isso, não foi modificada, então decodifica o corpo e o streaming continua funcionando. Defina esta variável apenas para um gateway que também reemite o stream como server-sent events; o Claude Code então lê o corpo sem cabeçalho como server-sent events. Requer Claude Code v2.1.239 ou posterior |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Defina como `1` para impedir que o Claude Code trate uma resposta por streaming do [Amazon Bedrock](/docs/pt/amazon-bedrock) com um cabeçalho `Content-Type` ausente ou vazio como o stream de eventos binário do Amazon Bedrock. Por padrão, o Claude Code presume que um gateway removeu o cabeçalho de uma resposta que, de outra forma, não foi modificada, então decodifica o corpo e o streaming continua funcionando. Defina-a apenas para um gateway que também reemite o stream como server-sent events; o Claude Code então lê o corpo sem cabeçalho como server-sent events. Requer Claude Code v2.1.239 ou posterior |

252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Defina como `1` para pular a verificação de que uma resposta de streaming do [Amazon Bedrock](/docs/pt/amazon-bedrock) carrega o content-type `application/vnd.amazon.eventstream`. Sem esta variável, quando uma resposta carrega um content-type diferente, o Claude Code falha a requisição com um erro que nomeia esse tipo, o que significa que um [gateway ou proxy está transformando a resposta](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configure o gateway para encaminhar o cabeçalho `Content-Type` e o corpo sem modificações em vez de definir esta variável. Requer Claude Code v2.1.208 ou posterior |252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Defina como `1` para pular a verificação de que uma resposta por streaming do [Amazon Bedrock](/docs/pt/amazon-bedrock) contém o content-type `application/vnd.amazon.eventstream`. Sem esta variável, quando uma resposta contém um content-type diferente, o Claude Code faz a requisição falhar com um erro que nomeia esse tipo, o que significa que um [gateway ou proxy está transformando a resposta](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configure o gateway para encaminhar o cabeçalho `Content-Type` e o corpo sem modificações em vez de definir esta variável. Requer Claude Code v2.1.208 ou posterior |

253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Defina como `1` para interromper os comandos de shell em segundo plano em execução de uma [sessão em segundo plano](/docs/pt/agent-view), os workflows dinâmicos e, a partir da v2.1.198, os subagentes em segundo plano quando o [supervisor](/docs/pt/agent-view#the-supervisor-process) parar, reiniciar ou atualizar o processo dessa sessão, em vez de entregá-los ao próximo processo da sessão. Afeta apenas essa transferência: enviar uma sessão para segundo plano com `←` ou [`/background`](/docs/pt/agent-view#from-inside-a-session) ainda transfere o trabalho em andamento, e `CLAUDE_DISABLE_ADOPT` desativa ambos. Requer Claude Code v2.1.196 ou posterior |253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Defina como `1` para interromper os comandos de shell em segundo plano em execução, os workflows dinâmicos e, a partir da v2.1.198, os subagentes em segundo plano de uma [sessão em segundo plano](/docs/pt/agent-view) quando o [supervisor](/docs/pt/agent-view#the-supervisor-process) para, reinicia ou atualiza o processo dessa sessão, em vez de transferi-los para o próximo processo da sessão. Afeta apenas essa transferência: enviar uma sessão para segundo plano com `←` ou [`/background`](/docs/pt/agent-view#from-inside-a-session) ainda transfere o trabalho em andamento, e `CLAUDE_DISABLE_ADOPT` desativa ambos. Requer Claude Code v2.1.196 ou posterior |

254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Defina como `1` para impedir que o Claude Code encerre [comandos de shell em segundo plano](/docs/pt/interactive-mode#background-bash-commands) sob pressão de memória do sistema. Por padrão, no macOS e no Linux, o Claude Code encerra shells em segundo plano quando o sistema operacional informa pressão crítica de memória do sistema e a sessão está ociosa há 30 minutos sem nenhum turno ou subagente em execução. O Windows não tem sinal de pressão de memória do sistema, então esta variável não tem efeito lá. Requer Claude Code v2.1.193 ou posterior |254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Defina como `1` para impedir que o Claude Code encerre [comandos de shell em segundo plano](/docs/pt/interactive-mode#background-bash-commands) sob pressão de memória. Por padrão, no macOS e no Linux, o Claude Code encerra shells em segundo plano quando o sistema operacional relata pressão crítica de memória RAM e a sessão está ociosa há 30 minutos, sem nenhum turno ou subagente em execução. O Windows não tem sinal de pressão de memória, então esta variável não tem efeito lá. Requer Claude Code v2.1.193 ou posterior |

255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Defina como `1` para desativar as [skills](/docs/pt/skills) e os workflows incluídos no 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. `/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`](/docs/pt/settings-reference#disablebundledskills) |255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Defina como `1` para desativar as [skills](/docs/pt/skills) e os workflows incluídos no Claude Code: skills incluídas e workflows são removidos completamente, enquanto comandos integrados como `/init` continuam podendo ser digitados, mas ficam ocultos para o modelo. `/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`](/docs/pt/settings-reference#disablebundledskills) |

256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Defina como `1` para manter as ferramentas de navegador do [Claude in Chrome](/docs/pt/chrome) disponíveis enquanto omite a seção do Chrome do system prompt e a [skill incluída](/docs/pt/skills#bundled-skills) `/claude-in-chrome`. Para hosts que incorporam o Claude Code e fornecem suas próprias orientações de navegador. Requer Claude Code v2.1.257 ou posterior |256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Defina como `1` para manter disponíveis as ferramentas de navegador do [Claude in Chrome](/docs/pt/chrome), omitindo a seção do Chrome do system prompt e a [skill incluída](/docs/pt/skills#bundled-skills) `/claude-in-chrome`. Para hosts que incorporam o Claude Code e fornecem suas próprias orientações de navegador. Requer Claude Code v2.1.257 ou posterior |

257| `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 |257| `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 |

258| `CLAUDE_CODE_DISABLE_CRON` | Defina como `1` para desativar as [tarefas agendadas](/docs/pt/scheduled-tasks). A skill `/loop` e as ferramentas de cron ficam indisponíveis e quaisquer tarefas já agendadas deixam de ser disparadas, incluindo tarefas que já estão em execução no meio da sessão |258| `CLAUDE_CODE_DISABLE_CRON` | Defina como `1` para desativar as [tarefas agendadas](/docs/pt/scheduled-tasks). A skill `/loop` e as ferramentas de cron ficam indisponíveis, e quaisquer tarefas já agendadas deixam de ser disparadas, incluindo tarefas que já estão em execução no meio da sessão |

259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Defina como `1` para desativar o limite de tempo nos prompts de [remoção de caminhos críticos](/docs/pt/permission-modes#critical-paths). No modo `auto`, o Claude Code então envia essas remoções ao classificador, e no modo `bypassPermissions` o prompt aguarda sua resposta. 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 |259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Defina como `1` para desativar o limite de tempo nos prompts de [remoção de caminhos críticos](/docs/pt/permission-modes#critical-paths). No modo `auto`, o Claude Code então envia essas remoções para o classificador, e no modo `bypassPermissions` o prompt aguarda sua resposta. Defina-a no ambiente que inicia o Claude Code, pois 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 |

260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Defina como `1` para remover das requisições à 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 esquema 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](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) lista o que a variável remove, incluindo o [MCP Tool Search](/docs/pt/mcp#scale-with-mcp-tool-search), e o que o Claude Code continua enviando |260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Defina como `1` para remover das requisições de API os cabeçalhos de requisição `anthropic-beta` de pré-lançamento, os campos de corpo que os acompanham e campos beta de esquema 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](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) lista o que a variável remove, incluindo o [MCP Tool Search](/docs/pt/mcp#scale-with-mcp-tool-search), e o que o Claude Code continua enviando |

261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Defina como `1` para desativar os [subagentes Explore e Plan](/docs/pt/sub-agents#built-in-subagents) integrados. O Claude explora com suas ferramentas de busca ou com o subagente de uso geral, e o [modo de planejamento](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) lê os arquivos diretamente em vez de iniciar os 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 |261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Defina como `1` para desativar os [subagentes integrados Explore e Plan](/docs/pt/sub-agents#built-in-subagents). O Claude explora com suas ferramentas de pesquisa ou com o subagente de propósito geral, e o [modo de planejamento](/docs/pt/permission-modes#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 subagentes 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 |

262| `CLAUDE_CODE_DISABLE_FAST_MODE` | Defina como `1` para desativar o [modo rápido](/docs/pt/fast-mode) |262| `CLAUDE_CODE_DISABLE_FAST_MODE` | Defina como `1` para desativar o [modo rápido](/docs/pt/fast-mode) |

263| `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 por completo, use a configuração [`feedbackSurveyRate`](/docs/pt/settings-reference#feedbacksurveyrate). Consulte [Pesquisas de qualidade de sessão](/docs/pt/data-usage#session-quality-surveys) |263| `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 ficam 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 por completo, use a configuração [`feedbackSurveyRate`](/docs/pt/settings-reference#feedbacksurveyrate). Consulte [Pesquisas de qualidade de sessão](/docs/pt/data-usage#session-quality-surveys) |

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

265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Defina como `1` para remover do contexto do Claude as instruções integradas de fluxo de trabalho de commit e PR e o snapshot do status do git. Útil ao usar suas próprias skills de fluxo de trabalho do git. Tem precedência sobre a configuração [`includeGitInstructions`](/docs/pt/settings-reference#includegitinstructions) quando definida |265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Defina como `1` para remover do contexto do Claude as instruções integradas de fluxo de trabalho de commit e PR e o snapshot do git status. Útil ao usar suas próprias skills de fluxo de trabalho do git. Tem precedência sobre a configuração [`includeGitInstructions`](/docs/pt/settings-reference#includegitinstructions) quando definida |

266| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Defina como `1` para impedir o remapeamento automático do Opus 4.0 e 4.1 para a versão atual do Opus na Anthropic API. Use quando quiser intencionalmente fixar um modelo mais antigo. O remapeamento não é executado no Amazon Bedrock, no Google Cloud's Agent Platform nem no Microsoft Foundry |266| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | Defina como `1` para impedir que o Claude Code leia scripts passados a um shell com `-c`, como `bash -c 'rm -rf ~'`, em busca de remoções de [caminhos críticos](/docs/pt/permission-modes#removals-inside-nested-commands-and-inline-scripts). O Claude Code ainda verifica os destinos de variáveis de shell e parâmetros posicionais nesses scripts, e as outras verificações de caminhos críticos continuam em execução. Defina-a no ambiente que inicia o Claude Code, pois o Claude Code ignora uma cópia entregue por meio de um bloco `env` de configurações. Requer Claude Code v2.1.288 ou posterior |

267| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Defina como `1` para impedir que o Claude Code no [Amazon Bedrock](/docs/pt/amazon-bedrock#when-a-model-is-disabled-mid-session) e no [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai#when-a-model-is-disabled-mid-session) mude para um modelo mais antigo quando sua conta perde o acesso ao modelo de uma sessão no meio da sessão; em vez disso, a requisição recusada falha imediatamente. Uma [cadeia de modelos de fallback](/docs/pt/model-config#fallback-model-chains) que você configurar ainda muda diante dessa recusa, e as [verificações de modelo na inicialização](/docs/pt/amazon-bedrock#startup-model-checks) ainda recorrem a um fallback na inicialização. Requer Claude Code v2.1.285 ou posterior |267| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Defina como `1` para impedir o remapeamento automático do Opus 4.0 e 4.1 para a versão atual do Opus na API da Anthropic. Use quando você quiser intencionalmente fixar um modelo mais antigo. O remapeamento não é executado no Amazon Bedrock, no Google Cloud's Agent Platform ou no Microsoft Foundry |

268| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Defina como `1` para impedir que o Claude Code, no [Amazon Bedrock](/docs/pt/amazon-bedrock#when-a-model-is-disabled-mid-session) e no [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai#when-a-model-is-disabled-mid-session), mude para um modelo mais antigo quando sua conta perde o acesso ao modelo de uma sessão no meio da sessão; a requisição recusada falha imediatamente em vez disso. Uma [cadeia de modelos de fallback](/docs/pt/model-config#fallback-model-chains) que você configurar ainda muda de modelo diante dessa recusa, e as [verificações de modelo na inicialização](/docs/pt/amazon-bedrock#startup-model-checks) ainda recorrem ao fallback na inicialização. Requer Claude Code v2.1.285 ou posterior |

268| `CLAUDE_CODE_DISABLE_MOUSE` | Defina como `1` para desativar o rastreamento do mouse na [renderização em tela cheia](/docs/pt/fullscreen). A rolagem pelo teclado com `PgUp` e `PgDn` continua funcionando. Use isso para manter o comportamento nativo de copiar ao selecionar do seu terminal |269| `CLAUDE_CODE_DISABLE_MOUSE` | Defina como `1` para desativar o rastreamento do mouse na [renderização em tela cheia](/docs/pt/fullscreen). A rolagem pelo teclado com `PgUp` e `PgDn` continua funcionando. Use isso para manter o comportamento nativo de copiar ao selecionar do seu terminal |

269| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Defina como `1` para desativar o tratamento de cliques, arrastar e passar o mouse na [renderização em tela cheia](/docs/pt/fullscreen), mantendo a rolagem pela roda do mouse. Use isso quando quiser que a rolagem pela roda funcione dentro do Claude Code, mas não quiser que os cliques posicionem o cursor, expandam a saída de ferramentas ou abram links. `CLAUDE_CODE_DISABLE_MOUSE` tem precedência quando ambas estão definidas. Requer Claude Code v2.1.195 ou posterior |270| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Defina como `1` para desativar o tratamento de cliques, arrastos e passagem do mouse na [renderização em tela cheia](/docs/pt/fullscreen), mantendo a rolagem com a roda do mouse. Use isso quando quiser que a rolagem com a roda funcione dentro do Claude Code, mas não quiser que cliques posicionem o cursor, expandam a saída de ferramentas ou abram links. `CLAUDE_CODE_DISABLE_MOUSE` tem precedência quando ambas estão definidas. Requer Claude Code v2.1.195 ou posterior |

270| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Defina como `1` para impedir que o Claude Code leia novamente o [certificado e a chave do cliente mTLS](/docs/pt/network-config#mtls-authentication) quando uma requisição à API falha com um erro em nível de conexão, como uma redefinição de conexão ou um erro de handshake TLS. Com o recarregamento desativado, o Claude Code carrega arquivos rotacionados apenas na próxima vez que aplicar as configurações ou na próxima inicialização. Requer Claude Code v2.1.232 ou posterior |271| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Defina como `1` para impedir que o Claude Code releia o [certificado e a chave de cliente mTLS](/docs/pt/network-config#mtls-authentication) quando uma requisição de API falha com um erro em nível de conexão, como uma redefinição de conexão ou um erro de handshake TLS. Com o recarregamento desativado, o Claude Code carrega arquivos rotacionados apenas na próxima vez que aplicar as configurações ou na próxima inicialização. Requer Claude Code v2.1.232 ou posterior |

271| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Defina com qualquer valor não vazio, como `1`, para desativar o tráfego de rede não essencial: atualizações automáticas, telemetria, relatórios de erros, o comando `/feedback`, o [feedback redigido pelo Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior), notas de versão, as verificações do [selo de status de PR e MR](/docs/pt/interactive-mode#pr-review-status) e verificações de disponibilidade, como a verificação do [modo rápido](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Também interrompe as [execuções em segundo plano das fontes `command` de plugins](/docs/pt/plugins/loading#when-a-command-source-re-runs), que são comandos locais e não tráfego de rede, porque elas podem acionar instalações de dependências. **Defini-la como `0` ou `false` ainda desativa esse tráfego**, diferentemente da maioria das variáveis de ativar/desativar; remova a definição da variável para permiti-lo novamente. Também desativa a busca de feature flags, o que torna indisponíveis o [Remote Control](/docs/pt/remote-control#requirements) e os outros [recursos que precisam da busca de feature flags](#features-that-need-feature-flag-fetching). A instalação automática do marketplace oficial de plugins não é coberta; desative-a com `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Não afeta a [descoberta de modelos do gateway](/docs/pt/llm-gateway-connect#add-gateway-models-to-the-model-picker), que tem sua própria opção de ativação |272| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Defina com qualquer valor não vazio, como `1`, para desativar o tráfego de rede não essencial: atualizações automáticas, telemetria, relatórios de erros, o comando `/feedback`, o [feedback redigido pelo Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior), notas de versão, as verificações do [selo de status de PR e MR](/docs/pt/interactive-mode#pr-review-status) e verificações de disponibilidade, como a verificação do [modo rápido](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Também interrompe as [execuções em segundo plano de fontes `command` de plugins](/docs/pt/plugins/loading#when-a-command-source-re-runs), que são comandos locais e não tráfego de rede, porque elas podem disparar instalações de dependências. **Defini-la como `0` ou `false` ainda desativa esse tráfego**, diferentemente da maioria das variáveis de ativar/desativar; remova a definição da variável para permiti-lo novamente. Também desativa a busca de feature flags, o que torna o [Remote Control](/docs/pt/remote-control#requirements) e os outros [recursos que precisam da busca de feature flags](#features-that-need-feature-flag-fetching) indisponíveis. A instalação automática do marketplace oficial de plugins não é abrangida; desative-a com `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Não afeta a [descoberta de modelos do gateway](/docs/pt/llm-gateway-connect#add-gateway-models-to-the-model-picker), que tem sua própria ativação opcional |

272| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Defina como `1` para desativar o fallback sem streaming quando uma requisição de streaming falha no meio do stream. Os erros de streaming são propagados para a camada de novas tentativas em vez disso. Útil quando um proxy ou gateway faz com que o fallback produza execução duplicada de ferramentas |273| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Defina como `1` para desativar o fallback sem streaming quando uma requisição por streaming falha no meio do stream. Os erros de streaming são propagados para a camada de retry em vez disso. Útil quando um proxy ou gateway faz com que o fallback produza execução duplicada de ferramentas |

273| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Defina como `1` para enviar a notificação de desktop da ferramenta `PushNotification` mesmo enquanto você está digitando no terminal ou com ele em foco. Por padrão, a ferramenta omite tanto a notificação de desktop quanto o [push móvel](/docs/pt/remote-control#mobile-push-notifications) quando detecta atividade recente do teclado ou foco no terminal. Esta variável desativa apenas essa verificação local, então o servidor ainda pode suprimir o push móvel quando detecta que você está ativo. Requer Claude Code v2.1.193 ou posterior |274| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Defina como `1` para enviar a notificação de desktop da ferramenta `PushNotification` mesmo enquanto você estiver digitando no terminal ou com ele em foco. Por padrão, a ferramenta omite tanto a notificação de desktop quanto o [push móvel](/docs/pt/remote-control#mobile-push-notifications) quando detecta atividade recente do teclado ou foco no terminal. Esta variável desativa apenas essa verificação local, então o servidor ainda pode suprimir o push móvel quando detectar que você está ativo. Requer Claude Code v2.1.193 ou posterior |

274| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Defina como `1` para desativar o registro automático do marketplace oficial de plugins. O Claude Code lê a variável quando está prestes a registrar o marketplace, geralmente durante a primeira inicialização interativa de uma máquina. Se a variável estiver definida nesse momento, o Claude Code pula o registro permanentemente. Remover a definição da variável depois não desfaz isso. Execute `claude plugin marketplace add anthropics/claude-plugins-official` para registrar o marketplace a qualquer momento |275| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Defina como `1` para desativar o registro automático do marketplace oficial de plugins. O Claude Code lê a variável quando está prestes a registrar o marketplace, geralmente durante a primeira inicialização interativa de uma máquina. Se a variável estiver definida nesse momento, o Claude Code pula o registro permanentemente. Remover a definição da variável depois não desfaz isso. Execute `claude plugin marketplace add anthropics/claude-plugins-official` para registrar o marketplace a qualquer momento |

275| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Defina como `1` para impedir que o Claude Code execute seus [hooks `Notification` para solicitações de permissão não respondidas](/docs/pt/hooks#notification) em sessões nas quais o Claude Code as envia ao callback `canUseTool` do Agent SDK, que é como o Claude Desktop e a extensão do VS Code hospedam o Claude Code. Não tem efeito em sessões de terminal. Requer Claude Code v2.1.233 ou posterior |276| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Defina como `1` para impedir que o Claude Code execute seus [hooks `Notification` para solicitações de permissão não respondidas](/docs/pt/hooks#notification) em sessões nas quais o Claude Code as envia para o callback `canUseTool` do Agent SDK, que é como o Claude Desktop e a extensão do VS Code hospedam o Claude Code. Não tem efeito em sessões de terminal. Requer Claude Code v2.1.233 ou posterior |

276| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Defina como `1` para pular o carregamento de skills do diretório de skills gerenciadas de todo o sistema. Útil para sessões em contêineres ou CI que não devem carregar skills provisionadas pelo operador |277| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Defina como `1` para pular o carregamento de skills do diretório de skills gerenciadas de todo o sistema. Útil para sessões em contêiner ou de CI que não devem carregar skills provisionadas pelo operador |

277| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Defina como `1` para desativar a verificação da [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) que nega os built-ins do `cmd` `rd`, `rmdir`, `del` e `erase` em um [caminho do sistema](/docs/pt/permission-modes#remove-item-in-powershell), como a raiz de uma unidade ou seu diretório pessoal. O Claude Code ignora esta variável no bloco `env` de um arquivo de configurações. Requer Claude Code v2.1.283 ou posterior |278| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Defina como `1` para desativar a verificação da [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) que nega os comandos integrados do `cmd` `rd`, `rmdir`, `del` e `erase` em um [caminho do sistema](/docs/pt/permission-modes#remove-item-in-powershell), como a raiz de uma unidade ou seu diretório pessoal. O Claude Code ignora esta variável no bloco `env` de um arquivo de configuração. Requer Claude Code v2.1.283 ou posterior |

279| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | Defina como `1` para desativar a [troca automática de modelo quando um classificador de segurança sinaliza uma requisição](/docs/pt/model-config#automatic-model-fallback), o comportamento controlado pela configuração [`switchModelsOnFlag`](/docs/pt/settings-reference#switchmodelsonflag) |

278| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Defina como `1` para impedir que o Claude Code envie o campo de saída estruturada `output_config.format` e o valor `anthropic-beta` que o acompanha, para um [gateway de LLM](/docs/pt/llm-gateway-protocol#feature-pass-through) cujo upstream os rejeita. Isso mantém ativados os outros recursos de pré-lançamento que [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) desativa. Requer Claude Code v2.1.288 ou posterior |280| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Defina como `1` para impedir que o Claude Code envie o campo de saída estruturada `output_config.format` e o valor `anthropic-beta` que o acompanha, para um [gateway de LLM](/docs/pt/llm-gateway-protocol#feature-pass-through) cujo upstream os rejeita. Isso mantém ativados os outros recursos de pré-lançamento que [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) desativa. Requer Claude Code v2.1.288 ou posterior |

279| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Defina como `1` para desativar a verificação de [caminho crítico](/docs/pt/permission-modes#critical-paths) para um `rm` recursivo cujo alvo é inteiramente a saída de uma substituição de comando, como `rm -rf "$(pwd)"`. As outras verificações de caminho crítico continuam sendo executadas. 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 |281| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Defina como `1` para desativar a verificação de [caminhos críticos](/docs/pt/permission-modes#critical-paths) para um `rm` recursivo cujo destino é inteiramente a saída de uma substituição de comando, como `rm -rf "$(pwd)"`. As outras verificações de caminhos críticos continuam em execução. Defina-a no ambiente que inicia o Claude Code, pois 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 |

280| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Defina como `1` para desativar as atualizações automáticas do título do terminal com base no contexto da conversa. Isso também pula a requisição em segundo plano ao modelo pequeno/rápido que [gera um título de sessão](/docs/pt/sessions#name-your-sessions) |282| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Defina como `1` para desativar as atualizações automáticas do título do terminal com base no contexto da conversa. Isso também omite a requisição em segundo plano ao modelo pequeno/rápido que [gera um título para a sessão](/docs/pt/sessions#name-your-sessions) |

281| `CLAUDE_CODE_DISABLE_THINKING` | Defina como `1` para omitir completamente o parâmetro `thinking` das requisições à API. Esta é uma opção de compatibilidade para proxies e gateways que rejeitam o parâmetro. Em modelos que pensam por padrão, omitir o parâmetro significa que o modelo ainda pode pensar. Para desativar explicitamente o [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) na Anthropic API, use `MAX_THINKING_TOKENS=0` em vez disso. Nenhuma das variáveis desativa o pensamento no Opus 5.5, no Sonnet 5.5 ou nos modelos Fable, que não permitem desativar o pensamento. Em [provedores terceirizados](/docs/pt/third-party-integrations), `MAX_THINKING_TOKENS=0` também omite o parâmetro, então as duas variáveis se comportam da mesma forma lá |283| `CLAUDE_CODE_DISABLE_THINKING` | Defina como `1` para omitir completamente o parâmetro `thinking` das requisições de API. Esta é uma opção de compatibilidade para proxies e gateways que rejeitam o parâmetro. Em modelos que pensam por padrão, omitir o parâmetro significa que o modelo ainda pode pensar. Para desativar explicitamente o [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) na API da Anthropic, use `MAX_THINKING_TOKENS=0` em vez disso. Nenhuma das variáveis desativa o pensamento no Opus 5.5, no Sonnet 5.5 ou nos modelos Fable, nos quais o pensamento não pode ser desativado. Em [provedores de terceiros](/docs/pt/third-party-integrations), `MAX_THINKING_TOKENS=0` também omite o parâmetro, então as duas variáveis se comportam da mesma forma lá |

282| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Defina como `1` para pular a [compactação automática](/docs/pt/costs#reduce-token-usage) proativa quando o Claude Code não reconhecer o ID do modelo, como um alias de [gateway de LLM](/docs/pt/llm-gateway). Sem esta variável, o Claude Code compacta na janela de contexto que presume para o ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` pode corrigir a janela presumida em vez disso; consulte [Corrigir a janela para um gateway ou ID de modelo personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) para saber quando cada variável se aplica. Requer Claude Code v2.1.223 ou posterior |284| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Defina como `1` para pular a [compactação automática](/docs/pt/costs#reduce-token-usage) proativa quando o Claude Code não reconhece o ID do modelo, como um alias de [gateway de LLM](/docs/pt/llm-gateway). Sem esta variável, o Claude Code compacta na janela de contexto que presume para o ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` pode corrigir a janela presumida em vez disso; consulte [Corrigir a janela para um ID de modelo de gateway ou personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) para saber quando cada variável se aplica. Requer Claude Code v2.1.223 ou posterior |

283| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Defina como `1` para desativar a rolagem virtual na [renderização em tela cheia](/docs/pt/fullscreen) e renderizar todas as mensagens da transcrição. Use isso se a rolagem no modo de tela cheia mostrar regiões em branco onde deveriam aparecer mensagens |285| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Defina como `1` para desativar a rolagem virtual na [renderização em tela cheia](/docs/pt/fullscreen) e renderizar todas as mensagens da transcrição. Use isso se a rolagem no modo de tela cheia mostrar regiões em branco onde as mensagens deveriam aparecer |

284| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Defina como `1` para desativar a ferramenta [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior). A ferramenta [WebSearch](/docs/pt/tools-reference#websearch-tool-behavior) continua disponível. Requer Claude Code v2.1.285 ou posterior |286| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Defina como `1` para desativar a ferramenta [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior). A ferramenta [WebSearch](/docs/pt/tools-reference#websearch-tool-behavior) continua disponível. Requer Claude Code v2.1.285 ou posterior |

285| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Defina como `1` para iniciar os comandos da [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) no Windows diretamente, em vez de por meio do launcher `cmd.exe`. Por padrão, o launcher permite que um comando PowerShell [em execução em segundo plano](/docs/pt/tools-reference#background-commands) [seja transferido para o próximo processo da sessão](/docs/pt/agent-view#the-supervisor-process), como quando você [envia a sessão para segundo plano](/docs/pt/agent-view#from-inside-a-session). Se você definir a variável, um comando PowerShell em segundo plano é interrompido quando o processo da sessão termina. Comandos Bash não são afetados. Requer Claude Code v2.1.269 ou posterior |287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Defina como `1` para iniciar comandos da [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) no Windows diretamente, em vez de por meio do inicializador `cmd.exe`. Por padrão, o inicializador permite que um comando do PowerShell [em execução em segundo plano](/docs/pt/tools-reference#background-commands) [seja transferido para o próximo processo da sessão](/docs/pt/agent-view#the-supervisor-process), como quando você [envia a sessão para segundo plano](/docs/pt/agent-view#from-inside-a-session). Se você definir a variável, um comando do PowerShell em segundo plano para quando o processo da sessão termina. Comandos Bash não são afetados. Requer Claude Code v2.1.269 ou posterior |

286| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Defina como `1` para desativar os [workflows](/docs/pt/workflows#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](/docs/pt/settings-reference#disableworkflows) |288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Defina como `1` para desativar os [workflows](/docs/pt/workflows#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](/docs/pt/settings-reference#disableworkflows) |

287| `CLAUDE_CODE_EFFORT_LEVEL` | Define o nível de esforço para modelos compatíveis. Valores: `low`, `medium`, `high`, `xhigh`, `max` ou `auto` para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre `--effort`, `/effort` e as configurações `modelSettings` e `effortLevel`. Um limite definido por [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel) ainda se aplica. Consulte [Ajustar o nível de esforço](/docs/pt/model-config#adjust-effort-level) |289| `CLAUDE_CODE_EFFORT_LEVEL` | Define o nível de esforço para os modelos compatíveis. Valores: `low`, `medium`, `high`, `xhigh`, `max` ou `auto` para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre `--effort`, `/effort` e as configurações `modelSettings` e `effortLevel`. Um limite [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel) ainda se aplica. Consulte [Ajustar o nível de esforço](/docs/pt/model-config#adjust-effort-level) |

288| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Aceita para compatibilidade com versões mais antigas e não tem efeito. O modo auto está disponível por padrão em todos os provedores, incluindo Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e sessões conectadas do [Claude apps gateway](/docs/pt/claude-apps-gateway). Da v2.1.158 à v2.1.206, definir esta variável como `1` era necessário para tornar o [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) disponível nesses provedores |290| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Aceita para compatibilidade com versões mais antigas e não tem efeito. O modo auto está disponível por padrão em todos os provedores, incluindo Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e sessões conectadas do [Claude apps gateway](/docs/pt/claude-apps-gateway). Da v2.1.158 à v2.1.206, era necessário definir isso como `1` para disponibilizar o [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) nesses provedores |

289| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sobrescreve a disponibilidade do [resumo da sessão](/docs/pt/interactive-mode#session-recap). Defina como `0` para forçar a desativação dos resumos independentemente da opção em `/config`. Defina como `1` para forçar a ativação dos resumos quando [`awaySummaryEnabled`](/docs/pt/settings-reference#awaysummaryenabled) for `false`. Tem precedência sobre a configuração e a opção em `/config` |291| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sobrescreve a disponibilidade do [resumo da sessão](/docs/pt/interactive-mode#session-recap). Defina como `0` para forçar a desativação dos resumos independentemente da opção em `/config`. Defina como `1` para forçar a ativação dos resumos quando [`awaySummaryEnabled`](/docs/pt/settings-reference#awaysummaryenabled) for `false`. Tem precedência sobre a configuração e a opção em `/config` |

290| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Defina como `1` para atualizar o estado dos plugins nos limites de turno no [modo não interativo](/docs/pt/headless) após a conclusão de uma instalação em segundo plano. Desativado por padrão porque a atualização altera o system prompt no meio da sessão, o que invalida o [cache de prompt](/docs/pt/prompt-caching) para aquele turno |292| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Defina como `1` para atualizar o estado dos plugins nos limites de turno no [modo não interativo](/docs/pt/headless) após a conclusão de uma instalação em segundo plano. Desativado por padrão porque a atualização altera o system prompt no meio da sessão, o que invalida o [cache de prompt](/docs/pt/prompt-caching) para esse turno |

291| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Defina como `1` para encaminhar a pesquisa de qualidade de sessão "How is Claude doing?" para o seu próprio [coletor OpenTelemetry](/docs/pt/monitoring-usage) quando o tráfego não essencial destinado à Anthropic estiver bloqueado. As avaliações da pesquisa são emitidas apenas como eventos OTEL para o coletor configurado. Nenhum dado da pesquisa é enviado à Anthropic nesse modo. Aplica-se quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` está definida, e não tem efeito caso contrário. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e a política de feedback de produto da organização têm precedência |293| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Defina como `1` para direcionar a pesquisa de qualidade da sessão "How is Claude doing?" para o seu próprio [coletor OpenTelemetry](/docs/pt/monitoring-usage) quando o tráfego não essencial destinado à Anthropic estiver bloqueado. As avaliações da pesquisa são emitidas apenas como eventos OTEL para o coletor configurado. Nenhum dado da pesquisa é enviado à Anthropic nesse modo. Aplica-se quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` está definida, e não tem efeito caso contrário. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e a política de feedback de produto da organização têm precedência |

292| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controla se as entradas das chamadas de ferramenta são transmitidas da API à medida que Claude as gera. Com isso desativado, uma entrada de ferramenta grande, como a gravação de um arquivo longo, chega somente depois que Claude termina de gerá-la, o que pode dar a impressão de que está travado. Ativado por padrão na API da Anthropic. No Amazon Bedrock e no Agent Platform do Google Cloud, ativado por modelo quando o contêiner implantado oferece suporte. Defina como `0` para desativar. Defina como `1` para forçar a ativação ao rotear por um proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Desativado por padrão no Microsoft Foundry e em conexões de [gateway](/docs/pt/llm-gateway) |294| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controla se as entradas de chamadas de ferramenta são transmitidas por streaming da API à medida que Claude as gera. Com isso desativado, uma entrada de ferramenta grande, como a gravação de um arquivo longo, chega apenas depois que Claude termina de gerá-la, o que pode dar a impressão de que está travado. Ativado por padrão na API da Anthropic. No Amazon Bedrock e no Google Cloud's Agent Platform, ativado por modelo quando o contêiner implantado oferece suporte. Defina como `0` para desativar. Defina como `1` para forçar a ativação ao rotear por um proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Desativado por padrão no Microsoft Foundry e em conexões de [gateway](/docs/pt/llm-gateway) |

293| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Defina como `1` para preencher o seletor `/model` a partir do endpoint `/v1/models` do seu gateway quando `ANTHROPIC_BASE_URL` aponta para um gateway compatível com a Anthropic, como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque, caso contrário, gateways baseados em uma chave de API compartilhada mostrariam a todos os usuários todos os modelos aos quais a chave tem acesso. Os modelos descobertos ainda são filtrados por uma allowlist [`availableModels`](/docs/pt/settings-reference#availablemodels) que a sessão recebe; entregue a lista por meio de [MDM ou de um arquivo de configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms), já que [a entrega gerenciada pelo servidor não está disponível em configurações de gateway](/docs/pt/server-managed-settings#platform-availability) |295| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Defina como `1` para preencher o seletor `/model` a partir do endpoint `/v1/models` do seu gateway quando `ANTHROPIC_BASE_URL` apontar para um gateway compatível com a Anthropic, como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque, caso contrário, gateways baseados em uma chave de API compartilhada mostrariam a todos os usuários todos os modelos que a chave pode acessar. Os modelos descobertos ainda são filtrados por uma allowlist [`availableModels`](/docs/pt/settings-reference#availablemodels) que a sessão recebe; entregue a lista por meio de [MDM ou de um arquivo de configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms), já que a [entrega gerenciada pelo servidor não está disponível em configurações de gateway](/docs/pt/server-managed-settings#platform-availability) |

294| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Removida na v2.1.142, quando o padrão do [modo rápido](/docs/pt/fast-mode) mudou do Opus 4.6 para o Opus 4.7 |296| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Removida na v2.1.142, quando o padrão do [modo rápido](/docs/pt/fast-mode) passou do Opus 4.6 para o Opus 4.7 |

295| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Defina como `false` para desativar as sugestões de prompt, as previsões em cinza que aparecem na entrada do seu prompt. Tem precedência sobre a configuração [`promptSuggestionEnabled`](/docs/pt/settings-reference#promptsuggestionenabled), que é o que o botão **Prompt suggestions** em `/config` grava. O Claude Code também [pausa as sugestões enquanto sua conta está perto ou no limite de uso](/docs/pt/interactive-mode#when-claude-code-skips-suggestions). Defina como `true` para mantê-las ativadas até você atingir o limite. Requer Claude Code v2.1.238 ou posterior. Consulte [Sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) |297| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Defina como `false` para desativar as sugestões de prompt, as previsões em cinza que aparecem na entrada do prompt. Tem precedência sobre a configuração [`promptSuggestionEnabled`](/docs/pt/settings-reference#promptsuggestionenabled), que é o que a opção **Prompt suggestions** em `/config` grava. O Claude Code também [pausa as sugestões quando sua conta está perto do limite de uso ou já o atingiu](/docs/pt/interactive-mode#when-claude-code-skips-suggestions). Defina como `true` para mantê-las ativadas até atingir o limite. Requer Claude Code v2.1.238 ou posterior. Consulte [Sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) |

296| `CLAUDE_CODE_ENABLE_TASKS` | Seleciona quais ferramentas de rastreamento de tarefas o Claude Code fornece nas [sessões que as possuem](/docs/pt/tools-reference#task-tool-availability). Por padrão, o Claude Code fornece as ferramentas Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Defina como `0` para obter a ferramenta legada `TodoWrite` em vez delas. Consulte [Lista de tarefas](/docs/pt/interactive-mode#task-list) |298| `CLAUDE_CODE_ENABLE_TASKS` | Seleciona quais ferramentas de acompanhamento de tarefas o Claude Code fornece em [sessões que as têm](/docs/pt/tools-reference#task-tool-availability). Por padrão, o Claude Code fornece as ferramentas Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Defina como `0` para obter a ferramenta legada `TodoWrite` em vez disso. Consulte [Lista de tarefas](/docs/pt/interactive-mode#task-list) |

297| `CLAUDE_CODE_ENABLE_TELEMETRY` | Defina como `1` para ativar a coleta de dados OpenTelemetry para métricas e logs. Necessária antes de configurar exportadores OTel. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Consulte [Monitoramento](/docs/pt/monitoring-usage) |299| `CLAUDE_CODE_ENABLE_TELEMETRY` | Defina como `1` para ativar a coleta de dados do OpenTelemetry para métricas e logs. Necessária antes de configurar exportadores OTel. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada em [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Consulte [Monitoramento](/docs/pt/monitoring-usage) |

298| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Defina como `1` para obter as ferramentas de rastreamento de tarefas em todos os modelos. Sem ela, o Claude Code as fornece por padrão apenas nos modelos listados em [Disponibilidade da ferramenta Task](/docs/pt/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` ainda seleciona as ferramentas Task ou `TodoWrite`. Requer Claude Code v2.1.233 ou posterior |300| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Defina como `1` para obter as ferramentas de acompanhamento de tarefas em todos os modelos. Sem ela, o Claude Code as fornece por padrão apenas nos modelos listados em [Disponibilidade da ferramenta Task](/docs/pt/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` ainda seleciona as ferramentas Task ou `TodoWrite`. Requer Claude Code v2.1.233 ou posterior |

299| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo em milissegundos a aguardar depois que o loop de consulta fica ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts que usam o modo SDK |301| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo em milissegundos a aguardar depois que o loop de consulta fica ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts que usam o modo SDK |

300| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Defina como `1` para ativar [equipes de agentes](/docs/pt/agent-teams). As equipes de agentes são experimentais e ficam desativadas por padrão |302| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Defina como `1` para ativar as [equipes de agentes](/docs/pt/agent-teams). As equipes de agentes são experimentais e ficam desativadas por padrão |

301| `CLAUDE_CODE_EXTRA_BODY` | Objeto JSON a ser mesclado no nível superior de todo corpo de requisição da API. Útil para passar parâmetros específicos do provedor que o Claude Code não expõe diretamente. Um valor exportado no seu shell também se aplica às [sessões em segundo plano](/docs/pt/agent-view) que você despacha com `claude agents` ou `--bg`. Antes da v2.1.206, as sessões em segundo plano ignoravam um valor exportado pelo shell e usavam qualquer cópia que o processo supervisor em segundo plano tivesse herdado |303| `CLAUDE_CODE_EXTRA_BODY` | Objeto JSON a ser mesclado no nível superior do corpo de cada requisição da API. Útil para passar parâmetros específicos do provedor que o Claude Code não expõe diretamente. Um valor exportado no seu shell também se aplica às [sessões em segundo plano](/docs/pt/agent-view) que você despacha com `claude agents` ou `--bg`. Antes da v2.1.206, as sessões em segundo plano ignoravam um valor exportado pelo shell e usavam qualquer cópia que o processo supervisor em segundo plano tivesse herdado |

302| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sobrescreve o limite padrão de tokens para leituras de arquivos. Útil quando você precisa ler arquivos maiores por completo |304| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sobrescreve o limite padrão de tokens para leituras de arquivo. Útil quando você precisa ler arquivos maiores por completo |

303| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Defina como `1` para forçar a persistência da transcrição, o histórico de prompts e o registro em `claude agents` mesmo quando este `claude` foi iniciado de dentro de outra sessão do Claude Code. Use quando um valor herdado de `CLAUDE_CODE_CHILD_SESSION`, por exemplo de uma sessão `screen` ou de um inicializador em segundo plano iniciado primeiro pela ferramenta Bash do Claude Code, faz com que uma sessão que é genuinamente de nível superior seja classificada incorretamente como aninhada. A partir da v2.1.178, o Claude Code detecta o caso do tmux automaticamente e ignora o marcador herdado, então o tmux não precisa mais desta variável. Também respeitada na v2.1.169 e anteriores; não tem efeito na v2.1.170 e na v2.1.171, em que a detecção de sessão aninhada que ela sobrescreve foi removida |305| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Defina como `1` para forçar a persistência da transcrição, o histórico de prompts e o registro em `claude agents` mesmo quando este `claude` foi iniciado de dentro de outra sessão do Claude Code. Use quando um valor herdado de `CLAUDE_CODE_CHILD_SESSION`, por exemplo de uma sessão `screen` ou de um inicializador em segundo plano iniciado primeiro pela ferramenta Bash do Claude Code, fizer com que uma sessão genuína de nível superior seja classificada incorretamente como aninhada. A partir da v2.1.178, o Claude Code detecta o caso do tmux automaticamente e ignora o marcador herdado, então o tmux não precisa mais desta variável. Também é respeitada na v2.1.169 e anteriores; não tem efeito na v2.1.170 e na v2.1.171, em que a detecção de sessão aninhada que ela sobrescreve foi removida |

304| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Defina como `1` para forçar a renderização de tachado para `~~text~~` nas respostas de Claude quando seu terminal oferece suporte, mas não é detectado automaticamente, como via SSH sem `TERM_PROGRAM` encaminhado. Sem isso, terminais não detectados mostram os marcadores `~~` literais em vez de renderizar o texto como tachado. Requer Claude Code v2.1.186 ou posterior |306| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Defina como `1` para forçar a renderização tachada de `~~text~~` nas respostas de Claude quando seu terminal oferece suporte, mas não é detectado automaticamente, como via SSH sem `TERM_PROGRAM` encaminhado. Sem isso, terminais não detectados mostram os marcadores `~~` literais em vez de renderizar o texto tachado. Requer Claude Code v2.1.186 ou posterior |

305| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Defina como `1` para forçar a ativação da [saída sincronizada](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) do modo privado DEC 2026 quando seu terminal oferece suporte, mas não é detectado automaticamente. Útil para emuladores como o `eat` do Emacs, que implementam BSU/ESU, mas não respondem à sondagem de capacidade. Não tem efeito no tmux. Diferentemente de `CLAUDE_CODE_NO_FLICKER`, que muda para a [renderização em tela cheia](/docs/pt/fullscreen), esta não altera o renderizador |307| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Defina como `1` para forçar a ativação da [saída sincronizada](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) do modo privado DEC 2026 quando seu terminal oferece suporte, mas não é detectado automaticamente. Útil para emuladores como o `eat` do Emacs, que implementam BSU/ESU mas não respondem à sondagem de capacidade. Não tem efeito no tmux. Diferentemente de `CLAUDE_CODE_NO_FLICKER`, que muda para a [renderização em tela cheia](/docs/pt/fullscreen), isso não altera o renderizador |

306| `CLAUDE_CODE_FORK_SUBAGENT` | Controla o [modo fork](/docs/pt/sub-agents#turn-fork-mode-on-or-off), que permite que Claude gere [subagentes bifurcados](/docs/pt/sub-agents#fork-the-current-conversation) por conta própria e fica ativado por padrão apenas em sessões interativas. Defina como `1` para ativá-lo também em `claude -p` e no Agent SDK, ou `0` para desativá-lo em todo tipo de sessão. Você pode executar `/subtask` com o modo fork ativado ou não. O padrão interativo requer Claude Code v2.1.232 ou posterior; em versões anteriores, defina a variável como `1` para ativar o modo fork |308| `CLAUDE_CODE_FORK_SUBAGENT` | Controla o [modo fork](/docs/pt/sub-agents#turn-fork-mode-on-or-off), que permite que o próprio Claude crie [subagentes bifurcados](/docs/pt/sub-agents#fork-the-current-conversation) e fica ativado por padrão apenas em sessões interativas. Defina como `1` para ativá-lo também em `claude -p` e no Agent SDK, ou `0` para desativá-lo em todos os tipos de sessão. Você pode executar `/subtask` com o modo fork ativado ou não. O padrão interativo requer Claude Code v2.1.232 ou posterior; em versões anteriores, defina a variável como `1` para ativar o modo fork |

307| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Defina como `1` para emitir blocos de texto e de pensamento de [subagentes](/docs/pt/sub-agents) na saída de `claude -p --output-format stream-json`, o mesmo comportamento da flag [`--forward-subagent-text`](/docs/pt/cli-reference#cli-flags). Use a variável quando um harness invoca `claude` e não consegue passar a flag por conta própria. Diferentemente da flag, que encerra com um erro fora do modo não interativo com saída stream-json, a variável é ignorada nesses casos para que invocações aninhadas continuem funcionando quando ela é definida para todo o processo. Requer Claude Code v2.1.211 ou posterior |309| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Defina como `1` para emitir blocos de texto e de pensamento de [subagentes](/docs/pt/sub-agents) na saída de `claude -p --output-format stream-json`, o mesmo comportamento da flag [`--forward-subagent-text`](/docs/pt/cli-reference#cli-flags). Use a variável quando um harness invoca `claude` e não consegue passar a flag por conta própria. Diferentemente da flag, que encerra com um erro fora do modo não interativo com saída stream-json, a variável é ignorada nesse caso para que invocações aninhadas continuem funcionando quando ela é definida para todo o processo. Requer Claude Code v2.1.211 ou posterior |

308| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Defina como `1` para enviar os [cabeçalhos de dica de gateway](/docs/pt/llm-gateway-protocol#gateway-hint-headers), como `x-claude-code-request-class` e `x-claude-code-compaction`, em um proxy personalizado ou em um provedor terceirizado, como Amazon Bedrock ou Claude Platform on AWS. Defina como `0` para parar de enviá-los em todas as conexões, incluindo uma conexão direta com a API da Anthropic, onde o Claude Code os envia por padrão. Requer Claude Code v2.1.273 ou posterior |310| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Defina como `1` para enviar os [cabeçalhos de dica do gateway](/docs/pt/llm-gateway-protocol#gateway-hint-headers), como `x-claude-code-request-class` e `x-claude-code-compaction`, em um proxy personalizado ou em um provedor terceirizado, como Amazon Bedrock ou Claude Platform on AWS. Defina como `0` para parar de enviá-los em todas as conexões, incluindo uma conexão direta com a API da Anthropic, em que o Claude Code os envia por padrão. Requer Claude Code v2.1.273 ou posterior |

309| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout em milissegundos para a requisição de [descoberta de modelos do gateway](/docs/pt/llm-gateway-protocol#model-discovery) que `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` ativa (padrão: `3000`). Aumente-o quando seu gateway precisar de mais de três segundos para responder a `/v1/models` na inicialização. Aceita apenas dígitos simples; `0`, valores negativos e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior |311| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout em milissegundos para a requisição de [descoberta de modelos do gateway](/docs/pt/llm-gateway-protocol#model-discovery) que `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` ativa (padrão: `3000`). Aumente-o quando seu gateway precisar de mais de três segundos para responder a `/v1/models` na inicialização. Aceita apenas dígitos simples; `0`, valores negativos e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior |

310| `CLAUDE_CODE_GIT_BASH_PATH` | Somente Windows: caminho para o executável do Git Bash (`bash.exe`). Use quando o Git Bash estiver instalado, mas não estiver no seu PATH. Se o caminho não existir ou o arquivo não se chamar `bash.exe`, `sh.exe`, `bash` ou `sh`, o Claude Code ignora a variável e detecta automaticamente o Git Bash como se ela não estivesse definida, registrando um aviso visível com `--debug`. Antes da v2.1.219, o Claude Code encerrava na inicialização quando o caminho não existia e usava qualquer arquivo existente como shell sem verificar se era bash ou sh. Consulte [Configuração no Windows](/docs/pt/setup#set-up-on-windows) |312| `CLAUDE_CODE_GIT_BASH_PATH` | Somente Windows: caminho para o executável do Git Bash (`bash.exe`). Use quando o Git Bash estiver instalado, mas não estiver no seu PATH. Se o caminho não existir ou o arquivo não se chamar `bash.exe`, `sh.exe`, `bash` ou `sh`, o Claude Code ignora a variável e detecta automaticamente o Git Bash como se ela não estivesse definida, registrando um aviso visível com `--debug`. Antes da v2.1.219, o Claude Code encerrava na inicialização quando o caminho não existia, e usava qualquer arquivo existente como shell sem verificar se era bash ou sh. Consulte [Configuração no Windows](/docs/pt/setup#set-up-on-windows) |

311| `CLAUDE_CODE_GLOB_HIDDEN` | Defina como `false` para excluir dotfiles dos resultados quando Claude invoca a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior). Incluídos por padrão. Não afeta o preenchimento automático de arquivos com `@`, `ls`, Grep nem Read |313| `CLAUDE_CODE_GLOB_HIDDEN` | Defina como `false` para excluir dotfiles dos resultados quando Claude invoca a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior). Incluídos por padrão. Não afeta o preenchimento automático de arquivos com `@`, `ls`, Grep ou Read |

312| `CLAUDE_CODE_GLOB_NO_IGNORE` | Defina como `false` para fazer a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior) respeitar os padrões do `.gitignore`. Por padrão, o Glob retorna todos os arquivos correspondentes, incluindo os ignorados pelo git. Não afeta o preenchimento automático de arquivos com `@`, que tem sua própria [configuração `respectGitignore`](/docs/pt/settings-reference#respectgitignore) |314| `CLAUDE_CODE_GLOB_NO_IGNORE` | Defina como `false` para fazer a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior) respeitar os padrões do `.gitignore`. Por padrão, o Glob retorna todos os arquivos correspondentes, incluindo os ignorados pelo git. Não afeta o preenchimento automático de arquivos com `@`, que tem sua própria [configuração `respectGitignore`](/docs/pt/settings-reference#respectgitignore) |

313| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout em segundos para a descoberta de arquivos da ferramenta Glob. O padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |315| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout em segundos para a descoberta de arquivos da ferramenta Glob. O padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |

314| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Por quantos minutos o trabalho em segundo plano pode manter um objetivo ativo aguardando antes que o Claude Code [peça a Claude para verificá-lo](/docs/pt/goal#background-work-defers-evaluation). Padrão `30`. Defina `0` para desativar as verificações. Informe minutos inteiros em dígitos simples, no máximo `10080`, que equivale a uma semana. O Claude Code trata qualquer outro valor como não definido e usa o padrão. Requer Claude Code v2.1.234 ou posterior |316| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Por quantos minutos o trabalho em segundo plano pode manter uma meta ativa aguardando antes que o Claude Code [peça a Claude para verificá-la](/docs/pt/goal#background-work-defers-evaluation). Padrão `30`. Defina `0` para desativar as verificações. Informe minutos inteiros em dígitos simples, no máximo `10080`, que corresponde a uma semana. O Claude Code trata qualquer outro valor como não definido e usa o padrão. Requer Claude Code v2.1.234 ou posterior |

315| `CLAUDE_CODE_HIDE_CWD` | Defina como `1` para ocultar o diretório de trabalho no logotipo de inicialização. Útil para compartilhamentos de tela ou gravações em que o caminho expõe o nome de usuário do seu sistema operacional |317| `CLAUDE_CODE_HIDE_CWD` | Defina como `1` para ocultar o diretório de trabalho no logotipo de inicialização. Útil para compartilhamentos de tela ou gravações em que o caminho expõe seu nome de usuário do sistema operacional |

316| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sobrescreve o endereço de host usado para conectar à extensão do IDE. Por padrão, o Claude Code detecta automaticamente o endereço correto, incluindo o roteamento do WSL para o Windows |318| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sobrescreve o endereço do host usado para conectar à extensão do IDE. Por padrão, o Claude Code detecta automaticamente o endereço correto, incluindo o roteamento do WSL para o Windows |

317| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para pular a instalação automática das extensões do IDE. Equivalente a definir [`autoInstallIdeExtension`](/docs/pt/settings-reference#autoinstallideextension) como `false` |319| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para pular a instalação automática das extensões do IDE. Equivalente a definir [`autoInstallIdeExtension`](/docs/pt/settings-reference#autoinstallideextension) como `false` |

318| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Defina como `1` para pular a validação das entradas do lockfile do IDE durante a conexão. Use quando a conexão automática não encontrar seu IDE mesmo com ele em execução |320| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Defina como `1` para pular a validação das entradas do lockfile do IDE durante a conexão. Use quando a conexão automática não encontrar seu IDE mesmo com ele em execução |

319| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Quantos [subagentes](/docs/pt/sub-agents#concurrent-subagent-limit) podem estar em execução em uma sessão antes que a ferramenta Agent se recuse a gerar outro (padrão: 20). Aceita um número inteiro positivo em dígitos simples; qualquer outra coisa é ignorada, então a variável pode ajustar o limite, mas não desativá-lo. Requer Claude Code v2.1.217 ou posterior |321| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Quantos [subagentes](/docs/pt/sub-agents#concurrent-subagent-limit) podem estar em execução em uma sessão antes que a ferramenta Agent se recuse a criar outro (padrão: 20). Aceita um número inteiro positivo em dígitos simples; qualquer outra coisa é ignorada, então a variável pode ajustar o limite, mas não pode desativá-lo. Requer Claude Code v2.1.217 ou posterior |

320| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sobrescreve o tamanho da janela de contexto que o Claude Code assume para o modelo ativo. A partir da v2.1.193, a forma como se aplica depende de como o Claude Code resolve o ID do modelo; consulte [Corrigir a janela para um gateway ou ID de modelo personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Use isso ao rotear para um modelo via `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para o seu nome |322| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sobrescreve o tamanho da janela de contexto que o Claude Code assume para o modelo ativo. A partir da v2.1.193, a forma como ela se aplica depende de como o Claude Code resolve o ID do modelo; consulte [Corrigir a janela para um gateway ou ID de modelo personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Use isso ao rotear para um modelo por meio de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para o seu nome |

321| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Comprimento máximo, em caracteres, de cada descrição de ferramenta MCP e das instruções de cada servidor MCP que o Claude Code envia ao modelo (padrão: 2048). O Claude Code [trunca textos mais longos](/docs/pt/mcp#for-mcp-server-authors). Aceita um número inteiro positivo em dígitos simples. Qualquer outra coisa é ignorada e o padrão se aplica. Requer Claude Code v2.1.280 ou posterior |323| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Comprimento máximo, em caracteres, de cada descrição de ferramenta MCP e das instruções de cada servidor MCP que o Claude Code envia ao modelo (padrão: 2048). O Claude Code [trunca textos mais longos](/docs/pt/mcp#for-mcp-server-authors). Aceita um número inteiro positivo em dígitos simples. Qualquer outra coisa é ignorada e o padrão se aplica. Requer Claude Code v2.1.280 ou posterior |

322| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Define o número máximo de tokens de saída para a maioria das requisições. Os padrões e limites variam por modelo; consulte [máximo de tokens de saída](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). O Claude Code reduz um valor acima do limite de um modelo para esse limite. Para um ID de modelo que o Claude Code não consegue resolver para um modelo que conhece, o padrão é 32000 e o limite é 128000. Aumentar esse valor reduz a janela de contexto efetiva disponível antes que a [compactação automática](/docs/pt/costs#reduce-token-usage) seja acionada |324| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Define o número máximo de tokens de saída para a maioria das requisições. Padrões e limites variam por modelo; consulte [máximo de tokens de saída](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). O Claude Code reduz um valor acima do limite de um modelo para esse limite. Para um ID de modelo que o Claude Code não consegue associar a um modelo conhecido, o padrão é 32000 e o limite é 128000. Aumentar esse valor reduz a janela de contexto efetiva disponível antes que a [compactação automática](/docs/pt/costs#reduce-token-usage) seja acionada |

323| `CLAUDE_CODE_MAX_RETRIES` | Sobrescreve o número de vezes que requisições de API com falha são tentadas novamente (padrão: 10). Limitado a 15 a partir da v2.1.186; a partir da v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Para sessões não supervisionadas que precisam aguardar interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG` em vez disso |325| `CLAUDE_CODE_MAX_RETRIES` | Sobrescreve o número de novas tentativas para requisições de API com falha (padrão: 10). Limitado a 15 a partir da v2.1.186; a partir da v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Para sessões não supervisionadas que precisam aguardar interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG` em vez disso |

324| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Removida na v2.1.224 e agora sem efeito. Anteriormente limitava o número total de [subagentes](/docs/pt/sub-agents) que Claude podia gerar com a ferramenta Agent em uma sessão (padrão: 200); gerar além do limite falhava com `Subagent spawn limit reached`. O [limite de subagentes simultâneos](/docs/pt/sub-agents#concurrent-subagent-limit) e o [limite de profundidade](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents) ainda se aplicam |326| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Removida na v2.1.224 e agora não tem efeito. Anteriormente, limitava o número total de [subagentes](/docs/pt/sub-agents) que Claude podia criar com a ferramenta Agent em uma sessão (padrão: 200); criar além do limite falhava com `Subagent spawn limit reached`. O [limite de subagentes simultâneos](/docs/pt/sub-agents#concurrent-subagent-limit) e o [limite de profundidade](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents) ainda se aplicam |

325| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Número de [camadas de subagentes](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents) permitidas abaixo da conversa principal (padrão: 3). No padrão, os subagentes podem gerar seus próprios subagentes, e um subagente na terceira camada não pode gerar mais nenhum; defina `1` para desativar o aninhamento. Da v2.1.217 até a v2.1.218, o padrão era 1, então um subagente não podia gerar os seus próprios a menos que você aumentasse o limite; a v2.1.219 aumentou o padrão para 3. Aceita um número inteiro positivo em dígitos simples; qualquer outra coisa é ignorada, então o limite pode ser ajustado, mas não removido. Requer Claude Code v2.1.217 ou posterior |327| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Número de [camadas de subagentes](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents) permitidas abaixo da conversa principal (padrão: 3). No padrão, subagentes podem criar seus próprios subagentes, e um subagente na terceira camada não pode criar mais; defina `1` para desativar o aninhamento. Da v2.1.217 à v2.1.218, o padrão era 1, então um subagente não podia criar os seus próprios a menos que você aumentasse o limite; a v2.1.219 aumentou o padrão para 3. Aceita um número inteiro positivo em dígitos simples; qualquer outra coisa é ignorada, então o limite pode ser ajustado, mas não removido. Requer Claude Code v2.1.217 ou posterior |

326| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Número máximo de ferramentas somente leitura e subagentes que podem ser executados em paralelo (padrão: 10). Valores mais altos aumentam o paralelismo, mas consomem mais recursos |328| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Número máximo de ferramentas somente leitura e subagentes que podem ser executados em paralelo (padrão: 10). Valores mais altos aumentam o paralelismo, mas consomem mais recursos |

327| `CLAUDE_CODE_MAX_TURNS` | Limita o número de turnos agênticos quando nenhum limite explícito é passado. Equivalente a passar [`--max-turns`](/docs/pt/cli-reference#cli-flags), que tem precedência quando ambos estão definidos. Um valor que não seja um inteiro positivo é rejeitado na inicialização com um erro, em vez de ser tratado como ausência de limite |329| `CLAUDE_CODE_MAX_TURNS` | Limita o número de turnos agênticos quando nenhum limite explícito é passado. Equivalente a passar [`--max-turns`](/docs/pt/cli-reference#cli-flags), que tem precedência quando ambos estão definidos. Um valor que não seja um inteiro positivo é rejeitado na inicialização com um erro, em vez de ser tratado como ausência de limite |

328| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Limite do número total de chamadas de [WebSearch](/docs/pt/tools-reference#websearch-tool-behavior) que uma sessão pode fazer (padrão: 200). Quando Claude atinge o limite, chamadas adicionais de WebSearch retornam um aviso dizendo para continuar com as informações que já reuniu. Aceita um número inteiro positivo sem limite superior. Qualquer outra coisa é ignorada e o padrão se aplica, então o limite pode ser aumentado, mas não desativado. Requer Claude Code v2.1.212 ou posterior |330| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Limite do número total de chamadas de [WebSearch](/docs/pt/tools-reference#websearch-tool-behavior) que uma sessão pode fazer (padrão: 200). Quando Claude atinge o limite, chamadas adicionais de WebSearch retornam um aviso dizendo para continuar com as informações que já coletou. Aceita um número inteiro positivo sem limite superior. Qualquer outra coisa é ignorada e o padrão se aplica, então o limite pode ser aumentado, mas não desativado. Requer Claude Code v2.1.212 ou posterior |

329| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Defina como `1` para iniciar servidores MCP stdio apenas com um ambiente base seguro mais o `env` configurado do servidor, em vez de herdar o ambiente do seu shell |331| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Defina como `1` para iniciar servidores MCP stdio apenas com um ambiente base seguro mais o `env` configurado do servidor, em vez de herdar o ambiente do seu shell |

330| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Tempo decorrido, em milissegundos, antes que uma chamada de ferramenta MCP ainda em execução [passe para uma tarefa em segundo plano](/docs/pt/mcp#automatic-backgrounding-of-long-tool-calls) (padrão: 120000, ou 2 minutos). Defina como `0` para desativar a passagem automática para segundo plano. Requer Claude Code v2.1.212 ou posterior |332| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Tempo decorrido em milissegundos antes que uma chamada de ferramenta MCP ainda em execução [passe para uma tarefa em segundo plano](/docs/pt/mcp#automatic-backgrounding-of-long-tool-calls) (padrão: 120000, ou 2 minutos). Defina como `0` para desativar a passagem automática para segundo plano. Requer Claude Code v2.1.212 ou posterior |

331| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Por quanto tempo, em milissegundos, o primeiro turno de uma sessão [não interativa](/docs/pt/headless) aguarda servidores MCP que ainda estão se conectando, no lugar da [espera do primeiro turno](/docs/pt/agent-sdk/mcp#connection-timing) padrão. Quando definida, a espera abrange todos os servidores pendentes. Defina como `0` para pular a espera. Um servidor de [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) mantém sua própria espera de `MCP_TIMEOUT`, independentemente do valor. Requer Claude Code v2.1.274 ou posterior |333| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Por quanto tempo, em milissegundos, o primeiro turno de uma sessão [não interativa](/docs/pt/headless) aguarda servidores MCP que ainda estão se conectando, no lugar da [espera padrão do primeiro turno](/docs/pt/agent-sdk/mcp#connection-timing). Quando definida, a espera abrange todos os servidores pendentes. Defina como `0` para pular a espera. Um servidor de [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) mantém sua própria espera de `MCP_TIMEOUT` independentemente do valor. Requer Claude Code v2.1.274 ou posterior |

332| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Timeout de inatividade, em milissegundos, para chamadas de ferramenta MCP. Quando um servidor MCP stdio, HTTP, SSE, WebSocket ou [conector do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) não envia resposta nem notificação de progresso por esse tempo, a chamada de ferramenta é abortada com um erro em vez de aguardar o `MCP_TOOL_TIMEOUT` geral. Sobrescreve os padrões por transporte de 300000 (5 minutos) para servidores de rede e 1800000 (30 minutos) para servidores stdio. Defina como `0` para desativar a verificação de inatividade. Valores abaixo de 1000 são elevados para um segundo, e o valor é limitado ao `MCP_TOOL_TIMEOUT` efetivo. Um `timeout` por servidor em `.mcp.json` de pelo menos 1000 eleva a janela de inatividade desse servidor para no mínimo o valor de `timeout`. Não se aplica a servidores de IDE nem a servidores in-process do SDK. Requer Claude Code v2.1.187 ou posterior. Antes da v2.1.203, os servidores stdio estavam isentos do timeout de inatividade |334| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Timeout de inatividade em milissegundos para chamadas de ferramenta MCP. Quando um servidor MCP stdio, HTTP, SSE, WebSocket ou de [conector do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) não envia nenhuma resposta nem notificação de progresso por esse tempo, a chamada de ferramenta é abortada com um erro em vez de aguardar o `MCP_TOOL_TIMEOUT` geral. Sobrescreve os padrões por transporte de 300000 (5 minutos) para servidores de rede e 1800000 (30 minutos) para servidores stdio. Defina como `0` para desativar a verificação de inatividade. Valores abaixo de 1000 são elevados para um segundo, e o valor é limitado ao `MCP_TOOL_TIMEOUT` efetivo. Um `timeout` por servidor em `.mcp.json` de pelo menos 1000 eleva a janela de inatividade desse servidor para pelo menos o valor de `timeout`. Não se aplica a servidores de IDE nem a servidores in-process do SDK. Requer Claude Code v2.1.187 ou posterior. Antes da v2.1.203, os servidores stdio eram isentos do timeout de inatividade |

333| `CLAUDE_CODE_MESSAGING_SOCKET` | Definida pelo Claude Code, não por você: em sessões que vinculam um [socket de caixa de entrada](/docs/pt/cross-session-messaging#the-sessions-inbox-socket), o Claude Code exporta o caminho desse socket para hooks e comandos Bash quando vincula o socket. Em uma sessão que começa com as mensagens ativadas, o Claude Code vincula o socket antes que qualquer hook seja executado. Outras sessões na máquina entregam mensagens para esse caminho. Cada sessão exporta seu próprio socket em vez de um herdado de um processo pai, e as mensagens que chegam nele passam pelos [controles de entrada](/docs/pt/cross-session-messaging#control-inbound-messages) da sessão. Blocos `env` de configurações não podem defini-la. Requer Claude Code v2.1.224 ou posterior |335| `CLAUDE_CODE_MESSAGING_SOCKET` | Definida pelo Claude Code, não por você: em sessões que vinculam um [socket de caixa de entrada](/docs/pt/cross-session-messaging#the-sessions-inbox-socket), o Claude Code exporta o caminho desse socket para hooks e comandos Bash quando vincula o socket. Em uma sessão que inicia com mensagens ativadas, o Claude Code vincula o socket antes da execução de qualquer hook. Outras sessões na máquina entregam mensagens nesse caminho. Cada sessão exporta seu próprio socket, em vez de um herdado de uma sessão pai, e as mensagens que chegam nele passam pelos [controles de entrada](/docs/pt/cross-session-messaging#control-inbound-messages) da sessão. Blocos `env` de configurações não podem defini-la. Requer Claude Code v2.1.224 ou posterior |

334| `CLAUDE_CODE_MESSAGING_TOKEN` | Definida pelo Claude Code, não por você: em sessões que vinculam um [socket de caixa de entrada](/docs/pt/cross-session-messaging#the-sessions-inbox-socket), o Claude Code exporta este token por sessão para hooks e comandos Bash junto com `CLAUDE_CODE_MESSAGING_SOCKET`. Um script que publica no socket pode enviar `{"type":"auth","token":"<token>"}` como sua primeira linha para provar que pertence à sessão. No Windows nativo, o Claude Code exige essa linha e fecha qualquer conexão que não comece com uma linha válida. As [regras de processo filho próprio](/docs/pt/cross-session-messaging#the-sessions-inbox-socket) dizem quando o Claude Code consulta o token. Cada sessão exporta seu próprio token, nunca um herdado de uma sessão pai. Blocos `env` de configurações não podem defini-la. Requer Claude Code v2.1.228 ou posterior |336| `CLAUDE_CODE_MESSAGING_TOKEN` | Definida pelo Claude Code, não por você: em sessões que vinculam um [socket de caixa de entrada](/docs/pt/cross-session-messaging#the-sessions-inbox-socket), o Claude Code exporta este token por sessão para hooks e comandos Bash junto com `CLAUDE_CODE_MESSAGING_SOCKET`. Um script que envia dados ao socket pode enviar `{"type":"auth","token":"<token>"}` como primeira linha para provar que pertence à sessão. No Windows nativo, o Claude Code exige essa linha e fecha qualquer conexão que não comece com uma linha válida. As [regras de processo filho próprio](/docs/pt/cross-session-messaging#the-sessions-inbox-socket) indicam quando o Claude Code consulta o token. Cada sessão exporta seu próprio token, nunca um herdado de uma sessão pai. Blocos `env` de configurações não podem defini-la. Requer Claude Code v2.1.228 ou posterior |

335| `CLAUDE_CODE_NATIVE_CURSOR` | Defina como `1` para mostrar o próprio cursor do terminal no ponto de inserção da entrada em vez de um bloco desenhado. O cursor respeita as configurações de piscar, formato e foco do terminal |337| `CLAUDE_CODE_NATIVE_CURSOR` | Defina como `1` para mostrar o próprio cursor do terminal no ponto de inserção em vez de um bloco desenhado. O cursor respeita as configurações de intermitência, formato e foco do terminal |

336| `CLAUDE_CODE_NEW_INIT` | Defina como `1` para fazer `/init` executar um fluxo de configuração interativo. O fluxo pergunta quais arquivos gerar, incluindo CLAUDE.md, skills e hooks, antes de explorar a base de código e gravá-los. Sem esta variável, `/init` gera um CLAUDE.md automaticamente sem perguntar |338| `CLAUDE_CODE_NEW_INIT` | Defina como `1` para fazer `/init` executar um fluxo de configuração interativo. O fluxo pergunta quais arquivos gerar, incluindo CLAUDE.md, skills e hooks, antes de explorar a base de código e gravá-los. Sem esta variável, `/init` gera um CLAUDE.md automaticamente sem pedir confirmação |

337| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Defina como `1` para gravar a saída do terminal por meio de um segundo descritor de arquivo não bloqueante, para que um terminal que para de ler, como um painel pausado do modo de controle do tmux ou uma conexão SSH travada, não possa congelar o Claude Code no meio da sessão. Aplica-se no macOS, Linux e WSL quando stdout é um terminal. Requer Claude Code v2.1.261 ou posterior |339| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Defina como `1` para gravar a saída do terminal por meio de um segundo descritor de arquivo não bloqueante, para que um terminal que para de ler, como um painel pausado do modo de controle do tmux ou uma conexão SSH travada, não possa congelar o Claude Code no meio da sessão. Aplica-se no macOS, no Linux e no WSL quando stdout é um terminal. Requer Claude Code v2.1.261 ou posterior |

338| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quantas vezes o Claude Code reenvia uma [requisição sem streaming](/docs/pt/errors#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Com `0`, a requisição falha no primeiro timeout. Não definida por padrão, então `CLAUDE_CODE_MAX_RETRIES` limita esses reenvios. Consulte [Ajustar o comportamento de novas tentativas](/docs/pt/errors#tune-retry-behavior) para o timeout. Requer Claude Code v2.1.285 ou posterior |340| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quantas vezes o Claude Code reenvia uma [requisição sem streaming](/docs/pt/errors#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Com `0`, a requisição falha no primeiro timeout. Não definida por padrão, então `CLAUDE_CODE_MAX_RETRIES` limita esses reenvios. Consulte [Ajustar o comportamento de novas tentativas](/docs/pt/errors#tune-retry-behavior) para o timeout. Requer Claude Code v2.1.285 ou posterior |

339| `CLAUDE_CODE_NO_FLICKER` | Defina como `1` para ativar a [renderização em tela cheia](/docs/pt/fullscreen), uma prévia de pesquisa que reduz a cintilação e mantém o uso de memória estável em conversas longas. Sobrescreve a configuração [`tui`](/docs/pt/settings-reference#tui); você também pode alternar com `/tui fullscreen` |341| `CLAUDE_CODE_NO_FLICKER` | Defina como `1` para ativar a [renderização em tela cheia](/docs/pt/fullscreen), uma prévia de pesquisa que reduz a cintilação e mantém o uso de memória estável em conversas longas. Sobrescreve a configuração [`tui`](/docs/pt/settings-reference#tui); você também pode alternar com `/tui fullscreen` |

340| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token de atualização OAuth para autenticação no Claude.ai. Quando definido, `claude auth login` troca esse token diretamente em vez de abrir um navegador. Requer `CLAUDE_CODE_OAUTH_SCOPES`. Útil para provisionar autenticação em ambientes automatizados |342| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token de atualização OAuth para autenticação no Claude.ai. Quando definido, `claude auth login` troca esse token diretamente em vez de abrir um navegador. Requer `CLAUDE_CODE_OAUTH_SCOPES`. Útil para provisionar autenticação em ambientes automatizados |

341| `CLAUDE_CODE_OAUTH_SCOPES` | Escopos OAuth separados por espaço com os quais o token de atualização foi emitido, como `"user:profile user:inference user:sessions:claude_code"`. Obrigatória quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definida |343| `CLAUDE_CODE_OAUTH_SCOPES` | Escopos OAuth, separados por espaço, com os quais o token de atualização foi emitido, como `"user:profile user:inference user:sessions:claude_code"`. Obrigatória quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definida |

342| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acesso OAuth para autenticação no claude.ai. Alternativa a `/login` para o SDK e ambientes automatizados. Tem precedência sobre credenciais armazenadas no keychain. Gere um com [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token). A menos que você execute [`/login`](/docs/pt/authentication#authentication-precedence), o Claude Code usa o token que você definiu durante toda a sessão. Para substituir um token expirado, gere um novo e reinicie |344| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acesso OAuth para autenticação no claude.ai. Alternativa a `/login` para SDK e ambientes automatizados. Tem precedência sobre credenciais armazenadas no keychain. Gere um com [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token). A menos que você execute [`/login`](/docs/pt/authentication#authentication-precedence), o Claude Code usa o token que você definiu durante toda a sessão. Para substituir um token expirado, gere um novo e reinicie |

343| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Removida na v2.1.160 e agora sem efeito. Anteriormente fixava o [modo rápido](/docs/pt/fast-mode) no Claude Opus 4.6 em vez do padrão atual. O Opus 4.6 não oferece mais suporte ao modo rápido |345| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Removida na v2.1.160 e agora não tem efeito. Anteriormente, fixava o [modo rápido](/docs/pt/fast-mode) no Claude Opus 4.6 em vez do padrão atual. O Opus 4.6 não oferece mais suporte ao modo rápido |

344| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Comprimento máximo dos atributos OpenTelemetry que carregam conteúdo (respostas do modelo, conteúdo de ferramentas, system prompts, corpos brutos da API), incluindo o marcador de truncamento, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). Aumente-o apenas se o seu backend de telemetria aceitar valores de atributo maiores que 64 KB, ou reduza-o para diminuir o volume de telemetria. Requer Claude Code v2.1.214 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage) |346| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Comprimento máximo dos atributos do OpenTelemetry que carregam conteúdo (respostas do modelo, conteúdo de ferramentas, system prompts, corpos brutos da API), incluindo o marcador de truncamento, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). Aumente-o apenas se o seu backend de telemetria aceitar valores de atributo maiores que 64 KB, ou reduza-o para diminuir o volume de telemetria. Requer Claude Code v2.1.214 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage) |

345| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Defina como `1` para gravar os erros de diagnóstico do exportador OpenTelemetry no stderr. Por padrão, esses erros só aparecem com `--debug`, então, caso contrário, um exportador mal configurado, como em uma colisão de porta do Prometheus, falha silenciosamente. Requer Claude Code v2.1.179 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage) |347| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Defina como `1` para gravar os erros de diagnóstico do exportador OpenTelemetry no stderr. Por padrão, esses erros só aparecem com `--debug`, então um exportador mal configurado, como em uma colisão de porta do Prometheus, falha silenciosamente. Requer Claude Code v2.1.179 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage) |

346| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout em milissegundos para descarregar spans pendentes do OpenTelemetry (padrão: 5000). Consulte [Monitoramento](/docs/pt/monitoring-usage) |348| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout em milissegundos para descarregar spans pendentes do OpenTelemetry (padrão: 5000). Consulte [Monitoramento](/docs/pt/monitoring-usage) |

347| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalo, em milissegundos, para atualizar cabeçalhos dinâmicos do OpenTelemetry (padrão: 1740000 / 29 minutos). Consulte [Cabeçalhos dinâmicos](/docs/pt/monitoring-usage#dynamic-headers) |349| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalo, em milissegundos, para atualizar os cabeçalhos dinâmicos do OpenTelemetry (padrão: 1740000 / 29 minutos). Consulte [Cabeçalhos dinâmicos](/docs/pt/monitoring-usage#dynamic-headers) |

348| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout em milissegundos para o exportador OpenTelemetry terminar no encerramento (padrão: 2000). Aumente-o se métricas forem descartadas na saída. Consulte [Monitoramento](/docs/pt/monitoring-usage) |350| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout em milissegundos para que o exportador OpenTelemetry termine no encerramento (padrão: 2000). Aumente-o se métricas forem descartadas na saída. Consulte [Monitoramento](/docs/pt/monitoring-usage) |

349| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Defina como `1` para permitir que o Claude Code execute o comando de atualização do seu gerenciador de pacotes em segundo plano quando uma nova versão estiver disponível. Aplica-se a instalações via Homebrew e WinGet. Outros gerenciadores de pacotes continuam mostrando o comando de atualização sem executá-lo. Consulte [Atualizações automáticas](/docs/pt/setup#auto-updates) |351| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Defina como `1` para permitir que o Claude Code execute o comando de atualização do seu gerenciador de pacotes em segundo plano quando uma nova versão estiver disponível. Aplica-se a instalações via Homebrew e WinGet. Outros gerenciadores de pacotes continuam mostrando o comando de atualização sem executá-lo. Consulte [Atualizações automáticas](/docs/pt/setup#auto-updates) |

350| `CLAUDE_CODE_PERFORCE_MODE` | Defina como `1` para ativar a proteção de gravação compatível com o Perforce. Quando definida, Edit, Write e NotebookEdit falham com uma dica `p4 edit <file>` se o arquivo de destino não tiver o bit de gravação do proprietário, que o Perforce remove em arquivos sincronizados até que `p4 edit` os abra. Isso impede que o Claude Code contorne o rastreamento de alterações do Perforce |352| `CLAUDE_CODE_PERFORCE_MODE` | Defina como `1` para ativar a proteção contra gravação compatível com o Perforce. Quando definida, Edit, Write e NotebookEdit falham com uma dica `p4 edit <file>` se o arquivo de destino não tiver o bit de gravação do proprietário, que o Perforce remove em arquivos sincronizados até que `p4 edit` os abra. Isso impede que o Claude Code contorne o controle de alterações do Perforce |

351| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sobrescreve o diretório raiz de plugins. Apesar do nome, isso define o diretório pai, não o cache em si: os marketplaces e o cache de plugins ficam em subdiretórios sob este caminho. O padrão é `~/.claude/plugins` |353| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sobrescreve o diretório raiz de plugins. Apesar do nome, isso define o diretório pai, não o cache em si: os marketplaces e o cache de plugins ficam em subdiretórios sob esse caminho. O padrão é `~/.claude/plugins` |

352| `CLAUDE_CODE_PLUGIN_DIRS` | Diretórios de plugins a serem carregados para a sessão, cada um carregado da mesma forma que uma flag [`--plugin-dir`](/docs/pt/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) o carrega. Separe vários caminhos com `:` no Unix ou `;` no Windows. Informe cada caminho como um caminho absoluto ou comece-o com `~`, porque o Claude Code ignora caminhos relativos. Requer Claude Code v2.1.280 ou posterior. Consulte [Carregar um plugin para uma sessão](/docs/pt/plugins/create#load-a-directory-or-archive-for-one-session) |354| `CLAUDE_CODE_PLUGIN_DIRS` | Diretórios de plugins a carregar para a sessão, cada um carregado da mesma forma que uma flag [`--plugin-dir`](/docs/pt/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) o carrega. Separe vários caminhos com `:` no Unix ou `;` no Windows. Informe cada caminho como um caminho absoluto ou comece-o com `~`, porque o Claude Code ignora caminhos relativos. Requer Claude Code v2.1.280 ou posterior. Consulte [Carregar um plugin para uma sessão](/docs/pt/plugins/create#load-a-directory-or-archive-for-one-session) |

353| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout em milissegundos para clonar ou atualizar um marketplace de plugins (padrão: 120000). Aumente este valor para repositórios grandes ou conexões de rede lentas. Consulte [Git clone timed out](/docs/pt/plugins/troubleshooting#git-clone-timed-out-after-120s) |355| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout em milissegundos para clonar ou atualizar um marketplace de plugins (padrão: 120000). Aumente este valor para repositórios grandes ou conexões de rede lentas. Consulte [Git clone timed out](/docs/pt/plugins/troubleshooting#git-clone-timed-out-after-120s) |

354| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Defina como `1` para pular a tentativa de clonar novamente e continuar usando o checkout existente do marketplace quando uma atualização do marketplace não consegue alcançar o remoto ou se autenticar nele. Útil em ambientes offline ou isolados (airgapped), onde clonar novamente falharia da mesma forma. Consulte [Atualizações do marketplace falham em ambientes offline](/docs/pt/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |356| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Defina como `1` para pular a tentativa de clonar novamente e continuar usando o checkout existente do marketplace quando uma atualização do marketplace não conseguir alcançar o remoto ou se autenticar nele. Útil em ambientes offline ou isolados (airgapped), em que clonar novamente falharia da mesma forma. Consulte [Atualizações do marketplace falham em ambientes offline](/docs/pt/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

355| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Defina como `1` para clonar fontes abreviadas `owner/repo` do GitHub via HTTPS em vez de SSH. Aplica-se à instalação e atualização de plugins, e a `/plugin marketplace add` e `update`. Útil em runners de CI, contêineres ou qualquer ambiente sem uma chave SSH configurada para `github.com` |357| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Defina como `1` para clonar fontes abreviadas `owner/repo` do GitHub via HTTPS em vez de SSH. Aplica-se à instalação e à atualização de plugins, e a `/plugin marketplace add` e `update`. Útil em runners de CI, contêineres ou qualquer ambiente sem uma chave SSH configurada para `github.com` |

356| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Caminho para um ou mais diretórios seed de plugins somente leitura, separados por `:` no Unix ou `;` no Windows. Use para incluir um diretório de plugins pré-preenchido em uma imagem de contêiner. O Claude Code registra marketplaces a partir desses diretórios na inicialização e usa plugins já armazenados em cache sem clonar novamente. Consulte [Pré-preencher plugins para contêineres](/docs/pt/plugins/org#seed-containers-and-ci) |358| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Caminho para um ou mais diretórios seed de plugins somente leitura, separados por `:` no Unix ou `;` no Windows. Use isso para incluir um diretório de plugins pré-preenchido em uma imagem de contêiner. O Claude Code registra os marketplaces a partir desses diretórios na inicialização e usa os plugins já armazenados em cache sem clonar novamente. Consulte [Pré-preencher plugins para contêineres](/docs/pt/plugins/org#seed-containers-and-ci) |

357| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Defina como `1` para impedir que o Claude Code passe `-ExecutionPolicy Bypass` ao iniciar o PowerShell para chamadas de ferramenta, hooks e comandos da linha de status, e respeitar a política de execução efetiva da máquina. Por padrão, o Claude Code contorna a política de execução no escopo do processo para que scripts `.ps1` e importações de módulos funcionem em instalações do Windows com o padrão Restricted. O bypass no escopo do processo nunca sobrescreve `MachinePolicy` ou `UserPolicy` da Política de Grupo, independentemente desta configuração |359| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Defina como `1` para impedir que o Claude Code passe `-ExecutionPolicy Bypass` ao iniciar o PowerShell para chamadas de ferramenta, hooks e comandos da linha de status, respeitando em vez disso a política de execução efetiva da máquina. Por padrão, o Claude Code ignora a política de execução no escopo do processo para que scripts `.ps1` e importações de módulos funcionem em instalações do Windows com o padrão Restricted. O bypass no escopo do processo nunca sobrescreve `MachinePolicy` ou `UserPolicy` da Política de Grupo, independentemente desta configuração |

358| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Limite máximo, em milissegundos, da espera ociosa por subagentes e fluxos de trabalho em segundo plano após o turno final no [modo não interativo](/docs/pt/headless#background-tasks-at-exit) com a flag `-p`. A espera ociosa recomeça cada vez que Claude executa um turno para tratar um resultado em segundo plano. Padrão: `600000`, ou 10 minutos. Quando a espera ociosa atinge o limite, o Claude Code para de aguardar as tarefas em segundo plano restantes e encerra. Defina como `0` para aguardar indefinidamente. Este limite é separado do período de tolerância de cinco segundos que se aplica a shells simples em segundo plano. Requer Claude Code v2.1.182 ou posterior |360| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Limite máximo, em milissegundos, para a espera ociosa por subagentes e workflows em segundo plano após o turno final no [modo não interativo](/docs/pt/headless#background-tasks-at-exit) com a flag `-p`. A espera ociosa recomeça cada vez que Claude usa um turno para lidar com um resultado em segundo plano. Padrão: `600000`, ou 10 minutos. Quando a espera ociosa atinge o limite, o Claude Code para de aguardar as tarefas em segundo plano restantes e sai. Defina como `0` para aguardar indefinidamente. Esse limite é separado do período de carência de cinco segundos que se aplica a shells simples em segundo plano. Requer Claude Code v2.1.182 ou posterior |

359| `CLAUDE_CODE_PROCESS_WRAPPER` | Inicia os processos que o Claude Code inicia a partir do seu próprio binário, como o serviço em segundo plano que hospeda as sessões da [visualização de agentes](/docs/pt/agent-view), por meio de um inicializador corporativo informado como prefixo argv, como `/opt/corp/launcher`. Defina-a no bloco `env` das configurações de usuário ou das [configurações gerenciadas](/docs/pt/managed-settings), não como um export do shell, para que o serviço em segundo plano desanexado a herde; configurações de projeto e locais não podem defini-la. Equivalente à [configuração `processWrapper`](/docs/pt/settings-reference#processwrapper), que requer Claude Code v2.1.210 ou posterior; esta variável tem precedência quando ambas estão definidas. A extensão do VS Code configura seu próprio inicializador separadamente por meio da configuração `claudeProcessWrapper`. Ignorada no Windows. Consulte [Executar o Claude Code por trás de um inicializador corporativo](/docs/pt/corporate-launcher) para o formato do valor, o que o inicializador abrange e o contrato que ele deve cumprir. Requer Claude Code v2.1.208 ou posterior |361| `CLAUDE_CODE_PROCESS_WRAPPER` | Inicia os processos que o Claude Code cria a partir do seu próprio binário, como o serviço em segundo plano que hospeda as sessões do [agent view](/docs/pt/agent-view), por meio de um inicializador corporativo informado como prefixo argv, como `/opt/corp/launcher`. Defina-a no bloco `env` das configurações de usuário ou das [configurações gerenciadas](/docs/pt/managed-settings), não como uma exportação do shell, para que o serviço em segundo plano desanexado a herde; as configurações de projeto e locais não podem defini-la. Equivalente à [configuração `processWrapper`](/docs/pt/settings-reference#processwrapper), que requer Claude Code v2.1.210 ou posterior; esta variável tem precedência quando ambas estão definidas. A extensão do VS Code configura seu próprio inicializador separadamente por meio da configuração `claudeProcessWrapper`. Ignorada no Windows. Consulte [Executar o Claude Code por trás de um inicializador corporativo](/docs/pt/corporate-launcher) para saber o formato do valor, o que o inicializador abrange e o contrato que o inicializador deve cumprir. Requer Claude Code v2.1.208 ou posterior |

360| `CLAUDE_CODE_PROJECT_DIR_NAME` | Defina junto com `CLAUDE_CONFIG_DIR` para escolher o nome do diretório em `projects/` no qual o Claude Code armazena as transcrições e a memória automática dessa sessão, no lugar de um nome derivado do caminho do diretório de trabalho. Por exemplo, iniciar o Claude Code com `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` as armazena em `/srv/tenant-a/projects/work/`. O Claude Code ignora esta variável quando `CLAUDE_CONFIG_DIR` não está definida e a lê apenas do ambiente a partir do qual você inicia `claude`, nunca de um [bloco `env` de arquivo de configurações](#in-settings-files). Consulte [Nomear o diretório do projeto você mesmo](/docs/pt/sessions#name-the-project-directory-yourself). Requer Claude Code v2.1.234 ou posterior |362| `CLAUDE_CODE_PROJECT_DIR_NAME` | Defina junto com `CLAUDE_CONFIG_DIR` para escolher o nome do diretório em `projects/` sob o qual o Claude Code armazena as transcrições e a memória automática dessa sessão, no lugar de um nome derivado do caminho do diretório de trabalho. Por exemplo, iniciar o Claude Code com `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` as armazena em `/srv/tenant-a/projects/work/`. O Claude Code ignora esta variável quando `CLAUDE_CONFIG_DIR` não está definida, e a lê apenas do ambiente a partir do qual você inicia `claude`, nunca de um [bloco `env` de arquivo de configurações](#in-settings-files). Consulte [Nomear o diretório do projeto por conta própria](/docs/pt/sessions#name-the-project-directory-yourself). Requer Claude Code v2.1.234 ou posterior |

361| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Defina `5m` ou `1h`, os únicos valores que o Claude Code aceita, para escolher o [TTL do cache de prompt](/docs/pt/prompt-caching#cache-lifetime) da conversa principal: seus turnos interativos, de `-p` e do SDK, além dos auxiliares executados junto com eles. Tem precedência sobre a configuração `promptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a sobrescreve. A API cobra gravações de cache de 1 hora a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior |363| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Defina `5m` ou `1h`, os únicos valores que o Claude Code aceita, para escolher o [TTL do cache de prompt](/docs/pt/prompt-caching#cache-lifetime) da conversa principal: seus turnos interativos, `-p` e do SDK, além dos auxiliares executados inline com eles. Tem precedência sobre a configuração `promptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a sobrescreve. A API cobra gravações de cache de 1 hora a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior |

362| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Defina como `1` para propagar o contexto de rastreamento W3C quando `ANTHROPIC_BASE_URL` aponta para um proxy personalizado. A propagação abrange o cabeçalho `traceparent` em requisições de modelo e de MCP HTTP e a variável de ambiente `TRACEPARENT` para subprocessos de Bash, PowerShell e hooks. Por padrão, a propagação é ativada apenas quando há conexão direta com a API da Anthropic. Adicionada na v2.1.152. Consulte [Traces (beta)](/docs/pt/monitoring-usage#traces-beta) |364| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Defina como `1` para propagar o contexto de trace W3C quando `ANTHROPIC_BASE_URL` apontar para um proxy personalizado. A propagação abrange o cabeçalho `traceparent` em requisições ao modelo e a MCP HTTP, e a variável de ambiente `TRACEPARENT` para subprocessos Bash, PowerShell e de hooks. Por padrão, a propagação fica ativada apenas quando há conexão direta com a API da Anthropic. Adicionada na v2.1.152. Consulte [Traces (beta)](/docs/pt/monitoring-usage#traces-beta) |

363| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Definida por plataformas host que incorporam o Claude Code e gerenciam o roteamento do provedor de modelos em seu nome. Quando definida, o Claude Code ignora variáveis de seleção de provedor, endpoint e autenticação, como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY`, em arquivos de configurações, para que as configurações de usuário não possam sobrescrever o roteamento do host. O Claude Code também ignora chaves de seleção de modelo, como `model`, `fallbackModel` e `modelOverrides`, nas [configurações gerenciadas](/docs/pt/managed-settings), qualquer que seja a fonte gerenciada que as entregue, para que a configuração de modelos do host tenha precedência sobre uma fixação de modelo gerenciada desatualizada. O Claude Code também ignora variáveis de seleção de modelo, como `ANTHROPIC_MODEL` e a família `ANTHROPIC_DEFAULT_*_MODEL`, em um bloco `env` gerenciado; uma allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) nas configurações gerenciadas ainda se aplica, a menos que o host forneça a sua própria. O Claude Code também pula a desativação automática de telemetria que, de outra forma, aplica em provedores terceirizados como Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud e Microsoft Foundry, então a telemetria segue a desativação padrão por `DISABLE_TELEMETRY`. Consulte [Comportamentos padrão por provedor de API](/docs/pt/data-usage#default-behaviors-by-api-provider) |365| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Definida por plataformas host que incorporam o Claude Code e gerenciam o roteamento do provedor de modelo em nome dele. Quando definida, o Claude Code ignora variáveis de seleção de provedor, endpoint e autenticação, como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY`, em arquivos de configurações, para que as configurações de usuário não possam sobrescrever o roteamento do host. O Claude Code também ignora chaves de seleção de modelo, como `model`, `fallbackModel` e `modelOverrides`, nas [configurações gerenciadas](/docs/pt/managed-settings), qualquer que seja a fonte gerenciada que as entregue, para que a configuração de modelo do host tenha precedência sobre uma fixação de modelo gerenciada desatualizada. O Claude Code também ignora variáveis de seleção de modelo, como `ANTHROPIC_MODEL` e a família `ANTHROPIC_DEFAULT_*_MODEL`, em um bloco `env` gerenciado; uma allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) nas configurações gerenciadas ainda se aplica, a menos que o host forneça a sua própria. O Claude Code também pula a desativação automática de telemetria que, de outra forma, aplica em provedores terceirizados, como Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, então a telemetria segue a desativação padrão via `DISABLE_TELEMETRY`. Consulte [Comportamentos padrão por provedor de API](/docs/pt/data-usage#default-behaviors-by-api-provider) |

364| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy realize a resolução de DNS em vez do chamador. Opcional, para ambientes em que o proxy deve lidar com a resolução de nomes de host |366| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy realize a resolução de DNS em vez do chamador. Opcional para ambientes em que o proxy deve lidar com a resolução de nomes de host |

365| `CLAUDE_CODE_REMOTE` | Definida automaticamente como `true` quando o Claude Code está sendo executado como uma [sessão na nuvem](/docs/pt/claude-code-on-the-web). Leia-a a partir de um hook ou script de configuração para detectar se você está em uma sessão na nuvem |367| `CLAUDE_CODE_REMOTE` | Definida automaticamente como `true` quando o Claude Code está sendo executado como uma [sessão na nuvem](/docs/pt/claude-code-on-the-web). Leia-a a partir de um hook ou script de configuração para detectar se você está em uma sessão na nuvem |

366| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definida automaticamente em [sessões na nuvem](/docs/pt/claude-code-on-the-web) com o ID da sessão atual. Leia-a para construir um link de volta à transcrição da sessão. Consulte [Vincular a saída de volta à sessão](/docs/pt/cloud-environments#link-output-back-to-the-session) |368| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definida automaticamente em [sessões na nuvem](/docs/pt/claude-code-on-the-web) com o ID da sessão atual. Leia-a para construir um link de volta para a transcrição da sessão. Consulte [Vincular a saída de volta à sessão](/docs/pt/cloud-environments#link-output-back-to-the-session) |

367| `CLAUDE_CODE_RESTRICTED` | Defina como `1` para iniciar a sessão no modo restrito, o mesmo que passar [`--restricted`](/docs/pt/cli-reference#cli-flags). O Claude Code ignora esta variável no bloco `env` de um arquivo de configurações. Requer Claude Code v2.1.248 ou posterior |369| `CLAUDE_CODE_RESTRICTED` | Defina como `1` para iniciar a sessão no modo restrito, o mesmo que passar [`--restricted`](/docs/pt/cli-reference#cli-flags). O Claude Code ignora esta variável no bloco `env` de um arquivo de configurações. Requer Claude Code v2.1.248 ou posterior |

368| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Defina como `1` para retomar automaticamente se a sessão anterior terminou no meio de um turno. Usada no modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt. Para desativar, remova a definição da variável ou defina-a como `0`. Para o painel de chat do VS Code, consulte [Continuar conversas após recarregar](/docs/pt/vs-code#continue-conversations-after-a-reload) |370| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Defina como `1` para retomar automaticamente se a sessão anterior terminou no meio de um turno. Usada no modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt. Para desativar, remova a definição da variável ou defina-a como `0`. Para o painel de chat do VS Code, consulte [Continuar conversas após um recarregamento](/docs/pt/vs-code#continue-conversations-after-a-reload) |

369| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Idade máxima, em milissegundos, da última mensagem da transcrição para que uma sessão que terminou no meio de um turno continue automaticamente ao ser retomada. Quando a última mensagem é mais antiga que esse limite, o Claude Code pula a retomada automática de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e sua mensagem de continuação `CLAUDE_CODE_RESUME_PROMPT`, e a sessão inicia ociosa para que você continue explicitamente. Não definida ou `0` significa sem limite, exceto que um turno cuja última requisição falhou com um erro de API é retomado apenas enquanto esse erro tiver menos de seis horas. Um valor positivo limita todos os turnos, incluindo esses; um valor negativo ou não numérico aplica um limite de uma hora. Scripts de inicialização de agentes de longa duração podem defini-la para que uma reinicialização com uma transcrição antiga não execute novamente um prompt desatualizado. O próprio Claude Code define um limite de uma hora quando reinicia uma sessão da [visualização de agentes](/docs/pt/agent-view) que travou e que herdou sua conversa de uma sessão interativa. Requer Claude Code v2.1.211 ou posterior |371| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Idade máxima, em milissegundos, da última mensagem da transcrição para que uma sessão que terminou no meio de um turno continue automaticamente ao ser retomada. Quando a última mensagem é mais antiga que esse limite, o Claude Code pula a retomada automática de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e sua mensagem de continuação `CLAUDE_CODE_RESUME_PROMPT`, e a sessão começa ociosa para que você continue explicitamente. Não definida ou `0` significa sem limite, exceto que um turno cuja última requisição falhou com um erro de API só é retomado enquanto esse erro tiver menos de seis horas. Um valor positivo limita todos os turnos, inclusive esses; um valor negativo ou não numérico aplica um limite de uma hora. Scripts de inicialização de agentes de longa duração podem definir isso para que uma reinicialização a partir de uma transcrição antiga não execute novamente um prompt obsoleto. O próprio Claude Code define um limite de uma hora quando reinicia uma sessão do [agent view](/docs/pt/agent-view) que travou e que herdou sua conversa de uma sessão interativa. Requer Claude Code v2.1.211 ou posterior |

370| `CLAUDE_CODE_RESUME_PROMPT` | Sobrescreve a mensagem de continuação que o Claude Code envia a Claude quando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continua um turno interrompido em vez de reenviar seu prompt, ou quando você retoma uma [chamada de ferramenta adiada](/docs/pt/hooks#defer-a-tool-call-for-later) com `-p`. O padrão é `Continue from where you left off.`. Uma string vazia usa o padrão |372| `CLAUDE_CODE_RESUME_PROMPT` | Sobrescreve a mensagem de continuação que o Claude Code envia a Claude quando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continua um turno interrompido em vez de reenviar seu prompt, ou quando você retoma uma [chamada de ferramenta adiada](/docs/pt/hooks#defer-a-tool-call-for-later) com `-p`. O padrão é `Continue from where you left off.`. Uma string vazia usa o padrão |

371| `CLAUDE_CODE_RETRY_WATCHDOG` | Defina como `1` para sessões não supervisionadas, como harnesses de avaliação, jobs de CI ou workers remotos. Tenta novamente erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. O Claude Code falha imediatamente quando uma requisição de velocidade padrão recebe um `429` que informa um limite de gastos ou créditos de uso esgotados, mesmo que venha de um [limite de gastos do gateway](/docs/pt/errors#spend-limit-reached) que é redefinido periodicamente. Antes da v2.1.239, o watchdog tentava novamente esses erros indefinidamente. Para requisições no modo rápido, consulte [Lidar com rate limits](/docs/pt/fast-mode#handle-rate-limits). O watchdog aguarda até 5 minutos entre as tentativas, ou até o limite ser redefinido quando a resposta traz um horário de redefinição do rate limit, para que uma sessão que atinge um limite de uso aguarde o restante da janela. Na v2.1.199 ou posterior, ele também aumenta a contagem padrão de novas tentativas para outros erros transitórios, como erros de servidor, timeouts e conexões interrompidas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. Requer Claude Code v2.1.186 ou posterior |373| `CLAUDE_CODE_RETRY_WATCHDOG` | Defina como `1` para sessões não supervisionadas, como harnesses de avaliação, jobs de CI ou workers remotos. Tenta novamente erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. O Claude Code falha imediatamente quando uma requisição de velocidade padrão recebe um `429` que informa um limite de gastos ou créditos de uso esgotados, mesmo que venha de um [limite de gastos do gateway](/docs/pt/errors#spend-limit-reached) que é redefinido periodicamente. Antes da v2.1.239, o watchdog tentava novamente esses erros indefinidamente. Para requisições no modo rápido, consulte [Lidar com rate limits](/docs/pt/fast-mode#handle-rate-limits). O watchdog aguarda até 5 minutos entre as tentativas, ou até a redefinição do limite quando a resposta informa um horário de redefinição do rate limit, para que uma sessão que atinge um limite de uso aguarde o restante da janela. Na v2.1.199 ou posterior, ele também aumenta o número padrão de novas tentativas para outros erros transitórios, como erros de servidor, timeouts e conexões interrompidas, para 300, cerca de três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. Requer Claude Code v2.1.186 ou posterior |

372| `CLAUDE_CODE_SAFE_MODE` | Defina como `1` para iniciar no modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, fluxos de trabalho, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e de sugestão de arquivos, servidores LSP e memória automática não são carregados, para solucionar problemas de uma configuração quebrada. A política de configurações gerenciadas ainda se aplica, incluindo hooks, linha de status e comandos de sugestão de arquivos configurados por política; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não se aplicam. Equivalente a passar [`--safe-mode`](/docs/pt/cli-reference#cli-flags). Processos filhos iniciados diretamente herdam a variável |374| `CLAUDE_CODE_SAFE_MODE` | Defina como `1` para iniciar no modo de segurança: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos da linha de status e de sugestão de arquivos, servidores LSP e memória automática não são carregados, para solucionar problemas de uma configuração com defeito. A política de configurações gerenciadas ainda se aplica, incluindo hooks, linha de status e comandos de sugestão de arquivos configurados por política; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Equivalente a passar [`--safe-mode`](/docs/pt/cli-reference#cli-flags). Processos filhos iniciados diretamente herdam a variável |

373| `CLAUDE_CODE_SCRIPT_CAPS` | Objeto JSON que limita quantas vezes scripts específicos podem ser invocados por sessão quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` está definida. As chaves são substrings comparadas com o texto do comando; os valores são limites inteiros de chamadas. Por exemplo, `{"deploy.sh": 2}` permite que `deploy.sh` seja chamado no máximo duas vezes. A correspondência é baseada em substrings, então truques de expansão do shell como `./scripts/deploy.sh $(evil)` ainda contam para o limite. A multiplicação em tempo de execução via `xargs` ou `find -exec` não é detectada; este é um controle de defesa em profundidade |375| `CLAUDE_CODE_SCRIPT_CAPS` | Objeto JSON que limita quantas vezes scripts específicos podem ser invocados por sessão quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` está definida. As chaves são substrings comparadas com o texto do comando; os valores são limites inteiros de chamadas. Por exemplo, `{"deploy.sh": 2}` permite que `deploy.sh` seja chamado no máximo duas vezes. A correspondência é baseada em substrings, então truques de expansão do shell como `./scripts/deploy.sh $(evil)` ainda contam para o limite. O fan-out em tempo de execução via `xargs` ou `find -exec` não é detectado; este é um controle de defesa em profundidade |

374| `CLAUDE_CODE_SCROLL_SPEED` | Define o multiplicador de rolagem da roda do mouse na [renderização em tela cheia](/docs/pt/fullscreen#mouse-wheel-scrolling). Aceita qualquer valor positivo até 20, incluindo valores fracionários abaixo de 1, como `0.5`, para desacelerar a rolagem acelerada do trackpad e da roda em terminais que já amplificam os eventos da roda. Defina como `3` para corresponder ao `vim` se o seu terminal envia um evento de roda por entalhe sem amplificação. Ignorada no terminal dos IDEs JetBrains, em que o Claude Code usa seu próprio tratamento de rolagem |376| `CLAUDE_CODE_SCROLL_SPEED` | Define o multiplicador de rolagem da roda do mouse na [renderização em tela cheia](/docs/pt/fullscreen#mouse-wheel-scrolling). Aceita qualquer valor positivo até 20, incluindo valores fracionários abaixo de 1, como `0.5`, para desacelerar a rolagem acelerada do trackpad e da roda em terminais que já amplificam os eventos da roda. Defina como `3` para corresponder ao `vim` se o seu terminal enviar um evento de roda por entalhe sem amplificação. Ignorada no terminal do IDE JetBrains, em que o Claude Code usa seu próprio tratamento de rolagem |

375| `CLAUDE_CODE_SEND_FEEDBACK` | Defina como `0` para desativar o [feedback redigido por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior) para uma sessão. Defina como `1` para ativá-lo onde sua conta já tem acesso; a variável não pode conceder acesso por si só, e os outros controles que desativam o feedback, como `DISABLE_FEEDBACK_COMMAND` e o valor `off` da configuração [`feedbackDrafts`](/docs/pt/settings-reference#feedbackdrafts), ainda se aplicam |377| `CLAUDE_CODE_SEND_FEEDBACK` | Defina como `0` para desativar o [feedback redigido por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior) em uma sessão. Defina como `1` para ativá-lo onde sua conta já tem acesso; a variável não pode conceder acesso por si só, e as outras opções que desativam o feedback, como `DISABLE_FEEDBACK_COMMAND` e o valor `off` da configuração [`feedbackDrafts`](/docs/pt/settings-reference#feedbackdrafts), ainda se aplicam |

376| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sobrescreve o orçamento de tempo, em milissegundos, para hooks [SessionEnd](/docs/pt/hooks#sessionend). O valor também é o timeout de cada hook que não define seu próprio `timeout`. Aplica-se à saída da sessão, a `/clear` e à troca de sessões via `/resume` interativo. Por padrão, o orçamento é de 1,5 segundo, elevado automaticamente para o maior `timeout` por hook configurado em arquivos de configurações, até 60 segundos. Timeouts em hooks fornecidos por plugins não aumentam o orçamento |378| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sobrescreve o orçamento de tempo, em milissegundos, para hooks [SessionEnd](/docs/pt/hooks#sessionend). O valor também é o timeout de cada hook que não define seu próprio `timeout`. Aplica-se à saída da sessão, a `/clear` e à troca de sessões via `/resume` interativo. Por padrão, o orçamento é de 1,5 segundo, elevado automaticamente ao maior `timeout` por hook configurado em arquivos de configurações, até 60 segundos. Timeouts em hooks fornecidos por plugins não aumentam o orçamento |

377| `CLAUDE_CODE_SESSION_ID` | Definida automaticamente com o ID da sessão atual em subprocessos das ferramentas Bash e PowerShell, em subprocessos de [comandos de hook](/docs/pt/hooks) e em subprocessos de [servidores MCP](/docs/pt/mcp) stdio. Para Bash, PowerShell e hooks, corresponde ao campo `session_id` na entrada JSON do hook e é atualizada em `/clear`. Um subprocesso de servidor MCP mantém o ID com o qual foi iniciado. Em `--resume <session-id>`, ele recebe o ID retomado, correspondendo aos hooks e ao Bash. Em `--continue` ou `--resume` sem um ID explícito, ele pode receber o ID da inicialização original. Use para correlacionar scripts e ferramentas externas com a sessão do Claude Code que os iniciou |379| `CLAUDE_CODE_SESSION_ID` | Definida automaticamente com o ID da sessão atual em subprocessos das ferramentas Bash e PowerShell, em subprocessos de [comandos de hook](/docs/pt/hooks) e em subprocessos de [servidores MCP](/docs/pt/mcp) stdio. Para Bash, PowerShell e hooks, corresponde ao campo `session_id` na entrada JSON do hook e é atualizada em `/clear`. Um subprocesso de servidor MCP mantém o ID com o qual foi iniciado. Em `--resume <session-id>`, ele recebe o ID retomado, correspondendo a hooks e Bash. Em `--continue` ou `--resume` sem um ID explícito, ele pode receber o ID inicial da inicialização em vez disso. Use para correlacionar scripts e ferramentas externas com a sessão do Claude Code que os iniciou |

378| `CLAUDE_CODE_SHELL` | Define o shell que o Claude Code usa para executar comandos da ferramenta Bash. Aceita um caminho para um binário `bash` ou `zsh`, por exemplo `/opt/homebrew/bin/bash`. Outros shells, como `fish`, não são suportados. Se o valor não for um caminho funcional de `bash` ou `zsh`, o Claude Code o ignora e recorre à detecção automática. A detecção automática usa seu `$SHELL` quando ele aponta para `bash` ou `zsh`; caso contrário, escolhe o primeiro `zsh` funcional e, depois, `bash` encontrado no seu `PATH` e nos locais de instalação padrão |380| `CLAUDE_CODE_SHELL` | Define o shell que o Claude Code usa para executar comandos da ferramenta Bash. Aceita um caminho para um binário `bash` ou `zsh`, por exemplo `/opt/homebrew/bin/bash`. Outros shells, como `fish`, não são suportados. Se o valor não for um caminho funcional de `bash` ou `zsh`, o Claude Code o ignora e recorre à detecção automática. A detecção automática usa seu `$SHELL` quando ele aponta para `bash` ou `zsh`; caso contrário, escolhe o primeiro `zsh` e depois o primeiro `bash` funcionais encontrados no seu `PATH` e em locais de instalação padrão |

379| `CLAUDE_CODE_SHELL_PREFIX` | Prefixo de comando que envolve os comandos de shell que o Claude Code inicia: chamadas da ferramenta Bash, comandos de [hook](/docs/pt/hooks), comandos da [linha de status](/docs/pt/statusline) e comandos de inicialização de [servidores MCP](/docs/pt/mcp) stdio. Hooks do PowerShell e hooks em formato exec são executados sem o prefixo. Útil para logging ou auditoria. Definir um caminho de executável simples, como `/path/to/logger.sh`, executa cada comando como `/path/to/logger.sh '<command>'`. O wrapper recebe a linha de comando como um único argumento entre aspas do shell em `$1`, então o wrapper deve reavaliar `$1` com um shell, por exemplo `exec bash -c "$1"`. Tratar `$1` como um caminho de executável simples quebra servidores MCP stdio que passam argumentos como `npx -y <package>`. Para chamadas da ferramenta Bash, `$1` contém a invocação completa do shell que o Claude Code monta, incluindo a configuração do ambiente, não apenas o comando que Claude executou |381| `CLAUDE_CODE_SHELL_PREFIX` | Prefixo de comando que envolve os comandos de shell que o Claude Code inicia: chamadas da ferramenta Bash, comandos de [hook](/docs/pt/hooks), comandos da [linha de status](/docs/pt/statusline) e comandos de inicialização de [servidores MCP](/docs/pt/mcp) stdio. Hooks do PowerShell e hooks no formato exec são executados sem o prefixo. Útil para logs ou auditoria. Definir um caminho de executável simples, como `/path/to/logger.sh`, executa cada comando como `/path/to/logger.sh '<command>'`. O wrapper recebe a linha de comando como um único argumento entre aspas de shell em `$1`, então o wrapper deve reavaliar `$1` com um shell, por exemplo `exec bash -c "$1"`. Tratar `$1` como um caminho de executável simples quebra servidores MCP stdio que passam argumentos como `npx -y <package>`. Para chamadas da ferramenta Bash, `$1` contém a invocação completa do shell que o Claude Code monta, incluindo a configuração do ambiente, e não apenas o comando que Claude executou |

380| `CLAUDE_CODE_SIMPLE` | Defina como `1` para executar com um system prompt mínimo e apenas as ferramentas Bash, de leitura de arquivos e de edição de arquivos. As ferramentas MCP de `--mcp-config` continuam disponíveis. Desativa a descoberta automática de hooks, skills, comandos personalizados, subagentes, plugins instalados, servidores MCP, memória automática e CLAUDE.md. Skills em um diretório que você passa com `--add-dir` ainda são carregadas. Tokens OAuth e credenciais do keychain não são lidos, então a autenticação da Anthropic deve vir de `ANTHROPIC_API_KEY` ou de um `apiKeyHelper` em `--settings`. Equivalente a passar [`--bare`](/docs/pt/headless#start-faster-with-bare-mode) |382| `CLAUDE_CODE_SIMPLE` | Defina como `1` para executar com um system prompt mínimo e apenas as ferramentas Bash, de leitura de arquivos e de edição de arquivos. As ferramentas MCP de `--mcp-config` continuam disponíveis. Desativa a descoberta automática de hooks, skills, comandos personalizados, subagentes, plugins instalados, servidores MCP, memória automática e CLAUDE.md. Skills em um diretório que você passa com `--add-dir` ainda são carregadas. Tokens OAuth e credenciais do keychain não são lidos, então a autenticação na Anthropic deve vir de `ANTHROPIC_API_KEY` ou de um `apiKeyHelper` em `--settings`. Equivalente a passar [`--bare`](/docs/pt/headless#start-faster-with-bare-mode) |

381| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Defina como `1` para usar um system prompt mais curto e descrições de ferramentas abreviadas em qualquer modelo. Defina como `0`, `false`, `no` ou `off` para desativar, mesmo em modelos em que o experimento ou a configuração do servidor o ativariam. O conjunto completo de ferramentas, os hooks, os servidores MCP e a descoberta de CLAUDE.md permanecem ativados |383| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Defina como `1` para usar um system prompt mais curto e descrições de ferramentas abreviadas em qualquer modelo. Defina como `0`, `false`, `no` ou `off` para desativar mesmo em modelos em que o experimento ou a configuração do servidor o ativaria de outra forma. O conjunto completo de ferramentas, os hooks, os servidores MCP e a descoberta de CLAUDE.md permanecem ativados |

382| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Pula a autenticação do lado do cliente para o [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), para gateways que assinam as requisições por conta própria |384| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Pula a autenticação no lado do cliente para o [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), para gateways que assinam as requisições por conta própria |

383| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Defina como `1` para desativar o cache em processo das credenciais resolvidas a partir da cadeia de provedores de credenciais padrão da AWS, para que o Claude Code resolva a cadeia a cada requisição de API. Com o cache desativado, um perfil baseado em SSO solicita credenciais ao IAM Identity Center a cada requisição. Consulte [cache de credenciais e timeout de resolução](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout). Requer Claude Code v2.1.207 ou posterior |385| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Defina como `1` para desativar o cache em processo das credenciais resolvidas a partir da cadeia padrão de provedores de credenciais da AWS, para que o Claude Code resolva a cadeia em cada requisição de API. Com o cache desativado, um perfil baseado em SSO solicita credenciais ao IAM Identity Center em cada requisição. Consulte [cache de credenciais e timeout de resolução](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout). Requer Claude Code v2.1.207 ou posterior |

384| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Pula a autenticação da AWS para o Amazon Bedrock (por exemplo, ao usar um gateway de LLM) |386| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Pula a autenticação da AWS para o Amazon Bedrock (por exemplo, ao usar um gateway de LLM) |

385| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Defina como `1` para tratar uma verificação de disponibilidade do [modo rápido](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) com falha como disponível, para redes que bloqueiam a requisição direta da verificação para `api.anthropic.com`. O Claude Code ainda respeita uma resposta "disabled by your organization" |387| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Defina como `1` para tratar uma verificação de disponibilidade do [modo rápido](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) com falha como disponível, para redes que bloqueiam a requisição direta da verificação para `api.anthropic.com`. O Claude Code ainda respeita uma resposta "disabled by your organization" |

386| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Defina como `1` para pular a verificação de disponibilidade do [modo rápido](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) do lado do cliente, para proxies que interceptam a requisição da verificação em vez de recusá-la. A API ainda rejeita requisições no modo rápido quando sua organização tem o modo rápido desativado |388| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Defina como `1` para pular a verificação de disponibilidade do [modo rápido](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) no lado do cliente, para proxies que interceptam a requisição da verificação em vez de recusá-la. A API ainda rejeita requisições no modo rápido quando sua organização tem o modo rápido desativado |

387| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Pula a autenticação do Azure para o Microsoft Foundry, para um proxy ou gateway que injeta seu próprio cabeçalho `Authorization`. O Claude Code envia as requisições sem uma credencial do Azure e preserva o cabeçalho `Authorization` que você fornece, por exemplo por meio de `ANTHROPIC_CUSTOM_HEADERS`. Ignorada quando `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` está definida. Antes da v2.1.203, esta variável deixava o cliente do Microsoft Foundry incapaz de enviar requisições, a menos que uma chave de API também estivesse definida |389| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Pula a autenticação do Azure para o Microsoft Foundry, para um proxy ou gateway que injeta seu próprio cabeçalho `Authorization`. O Claude Code envia requisições sem uma credencial do Azure e preserva o cabeçalho `Authorization` que você fornece, por exemplo por meio de `ANTHROPIC_CUSTOM_HEADERS`. Ignorada quando `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` está definida. Antes da v2.1.203, esta variável deixava o cliente do Microsoft Foundry incapaz de enviar requisições, a menos que uma chave de API também estivesse definida |

388| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Pula a autenticação da AWS para o Amazon Bedrock Mantle (por exemplo, ao usar um gateway de LLM) |390| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Pula a autenticação da AWS para o Amazon Bedrock Mantle (por exemplo, ao usar um gateway de LLM) |

389| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | As [verificações de modelos na inicialização](/docs/pt/amazon-bedrock#startup-model-checks) no [Amazon Bedrock](/docs/pt/amazon-bedrock) e no [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) lembram, nesta máquina, quais modelos elas descobriram que sua conta não pode invocar, por até um dia. Defina como `1` para desativar essa memória. Requer Claude Code v2.1.285 ou posterior |391| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | As [verificações de modelo na inicialização](/docs/pt/amazon-bedrock#startup-model-checks) no [Amazon Bedrock](/docs/pt/amazon-bedrock) e no [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) lembram, nesta máquina, quais modelos elas descobriram que sua conta não pode invocar, por até um dia. Defina como `1` para desativar essa memória. Requer Claude Code v2.1.285 ou posterior |

390| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Defina como `1` para pular a gravação do histórico de prompts e das transcrições de sessão em disco. Sessões iniciadas com esta variável definida não aparecem em `--resume`, `--continue` nem no histórico da seta para cima. Útil para sessões efêmeras executadas por scripts |392| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Defina como `1` para pular a gravação do histórico de prompts e das transcrições de sessão no disco. Sessões iniciadas com esta variável definida não aparecem em `--resume`, `--continue` nem no histórico da seta para cima. Útil para sessões efêmeras executadas por scripts |

391| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Pula a autenticação do Google para o Agent Platform do Google Cloud (por exemplo, ao usar um gateway de LLM) |393| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Pula a autenticação do Google para o Google Cloud's Agent Platform (por exemplo, ao usar um gateway de LLM) |

392| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Defina como `1` para que uma sessão iniciada com `--output-format stream-json` grave uma [mensagem de resultado informando por que o Claude Code se recusou a iniciar](/docs/pt/agent-sdk/typescript#startup_failure_reason) para falhas de inicialização que, de outra forma, terminam apenas com stderr. Requer Claude Code v2.1.274 ou posterior |394| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Defina como `1` para que uma sessão iniciada com `--output-format stream-json` grave uma [mensagem de resultado informando por que o Claude Code se recusou a iniciar](/docs/pt/agent-sdk/typescript#startup_failure_reason) para falhas de inicialização que, de outra forma, terminam apenas com stderr. Requer Claude Code v2.1.274 ou posterior |

393| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Número máximo de vezes consecutivas que um hook [Stop](/docs/pt/hooks#stop) ou [SubagentStop](/docs/pt/hooks#subagentstop) pode impedir que o turno termine antes que o Claude Code o sobrescreva e encerre o turno mesmo assim (padrão: 8). Defina como `0` para desativar o limite. Aumente-o se o seu hook legitimamente precisar de mais iterações para chegar a uma conclusão |395| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Número máximo de vezes consecutivas que um hook [Stop](/docs/pt/hooks#stop) ou [SubagentStop](/docs/pt/hooks#subagentstop) pode impedir o término do turno antes que o Claude Code o sobrescreva e encerre o turno mesmo assim (padrão: 8). Defina como `0` para desativar o limite. Aumente-o se o seu hook legitimamente precisar de mais iterações para ser resolvido |

394| `CLAUDE_CODE_SUBAGENT_MODEL` | O modelo padrão para [subagentes](/docs/pt/sub-agents#choose-a-model), colegas de [equipe de agentes](/docs/pt/agent-teams#specify-teammates-and-models) e agentes de [fluxos de trabalho](/docs/pt/workflows) que não recebem um modelo de outra forma. Aceita um alias como `haiku` ou um nome completo de modelo. Duas fontes têm precedência sobre ela: um modelo que Claude passa ao gerar o agente e um campo `model` na definição do agente, incluindo `inherit`. Para mudar isso, defina [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/pt/sub-agents#run-every-subagent-on-one-model). Consulte [Escolher um modelo](/docs/pt/sub-agents#choose-a-model) para a ordem completa. Defini-la como `inherit` é o mesmo que deixá-la não definida. Antes da v2.1.251, esta variável sobrescrevia tanto o modelo por invocação quanto o campo `model` da definição |396| `CLAUDE_CODE_SUBAGENT_MODEL` | O modelo padrão para [subagentes](/docs/pt/sub-agents#choose-a-model), colegas de [equipes de agentes](/docs/pt/agent-teams#specify-teammates-and-models) e agentes de [workflows](/docs/pt/workflows) aos quais não é atribuído um modelo de outra forma. Aceita um alias como `haiku` ou um nome completo de modelo. Duas fontes têm precedência sobre ela: um modelo que Claude passa ao criar o agente e um campo `model` na definição do agente, incluindo `inherit`. Para mudar isso, defina [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/pt/sub-agents#run-every-subagent-on-one-model). Consulte [Escolher um modelo](/docs/pt/sub-agents#choose-a-model) para ver a ordem completa. Defini-la como `inherit` é o mesmo que deixá-la não definida. Antes da v2.1.251, esta variável sobrescrevia tanto o modelo por invocação quanto o campo `model` da definição |

395| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Defina como `1` para forçar um único modelo em subagentes, colegas de equipe e agentes de fluxos de trabalho. [Executar todos os subagentes em um único modelo](/docs/pt/sub-agents#run-every-subagent-on-one-model) informa qual é esse modelo. Requer Claude Code v2.1.257 ou posterior |397| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Defina como `1` para forçar um único modelo em subagentes, colegas de equipe e agentes de workflows. [Executar todos os subagentes em um único modelo](/docs/pt/sub-agents#run-every-subagent-on-one-model) indica qual é esse modelo. Requer Claude Code v2.1.257 ou posterior |

396| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Defina `5m` ou `1h`, os únicos valores que o Claude Code aceita, para escolher o [TTL do cache de prompt](/docs/pt/prompt-caching#cache-lifetime) para requisições fora da conversa principal, como [subagentes](/docs/pt/sub-agents), fluxos de trabalho e trabalho em segundo plano. Tem precedência sobre a configuração `subagentPromptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a sobrescreve. A API cobra gravações de cache de 1 hora a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior |398| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Defina `5m` ou `1h`, os únicos valores que o Claude Code aceita, para escolher o [TTL do cache de prompt](/docs/pt/prompt-caching#cache-lifetime) para requisições fora da conversa principal, como [subagentes](/docs/pt/sub-agents), workflows e trabalho em segundo plano. Tem precedência sobre a configuração `subagentPromptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a sobrescreve. A API cobra gravações de cache de 1 hora a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior |

397| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Defina como `1` para remover credenciais dos ambientes de subprocessos (ferramenta Bash, hooks, servidores MCP stdio): credenciais da Anthropic e de provedores de nuvem, qualquer outra variável que o Claude Code reconheça como credencial e credenciais incorporadas em URLs de registros de pacotes. O processo pai do Claude mantém essas credenciais para chamadas de API, mas os processos filhos não podem lê-las, o que reduz a exposição a ataques de injeção de prompt que tentam exfiltrar segredos via expansão do shell. Na v2.1.251 ou posterior, a limpeza também remove as próprias variáveis de ponteiro do armazenamento de configuração do Claude Code (como `CLAUDE_CONFIG_DIR`), para que um processo filho não consiga localizar um diretório de configuração realocado. Deixe a limpeza desativada se um subprocesso precisar dessas variáveis. No Linux, isso também executa os subprocessos Bash em um namespace de PID isolado para que não possam ler os ambientes dos processos do host via `/proc`; como efeito colateral, `ps`, `pgrep` e `kill` não conseguem ver nem sinalizar processos do host. `claude-code-action` define isso automaticamente quando `allowed_non_write_users` está configurado |399| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Defina como `1` para remover credenciais dos ambientes de subprocessos (ferramenta Bash, hooks, servidores MCP stdio): credenciais da Anthropic e de provedores de nuvem, qualquer outra variável que o Claude Code reconheça como credencial e credenciais incorporadas em URLs de registros de pacotes. O processo Claude pai mantém essas credenciais para chamadas de API, mas os processos filhos não conseguem lê-las, reduzindo a exposição a ataques de injeção de prompt que tentam exfiltrar segredos via expansão do shell. Na v2.1.251 ou posterior, a remoção também elimina as próprias variáveis do Claude Code que apontam para o armazenamento de configuração (como `CLAUDE_CONFIG_DIR`), para que um processo filho não consiga localizar um diretório de configuração realocado. Deixe a remoção não definida se um subprocesso precisar dessas variáveis. No Linux, isso também executa os subprocessos Bash em um namespace de PID isolado para que não possam ler os ambientes de processos do host via `/proc`; como efeito colateral, `ps`, `pgrep` e `kill` não conseguem ver nem sinalizar processos do host. `claude-code-action` define isso automaticamente quando `allowed_non_write_users` está configurado |

398| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Defina como `1` no modo não interativo (a flag `-p`) para aguardar a conclusão da instalação de plugins antes da primeira consulta. Sem isso, os plugins são instalados em segundo plano e podem não estar disponíveis no primeiro turno. Combine com `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar a espera |400| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Defina como `1` no modo não interativo (a flag `-p`) para aguardar a conclusão da instalação de plugins antes da primeira consulta. Sem isso, os plugins são instalados em segundo plano e podem não estar disponíveis no primeiro turno. Combine com `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar a espera |

399| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout em milissegundos para a instalação síncrona de plugins. Quando excedido, o Claude Code prossegue sem plugins e registra um erro em log. Sem padrão: sem esta variável, a instalação síncrona aguarda até ser concluída |401| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout em milissegundos para a instalação síncrona de plugins. Quando excedido, o Claude Code prossegue sem plugins e registra um erro em log. Sem padrão: sem esta variável, a instalação síncrona aguarda até ser concluída |

400| `CLAUDE_CODE_SYNC_SKILLS` | Defina como `1` no modo não interativo com a flag `-p` para fazer o Claude Code baixar as skills ativadas para sua conta do claude.ai nessa execução e aguardar a lista delas, por até `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, antes de executar a primeira consulta. Os downloads em si terminam em segundo plano, e Claude aguarda o download de uma skill quando a invoca. Requer autenticação no claude.ai. Sessões de terminal em que você faz login com sua conta do claude.ai [baixam essas skills](/docs/pt/skills#where-synced-skills-load) para `~/.claude/skills/synced/` e as ressincronizam aproximadamente a cada 10 minutos sem esta variável, então defina-a apenas quando uma execução `-p` precisar das suas skills atuais na primeira consulta. Antes da v2.1.273, as sessões de terminal as baixavam apenas em uma execução `-p` com esta variável definida. O nome de pasta `synced` é [reservado para este download](/docs/pt/skills#where-skills-live). Antes da v2.1.227, as skills eram baixadas diretamente em `~/.claude/skills/`. O Claude Code aplica [regras extras às skills baixadas](/docs/pt/skills#how-synced-skills-behave), como não executar os comandos `!` delas na sua máquina |402| `CLAUDE_CODE_SYNC_SKILLS` | Defina como `1` no modo não interativo com a flag `-p` para fazer o Claude Code baixar as skills ativadas para sua conta do claude.ai nessa execução e aguardar a lista delas, até `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, antes de executar a primeira consulta. Os downloads em si terminam em segundo plano, e Claude aguarda o download de uma skill quando a invoca. Requer autenticação no claude.ai. Sessões de terminal em que você faz login com sua conta do claude.ai [baixam essas skills](/docs/pt/skills#where-synced-skills-load) para `~/.claude/skills/synced/` e ressincronizam aproximadamente a cada 10 minutos sem esta variável, então defina-a apenas quando uma execução `-p` precisar das suas skills atuais na primeira consulta. Antes da v2.1.273, as sessões de terminal as baixavam apenas em uma execução `-p` com esta variável definida. O nome de pasta `synced` é [reservado para esse download](/docs/pt/skills#where-skills-live). Antes da v2.1.227, as skills eram baixadas diretamente em `~/.claude/skills/`. O Claude Code aplica [regras extras às skills baixadas](/docs/pt/skills#how-synced-skills-behave), como não executar seus comandos `!` na sua máquina |

401| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout em milissegundos para a ressincronização de skills executada no meio da sessão quando um aplicativo criado com o [Agent SDK](/docs/pt/agent-sdk/typescript#query-object) recarrega as skills (padrão: 30000). Quando excedido, o recarregamento continua com as skills que já chegaram, e os downloads restantes terminam em segundo plano |403| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout em milissegundos para a ressincronização de skills executada no meio da sessão quando um app criado com o [Agent SDK](/docs/pt/agent-sdk/typescript#query-object) recarrega as skills (padrão: 30000). Quando excedido, o recarregamento continua com as skills que já chegaram, e os downloads restantes terminam em segundo plano |

402| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout em milissegundos para que a primeira consulta aguarde a lista inicial de skills quando `CLAUDE_CODE_SYNC_SKILLS` está definida (padrão: 5000). Quando excedido, a primeira consulta é executada com as skills que já chegaram. Os downloads terminam em segundo plano de qualquer forma, e Claude aguarda o download de uma skill quando a invoca |404| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout em milissegundos durante o qual a primeira consulta aguarda a lista inicial de skills quando `CLAUDE_CODE_SYNC_SKILLS` está definida (padrão: 5000). Quando excedido, a primeira consulta é executada com as skills que já chegaram. Os downloads terminam em segundo plano de qualquer forma, e Claude aguarda o download de uma skill quando a invoca |

403| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Defina como `false` para desativar o realce de sintaxe na saída de diff. Útil quando as cores interferem na configuração do seu terminal. Para desativar também o realce em blocos de código e pré-visualizações de arquivos, use a configuração [`syntaxHighlightingDisabled`](/docs/pt/settings-reference#syntaxhighlightingdisabled) |405| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Defina como `false` para desativar o realce de sintaxe na saída de diff. Útil quando as cores interferem na configuração do seu terminal. Para desativar também o realce em blocos de código e em visualizações de arquivos, use a configuração [`syntaxHighlightingDisabled`](/docs/pt/settings-reference#syntaxhighlightingdisabled) |

404| `CLAUDE_CODE_TASK_LIST_ID` | Compartilha uma lista de tarefas entre sessões. Defina o mesmo ID em várias instâncias do Claude Code para coordenar uma lista de tarefas compartilhada, em [sessões que têm as ferramentas Task](/docs/pt/tools-reference#task-tool-availability). Consulte [Lista de tarefas](/docs/pt/interactive-mode#task-list) |406| `CLAUDE_CODE_TASK_LIST_ID` | Compartilha uma lista de tarefas entre sessões. Defina o mesmo ID em várias instâncias do Claude Code para coordenar o trabalho em uma lista de tarefas compartilhada, em [sessões que têm as ferramentas Task](/docs/pt/tools-reference#task-tool-availability). Consulte [Lista de tarefas](/docs/pt/interactive-mode#task-list) |

405| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Sobrescreve, em milissegundos, quanto tempo uma sessão não interativa aguarda na saída para que sua [equipe de agentes](/docs/pt/agent-teams) termine de ser desmontada. Aceita de 1000 a 60000; um valor fora desse intervalo é ignorado e o padrão de 10000 se aplica. Requer Claude Code v2.1.206 ou posterior |407| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Sobrescreve, em milissegundos, quanto tempo uma sessão não interativa aguarda na saída para que sua [equipe de agentes](/docs/pt/agent-teams) termine de ser desmontada. Aceita valores de 1000 a 60000; um valor fora do intervalo é ignorado e o padrão de 10000 se aplica. Requer Claude Code v2.1.206 ou posterior |

406| `CLAUDE_CODE_TMPDIR` | Sobrescreve o diretório temporário usado para arquivos temporários internos. O Claude Code acrescenta `/claude-{uid}/` a este caminho no Unix, ou `/claude/` no Windows. Padrão: `/tmp` no macOS, `os.tmpdir()` no Linux e no Windows. No macOS e no Linux, subprocessos Bash [em sandbox](/docs/pt/sandboxing) recebem um `$TMPDIR` de fallback curto sob o padrão do sistema quando o valor que você definiu é um caminho longo, já que algumas ferramentas falham quando os caminhos temporários ficam longos demais. Comandos Bash fora do sandbox herdam o `$TMPDIR` do seu shell quando ele está definido. No Windows nativo, quando seu shell não define `$TMPDIR`, um comando Bash que referencia `$TMPDIR` recebe o valor que você definiu, ou `%TEMP%` quando você não definiu nenhum. Os próprios arquivos temporários do Claude Code sempre usam o valor que você definiu. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |408| `CLAUDE_CODE_TMPDIR` | Sobrescreve o diretório temporário usado para arquivos temporários internos. O Claude Code acrescenta `/claude-{uid}/` a esse caminho no Unix, ou `/claude/` no Windows. Padrão: `/tmp` no macOS, `os.tmpdir()` no Linux e no Windows. No macOS e no Linux, subprocessos Bash em [sandbox](/docs/pt/sandboxing) recebem um `$TMPDIR` de fallback curto sob o padrão do sistema quando o valor que você definiu é um caminho longo, já que algumas ferramentas falham quando os caminhos temporários ficam longos demais. Comandos Bash fora do sandbox herdam o `$TMPDIR` do seu shell quando ele está definido. No Windows nativo, quando seu shell não define `$TMPDIR`, um comando Bash que referencia `$TMPDIR` recebe o valor que você definiu, ou `%TEMP%` quando você não definiu nenhum. Os próprios arquivos temporários do Claude Code sempre usam o valor que você definiu. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada em [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

407| `CLAUDE_CODE_TMUX_TRUECOLOR` | Defina com qualquer valor não vazio, como `1`, para permitir saída truecolor de 24 bits dentro do tmux. **Defini-la como `0` ou `false` ainda permite truecolor**, diferentemente da maioria das variáveis de ativar/desativar; remova a definição da variável para restaurar a limitação a 256 cores. Por padrão, o Claude Code limita a saída a 256 cores quando `$TMUX` está definida, porque o tmux não repassa sequências de escape truecolor, a menos que seja configurado para isso. Defina-a depois de adicionar `set -ga terminal-overrides ',*:Tc'` ao seu `~/.tmux.conf`. Consulte [Configuração do terminal](/docs/pt/terminal-config) para outras configurações do tmux |409| `CLAUDE_CODE_TMUX_TRUECOLOR` | Defina como qualquer valor não vazio, como `1`, para permitir saída truecolor de 24 bits dentro do tmux. **Defini-la como `0` ou `false` ainda permite truecolor**, ao contrário da maioria das variáveis de ativar/desativar; remova a definição da variável para restaurar a limitação a 256 cores. Por padrão, o Claude Code limita a saída a 256 cores quando `$TMUX` está definida, porque o tmux não repassa sequências de escape truecolor a menos que esteja configurado para isso. Defina isso depois de adicionar `set -ga terminal-overrides ',*:Tc'` ao seu `~/.tmux.conf`. Consulte [Configuração do terminal](/docs/pt/terminal-config) para outras configurações do tmux |

408| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | No Linux e no WSL, defina com uma lista separada por vírgulas dos tipos de processos que o Claude Code [exclui do limite de memória das ferramentas](/docs/pt/tools-reference#memory-limit-on-linux-and-wsl), como `mcp` ou `lsp`. Defina `none` para limitar todos os tipos, ou `all-new` para limitar apenas os comandos das ferramentas Bash, PowerShell e Monitor. O Claude Code mantém os comandos das ferramentas Bash, PowerShell e Monitor sob o limite, independentemente do que você listar. Requer Claude Code v2.1.246 ou posterior |410| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | No Linux e no WSL, defina como uma lista separada por vírgulas dos tipos de processos que o Claude Code [exclui do limite de memória de ferramentas](/docs/pt/tools-reference#memory-limit-on-linux-and-wsl), como `mcp` ou `lsp`. Defina `none` para limitar todos os tipos, ou `all-new` para limitar apenas os comandos das ferramentas Bash, PowerShell e Monitor. O Claude Code mantém os comandos das ferramentas Bash, PowerShell e Monitor sob o limite independentemente do que você listar. Requer Claude Code v2.1.246 ou posterior |

409| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | No Linux e no WSL, defina com um tamanho como `4G` para [limitar a memória que os comandos das ferramentas Bash e PowerShell podem usar](/docs/pt/tools-reference#memory-limit-on-linux-and-wsl), e os comandos da ferramenta Monitor na v2.1.246 ou posterior. Escreva o tamanho em dígitos simples, sozinho para um número de bytes ou com um sufixo `K`, `M`, `G` ou `T`. Defina `0` ou `off` para desativar o limite. Depois que o primeiro processo iniciado pelo Claude Code tiver ativado ou desativado o limite, um valor alterado entra em vigor na próxima vez que você iniciar `claude`. Requer Claude Code v2.1.233 ou posterior |411| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | No Linux e no WSL, defina como um tamanho, como `4G`, para [limitar a memória que os comandos das ferramentas Bash e PowerShell podem usar](/docs/pt/tools-reference#memory-limit-on-linux-and-wsl), e os comandos da ferramenta Monitor na v2.1.246 ou posterior. Escreva o tamanho em dígitos simples, sozinho para um número de bytes ou com um sufixo `K`, `M`, `G` ou `T`. Defina `0` ou `off` para desativar o limite. Depois que o primeiro processo iniciado pelo Claude Code tiver ativado ou desativado o limite, um valor alterado entra em vigor na próxima vez que você iniciar `claude`. Requer Claude Code v2.1.233 ou posterior |

410| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Prazo, em milissegundos, antes que o Claude Code cancele um diálogo que ele encaminha para um cliente remoto, como um host de [Remote Control](/docs/pt/remote-control) ou do SDK, ou o diálogo de aprovação de uma [mensagem entre sessões retida](/docs/pt/cross-session-messaging#control-inbound-messages); prompts de permissão e perguntas de `AskUserQuestion` usam seus próprios fluxos e não são regidos por ela. No Claude Code v2.1.236 ou posterior, ela também limita o [prompt de consentimento de créditos de uso do Fable](/docs/pt/model-config#fable-and-usage-credits) no meio da sessão em uma sessão que pode estar sendo executada sem supervisão. [Controlar mensagens recebidas](/docs/pt/cross-session-messaging#control-inbound-messages) e [sessões não interativas](/docs/pt/cross-session-messaging#non-interactive-sessions) abordam as regras completas de expiração de mensagens retidas, incluindo os casos em que o prazo não se aplica. Sobrescreve a configuração [`dialogExpiry`](/docs/pt/settings-reference#dialogexpiry). `0` ou um valor negativo desativa o prazo |412| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Prazo, em milissegundos, antes que o Claude Code cancele um diálogo que encaminha a um cliente remoto, como um host do [Remote Control](/docs/pt/remote-control) ou do SDK, ou o diálogo de aprovação de uma [mensagem entre sessões retida](/docs/pt/cross-session-messaging#control-inbound-messages); prompts de permissão e perguntas de `AskUserQuestion` usam seus próprios fluxos e não são regidos por ela. No Claude Code v2.1.236 ou posterior, ela também limita o [prompt de consentimento de créditos de uso do Fable](/docs/pt/model-config#fable-and-usage-credits) exibido no meio da sessão em uma sessão que pode estar sendo executada sem supervisão. [Controlar mensagens recebidas](/docs/pt/cross-session-messaging#control-inbound-messages) e [sessões não interativas](/docs/pt/cross-session-messaging#non-interactive-sessions) abordam as regras completas de expiração de mensagens retidas, incluindo os casos em que o prazo não se aplica. Sobrescreve a configuração [`dialogExpiry`](/docs/pt/settings-reference#dialogexpiry). `0` ou um valor negativo desativa o prazo |

411| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usar o [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) |413| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usa o [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) |

412| `CLAUDE_CODE_USE_BEDROCK` | Usar o [Amazon Bedrock](/docs/pt/amazon-bedrock) |414| `CLAUDE_CODE_USE_BEDROCK` | Usa o [Amazon Bedrock](/docs/pt/amazon-bedrock) |

413| `CLAUDE_CODE_USE_FOUNDRY` | Usar o [Microsoft Foundry](/docs/pt/microsoft-foundry) |415| `CLAUDE_CODE_USE_FOUNDRY` | Usa o [Microsoft Foundry](/docs/pt/microsoft-foundry) |

414| `CLAUDE_CODE_USE_MANTLE` | Usar o [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) do Amazon Bedrock |416| `CLAUDE_CODE_USE_MANTLE` | Usa o [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) do Amazon Bedrock |

415| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Defina como `1` para descobrir comandos personalizados, subagentes e estilos de saída usando as APIs de arquivos do Node.js em vez do ripgrep. Defina-a se o binário do ripgrep incluído estiver indisponível ou bloqueado no seu ambiente. Não afeta a ferramenta Grep nem as ferramentas de busca de arquivos |417| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Defina como `1` para descobrir comandos personalizados, subagentes e estilos de saída usando as APIs de arquivos do Node.js em vez do ripgrep. Defina isso se o binário do ripgrep incluído estiver indisponível ou bloqueado no seu ambiente. Não afeta o Grep nem as ferramentas de busca de arquivos |

416| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controla a ferramenta PowerShell. No Windows sem Git Bash, a ferramenta é ativada automaticamente; defina como `0` para desativá-la. No Windows com Git Bash instalado, a ferramenta fica ativada por padrão para contas do claude.ai e do Console; defina como `1` para ativá-la em sessões do Amazon Bedrock, do Agent Platform do Google Cloud e do Microsoft Foundry, ou `0` para desativá-la. No Linux, macOS e WSL, defina como `1` para ativá-la, o que requer `pwsh` no seu `PATH`. Quando ativada no Windows, Claude pode executar comandos do PowerShell nativamente em vez de roteá-los pelo Git Bash. Consulte [Ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) |418| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controla a ferramenta PowerShell. No Windows sem Git Bash, a ferramenta é ativada automaticamente; defina como `0` para desativá-la. No Windows com Git Bash instalado, a ferramenta fica ativada por padrão para contas do claude.ai e do Console; defina como `1` para ativá-la em sessões do Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, ou `0` para desativá-la. No Linux, no macOS e no WSL, defina como `1` para ativá-la, o que requer `pwsh` no seu `PATH`. Quando ativada no Windows, Claude pode executar comandos do PowerShell nativamente em vez de passar pelo Git Bash. Consulte [Ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) |

417| `CLAUDE_CODE_USE_VERTEX` | Usar o [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) |419| `CLAUDE_CODE_USE_VERTEX` | Usa o [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) |

418| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Defina com o número de milissegundos durante os quais o [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior) mantém em cache a resposta de cada URL buscada. O padrão é `900000`, que equivale a 15 minutos. Aceita apenas dígitos simples; `0`, um decimal ou qualquer outra grafia mantém o padrão. O Claude Code lê o valor uma vez por inicialização, então uma alteração em um bloco `env` de configurações se aplica na próxima vez que você iniciar `claude`. Requer Claude Code v2.1.233 ou posterior |420| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Defina como o número de milissegundos durante os quais o [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior) mantém em cache a resposta de cada URL buscada. O padrão é `900000`, que equivale a 15 minutos. Aceita apenas dígitos simples; `0`, um decimal ou qualquer outra grafia mantém o padrão. O Claude Code lê o valor uma vez por inicialização, então uma alteração em um bloco `env` das configurações se aplica na próxima vez que você iniciar o `claude`. Requer Claude Code v2.1.233 ou posterior |

419| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superior, em milissegundos, de quanto tempo o [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior) aguarda o download de uma página, incluindo quaisquer redirecionamentos que ele siga. Um download que não tiver sido concluído até lá falha com um erro de prazo. O padrão é `300000`, que equivale a cinco minutos. Defina como `0` para remover o limite. Aceita apenas dígitos simples; um decimal ou qualquer outra grafia mantém o padrão. Requer Claude Code v2.1.268 ou posterior |421| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superior, em milissegundos, de quanto tempo o [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior) espera pelo download de uma página, incluindo quaisquer redirecionamentos que ele siga. Um download que não tiver sido concluído até lá falha com um erro de prazo. O padrão é `300000`, que equivale a cinco minutos. Defina como `0` para remover o limite. Aceita apenas dígitos simples; um decimal ou qualquer outra grafia mantém o padrão. Requer Claude Code v2.1.268 ou posterior |

420| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Quantos agentes uma única execução de [workflow](/docs/pt/workflows) executa ao mesmo tempo, de `1` a `256`. Por padrão, uma execução roda até 16 agentes ao mesmo tempo, menos quando o Claude Code tem menos CPUs disponíveis; chamadas `agent()` enfileiradas aguardam um slot livre. A transcrição de cada agente em execução permanece na memória do Claude Code, então valores mais altos aumentam o uso de memória. Aceita apenas dígitos simples; valores fora do intervalo e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior |422| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` está definida como `1`, quanto tempo o Claude Code espera antes de cada lembrete para que o Claude verifique [subagentes em segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) que ainda estão em execução. Aceita uma ou mais esperas separadas por vírgula, em segundos inteiros de `1` a `86400`, como `600` ou `600,1800,3600`. Cada valor é a espera antes do próximo lembrete, e o último valor se repete. Aceita apenas dígitos simples; qualquer outro valor ou grafia é lido como não definido. Quando não definida, não há lembretes. Requer Claude Code v2.1.283 ou posterior |

421| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superior em milissegundos de quanto tempo um agente de [workflow](/docs/pt/workflows) espera que a primeira resposta de um irmão com o mesmo prefixo comece antes de enviar sua própria primeira requisição. Quando um fan-out inicia vários agentes que compartilham um [prefixo de cache de prompt](/docs/pt/workflows#prompt-caching-in-a-fan-out), o Claude Code segura todos, exceto o primeiro agente, por até esse tempo, para que os demais leiam o prefixo em cache em vez de cada um processá-lo sem cache. Padrão `5000`. Defina como `0` para desativar a espera. Quando `DISABLE_PROMPT_CACHING` está definido, os agentes nunca esperam. Requer Claude Code v2.1.229 ou posterior |423| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Quantos agentes uma única execução de [workflow](/docs/pt/workflows) executa ao mesmo tempo, de `1` a `256`. Por padrão, uma execução executa até 16 agentes ao mesmo tempo, menos quando o Claude Code tem menos CPUs disponíveis; chamadas `agent()` enfileiradas aguardam um slot livre. A transcrição de cada agente em execução permanece na memória do Claude Code, então valores mais altos aumentam o uso de memória. Aceita apenas dígitos simples; valores fora do intervalo e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior |

424| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superior, em milissegundos, de quanto tempo um agente de [workflow](/docs/pt/workflows) espera que a primeira resposta de um agente irmão com o mesmo prefixo comece antes de enviar sua própria primeira requisição. Quando um fan-out inicia vários agentes que compartilham um [prefixo de cache de prompt](/docs/pt/workflows#prompt-caching-in-a-fan-out), o Claude Code retém todos os agentes, exceto o primeiro, por até esse tempo, para que os demais leiam o prefixo em cache em vez de cada um processá-lo sem cache. Padrão `5000`. Defina como `0` para desativar a espera. Quando `DISABLE_PROMPT_CACHING` está definida, os agentes nunca esperam. Requer Claude Code v2.1.229 ou posterior |

422| `CLAUDE_CONFIG_DIR` | Sobrescreve o diretório de configuração (padrão: `~/.claude`). Todas as configurações, o histórico de sessões e os plugins são armazenados nesse caminho. Para credenciais, consulte [onde o Claude Code armazena credenciais](/docs/pt/authentication#credential-management). Útil para executar várias contas lado a lado: por exemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |425| `CLAUDE_CONFIG_DIR` | Sobrescreve o diretório de configuração (padrão: `~/.claude`). Todas as configurações, o histórico de sessões e os plugins são armazenados nesse caminho. Para credenciais, consulte [onde o Claude Code armazena credenciais](/docs/pt/authentication#credential-management). Útil para executar várias contas lado a lado: por exemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

423| `CLAUDE_DISABLE_ADOPT` | Defina como `1` para interromper o trabalho em segundo plano em andamento em vez de transferi-lo quando você envia uma sessão para segundo plano pressionando `←` ou com [`/background`](/docs/pt/agent-view#from-inside-a-session). O Claude Code pede que você confirme antes de enviar para segundo plano e, em seguida, interrompe as tarefas que de outra forma seriam transferidas. Requer Claude Code v2.1.195 ou posterior |426| `CLAUDE_DISABLE_ADOPT` | Defina como `1` para interromper o trabalho em segundo plano em andamento em vez de transferi-lo quando você coloca uma sessão em segundo plano pressionando `←` ou com [`/background`](/docs/pt/agent-view#from-inside-a-session). O Claude Code pede que você confirme antes de colocar em segundo plano e, em seguida, interrompe as tarefas que, de outra forma, seriam transferidas. Requer Claude Code v2.1.195 ou posterior |

424| `CLAUDE_EFFORT` | Definida automaticamente em subprocessos da ferramenta Bash e em comandos de hook com o [nível de esforço](/docs/pt/model-config#adjust-effort-level) em vigor quando o subprocesso é iniciado: `low`, `medium`, `high`, `xhigh` ou `max`. Corresponde ao campo `effort.level` passado para [hooks](/docs/pt/hooks). Definida apenas quando o modelo atual suporta o parâmetro de esforço |427| `CLAUDE_EFFORT` | Definida automaticamente em subprocessos da ferramenta Bash e em comandos de hook como o [nível de esforço](/docs/pt/model-config#adjust-effort-level) em vigor quando o subprocesso é iniciado: `low`, `medium`, `high`, `xhigh` ou `max`. Corresponde ao campo `effort.level` passado aos [hooks](/docs/pt/hooks). Definida apenas quando o modelo atual suporta o parâmetro de esforço |

425| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Defina como `1` para forçar a ativação do watchdog de inatividade de streaming em nível de byte, ou como `0` para forçar sua desativação. `0` também desativa o [prazo do primeiro byte](/docs/pt/network-config#streaming-idle-watchdogs) nas conexões em que esse prazo é executado. Quando não definida, o watchdog fica ativado por padrão para conexões diretas com a API da Anthropic e com a [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), e para respostas de streaming em conexões de [gateway](/docs/pt/gateways) alcançadas por meio de `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL`; antes da v2.1.222 ele não era executado nessas conexões de gateway, então o watchdog em nível de evento podia relatar um travamento ali mesmo enquanto pings de keep-alive estavam chegando. Para timeouts e como os temporizadores interagem, consulte [Watchdogs de inatividade de streaming](/docs/pt/network-config#streaming-idle-watchdogs) |428| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Defina como `1` para forçar a ativação do watchdog de inatividade de streaming em nível de byte, ou como `0` para forçar sua desativação. `0` também desativa o [prazo do primeiro byte](/docs/pt/network-config#streaming-idle-watchdogs) nas conexões em que esse prazo é executado. Quando não definida, o watchdog é ativado por padrão para conexões diretas com a Anthropic API e com o [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), e para respostas de streaming em conexões de [gateway](/docs/pt/gateways) acessadas por meio de `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL`; antes da v2.1.222, ele não era executado nessas conexões de gateway, então o watchdog em nível de evento podia relatar um travamento ali mesmo enquanto pings de keep-alive estavam chegando. Para timeouts e como os temporizadores interagem, consulte [Watchdogs de inatividade de streaming](/docs/pt/network-config#streaming-idle-watchdogs) |

426| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Defina como `1` para ativar o watchdog de inatividade de streaming em nível de byte nas respostas `vnd.amazon.eventstream` do Amazon Bedrock, o que também ativa o [prazo do primeiro byte](/docs/pt/network-config#streaming-idle-watchdogs) em requisições de streaming do Bedrock. Desativado por padrão. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |429| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Defina como `1` para ativar o watchdog de inatividade de streaming em nível de byte em respostas `vnd.amazon.eventstream` do Amazon Bedrock, o que também ativa o [prazo do primeiro byte](/docs/pt/network-config#streaming-idle-watchdogs) em requisições de streaming do Bedrock. Desativado por padrão. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

427| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Defina como `0` para forçar a desativação do watchdog de inatividade de streaming em nível de evento, ou como `1` para forçar sua ativação. Quando não definida, o watchdog fica ativado por padrão para todos os provedores. Antes da v2.1.196, o padrão quando não definida era controlado pelo servidor na API direta da Anthropic e desativado em outros provedores. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; para os outros temporizadores de travamento que são executados junto com este, consulte [Watchdogs de inatividade de streaming](/docs/pt/network-config#streaming-idle-watchdogs) |430| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Defina como `0` para forçar a desativação do watchdog de inatividade de streaming em nível de evento, ou como `1` para forçar sua ativação. Quando não definida, o watchdog fica ativado por padrão para todos os provedores. Antes da v2.1.196, o padrão sem definição era controlado pelo servidor na Anthropic API direta e desativado em outros provedores. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; para os outros temporizadores de travamento que são executados junto com este, consulte [Watchdogs de inatividade de streaming](/docs/pt/network-config#streaming-idle-watchdogs) |

428| `CLAUDE_ENV_FILE` | Caminho para um script de shell cujo conteúdo o Claude Code executa antes de cada comando Bash no mesmo processo de shell, para que as exportações no arquivo fiquem visíveis para o comando. Use para persistir a ativação de virtualenv ou conda entre comandos. Também preenchida dinamicamente pelos hooks [SessionStart](/docs/pt/hooks#persist-environment-variables), [Setup](/docs/pt/hooks#setup), [CwdChanged](/docs/pt/hooks#cwdchanged) e [FileChanged](/docs/pt/hooks#filechanged) |431| `CLAUDE_ENV_FILE` | Caminho para um script de shell cujo conteúdo o Claude Code executa antes de cada comando Bash no mesmo processo de shell, de modo que as exportações no arquivo fiquem visíveis para o comando. Use para manter a ativação de virtualenv ou conda entre comandos. Também preenchida dinamicamente pelos hooks [SessionStart](/docs/pt/hooks#persist-environment-variables), [Setup](/docs/pt/hooks#setup), [CwdChanged](/docs/pt/hooks#cwdchanged) e [FileChanged](/docs/pt/hooks#filechanged) |

429| `CLAUDE_JOB_DIR` | Definida pelo Claude Code em cada [sessão em segundo plano](/docs/pt/agent-view) como o diretório `~/.claude/jobs/<id>` dessa sessão. Os comandos de shell que a sessão executa a herdam. Grave arquivos temporários em [`$CLAUDE_JOB_DIR/tmp`](/docs/pt/agent-view#where-state-is-stored). As chamadas `Write` e `Edit` do Claude ali não pedem permissão, e o diretório é removido quando a sessão é excluída |432| `CLAUDE_JOB_DIR` | Definida pelo Claude Code em cada [sessão em segundo plano](/docs/pt/agent-view) como o diretório `~/.claude/jobs/<id>` dessa sessão. Os comandos de shell que a sessão executa a herdam. Grave arquivos temporários em [`$CLAUDE_JOB_DIR/tmp`](/docs/pt/agent-view#where-state-is-stored). As chamadas `Write` e `Edit` do Claude nesse local não solicitam permissão, e o diretório é removido quando a sessão é excluída |

430| `CLAUDE_PID` | O Claude Code define esta variável com seu próprio ID de processo nos subprocessos que ele gera: comandos das ferramentas Bash e PowerShell e comandos de hook. No Linux, a integração de shell da ferramenta Bash a utiliza para recusar um padrão de `pkill` que corresponderia ao próprio processo do Claude Code; consulte [a referência de erros](/docs/pt/errors#pkill-pattern-matches-the-claude-code-process). Leia-a a partir dos seus próprios scripts para identificar ou sinalizar deliberadamente o processo pai do Claude Code. Requer Claude Code v2.1.214 ou posterior |433| `CLAUDE_PID` | O Claude Code define esta variável com o ID do seu próprio processo nos subprocessos que ele cria: comandos das ferramentas Bash e PowerShell e comandos de hook. No Linux, a integração de shell da ferramenta Bash a usa para recusar um padrão de `pkill` que corresponderia ao próprio processo do Claude Code; consulte [a referência de erros](/docs/pt/errors#pkill-pattern-matches-the-claude-code-process). Leia-a a partir dos seus próprios scripts para identificar ou enviar sinais deliberadamente ao processo pai do Claude Code. Requer Claude Code v2.1.214 ou posterior |

431| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefixo para nomes de sessão do [Remote Control](/docs/pt/remote-control) gerados automaticamente quando nenhum nome explícito é fornecido. O padrão é o hostname da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. A flag de CLI `--remote-control-session-name-prefix` define o mesmo valor para uma única invocação |434| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefixo para nomes de sessão do [Remote Control](/docs/pt/remote-control) gerados automaticamente quando nenhum nome explícito é fornecido. O padrão é o hostname da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. A flag de CLI `--remote-control-session-name-prefix` define o mesmo valor para uma única invocação |

432| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Prazo em milissegundos para o primeiro byte de resposta de uma requisição de streaming, nas conexões em que o [prazo do primeiro byte](/docs/pt/network-config#streaming-idle-watchdogs) é executado. Para saber como o Claude Code o limita, o tempo extra que ele adiciona para corpos de requisição grandes e como ele escolhe o prazo quando você deixa esta variável não definida, consulte [No response from API](/docs/pt/errors#no-response-from-api). Requer Claude Code v2.1.242 ou posterior |435| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Prazo, em milissegundos, para o primeiro byte de resposta de uma requisição de streaming, nas conexões em que o [prazo do primeiro byte](/docs/pt/network-config#streaming-idle-watchdogs) é executado. Para saber como o Claude Code o limita, o tempo extra que ele adiciona para corpos de requisição grandes e como ele escolhe o prazo quando você deixa esta variável sem definição, consulte [No response from API](/docs/pt/errors#no-response-from-api). Requer Claude Code v2.1.242 ou posterior |

433| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout em milissegundos antes que os watchdogs de inatividade de streaming em nível de evento e de byte fechem uma conexão travada. Quando você define esta variável explicitamente, o mínimo é `300000` (5 minutos); valores menores são limitados silenciosamente para absorver pausas de pensamento estendido e buffering de proxy, e o watchdog em nível de byte limita o valor a 30 minutos. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` tem precedência sobre esta variável para o watchdog em nível de byte. Para os padrões de cada watchdog quando não definida, consulte [Watchdogs de inatividade de streaming](/docs/pt/network-config#streaming-idle-watchdogs) |436| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout, em milissegundos, antes que os watchdogs de inatividade de streaming em nível de evento e de byte fechem uma conexão travada. Quando você define esta variável explicitamente, o mínimo é `300000` (5 minutos); valores menores são ajustados silenciosamente para absorver pausas de pensamento estendido e buffering de proxy, e o watchdog em nível de byte limita o valor a 30 minutos. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` tem precedência sobre esta variável para o watchdog em nível de byte. Para os padrões de cada watchdog quando não definida, consulte [Watchdogs de inatividade de streaming](/docs/pt/network-config#streaming-idle-watchdogs) |

434| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Removida na v2.1.260 e agora sem efeito. Anteriormente limitava por quanto tempo um [comando de shell em segundo plano](/docs/pt/interactive-mode#background-bash-commands) iniciado por um [subagente](/docs/pt/sub-agents) podia ser executado, em milissegundos, com um padrão de 60 minutos. Consulte [as regras de tempo de vida de comandos em segundo plano](/docs/pt/tools-reference#background-commands) |437| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Removida na v2.1.260 e agora sem efeito. Anteriormente limitava por quanto tempo um [comando de shell em segundo plano](/docs/pt/interactive-mode#background-bash-commands) iniciado por um [subagente](/docs/pt/sub-agents) podia ser executado, em milissegundos, com um padrão de 60 minutos. Consulte [as regras de tempo de vida de comandos em segundo plano](/docs/pt/tools-reference#background-commands) |

435| `DEBUG` | Defina como `1` para ativar o modo de depuração, equivalente a iniciar com [`--debug`](/docs/pt/cli-reference#cli-flags). Os logs de depuração são gravados em `~/.claude/debug/<session-id>.txt`, ou no caminho definido por `CLAUDE_CODE_DEBUG_LOGS_DIR`. Apenas os valores verdadeiros `1`, `true`, `yes` e `on` ativam o modo de depuração, então padrões de namespace como `DEBUG=express:*` definidos para outras ferramentas não o acionam |438| `DEBUG` | Defina como `1` para ativar o modo de depuração, equivalente a iniciar com [`--debug`](/docs/pt/cli-reference#cli-flags). Os logs de depuração são gravados em `~/.claude/debug/<session-id>.txt` ou no caminho definido por `CLAUDE_CODE_DEBUG_LOGS_DIR`. Apenas os valores verdadeiros `1`, `true`, `yes` e `on` ativam o modo de depuração, portanto padrões de namespace como `DEBUG=express:*` definidos para outras ferramentas não o acionam |

436| `DISABLE_AUTOUPDATER` | Defina como `1` para desativar as atualizações automáticas em segundo plano. O `claude update` manual ainda funciona. Use `DISABLE_UPDATES` para bloquear ambos |439| `DISABLE_AUTOUPDATER` | Defina como `1` para desativar as atualizações automáticas em segundo plano. O `claude update` manual continua funcionando. Use `DISABLE_UPDATES` para bloquear ambos |

437| `DISABLE_AUTO_COMPACT` | Defina como `1` para desativar a compactação automática ao se aproximar do limite de contexto. O comando manual `/compact` continua disponível. Use quando quiser controle explícito sobre quando a compactação ocorre. Sobrescreve a configuração [`autoCompactEnabled`](/docs/pt/settings-reference#autocompactenabled) |440| `DISABLE_AUTO_COMPACT` | Defina como `1` para desativar a compactação automática ao se aproximar do limite de contexto. O comando manual `/compact` continua disponível. Use quando quiser controle explícito sobre quando a compactação ocorre. Sobrescreve a configuração [`autoCompactEnabled`](/docs/pt/settings-reference#autocompactenabled) |

438| `DISABLE_COMPACT` | Defina como `1` para desativar toda a compactação: tanto a compactação automática quanto o comando manual `/compact` |441| `DISABLE_COMPACT` | Defina como `1` para desativar toda a compactação: tanto a compactação automática quanto o comando manual `/compact` |

439| `DISABLE_COST_WARNINGS` | Defina como `1` para desativar as mensagens de aviso de custo |442| `DISABLE_COST_WARNINGS` | Defina como `1` para desativar as mensagens de aviso de custo |

440| `DISABLE_DOCTOR_COMMAND` | Defina como `1` para ocultar a skill de verificação de configuração [`/doctor`](/docs/pt/commands#all-commands) e seu alias `/checkup`. Útil para implantações gerenciadas em que os usuários não devem executar diagnósticos de configuração a partir de uma sessão. Não afeta o comando de terminal `claude doctor`. Antes da v2.1.205, esta variável ocultava o comando da tela de diagnóstico `/doctor` |443| `DISABLE_DOCTOR_COMMAND` | Defina como `1` para ocultar a skill de verificação de configuração [`/doctor`](/docs/pt/commands#all-commands) e seu alias `/checkup`. Útil para implantações gerenciadas em que os usuários não devem executar diagnósticos de configuração a partir de uma sessão. Não afeta o comando de terminal `claude doctor`. Antes da v2.1.205, esta variável ocultava o comando da tela de diagnósticos `/doctor` |

441| `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**, ao contrário da maioria das variáveis liga/desliga; remova a definição da variável para reativar o relatório de erros |444| `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**, ao contrário da maioria das variáveis liga/desliga; remova a definição da variável para reativar o relatório de erros |

442| `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 |445| `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 |

443| `DISABLE_FEEDBACK_COMMAND` | Defina como `1` para desativar o comando `/feedback` e o [feedback redigido pelo Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior). Também desativa `/bug` e `/share`, que relatam pelo mesmo caminho; antes da v2.1.212 eles eram aliases de `/feedback`, então o comando era desativado sob todos os nomes. O nome antigo `DISABLE_BUG_COMMAND` também é aceito |446| `DISABLE_FEEDBACK_COMMAND` | Defina como `1` para desativar o comando `/feedback` e o [feedback redigido pelo Claude](/docs/pt/tools-reference#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`, então o comando era desativado sob todos os nomes. O nome antigo `DISABLE_BUG_COMMAND` também é aceito |

444| `DISABLE_GROWTHBOOK` | Defina como `1` ou `true` para desativar a busca de feature flags do GrowthBook e usar os padrões do código para todas as flags. Isso torna o [Remote Control](/docs/pt/remote-control#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 |447| `DISABLE_GROWTHBOOK` | Defina como `1` ou `true` para desativar a busca de feature flags do GrowthBook e usar os padrões do código para todas as flags. Isso torna indisponíveis o [Remote Control](/docs/pt/remote-control#requirements) e os outros [recursos que precisam da busca de feature flags](#features-that-need-feature-flag-fetching). Defini-la como `0` ou `false` mantém a busca ativada. O registro de eventos de telemetria permanece ativado, a menos que `DISABLE_TELEMETRY` também esteja definida |

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

446| `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, Agent Platform do Google Cloud ou Microsoft Foundry) |449| `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) |

447| `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 suporta [pensamento intercalado](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |450| `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 suporta [pensamento intercalado](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

448| `DISABLE_LOGIN_COMMAND` | Defina como `1` para ocultar o comando `/login`. Útil quando a autenticação é tratada externamente por meio de chaves de API ou `apiKeyHelper` |451| `DISABLE_LOGIN_COMMAND` | Defina como `1` para ocultar o comando `/login`. Útil quando a autenticação é tratada externamente por meio de chaves de API ou `apiKeyHelper` |

449| `DISABLE_LOGOUT_COMMAND` | Defina como `1` para ocultar o comando `/logout` |452| `DISABLE_LOGOUT_COMMAND` | Defina como `1` para ocultar o comando `/logout` |

450| `DISABLE_PROMPT_CACHING` | Defina como `1` para desativar o [cache de prompt](/docs/pt/prompt-caching#disable-prompt-caching) para todos os modelos (tem precedência sobre as configurações por modelo) |453| `DISABLE_PROMPT_CACHING` | Defina como `1` para desativar o [cache de prompt](/docs/pt/prompt-caching#disable-prompt-caching) para todos os modelos (tem precedência sobre as configurações por modelo) |

451| `DISABLE_PROMPT_CACHING_FABLE` | Defina como `1` para desativar o cache de prompt para os modelos Fable |454| `DISABLE_PROMPT_CACHING_FABLE` | Defina como `1` para desativar o cache de prompt para modelos Fable |

452| `DISABLE_PROMPT_CACHING_HAIKU` | Defina como `1` para desativar o cache de prompt para o [modelo Haiku padrão](/docs/pt/prompt-caching#disable-prompt-caching), onde quer que ele seja executado |455| `DISABLE_PROMPT_CACHING_HAIKU` | Defina como `1` para desativar o cache de prompt para o [modelo Haiku padrão](/docs/pt/prompt-caching#disable-prompt-caching), onde quer que ele seja executado |

453| `DISABLE_PROMPT_CACHING_OPUS` | Defina como `1` para desativar o cache de prompt para o [modelo Opus padrão](/docs/pt/prompt-caching#disable-prompt-caching) |456| `DISABLE_PROMPT_CACHING_OPUS` | Defina como `1` para desativar o cache de prompt para o [modelo Opus padrão](/docs/pt/prompt-caching#disable-prompt-caching) |

454| `DISABLE_PROMPT_CACHING_SONNET` | Defina como `1` para desativar o cache de prompt para o [modelo Sonnet padrão](/docs/pt/prompt-caching#disable-prompt-caching) |457| `DISABLE_PROMPT_CACHING_SONNET` | Defina como `1` para desativar o cache de prompt para o [modelo Sonnet padrão](/docs/pt/prompt-caching#disable-prompt-caching) |

455| `DISABLE_TELEMETRY` | Defina com qualquer valor não vazio, como `1`, para desativar a telemetria. **Defini-la como `0` ou `false` ainda desativa**, ao contrário da maioria das variáveis liga/desliga; remova a definição da variável para reativar a telemetria. Os eventos de telemetria não incluem dados do usuário como código, caminhos de arquivo ou comandos Bash. Também desativa a [busca de feature flags](#features-that-need-feature-flag-fetching). Consulte [Desativar a telemetria para sua organização](/docs/pt/managed-settings#turn-telemetry-off-for-your-organization) |458| `DISABLE_TELEMETRY` | Defina com qualquer valor não vazio, como `1`, para desativar a telemetria. **Defini-la como `0` ou `false` ainda desativa**, ao contrário da maioria das variáveis liga/desliga; remova a definição da variável para reativar a telemetria. Os eventos de telemetria não incluem dados do usuário, como código, caminhos de arquivo ou comandos Bash. Também desativa a [busca de feature flags](#features-that-need-feature-flag-fetching). Consulte [Desativar a telemetria para sua organização](/docs/pt/managed-settings#turn-telemetry-off-for-your-organization) |

456| `DISABLE_UPDATES` | Defina como `1` para bloquear todas as atualizações, incluindo `claude update` e `claude install` manuais. Mais restritiva que `DISABLE_AUTOUPDATER`. Use ao distribuir o Claude Code pelos seus próprios canais quando os usuários não devem se autoatualizar |459| `DISABLE_UPDATES` | Defina como `1` para bloquear todas as atualizações, incluindo `claude update` e `claude install` manuais. Mais restritiva que `DISABLE_AUTOUPDATER`. Use ao distribuir o Claude Code pelos seus próprios canais quando os usuários não devem se autoatualizar |

457| `DISABLE_UPGRADE_COMMAND` | Defina como `1` para ocultar o comando `/upgrade` |460| `DISABLE_UPGRADE_COMMAND` | Defina como `1` para ocultar o comando `/upgrade` |

458| `DO_NOT_TRACK` | Defina como `1` para desativar a telemetria, com o mesmo efeito de `DISABLE_TELEMETRY`, inclusive na [busca de feature flags](#features-that-need-feature-flag-fetching). O Claude Code lê esta variável como um booleano padrão, então `0` mantém a telemetria ativada, e a respeita como a convenção entre ferramentas reconhecida por muitas CLIs de desenvolvedor |461| `DO_NOT_TRACK` | Defina como `1` para desativar a telemetria, com o mesmo efeito que `DISABLE_TELEMETRY`, inclusive sobre a [busca de feature flags](#features-that-need-feature-flag-fetching). O Claude Code lê esta variável como um booleano padrão, então `0` mantém a telemetria ativada, e a respeita como a convenção entre ferramentas reconhecida por muitas CLIs de desenvolvedor |

459| `ENABLE_BETA_TRACING_DETAILED` | Defina como `1`, junto com `BETA_TRACING_ENDPOINT`, para ativar o [rastreamento beta detalhado](/docs/pt/monitoring-usage#traces-beta), que adiciona atributos de span com conteúdo e o span `claude_code.hook`. Sessões interativas da CLI também exigem que sua organização esteja na lista de permissões do beta. Ambas as variáveis são ignoradas nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |462| `ENABLE_BETA_TRACING_DETAILED` | Defina como `1`, junto com `BETA_TRACING_ENDPOINT`, para ativar o [rastreamento beta detalhado](/docs/pt/monitoring-usage#traces-beta), que adiciona atributos de span com conteúdo e o span `claude_code.hook`. Sessões interativas da CLI também exigem que sua organização esteja na lista de permissões do beta. Ambas as variáveis são ignoradas nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

460| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para impedir que o Claude Code busque [servidores MCP do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai). Ativada por padrão para usuários com login. Para desativar por projeto ou por organização, defina [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors) nas configurações |463| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para impedir que o Claude Code busque [servidores MCP do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai). Ativado por padrão para usuários conectados. Para desativar por projeto ou por organização, defina [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors) nas configurações em vez disso |

461| `ENABLE_PROMPT_CACHING_1H` | Defina como `1` para solicitar um [TTL de cache de prompt](/docs/pt/prompt-caching#cache-lifetime) de 1 hora em vez do padrão de 5 minutos. Destinada a usuários de chave de API, [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Usuários de assinatura dentro do uso incluído recebem o TTL de 1 hora automaticamente na [conversa principal](/docs/pt/prompt-caching#which-ttl-each-request-gets). Usuários de assinatura que utilizam [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) podem defini-la para manter o TTL de 1 hora. Gravações de cache de 1 hora são cobradas a uma taxa mais alta. Para escolher o TTL por grupo de requisições, use `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que têm precedência sobre esta variável |464| `ENABLE_PROMPT_CACHING_1H` | Defina como `1` para solicitar um [TTL de cache de prompt](/docs/pt/prompt-caching#cache-lifetime) de 1 hora em vez dos 5 minutos padrão. Destinado a usuários de chave de API, [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Usuários de assinatura dentro do uso incluído recebem o TTL de 1 hora automaticamente na [conversa principal](/docs/pt/prompt-caching#which-ttl-each-request-gets). Usuários de assinatura que utilizam [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) podem defini-la para manter o TTL de 1 hora. Gravações de cache de 1 hora são cobradas a uma taxa mais alta. Para escolher o TTL por grupo de requisições, use `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que têm precedência sobre esta variável |

462| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuada. Use `ENABLE_PROMPT_CACHING_1H` em vez disso |465| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuada. Use `ENABLE_PROMPT_CACHING_1H` em vez disso |

463| `ENABLE_TOOL_SEARCH` | Controla o [MCP Tool Search](/docs/pt/mcp#scale-with-mcp-tool-search). Quando não definida, o Claude Code adia todas as ferramentas MCP por padrão. Ele ainda as carrega antecipadamente em modelos da Agent Platform do Google Cloud anteriores à geração Claude 4.5, em uma implantação do Microsoft Foundry hospedada no Azure e quando `ANTHROPIC_BASE_URL` aponta para um host que não é first-party. `true` sempre adia e envia o cabeçalho beta, exceto nesses mesmos modelos da Agent Platform e implantações do Microsoft Foundry; as requisições falham em proxies que não suportam `tool_reference`. `auto` carrega antecipadamente quando as definições de ferramentas cabem em 10% do contexto. `auto:N` define um limite personalizado, como `auto:5` para 5%. `false` carrega todas as ferramentas antecipadamente. Um valor que você mesmo define é ignorado quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` está definida. Antes da v2.1.221, o Claude Code desativava a busca de ferramentas para todos os modelos na Agent Platform do Google Cloud, a menos que você definisse esta variável como `true` |466| `ENABLE_TOOL_SEARCH` | Controla a [MCP Tool Search](/docs/pt/mcp#scale-with-mcp-tool-search). Quando não definida, o Claude Code adia todas as ferramentas MCP por padrão. Ele ainda as carrega antecipadamente em modelos do Google Cloud's Agent Platform anteriores à geração Claude 4.5, em uma implantação do Microsoft Foundry hospedada no Azure e quando `ANTHROPIC_BASE_URL` aponta para um host que não é first-party. `true` sempre adia e envia o cabeçalho beta, exceto nesses mesmos modelos do Agent Platform e implantações do Microsoft Foundry; as requisições falham em proxies que não suportam `tool_reference`. `auto` carrega antecipadamente quando as definições de ferramentas cabem em 10% do contexto. `auto:N` define um limite personalizado, como `auto:5` para 5%. `false` carrega todas as ferramentas antecipadamente. Um valor que você mesmo define é ignorado quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` está definida. Antes da v2.1.221, o Claude Code desativava a busca de ferramentas para todos os modelos no Google Cloud's Agent Platform, a menos que você definisse esta variável como `true` |

464| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Defina com qualquer valor não vazio, como `1`, para fazer o Claude Code parar de tentar novamente em erros repetidos de sobrecarga para todos os modelos quando nenhum modelo de fallback está configurado. **Defini-la como `0` ou `false` ainda ativa isso**, ao contrário da maioria das variáveis liga/desliga; remova a definição da variável para restaurar o comportamento padrão de novas tentativas. Sem ela, o Claude Code para de tentar novamente dessa forma em modelos que reconhece como modelos Opus, Fable ou Mythos quando você se autentica com uma chave de API ou um [provedor de terceiros](/docs/pt/third-party-integrations) em vez de uma assinatura do Claude. No Claude Code v2.1.160 ou posterior, o Claude Code alterna para sua [cadeia de modelos de fallback](/docs/pt/model-config#fallback-model-chains) configurada em erros repetidos de sobrecarga para qualquer modelo principal, então esta variável não afeta a alternância para um modelo de fallback |467| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Defina com qualquer valor não vazio, como `1`, para fazer o Claude Code parar de tentar novamente em erros de sobrecarga repetidos para todos os modelos quando nenhum modelo de fallback estiver configurado. **Defini-la como `0` ou `false` ainda ativa esse comportamento**, ao contrário da maioria das variáveis liga/desliga; remova a definição da variável para restaurar o comportamento padrão de novas tentativas. Sem ela, o Claude Code para de tentar novamente dessa forma em modelos que reconhece como modelos Opus, Fable ou Mythos quando você se autentica com uma chave de API ou um [provedor de terceiros](/docs/pt/third-party-integrations) em vez de uma assinatura do Claude. No Claude Code v2.1.160 ou posterior, o Claude Code alterna para sua [cadeia de modelos de fallback](/docs/pt/model-config#fallback-model-chains) configurada em erros de sobrecarga repetidos para qualquer modelo principal, então esta variável não afeta a troca para um modelo de fallback |

465| `FORCE_AUTOUPDATE_PLUGINS` | Defina como `1` para forçar atualizações automáticas de plugins mesmo quando o atualizador automático principal está desativado por meio de `DISABLE_AUTOUPDATER` |468| `FORCE_AUTOUPDATE_PLUGINS` | Defina como `1` para forçar atualizações automáticas de plugins mesmo quando o atualizador automático principal está desativado via `DISABLE_AUTOUPDATER` |

466| `FORCE_HYPERLINK` | Defina como `1` para ativar hyperlinks OSC 8 clicáveis quando seu terminal os suporta mas não é detectado automaticamente, ou `0` para desativá-los. Quando não definida, o Claude Code ativa hyperlinks apenas quando detecta suporte do terminal. O Claude Code interpreta este valor como um número, não um booleano, então um valor como `false`, `no` ou `off` ativa os hyperlinks em vez de desativá-los. O [selo de PR ou merge request](/docs/pt/interactive-mode#pr-review-status) do rodapé é renderizado como hyperlink mesmo quando o Claude Code não consegue detectar suporte do terminal, como por SSH. Defina `0` para renderizar o selo como texto simples |469| `FORCE_HYPERLINK` | Defina como `1` para ativar hyperlinks OSC 8 clicáveis quando seu terminal os suporta, mas não é detectado automaticamente, ou `0` para desativá-los. Quando não definida, o Claude Code ativa hyperlinks apenas quando detecta suporte do terminal. O Claude Code interpreta este valor como um número, não como um booleano, portanto um valor como `false`, `no` ou `off` ativa os hyperlinks em vez de desativá-los. O [selo de PR ou merge request](/docs/pt/interactive-mode#pr-review-status) do rodapé é renderizado como hyperlink mesmo quando o Claude Code não consegue detectar suporte do terminal, como via SSH. Defina `0` para renderizar o selo como texto simples |

467| `FORCE_PROMPT_CACHING_5M` | Defina como `1` para forçar o TTL de cache de prompt de 5 minutos mesmo quando o TTL de 1 hora seria aplicado. Sobrescreve `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e as configurações `promptCacheTtl` e `subagentPromptCacheTtl` |470| `FORCE_PROMPT_CACHING_5M` | Defina como `1` para forçar o TTL de cache de prompt de 5 minutos mesmo quando o TTL de 1 hora se aplicaria. Sobrescreve `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e as configurações `promptCacheTtl` e `subagentPromptCacheTtl` |

468| `HTTP_PROXY` | Especifica o servidor proxy HTTP para conexões de rede |471| `HTTP_PROXY` | Especifica o servidor proxy HTTP para conexões de rede |

469| `HTTPS_PROXY` | Especifica o servidor proxy HTTPS para conexões de rede |472| `HTTPS_PROXY` | Especifica o servidor proxy HTTPS para conexões de rede |

470| `IS_DEMO` | Defina com qualquer valor não vazio, como `1`, para ativar o modo de demonstração: oculta seu e-mail e o nome da organização do cabeçalho e da saída de `/status`, e pula o onboarding. **Defini-la como `0` ou `false` ainda ativa o modo de demonstração**, ao contrário da maioria das variáveis liga/desliga; remova a definição da variável para desativá-lo. Útil ao fazer streaming ou gravar uma sessão |473| `IS_DEMO` | Defina com qualquer valor não vazio, como `1`, para ativar o modo de demonstração: oculta seu e-mail e o nome da organização do cabeçalho e da saída de `/status`, e pula o onboarding. **Defini-la como `0` ou `false` ainda ativa o modo de demonstração**, ao contrário da maioria das variáveis de ativar/desativar; remova a definição da variável para desativá-lo. Útil ao transmitir ou gravar uma sessão |

471| `MAX_MCP_OUTPUT_TOKENS` | Número máximo de tokens permitidos nas respostas de ferramentas MCP. O Claude Code exibe um aviso quando a saída excede 10.000 tokens. Ferramentas que declaram [`anthropic/maxResultSizeChars`](/docs/pt/mcp#raise-the-limit-for-a-specific-tool) usam esse limite de caracteres para conteúdo de texto, mas o conteúdo de imagem dessas ferramentas ainda está sujeito a esta variável (padrão: 25000) |474| `MAX_MCP_OUTPUT_TOKENS` | Número máximo de tokens permitidos nas respostas de ferramentas MCP. O Claude Code exibe um aviso quando a saída excede 10.000 tokens. Ferramentas que declaram [`anthropic/maxResultSizeChars`](/docs/pt/mcp#raise-the-limit-for-a-specific-tool) usam esse limite de caracteres para conteúdo de texto, mas o conteúdo de imagem dessas ferramentas ainda está sujeito a esta variável (padrão: 25000) |

472| `MAX_STRUCTURED_OUTPUT_RETRIES` | Número de tentativas que o Claude Code permite quando a resposta do modelo falha na validação contra o [`--json-schema`](/docs/pt/cli-reference#cli-flags) no modo não interativo com a flag `-p`; após esse número de tentativas com falha sem saída válida, a execução falha. O mesmo limite se aplica quando a saída estruturada de um subagente de [workflow](/docs/pt/workflows) falha na validação. O padrão é 5, uma primeira tentativa mais quatro novas tentativas |475| `MAX_STRUCTURED_OUTPUT_RETRIES` | Número de tentativas que o Claude Code permite quando a resposta do modelo falha na validação contra o [`--json-schema`](/docs/pt/cli-reference#cli-flags) no modo não interativo com a flag `-p`; após essa quantidade de tentativas com falha sem saída válida, a execução falha. O mesmo limite se aplica quando a saída estruturada de um subagente de [workflow](/docs/pt/workflows) falha na validação. O padrão é 5, uma primeira tentativa mais quatro novas tentativas |

473| `MAX_THINKING_TOKENS` | Orçamento fixo de tokens para o [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). O Claude Code o limita a um token abaixo do máximo de tokens de saída da requisição e nunca abaixo de 1.024. Consulte `CLAUDE_CODE_MAX_OUTPUT_TOKENS` para saber como esse limite é definido. Quando não definida e o pensamento está ativado, modelos com [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level) escolhem sua própria profundidade de pensamento, e outros modelos usam o limite. Defina como `0` para desativar o pensamento na API da Anthropic, exceto no Opus 5.5, no Sonnet 5.5 e nos modelos Fable, que não podem ter o pensamento desativado. Em [provedores de terceiros](/docs/pt/third-party-integrations), `0` omite o parâmetro `thinking`. Com o pensamento desativado na API da Anthropic, o Claude Code envia o esforço `high` em vez de um nível mais alto para modelos que ele sabe que [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como o Opus 5. O Claude Code ignora valores diferentes de zero em modelos de raciocínio adaptativo, exceto nos modelos em que `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` desativa o raciocínio adaptativo |476| `MAX_THINKING_TOKENS` | Orçamento fixo de tokens para o [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). O Claude Code o limita a um token abaixo do máximo de tokens de saída da requisição e nunca abaixo de 1.024. Consulte `CLAUDE_CODE_MAX_OUTPUT_TOKENS` para saber como esse limite é definido. Quando não definida e o pensamento está ativado, os modelos com [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level) escolhem sua própria profundidade de pensamento, e os outros modelos usam o limite. Defina como `0` para desativar o pensamento na Anthropic API, exceto no Opus 5.5, no Sonnet 5.5 e nos modelos Fable, que não podem ter o pensamento desativado. Em [provedores de terceiros](/docs/pt/third-party-integrations), `0` omite o parâmetro `thinking` em vez disso. Com o pensamento desativado na Anthropic API, o Claude Code envia o esforço `high` em vez de um nível mais alto para modelos que ele sabe que [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como o Opus 5. Para um valor positivo, o Claude Code ignora o próprio número em modelos com raciocínio adaptativo, exceto quando `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` desativa o raciocínio adaptativo |

474| `MCP_CLIENT_SECRET` | Client secret OAuth para servidores MCP que exigem [credenciais pré-configuradas](/docs/pt/mcp#use-pre-configured-oauth-credentials). Evita o prompt interativo ao adicionar um servidor com `--client-secret` |477| `MCP_CLIENT_SECRET` | Segredo de cliente OAuth para servidores MCP que exigem [credenciais pré-configuradas](/docs/pt/mcp#use-pre-configured-oauth-credentials). Evita o prompt interativo ao adicionar um servidor com `--client-secret` |

475| `MCP_CONNECTION_NONBLOCKING` | Controla se a inicialização espera que os servidores MCP se conectem antes da primeira consulta. A inicialização do MCP é não bloqueante por padrão: os servidores se conectam em segundo plano e suas ferramentas ficam disponíveis à medida que terminam. Defina como `0` para fazer o Claude Code esperar que os servidores se conectem antes da primeira consulta. Servidores configurados com [`alwaysLoad: true`](/docs/pt/mcp#exempt-a-server-from-deferral) ainda fazem a inicialização esperar independentemente disso, exceto quando servidos a partir do [cache de descoberta](/docs/pt/mcp#server-status-detail), já que suas ferramentas precisam estar presentes quando o primeiro prompt é construído. No modo não interativo (`-p`) sem `--input-format stream-json`, o Claude Code também espera pelos servidores ainda pendentes antes do primeiro turno, independentemente desta variável. Quando você passa [`--mcp-config`](/docs/pt/cli-reference#cli-flags) explicitamente, a espera tem um prazo maior; consulte a entrada dessa flag para a exceção de servidores em cache |478| `MCP_CONNECTION_NONBLOCKING` | Controla se a inicialização espera que os servidores MCP se conectem antes da primeira consulta. A inicialização do MCP não é bloqueante por padrão: os servidores se conectam em segundo plano e suas ferramentas ficam disponíveis à medida que terminam. Defina como `0` para fazer o Claude Code esperar que os servidores se conectem antes da primeira consulta. Servidores configurados com [`alwaysLoad: true`](/docs/pt/mcp#exempt-a-server-from-deferral) ainda fazem a inicialização esperar de qualquer forma, exceto quando servidos a partir do [cache de descoberta](/docs/pt/mcp#server-status-detail), já que suas ferramentas precisam estar presentes quando o primeiro prompt é montado. No modo não interativo (`-p`) sem `--input-format stream-json`, o Claude Code também espera pelos servidores ainda pendentes antes do primeiro turno, independentemente desta variável. Quando você passa [`--mcp-config`](/docs/pt/cli-reference#cli-flags) explicitamente, a espera tem um prazo mais longo; consulte a entrada dessa flag para a exceção de servidores em cache |

476| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo a inicialização bloqueante do MCP espera, em milissegundos, pelo lote de conexões antes de capturar a lista de ferramentas (padrão: 5000). Aplica-se quando `MCP_CONNECTION_NONBLOCKING=0` ou para servidores marcados com [`alwaysLoad: true`](/docs/pt/mcp#exempt-a-server-from-deferral). Servidores ainda pendentes no prazo continuam se conectando em segundo plano. Diferente de `MCP_TIMEOUT`, que limita a tentativa de conexão de um servidor individual |479| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo a inicialização bloqueante do MCP espera, em milissegundos, pelo lote de conexões antes de capturar um snapshot da lista de ferramentas (padrão: 5000). Aplica-se quando `MCP_CONNECTION_NONBLOCKING=0` ou para servidores marcados com [`alwaysLoad: true`](/docs/pt/mcp#exempt-a-server-from-deferral). Servidores ainda pendentes no prazo continuam se conectando em segundo plano. Diferente de `MCP_TIMEOUT`, que limita a tentativa de conexão de um servidor individual |

477| `MCP_DISCOVERY_CACHE` | Ativa ou desativa o [cache de descoberta do MCP](/docs/pt/mcp#server-status-detail). Com o cache ativado, um servidor HTTP ou SSE remoto que você já usou antes pode mostrar o [status `cached`](/docs/pt/mcp#server-status-detail), e o Claude Code o conecta na primeira chamada de ferramenta em vez de na inicialização. O cache fica desativado por padrão, a menos que uma implantação gradual o tenha ativado para sua conta. Defina como `1` para ativá-lo, ou `0` para mantê-lo desativado mesmo quando a implantação o tiver ativado. Antes da v2.1.238, o cache ficava ativado por padrão. O status `cached` requer Claude Code v2.1.221 ou posterior |480| `MCP_DISCOVERY_CACHE` | Ativa ou desativa o [cache de descoberta do MCP](/docs/pt/mcp#server-status-detail). Com o cache ativado, um servidor HTTP ou SSE remoto que você já usou pode mostrar o [status `cached`](/docs/pt/mcp#server-status-detail), e o Claude Code o conecta na sua primeira chamada de ferramenta em vez de na inicialização. O cache fica desativado por padrão, a menos que uma implantação gradual o tenha ativado para sua conta. Defina como `1` para ativá-lo, ou `0` para mantê-lo desativado mesmo quando a implantação gradual o tiver ativado. Antes da v2.1.238, o cache ficava ativado por padrão. O status `cached` requer Claude Code v2.1.221 ou posterior |

478| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Idade máxima, em segundos, de uma entrada do [cache de descoberta](/docs/pt/mcp#server-status-detail) (padrão: 14400, ou 4 horas). Em uma inicialização em que a entrada é mais antiga que isso, o Claude Code a descarta e conecta o servidor na inicialização, como faz com o cache desativado. O Claude Code limita o valor a 7 dias. Antes da v2.1.238, o padrão era 86400, ou 24 horas, e o Claude Code não limitava o valor |481| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Idade máxima, em segundos, de uma entrada do [cache de descoberta](/docs/pt/mcp#server-status-detail) (padrão: 14400, ou 4 horas). Em uma inicialização em que a entrada é mais antiga que isso, o Claude Code a descarta e conecta o servidor na inicialização, como faz com o cache desativado. O Claude Code limita o valor a 7 dias. Antes da v2.1.238, o padrão era 86400, ou 24 horas, e o Claude Code não limitava o valor |

479| `MCP_DISCOVERY_CACHE_STRIKES` | Em uma inicialização em que uma entrada do [cache de descoberta](/docs/pt/mcp#server-status-detail) é mais antiga que `MCP_DISCOVERY_CACHE_TTL_S`, o Claude Code a atualiza em segundo plano. Esta variável define quantas atualizações seguidas podem falhar antes que o Claude Code descarte a entrada e conecte o servidor na próxima inicialização (padrão: 1). Aumente-a se sua conexão de rede cair ocasionalmente, para que uma única atualização com falha não descarte a entrada. Requer Claude Code v2.1.238 ou posterior |482| `MCP_DISCOVERY_CACHE_STRIKES` | Em uma inicialização em que uma entrada do [cache de descoberta](/docs/pt/mcp#server-status-detail) é mais antiga que `MCP_DISCOVERY_CACHE_TTL_S`, o Claude Code a atualiza em segundo plano. Esta variável define quantas atualizações seguidas podem falhar antes que o Claude Code descarte a entrada e, em vez disso, conecte o servidor na próxima inicialização (padrão: 1). Aumente-a se sua conexão de rede cair ocasionalmente, para que uma única atualização com falha não descarte a entrada. Requer Claude Code v2.1.238 ou posterior |

480| `MCP_DISCOVERY_CACHE_TTL_S` | Segundos durante os quais o Claude Code usa uma entrada do [cache de descoberta](/docs/pt/mcp#server-status-detail) sem atualizá-la (padrão: 900). Em uma inicialização em que a entrada é mais antiga que isso, o Claude Code ainda a usa, mas a atualiza em segundo plano. Quando a entrada fica mais antiga que `MCP_DISCOVERY_CACHE_MAX_STALE_S`, o Claude Code a descarta. O Claude Code limita o valor a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, que é de 4 horas por padrão. Antes da v2.1.238, o Claude Code não limitava o valor |483| `MCP_DISCOVERY_CACHE_TTL_S` | Segundos durante os quais o Claude Code usa uma entrada do [cache de descoberta](/docs/pt/mcp#server-status-detail) sem atualizá-la (padrão: 900). Em uma inicialização em que a entrada é mais antiga que isso, o Claude Code ainda a usa, mas a atualiza em segundo plano. Quando a entrada fica mais antiga que `MCP_DISCOVERY_CACHE_MAX_STALE_S`, o Claude Code a descarta em vez disso. O Claude Code limita o valor a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, que é 4 horas por padrão. Antes da v2.1.238, o Claude Code não limitava o valor |

481| `MCP_OAUTH_CALLBACK_PORT` | Porta fixa para o callback de redirecionamento OAuth, como alternativa a `--callback-port` ao adicionar um servidor MCP com [credenciais pré-configuradas](/docs/pt/mcp#use-pre-configured-oauth-credentials) |484| `MCP_OAUTH_CALLBACK_PORT` | Porta fixa para o callback de redirecionamento OAuth, como alternativa a `--callback-port` ao adicionar um servidor MCP com [credenciais pré-configuradas](/docs/pt/mcp#use-pre-configured-oauth-credentials) |

482| `MCP_PROTOCOL_NEGOTIATION` | Apenas no [runtime de cliente MCP v2](/docs/pt/mcp#mcp-client-runtimes), define se o Claude Code sonda os servidores em busca da revisão de protocolo MCP 2026-07-28. Defina `auto` para sondar servidores HTTP, de conector do claude.ai e stdio, ou `legacy` para não sondar nenhum. Com a variável não definida, o Claude Code sonda os servidores descritos em [Runtimes de cliente MCP](/docs/pt/mcp#mcp-client-runtimes). Qualquer outro valor é ignorado com um aviso no log de depuração. Requer Claude Code v2.1.221 ou posterior |485| `MCP_PROTOCOL_NEGOTIATION` | Apenas no [runtime de cliente MCP v2](/docs/pt/mcp#mcp-client-runtimes), define se o Claude Code sonda os servidores em busca da revisão 2026-07-28 do protocolo MCP. Defina `auto` para sondar servidores HTTP, de conector do claude.ai e stdio, ou `legacy` para não sondar nenhum. Com a variável não definida, o Claude Code sonda os servidores descritos em [Runtimes de cliente MCP](/docs/pt/mcp#mcp-client-runtimes). Qualquer outro valor é ignorado com um aviso no log de depuração. Requer Claude Code v2.1.221 ou posterior |

483| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP remotos (HTTP/SSE) a conectar em paralelo durante a inicialização (padrão: 20) |486| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP remotos (HTTP/SSE) a conectar em paralelo durante a inicialização (padrão: 20) |

484| `MCP_SDK_GENERATION` | Fixa com qual [runtime de cliente MCP](/docs/pt/mcp#mcp-client-runtimes) este processo se conecta aos servidores MCP: `v1`, construído sobre o MCP TypeScript SDK 1.x, ou `v2`, construído sobre o [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Sem a variável, o Claude Code usa o v2, a partir das versões listadas nessa seção. No Claude Code v2.1.221 ou posterior, o runtime v2 verifica o emissor que um servidor OAuth MCP retorna em sua resposta de autorização e faz o login falhar com um erro que começa com `Issuer mismatch in authorization response` quando ele não corresponde. O runtime v1 não executa essa verificação. Se você definir um valor não reconhecido, o Claude Code o ignora e grava um aviso no log de depuração. O Claude Code lê o valor uma vez por processo. Requer Claude Code v2.1.218 ou posterior |487| `MCP_SDK_GENERATION` | Fixa qual [runtime de cliente MCP](/docs/pt/mcp#mcp-client-runtimes) este processo usa para se conectar aos servidores MCP: `v1`, baseado no MCP TypeScript SDK 1.x, ou `v2`, baseado no [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Sem a variável, o Claude Code usa o v2, a partir das versões listadas nessa seção. No Claude Code v2.1.221 ou posterior, o runtime v2 verifica o emissor que um servidor OAuth do MCP retorna em sua resposta de autorização e faz o login falhar com um erro que começa com `Issuer mismatch in authorization response` quando ele não corresponde. O runtime v1 não executa essa verificação. Se você definir um valor não reconhecido, o Claude Code o ignora e grava um aviso no log de depuração. O Claude Code lê o valor uma vez por processo. Requer Claude Code v2.1.218 ou posterior |

485| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP locais (stdio) a conectar em paralelo durante a inicialização (padrão: 3) |488| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP locais (stdio) a conectar em paralelo durante a inicialização (padrão: 3) |

486| `MCP_TIMEOUT` | Timeout em milissegundos para a inicialização do servidor MCP (padrão: 30000, ou 30 segundos) |489| `MCP_TIMEOUT` | Timeout em milissegundos para a inicialização do servidor MCP (padrão: 30000, ou 30 segundos) |

487| `MCP_TOOL_TIMEOUT` | Timeout em milissegundos para a execução de ferramentas MCP (padrão: 100000000, cerca de 28 horas). Para um servidor HTTP, SSE ou de conector do claude.ai, cada requisição também atinge o timeout após 60 segundos por padrão; defina esta variável, ou o `timeout` por servidor, acima de 60000 para aumentar esse limite por requisição. Um valor menor ainda encurta o timeout geral de execução da ferramenta, mas mantém o limite por requisição em 60 segundos. Servidores stdio e WebSocket não têm temporizador por requisição. Um campo `timeout` por servidor em `.mcp.json` sobrescreve esta variável para aquele servidor. Um `timeout` por servidor de pelo menos 1000 também define a janela mínima de inatividade para as chamadas de ferramenta daquele servidor, de modo que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca as aborte antes; esse piso requer Claude Code v2.1.203 ou posterior. Para a variável de ambiente, valores abaixo de 1000 são arredondados para um segundo; para o campo por servidor, valores abaixo de 1000 são ignorados |490| `MCP_TOOL_TIMEOUT` | Timeout em milissegundos para a execução de ferramentas MCP (padrão: 100000000, cerca de 28 horas). Para um servidor HTTP, SSE ou de conector do claude.ai, cada requisição também atinge o timeout após 60 segundos por padrão; defina esta variável, ou o `timeout` por servidor, acima de 60000 para aumentar esse limite por requisição. Um valor menor ainda encurta o timeout geral de execução da ferramenta, mas mantém o limite por requisição em 60 segundos. Servidores stdio e WebSocket não têm temporizador por requisição. Um campo `timeout` por servidor em `.mcp.json` sobrescreve isso para esse servidor. Um `timeout` por servidor de pelo menos 1000 também define a janela mínima de inatividade para as chamadas de ferramenta desse servidor, de modo que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca as aborte antes; esse piso requer Claude Code v2.1.203 ou posterior. Para a variável de ambiente, valores abaixo de 1000 são elevados para um segundo; para o campo por servidor, valores abaixo de 1000 são ignorados |

488| `NO_PROXY` | Lista de domínios e IPs para os quais as requisições serão enviadas diretamente, ignorando o proxy |491| `NO_PROXY` | Lista de domínios e IPs para os quais as requisições serão enviadas diretamente, ignorando o proxy |

489| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite padrão do SDK do OpenTelemetry para o comprimento de valores de atributos. O Claude Code limita atributos de telemetria com conteúdo ao menor valor entre este e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, para que o marcador de truncamento fique dentro do limite do SDK. O Claude Code lê as variantes `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` da mesma forma, e o menor valor definido se aplica a todos os sinais. Requer Claude Code v2.1.214 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage#common-configuration-variables) |492| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite padrão do SDK do OpenTelemetry para o comprimento do valor de atributos. O Claude Code limita os atributos de telemetria com conteúdo ao menor valor entre este e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, para que o marcador de truncamento permaneça dentro do limite do SDK. O Claude Code lê as variantes `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` da mesma forma, e o menor valor definido se aplica a todos os sinais. Requer Claude Code v2.1.214 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage#common-configuration-variables) |

490| `OTEL_LOG_ASSISTANT_RESPONSES` | Defina como `1` para incluir o texto de resposta do modelo nos eventos de log `assistant_response` do OpenTelemetry. Quando não definida, o Claude Code usa o valor de `OTEL_LOG_USER_PROMPTS`. Defina como `0` para manter as respostas ocultadas mesmo quando `OTEL_LOG_USER_PROMPTS` está definida. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.193 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage#assistant-response-event) |493| `OTEL_LOG_ASSISTANT_RESPONSES` | Defina como `1` para incluir o texto de resposta do modelo nos eventos de log `assistant_response` do OpenTelemetry. Quando não definida, o Claude Code usa o valor de `OTEL_LOG_USER_PROMPTS` em vez disso. Defina como `0` para manter as respostas ocultadas mesmo quando `OTEL_LOG_USER_PROMPTS` estiver definida. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.193 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage#assistant-response-event) |

491| `OTEL_LOG_MANAGED_SETTINGS` | Defina como `1` para adicionar as configurações gerenciadas ocultadas, e um digest SHA-256 das configurações antes da ocultação, aos eventos de log `managed_settings_resolved` do OpenTelemetry. Desativada por padrão. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas; um valor nas configurações de projeto ou locais não a ativa. Requer Claude Code v2.1.274 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage#managed-settings-resolved-event) |494| `OTEL_LOG_MANAGED_SETTINGS` | Defina como `1` para adicionar as configurações gerenciadas com dados ocultados, e um digest SHA-256 das configurações antes da ocultação, aos eventos de log `managed_settings_resolved` do OpenTelemetry. Desativado por padrão. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas; um valor nas configurações de projeto ou locais não a ativa. Requer Claude Code v2.1.274 ou posterior. Consulte [Monitoramento](/docs/pt/monitoring-usage#managed-settings-resolved-event) |

492| `OTEL_LOG_RAW_API_BODIES` | Emite o JSON de requisição e resposta da Messages API da Anthropic como eventos de log `api_request_body` / `api_response_body`. Defina como `1` para corpos inline truncados no limite de conteúdo, ou `file:<dir>` para gravar corpos não truncados em disco e emitir um caminho `body_ref` em vez disso. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura o limite de conteúdo, 60 KB por padrão. Desativada por padrão; os corpos incluem todo o histórico da conversa. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Consulte [Monitoramento](/docs/pt/monitoring-usage#api-request-body-event) |495| `OTEL_LOG_RAW_API_BODIES` | Emite o JSON de requisição e resposta da Anthropic Messages API como eventos de log `api_request_body` / `api_response_body`. Defina como `1` para corpos inline truncados no limite de conteúdo, ou `file:<dir>` para gravar corpos não truncados em disco e emitir um caminho `body_ref` em vez disso. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura o limite de conteúdo, 60 KB por padrão. Desativado por padrão; os corpos incluem todo o histórico da conversa. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Consulte [Monitoramento](/docs/pt/monitoring-usage#api-request-body-event) |

493| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir o conteúdo da ferramenta no evento de span `tool.output` do OpenTelemetry. Os atributos de span carregam o conteúdo da ferramenta sob [seus próprios controles](/docs/pt/monitoring-usage#new-context-gates). Requer [rastreamento](/docs/pt/monitoring-usage#traces-beta). Desativada por padrão para proteger dados sensíveis. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. Consulte [Monitoramento](/docs/pt/monitoring-usage#tool-output-span-event) |496| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir o conteúdo das ferramentas no evento de span `tool.output` do OpenTelemetry. Os atributos de span carregam conteúdo de ferramentas sob [seus próprios controles](/docs/pt/monitoring-usage#new-context-gates). Requer [rastreamento](/docs/pt/monitoring-usage#traces-beta). Desativado por padrão para proteger dados sensíveis. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. Consulte [Monitoramento](/docs/pt/monitoring-usage#tool-output-span-event) |

494| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada de ferramentas; nomes de servidores MCP; nomes de workflows criados pelo usuário; strings de erro brutas em falhas de ferramentas; a `category` de recusa em eventos `api_refusal`; nomes reais de agentes, skills, plugins e servidores MCP nas [métricas de custo e de tokens](/docs/pt/monitoring-usage#cost-counter); e outros detalhes de ferramentas em métricas, traces e logs do OpenTelemetry. Desativada por padrão para proteger PII. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. Consulte [Monitoramento](/docs/pt/monitoring-usage) |497| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada de ferramentas; nomes de servidores MCP; nomes de workflows criados pelo usuário; strings de erro brutas em falhas de ferramentas; a `category` de recusa em eventos `api_refusal`; nomes reais de agentes, skills, plugins e servidores MCP nas [métricas de custo e tokens](/docs/pt/monitoring-usage#cost-counter); e outros detalhes de ferramentas em métricas, traces e logs do OpenTelemetry. Desativado por padrão para proteger PII. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. Consulte [Monitoramento](/docs/pt/monitoring-usage) |

495| `OTEL_LOG_USER_PROMPTS` | Defina como `1` para incluir o texto dos prompts do usuário em traces e logs do OpenTelemetry. Desativada por padrão (os prompts são ocultados). Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. Consulte [Monitoramento](/docs/pt/monitoring-usage) |498| `OTEL_LOG_USER_PROMPTS` | Defina como `1` para incluir o texto do prompt do usuário em traces e logs do OpenTelemetry. Desativado por padrão (os prompts são ocultados). Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. Consulte [Monitoramento](/docs/pt/monitoring-usage) |

496| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Defina como `false` para excluir o UUID da conta dos atributos de métricas (padrão: incluído). Consulte [Monitoramento](/docs/pt/monitoring-usage) |499| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Defina como `false` para excluir o UUID da conta dos atributos de métricas (padrão: incluído). Consulte [Monitoramento](/docs/pt/monitoring-usage) |

497| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Defina como `true` para incluir o entrypoint da sessão nos atributos de métricas (padrão: excluído). Adicionada na v2.1.152. Consulte [Monitoramento](/docs/pt/monitoring-usage) |500| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Defina como `true` para incluir o ponto de entrada da sessão nos atributos de métricas (padrão: excluído). Adicionada na v2.1.152. Consulte [Monitoramento](/docs/pt/monitoring-usage) |

498| `OTEL_METRICS_INCLUDE_REPOSITORY` | Defina como `true` para marcar métricas e eventos do OpenTelemetry com atributos `vcs.*` que identificam o repositório da sessão (padrão: excluído). Requer Claude Code v2.1.269 ou posterior. Consulte [Atributos de repositório](/docs/pt/monitoring-usage#repository-attributes) |501| `OTEL_METRICS_INCLUDE_REPOSITORY` | Defina como `true` para marcar métricas e eventos do OpenTelemetry com atributos `vcs.*` que identificam o repositório da sessão (padrão: excluído). Requer Claude Code v2.1.269 ou posterior. Consulte [Atributos de repositório](/docs/pt/monitoring-usage#repository-attributes) |

499| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partir da v2.1.161, o Claude Code anexa as chaves de `OTEL_RESOURCE_ATTRIBUTES` aos rótulos dos pontos de dados de métricas. Defina como `false` para excluí-las (padrão: incluídas). Consulte [Monitoramento](/docs/pt/monitoring-usage#multi-team-organization-support) |502| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partir da v2.1.161, o Claude Code anexa as chaves de `OTEL_RESOURCE_ATTRIBUTES` aos rótulos dos pontos de dados de métricas. Defina como `false` para excluí-las (padrão: incluídas). Consulte [Monitoramento](/docs/pt/monitoring-usage#multi-team-organization-support) |

500| `OTEL_METRICS_INCLUDE_SESSION_ID` | Defina como `false` para excluir o ID da sessão dos atributos de métricas (padrão: incluído). Consulte [Monitoramento](/docs/pt/monitoring-usage) |503| `OTEL_METRICS_INCLUDE_SESSION_ID` | Defina como `false` para excluir o ID da sessão dos atributos de métricas (padrão: incluído). Consulte [Monitoramento](/docs/pt/monitoring-usage) |

501| `OTEL_METRICS_INCLUDE_VERSION` | Defina como `true` para incluir a versão do Claude Code nos atributos de métricas (padrão: excluído). Consulte [Monitoramento](/docs/pt/monitoring-usage) |504| `OTEL_METRICS_INCLUDE_VERSION` | Defina como `true` para incluir a versão do Claude Code nos atributos de métricas (padrão: excluída). Consulte [Monitoramento](/docs/pt/monitoring-usage) |

502| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sobrescreve o orçamento de caracteres para os metadados de skills mostrados à [ferramenta Skill](/docs/pt/skills#control-who-invokes-a-skill). O orçamento escala dinamicamente em 1% da janela de contexto, com um fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores |505| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sobrescreve o orçamento de caracteres para os metadados de skills exibidos à [ferramenta Skill](/docs/pt/skills#control-who-invokes-a-skill). O orçamento é dimensionado dinamicamente em 1% da janela de contexto, com um fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores |

503| `TASK_MAX_OUTPUT_LENGTH` | Removida na v2.1.277 e agora sem efeito, junto com a ferramenta `TaskOutput` que ela dimensionava. Anteriormente definia o número máximo de caracteres da saída de uma [tarefa em segundo plano](/docs/pt/tools-reference#background-commands) que a ferramenta `TaskOutput` mantinha. O Claude lê o arquivo de saída de uma tarefa em segundo plano com `Read` em vez disso |506| `TASK_MAX_OUTPUT_LENGTH` | Removida na v2.1.277 e agora sem efeito, junto com a ferramenta `TaskOutput` cujo tamanho ela definia. Anteriormente definia o número máximo de caracteres da saída de uma [tarefa em segundo plano](/docs/pt/tools-reference#background-commands) que a ferramenta `TaskOutput` mantinha. O Claude lê o arquivo de saída de uma tarefa em segundo plano com `Read` em vez disso |

504| `USE_BUILTIN_RIPGREP` | Defina como `0` para usar o `rg` instalado no sistema em vez do `rg` incluído com o Claude Code |507| `USE_BUILTIN_RIPGREP` | Defina como `0` para usar o `rg` instalado no sistema em vez do `rg` incluído no Claude Code |

505| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Sobrescreve a região do Claude 3.5 Haiku ao usar a Agent Platform do Google Cloud |508| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Sobrescreve a região do Claude 3.5 Haiku ao usar o Google Cloud's Agent Platform |

506| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Sobrescreve a região do Claude 3.5 Sonnet ao usar a Agent Platform do Google Cloud |509| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Sobrescreve a região do Claude 3.5 Sonnet ao usar o Google Cloud's Agent Platform |

507| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Sobrescreve a região do Claude 3.7 Sonnet ao usar a Agent Platform do Google Cloud |510| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Sobrescreve a região do Claude 3.7 Sonnet ao usar o Google Cloud's Agent Platform |

508| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Sobrescreve a região do Claude 4.0 Opus ao usar a Agent Platform do Google Cloud |511| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Sobrescreve a região do Claude 4.0 Opus ao usar o Google Cloud's Agent Platform |

509| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Sobrescreve a região do Claude 4.0 Sonnet ao usar a Agent Platform do Google Cloud |512| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Sobrescreve a região do Claude 4.0 Sonnet ao usar o Google Cloud's Agent Platform |

510| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Sobrescreve a região do Claude 4.1 Opus ao usar a Agent Platform do Google Cloud |513| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Sobrescreve a região do Claude 4.1 Opus ao usar o Google Cloud's Agent Platform |

511| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Sobrescreve a região do Claude Opus 4.5 ao usar a Agent Platform do Google Cloud |514| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Sobrescreve a região do Claude Opus 4.5 ao usar o Google Cloud's Agent Platform |

512| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Sobrescreve a região do Claude Sonnet 4.5 ao usar a Agent Platform do Google Cloud |515| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Sobrescreve a região do Claude Sonnet 4.5 ao usar o Google Cloud's Agent Platform |

513| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Sobrescreve a região do Claude Opus 4.6 ao usar a Agent Platform do Google Cloud |516| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Sobrescreve a região do Claude Opus 4.6 ao usar o Google Cloud's Agent Platform |

514| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Sobrescreve a região do Claude Sonnet 4.6 ao usar a Agent Platform do Google Cloud |517| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Sobrescreve a região do Claude Sonnet 4.6 ao usar o Google Cloud's Agent Platform |

515| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Sobrescreve a região do Claude Opus 4.7 ao usar a Agent Platform do Google Cloud |518| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Sobrescreve a região do Claude Opus 4.7 ao usar o Google Cloud's Agent Platform |

516| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Sobrescreve a região do Claude Opus 4.8 ao usar a Agent Platform do Google Cloud |519| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Sobrescreve a região do Claude Opus 4.8 ao usar o Google Cloud's Agent Platform |

517| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Sobrescreve a região do Claude Opus 5.5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.280 |520| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Sobrescreve a região do Claude Opus 5.5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.280 |

518| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Sobrescreve a região do Claude Sonnet 5.5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.284 |521| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Sobrescreve a região do Claude Sonnet 5.5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.284 |

519| `VERTEX_REGION_CLAUDE_5_OPUS` | Sobrescreve a região do Claude Opus 5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.219 |522| `VERTEX_REGION_CLAUDE_5_OPUS` | Sobrescreve a região do Claude Opus 5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.219 |

520| `VERTEX_REGION_CLAUDE_5_SONNET` | Sobrescreve a região do Claude Sonnet 5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.197 |523| `VERTEX_REGION_CLAUDE_5_SONNET` | Sobrescreve a região do Claude Sonnet 5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.197 |

521| `VERTEX_REGION_CLAUDE_FABLE_5` | Sobrescreve a região do Claude Fable 5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.170 |524| `VERTEX_REGION_CLAUDE_FABLE_5` | Sobrescreve a região do Claude Fable 5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.170 |

522| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sobrescreve a região do Claude Fable 5.1 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.257 |525| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sobrescreve a região do Claude Fable 5.1 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.257 |

523| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sobrescreve a região do Claude Haiku 4.5 ao usar a Agent Platform do Google Cloud |526| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sobrescreve a região do Claude Haiku 4.5 ao usar o Google Cloud's Agent Platform |

524 527 

525As variáveis padrão de exportador do OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` e variantes específicas de sinal) também são suportadas. Consulte [Monitoramento](/docs/pt/monitoring-usage) para detalhes de configuração.528As variáveis padrão de exportador do OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` e variantes específicas de sinal) também são suportadas. Consulte [Monitoramento](/docs/pt/monitoring-usage) para detalhes de configuração.

526 529 

527Defina `CLAUDE_CODE_ENABLE_TELEMETRY` e as variáveis do OpenTelemetry que ativam a exportação, escolhem seu destino ou capturam conteúdo no seu shell, nas configurações de usuário ou nas configurações gerenciadas. O Claude Code [as ignora nas configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. `OTEL_RESOURCE_ATTRIBUTES` e as variáveis de intervalo de exportação, timeout e compressão, como `OTEL_METRIC_EXPORT_INTERVAL`, ainda se aplicam a partir das configurações de projeto e locais.530Defina `CLAUDE_CODE_ENABLE_TELEMETRY` e as variáveis do OpenTelemetry que ativam a exportação, escolhem seu destino ou capturam conteúdo no seu shell, nas configurações de usuário ou nas configurações gerenciadas. O Claude Code [as ignora nas configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. `OTEL_RESOURCE_ATTRIBUTES` e as variáveis de intervalo, timeout e compressão da exportação, como `OTEL_METRIC_EXPORT_INTERVAL`, ainda se aplicam a partir das configurações de projeto e locais.

528 531 

529<h2 id="features-that-need-feature-flag-fetching">532<h2 id="features-that-need-feature-flag-fetching">

530 Recursos que precisam de busca de feature-flag533 Recursos que precisam de busca de feature-flag

Details

248| **Subagents** | Quando gerado | Contexto fresco com skills especificadas, ou a conversa pai para um [fork](/docs/pt/sub-agents#fork-the-current-conversation) | Isolado da sessão principal |248| **Subagents** | Quando gerado | Contexto fresco com skills especificadas, ou a conversa pai para um [fork](/docs/pt/sub-agents#fork-the-current-conversation) | Isolado da sessão principal |

249| **Hooks** | No disparo | Nada (executa externamente) | Zero, a menos que hook retorne contexto adicional |249| **Hooks** | No disparo | Nada (executa externamente) | Zero, a menos que hook retorne contexto adicional |

250 250 

251\*Por padrão, descrições de skill carregam no início da sessão para que Claude possa decidir quando usá-las. Defina `disable-model-invocation: true` no frontmatter de uma skill para ocultá-la de Claude inteiramente até que você a invoque manualmente. Para uma skill que você não escreveu, defina [`skillOverrides`](/docs/pt/skills#override-skill-visibility-from-settings) em configurações para fazer o mesmo sem editar seu arquivo.251\*Defina [`disable-model-invocation: true`](/docs/pt/skills#control-who-invokes-a-skill) no frontmatter de uma skill para manter sua descrição fora do contexto de Claude. Para uma skill que você não escreveu, defina [`skillOverrides`](/docs/pt/skills#override-skill-visibility-from-settings) em configurações para fazer o mesmo sem editar seu arquivo.

252 252 

253<h3 id="understand-how-features-load">253<h3 id="understand-how-features-load">

254 Entender como os recursos carregam254 Entender como os recursos carregam


278 278 

279 **O que carrega:** Para skills invocáveis por modelo, Claude vê nomes e descrições em cada requisição. Quando você invoca uma skill com `/<name>` ou Claude a carrega automaticamente, o conteúdo completo carrega em sua conversa.279 **O que carrega:** Para skills invocáveis por modelo, Claude vê nomes e descrições em cada requisição. Quando você invoca uma skill com `/<name>` ou Claude a carrega automaticamente, o conteúdo completo carrega em sua conversa.

280 280 

281 **Como Claude escolhe skills:** Claude corresponde sua tarefa contra descrições de skill para decidir quais são relevantes. Se descrições forem vagas ou se sobrepuserem, Claude pode carregar a skill errada ou perder uma que ajudaria. Para dizer a Claude para usar uma skill específica, invoque-a com `/<name>`. Skills com `disable-model-invocation: true` são invisíveis a Claude até que você as invoque.281 **Como Claude escolhe skills:** Claude corresponde sua tarefa contra descrições de skill para decidir quais são relevantes. Se descrições forem vagas ou se sobrepuserem, Claude pode carregar a skill errada ou perder uma que ajudaria. Para dizer a Claude para usar uma skill específica, invoque-a com `/<name>`.

282 282 

283 **Custo de contexto:** Baixo até ser usado. Skills apenas de usuário têm custo zero até invocação.283 **Custo de contexto:** Baixo até ser usado. Skills apenas de usuário têm custo zero até invocação.

284 284 

285 **Em subagents:** Skills funcionam diferentemente em subagents. Em vez de carregamento sob demanda, skills listadas no campo `skills` do subagent são totalmente pré-carregadas em seu contexto no lançamento. Subagents ainda podem descobrir e invocar skills de projeto, usuário e plugin não listadas através da ferramenta Skill.285 **Em subagents:** Skills funcionam diferentemente em subagents. Em vez de carregamento sob demanda, skills listadas no campo `skills` do subagent são totalmente pré-carregadas em seu contexto no lançamento. Subagents ainda podem descobrir e invocar skills de projeto, usuário e plugin não listadas através da ferramenta Skill.

286 286 

287 <Tip>Use `disable-model-invocation: true` para skills com efeitos colaterais. Isso economiza contexto e garante que apenas você as dispare.</Tip>287 <Tip>Use `disable-model-invocation: true` para skills com efeitos colaterais. Isso economiza contexto e garante que sejam executadas apenas quando você as nomear.</Tip>

288 </Tab>288 </Tab>

289 289 

290 <Tab title="Servidores MCP">290 <Tab title="Servidores MCP">

fullscreen.md +3 −3

Details

107* **Role uma lista que transborda com a barra de rolagem dela.** Em painéis de lista como `/skills`, `/mcp` e a lista Installed do `/plugin`, uma barra de rolagem aparece ao lado de uma lista com mais linhas do que cabem enquanto o ponteiro está sobre ela. Clique na trilha para pular para aquele ponto ou arraste o indicador. Requer Claude Code v2.1.281 ou posterior.107* **Role uma lista que transborda com a barra de rolagem dela.** Em painéis de lista como `/skills`, `/mcp` e a lista Installed do `/plugin`, uma barra de rolagem aparece ao lado de uma lista com mais linhas do que cabem enquanto o ponteiro está sobre ela. Clique na trilha para pular para aquele ponto ou arraste o indicador. Requer Claude Code v2.1.281 ou posterior.

108 * Onde a barra tem setas `↑` e `↓` nas extremidades, clique em uma seta para rolar uma única linha ou mantenha-a pressionada para continuar rolando. As setas requerem Claude Code v2.1.286 ou posterior.108 * Onde a barra tem setas `↑` e `↓` nas extremidades, clique em uma seta para rolar uma única linha ou mantenha-a pressionada para continuar rolando. As setas requerem Claude Code v2.1.286 ou posterior.

109* **Clique na linha `↑ N more` ou `↓ N more` na borda de uma lista** para pular para aquela extremidade da lista sem escolher uma opção. Requer Claude Code v2.1.286 ou posterior.109* **Clique na linha `↑ N more` ou `↓ N more` na borda de uma lista** para pular para aquela extremidade da lista sem escolher uma opção. Requer Claude Code v2.1.286 ou posterior.

110* **Click a collapsed tool result** to expand it and see the full output. Click again to collapse. The tool call and its result expand together. Only messages that have more to show are clickable.110* **Clique em um resultado de ferramenta recolhido** para expandi-lo e ver a saída completa. Clique novamente para recolhê-lo. A chamada de ferramenta e seu resultado são expandidos juntos. Apenas mensagens que têm mais conteúdo a mostrar são clicáveis.

111 * Clicking also expands the output of a `!` shell command, whether an older truncated result or the live progress row while the command runs. Requires Claude Code v2.1.257 or later.111 * Clicar também expande a saída de um comando de shell `!`, seja um resultado truncado mais antigo ou a linha de progresso ao vivo enquanto o comando é executado. Requer Claude Code v2.1.257 ou posterior.

112 * Clicking also expands a dim `Message from @<sender>` line when the sender is a [teammate](/docs/pt/agent-teams) or another agent running in your session. The line for a message from [one of your other sessions](/docs/pt/cross-session-messaging#what-a-message-looks-like) also shows the message's first line and isn't clickable, so press `Ctrl+o` to read that one.112 * Clicar também expande uma linha esmaecida `Message from @<sender>` quando o remetente é um [colega de equipe](/docs/pt/agent-teams) ou outro agente em execução na sua sessão.

113* **Hold `Cmd` on macOS, or `Ctrl` on Linux and Windows, and click a URL or file path** to open it. Plain `http://` and `https://` URLs open in your browser, and file paths in tool output, like the ones printed after an Edit or Write, open in your default application. A plain click without the modifier doesn't open links, matching native terminal behavior.113* **Hold `Cmd` on macOS, or `Ctrl` on Linux and Windows, and click a URL or file path** to open it. Plain `http://` and `https://` URLs open in your browser, and file paths in tool output, like the ones printed after an Edit or Write, open in your default application. A plain click without the modifier doesn't open links, matching native terminal behavior.

114 * Claude Code renders a network (UNC) path, such as `\\server\share\file.ts`, as plain text with no link, because opening a network path can send your Windows credentials to the host it names.114 * Claude Code renders a network (UNC) path, such as `\\server\share\file.ts`, as plain text with no link, because opening a network path can send your Windows credentials to the host it names.

115 * Some macOS terminals forward `Cmd`+click to the running app instead of opening the link themselves, and the terminal mouse protocol has no way to encode the `Cmd` key, so Claude Code receives a plain click. In Ghostty, and in Warp on macOS, Claude Code detects this and lets a plain click on a link open it, and holding `Cmd` still works.115 * Some macOS terminals forward `Cmd`+click to the running app instead of opening the link themselves, and the terminal mouse protocol has no way to encode the `Cmd` key, so Claude Code receives a plain click. In Ghostty, and in Warp on macOS, Claude Code detects this and lets a plain click on a link open it, and holding `Cmd` still works.

headless.md +1 −1

Details

59| Adições de prompt do sistema | `--append-system-prompt`, `--append-system-prompt-file` |59| Adições de prompt do sistema | `--append-system-prompt`, `--append-system-prompt-file` |

60| Configurações | `--settings <file-or-json>` |60| Configurações | `--settings <file-or-json>` |

61| Servidores MCP | `--mcp-config <file-or-json>` |61| Servidores MCP | `--mcp-config <file-or-json>` |

62| Agentes personalizados | `--agents <json>` |62| [Agentes personalizados](/docs/pt/sub-agents#choose-the-subagent-scope) | `--agents <file-or-json>` |

63| Um plugin | `--plugin-dir <path>`, `--plugin-url <url>` |63| Um plugin | `--plugin-dir <path>`, `--plugin-url <url>` |

64 64 

65O modo bare também limita o que acontece enquanto a sessão é executada:65O modo bare também limita o que acontece enquanto a sessão é executada:

hooks.md +46 −10

Details

474| Campo | Obrigatório | Descrição |474| Campo | Obrigatório | Descrição |

475| :- | :- | :- |475| :- | :- | :- |

476| `type` | sim | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"` ou `"agent"` |476| `type` | sim | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"` ou `"agent"` |

477| `if` | não | Sintaxe de regra de permissão para filtrar quando este hook executa, como `"Bash(git *)"` ou `"Edit(*.ts)"`. O comando do hook apenas é executado se a chamada de ferramenta corresponde ao padrão. Consulte a [tabela de correspondência Bash](#bash-if-matching) abaixo para saber como padrões Bash são avaliados contra subcomandos, `$()` e backticks. Apenas avaliado em eventos de ferramenta: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest` e `PermissionDenied`. Em outros eventos, um hook com `if` definido nunca executa. Usa a mesma sintaxe que [regras de permissão](/docs/pt/permissions) |477| `if` | não | [Sintaxe de regra de permissão](/docs/pt/permissions#permission-rule-syntax) para filtrar quando este hook executa, como `"Bash(git *)"` ou `"Edit(*.ts)"`. O comando do hook apenas é executado se a chamada de ferramenta corresponde ao padrão. Consulte a [tabela de correspondência Bash](#bash-if-matching) para saber como padrões Bash são avaliados contra subcomandos, `$()` e backticks. Apenas avaliado em eventos de ferramenta: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest` e `PermissionDenied`. Em outros eventos, um hook com `if` definido nunca executa |

478| `timeout` | não | Segundos antes de cancelar. Claude Code não o impõe em um hook de comando que você executa com [`async: true`](#run-hooks-in-the-background). Padrões: 600 para `command`, `http` e `mcp_tool`; 30 para `prompt`; 60 para `agent`. Claude Code reduz o padrão de `command`, `http` e `mcp_tool` para 30 em [`UserPromptSubmit`](#userpromptsubmit), [`PreModelSwitch`](#premodelswitch) e [`PostModelSwitch`](#postmodelswitch), e para 10 em [`MessageDisplay`](#messagedisplay). Hooks de [`SessionEnd`](#sessionend) compartilham um orçamento de 1,5 segundo; se suas configurações definirem um `timeout` por hook mais longo, Claude Code aumenta o orçamento para corresponder, até 60 segundos |478| `timeout` | não | Segundos antes de cancelar. Claude Code não o impõe em um hook de comando que você executa com [`async: true`](#run-hooks-in-the-background). Padrões: 600 para `command`, `http` e `mcp_tool`; 30 para `prompt`; 60 para `agent`. Claude Code reduz o padrão de `command`, `http` e `mcp_tool` para 30 em [`UserPromptSubmit`](#userpromptsubmit), [`PreModelSwitch`](#premodelswitch) e [`PostModelSwitch`](#postmodelswitch), e para 10 em [`MessageDisplay`](#messagedisplay). Hooks de [`SessionEnd`](#sessionend) compartilham um orçamento de 1,5 segundo; se suas configurações definirem um `timeout` por hook mais longo, Claude Code aumenta o orçamento para corresponder, até 60 segundos |

479| `statusMessage` | não | Mensagem de spinner personalizada exibida enquanto o hook executa |479| `statusMessage` | não | Mensagem de spinner personalizada exibida enquanto o hook executa |

480| `once` | não | Se `true`, Claude Code remove o hook após sua primeira execução bem-sucedida. Uma execução que falha, bloqueia com código de saída 2 ou expira deixa o hook em vigor, então ele executa novamente no próximo evento correspondente. Apenas honrado para hooks declarados em [frontmatter de skill](#hooks-in-skills-and-agents); ignorado em arquivos de configurações e frontmatter de agente |480| `once` | não | Se `true`, Claude Code remove o hook após sua primeira execução bem-sucedida. Uma execução que falha, bloqueia com código de saída 2 ou expira deixa o hook em vigor, então ele executa novamente no próximo evento correspondente. Apenas honrado para hooks declarados em [frontmatter de skill](#hooks-in-skills-and-agents); ignorado em arquivos de configurações e frontmatter de agente |


483 483 

484Em uma condição `if` para uma ferramenta de arquivo, um padrão de diretório de segmento único como `"Edit(src/**)"` corresponde apenas ao diretório `src` no diretório de trabalho e aos arquivos sob ele. Para corresponder a um diretório nomeado `src` em qualquer profundidade, escreva `"Edit(**/src/**)"`. Antes de v2.1.214, `"Edit(src/**)"` correspondia a um diretório nomeado `src` em qualquer profundidade sob o diretório de trabalho.484Em uma condição `if` para uma ferramenta de arquivo, um padrão de diretório de segmento único como `"Edit(src/**)"` corresponde apenas ao diretório `src` no diretório de trabalho e aos arquivos sob ele. Para corresponder a um diretório nomeado `src` em qualquer profundidade, escreva `"Edit(**/src/**)"`. Antes de v2.1.214, `"Edit(src/**)"` correspondia a um diretório nomeado `src` em qualquer profundidade sob o diretório de trabalho.

485 485 

486<span id="bash-if-matching" />Para padrões Bash, se seu comando de hook executa depende da forma do padrão e do comando Bash que Claude está invocando. Atribuições `VAR=value` iniciais são removidas antes da correspondência.486<h4 id="bash-if-matching">

487 Como padrões `if` correspondem a comandos Bash

488</h4>

489 

490Para padrões Bash no [campo `if`](#common-fields), se seu comando de hook executa depende da forma do padrão e do comando Bash que Claude está invocando. Atribuições `VAR=value` iniciais são removidas antes da correspondência.

487 491 

488| padrão `if` | Comando Bash | Hook executa? | Por quê |492| padrão `if` | Comando Bash | Hook executa? | Por quê |

489| :- | :- | :- | :- |493| :- | :- | :- | :- |


1949 1953 

1950| Campo | Tipo | Exemplo | Descrição |1954| Campo | Tipo | Exemplo | Descrição |

1951| :- | :- | :- | :- |1955| :- | :- | :- | :- |

1952| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React"}], "multiSelect": false}]` | Perguntas a apresentar, cada uma com uma string `question`, um `header` curto, um array `options` e uma flag `multiSelect` opcional |1956| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false}]` | Perguntas a serem apresentadas, cada uma com uma string `question`, um `header` curto, um array `options` e uma flag `multiSelect` opcional |

1953| `answers` | object | `{"Which framework?": "React"}` | Opcional. Mapeia o texto da pergunta para o rótulo da opção selecionada. Respostas de seleção múltipla unem os rótulos com vírgulas. O Claude não define este campo; forneça-o via `updatedInput` para responder programaticamente |1957| `answers` | object | `{"Which framework?": "React"}` | Opcional. Mapeia o texto da pergunta para o rótulo da opção selecionada. Respostas de seleção múltipla unem os rótulos com vírgulas. O Claude não define este campo; forneça-o via `updatedInput` para responder programaticamente |

1954 1958 

1955<h5 id="exitplanmode">1959<h5 id="exitplanmode">


2001}2005}

2002```2006```

2003 2007 

2004<span id="allow-with-updatedinput" />2008<Note>

2009 O PreToolUse usava anteriormente os campos `decision` e `reason` de nível superior, mas eles estão descontinuados para este evento. Use `hookSpecificOutput.permissionDecision` e `hookSpecificOutput.permissionDecisionReason`. Os valores descontinuados `"approve"` e `"block"` correspondem a `"allow"` e `"deny"`, respectivamente. Outros eventos, como PostToolUse e Stop, continuam usando `decision` e `reason` de nível superior como seu formato atual.

2010</Note>

2005 2011 

2006No [modo não interativo](/docs/pt/headless) com a flag `-p`, o Claude Code oferece `AskUserQuestion` e `ExitPlanMode` somente quando a execução tem um [host de permissão](/docs/pt/headless#turn-off-permission-prompts-in-unattended-runs) para receber o prompt, como um callback `canUseTool` do Agent SDK. Essas ferramentas exigem interação do usuário. Retornar `permissionDecision: "allow"` junto com `updatedInput` satisfaz esse requisito: o hook lê a entrada da ferramenta do stdin, coleta a resposta por meio da sua própria UI e a retorna em `updatedInput` para que a ferramenta seja executada sem solicitar confirmação. Retornar apenas `"allow"` não é suficiente para essas ferramentas. Para `AskUserQuestion`, devolva o array `questions` original e adicione um objeto [`answers`](#askuserquestion) que mapeia o texto de cada pergunta para a resposta escolhida.2012<h4 id="allow-with-updatedinput">

2013 Ferramentas que exigem interação do usuário

2014</h4>

2007 2015 

2008Uma ferramenta MCP cujo servidor a marca com [`_meta["anthropic/requiresUserInteraction"]`](/docs/pt/mcp#require-approval-for-a-specific-tool) é mais restrita: um hook não pode pular seu prompt de aprovação com `"allow"`, com ou sem `updatedInput`, porque o Claude Code não consegue confirmar que o hook coletou a interação de que a ferramenta precisa.2016`AskUserQuestion` e `ExitPlanMode` exigem interação do usuário. No [modo não interativo](/docs/pt/headless) com a flag `-p`, o Claude Code as oferece somente quando a execução tem um [host de permissão](/docs/pt/headless#turn-off-permission-prompts-in-unattended-runs) para receber o prompt, como um callback `canUseTool` do Agent SDK.

2009 2017 

2010<Note>2018Um hook `PreToolUse` atende a esse requisito quando faz o seguinte:

2011 O PreToolUse usava anteriormente os campos de nível superior `decision` e `reason`, mas eles estão descontinuados para este evento. Use `hookSpecificOutput.permissionDecision` e `hookSpecificOutput.permissionDecisionReason`. Os valores descontinuados `"approve"` e `"block"` correspondem a `"allow"` e `"deny"`, respectivamente. Outros eventos, como PostToolUse e Stop, continuam usando `decision` e `reason` de nível superior como seu formato atual.2019 

2012</Note>20201. Lê a entrada da ferramenta do stdin

20212. Coleta a resposta por meio da sua própria interface

20223. Retorna `permissionDecision: "allow"` junto com `updatedInput` contendo a resposta, para que a ferramenta seja executada sem solicitar confirmação

2023 

2024Retornar apenas `"allow"` não é suficiente para essas ferramentas.

2025 

2026Para `AskUserQuestion`, devolva o array `questions` original e adicione um objeto [`answers`](#askuserquestion) que mapeia o texto de cada pergunta para a resposta escolhida. Esta saída responde a uma pergunta com `React`:

2027 

2028```json theme={null}

2029{

2030 "hookSpecificOutput": {

2031 "hookEventName": "PreToolUse",

2032 "permissionDecision": "allow",

2033 "updatedInput": {

2034 "questions": [

2035 {

2036 "question": "Which framework?",

2037 "header": "Framework",

2038 "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}],

2039 "multiSelect": false

2040 }

2041 ],

2042 "answers": {"Which framework?": "React"}

2043 }

2044 }

2045}

2046```

2047 

2048Uma ferramenta MCP cujo servidor a marca com [`_meta["anthropic/requiresUserInteraction"]`](/docs/pt/mcp#require-approval-for-a-specific-tool) é mais restrita: um hook não pode pular seu prompt de aprovação com `"allow"`, com ou sem `updatedInput`, porque o Claude Code não consegue confirmar que o hook coletou a interação de que a ferramenta precisa.

2013 2049 

2014<h4 id="defer-a-tool-call-for-later">2050<h4 id="defer-a-tool-call-for-later">

2015 Adiar uma chamada de ferramenta para mais tarde2051 Adiar uma chamada de ferramenta para mais tarde


2036 "deferred_tool_use": {2072 "deferred_tool_use": {

2037 "id": "toolu_01abc",2073 "id": "toolu_01abc",

2038 "name": "AskUserQuestion",2074 "name": "AskUserQuestion",

2039 "input": { "questions": [{ "question": "Which framework?", "header": "Framework", "options": [{"label": "React"}, {"label": "Vue"}], "multiSelect": false }] }2075 "input": { "questions": [{ "question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false }] }

2040 }2076 }

2041}2077}

2042```2078```

Details

470* Sua conta está próxima ou no limite de uso. Para manter as sugestões ativadas até atingir o limite, defina [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/pt/env-vars) como `true`. Antes da v2.1.238, Claude Code as pulava perto do limite mesmo com a variável definida como `true`470* Sua conta está próxima ou no limite de uso. Para manter as sugestões ativadas até atingir o limite, defina [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/pt/env-vars) como `true`. Antes da v2.1.238, Claude Code as pulava perto do limite mesmo com a variável definida como `true`

471* Em uma [equipe de agentes](/docs/pt/agent-teams), nas sessões de colegas de equipe por padrão. A sessão do líder mostra sugestões471* Em uma [equipe de agentes](/docs/pt/agent-teams), nas sessões de colegas de equipe por padrão. A sessão do líder mostra sugestões

472 472 

473O aviso `Showing fewer prompt suggestions · use one to bring them back` significa que Claude Code está mostrando sugestões com menos frequência porque você deixou muitas seguidas sem usar. Para voltar à frequência habitual, use uma sugestão ou defina [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/pt/env-vars) como `true`.

474 

473No modo de impressão, Claude Code não gera sugestões por padrão. Passe [`--prompt-suggestions`](/docs/pt/cli-reference#cli-flags) com `-p "<prompt>" --output-format stream-json --verbose` para que Claude Code emita uma mensagem `prompt_suggestion` após cada volta que gera uma. O gerador pula conversas muito curtas e caches de prompt frios aqui também, portanto uma única consulta `-p` curta pode não emitir nenhuma.475No modo de impressão, Claude Code não gera sugestões por padrão. Passe [`--prompt-suggestions`](/docs/pt/cli-reference#cli-flags) com `-p "<prompt>" --output-format stream-json --verbose` para que Claude Code emita uma mensagem `prompt_suggestion` após cada volta que gera uma. O gerador pula conversas muito curtas e caches de prompt frios aqui também, portanto uma única consulta `-p` curta pode não emitir nenhuma.

474 476 

475<h3 id="turn-prompt-suggestions-off">477<h3 id="turn-prompt-suggestions-off">

keybindings.md +4 −0

Details

464| :- | :- | :- |464| :- | :- | :- |

465| `agents:switchView` | Ctrl+S | Alternar [agrupamento de sessão](/docs/pt/agent-view#organize-the-list) entre estado e diretório |465| `agents:switchView` | Ctrl+S | Alternar [agrupamento de sessão](/docs/pt/agent-view#organize-the-list) entre estado e diretório |

466| `agents:togglePin` | Ctrl+T | [Fixar ou desafixar](/docs/pt/agent-view#organize-the-list) a sessão selecionada |466| `agents:togglePin` | Ctrl+T | [Fixar ou desafixar](/docs/pt/agent-view#organize-the-list) a sessão selecionada |

467| `agents:find` | Ctrl+F | Encontrar sessões por nome, com o [filtro `n:`](/docs/pt/agent-view#filter-sessions). Requer v2.1.288 ou posterior |

468| `agents:rename` | Ctrl+R | [Renomear](/docs/pt/agent-view#organize-the-list) a sessão selecionada. Requer v2.1.288 ou posterior |

469| `agents:previousGroup` | Ctrl+Up, Meta+Up | Pular para o [cabeçalho de grupo](/docs/pt/agent-view#organize-the-list) anterior. Requer v2.1.288 ou posterior |

470| `agents:nextGroup` | Ctrl+Down, Meta+Down | Pular para o próximo cabeçalho de grupo. Requer v2.1.288 ou posterior |

467 471 

468Enquanto a visualização do agente está aberta, Claude Code usa a vinculação `Agents` para qualquer tecla que o contexto `Agents` vincula, e ignora uma vinculação `Chat` ou `Global` na mesma tecla. Por exemplo, pressionar Ctrl+S na visualização do agente alterna o agrupamento de sessão em vez de disparar o padrão `chat:stash`.472Enquanto a visualização do agente está aberta, Claude Code usa a vinculação `Agents` para qualquer tecla que o contexto `Agents` vincula, e ignora uma vinculação `Chat` ou `Global` na mesma tecla. Por exemplo, pressionar Ctrl+S na visualização do agente alterna o agrupamento de sessão em vez de disparar o padrão `chat:stash`.

469 473 

Details

271 No Claude Code v2.1.273 ou posterior, enquanto `allowManagedMcpServersOnly` está ativo, a lista `allowedMcpServers` da fonte de administrador com classificação mais alta que define uma se aplica e bloqueia a do pai, como uma [chave entre fontes](#keys-read-from-every-admin-source). A lista do pai se aplica apenas quando nenhuma fonte de administrador define uma. A entrada [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) diz qual fonte fornece cada chave sob `"merge"`. Antes de v2.1.223, um valor em qualquer fonte de administrador bloqueava a do pai271 No Claude Code v2.1.273 ou posterior, enquanto `allowManagedMcpServersOnly` está ativo, a lista `allowedMcpServers` da fonte de administrador com classificação mais alta que define uma se aplica e bloqueia a do pai, como uma [chave entre fontes](#keys-read-from-every-admin-source). A lista do pai se aplica apenas quando nenhuma fonte de administrador define uma. A entrada [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) diz qual fonte fornece cada chave sob `"merge"`. Antes de v2.1.223, um valor em qualquer fonte de administrador bloqueava a do pai

272* Para `availableModels`, Claude Code impõe o valor nas configurações gerenciadas que aplica e bloqueia uma lista fornecida pelo pai272* Para `availableModels`, Claude Code impõe o valor nas configurações gerenciadas que aplica e bloqueia uma lista fornecida pelo pai

273* Para `strictKnownMarketplaces`, Claude Code igualmente impõe a lista nas configurações gerenciadas que aplica e bloqueia uma fornecida pelo pai. A lista do pai se aplica apenas quando nenhuma fonte gerenciada aplicada define uma. Requer Claude Code v2.1.282 ou posterior273* Para `strictKnownMarketplaces`, Claude Code igualmente impõe a lista nas configurações gerenciadas que aplica e bloqueia uma fornecida pelo pai. A lista do pai se aplica apenas quando nenhuma fonte gerenciada aplicada define uma. Requer Claude Code v2.1.282 ou posterior

274* Para `allowedProviders`, uma lista na [fonte gerenciada selecionada](#which-managed-source-claude-code-uses) bloqueia uma fornecida pelo pai, e sob a opção `"merge"` de [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) uma lista em qualquer fonte de administrador também bloqueia. Requer Claude Code v2.1.285 ou posterior

274* Um `blockedMarketplaces` fornecido pelo pai se aplica além de qualquer lista de negação que uma fonte gerenciada define. Requer Claude Code v2.1.282 ou posterior275* Um `blockedMarketplaces` fornecido pelo pai se aplica além de qualquer lista de negação que uma fonte gerenciada define. Requer Claude Code v2.1.282 ou posterior

275 276 

276<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">277<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">

model-config.md +1 −1

Details

766| :- | :- |766| :- | :- |

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

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

769| Desativar através de uma variável de ambiente | Defina [`MAX_THINKING_TOKENS=0`](/docs/pt/env-vars), que desativa o pensamento na Anthropic API exceto em Opus 5.5, Sonnet 5.5 e modelos Fable. Em [provedores de terceiros](/docs/pt/third-party-integrations), Claude Code omite o parâmetro `thinking`, e modelos de raciocínio adaptativo ainda podem pensar. Outros valores se aplicam apenas com um [orçamento de pensamento fixo](#adaptive-reasoning-and-fixed-thinking-budgets) |769| Desativar através de uma variável de ambiente | Defina [`MAX_THINKING_TOKENS=0`](/docs/pt/env-vars), que desativa o pensamento na Anthropic API exceto em Opus 5.5, Sonnet 5.5 e modelos Fable. Em [provedores de terceiros](/docs/pt/third-party-integrations), Claude Code omite o parâmetro `thinking` em vez disso, e modelos de raciocínio adaptativo ainda podem pensar |

770 770 

771Você não pode desativar o pensamento em Opus 5.5, Sonnet 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.771Você não pode desativar o pensamento em Opus 5.5, Sonnet 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.

772 772 

Details

676* `.devcontainer`676* `.devcontainer`

677* `.yarn`677* `.yarn`

678* `.mvn`678* `.mvn`

679* `.claude`, exceto por `.claude/worktrees` onde Claude armazena seus próprios git worktrees679* `.claude`, exceto por `.claude/worktrees` onde Claude armazena seus próprios git worktrees, e exceto pelos arquivos markdown no diretório de [memória automática](/docs/pt/memory#storage-location) do próprio Claude em uma sessão iniciada sem `--restricted`

680* Um diretório que você carregou com [`--plugin-dir`](/docs/pt/plugins/mods/create#change-a-mod-with-claude), porque Claude Code recarrega e executa o código de um mod a partir dele quando um arquivo muda680* Um diretório que você carregou com [`--plugin-dir`](/docs/pt/plugins/mods/create#change-a-mod-with-claude), porque Claude Code recarrega e executa o código de um mod a partir dele quando um arquivo muda

681 681 

682Arquivos protegidos:682Arquivos protegidos:


739Claude Code também procura dentro dessas construções:739Claude Code também procura dentro dessas construções:

740 740 

741* **Comandos aninhados**: uma subshell com `(...)`, um grupo de chaves com `{ ...; }`, substituição de comando com `$(...)` ou backticks, ou substituição de processo com `<(...)`. Claude Code encontra uma remoção de caminho crítico independentemente de estar dentro da forma aninhada, como em `(rm -rf ~)` ou `echo "$(rm -rf ~)"`, ou em outro lugar no mesmo comando.741* **Comandos aninhados**: uma subshell com `(...)`, um grupo de chaves com `{ ...; }`, substituição de comando com `$(...)` ou backticks, ou substituição de processo com `<(...)`. Claude Code encontra uma remoção de caminho crítico independentemente de estar dentro da forma aninhada, como em `(rm -rf ~)` ou `echo "$(rm -rf ~)"`, ou em outro lugar no mesmo comando.

742* **Scripts inline**: Claude Code verifica um script passado para um shell como `sh -c` ou `bash -c` para a variável de shell e os alvos de parâmetro posicional [](#other-targets-that-count-as-critical-paths).742* **Scripts inline**: um script passado para `sh`, `bash`, `zsh` ou um shell POSIX semelhante com `-c`, como em `bash -c 'rm -rf ~'`.

743 * Quando o script está entre aspas duplas, o shell invocador expande suas variáveis antes que o shell interno receba o script. Em `find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;`, o comando se expande para uma remoção da raiz do sistema de arquivos uma vez por correspondência, e Claude Code a trata como uma remoção de caminho crítico.743 * Quando o script está entre aspas duplas, o shell invocador expande suas variáveis antes que o shell interno receba o script. Em `find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;`, o comando se expande para uma remoção da raiz do sistema de arquivos uma vez por correspondência, e Claude Code a trata como uma remoção de caminho crítico.

744 * Um script entre aspas simples que vincula `$1` a um valor real, como `sh -c 'rm -rf "$1"/*' _ {}` faz, não é sinalizado.744 * Um script entre aspas simples que vincula `$1` a um valor real, como `sh -c 'rm -rf "$1"/*' _ {}` faz, não é sinalizado.

745 745 

746Para desativar a verificação em um caminho crítico digitado diretamente em um script `-c`, como `~`, defina [`CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT=1`](/docs/pt/env-vars#variables) no ambiente que inicia Claude Code.

747 

746<h3 id="rewrite-a-flagged-command">748<h3 id="rewrite-a-flagged-command">

747 Reescrever um comando sinalizado749 Reescrever um comando sinalizado

748</h3>750</h3>

Details

336| `version` | string | Para uma instalação de marketplace, a [versão que Claude Code computou](/docs/pt/plugins/loading#versions-and-updates) na instalação. Para um plugin de sessão única, diretório de skills ou sincronizado, a `version` do manifesto, ou `unknown` quando não declara nenhuma |336| `version` | string | Para uma instalação de marketplace, a [versão que Claude Code computou](/docs/pt/plugins/loading#versions-and-updates) na instalação. Para um plugin de sessão única, diretório de skills ou sincronizado, a `version` do manifesto, ou `unknown` quando não declara nenhuma |

337| `scope` | string | `user`, `project`, `local` ou `managed` para installs; `user` ou `project` para plugins de diretório de skills; `session` para plugins de sessão única; `synced` para plugins sincronizados de claude.ai |337| `scope` | string | `user`, `project`, `local` ou `managed` para installs; `user` ou `project` para plugins de diretório de skills; `session` para plugins de sessão única; `synced` para plugins sincronizados de claude.ai |

338| `enabled` | boolean | Se o plugin está ativado em suas configurações mescladas |338| `enabled` | boolean | Se o plugin está ativado em suas configurações mescladas |

339| `installPath` | string | Diretório do qual o plugin carrega |339| `installPath` | string | Diretório do qual o plugin carrega, exceto para um plugin que as sessões [carregam no local](/docs/pt/plugins/loading#in-place-and-copied-plugins) a partir da pasta do seu marketplace |

340| `readFromFolder` | string | Para um plugin que as sessões [carregam no local](/docs/pt/plugins/loading#in-place-and-copied-plugins) a partir da pasta do seu marketplace, o diretório de origem do plugin dentro dessa pasta. Requer Claude Code v2.1.289 ou posterior |

341| `folderVersion` | string | Com `readFromFolder`, a `version` do plugin conforme Claude Code a carregou dessa pasta, que pode diferir do campo `version` acima. Ausente quando o plugin não carregou ou não declara versão. Requer Claude Code v2.1.289 ou posterior |

340| `installedAt` | string | Timestamp ISO da instalação. Apenas installs de marketplace |342| `installedAt` | string | Timestamp ISO da instalação. Apenas installs de marketplace |

341| `lastUpdated` | string | Timestamp ISO da última atualização. Apenas installs de marketplace |343| `lastUpdated` | string | Timestamp ISO da última atualização. Apenas installs de marketplace |

342| `projectPath` | string | Projeto ao qual a instalação pertence. Apenas escopo `project` e `local` |344| `projectPath` | string | Projeto ao qual a instalação pertence. Apenas escopo `project` e `local` |


637 * Um diretório nomeado `.claude`: os diretórios `skills`, `agents` e `commands` dentro dele639 * Um diretório nomeado `.claude`: os diretórios `skills`, `agents` e `commands` dentro dele

638 * Qualquer outro diretório: esses três diretórios sob seu `.claude`640 * Qualquer outro diretório: esses três diretórios sob seu `.claude`

639 641 

642Quando o diretório contém tanto um `.claude-plugin/marketplace.json` quanto um `.claude-plugin/plugin.json`, Claude Code valida o marketplace e também o manifesto e os arquivos de componente do plugin. Isso requer Claude Code v2.1.289 ou posterior.

643 

640Claude Code não segue symlinks dentro do diretório que você nomeia. O que faz depende de onde o link está:644Claude Code não segue symlinks dentro do diretório que você nomeia. O que faz depende de onde o link está:

641 645 

642* **Um diretório `skills`, `agents` ou `commands` vinculado sob a raiz do plugin ou `.claude`**: Claude Code avisa que nada nele foi lido.646* **Um diretório `skills`, `agents` ou `commands` vinculado sob a raiz do plugin ou `.claude`**: Claude Code avisa que nada nele foi lido.


647 651 

648* **Um `SKILL.md` na raiz do plugin**: quando você executa `claude plugin validate` contra um diretório de plugin, Claude Code não verifica um `SKILL.md` na raiz do plugin652* **Um `SKILL.md` na raiz do plugin**: quando você executa `claude plugin validate` contra um diretório de plugin, Claude Code não verifica um `SKILL.md` na raiz do plugin

649* **Um `CLAUDE.md` na raiz do plugin**: em uma execução de plugin, Claude Code também avisa sobre um `CLAUDE.md` na raiz do plugin653* **Um `CLAUDE.md` na raiz do plugin**: em uma execução de plugin, Claude Code também avisa sobre um `CLAUDE.md` na raiz do plugin

650* **Arquivos de plugin em uma execução de marketplace**: de um diretório de marketplace, Claude Code não abre os arquivos de skill, agent, comando ou hook dos plugins. Para encontrar erros nesses arquivos, valide cada diretório de plugin654* **Arquivos de plugin em uma execução de marketplace**: de um diretório de marketplace, Claude Code não abre os arquivos de skill, agent, comando ou hook dos plugins que o marketplace lista em outros diretórios, nem os arquivos de servidor MCP que eles incluem. Para encontrar erros nesses arquivos, valide cada diretório de plugin

651 655 

652<h4 id="output-and-exit-codes">656<h4 id="output-and-exit-codes">

653 Saída e códigos de saída657 Saída e códigos de saída

Details

100 Greet the user warmly and ask how you can help them today.100 Greet the user warmly and ask how you can help them today.

101 ```101 ```

102 102 

103 A linha `disable-model-invocation: true` significa que Claude não executa a skill por conta própria, então apenas você a dispara. Remova essa linha de uma skill que você quer que Claude execute por conta própria. O comando da skill combina o nome do plugin e o nome da skill, então você executa este como `/my-first-plugin:hello`. Para os outros campos do frontmatter, veja a [referência do frontmatter da skill](/docs/pt/skills#frontmatter-reference).103 A linha `disable-model-invocation: true` significa que Claude não executa a skill por conta própria. Remova essa linha de uma skill que você quer que Claude execute por conta própria. O comando da skill combina o nome do plugin e o nome da skill, então você executa este como `/my-first-plugin:hello`. Para os outros campos do frontmatter, veja a [referência do frontmatter da skill](/docs/pt/skills#frontmatter-reference).

104 </Step>104 </Step>

105 105 

106 <Step title="Validar o plugin">106 <Step title="Validar o plugin">

Details

215 215 

216Para lançar uma nova versão aos usuários, altere o `version` do plugin. Os usuários obtêm uma nova cópia apenas quando a versão computada do plugin difere da que eles têm. Essa versão vem de `plugin.json` primeiro, depois da entrada do marketplace, por [Versions and updates](/docs/pt/plugins/loading#versions-and-updates).216Para lançar uma nova versão aos usuários, altere o `version` do plugin. Os usuários obtêm uma nova cópia apenas quando a versão computada do plugin difere da que eles têm. Essa versão vem de `plugin.json` primeiro, depois da entrada do marketplace, por [Versions and updates](/docs/pt/plugins/loading#versions-and-updates).

217 217 

218Um plugin que os usuários [load in place](/docs/pt/plugins/loading#find-plugins-on-disk) a partir de um marketplace que adicionaram como um diretório local não é controlado por `version`. Ele carrega seus arquivos atuais em cada início de sessão, seja qual for sua string de versão.218Um plugin que os usuários [carregam no local](/docs/pt/plugins/loading#find-plugins-on-disk) a partir de um marketplace que adicionaram de um caminho local não é controlado por `version`. Ele carrega seus arquivos atuais em cada início de sessão, seja qual for sua string de versão.

219 219 

220Para cada instalação que não seja um carregamento in-place ou um de um source `command`, aumente `version` em cada lançamento ou omita-o:220Para cada instalação que não seja um carregamento in-place ou um de um source `command`, aumente `version` em cada lançamento ou omita-o:

221 221 

Details

208Claude Code carrega alguns plugins in-place de onde você os mantém e copia o resto para o cache, de acordo com sua origem:208Claude Code carrega alguns plugins in-place de onde você os mantém e copia o resto para o cache, de acordo com sua origem:

209 209 

210* **Plugins `--plugin-dir` e de diretório de skills**: o diretório carrega in-place e nunca é copiado. Um arquivo `--plugin-url` ou um `.zip` de `--plugin-dir` é extraído para um diretório temporário de sessão primeiro210* **Plugins `--plugin-dir` e de diretório de skills**: o diretório carrega in-place e nunca é copiado. Um arquivo `--plugin-url` ou um `.zip` de `--plugin-dir` é extraído para um diretório temporário de sessão primeiro

211* **Plugins de caminho relativo em um marketplace que você adicionou de um diretório local**: o plugin carrega in-place de seu caminho dentro da pasta do marketplace. Suas edições no diretório de origem têm efeito no próximo início de sessão ou `/reload-plugins`, e você não precisa aumentar a versão. Os processos de hook do plugin e servidores MCP e LSP recebem um `CLAUDE_PLUGIN_ROOT` que aponta para o diretório de origem. Para suas dependências de pacote Node.js, veja [Quando a instalação de dependência é executada](#when-the-dependency-install-runs)211* **Plugins de caminho relativo em um marketplace que você adicionou de um caminho local**: o plugin carrega in-place de seu caminho dentro da pasta do marketplace. Suas edições no diretório de origem têm efeito no próximo início de sessão ou `/reload-plugins`, e você não precisa aumentar a versão. Os processos de hook do plugin e servidores MCP e LSP recebem um `CLAUDE_PLUGIN_ROOT` que aponta para o diretório de origem. Para suas dependências de pacote Node.js, veja [Quando a instalação de dependência é executada](#when-the-dependency-install-runs)

212* **Plugins de fonte `command` em [modo de link](/docs/pt/plugins/marketplace-reference#command-plugin-source)**: o diretório que o comando imprimiu carrega in-place, através de links na entrada de cache212* **Plugins de fonte `command` em [modo de link](/docs/pt/plugins/marketplace-reference#command-plugin-source)**: o diretório que o comando imprimiu carrega in-place, através de links na entrada de cache

213* **Cada outro plugin de marketplace**: Claude Code copia o plugin para `cache/<marketplace>/<plugin>/<version>/` na instalação e carrega essa cópia. Arquivos fora do diretório do plugin não são copiados, então quando um script dentro de um plugin copiado lê um caminho acima da raiz do plugin, como `../shared`, ele não os encontra213* **Cada outro plugin de marketplace**: Claude Code copia o plugin para `cache/<marketplace>/<plugin>/<version>/` na instalação e carrega essa cópia. Arquivos fora do diretório do plugin não são copiados, então quando um script dentro de um plugin copiado lê um caminho acima da raiz do plugin, como `../shared`, ele não os encontra

214 214 


250* Quando Claude Code atualiza um plugin para uma nova versão250* Quando Claude Code atualiza um plugin para uma nova versão

251* No início da sessão quando um plugin habilitado ainda não está em cache, como em uma máquina nova251* No início da sessão quando um plugin habilitado ainda não está em cache, como em uma máquina nova

252 252 

253Para um plugin de caminho relativo [carregado in-place](#in-place-and-copied-plugins) de um marketplace de diretório local, Claude Code não instala as dependências no diretório de origem. Instale-as lá você mesmo, ou de um hook para [`${CLAUDE_PLUGIN_DATA}`](/docs/pt/plugins/components#path-variables-and-persistent-data).253Para um plugin de caminho relativo [carregado in-place](#in-place-and-copied-plugins) de um marketplace que você adicionou de um caminho local, Claude Code não instala as dependências no diretório de origem. Instale-as lá você mesmo, ou de um hook para [`${CLAUDE_PLUGIN_DATA}`](/docs/pt/plugins/components#path-variables-and-persistent-data).

254 254 

255A instalação é executada apenas quando o diretório raiz do plugin contém tanto um `package.json` quanto um lockfile suportado.255A instalação é executada apenas quando o diretório raiz do plugin contém tanto um `package.json` quanto um lockfile suportado.

256 256 


315 315 

316Um manifesto que fixa `"version"` é uma forma da versão computada ficar a mesma através de commits. Veja [Como Claude Code computa a versão](#how-claude-code-computes-the-version) para a ordem de resolução.316Um manifesto que fixa `"version"` é uma forma da versão computada ficar a mesma através de commits. Veja [Como Claude Code computa a versão](#how-claude-code-computes-the-version) para a ordem de resolução.

317 317 

318Um plugin [carregado in-place](#in-place-and-copied-plugins) de um marketplace de diretório local carrega seus arquivos de origem atuais em cada início de sessão, qualquer que seja sua string de versão. Para um plugin de um [marketplace hospedado em claude.ai](/docs/pt/plugins/install#add-from-claude-ai), a versão que claude.ai registra para o plugin é sua versão, e o `version` do manifesto não é lido.318Um plugin [carregado in-place](#in-place-and-copied-plugins) de um marketplace que você adicionou a partir de um caminho local carrega seus arquivos de origem atuais em cada início de sessão, qualquer que seja sua string de versão. Para um plugin de um [marketplace hospedado em claude.ai](/docs/pt/plugins/install#add-from-claude-ai), a versão que claude.ai registra para o plugin é sua versão, e o `version` do manifesto não é lido.

319 319 

320<h3 id="how-claude-code-computes-the-version">320<h3 id="how-claude-code-computes-the-version">

321 Como Claude Code computa a versão321 Como Claude Code computa a versão

Details

199 `version`199 `version`

200</h3>200</h3>

201 201 

202Uma string de versão, não verificada contra semver. Configurá-la fixa o plugin nessa versão até você alterá-la; veja [Versões e atualizações](/docs/pt/plugins/loading#versions-and-updates). Um plugin com uma [`command` source](/docs/pt/plugins/marketplace-reference), um plugin de um [marketplace hospedado em claude.ai](/docs/pt/plugins/install#add-from-claude-ai) e um plugin [carregado no local](/docs/pt/plugins/loading#find-plugins-on-disk) de um marketplace adicionado como um diretório local não são fixados por este campo.202Uma string de versão, não verificada contra semver. Configurá-la fixa o plugin nessa versão até você alterá-la; veja [Versões e atualizações](/docs/pt/plugins/loading#versions-and-updates). Um plugin com uma [`command` source](/docs/pt/plugins/marketplace-reference), um plugin de um [marketplace hospedado em claude.ai](/docs/pt/plugins/install#add-from-claude-ai) e um plugin [carregado no local](/docs/pt/plugins/loading#find-plugins-on-disk) de um marketplace adicionado a partir de um caminho local não são fixados por este campo.

203 203 

204<h3 id="metadata">204<h3 id="metadata">

205 `metadata`205 `metadata`

Details

434| `Link`, `Code`, `Markdown` | Um link com `href` e um `label` opcional, um bloco de código e texto formatado da forma que as respostas do Claude são. `Markdown` leva seu conteúdo em uma propriedade `text`, não em `children`, e precisa de uma `key` quando você passa `onLinkPress`. | Em todos os lugares |434| `Link`, `Code`, `Markdown` | Um link com `href` e um `label` opcional, um bloco de código e texto formatado da forma que as respostas do Claude são. `Markdown` leva seu conteúdo em uma propriedade `text`, não em `children`, e precisa de uma `key` quando você passa `onLinkPress`. | Em todos os lugares |

435| `Input`, `Select` | Um campo de texto e um seletor | Terminal, Desktop |435| `Input`, `Select` | Um campo de texto e um seletor | Terminal, Desktop |

436| `Svg` | Um documento SVG | Desktop |436| `Svg` | Um documento SVG | Desktop |

437| `Client` | Uma região desenhada por um segundo arquivo seu, para animação e entrada de ponteiro. Esse arquivo não recebe API de mods. Ele alcança seus hooks apenas postando dados, que chegam como um evento `ui.message`. | Terminal, Desktop |437| `Client` | Uma região desenhada por um segundo arquivo seu, para animação e entrada de ponteiro. Esse arquivo não recebe API de mods. Ele alcança seus hooks postando dados, que chegam como um evento `ui.message`. Se ele falhar ao carregar, desenhar ou executar, seus hooks recebem um evento [`ui.fault`](/docs/pt/plugins/mods/reference#interface). | Terminal, Desktop |

438| `Raster`, `Image` | Uma [grade de células coloridas](#draw-a-grid-of-colored-cells) e uma imagem | Terminal |438| `Raster`, `Image` | Uma [grade de células coloridas](#draw-a-grid-of-colored-cells) e uma imagem | Terminal |

439 439 

440Se seu módulo é um arquivo `.tsx` ou `.jsx`, você pode escrever a árvore como JSX. Desestruture os elementos de `$.ui.resolve(e)` primeiro.440Se seu módulo é um arquivo `.tsx` ou `.jsx`, você pode escrever a árvore como JSX. Desestruture os elementos de `$.ui.resolve(e)` primeiro.


664 Quando o Claude Code redesenha sem ser solicitado664 Quando o Claude Code redesenha sem ser solicitado

665</h3>665</h3>

666 666 

667O Claude Code executa seu hook `ui.render` novamente quando as props do site mudam ou a largura do terminal muda. Ele não executa o hook em um timer, e não pode dizer quando uma variável em seu módulo muda.667O Claude Code executa seu hook `ui.render` novamente quando as props do site mudam ou a largura do terminal muda. Quando um `Client` no site falha e seu mod trata [`ui.fault`](/docs/pt/plugins/mods/reference#interface), o Claude Code executa o hook mais uma vez depois que seus hooks `ui.fault` retornam, para que seu hook `ui.render` possa deixar o `Client` de fora. Ele não executa o hook em um timer, e não pode dizer quando uma variável em seu módulo muda.

668 668 

669<h3 id="redraw-when-your-data-changes">669<h3 id="redraw-when-your-data-changes">

670 Redesenhar quando seus dados mudam670 Redesenhar quando seus dados mudam

Details

6 6 

7> Referência completa para mods do Claude Code: estrutura do módulo de hooks, eventos, métodos da API de mods, pontos de renderização, elementos por superfície, limites e configurações.7> Referência completa para mods do Claude Code: estrutura do módulo de hooks, eventos, métodos da API de mods, pontos de renderização, elementos por superfície, limites e configurações.

8 8 

9Consulte qualquer evento que um [mod](/docs/pt/plugins/mods/overview) pode tratar, método da API de mods que ele pode chamar ou ponto de renderização em que ele pode desenhar, para a CLI do Claude Code e o aplicativo Desktop a partir da v2.1.287. Cada entrada fornece o nome e uma descrição de uma linha, e aponta para a seção do guia que a explica, quando houver.9Consulte qualquer evento que um [mod](/docs/pt/plugins/mods/overview) pode tratar, método da API de mods que ele pode chamar ou ponto de renderização em que ele pode desenhar, para a CLI do Claude Code e o aplicativo Desktop a partir da v2.1.289. Cada entrada fornece o nome e uma descrição de uma linha, e aponta para a seção do guia que a explica, quando houver.

10 10 

11<Note>11<Note>

12 A referência completa são as [declarações TypeScript para mods](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts) do Claude Code, que descrevem cada evento, método e elemento, com exemplos. A cópia no GitHub pode ser mais antiga que a versão do Claude Code que você tem instalada. Quando as duas divergirem, confie [na cópia que o Claude Code grava para a sua versão](/docs/pt/plugins/mods/create#get-the-types-for-your-build).12 A referência completa são as [declarações TypeScript para mods](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts) do Claude Code, que descrevem cada evento, método e elemento, com exemplos. A cópia no GitHub pode ser mais antiga que a versão do Claude Code que você tem instalada. Quando as duas divergirem, confie [na cópia que o Claude Code grava para a sua versão](/docs/pt/plugins/mods/create#get-the-types-for-your-build).


128 Subagentes128 Subagentes

129</h3>129</h3>

130 130 

131Eventos de subagente são disparados quando um tipo de subagente é oferecido ao Claude e quando um está prestes a iniciar:131Eventos de subagente são disparados quando um tipo de subagente é oferecido ao Claude e quando um subagente ou um colega de uma equipe de agentes está prestes a iniciar:

132 132 

133| Evento | Dispara quando | Um hook pode retornar |133| Evento | Dispara quando | Um hook pode retornar |

134| :- | :- | :- |134| :- | :- | :- |

135| `agent.offer` | Um tipo de subagente é oferecido ao Claude | `{ isOffered: false }` para retê-lo |135| `agent.offer` | Um tipo de subagente é oferecido ao Claude | `{ isOffered: false }` para retê-lo |

136| `agent.spawn` | Um subagente está prestes a iniciar | `{ model }` ou `{ deny: reason }` |136| `agent.spawn` | Um subagente ou um colega de uma [equipe de agentes](/docs/pt/agent-teams) está prestes a iniciar. Para um colega de equipe, `e.isTeammate` é `true`. | `next({ ...e, model })` para escolher seu modelo, ou `{ deny: reason }` |

137 137 

138<h3 id="interface">138<h3 id="interface">

139 Interface139 Interface


149| `ui.focus`, `ui.scroll` | O controle em foco ou a posição de rolagem de um painel ou da faixa está prestes a mudar |149| `ui.focus`, `ui.scroll` | O controle em foco ou a posição de rolagem de um painel ou da faixa está prestes a mudar |

150| `ui.close` | Um painel está prestes a fechar. `e.id` é o painel e `e.origin.kind` é `plugin`, `person` ou `unload`. |150| `ui.close` | Um painel está prestes a fechar. `e.id` é o painel e `e.origin.kind` é `plugin`, `person` ou `unload`. |

151| [`ui.message`](/docs/pt/plugins/mods/interface#build-a-tree-from-elements) | Um elemento `Client` envia dados para o seu mod |151| [`ui.message`](/docs/pt/plugins/mods/interface#build-a-tree-from-elements) | Um elemento `Client` envia dados para o seu mod |

152| [`ui.fault`](/docs/pt/plugins/mods/interface#redraw-when-something-changes) | Um elemento `Client` que seu mod desenhou falhou ao carregar, desenhar ou executar. `e.phase` é `load`, `render` ou `run`, e `e.reason` é a mensagem de erro. Requer o Claude Code v2.1.289 ou posterior. |

152 153 

153<h3 id="other-mods">154<h3 id="other-mods">

154 Outros mods155 Outros mods


192| Namespace | Métodos |193| Namespace | Métodos |

193| :- | :- |194| :- | :- |

194| `$.plugin` | `name`, `root`: o nome e o diretório deste plugin |195| `$.plugin` | `name`, `root`: o nome e o diretório deste plugin |

195| [`$.ui`](/docs/pt/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `status`, `log`, `notice`, `ask`, `copy`, `blit` |196| [`$.ui`](/docs/pt/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit` |

196| [`$.command`](/docs/pt/plugins/mods/api#add-a-command) | `register`, `run`, `list` |197| [`$.command`](/docs/pt/plugins/mods/api#add-a-command) | `register`, `run`, `list` |

197| [`$.tool`](/docs/pt/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |198| [`$.tool`](/docs/pt/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |

198| `$.agent` | `register`, `spawn`, `list` |199| `$.agent` | `register`, `spawn`, `list` |


276 277 

277| Limite | Valor |278| Limite | Valor |

278| :- | :- |279| :- | :- |

279| O tempo de execução próprio de um hook para um evento, sem contar o tempo dentro de `next` ou de uma chamada à API de mods que não seja `$.clock.sleep` | 10 segundos |280| O tempo de execução próprio de um hook para um evento, sem contar o tempo dentro de `next` ou de uma chamada à API de mods que não seja `$.clock.sleep` | 10 segundos, ou 50 milissegundos para um hook `prompt.edit` |

280| O tempo de execução de um manipulador `.catch` | 1 segundo |281| O tempo de execução de um manipulador `.catch` | 1 segundo |

281| Todos os hooks `session.end` juntos | 1,5 segundo |282| Todos os hooks `session.end` juntos | O mesmo que o [orçamento do hook SessionEnd](/docs/pt/hooks#sessionend-input), 1,5 segundo a menos que você o altere, contado a partir do momento em que os hooks `SessionEnd` das suas configurações terminam |

282| Timeout de `$.process.run` | 30 segundos por padrão, no máximo 10 minutos |283| Timeout de `$.process.run` | 30 segundos por padrão, no máximo 10 minutos |

283| `maxTokens` de `$.model.complete` | 1024 por padrão, até 64.000 ou o limite de saída do modelo |284| `maxTokens` de `$.model.complete` | 1024 por padrão, até 64.000 ou o limite de saída do modelo |

284| `$.fs.read` e `$.fs.write` | 4 MiB para um arquivo |285| `$.fs.read` e `$.fs.write` | 4 MiB para um arquivo |

Details

1016 1016 

1017Verifique estas causas em ordem:1017Verifique estas causas em ordem:

1018 1018 

1019* **A skill define `disable-model-invocation: true`**: com esse campo definido, apenas você pode invocar a skill. A skill de modelo em [Create your first plugin](/docs/pt/plugins/create#create-your-first-plugin) a define. Remova a linha de uma skill que você quer que Claude invoque por conta própria. [Control who invokes a skill](/docs/pt/skills#control-who-invokes-a-skill) cobre o campo1019* **A skill define `disable-model-invocation: true`**: a skill de modelo em [Create your first plugin](/docs/pt/plugins/create#create-your-first-plugin) a define. Remova a linha de uma skill que você quer que Claude invoque por conta própria. [Control who invokes a skill](/docs/pt/skills#control-who-invokes-a-skill) cobre o campo

1020* **A descrição não corresponde a como as pessoas pedem**: trabalhe através das verificações em [Skill not triggering](/docs/pt/skills#skill-not-triggering)1020* **A descrição não corresponde a como as pessoas pedem**: trabalhe através das verificações em [Skill not triggering](/docs/pt/skills#skill-not-triggering)

1021* **A descrição está truncada**: quando muitas skills estão instaladas, Claude Code encurta descrições para caber no orçamento de caracteres da listagem, o que pode remover as palavras-chave que Claude precisa para corresponder a uma solicitação. Veja [Skill descriptions are cut short](/docs/pt/skills#skill-descriptions-are-cut-short)1021* **A descrição está truncada**: quando muitas skills estão instaladas, Claude Code encurta descrições para caber no orçamento de caracteres da listagem, o que pode remover as palavras-chave que Claude precisa para corresponder a uma solicitação. Veja [Skill descriptions are cut short](/docs/pt/skills#skill-descriptions-are-cut-short)

1022 1022 

sandboxing.md +1 −1

Details

463 463 

464O mascaramento requer o seguinte:464O mascaramento requer o seguinte:

465 465 

466* **Terminação de TLS**: o proxy substitui o valor real dentro do conteúdo da requisição, então precisa enxergá-lo. Defina [`network.tlsTerminate`](/docs/pt/settings-reference#sandbox-network-tlsterminate) para que o proxy termine o TLS por conta própria. Sem isso, o mascaramento falha sem expor nada: o comando ainda vê apenas o sentinela, mas o sentinela chega ao servidor inalterado e a autenticação falha. O Claude Code relata essa configuração incorreta na inicialização.466* **Terminação de TLS**: o proxy substitui o valor real dentro do conteúdo da requisição, então precisa enxergá-lo. Defina [`network.tlsTerminate`](/docs/pt/settings-reference#sandbox-network-tlsterminate) para que o proxy termine o TLS por conta própria. Sem isso, o mascaramento falha sem expor nada: o comando ainda vê apenas o sentinela, mas o sentinela chega ao servidor inalterado e a autenticação falha. Para verificar essa configuração incorreta, execute `claude doctor` no seu terminal e procure o aviso `TLS termination is unavailable`.

467* **Um destino permitido**: cada entrada `mask` pode listar `injectHosts`, os hosts que o valor real tem permissão para alcançar. O proxy injeta apenas em conexões que a [allowlist de domínios](#network-isolation) admite, então cada host de `injectHosts` também precisa estar acessível por meio de `network.allowedDomains`. Para uma entrada `mask` sem `injectHosts`, o proxy substitui o valor real em requisições para todos os hosts em `network.allowedDomains`.467* **Um destino permitido**: cada entrada `mask` pode listar `injectHosts`, os hosts que o valor real tem permissão para alcançar. O proxy injeta apenas em conexões que a [allowlist de domínios](#network-isolation) admite, então cada host de `injectHosts` também precisa estar acessível por meio de `network.allowedDomains`. Para uma entrada `mask` sem `injectHosts`, o proxy substitui o valor real em requisições para todos os hosts em `network.allowedDomains`.

468* **Um escopo de configurações confiável**: o mascaramento autoriza o proxy a enviar sua credencial real para algum lugar, então o Claude Code respeita entradas `mask`, `network.tlsTerminate`, [`credentials.allowPlaintextInject`](/docs/pt/settings-reference#sandbox-credentials-allowplaintextinject), `awsPairs` e `sigv4` somente a partir de configurações de usuário, configurações gerenciadas e da flag `--settings`. Ele os ignora no `.claude/settings.json` ou `.claude/settings.local.json` de um repositório. Quando seu administrador fornece entradas `mask`, `network.tlsTerminate` ou `credentials.allowPlaintextInject` por meio de configurações gerenciadas pelo servidor, elas contam como [configurações que precisam de aprovação](/docs/pt/server-managed-settings#security-approval-dialogs).468* **Um escopo de configurações confiável**: o mascaramento autoriza o proxy a enviar sua credencial real para algum lugar, então o Claude Code respeita entradas `mask`, `network.tlsTerminate`, [`credentials.allowPlaintextInject`](/docs/pt/settings-reference#sandbox-credentials-allowplaintextinject), `awsPairs` e `sigv4` somente a partir de configurações de usuário, configurações gerenciadas e da flag `--settings`. Ele os ignora no `.claude/settings.json` ou `.claude/settings.local.json` de um repositório. Quando seu administrador fornece entradas `mask`, `network.tlsTerminate` ou `credentials.allowPlaintextInject` por meio de configurações gerenciadas pelo servidor, elas contam como [configurações que precisam de aprovação](/docs/pt/server-managed-settings#security-approval-dialogs).

469 469 

Details

117claude -p "your message" --cloud <session-id>117claude -p "your message" --cloud <session-id>

118```118```

119 119 

120Para `<session-id>`, passe o ID `session_...` ou `cse_...` simples ou a URL claude.ai/code da sessão. Um envio bem-sucedido imprime `Sent to cloud session.` com o ID da sessão e um link de visualização. Formas de ID aceitas, saída JSON, requisitos de conta e política e a referência de erro estão em [Enviar acompanhamentos a partir do CLI](/docs/pt/claude-code-on-the-web#send-follow-ups-from-the-cli), pois o comando funciona da mesma forma contra sessões hospedadas pela Anthropic.120Para `<session-id>`, passe o ID `session_...` ou `cse_...` simples ou a URL claude.ai/code da sessão. Um envio bem-sucedido imprime `Sent to cloud session.` com o ID da sessão e um link de visualização. Formas de ID aceitas, saída JSON e os requisitos de conta e política estão em [Enviar acompanhamentos a partir do CLI](/docs/pt/claude-code-on-the-web#send-follow-ups-from-the-cli), pois o comando funciona da mesma forma contra sessões hospedadas pela Anthropic.

121 121 

122<h2 id="what’s-next">122<h2 id="what’s-next">

123 Próximos passos123 Próximos passos

Details

3135* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/pt/sessions#name-the-project-directory-yourself), que Claude Code lê apenas do ambiente de inicialização, é ignorada de cada arquivo; requer v2.1.234 ou posterior.3135* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/pt/sessions#name-the-project-directory-yourself), que Claude Code lê apenas do ambiente de inicialização, é ignorada de cada arquivo; requer v2.1.234 ou posterior.

3136* [`CLAUDE_CODE_RESTRICTED`](/docs/pt/env-vars#variables), que Claude Code lê apenas do ambiente de inicialização, é ignorada de cada arquivo.3136* [`CLAUDE_CODE_RESTRICTED`](/docs/pt/env-vars#variables), que Claude Code lê apenas do ambiente de inicialização, é ignorada de cada arquivo.

3137* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/pt/env-vars#variables), que Claude Code lê apenas do ambiente de inicialização, é ignorada de cada arquivo. A variável requer Claude Code v2.1.283 ou posterior.3137* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/pt/env-vars#variables), que Claude Code lê apenas do ambiente de inicialização, é ignorada de cada arquivo. A variável requer Claude Code v2.1.283 ou posterior.

3138* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` e `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/pt/env-vars#variables), que Claude Code lê apenas do ambiente de inicialização, são ignoradas de cada arquivo.3138* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`, `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` e `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT`](/docs/pt/env-vars#variables), que Claude Code lê apenas do ambiente de inicialização, são ignoradas de cada arquivo.

3139 3139 

3140<h3 id="filecheckpointingenabled">3140<h3 id="filecheckpointingenabled">

3141 `fileCheckpointingEnabled`3141 `fileCheckpointingEnabled`

skills.md +71 −58

Details

364- Include request validation364- Include request validation

365```365```

366 366 

367**Conteúdo de tarefa** fornece ao Claude instruções passo a passo para uma ação específica, como deploys, commits ou geração de código. Geralmente são ações que você deseja invocar diretamente com `/skill-name` em vez de deixar o Claude decidir quando executá-las. Adicione `disable-model-invocation: true` para impedir que o Claude a acione automaticamente. O exemplo abaixo adiciona `context: fork`, que executa a skill em seu próprio contexto de subagente; consulte [Executar skills em um subagente](#run-skills-in-a-subagent).367**Conteúdo de tarefa** fornece ao Claude instruções passo a passo para uma ação específica, como implantações, commits ou geração de código. Geralmente são ações que você deseja invocar diretamente com `/skill-name` em vez de deixar o Claude decidir quando executá-las. Adicione `disable-model-invocation: true` para impedir que o Claude a acione automaticamente. O exemplo abaixo adiciona `context: fork`, que executa a skill em seu próprio contexto de subagente; consulte [Executar skills em um subagente](#run-skills-in-a-subagent).

368 368 

369```yaml theme={null}369```yaml theme={null}

370---370---


386 Referência do frontmatter386 Referência do frontmatter

387</h3>387</h3>

388 388 

389Configure uma skill com [frontmatter](/docs/pt/glossary#frontmatter) YAML entre marcadores `---` no topo do `SKILL.md` e escreva as instruções da skill em Markdown após o `---` de fechamento. Os nomes dos campos usam palavras em minúsculas separadas por hifens, exceto `when_to_use`. Um [arquivo de comando](#where-skills-live) em `.claude/commands/` aceita os mesmos campos, exceto `name` e `paths`. Este exemplo define quatro campos:389Configure uma skill com o [frontmatter](/docs/pt/glossary#frontmatter) YAML entre marcadores `---` no topo do `SKILL.md` e escreva as instruções da skill em Markdown após o `---` de fechamento. Os nomes dos campos usam palavras em minúsculas separadas por hífens, exceto `when_to_use`. Um [arquivo de comando](#where-skills-live) em `.claude/commands/` aceita os mesmos campos, exceto `name` e `paths`. Este exemplo define quatro campos:

390 390 

391```yaml theme={null}391```yaml theme={null}

392---392---


399Your skill instructions here...399Your skill instructions here...

400```400```

401 401 

402Todos os campos são opcionais. Apenas `description` é recomendado para que o Claude saiba quando usar a skill. O nome de um campo deve corresponder exatamente à tabela, incluindo hifens: o Claude Code ignora um campo que não reconhece sem relatar um erro.402Todos os campos são opcionais. Apenas `description` é recomendado, para que o Claude saiba quando usar a skill. O nome de um campo deve corresponder exatamente à tabela, incluindo os hífens: o Claude Code ignora um campo que não reconhece sem relatar um erro.

403 403 

404O Claude Code lê o frontmatter somente quando o `---` de abertura é a primeira linha do arquivo. Caso contrário, ele trata o arquivo inteiro, incluindo os marcadores `---`, como conteúdo da skill. Se o YAML entre os marcadores não puder ser analisado, a skill ainda é carregada sem nenhum campo definido; consulte [Skill não é acionada](#skill-not-triggering) para encontrar e corrigir o erro.404O Claude Code lê o frontmatter somente quando o `---` de abertura é a primeira linha do arquivo. Caso contrário, ele trata o arquivo inteiro, incluindo os marcadores `---`, como conteúdo da skill. Se o YAML entre os marcadores não puder ser analisado, a skill ainda é carregada sem nenhum campo definido; consulte [Skill não é acionada](#skill-not-triggering) para encontrar e corrigir o erro.

405 405 

406Campos booleanos aceitam `yes`, `no`, `on`, `off`, `1` e `0` com qualquer combinação de maiúsculas e minúsculas, além de `true` e `false`. Antes da v2.1.218, o Claude Code reconhecia apenas `true` e `false`.406Campos booleanos aceitam `yes`, `no`, `on`, `off`, `1` e `0` em qualquer combinação de maiúsculas e minúsculas, além de `true` e `false`. Antes da v2.1.218, o Claude Code reconhecia apenas `true` e `false`.

407 407 

408| Campo | Obrigatório | Descrição |408| Campo | Obrigatório | Descrição |

409| :- | :- | :- |409| :- | :- | :- |

410| `name` | Não | Nome do comando exibido no menu `/`. O padrão é o nome do diretório. Consulte [Como uma skill obtém seu nome de comando](#how-a-skill-gets-its-command-name) para ver como o campo interage com o nome que você digita para invocar a skill. |410| `name` | Não | Nome do comando exibido no menu `/`. O padrão é o nome do diretório. Consulte [Como uma skill obtém seu nome de comando](#how-a-skill-gets-its-command-name) para saber como o campo interage com o nome que você digita para invocar a skill. |

411| `description` | Recomendado | O que a skill faz e quando usá-la. O Claude usa isso para decidir quando aplicar a skill. Se omitido, usa a primeira linha não vazia do conteúdo markdown. Coloque o caso de uso principal primeiro: o texto combinado de `description` e `when_to_use` é truncado em 1.536 caracteres na listagem de skills para reduzir o uso de contexto. |411| `description` | Recomendado | O que a skill faz e quando usá-la. O Claude usa isso para decidir quando aplicar a skill. Se omitido, usa a primeira linha não vazia do conteúdo markdown. Coloque o caso de uso principal primeiro: o texto combinado de `description` e `when_to_use` é truncado em 1.536 caracteres na listagem de skills para reduzir o uso de contexto. |

412| `when_to_use` | Não | Contexto adicional sobre quando o Claude deve invocar a skill, como frases de acionamento ou exemplos de solicitações. É anexado a `description` na listagem de skills e conta para o limite de 1.536 caracteres. |412| `when_to_use` | Não | Contexto adicional sobre quando o Claude deve invocar a skill, como frases de acionamento ou exemplos de solicitações. É anexado a `description` na listagem de skills e conta para o limite de 1.536 caracteres. |

413| `argument-hint` | Não | Dica exibida durante o preenchimento automático para indicar os argumentos esperados. Exemplo: `[issue-number]` ou `[filename] [format]`. |413| `argument-hint` | Não | Dica exibida durante o preenchimento automático para indicar os argumentos esperados. Exemplo: `[issue-number]` ou `[filename] [format]`. |

414| `arguments` | Não | Argumentos posicionais nomeados para [substituição `$name`](#available-string-substitutions) no conteúdo da skill. Aceita uma string separada por espaços ou uma lista YAML. Os nomes são mapeados para as posições dos argumentos em ordem. |414| `arguments` | Não | Argumentos posicionais nomeados para [substituição de `$name`](#available-string-substitutions) no conteúdo da skill. Aceita uma string separada por espaços ou uma lista YAML. Os nomes são mapeados para as posições dos argumentos em ordem. |

415| `disable-model-invocation` | Não | Defina como `true` para impedir que o Claude carregue esta skill automaticamente. Use para fluxos de trabalho que você deseja acionar manualmente com `/name`. Também impede que a skill seja [pré-carregada em subagentes](/docs/pt/sub-agents#preload-skills-into-subagents). A partir da v2.1.196, também impede que a skill seja executada quando uma [tarefa agendada](/docs/pt/scheduled-tasks) é disparada com a skill como seu prompt. Padrão: `false`. |415| `disable-model-invocation` | Não | Defina como `true` para impedir que o Claude carregue esta skill automaticamente. Use para fluxos de trabalho que você deseja acionar manualmente com `/name`. Também impede que a skill seja [pré-carregada em subagentes](/docs/pt/sub-agents#preload-skills-into-subagents). A partir da v2.1.196, também impede que a skill seja executada quando uma [tarefa agendada](/docs/pt/scheduled-tasks) dispara com a skill como seu prompt. Padrão: `false`. |

416| `user-invocable` | Não | Defina como `false` quando apenas o Claude deve invocar a skill: o Claude Code a oculta do menu `/` e não a executa quando você digita `/name`. Use para conhecimento de fundo que os usuários não devem invocar diretamente. Padrão: `true`. |416| `user-invocable` | Não | Defina como `false` quando apenas o Claude deve invocar a skill: o Claude Code a oculta do menu `/` e não a executa quando você digita `/name`. Use para conhecimento de fundo que os usuários não devem invocar diretamente. Padrão: `true`. |

417| `allowed-tools` | Não | Ferramentas que o Claude pode usar sem pedir permissão durante o turno que invoca esta skill. A concessão é removida quando você envia sua próxima mensagem. Aceita uma string separada por espaços ou vírgulas, ou uma lista YAML. Consulte [Pré-aprovar ferramentas para uma skill](#pre-approve-tools-for-a-skill). |417| `allowed-tools` | Não | Ferramentas que o Claude pode usar sem pedir permissão durante o turno que invoca esta skill. A concessão é removida quando você envia sua próxima mensagem. Aceita uma string separada por espaços ou vírgulas, ou uma lista YAML. Consulte [Pré-aprovar ferramentas para uma skill](#pre-approve-tools-for-a-skill). |

418| `disallowed-tools` | Não | Ferramentas removidas do conjunto disponível do Claude enquanto esta skill está ativa. Use para skills autônomas que nunca devem chamar certas ferramentas, como `AskUserQuestion` para um loop em segundo plano. Aceita uma string separada por espaços ou vírgulas, ou uma lista YAML. A restrição é removida quando você envia sua próxima mensagem. Assim como as regras deny, o campo não pode remover [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) enquanto qualquer outra ferramenta permanecer. |418| `disallowed-tools` | Não | Ferramentas removidas do conjunto disponível do Claude enquanto esta skill está ativa. Use para skills autônomas que nunca devem chamar certas ferramentas, como `AskUserQuestion` para um loop em segundo plano. Aceita uma string separada por espaços ou vírgulas, ou uma lista YAML. A restrição é removida quando você envia sua próxima mensagem. Assim como as regras de deny, o campo não pode remover [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) enquanto qualquer outra ferramenta permanecer. |

419| `model` | Não | Modelo a ser usado quando esta skill está ativa. A substituição se aplica pelo restante do turno atual e não é salva nas configurações. O modelo da sessão é retomado quando você envia seu próximo prompt. Aceita os mesmos valores que [`/model`](/docs/pt/model-config), ou `inherit` para manter o modelo ativo. Um valor excluído pela allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização não é usado, e a sessão mantém seu modelo atual. No [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), e no [modo de planejamento enquanto o classificador revisa comandos](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), um modelo que o modo auto não suporta também não é usado, e a sessão mantém seu modelo atual. Com `context: fork`, o valor define o [modelo do subagente bifurcado](#run-skills-in-a-subagent), e um valor excluído segue as [mesmas regras de uma substituição de modelo de subagente](/docs/pt/model-config#restrict-model-selection). |419| `model` | Não | Modelo a ser usado quando esta skill está ativa. A substituição se aplica ao restante do turno atual e não é salva nas configurações. O modelo da sessão é retomado quando você envia seu próximo prompt. Aceita os mesmos valores que [`/model`](/docs/pt/model-config), ou `inherit` para manter o modelo ativo. Um valor excluído pela allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização não é usado, e a sessão mantém seu modelo atual. No [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), e no [modo de planejamento enquanto o classificador revisa comandos](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), um modelo que o modo auto não suporta também não é usado, e a sessão mantém seu modelo atual. Com `context: fork`, o valor define o [modelo do subagente bifurcado](#run-skills-in-a-subagent) em vez disso, e um valor excluído segue as [mesmas regras que uma substituição de modelo de subagente](/docs/pt/model-config#restrict-model-selection). |

420| `effort` | Não | [Nível de esforço](/docs/pt/model-config#adjust-effort-level) quando esta skill está ativa. Sobrescreve o nível de esforço da sessão. Quando você o omite, o nível vem da [ordem de resolução de esforço](/docs/pt/model-config#adjust-effort-level). Opções: `low`, `medium`, `high`, `xhigh`, `max`; os níveis disponíveis dependem do modelo. |420| `effort` | Não | [Nível de esforço](/docs/pt/model-config#adjust-effort-level) quando esta skill está ativa. Sobrescreve o nível de esforço da sessão. Quando você o omite, o nível vem da [ordem de resolução de esforço](/docs/pt/model-config#adjust-effort-level). Opções: `low`, `medium`, `high`, `xhigh`, `max`; os níveis disponíveis dependem do modelo. |

421| `context` | Não | Defina como `fork` para executar em um contexto de subagente bifurcado. Consulte [Executar skills em um subagente](#run-skills-in-a-subagent). |421| `context` | Não | Defina como `fork` para executar em um contexto de subagente bifurcado. Consulte [Executar skills em um subagente](#run-skills-in-a-subagent). |

422| `agent` | Não | Qual tipo de subagente usar quando `context: fork` está definido. |422| `agent` | Não | Qual tipo de subagente usar quando `context: fork` está definido. |

423| `background` | Não | Aplica-se somente com `context: fork`. Defina como `false` para aguardar o resultado do subagente bifurcado no turno que invocou a skill, em vez de [executá-lo em segundo plano](#run-skills-in-a-subagent). Padrão: `true`. Requer Claude Code v2.1.218 ou posterior. |423| `background` | Não | Aplica-se apenas com `context: fork`. Defina como `false` para aguardar o resultado do subagente bifurcado no turno que invocou a skill, em vez de [executá-lo em segundo plano](#run-skills-in-a-subagent). Padrão: `true`. Requer o Claude Code v2.1.218 ou posterior. |

424| `hooks` | Não | Hooks que o Claude Code registra quando a skill é invocada e mantém em execução pelo restante da sessão. Consulte [Hooks em skills e agentes](/docs/pt/hooks#hooks-in-skills-and-agents) para o formato de configuração e a opção `once`. |424| `hooks` | Não | Hooks que o Claude Code registra quando a skill é invocada e mantém em execução pelo restante da sessão. Consulte [Hooks em skills e agentes](/docs/pt/hooks#hooks-in-skills-and-agents) para o formato de configuração e a opção `once`. |

425| `paths` | Não | Padrões glob que limitam quando esta skill é ativada. Aceita uma string separada por vírgulas ou uma lista YAML. Quando definido, o Claude carrega a skill automaticamente somente ao trabalhar com arquivos que correspondem aos padrões. Usa o mesmo formato das [regras específicas de caminho](/docs/pt/memory#path-specific-rules). |425| `paths` | Não | Padrões glob que limitam quando esta skill é ativada. Aceita uma string separada por vírgulas ou uma lista YAML. Quando definido, o Claude carrega a skill automaticamente apenas ao trabalhar com arquivos que correspondem aos padrões. Usa o mesmo formato que as [regras específicas de caminho](/docs/pt/memory#path-specific-rules). |

426| `shell` | Não | Shell a ser usado para blocos `` !`command` `` e ` ```! ` nesta skill. Aceita `bash` (padrão) ou `powershell`. Definir `powershell` executa comandos de shell inline via PowerShell quando a [ferramenta PowerShell](/pt/tools-reference#powershell-tool) está habilitada: ela fica ativada por padrão no Windows sem Git Bash, ativada por padrão com Git Bash para contas claude.ai e Console, e precisa de `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` em sessões do Amazon Bedrock, do Agent Platform do Google Cloud e do Microsoft Foundry, e no macOS, Linux e WSL. Defina como `0` para desativar a ferramenta. |426| `shell` | Não | Shell a ser usado para blocos `` !`command` `` e ` ```! ` nesta skill. Aceita `bash` (padrão) ou `powershell`. Definir `powershell` executa comandos de shell inline via PowerShell quando a [ferramenta PowerShell](/pt/tools-reference#powershell-tool) está habilitada: ela está ativada por padrão no Windows sem Git Bash, ativada por padrão com Git Bash para contas claude.ai e Console, e requer `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` em sessões do Amazon Bedrock, do Agent Platform do Google Cloud e do Microsoft Foundry, e no macOS, Linux e WSL. Defina-a como `0` para desativar a ferramenta. |

427| `metadata` | Não | Mapa YAML de formato livre para seus próprios dados de chave-valor, como campos de direitos de uso ou de catálogo, lidos pelas suas próprias ferramentas a partir do `SKILL.md`. O Claude Code não age sobre seu conteúdo e descarta um valor que não seja um mapa. Não reutilize nomes de campos do frontmatter, como `paths`, como chaves. |427| `metadata` | Não | Mapa YAML de formato livre para seus próprios dados de chave-valor, como campos de direitos de uso ou de catálogo, lidos por suas próprias ferramentas a partir do `SKILL.md`. O Claude Code não age sobre seu conteúdo e descarta um valor que não seja um mapa. Não reutilize nomes de campos do frontmatter, como `paths`, como chaves. |

428| `license` | Não | Licença que cobre a skill. Faz parte da especificação [Agent Skills](https://agentskills.io); consulte [Usar o frontmatter de skills fora do Claude Code](#using-skill-frontmatter-outside-claude-code). O Claude Code aceita o campo, mas não age sobre ele. |428| `license` | Não | Licença que cobre a skill. Faz parte da especificação [Agent Skills](https://agentskills.io); consulte [Usar o frontmatter de skills fora do Claude Code](#using-skill-frontmatter-outside-claude-code). O Claude Code aceita o campo, mas não age sobre ele. |

429| `compatibility` | Não | Requisitos de ambiente para a skill, como produtos pretendidos ou pré-requisitos de sistema, conforme definido pela especificação [Agent Skills](https://agentskills.io); consulte [Usar o frontmatter de skills fora do Claude Code](#using-skill-frontmatter-outside-claude-code). Aceita uma string de até 500 caracteres. O Claude Code aceita o campo, mas não age sobre ele. |429| `compatibility` | Não | Requisitos de ambiente para a skill, como produtos pretendidos ou pré-requisitos de sistema, conforme definido pela especificação [Agent Skills](https://agentskills.io); consulte [Usar o frontmatter de skills fora do Claude Code](#using-skill-frontmatter-outside-claude-code). Aceita uma string de até 500 caracteres. O Claude Code aceita o campo, mas não age sobre ele. |

430 430 


436 436 

437| Caminho de distribuição | Campos de frontmatter que você pode usar |437| Caminho de distribuição | Campos de frontmatter que você pode usar |

438| :- | :- |438| :- | :- |

439| Skills do Claude Code em [qualquer nível](#where-skills-live), incluindo skills de [plugins](/docs/pt/plugins/overview) | Todos os campos da tabela acima |439| Skills do Claude Code em [qualquer nível](#where-skills-live), incluindo skills de [plugin](/docs/pt/plugins/overview) | Todos os campos da tabela acima |

440| Uploads de skills no claude.ai, a API de Skills e o empacotamento com `package_skill.py` de [anthropics/skills](https://github.com/anthropics/skills) | `name`, `description`, `license`, `compatibility`, `metadata`, `allowed-tools` |440| Uploads de skills no claude.ai, a Skills API e o empacotamento com `package_skill.py` de [anthropics/skills](https://github.com/anthropics/skills) | `name`, `description`, `license`, `compatibility`, `metadata`, `allowed-tools` |

441 441 

442Quando você habilita uma skill pessoal para sua conta do claude.ai, por exemplo para usá-la em [sessões do Cowork e na nuvem](#skills-in-cowork-and-cloud-sessions) e em rotinas, você a envia para o claude.ai, então as mesmas regras se aplicam.442Quando você habilita uma skill pessoal para sua conta do claude.ai, por exemplo para usá-la no [Cowork e em sessões na nuvem](#skills-in-cowork-and-cloud-sessions) e em rotinas, você a envia para o claude.ai, então as mesmas regras se aplicam.

443 443 

444Se você incluir qualquer campo que a especificação não permite, o empacotamento ou o upload falha com um erro grave em vez de ignorar o campo:444Se você incluir qualquer campo que a especificação não permite, o empacotamento ou o upload falha com um erro fatal em vez de ignorar o campo:

445 445 

446```446```

447Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name447Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

448```448```

449 449 

450Restringir o frontmatter aos seis campos da especificação evita o erro de chave inesperada acima. A [especificação Agent Skills](https://agentskills.io) e os [requisitos da API de Skills](https://docs.claude.com/en/api/skills-guide) definem todo o resto que esses caminhos validam. Recursos de corpo exclusivos do Claude Code, como a [injeção de contexto dinâmico](#inject-dynamic-context), não funcionam no chat do claude.ai nem pela API. O Claude Code aceita todos os seis campos, então um frontmatter que segue a especificação é carregado no Claude Code sem alterações.450Restringir o frontmatter aos seis campos da especificação evita o erro de chave inesperada acima. A [especificação Agent Skills](https://agentskills.io) e os [requisitos da Skills API](https://docs.claude.com/en/api/skills-guide) definem todo o resto que esses caminhos validam. Recursos de corpo exclusivos do Claude Code, como a [injeção de contexto dinâmico](#inject-dynamic-context), não funcionam no chat do claude.ai nem pela API. O Claude Code aceita todos os seis campos, então um frontmatter que segue a especificação é carregado no Claude Code sem alterações.

451 451 

452<h4 id="how-a-skill-gets-its-command-name">452<h4 id="how-a-skill-gets-its-command-name">

453 Como uma skill obtém seu nome de comando453 Como uma skill obtém seu nome de comando

454</h4>454</h4>

455 455 

456O comando que você digita para invocar uma skill vem do local onde o arquivo da skill está e, para diretórios de skills e skills de plugins, do campo `name` do frontmatter. Em um diretório de skills pessoal ou de projeto, `name` define o comando que o menu `/` exibe e que você digita, a menos que outro comando já use esse nome. O nome do diretório também invoca a skill. Em uma skill de plugin, `name` define o último segmento do comando e o prefixo do plugin permanece.456O comando que você digita para invocar uma skill vem do local onde o arquivo da skill está e, para diretórios de skills e skills de plugin, do campo `name` do frontmatter. Em um diretório de skills pessoal ou de projeto, `name` define o comando que o menu `/` exibe e que você digita, a menos que outro comando já use esse nome. O nome do diretório também invoca a skill. Em uma skill de plugin, `name` define o último segmento do comando, e o prefixo do plugin permanece.

457 457 

458A tabela abaixo mostra de onde vem o nome do comando para cada estrutura:458A tabela abaixo mostra de onde vem o nome do comando para cada estrutura:

459 459 


463| Diretório `.claude/skills/` [aninhado](#where-skills-live), quando o nome do diretório conflita com outra skill | Caminho do subdiretório relativo ao diretório de trabalho, seguido do nome do diretório da skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |463| Diretório `.claude/skills/` [aninhado](#where-skills-live), quando o nome do diretório conflita com outra skill | Caminho do subdiretório relativo ao diretório de trabalho, seguido do nome do diretório da skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |

464| Arquivo em `.claude/commands/` | Nome do arquivo sem extensão | `.claude/commands/deploy.md` → `/deploy` |464| Arquivo em `.claude/commands/` | Nome do arquivo sem extensão | `.claude/commands/deploy.md` → `/deploy` |

465| Arquivo em um subdiretório de `.claude/commands/` | Caminho do subdiretório relativo a `commands/` com cada `/` substituída por `:`, seguido do nome do arquivo sem extensão | `.claude/commands/frontend/component.md` → `/frontend:component` |465| Arquivo em um subdiretório de `.claude/commands/` | Caminho do subdiretório relativo a `commands/` com cada `/` substituída por `:`, seguido do nome do arquivo sem extensão | `.claude/commands/frontend/component.md` → `/frontend:component` |

466| Subdiretório `skills/` de plugin | `name` do frontmatter ou o nome do diretório, com namespace do plugin | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review`, ou `/my-plugin:fancy` com `name: fancy` |466| Subdiretório `skills/` do plugin | `name` do frontmatter ou o nome do diretório, com namespace do plugin | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review`, ou `/my-plugin:fancy` com `name: fancy` |

467| `SKILL.md` na raiz do plugin | `name` do frontmatter, com o nome do diretório do plugin como fallback | `my-plugin/SKILL.md` com `name: review` → `/my-plugin:review`. Consulte [uma única skill na raiz do plugin](/docs/pt/plugins/components#skills) |467| `SKILL.md` na raiz do plugin | `name` do frontmatter, com o nome do diretório do plugin como fallback | `my-plugin/SKILL.md` com `name: review` → `/my-plugin:review`. Consulte [uma única skill na raiz do plugin](/docs/pt/plugins/components#skills) |

468| Skill [sincronizada do claude.ai](#how-synced-skills-behave) | O nome da skill na sua conta do claude.ai, com o prefixo `anthropic-skills:` | Skill da conta `deploy` → `/anthropic-skills:deploy`, ou `/deploy` enquanto nenhum outro comando usar esse nome |468| Skill [sincronizada do claude.ai](#how-synced-skills-behave) | O nome da skill na sua conta do claude.ai, prefixado com `anthropic-skills:` | Skill da conta `deploy` → `/anthropic-skills:deploy`, ou `/deploy` enquanto nenhum outro comando usar esse nome |

469 469 

470Em uma skill de plugin, o `name` do frontmatter substitui o nome do diretório no último segmento do comando, então `my-plugin/skills/review/SKILL.md` com `name: fancy` se torna `/my-plugin:fancy`. O `/fancy` simples também invoca a skill, a menos que outro comando já use esse nome. Se o `name` que você escreve já começa com o próprio prefixo do plugin, o Claude Code não adiciona o prefixo novamente na v2.1.246 ou posterior. Por exemplo, `name: my-plugin:fancy` ainda se torna `/my-plugin:fancy`. Da v2.1.216 até a v2.1.245, o Claude Code duplicava o prefixo quando o `name` já o continha.470Em uma skill de plugin, o `name` do frontmatter substitui o nome do diretório no último segmento do comando, então `my-plugin/skills/review/SKILL.md` com `name: fancy` se torna `/my-plugin:fancy`. O `/fancy` sem prefixo também invoca a skill, a menos que outro comando já use esse nome. Se o `name` que você escrever já começar com o prefixo do próprio plugin, o Claude Code não adiciona o prefixo novamente na v2.1.246 ou posterior. Por exemplo, `name: my-plugin:fancy` ainda se torna `/my-plugin:fancy`. Da v2.1.216 até a v2.1.245, o Claude Code duplicava o prefixo quando o `name` já o continha.

471 471 

472Em [sessões não interativas](/docs/pt/headless), os nomes `help` e `feedback` não são reservados para seus comandos integrados exclusivos do terminal, então uma skill de plugin com um desses nomes mantém seu comando simples nessas sessões. O nome de todos os outros comandos integrados exclusivos do terminal, como `/login`, permanece reservado, mesmo que o comando não possa ser executado nessas sessões.472Em [sessões não interativas](/docs/pt/headless), os nomes `help` e `feedback` não são reservados para seus comandos integrados exclusivos do terminal, então uma skill de plugin com um desses nomes mantém seu comando sem prefixo ali. O nome de todos os outros comandos integrados exclusivos do terminal, como `/login`, permanece reservado, mesmo que o comando não possa ser executado nessas sessões.

473 473 

474Para um `SKILL.md` na raiz do plugin, não há diretório de skill de onde obter o nome, então `name` fornece todo o segmento final. Sem um campo `name`, o Claude Code usa o nome do diretório do plugin como fallback.474Para um `SKILL.md` na raiz do plugin, não há diretório de skill de onde obter o nome, então `name` fornece todo o segmento final. Sem um campo `name`, o Claude Code recorre ao nome do diretório do plugin.

475 475 

476<h4 id="available-string-substitutions">476<h4 id="available-string-substitutions">

477 Substituições de string disponíveis477 Substituições de string disponíveis


482| Variável | Descrição |482| Variável | Descrição |

483| :- | :- |483| :- | :- |

484| `$ARGUMENTS` | Todos os argumentos passados ao invocar a skill. Quando nenhum placeholder recebe um argumento, o Claude Code os anexa como `ARGUMENTS: <value>`. Consulte [Passar argumentos para skills](#pass-arguments-to-skills). |484| `$ARGUMENTS` | Todos os argumentos passados ao invocar a skill. Quando nenhum placeholder recebe um argumento, o Claude Code os anexa como `ARGUMENTS: <value>`. Consulte [Passar argumentos para skills](#pass-arguments-to-skills). |

485| `$ARGUMENTS[N]` | Acessa um argumento específico por índice baseado em 0, como `$ARGUMENTS[0]` para o primeiro argumento. |485| `$ARGUMENTS[N]` | Acessa um argumento específico pelo índice baseado em 0, como `$ARGUMENTS[0]` para o primeiro argumento. |

486| `$N` | Forma abreviada de `$ARGUMENTS[N]`, como `$0` para o primeiro argumento ou `$1` para o segundo. |486| `$N` | Forma abreviada de `$ARGUMENTS[N]`, como `$0` para o primeiro argumento ou `$1` para o segundo. |

487| `$name` | Argumento nomeado declarado na lista [`arguments`](#frontmatter-reference) do frontmatter. Os nomes são mapeados para as posições em ordem, então com `arguments: [issue, branch]` o placeholder `$issue` se expande para o primeiro argumento e `$branch` para o segundo. |487| `$name` | Argumento nomeado declarado na lista [`arguments`](#frontmatter-reference) do frontmatter. Os nomes são mapeados para as posições em ordem, então com `arguments: [issue, branch]` o placeholder `$issue` se expande para o primeiro argumento e `$branch` para o segundo. |

488| `${CLAUDE_SESSION_ID}` | O ID da sessão atual. Útil para registro em log, criação de arquivos específicos da sessão ou correlação da saída da skill com sessões. |488| `${CLAUDE_SESSION_ID}` | O ID da sessão atual. Útil para logs, para criar arquivos específicos da sessão ou para correlacionar a saída da skill com sessões. |

489| `${CLAUDE_EFFORT}` | O nível de esforço atual: `low`, `medium`, `high`, `xhigh` ou `max`. Use para adaptar as instruções da skill à configuração de esforço ativa. |489| `${CLAUDE_EFFORT}` | O nível de esforço atual: `low`, `medium`, `high`, `xhigh` ou `max`. Use isso para adaptar as instruções da skill à configuração de esforço ativa. |

490| `${CLAUDE_SKILL_DIR}` | O diretório que contém o arquivo `SKILL.md` da skill. Para skills de plugins, é o subdiretório da skill dentro do plugin, não a raiz do plugin. Use em comandos de injeção bash para referenciar scripts ou arquivos incluídos com a skill, independentemente do diretório de trabalho atual. |490| `${CLAUDE_SKILL_DIR}` | O diretório que contém o arquivo `SKILL.md` da skill. Para skills de plugin, é o subdiretório da skill dentro do plugin, não a raiz do plugin. Use isso em comandos de injeção bash para referenciar scripts ou arquivos incluídos com a skill, independentemente do diretório de trabalho atual. |

491| `${CLAUDE_PROJECT_DIR}` | O diretório raiz do projeto. É o mesmo caminho que os [hooks](/docs/pt/hooks#reference-scripts-by-path) e os servidores MCP recebem como `CLAUDE_PROJECT_DIR`. Use para referenciar scripts ou arquivos locais do projeto, como `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, independentemente de onde a skill esteja instalada. |491| `${CLAUDE_PROJECT_DIR}` | O diretório raiz do projeto. É o mesmo caminho que os [hooks](/docs/pt/hooks#reference-scripts-by-path) e os servidores MCP recebem como `CLAUDE_PROJECT_DIR`. Use isso para referenciar scripts ou arquivos locais do projeto, como `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, independentemente de onde a skill está instalada. |

492| `${CLAUDE_PLUGIN_ROOT}` | O diretório de instalação do plugin. Substituído somente em skills de plugins. Use para referenciar scripts ou arquivos incluídos em qualquer lugar do plugin, incluindo recursos compartilhados entre as skills do plugin. Consulte [variáveis de ambiente de plugins](/docs/pt/plugins/manifest-reference#environment-variables). |492| `${CLAUDE_PLUGIN_ROOT}` | O diretório de instalação do plugin. Substituído apenas em skills de plugin. Use isso para referenciar scripts ou arquivos incluídos em qualquer lugar do plugin, incluindo recursos compartilhados entre as skills do plugin. Consulte [variáveis de ambiente de plugins](/docs/pt/plugins/manifest-reference#environment-variables). |

493| `${CLAUDE_PLUGIN_DATA}` | O [diretório de dados persistentes](/docs/pt/plugins/components#path-variables-and-persistent-data) do plugin, que sobrevive às atualizações do plugin. Substituído somente em skills de plugins. Use para referenciar dependências instaladas, arquivos gerados ou caches que devem sobreviver a uma atualização. |493| `${CLAUDE_PLUGIN_DATA}` | O [diretório de dados persistentes](/docs/pt/plugins/components#path-variables-and-persistent-data) do plugin, que sobrevive às atualizações do plugin. Substituído apenas em skills de plugin. Use isso para referenciar dependências instaladas, arquivos gerados ou caches que precisam sobreviver a uma atualização. |

494 494 

495O Claude Code substitui `${CLAUDE_SKILL_DIR}` e `${CLAUDE_PROJECT_DIR}` em dois lugares: no conteúdo markdown da skill e nas regras de Bash no frontmatter [`allowed-tools`](#frontmatter-reference). Em uma skill de plugin, o Claude Code substitui `${CLAUDE_PLUGIN_ROOT}` e `${CLAUDE_PLUGIN_DATA}` nesses mesmos dois lugares. Usar a mesma variável em ambos os lugares permite que uma skill execute um script incluído sem um prompt de permissão. A skill a seguir mostra o padrão:495O Claude Code substitui `${CLAUDE_SKILL_DIR}` e `${CLAUDE_PROJECT_DIR}` em dois lugares: no conteúdo markdown da skill e nas regras de Bash do frontmatter [`allowed-tools`](#frontmatter-reference). Em uma skill de plugin, o Claude Code substitui `${CLAUDE_PLUGIN_ROOT}` e `${CLAUDE_PLUGIN_DATA}` nos mesmos dois lugares. Usar a mesma variável em ambos os lugares permite que uma skill execute um script incluído sem um prompt de permissão. A skill a seguir mostra o padrão:

496 496 

497```yaml theme={null}497```yaml theme={null}

498---498---


504Run `${CLAUDE_SKILL_DIR}/scripts/render.sh <csv-file>` to render the chart.504Run `${CLAUDE_SKILL_DIR}/scripts/render.sh <csv-file>` to render the chart.

505```505```

506 506 

507Se esta skill estiver instalada em `~/.claude/skills/render-chart/`, ambas as ocorrências de `${CLAUDE_SKILL_DIR}` se expandem para esse diretório. A regra de `allowed-tools` então corresponde exatamente ao comando que o corpo da skill instrui o Claude a executar, então o script é executado sem solicitar confirmação.507Se essa skill estiver instalada em `~/.claude/skills/render-chart/`, ambas as ocorrências de `${CLAUDE_SKILL_DIR}` se expandem para esse diretório. A regra de `allowed-tools` então corresponde exatamente ao comando que o corpo da skill instrui o Claude a executar, então o script é executado sem solicitar confirmação.

508 508 

509A substituição de `${CLAUDE_PROJECT_DIR}` requer Claude Code v2.1.196 ou posterior.509A substituição de `${CLAUDE_PROJECT_DIR}` requer o Claude Code v2.1.196 ou posterior.

510 510 

511Os argumentos indexados usam aspas no estilo shell, então coloque valores com várias palavras entre aspas para passá-los como um único argumento. Por exemplo, `/my-skill "hello world" second` faz `$0` se expandir para `hello world` e `$1` para `second`. O placeholder `$ARGUMENTS` sempre se expande para a string completa de argumentos conforme digitada.511Os argumentos indexados usam aspas no estilo do shell, então coloque valores com várias palavras entre aspas para passá-los como um único argumento. Por exemplo, `/my-skill "hello world" second` faz `$0` se expandir para `hello world` e `$1` para `second`. O placeholder `$ARGUMENTS` sempre se expande para a string completa de argumentos como foi digitada.

512 512 

513Um placeholder indexado sem argumento correspondente, como `$2` quando apenas um argumento foi passado, permanece inalterado no conteúdo. Um placeholder nomeado do frontmatter [`arguments`](#frontmatter-reference) sem argumento correspondente se expande para uma string vazia.513Um placeholder indexado sem argumento correspondente, como `$2` quando apenas um argumento foi passado, permanece inalterado no conteúdo. Um placeholder nomeado do frontmatter [`arguments`](#frontmatter-reference) sem argumento correspondente se expande para uma string vazia.

514 514 

515Se você passar um valor de argumento que contém texto como `$1` ou `$ARGUMENTS`, o Claude Code o insere como texto literal e não o expande. Por exemplo, se o corpo de uma skill contém `Summarize $0` e você executa `/summarize "$ARGUMENTS from yesterday"`, o Claude recebe `Summarize $ARGUMENTS from yesterday`. O Claude Code ainda substitui variáveis `${CLAUDE_*}`, como `${CLAUDE_SKILL_DIR}`, depois de inserir os argumentos.515Se você passar um valor de argumento que contenha texto como `$1` ou `$ARGUMENTS`, o Claude Code o insere como texto literal e não o expande. Por exemplo, se o corpo de uma skill contém `Summarize $0` e você executa `/summarize "$ARGUMENTS from yesterday"`, o Claude recebe `Summarize $ARGUMENTS from yesterday`. O Claude Code ainda substitui variáveis `${CLAUDE_*}`, como `${CLAUDE_SKILL_DIR}`, depois de inserir os argumentos.

516 516 

517Para incluir um `$` literal antes de um dígito, de `ARGUMENTS` ou de um nome de argumento declarado, como `$1.00` em texto corrido, escape-o com uma barra invertida: `\$1.00`. Uma barra invertida antes de qualquer outro `$` permanece inalterada. Apenas uma única barra invertida diretamente antes do token o escapa. Uma barra invertida dupla, como `\\$1`, mantém ambas as barras invertidas, e `$1` ainda se expande para o valor do argumento. O escape com barra invertida cobre apenas esses placeholders de argumentos. Uma barra invertida não impede a substituição de uma variável `${CLAUDE_*}` onde a variável se aplica.517Para incluir um `$` literal antes de um dígito, de `ARGUMENTS` ou de um nome de argumento declarado, como `$1.00` em texto corrido, escape-o com uma barra invertida: `\$1.00`. Uma barra invertida antes de qualquer outro `$` permanece inalterada. Apenas uma única barra invertida imediatamente antes do token o escapa. Uma barra invertida duplicada, como `\\$1`, mantém ambas as barras invertidas, e `$1` ainda se expande para o valor do argumento. O escape com barra invertida abrange apenas esses placeholders de argumentos. Uma barra invertida não impede a substituição de uma variável `${CLAUDE_*}` onde a variável se aplica.

518 518 

519**Exemplo usando substituições:**519**Exemplo usando substituições:**

520 520 


530```530```

531 531 

532<h3 id="add-supporting-files">532<h3 id="add-supporting-files">

533 Adicionar arquivos de apoio533 Adicionar arquivos de suporte

534</h3>534</h3>

535 535 

536As skills podem incluir vários arquivos em seu diretório. Isso mantém o `SKILL.md` focado no essencial, enquanto permite que o Claude acesse material de referência detalhado somente quando necessário. Documentos de referência grandes, especificações de API ou coleções de exemplos não precisam ser carregados no contexto toda vez que a skill é executada.536As skills podem incluir vários arquivos em seu diretório. Isso mantém o `SKILL.md` focado no essencial, ao mesmo tempo que permite ao Claude acessar material de referência detalhado apenas quando necessário. Documentos de referência grandes, especificações de API ou coleções de exemplos não precisam ser carregados no contexto toda vez que a skill é executada.

537 537 

538```text theme={null}538```text theme={null}

539my-skill/539my-skill/


544 └── helper.py (utility script - executed, not loaded)544 └── helper.py (utility script - executed, not loaded)

545```545```

546 546 

547Referencie os arquivos de apoio a partir do `SKILL.md` para que o Claude saiba o que cada arquivo contém e quando carregá-lo:547Referencie os arquivos de suporte a partir do `SKILL.md` para que o Claude saiba o que cada arquivo contém e quando carregá-lo:

548 548 

549```markdown theme={null}549```markdown theme={null}

550## Additional resources550## Additional resources


561 561 

562Por padrão, tanto você quanto o Claude podem invocar qualquer skill. Você pode digitar `/skill-name` para invocá-la diretamente, e o Claude pode carregá-la automaticamente quando for relevante para sua conversa. Dois campos do frontmatter permitem restringir isso:562Por padrão, tanto você quanto o Claude podem invocar qualquer skill. Você pode digitar `/skill-name` para invocá-la diretamente, e o Claude pode carregá-la automaticamente quando for relevante para sua conversa. Dois campos do frontmatter permitem restringir isso:

563 563 

564* **`disable-model-invocation: true`**: Somente você pode invocar a skill. Use para fluxos de trabalho com efeitos colaterais ou cujo momento você deseja controlar, como `/commit`, `/deploy` ou `/send-slack-message`. Você não quer que o Claude decida fazer deploy só porque seu código parece pronto.564* **`disable-model-invocation: true`**: o Claude não pode invocar a skill por conta própria. Use isso para fluxos de trabalho com efeitos colaterais ou cujo momento você deseja controlar, como `/commit`, `/deploy` ou `/send-slack-message`. Você não quer que o Claude decida fazer deploy porque seu código parece pronto.

565 565 

566* **`user-invocable: false`**: Somente o Claude pode invocar a skill. Use para conhecimento de fundo que não é acionável como comando. Uma skill `legacy-system-context` explica como um sistema antigo funciona. O Claude deve saber disso quando for relevante, mas `/legacy-system-context` não é uma ação significativa para os usuários executarem.566* **`user-invocable: false`**: apenas o Claude pode invocar a skill. Use isso para conhecimento de fundo que não é acionável como comando. Uma skill `legacy-system-context` explica como um sistema antigo funciona. O Claude deve saber disso quando for relevante, mas `/legacy-system-context` não é uma ação significativa para os usuários executarem.

567 567 

568Este exemplo cria uma skill de deploy que somente você pode acionar. Se você definir `disable-model-invocation: true`, o Claude não poderá executar a skill automaticamente:568Este exemplo cria uma skill de deploy. Se você definir `disable-model-invocation: true`, o Claude não poderá executar a skill automaticamente:

569 569 

570```yaml theme={null}570```yaml theme={null}

571---571---


584 584 

585Se o Claude tentar mesmo assim, o Claude Code bloqueia a chamada e o instrui a não reproduzir as etapas de deploy de outra forma, então espere que o Claude sugira que você mesmo execute `/deploy`.585Se o Claude tentar mesmo assim, o Claude Code bloqueia a chamada e o instrui a não reproduzir as etapas de deploy de outra forma, então espere que o Claude sugira que você mesmo execute `/deploy`.

586 586 

587Veja como os dois campos afetam a invocação e o carregamento de contexto:587Veja como os dois campos afetam a invocação e o carregamento no contexto:

588 588 

589| Frontmatter | Você pode invocar | O Claude pode invocar | Quando é carregado no contexto |589| Frontmatter | Você pode invocar | O Claude pode invocar | Quando é carregado no contexto |

590| :- | :- | :- | :- |590| :- | :- | :- | :- |

591| (padrão) | Sim | Sim | Descrição sempre no contexto, skill completa carregada quando invocada |591| (padrão) | Sim | Sim | Descrição sempre no contexto, skill completa carregada quando invocada |

592| `disable-model-invocation: true` | Sim | Não | Descrição fora do contexto, skill completa carregada quando você a invoca |592| `disable-model-invocation: true` | Sim | Não por conta própria | Descrição não está no contexto, skill completa carregada quando invocada |

593| `user-invocable: false` | Não | Sim | Descrição sempre no contexto, skill completa carregada quando invocada |593| `user-invocable: false` | Não | Sim | Descrição sempre no contexto, skill completa carregada quando invocada |

594 594 

595<Note>595<Note>

596 Em uma sessão normal, as descrições das skills são carregadas no contexto para que o Claude saiba o que está disponível, mas o conteúdo completo da skill só é carregado quando invocado. [Subagentes com skills pré-carregadas](/docs/pt/sub-agents#preload-skills-into-subagents) funcionam de forma diferente: o conteúdo completo da skill é injetado na inicialização.596 Em uma sessão normal, as descrições das skills são carregadas no contexto para que o Claude saiba o que está disponível, mas o conteúdo completo da skill só é carregado quando invocado. [Subagentes com skills pré-carregadas](/docs/pt/sub-agents#preload-skills-into-subagents) funcionam de forma diferente: o conteúdo completo da skill é injetado na inicialização.

597</Note>597</Note>

598 598 

599<h4 id="where-you-write-the-skill’s-name">

600 Onde você escreve o nome da skill

601</h4>

602 

603Para executar uma skill diretamente, coloque seu nome no início da mensagem. Após texto simples, o nome dá ao Claude permissão para executar a skill, mas não a executa:

604 

605| Onde | Exemplo | O que acontece |

606| :- | :- | :- |

607| No início da sua mensagem | `/deploy staging` | O Claude Code executa a skill diretamente |

608| Após texto simples, como uma palavra separada sem pontuação anexada | `go ahead and /deploy to staging` | Nada é executado diretamente. O nome conta como sua permissão para aquela mensagem: o Claude pode executar a skill enquanto responde e avalia pela sua redação se você pediu isso |

609 

610Para escrever sobre a skill sem permitir uma execução, omita a barra.

611 

599<h3 id="skill-content-lifecycle">612<h3 id="skill-content-lifecycle">

600 Ciclo de vida do conteúdo da skill613 Ciclo de vida do conteúdo da skill

601</h3>614</h3>

602 615 

603Quando você ou o Claude invocam uma skill, o conteúdo renderizado do `SKILL.md` entra na conversa como uma única mensagem e permanece lá nos turnos seguintes. Essa persistência se aplica às instruções da skill, não às suas permissões: uma concessão de [`allowed-tools`](#pre-approve-tools-for-a-skill) é removida quando você envia sua próxima mensagem. O Claude Code não relê o arquivo da skill em turnos posteriores, então escreva as orientações que devem se aplicar ao longo de uma tarefa como instruções permanentes, e não como etapas únicas.616Quando você ou o Claude invocam uma skill, o conteúdo renderizado do `SKILL.md` entra na conversa como uma única mensagem e permanece ali nos turnos seguintes. Essa persistência se aplica às instruções da skill, não às suas permissões: uma concessão de [`allowed-tools`](#pre-approve-tools-for-a-skill) é removida quando você envia sua próxima mensagem. O Claude Code não relê o arquivo da skill em turnos posteriores, então escreva as orientações que devem valer durante toda uma tarefa como instruções permanentes, e não como etapas únicas.

604 617 

605Quando o Claude invoca novamente uma skill cujo conteúdo renderizado é idêntico à cópia já presente no contexto, o Claude Code adiciona uma breve nota de que a skill já está carregada, em vez de uma segunda cópia do conteúdo. Quando o conteúdo renderizado difere, porque os argumentos mudaram ou um comando de [contexto dinâmico](#inject-dynamic-context) produziu uma nova saída, o Claude Code anexa o conteúdo completo novamente.618Quando o Claude reinvoca uma skill cujo conteúdo renderizado é idêntico à cópia já presente no contexto, o Claude Code adiciona uma breve nota de que a skill já está carregada, em vez de uma segunda cópia do conteúdo. Quando o conteúdo renderizado é diferente, porque os argumentos mudaram ou um comando de [contexto dinâmico](#inject-dynamic-context) produziu uma nova saída, o Claude Code anexa o conteúdo completo novamente.

606 619 

607A [compactação automática](/docs/pt/how-claude-code-works#when-context-fills-up) mantém as skills invocadas dentro de um orçamento de tokens. Quando a conversa é resumida para liberar contexto, o Claude Code reanexa a invocação mais recente de cada skill após o resumo, mantendo os primeiros 5.000 tokens de cada uma. As skills reanexadas compartilham um orçamento combinado de 25.000 tokens. O Claude Code preenche esse orçamento começando pela skill invocada mais recentemente, então skills mais antigas podem ser descartadas inteiramente após a compactação se você tiver invocado muitas em uma sessão.620A [compactação automática](/docs/pt/how-claude-code-works#when-context-fills-up) mantém as skills invocadas dentro de um orçamento de tokens. Quando a conversa é resumida para liberar contexto, o Claude Code reanexa a invocação mais recente de cada skill após o resumo, mantendo os primeiros 5.000 tokens de cada uma. As skills reanexadas compartilham um orçamento combinado de 25.000 tokens. O Claude Code preenche esse orçamento começando pela skill invocada mais recentemente, então skills mais antigas podem ser descartadas por completo após a compactação se você tiver invocado muitas em uma sessão.

608 621 

609Se o Claude parar de seguir uma skill no meio de uma sessão, consulte [O Claude para de seguir uma skill](#claude-stops-following-a-skill).622Se o Claude parar de seguir uma skill no meio de uma sessão, consulte [O Claude para de seguir uma skill](#claude-stops-following-a-skill).

610 623 


612 Pré-aprovar ferramentas para uma skill625 Pré-aprovar ferramentas para uma skill

613</h3>626</h3>

614 627 

615O campo `allowed-tools` concede permissão para as ferramentas listadas durante o turno que invoca a skill, para que o Claude possa usá-las sem solicitar sua aprovação. A concessão é removida quando você envia sua próxima mensagem, mesmo que o conteúdo da skill [permaneça no contexto](#skill-content-lifecycle); invocar a skill novamente a reaplica para aquele turno. Ele não restringe quais ferramentas estão disponíveis: todas as ferramentas continuam podendo ser chamadas, e suas [configurações de permissão](/docs/pt/permissions) ainda regem as ferramentas não listadas. Para pré-aprovar ferramentas para a sessão inteira em vez de um único turno, adicione regras allow a essas configurações de permissão.628O campo `allowed-tools` concede permissão para as ferramentas listadas durante o turno que invoca a skill, para que o Claude possa usá-las sem solicitar sua aprovação. A concessão é removida quando você envia sua próxima mensagem, mesmo que o conteúdo da skill [permaneça no contexto](#skill-content-lifecycle); invocar a skill novamente a reaplica para aquele turno. Ele não restringe quais ferramentas estão disponíveis: todas as ferramentas continuam podendo ser chamadas, e suas [configurações de permissão](/docs/pt/permissions) ainda regem as ferramentas que não estão listadas. Para pré-aprovar ferramentas para a sessão inteira em vez de um único turno, adicione regras de allow a essas configurações de permissão.

616 629 

617A confiança no workspace não restringe esse campo. O Claude Code aplica o `allowed-tools` de uma skill de projeto mesmo em uma execução `-p` em uma pasta na qual você nunca confiou. Uma skill pode conceder a si mesma amplo acesso a ferramentas, então revise o `allowed-tools` das skills incluídas em um repositório antes de executar o Claude Code nele. Para ignorar o campo nas skills de repositórios em toda a sua organização, consulte [Quando apenas regras de permissão gerenciadas se aplicam](#when-only-managed-permission-rules-apply).630A confiança no workspace não restringe este campo. O Claude Code aplica o `allowed-tools` de uma skill de projeto mesmo em uma execução com `-p` em uma pasta na qual você nunca confiou. Uma skill pode conceder a si mesma amplo acesso a ferramentas, então revise o `allowed-tools` das skills incluídas em um repositório antes de executar o Claude Code nele. Para desconsiderar o campo em skills de repositório em toda a sua organização, consulte [Quando apenas regras de permissão gerenciadas se aplicam](#when-only-managed-permission-rules-apply).

618 631 

619Esta skill permite que o Claude execute comandos git sem aprovação a cada uso sempre que você a invoca:632Esta skill permite que o Claude execute comandos git sem aprovação a cada uso sempre que você a invocar:

620 633 

621```yaml theme={null}634```yaml theme={null}

622---635---


627---640---

628```641```

629 642 

630Para remover ferramentas do conjunto disponível do Claude enquanto uma skill está ativa, liste-as em `disallowed-tools` no frontmatter da skill. A restrição é removida quando você envia sua próxima mensagem. Assim como as regras deny, o campo não pode remover [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) enquanto qualquer outra ferramenta permanecer. Para bloquear ferramentas em todas as skills e prompts, adicione regras deny nas suas [configurações de permissão](/docs/pt/permissions).643Para remover ferramentas do conjunto disponível do Claude enquanto uma skill está ativa, liste-as em `disallowed-tools` no frontmatter da skill. A restrição é removida quando você envia sua próxima mensagem. Assim como as regras de deny, o campo não pode remover [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) enquanto qualquer outra ferramenta permanecer. Para bloquear ferramentas em todas as skills e prompts, adicione regras de deny nas suas [configurações de permissão](/docs/pt/permissions).

631 644 

632<h4 id="when-only-managed-permission-rules-apply">645<h4 id="when-only-managed-permission-rules-apply">

633 Quando apenas regras de permissão gerenciadas se aplicam646 Quando apenas regras de permissão gerenciadas se aplicam

634</h4>647</h4>

635 648 

636Quando sua organização define `allowManagedPermissionRulesOnly` nas configurações gerenciadas, o Claude Code ignora `allowed-tools` em skills de projeto e pessoais e nas [outras fontes listadas na entrada da configuração](/docs/pt/settings-reference#allowmanagedpermissionrulesonly). Isso requer Claude Code v2.1.282 ou posterior.649Quando sua organização define `allowManagedPermissionRulesOnly` nas configurações gerenciadas, o Claude Code ignora `allowed-tools` em skills de projeto e pessoais e nas [outras origens listadas na entrada da configuração](/docs/pt/settings-reference#allowmanagedpermissionrulesonly). Isso requer o Claude Code v2.1.282 ou posterior.

637 650 

638As ferramentas que uma skill afetada lista passam, em vez disso, pelas regras gerenciadas da sua organização e pelo prompt de permissão normal. Execute `/status` para listar cada skill cujo `allowed-tools` o Claude Code ignorou até o momento na sessão. Um comando injetado na skill que nenhuma regra gerenciada permite segue [Verificações de permissão em comandos injetados](#permission-checks-on-injected-commands).651As ferramentas que uma skill afetada lista passam, em vez disso, pelas regras gerenciadas da sua organização e pelo prompt de permissão normal. Execute `/status` para listar cada skill cujo `allowed-tools` o Claude Code ignorou até o momento na sessão. Um comando injetado na skill que nenhuma regra gerenciada permite segue as [Verificações de permissão em comandos injetados](#permission-checks-on-injected-commands).

639 652 

640<h3 id="pass-arguments-to-skills">653<h3 id="pass-arguments-to-skills">

641 Passar argumentos para skills654 Passar argumentos para skills


643 656 

644Tanto você quanto o Claude podem passar argumentos ao invocar uma skill. Os argumentos ficam disponíveis por meio do placeholder `$ARGUMENTS`.657Tanto você quanto o Claude podem passar argumentos ao invocar uma skill. Os argumentos ficam disponíveis por meio do placeholder `$ARGUMENTS`.

645 658 

646Esta skill corrige uma issue do GitHub pelo número. O placeholder `$ARGUMENTS` é substituído pelo que vier depois do nome da skill:659Esta skill corrige uma issue do GitHub pelo número. O placeholder `$ARGUMENTS` é substituído pelo que vier após o nome da skill:

647 660 

648```yaml theme={null}661```yaml theme={null}

649---662---


663 676 

664Quando você executa `/fix-issue 123`, o Claude recebe "Fix GitHub issue 123 following our coding standards..."677Quando você executa `/fix-issue 123`, o Claude recebe "Fix GitHub issue 123 following our coding standards..."

665 678 

666Se você invocar uma skill com argumentos, mas nenhum placeholder no conteúdo da skill receber um, o Claude Code anexa `ARGUMENTS: <your input>` ao final do conteúdo da skill para que o Claude ainda veja o que você digitou. Um placeholder é `$ARGUMENTS`, uma forma indexada como `$1` ou um argumento nomeado. Um placeholder indexado sem argumento em sua posição permanece como texto literal e não conta como tendo recebido um. Um placeholder nomeado conta mesmo quando sua posição não tem argumento, porque ele se expande para uma string vazia.679Se você invocar uma skill com argumentos, mas nenhum placeholder no conteúdo da skill receber um, o Claude Code anexa `ARGUMENTS: <your input>` ao final do conteúdo da skill para que o Claude ainda veja o que você digitou. Um placeholder é `$ARGUMENTS`, uma forma indexada como `$1` ou um argumento nomeado. Um placeholder indexado sem argumento na sua posição permanece como texto literal e não conta como tendo recebido um. Um placeholder nomeado conta mesmo quando sua posição não tem argumento, porque ele se expande para uma string vazia.

667 680 

668Você também pode empilhar várias skills no início de uma mensagem. Digitar `/write-tests /fix-issue 123` carrega ambas as skills e passa o texto final `123` como `$ARGUMENTS` para cada uma delas.681Você também pode empilhar várias skills no início de uma mensagem. Digitar `/write-tests /fix-issue 123` carrega ambas as skills e passa o texto final `123` como `$ARGUMENTS` para cada uma delas.

669 682 

670O Claude Code expande a primeira skill mais até cinco outras empilhadas depois dela. A expansão para no primeiro token que não seja uma skill inline invocável pelo usuário, então uma skill que é executada como um [subagente bifurcado](#run-skills-in-a-subagent), como [`/code-review`](/docs/pt/code-review#review-a-diff-locally), ou uma cujos argumentos podem começar com um comando de barra, como `/loop`, também encerra a sequência ali. Esse token e tudo o que vem depois dele se tornam o texto de argumentos para cada skill expandida. `/code-review` é executada como um subagente bifurcado a partir da v2.1.218; em versões anteriores, ela era executada inline e empilhada.683O Claude Code expande a primeira skill mais até cinco outras empilhadas depois dela. A expansão para no primeiro token que não seja uma skill inline invocável pelo usuário, então uma skill que é executada como um [subagente bifurcado](#run-skills-in-a-subagent), como [`/code-review`](/docs/pt/code-review#review-a-diff-locally), ou uma cujos argumentos podem começar com um comando de barra, como `/loop`, também encerra a sequência ali. Esse token e tudo o que vem depois dele se tornam o texto de argumentos para todas as skills expandidas. `/code-review` é executado como um subagente bifurcado a partir da v2.1.218; em versões anteriores, ele era executado inline e empilhado.

671 684 

672Para acessar argumentos individuais por posição, use `$ARGUMENTS[N]` ou a forma mais curta `$N`:685Para acessar argumentos individuais pela posição, use `$ARGUMENTS[N]` ou a forma mais curta `$N`:

673 686 

674```yaml theme={null}687```yaml theme={null}

675---688---

sub-agents.md +1 −1

Details

632 632 

633O conteúdo completo de cada skill listada é injetado no contexto do subagente na inicialização. Este campo controla quais skills são pré-carregadas, não quais skills o subagente pode acessar: sem ele, o subagente ainda pode descobrir e invocar skills de projeto, usuário e plugin através da ferramenta Skill durante a execução. Para impedir que um subagente invoque skills inteiramente, omita `Skill` da lista [`tools`](#available-tools) ou adicione-o a `disallowedTools`.633O conteúdo completo de cada skill listada é injetado no contexto do subagente na inicialização. Este campo controla quais skills são pré-carregadas, não quais skills o subagente pode acessar: sem ele, o subagente ainda pode descobrir e invocar skills de projeto, usuário e plugin através da ferramenta Skill durante a execução. Para impedir que um subagente invoque skills inteiramente, omita `Skill` da lista [`tools`](#available-tools) ou adicione-o a `disallowedTools`.

634 634 

635Você não pode pré-carregar skills que definem [`disable-model-invocation: true`](/docs/pt/skills#control-who-invokes-a-skill), já que pré-carregar extrai do mesmo conjunto de skills que Claude pode invocar. Isso inclui a skill `/verify` integrada: apenas você pode executá-la, portanto ela não pode ser pré-carregada também.635Você não pode pré-carregar skills que definem [`disable-model-invocation: true`](/docs/pt/skills#control-who-invokes-a-skill), já que o pré-carregamento extrai do mesmo conjunto de skills que Claude pode invocar. Isso inclui a skill `/verify` integrada, que Claude não pode executar por conta própria.

636 636 

637Se uma skill listada estiver faltando ou desabilitada, por exemplo pela política de sua organização, Claude Code a ignora e registra um aviso no log de debug.637Se uma skill listada estiver faltando ou desabilitada, por exemplo pela política de sua organização, Claude Code a ignora e registra um aviso no log de debug.

638 638 

Details

62Conectar GitHub é um processo único. Se você já usa a CLI do GitHub, você pode [fazer isso do seu terminal](#connect-from-your-terminal) em vez do navegador.62Conectar GitHub é um processo único. Se você já usa a CLI do GitHub, você pode [fazer isso do seu terminal](#connect-from-your-terminal) em vez do navegador.

63 63 

64<Note>64<Note>

65 Em planos Team e Enterprise, a etapa **Sign in with GitHub** funciona apenas após um [Owner](/docs/pt/server-managed-settings#access-control) da sua organização Claude ativar o conector GitHub em [**Admin settings > Connectors**](https://claude.ai/admin-settings/connectors). Até então, essa etapa mostra "GitHub access is required for Claude Code on the web" em vez de um botão de login. Após o conector estar ativado, recarregue [claude.ai/code](https://claude.ai/code) e comece novamente a partir da primeira etapa. Um segundo toggle, [Quick web setup](/docs/pt/claude-code-on-the-web#github-authentication-options) em [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code), é opcional: com ele ativado, `/web-setup` funciona e a integração cria o ambiente para os membros.65 Em planos Team e Enterprise, a etapa **Sign in with GitHub** funciona apenas após um [Owner](/docs/pt/server-managed-settings#access-control) da sua organização Claude ativar o conector GitHub em [**Admin settings > Connectors**](https://claude.ai/admin-settings/connectors). Até então, essa etapa mostra "GitHub access is required for Claude Code on the web" em vez de um botão de login. Após o conector estar ativado, recarregue [claude.ai/code](https://claude.ai/code) e comece novamente a partir da primeira etapa. Um segundo toggle, [Quick web setup](/docs/pt/claude-code-on-the-web#quick-web-setup-for-team-and-enterprise) em [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code), é opcional: com ele ativado, `/web-setup` funciona e a integração cria o ambiente para os membros.

66</Note>66</Note>

67 67 

68<Steps>68<Steps>


84 Um [ambiente em nuvem](/docs/pt/cloud-environments) é a configuração salva que controla qual acesso à rede Claude tem durante as sessões e o que é executado quando uma sessão é iniciada. O que acontece após você conectar o GitHub depende do seu plano:84 Um [ambiente em nuvem](/docs/pt/cloud-environments) é a configuração salva que controla qual acesso à rede Claude tem durante as sessões e o que é executado quando uma sessão é iniciada. O que acontece após você conectar o GitHub depende do seu plano:

85 85 

86 * **Pro e Max**: a integração cria um ambiente chamado **Default** para você.86 * **Pro e Max**: a integração cria um ambiente chamado **Default** para você.

87 * **Team e Enterprise**: a integração mostra um formulário **Create your first cloud environment**. Deixe o nome pré-preenchido e o acesso à rede inalterados e clique em **Create & finish** para criar o ambiente **Default**. Se um Owner ativou [Quick web setup](/docs/pt/claude-code-on-the-web#github-authentication-options), a integração cria **Default** para você em vez disso.87 * **Team e Enterprise**: a integração mostra um formulário **Create your first cloud environment**. Deixe o nome pré-preenchido e o acesso à rede inalterados e clique em **Create & finish** para criar o ambiente **Default**. Se um Owner ativou [Quick web setup](/docs/pt/claude-code-on-the-web#quick-web-setup-for-team-and-enterprise), a integração cria **Default** para você em vez disso.

88 88 

89 **Default** usa [acesso à rede `Trusted`](/docs/pt/cloud-environments#access-levels): as sessões alcançam [registros de pacotes comuns](/docs/pt/cloud-environments#default-allowed-domains) e outros domínios na lista de permissões, e nada mais através da rede da sessão. Veja [Ferramentas instaladas](/docs/pt/cloud-environments#installed-tools) para o que está disponível sem nenhuma configuração.89 **Default** usa [acesso à rede `Trusted`](/docs/pt/cloud-environments#access-levels): as sessões alcançam [registros de pacotes comuns](/docs/pt/cloud-environments#default-allowed-domains) e outros domínios na lista de permissões, e nada mais através da rede da sessão. Veja [Ferramentas instaladas](/docs/pt/cloud-environments#installed-tools) para o que está disponível sem nenhuma configuração.

90 90 


96 Conecte do seu terminal96 Conecte do seu terminal

97</h3>97</h3>

98 98 

99Se você já usa a CLI do GitHub (`gh`), você pode conectar GitHub para sessões em nuvem do seu terminal. Isso requer a [CLI do Claude Code](/docs/pt/quickstart). Em planos Team e Enterprise, `/web-setup` está disponível apenas após um Owner ativar [Quick web setup](/docs/pt/claude-code-on-the-web#github-authentication-options).99Se você já usa a CLI do GitHub (`gh`), você pode conectar GitHub para sessões na nuvem do seu terminal. Isso requer a [CLI do Claude Code](/docs/pt/quickstart). Em planos Team e Enterprise, `/web-setup` está disponível apenas após um Owner ativar [Quick web setup](/docs/pt/claude-code-on-the-web#quick-web-setup-for-team-and-enterprise).

100 100 

101Quando você executa `/web-setup`, Claude Code lê o token que `gh auth token` imprime, pede que você confirme e envia o token para Anthropic. Anthropic o armazena criptografado com sua conta claude.ai, e suas sessões em nuvem o usam para acesso ao GitHub até você [removê-lo](#remove-the-web-setup-token). Uma sessão em nuvem que você inicia por conta própria pode então acessar qualquer repositório que esse token possa acessar, sem nenhuma instalação do Claude GitHub App. Threads em um [projeto](/docs/pt/claude-projects#set-up-github-access) ainda precisam do Claude GitHub App.101Quando você executa `/web-setup`, Claude Code lê o token que `gh auth token` imprime, pede que você confirme e envia o token para Anthropic. Anthropic o armazena criptografado com sua conta claude.ai, e suas sessões em nuvem o usam para acesso ao GitHub até você [removê-lo](#remove-the-web-setup-token). Uma sessão em nuvem que você inicia por conta própria pode então acessar qualquer repositório que esse token possa acessar, sem nenhuma instalação do Claude GitHub App. Threads em um [projeto](/docs/pt/claude-projects#set-up-github-access) ainda precisam do Claude GitHub App.

102 102 


259 259 

260Se você digitou dentro do Claude Code e o menu de comandos mostra `No commands match "/web-setup"`, ou enviá-lo retorna `Unknown command: /web-setup`, o comando está oculto porque um requisito não é atendido. A causa geralmente é que você está autenticado com uma chave de API ou provedor de terceiros em vez de uma assinatura claude.ai. Execute `/login` para conectar-se com sua conta claude.ai.260Se você digitou dentro do Claude Code e o menu de comandos mostra `No commands match "/web-setup"`, ou enviá-lo retorna `Unknown command: /web-setup`, o comando está oculto porque um requisito não é atendido. A causa geralmente é que você está autenticado com uma chave de API ou provedor de terceiros em vez de uma assinatura claude.ai. Execute `/login` para conectar-se com sua conta claude.ai.

261 261 

262Nos planos Team e Enterprise, o comando está oculto por padrão: a [alternância Quick web setup](/docs/pt/claude-code-on-the-web#github-authentication-options) está desativada até que um Proprietário a ative. Enquanto estiver desativada, [conecte GitHub do navegador](#connect-github) em vez disso.262Nos planos Team e Enterprise, o comando está oculto por padrão: a [alternância Quick web setup](/docs/pt/claude-code-on-the-web#quick-web-setup-for-team-and-enterprise) está desativada até que um Proprietário a ative. Enquanto estiver desativada, [conecte GitHub do navegador](#connect-github) em vez disso.

263 263 

264O comando também está oculto em dois outros casos:264O comando também está oculto em dois outros casos:

265 265