SpyBara
Go Premium

Documentation 2026-10-03 23:57 UTC to 2026-10-04 21:01 UTC

53 files changed +1,014 −601. View all changes and history on the product overview
2026
Sun 4 21:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59

admin-setup.md +2 −2

Details

137 Contas do GitHub conectadas137 Contas do GitHub conectadas

138</h3>138</h3>

139 139 

140Nos planos Team e Enterprise, [**Admin settings > GitHub**](https://claude.ai/admin-settings/github) lista as organizações do GitHub e as contas pessoais vinculadas à sua organização Claude por meio do [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) e Claude Security compartilham essa lista. Para abri-la, é necessária uma função de administrador na sua organização Claude.140Nos planos Team e Enterprise, [**Organization settings > GitHub**](https://claude.ai/admin-settings/github) lista as organizações do GitHub e as contas pessoais vinculadas à sua organização Claude por meio do [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) e Claude Security compartilham essa lista. Para abri-la, é necessária uma função de administrador na sua organização Claude.

141 141 

142Um administrador ou um membro pode vincular uma conta:142Um administrador ou um membro pode vincular uma conta:

143 143 


161| Usage monitoring | Exportação OpenTelemetry de sessões, ferramentas e tokens | Todos os provedores | [Monitoring usage](/docs/pt/monitoring-usage) |161| Usage monitoring | Exportação OpenTelemetry de sessões, ferramentas e tokens | Todos os provedores | [Monitoring usage](/docs/pt/monitoring-usage) |

162| Analytics dashboard | Métricas de adoção e contribuição com um placar em Teams / Enterprise; métricas de uso e gastos por usuário em Console | Teams / Enterprise em [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console em [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/docs/pt/analytics) |162| Analytics dashboard | Métricas de adoção e contribuição com um placar em Teams / Enterprise; métricas de uso e gastos por usuário em Console | Teams / Enterprise em [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console em [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/docs/pt/analytics) |

163| Programmatic reporting | Dados de uso e custo por usuário em uma API | [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) para Enterprise, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) para Console | [Costs](/docs/pt/costs#manage-costs-for-your-organization) |163| Programmatic reporting | Dados de uso e custo por usuário em uma API | [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) para Enterprise, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) para Console | [Costs](/docs/pt/costs#manage-costs-for-your-organization) |

164| Spend controls | Limites de gastos e limites de taxa | Configurações de administrador para Teams / Enterprise, limites de espaço de trabalho para Console; em nuvens de terceiros, controles de orçamento da nuvem ou um [Claude apps gateway](/docs/pt/claude-apps-gateway) com [limites de gastos](/docs/pt/claude-apps-gateway-spend-limits) por usuário | [Costs](/docs/pt/costs#manage-costs-for-your-organization) |164| Spend controls | Limites de gastos e rate limits | Configurações da organização para Teams / Enterprise, limites de workspace para Console; em nuvens de terceiros, controles de orçamento da nuvem ou um [Claude apps gateway](/docs/pt/claude-apps-gateway) com [limites de gastos](/docs/pt/claude-apps-gateway-spend-limits) por usuário | [Costs](/docs/pt/costs#manage-costs-for-your-organization) |

165 165 

166Em Teams e Enterprise, os números de uso e gastos por usuário vêm do [relatório de gastos](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) nas configurações de análise da sua organização, não do painel de análise. Os provedores de nuvem expõem gastos através do AWS Cost Explorer, GCP Billing ou Azure Cost Management. Para planejar orçamentos empresariais em Claude chat, Claude Code e Cowork, consulte o [guia de consumo Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide).166Em Teams e Enterprise, os números de uso e gastos por usuário vêm do [relatório de gastos](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) nas configurações de análise da sua organização, não do painel de análise. Os provedores de nuvem expõem gastos através do AWS Cost Explorer, GCP Billing ou Azure Cost Management. Para planejar orçamentos empresariais em Claude chat, Claude Code e Cowork, consulte o [guia de consumo Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide).

167 167 

agent-sdk/mcp.md +14 −0

Details

919 ```919 ```

920</CodeGroup>920</CodeGroup>

921 921 

922<h3 id="a-tool-is-missing-from-an-sdk-mcp-server">

923 Uma ferramenta está ausente de um servidor MCP do SDK

924</h3>

925 

926No SDK TypeScript, quando o esquema de entrada de uma ferramenta não pode ser convertido em JSON Schema, o servidor que você criou com [`createSdkMcpServer()`](/docs/pt/agent-sdk/typescript#createsdkmcpserver) deixa essa ferramenta de fora ao listar suas ferramentas. O SDK emite um aviso nesse momento. No Node.js, o aviso é um aviso de processo com o código `CLAUDE_SDK_MCP_TOOL_SCHEMA_UNCONVERTIBLE`, e começa com este texto:

927 

928```text theme={null}

929Tool "<name>" on SDK MCP server "<server>" was left out of the server's tool list, because its input schema cannot be converted to JSON Schema

930```

931 

932O restante do aviso fornece a mensagem do erro de conversão, quando houver uma, e depois indica o que verificar e alterar.

933 

934Antes do TypeScript Agent SDK v0.3.286, um único esquema não conversível fazia toda a listagem de ferramentas do servidor falhar sem esse aviso, de modo que nenhuma das ferramentas desse servidor chegava a Claude.

935 

922<h3 id="connection-timeouts">936<h3 id="connection-timeouts">

923 Connection timeouts937 Connection timeouts

924</h3>938</h3>

Details

13| Sintoma | Ir para |13| Sintoma | Ir para |

14| :- | :- |14| :- | :- |

15| Skills não encontradas, uma skill não sendo usada, erro `Invalid skill name` | [Solução de problemas de Skills](/docs/pt/agent-sdk/skills#troubleshooting) |15| Skills não encontradas, uma skill não sendo usada, erro `Invalid skill name` | [Solução de problemas de Skills](/docs/pt/agent-sdk/skills#troubleshooting) |

16| Servidor MCP mostra status `failed`, ferramentas não sendo chamadas, timeouts de conexão, saída de ferramenta que excede o máximo de tokens permitidos | [Solução de problemas de MCP](/docs/pt/agent-sdk/mcp#troubleshooting) |16| Servidor MCP mostra status `failed`, ferramentas não sendo chamadas, uma ferramenta ausente de um servidor MCP do SDK, timeouts de conexão, saída de ferramenta que excede o máximo de tokens permitidos | [Solução de problemas de MCP](/docs/pt/agent-sdk/mcp#troubleshooting) |

17| Plugin não carregando, skills de plugin não aparecendo | [Solução de problemas de Plugins](/docs/pt/agent-sdk/plugins#troubleshooting) |17| Plugin não carregando, skills de plugin não aparecendo | [Solução de problemas de Plugins](/docs/pt/agent-sdk/plugins#troubleshooting) |

18| Claude não delegando para subagentes, agentes baseados em sistema de arquivos não carregando | [Solução de problemas de Subagents](/docs/pt/agent-sdk/subagents#troubleshooting) |18| Claude não delegando para subagentes, agentes baseados em sistema de arquivos não carregando | [Solução de problemas de Subagents](/docs/pt/agent-sdk/subagents#troubleshooting) |

19| Opções de checkpointing não reconhecidas, mensagens de usuário sem UUIDs, `No file checkpoint found`, `File rewinding is not enabled`, `ProcessTransport is not ready for writing` | [Solução de problemas de checkpointing de arquivo](/docs/pt/agent-sdk/file-checkpointing#troubleshooting) |19| Opções de checkpointing não reconhecidas, mensagens de usuário sem UUIDs, `No file checkpoint found`, `File rewinding is not enabled`, `ProcessTransport is not ready for writing` | [Solução de problemas de checkpointing de arquivo](/docs/pt/agent-sdk/file-checkpointing#troubleshooting) |

Details

863 fast_mode_state?: "off" | "cooldown" | "on";863 fast_mode_state?: "off" | "cooldown" | "on";

864 fast_mode_disabled_reason?: FastModeDisabledReason;864 fast_mode_disabled_reason?: FastModeDisabledReason;

865 hooks_applied?: boolean;865 hooks_applied?: boolean;

866 sdk_mcp_manifests_parked?: Record<

867 string,

868 | "parked"

869 | "already_connected"

870 | "protocol_version_mismatch"

871 | "malformed"

872 | "not_honoured"

873 >;

866};874};

867```875```

868 876 


875 883 

876Antes do Agent SDK v0.3.238, a resposta nunca carregava o campo, e Claude Code ignorava `hooks` em cada inicialização repetida.884Antes do Agent SDK v0.3.238, a resposta nunca carregava o campo, e Claude Code ignorava `hooks` em cada inicialização repetida.

877 885 

886O campo `sdkMcpServerManifests` da requisição e o campo `sdk_mcp_manifests_parked` da resposta são destinados aos [servidores MCP do SDK](/docs/pt/agent-sdk/custom-tools) em processo que você criou com [`createSdkMcpServer()`](#createsdkmcpserver). Sua aplicação não define nem lê nenhum desses campos.

887 

878A resposta sempre relata `fast_mode_state`, e quando algo bloqueia [fast mode](/docs/pt/fast-mode), `fast_mode_disabled_reason` carrega o código de razão junto com ele, para que você possa explicar o estado bloqueado em vez de re-derivar a disponibilidade. Ambos os comportamentos requerem Claude Code v2.1.219 ou posterior. Antes de v2.1.219, a resposta omitia `fast_mode_state` quando fast mode não estava disponível e nunca carregava uma razão. Para os códigos de razão e seus significados, veja [`fast_mode_disabled_reason`](#sdkresultmessage) na mensagem de resultado.888A resposta sempre relata `fast_mode_state`, e quando algo bloqueia [fast mode](/docs/pt/fast-mode), `fast_mode_disabled_reason` carrega o código de razão junto com ele, para que você possa explicar o estado bloqueado em vez de re-derivar a disponibilidade. Ambos os comportamentos requerem Claude Code v2.1.219 ou posterior. Antes de v2.1.219, a resposta omitia `fast_mode_state` quando fast mode não estava disponível e nunca carregava uma razão. Para os códigos de razão e seus significados, veja [`fast_mode_disabled_reason`](#sdkresultmessage) na mensagem de resultado.

879 889 

880O wrapper de resposta de controle para um `initialize` bem-sucedido também carrega um array `pending_permission_requests`. O campo está no wrapper de resposta em si, não na carga `SDKControlInitializeResponse` acima. Cada entrada é uma mensagem `control_request` completa com a mesma forma `{ type: "control_request", request_id, request }` que a sessão transmite para solicitações de permissão durante a execução.890O wrapper de resposta de controle para um `initialize` bem-sucedido também carrega um array `pending_permission_requests`. O campo está no wrapper de resposta em si, não na carga `SDKControlInitializeResponse` acima. Cada entrada é uma mensagem `control_request` completa com a mesma forma `{ type: "control_request", request_id, request }` que a sessão transmite para solicitações de permissão durante a execução.


1955| - | - |1965| - | - |

1956| `interrupt_receipt_v1` | [`interrupt()`](#query-object) resolve com um recibo [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) listando as mensagens que estavam pendentes quando a interrupção chegou |1966| `interrupt_receipt_v1` | [`interrupt()`](#query-object) resolve com um recibo [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) listando as mensagens que estavam pendentes quando a interrupção chegou |

1957| `interrupt_cancel_queued_v1` | A requisição de controle `interrupt` respeita `cancel_queued: true`, cancelando as mensagens que o recibo listaria sob `still_queued` e listando-as sob `cancelled` em vez disso. Consulte [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Requer Claude Code v2.1.219 ou posterior |1967| `interrupt_cancel_queued_v1` | A requisição de controle `interrupt` respeita `cancel_queued: true`, cancelando as mensagens que o recibo listaria sob `still_queued` e listando-as sob `cancelled` em vez disso. Consulte [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Requer Claude Code v2.1.219 ou posterior |

1968| `sdk_mcp_manifests` | A requisição de controle `initialize` aceita `sdkMcpServerManifests`, resultados de handshake MCP capturados dos seus [servidores MCP do SDK](/docs/pt/agent-sdk/custom-tools) em processo. O Claude Code anuncia essa capacidade no v2.1.286 ou posterior |

1969| `sdk_mcp_tools_list_changed` | Uma notificação `tools/list_changed` de um [servidor MCP do SDK](/docs/pt/agent-sdk/custom-tools) faz o Claude Code listar novamente as ferramentas desse servidor, para que uma ferramenta que o servidor adiciona no meio da sessão chegue ao Claude. O Claude Code anuncia essa capacidade no v2.1.286 ou posterior |

1958 1970 

1959O array `plugin_errors` lista falhas de carregamento de plugin. Uma entrada descreve um plugin que não carregou e está ausente de `plugins`, ou um plugin que carregou sem uma de suas partes, como seu arquivo de hooks. A chave é omitida quando nada falhou. `SDKSystemMessage` declara `plugin_errors` em Agent SDK v0.3.283 ou posterior.1971O array `plugin_errors` lista falhas de carregamento de plugin. Uma entrada descreve um plugin que não carregou e está ausente de `plugins`, ou um plugin que carregou sem uma de suas partes, como seu arquivo de hooks. A chave é omitida quando nada falhou. `SDKSystemMessage` declara `plugin_errors` em Agent SDK v0.3.283 ou posterior.

1960 1972 

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

Details

386 386 

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

388 388 

389<h3 id="when-your-organization-enforces-a-model-allowlist">

390 Quando sua organização impõe uma allowlist de modelos

391</h3>

392 

393Se você definir [`enforceAvailableModels`](/docs/pt/model-config#enforce-the-allowlist-for-the-default-model) nas configurações gerenciadas, as verificações de modelo na inicialização usam apenas modelos que sua lista `availableModels` permite. Isso se aplica à API Invoke do Amazon Bedrock e requer Claude Code v2.1.287 ou posterior. Uma lista sem `enforceAvailableModels` não restringe essas verificações.

394 

395As verificações comparam cada entrada com o ID do perfil de inferência que enviariam, incluindo seu [prefixo de região](#cross-region-inference-profile-prefixes), portanto escreva a lista usando esses IDs. Este exemplo permite Opus 4.8 e Sonnet 4.5 para uma implantação cujos modelos resolvem para perfis `us.`:

396 

397```json theme={null}

398{

399 "availableModels": ["us.anthropic.claude-opus-4-8", "us.anthropic.claude-sonnet-4-5-20250929-v1:0"],

400 "enforceAvailableModels": true

401}

402```

403 

404Para aliases, prefixos de versão e entradas `modelOverrides`, consulte [Fixar modelos para implantações de terceiros](/docs/pt/model-config#pin-models-for-third-party-deployments).

405 

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

390 Quando um modelo é desabilitado durante a sessão407 Quando um modelo é desabilitado durante a sessão

391</h3>408</h3>

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

538</h3>538</h3>

539 539 

540<Tip>540<Tip>

541 Faça loop através de tarefas chamando `claude -p` para cada uma. Use `--allowedTools` para escopear permissões para operações em lote.541 Faça loop através de tarefas chamando `claude -p` para cada uma. Use `--allowedTools` para pré-aprovar ferramentas para operações em lote.

542</Tip>542</Tip>

543 543 

544Para grandes migrações ou análises, você pode distribuir trabalho entre muitas invocações Claude paralelas. Execute [`/batch <instruction>`](/docs/pt/commands#all-commands) para ter Claude dividir a mudança entre 5 a 30 subagentes. Cada subagente trabalha em seu próprio worktree. Para conduzir o fan-out a partir de seu próprio script em vez disso, faça loop sobre `claude -p`:544Para grandes migrações ou análises, você pode distribuir trabalho entre muitas invocações Claude paralelas. Execute [`/batch <instruction>`](/docs/pt/commands#all-commands) para ter Claude dividir a mudança entre 5 a 30 subagentes. Cada subagente trabalha em seu próprio worktree. Para conduzir o fan-out a partir de seu próprio script em vez disso, faça loop sobre `claude -p`:


552 ```bash theme={null}552 ```bash theme={null}

553 for file in $(cat files.txt); do553 for file in $(cat files.txt); do

554 claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \554 claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \

555 --allowedTools "Edit,Bash(git commit *)"555 --allowedTools "Edit,Bash(git commit *)" \

556 --permission-mode dontAsk

556 done557 done

557 ```558 ```

558 </Step>559 </Step>

559 560 

560 <Step title="Test on a few files, then run on all of them">561 <Step title="Teste em alguns arquivos, depois execute em todos eles">

561 Refine seu prompt baseado no que dá errado com os primeiros 2-3 arquivos, depois execute no conjunto completo. A flag `--allowedTools` restringe o que Claude pode fazer, o que importa quando você está executando sem supervisão.562 Refine seu prompt baseado no que dá errado com os primeiros 2-3 arquivos, depois execute no conjunto completo. A flag `--allowedTools` pré-aprova as ferramentas de que a migração precisa, e [`--permission-mode dontAsk`](/docs/pt/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) nega qualquer outra coisa que precisaria de aprovação, o que importa quando você está executando sem supervisão.

562 </Step>563 </Step>

563</Steps>564</Steps>

564 565 

channels.md +1 −1

Details

326 Habilitar canais para sua organização326 Habilitar canais para sua organização

327</h3>327</h3>

328 328 

329Os administradores podem habilitar canais em [**claude.ai → Admin settings → Claude Code → Channels**](https://claude.ai/admin-settings/claude-code), o que requer a função de administrador, ou definindo `channelsEnabled` como `true` nas configurações gerenciadas.329Habilite canais para sua organização em [**Organization settings > Claude Code > Channels**](https://claude.ai/admin-settings/claude-code), o que requer a função Owner, ou definindo `channelsEnabled` como `true` nas configurações gerenciadas.

330 330 

331Uma vez habilitado, os usuários em sua organização podem usar `--channels` para optar por servidores de canal em sessões individuais. Se a configuração estiver desabilitada ou não definida, o servidor MCP ainda se conecta e suas ferramentas funcionam, mas as mensagens de canal não chegarão. Um aviso de inicialização informa ao usuário para ter um administrador habilitar a configuração.331Uma vez habilitado, os usuários em sua organização podem usar `--channels` para optar por servidores de canal em sessões individuais. Se a configuração estiver desabilitada ou não definida, o servidor MCP ainda se conecta e suas ferramentas funcionam, mas as mensagens de canal não chegarão. Um aviso de inicialização informa ao usuário para ter um administrador habilitar a configuração.

332 332 

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. Isso inclui o modelo com o qual uma sessão inicia antes que o desenvolvedor escolha um; veja [Iniciar sessões em um modelo que a política permite](/docs/pt/claude-apps-gateway-config#start-sessions-on-a-model-the-policy-allows).

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


511 516 

512A tabela cobre quais recursos do Claude Code funcionam quando os desenvolvedores se conectam através do gateway e o que o próprio servidor gateway suporta. Onde algo não é suportado, a coluna Notas fornece a alternativa.517A tabela cobre quais recursos do Claude Code funcionam quando os desenvolvedores se conectam através do gateway e o que o próprio servidor gateway suporta. Onde algo não é suportado, a coluna Notas fornece a alternativa.

513 518 

514O gateway entrega os valores [`anthropic-beta`](https://platform.claude.com/docs/en/api/beta-headers) que a CLI envia para cada upstream, então operadores não mantêm uma lista de permissões beta. Para Amazon Bedrock, que ignora o cabeçalho, o gateway move os valores para o campo `anthropic_beta` do corpo da solicitação; os outros upstreams recebem o cabeçalho conforme enviado.519O gateway entrega os valores [`anthropic-beta`](https://platform.claude.com/docs/en/api/beta-headers) que a CLI envia para cada upstream, então operadores não mantêm uma allowlist de betas. Para Amazon Bedrock, que ignora o cabeçalho, o gateway move os valores para o campo `anthropic_beta` do corpo da requisição; os outros upstreams recebem o cabeçalho conforme enviado.

515 520 

516| Recurso | Status | Notas |521| Recurso | Status | Notas |

517| - | - | - |522| - | - | - |

518| Encaminhamento de inferência (Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud, Microsoft Foundry, Anthropic) | Disponível | Com tradução de modelo por upstream e failover. O upstream Amazon Bedrock usa o endpoint `bedrock-runtime` e a cadeia de credencial padrão da AWS; o [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) do Amazon Bedrock não é um upstream suportado. O [upstream Claude Platform on AWS](/docs/pt/claude-apps-gateway-config#claude-platform-on-aws) requer Claude Code v2.1.198 ou posterior no servidor gateway. |523| Encaminhamento de inferência (Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud, Microsoft Foundry, Anthropic) | Disponível | Com tradução de modelo por upstream e failover. O upstream Amazon Bedrock usa o endpoint `bedrock-runtime` e a cadeia de credenciais padrão da AWS. O [upstream Amazon Bedrock Mantle](/docs/pt/claude-apps-gateway-config#amazon-bedrock-mantle-endpoint) requer Claude Code v2.1.283 ou posterior no servidor gateway, e o [upstream Claude Platform on AWS](/docs/pt/claude-apps-gateway-config#claude-platform-on-aws) requer v2.1.198 ou posterior. |

519| Acesso a modelos e configurações gerenciadas por grupo IdP | Disponível | O acesso a modelos é aplicado no lado do servidor; as configurações gerenciadas são entregues por grupo IdP e aplicadas pela CLI no [nível de configurações gerenciadas](/docs/pt/settings#settings-precedence) |524| Acesso a modelos e configurações gerenciadas por grupo IdP | Disponível | O acesso a modelos é aplicado no lado do servidor; as configurações gerenciadas são entregues por grupo IdP e aplicadas pela CLI no [nível de configurações gerenciadas](/docs/pt/settings#settings-precedence) |

520| Claude Desktop | Disponível com opt-in | O gateway fornece a configuração do Claude Desktop em `/user/bootstrap` uma vez que uma política [opta por um `desktop` key](/docs/pt/claude-apps-gateway-config#claude-desktop-overlay), e o Claude Desktop envia solicitações de modelo de suas abas Cowork e Code, e da aba Chat quando você a habilita, através do gateway. Para ativar a aba Chat, consulte [Conectar Claude Desktop](#connect-claude-desktop). Requer Claude Code v2.1.203 ou posterior no servidor gateway. |525| Claude Desktop | Disponível com opt-in | O gateway fornece a configuração do Claude Desktop em `/user/bootstrap` uma vez que uma política [opta por uma chave `desktop`](/docs/pt/claude-apps-gateway-config#claude-desktop-overlay), e o Claude Desktop envia requisições de modelo de suas abas Cowork e Code, e da aba Chat quando você a habilita, através do gateway. Para ativar a aba Chat, consulte [Conectar Claude Desktop](#connect-claude-desktop). Requer Claude Code v2.1.203 ou posterior no servidor gateway. |

521| Fan-out de telemetria (OTLP/HTTP) | Disponível | Identidade-marcada por exportação; ambas as codificações protobuf e JSON |526| Fan-out de telemetria (OTLP/HTTP) | Disponível | Identidade-marcada por exportação; ambas as codificações protobuf e JSON |

522| Provedores de identidade OIDC | Disponível | Qualquer IdP compatível com OIDC; o gateway executa descoberta OIDC padrão e o fluxo de código de autorização. Consulte [Configuração do provedor de identidade](/docs/pt/claude-apps-gateway-deploy#identity-provider-setup) para configuração por IdP |527| Provedores de identidade OIDC | Disponível | Qualquer IdP compatível com OIDC; o gateway executa descoberta OIDC padrão e o fluxo de código de autorização. Consulte [Configuração do provedor de identidade](/docs/pt/claude-apps-gateway-deploy#identity-provider-setup) para configuração por IdP |

523| Limites de gastos por usuário e por grupo | Disponível | Consulte [Limites de gastos](/docs/pt/claude-apps-gateway-spend-limits) |528| Limites de gastos por usuário e por grupo | Disponível | Consulte [Limites de gastos](/docs/pt/claude-apps-gateway-spend-limits) |

524| Busca na web no lado do servidor | Não disponível | A CLI não pode ver qual provedor upstream o gateway roteia, então não pode verificar o suporte de busca na web e desabilita WebSearch em sessões de gateway |529| Busca na web no lado do servidor | Não disponível | A CLI não pode ver qual provedor upstream o gateway roteia, então não pode verificar o suporte de busca na web e desabilita WebSearch em sessões de gateway |

525| [Remote Control](/docs/pt/remote-control) | Não disponível | A CLI mostra [um erro nomeando o gateway](/docs/pt/errors#remote-control-requires-the-anthropic-api) |530| [Remote Control](/docs/pt/remote-control) | Não disponível | A CLI mostra [um erro nomeando o gateway](/docs/pt/errors#remote-control-requires-the-anthropic-api) |

526| [`/design-sync`](/docs/pt/commands#all-commands) e `/design-login` | Não disponível | Ambos precisam de claude.ai, que a CLI não contatará em sessões de gateway, então nenhum comando aparece lá |531| [`/design-sync`](/docs/pt/commands#all-commands) e `/design-login` | Não disponível | Ambos precisam de claude.ai, que a CLI não contatará em sessões de gateway, então nenhum comando aparece lá |

527| Recursos que precisam de busca de sinalizador de recurso, como `/import` e `claude import` | Não disponível | A CLI pula a busca de sinalizador em sessões de gateway. [Recursos que precisam de busca de sinalizador de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching) lista o que isso desativa |532| Recursos que precisam de busca de feature flags, como `/import` e `claude import` | Não disponível | A CLI pula a busca de flags em sessões de gateway. [Recursos que precisam de busca de feature flags](/docs/pt/env-vars#features-that-need-feature-flag-fetching) lista o que isso desativa |

528| Cache de prompt padrão | Disponível | O gateway encaminha pontos de interrupção `cache_control` para cada upstream. [Onde o cache reside](/docs/pt/prompt-caching#where-the-cache-lives) cobre quais blocos a CLI marca, incluindo o contexto do sistema que ela anexa no meio da conversa |533| Cache de prompt padrão | Disponível | O gateway encaminha pontos de interrupção `cache_control` para cada upstream. [Onde o cache reside](/docs/pt/prompt-caching#where-the-cache-lives) cobre quais blocos a CLI marca, incluindo o contexto do sistema que ela anexa no meio da conversa |

529| TTL de cache de 1 hora | Não disponível | A CLI omite a beta de ttl de cache estendido em sessões de gateway, porque nem todo upstream que o gateway pode rotear suporta o TTL de 1 hora, então o cache de prompt através do gateway usa o TTL de 5 minutos; consulte a nota de cabeçalho beta acima |534| TTL de cache de 1 hora | Não disponível | A CLI omite a beta de ttl de cache estendido em sessões de gateway, porque nem todo upstream que o gateway pode rotear suporta o TTL de 1 hora, então o cache de prompt através do gateway usa o TTL de 5 minutos; consulte a nota de cabeçalho beta acima |

530| Modo automático | Disponível | Segue as [regras do provedor de terceiros](/docs/pt/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry): apenas os modelos elegíveis em provedores de terceiros podem usá-lo. Antes da v2.1.207, o modo automático em sessões de gateway exigia a definição de `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, entregável através do bloco `env` da política gerenciada |535| Modo auto | Disponível | Segue as [regras do provedor de terceiros](/docs/pt/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry): apenas os modelos elegíveis em provedores de terceiros podem usá-lo. Antes da v2.1.207, o modo auto em sessões de gateway exigia configurar `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, entregável através do bloco `env` da política gerenciada |

531| Otimizações apenas de primeira parte, como escopo de cache global e ferramentas eficientes em tokens | Não disponível | A CLI não as habilita em sessões de gateway; consulte a nota de cabeçalho beta acima |536| Otimizações apenas de primeira parte, como escopo de cache global e ferramentas eficientes em tokens | Não disponível | A CLI não as habilita em sessões de gateway; consulte a nota de cabeçalho beta acima |

532| OTLP/gRPC | Não suportado | OTLP sobre HTTP apenas |537| OTLP/gRPC | Não suportado | OTLP sobre HTTP apenas |

533| SAML, LDAP e outras autenticações não-OIDC | Não suportado | OIDC apenas. Coloque na frente com uma ponte OIDC se necessário |538| SAML, LDAP e outras autenticações não-OIDC | Não suportado | OIDC apenas. Coloque na frente com uma ponte OIDC se necessário |

Details

242 242 

243`upstreams` é uma lista ordenada. O gateway encaminha inferência para o primeiro upstream que resolve o modelo solicitado.243`upstreams` é uma lista ordenada. O gateway encaminha inferência para o primeiro upstream que resolve o modelo solicitado.

244 244 

245Em `5xx`, `429`, `401`, `403`, `404` ou timeout, o gateway falha para o próximo upstream; outro `4xx` não, porque esses erros são atribuíveis à solicitação em vez do upstream. Um `401` ou `403` significa que a credencial que o gateway usou contra esse upstream falhou. Um `404` significa que esse upstream não serve o modelo solicitado, portanto um upstream posterior na lista ainda pode.245Em `5xx`, `429`, `401`, `403`, `404` ou timeout, o gateway falha para o próximo upstream; outro `4xx` não, porque esses erros são atribuíveis à solicitação em vez do upstream. Um `401` ou `403` significa que o upstream rejeitou a credencial que o gateway usou ou negou acesso a ela, por exemplo, ao modelo solicitado. Um `404` significa que esse upstream não serve o modelo solicitado, portanto um upstream posterior na lista ainda pode.

246 246 

247Se você definir `forward_user_identity: true` em um upstream, um `429` que ele retorna para uma solicitação que carregava o email do desenvolvedor não falha. Consulte [como uma negação de limite por usuário chega ao desenvolvedor](#per-user-identity-headers-for-a-proxy-you-run).247Se você definir `forward_user_identity: true` em um upstream, um `429` que ele retorna para uma solicitação que carregava o email do desenvolvedor não falha. Consulte [como uma negação de limite por usuário chega ao desenvolvedor](#per-user-identity-headers-for-a-proxy-you-run).

248 248 


401 401 

402Defina `guardrail` em todos os upstreams `bedrock` ou em nenhum. O gateway se recusa a iniciar com uma mistura, porque o [failover](#multiple-upstreams) poderia, de outra forma, enviar uma requisição a um upstream Bedrock que não tem guardrail.402Defina `guardrail` em todos os upstreams `bedrock` ou em nenhum. O gateway se recusa a iniciar com uma mistura, porque o [failover](#multiple-upstreams) poderia, de outra forma, enviar uma requisição a um upstream Bedrock que não tem guardrail.

403 403 

404O guardrail cobre apenas upstreams Bedrock. Se você listar outro provedor em `upstreams`, o gateway envia requisições a esse provedor sem o guardrail.404O guardrail cobre apenas upstreams Bedrock. Se você listar outro provedor em `upstreams`, o gateway envia requisições a esse provedor sem o guardrail, ou se recusa a iniciar se esse provedor for [`mantle`](#amazon-bedrock-mantle-endpoint).

405 405 

406Quando uma requisição `/v1/messages` cujo corpo carrega um campo `amazon-bedrock-*`, como `amazon-bedrock-guardrailConfig`, chega a um upstream Bedrock que tem `guardrail` definido, o gateway responde 400 em vez de encaminhá-la.406Quando uma requisição `/v1/messages` cujo corpo carrega um campo `amazon-bedrock-*`, como `amazon-bedrock-guardrailConfig`, chega a um upstream Bedrock que tem `guardrail` definido, o gateway responde 400 em vez de encaminhá-la.

407 407 


451* Se o STS recusar ou estiver inacessível, o gateway não envia a requisição com as credenciais próprias do upstream. Ele registra o erro do STS com o que verificar e então tenta o próximo upstream que você listou. [Mensagens de erro do upstream](#upstream-error-messages) descreve o que o cliente recebe quando nenhum upstream tem sucesso. Um upstream posterior sem `assume_role` serviria a requisição com suas próprias credenciais, portanto liste um apenas se for isso que você deseja.451* Se o STS recusar ou estiver inacessível, o gateway não envia a requisição com as credenciais próprias do upstream. Ele registra o erro do STS com o que verificar e então tenta o próximo upstream que você listou. [Mensagens de erro do upstream](#upstream-error-messages) descreve o que o cliente recebe quando nenhum upstream tem sucesso. Um upstream posterior sem `assume_role` serviria a requisição com suas próprias credenciais, portanto liste um apenas se for isso que você deseja.

452* O gateway chama o endpoint regional do STS `sts.<region>.amazonaws.com`, que sua rede deve alcançar. Para o endpoint FIPS, defina `AWS_USE_FIPS_ENDPOINT=true` no ambiente do gateway em vez de `use_fips_endpoint` em um arquivo de configuração AWS.452* O gateway chama o endpoint regional do STS `sts.<region>.amazonaws.com`, que sua rede deve alcançar. Para o endpoint FIPS, defina `AWS_USE_FIPS_ENDPOINT=true` no ambiente do gateway em vez de `use_fips_endpoint` em um arquivo de configuração AWS.

453* `assume_role` se aplica apenas a `provider: bedrock` e precisa de credenciais de origem SigV4: o gateway se recusa a iniciar quando ele está definido junto com `aws_bearer_token`.453* `assume_role` se aplica apenas a `provider: bedrock` e precisa de credenciais de origem SigV4: o gateway se recusa a iniciar quando ele está definido junto com `aws_bearer_token`.

454* Cada desenvolvedor que o gateway admite pode usar esse upstream; [`managed`](#managed) governa quais desenvolvedores podem usar quais modelos. Para impedir que um modelo servido através da função também seja servido a partir de outra conta, dê a ele um id personalizado cujo mapa `upstream_model` tenha apenas o nome desse upstream. Para esse id, o gateway pula todos os outros upstreams, portanto nem a requisição nem a contagem de tokens de uma requisição abortada podem fazer failover para outra conta. Nomes de modelos integrados ainda são tentados em cada upstream em ordem, incluindo este, e uma requisição que o alcança é assinada com a mesma função, portanto liste esse upstream por último, a menos que sua conta também deva servi-los.454* Cada desenvolvedor que o gateway admite pode usar esse upstream; [`managed`](#managed) governa quais desenvolvedores podem usar quais modelos. Para impedir que um modelo servido através da função também seja servido a partir de outra conta, dê a ele um id personalizado cujo mapa `upstream_model` tenha apenas o nome desse upstream. Para esse id, o gateway pula todos os outros upstreams, portanto nem a requisição nem a contagem de tokens de uma requisição abortada podem fazer failover para outra conta. Uma requisição para um nome de modelo integrado ainda pode [alcançar esse upstream](#multiple-upstreams), e o gateway a assina com a mesma função. Liste esse upstream por último, a menos que sua conta também deva servir esses modelos.

455 455 

456Este exemplo dá a um modelo um id personalizado que apenas o upstream isolado serve:456Este exemplo dá a um modelo um id personalizado que apenas o upstream isolado serve:

457 457 


490 490 

491Para uma atribuição estrita por desenvolvedor, defina `assume_role` com `session_name` em cada upstream Bedrock que você listar. Um upstream sem ele assina as requisições que serve com suas próprias credenciais.491Para uma atribuição estrita por desenvolvedor, defina `assume_role` com `session_name` em cada upstream Bedrock que você listar. Um upstream sem ele assina as requisições que serve com suas próprias credenciais.

492 492 

493<h4 id="amazon-bedrock-mantle-endpoint">

494 Endpoint Mantle do Amazon Bedrock

495</h4>

496 

497O provedor `mantle` envia inferência para o [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) do Amazon Bedrock. Ele requer Claude Code v2.1.283 ou posterior no servidor gateway. Versões anteriores do gateway o rejeitam na inicialização, portanto atualize cada réplica antes de adicioná-lo.

498 

499O exemplo abaixo coloca o Mantle primeiro, com um upstream Amazon Bedrock atrás dele para servir cada modelo que o campo `models` deixa de fora:

500 

501```yaml theme={null}

502upstreams:

503 - provider: mantle

504 region: us-east-1

505 models: [claude-opus-4-7, claude-haiku-4-5] # obrigatório

506 auth: {} # cadeia de credencial padrão AWS

507 - provider: bedrock

508 region: us-east-1

509 auth: {}

510```

511 

512A tabela abaixo lista os campos específicos de um upstream `mantle`.

513 

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

515| - | - | - |

516| `region` | Sim | Região AWS. O gateway deriva o endpoint a partir dela como `https://bedrock-mantle.<region>.api.aws/anthropic`. |

517| `models` | Sim | Os modelos aos quais sua conta AWS recebeu acesso no Mantle, nomeados como os clientes os enviam, como `claude-haiku-4-5`. Apenas esses vão para este upstream, e todos os outros modelos pulam para o próximo. |

518| `auth` | Não | Aceita as mesmas chaves que o bloco `auth` do upstream [Amazon Bedrock](#amazon-bedrock), sob as mesmas regras. |

519| `base_url` | Não | Substitua o endpoint derivado. Mantenha o caminho `/anthropic` no final. |

520 

521Conceda à identidade AWS do upstream as ações IAM próprias do Mantle para inferência e contagem de tokens, que [Usar o endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) lista.

522 

523Para um ID de modelo do Mantle que o gateway não conhece, adicione uma entrada ao bloco [`models:`](#models) de nível superior cujo `upstream_model` mapeie o nome deste upstream para esse ID. Em seguida, coloque o `id` dessa entrada também no campo `models` deste upstream.

524 

525As configurações `guardrail` e `assume_role` de um upstream `bedrock` não se estendem às requisições que o Mantle serve:

526 

527* **`guardrail`**: o gateway não aplica nenhum [guardrail do Bedrock](#apply-an-amazon-bedrock-guardrail) às requisições que envia ao Mantle, portanto ele se recusa a iniciar quando um upstream `mantle` está listado enquanto qualquer upstream `bedrock` define `guardrail`.

528* **`assume_role`**: um upstream `mantle` não aceita [`assume_role`](#bedrock-in-another-aws-account). As requisições que o Mantle serve são enviadas com as credenciais `auth` próprias do upstream `mantle` e não são [atribuídas por desenvolvedor](#per-developer-aws-cost-attribution).

529 

530Para saber o que significam as respostas de erro próprias do Mantle, consulte [Erros do endpoint Mantle](/docs/pt/amazon-bedrock#mantle-endpoint-errors).

531 

493<h4 id="claude-platform-on-aws">532<h4 id="claude-platform-on-aws">

494 Claude Platform on AWS533 Claude Platform on AWS

495</h4>534</h4>


692| Diferentes contas | Um upstream Amazon Bedrock por conta. A cadeia padrão (`auth: {}`) usa a identidade do pod; para uma segunda conta, adicione [`assume_role`](#bedrock-in-another-aws-account) para alcançá-la com credenciais de curta duração, ou defina credenciais explícitas ou um token de portador em `auth:`. |731| Diferentes contas | Um upstream Amazon Bedrock por conta. A cadeia padrão (`auth: {}`) usa a identidade do pod; para uma segunda conta, adicione [`assume_role`](#bedrock-in-another-aws-account) para alcançá-la com credenciais de curta duração, ou defina credenciais explícitas ou um token de portador em `auth:`. |

693| Throughput provisionado | Mapeie o modelo para o ARN de throughput provisionado em `models:` para o nome desse upstream. Outros upstreams mantêm o ID sob demanda, portanto a capacidade PT é esgotada antes de falhar. |732| Throughput provisionado | Mapeie o modelo para o ARN de throughput provisionado em `models:` para o nome desse upstream. Outros upstreams mantêm o ID sob demanda, portanto a capacidade PT é esgotada antes de falhar. |

694| Endpoints VPC / FIPS | Defina `base_url:` no upstream para sua URL de endpoint VPC ou FIPS |733| Endpoints VPC / FIPS | Defina `base_url:` no upstream para sua URL de endpoint VPC ou FIPS |

695| Roteamento com escopo de modelo | Apenas um modelo `id` personalizado, que não é um modelo Claude integrado, pula os upstreams ausentes de seu mapa `upstream_model:`. O gateway tenta modelos integrados em cada upstream em ordem e usa o ID padrão do provedor onde o mapa não tem entrada, portanto para modelos integrados o mapa muda qual ID um upstream recebe em vez de se é tentado; um upstream que rejeita o ID segue as mesmas [regras de failover](#upstreams) que qualquer outro erro de upstream. |734| Roteamento com escopo de modelo | Apenas um modelo `id` personalizado, que não é um modelo Claude integrado, pula os upstreams ausentes de seu mapa `upstream_model:`. Um upstream `mantle` é tentado apenas para os modelos listados em seu [campo `models`](#amazon-bedrock-mantle-endpoint). Em todos os outros upstreams, o gateway tenta modelos integrados em ordem e usa o ID padrão do provedor onde o mapa não tem entrada, portanto para modelos integrados o mapa muda qual ID um upstream recebe em vez de se é tentado; um upstream que rejeita o ID segue as mesmas [regras de failover](#upstreams) que qualquer outro erro de upstream. |

696 735 

697Falhar entre provedores de nuvem ou para a API Anthropic direta muda qual acordo, geografia e outros termos governam a solicitação.736Falhar entre provedores de nuvem ou para a API Anthropic direta muda qual acordo, geografia e outros termos governam a solicitação.

698 737 


848 - match: {}887 - match: {}

849 cli:888 cli:

850 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]889 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

890 # Make the Default option in /model resolve inside each policy's

891 # list. The eng-contractors policy inherits enforceAvailableModels.

892 enforceAvailableModels: true

851```893```

852 894 

853Uma captura `match: {}`, convencionalmente listada por último, é tratada como uma camada base. Cada outra política herda qualquer chave que não define da captura, então entradas por função só precisam listar o que difere do padrão da organização. As regras de mesclagem dependem do tipo de chave:895Uma captura `match: {}`, convencionalmente listada por último, é tratada como uma camada base. Cada outra política herda qualquer chave que não define da captura, então entradas por função só precisam listar o que difere do padrão da organização. As regras de mesclagem dependem do tipo de chave:


856* **Listas de negação e arrays de hook**: `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces` e cada array de tipo de evento `hooks`. Estes tomam a união de base e política, então um hook de negação ou auditoria em toda a organização não pode ser acidentalmente descartado por uma substituição por função.898* **Listas de negação e arrays de hook**: `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces` e cada array de tipo de evento `hooks`. Estes tomam a união de base e política, então um hook de negação ou auditoria em toda a organização não pode ser acidentalmente descartado por uma substituição por função.

857* **Chaves de tipo registro**: `env`, `modelOverrides` e `skillOverrides`. Estas mesclam superficialmente, então um bloco `env` por função sobrescreve as chaves que define e herda o resto da base.899* **Chaves de tipo registro**: `env`, `modelOverrides` e `skillOverrides`. Estas mesclam superficialmente, então um bloco `env` por função sobrescreve as chaves que define e herda o resto da base.

858 900 

859`availableModels` também é aplicado no lado do servidor em `/v1/messages`, então um modelo negado retorna `400` independentemente do que o cliente envia.901`availableModels` também é aplicado no lado do servidor em `/v1/messages`, então um modelo negado retorna `400` independentemente do que o cliente envia. Uma lista vazia nega todos os modelos. A verificação também cobre o modelo em que uma sessão começa antes de o desenvolvedor escolher um, então [inicie sessões em um modelo que a política permite](#start-sessions-on-a-model-the-policy-allows).

860 902 

861O gateway valida o valor `model` em si antes de retransmitir uma requisição, então um valor malformado nunca atinge um upstream. Ele rejeita a requisição com um `400` em dois casos:903O gateway valida o valor `model` em si antes de retransmitir uma requisição, então um valor malformado nunca atinge um upstream. Ele rejeita a requisição com um `400` em dois casos:

862 904 


883 * **Associação de grupo**: mudar a associação de grupo de um usuário muda qual política o corresponde. Isto entra em vigor na próxima remintagem de sessão, significando o próximo refresh silencioso, limitado por `session.ttl_hours`.925 * **Associação de grupo**: mudar a associação de grupo de um usuário muda qual política o corresponde. Isto entra em vigor na próxima remintagem de sessão, significando o próximo refresh silencioso, limitado por `session.ttl_hours`.

884</Note>926</Note>

885 927 

928<h4 id="start-sessions-on-a-model-the-policy-allows">

929 Iniciar sessões em um modelo que a política permite

930</h4>

931 

932Se `availableModels` deixa de fora o modelo padrão do Claude Code, as sessões recebem respostas `400` até que o desenvolvedor escolha um modelo listado, por exemplo com `/model`. Em sessões do gateway, o padrão é o modelo Opus para o qual o alias `opus` resolve, e `availableModels` sozinho não o altera.

933 

934Para corrigir isso, defina [`enforceAvailableModels: true`](/docs/pt/model-config#enforce-the-allowlist-for-the-default-model) no mesmo bloco `cli` e, em seguida, verifique que tipo de entrada a lista tem:

935 

936* **Um alias como `sonnet`, ou um ID integrado como `claude-sonnet-4-6`**: as sessões começam em um desses modelos, e a opção Default em `/model` resolve para ele

937* **Nenhum alias ou ID integrado na lista**: as sessões podem continuar começando no padrão integrado, então também defina [`model`](/docs/pt/model-config#control-the-model-users-run-on) como um dos IDs listados no bloco `cli` dessa política

938 

939Esta política lista um ID personalizado que [`models`](#models) define e inicia sessões nesse ID:

940 

941```yaml theme={null}

942managed:

943 policies:

944 - match: { groups: [restricted-projects] }

945 cli:

946 availableModels: [claude-opus-restricted]

947 enforceAvailableModels: true

948 model: claude-opus-restricted

949```

950 

886<h4 id="matcher-values-that-stop-the-gateway-at-boot">951<h4 id="matcher-values-that-stop-the-gateway-at-boot">

887 Valores de matcher que interrompem o gateway na inicialização952 Valores de matcher que interrompem o gateway na inicialização

888</h4>953</h4>


920 cli:985 cli:

921 # Model access (also enforced server-side at /v1/messages)986 # Model access (also enforced server-side at /v1/messages)

922 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]987 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

988 enforceAvailableModels: true # Default resolves inside the list

923 989 

924 # Permission policy990 # Permission policy

925 permissions:991 permissions:


1041 - match: { groups: [eng-contractors] }1107 - match: { groups: [eng-contractors] }

1042 cli:1108 cli:

1043 availableModels: [claude-sonnet-4-6]1109 availableModels: [claude-sonnet-4-6]

1110 enforceAvailableModels: true

1044 desktop:1111 desktop:

1045 isLocalDevMcpEnabled: false1112 isLocalDevMcpEnabled: false

1046 disableAutoUpdates: true1113 disableAutoUpdates: true


1434 # region: us-east-11501 # region: us-east-1

1435 # auth: {}1502 # auth: {}

1436 1503 

1504 # - provider: mantle

1505 # region: us-east-1

1506 # models: [claude-opus-4-8, claude-opus-4-7, claude-haiku-4-5]

1507 # auth: {}

1508 

1437 # - provider: anthropicAws1509 # - provider: anthropicAws

1438 # region: us-east-11510 # region: us-east-1

1439 # workspace_id: wrkspc_...1511 # workspace_id: wrkspc_...


1456 upstream_model:1528 upstream_model:

1457 anthropic: claude-opus-4-81529 anthropic: claude-opus-4-8

1458 # bedrock: us.anthropic.claude-opus-4-81530 # bedrock: us.anthropic.claude-opus-4-8

1531 # mantle: anthropic.claude-opus-4-8

1459 # anthropicAws: claude-opus-4-81532 # anthropicAws: claude-opus-4-8

1460 # vertex: claude-opus-4-81533 # vertex: claude-opus-4-8

1461 # foundry: <your-opus-deployment-name>1534 # foundry: <your-opus-deployment-name>


1473 - match: { groups: [contractors] }1546 - match: { groups: [contractors] }

1474 cli:1547 cli:

1475 availableModels: [claude-haiku-4-5]1548 availableModels: [claude-haiku-4-5]

1476 # Restrinja a opção do seletor Padrão aos availableModels em vez de

1477 # o padrão de tier, para que contractors não recebam um 400 no padrão.

1478 enforceAvailableModels: true

1479 # allow aprova automaticamente essas ferramentas; não bloqueia o resto.1549 # allow aprova automaticamente essas ferramentas; não bloqueia o resto.

1480 # Adicione regras deny para restringir ferramentas.1550 # Adicione regras deny para restringir ferramentas.

1481 permissions: { allow: [Read, Grep] }1551 permissions: { allow: [Read, Grep] }

1482 - match: {}1552 - match: {}

1483 cli:1553 cli:

1484 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]1554 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

1555 # Restrinja a opção Padrão do seletor aos availableModels de cada política

1556 # em vez do padrão integrado, para que nenhuma função receba um 400 no Padrão.

1557 # A política de contractors herda esta chave.

1558 enforceAvailableModels: true

1485 permissions:1559 permissions:

1486 allow: [Read, Grep, Bash, Edit]1560 allow: [Read, Grep, Bash, Edit]

1487 deny: ["WebFetch"]1561 deny: ["WebFetch"]

Details

429 429 

430O gateway responde `431` quando os cabeçalhos de uma requisição totalizam mais de 256 KiB, ou mais de [`limits.max_request_header_bytes`](/docs/pt/claude-apps-gateway-config#http-tuning) se você o definir. Ele não escreve nenhuma linha de log nem evento de auditoria para essas requisições. Versões do gateway anteriores a v2.1.284 respondem `431` acima de 16 KiB.430O gateway responde `431` quando os cabeçalhos de uma requisição totalizam mais de 256 KiB, ou mais de [`limits.max_request_header_bytes`](/docs/pt/claude-apps-gateway-config#http-tuning) se você o definir. Ele não escreve nenhuma linha de log nem evento de auditoria para essas requisições. Versões do gateway anteriores a v2.1.284 respondem `431` acima de 16 KiB.

431 431 

432O que alterar depende da versão e da configuração do seu gateway:432Comece pelo primeiro destes casos que se aplica ao seu gateway:

433 433 

434* **Gateway anterior a v2.1.284**: atualize o gateway434* **Gateway anterior a v2.1.284**: atualize o gateway

435* **`limits.max_request_header_bytes` definido**: aumente o valor ou remova a chave435* **`limits.max_request_header_bytes` definido**: aumente o valor ou remova a chave

436* **Nenhum dos casos se aplica, ou o `431` continua depois**: faça com que seu IdP emita menos grupos. [Identity provider setup](#identity-provider-setup) explica como Okta, Microsoft Entra ID e Google Workspace fornecem grupos436* **Nenhum dos casos se aplica, ou o `431` continua depois**: faça com que seu IdP emita menos grupos. [Identity provider setup](#identity-provider-setup) explica como Okta, Microsoft Entra ID e Google Workspace fornecem grupos

437 437 

438Ao reduzir a reivindicação de grupos, mantenha os grupos que você nomeou nestas configurações, que decidem o acesso, a política e os limites de gastos de um desenvolvedor:

439 

440* **[`oidc.allowed_groups`](/docs/pt/claude-apps-gateway-config#oidc)**: decide quem pode fazer login

441* **[`admin.admin_groups`](/docs/pt/claude-apps-gateway-config#admin)**: decide quem pode chamar a API de administração com sua sessão do gateway

442* **`match.groups` em [`managed.policies`](/docs/pt/claude-apps-gateway-config#managed)**: decide qual política se aplica a um desenvolvedor

443* **[Limites de gastos](/docs/pt/claude-apps-gateway-spend-limits) `rbac_group`**: decidem quais limites de grupo se aplicam a um desenvolvedor

444 

438<h2 id="related">445<h2 id="related">

439 Relacionado446 Relacionado

440</h2>447</h2>

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-setup-for-team-and-enterprise">

71 Quick setup para Team e Enterprise

72</h3>

73 

74Quick 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 setup** em [**Organization 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

429 badge: 'local',429 badge: 'local',

430 oneLiner: 'App state and UI preferences',430 oneLiner: 'App state and UI preferences',

431 when: <>Read at session start for your preferences and MCP servers. Claude Code writes back to it when you change settings in <C>/config</C> or approve trust prompts</>,431 when: <>Read at session start for your preferences and MCP servers. Claude Code writes back to it when you change settings in <C>/config</C> or approve trust prompts</>,

432 description: <>Holds state that does not belong in settings.json: theme, OAuth session, per-project trust decisions, your personal MCP servers, and UI toggles. Mostly managed through <C>/config</C> rather than editing directly.</>,432 description: <>Holds state that does not belong in settings.json: OAuth session, per-project trust decisions, your personal MCP servers, and UI toggles. Mostly managed through <C>/config</C> rather than editing directly.</>,

433 tips: [<>IDE toggles like <C>autoConnectIde</C> and <C>externalEditorContext</C> live here, not in settings.json</>, <>The <C>projects</C> key tracks per-project state like trust-dialog acceptance and last-session metrics. Permission rules you approve in-session go to <C>.claude/settings.local.json</C> instead</>, <>MCP servers here are yours only: user scope applies across all projects, local scope is per-project but not committed. Team-shared servers go in <C>.mcp.json</C> at the project root instead</>],433 tips: [<>IDE toggles like <C>autoConnectIde</C> and <C>externalEditorContext</C> live here, not in settings.json</>, <>The <C>projects</C> key tracks per-project state like trust-dialog acceptance and last-session metrics. Permission rules you approve in-session go to <C>.claude/settings.local.json</C> instead</>, <>MCP servers here are yours only: user scope applies across all projects, local scope is per-project but not committed. Team-shared servers go in <C>.mcp.json</C> at the project root instead</>],

434 example: `{434 example: `{

435 "autoConnectIde": true,435 "autoConnectIde": true,


497 oneLiner: 'Custom keyboard shortcuts',497 oneLiner: 'Custom keyboard shortcuts',

498 when: 'Read at session start and hot-reloaded when you edit the file',498 when: 'Read at session start and hot-reloaded when you edit the file',

499 description: <>Rebind keyboard shortcuts in the interactive CLI. Run <C>/keybindings</C> to create or open this file with a schema reference. Ctrl+C, Ctrl+D, Ctrl+M, and Caps Lock are reserved and cannot be rebound.</>,499 description: <>Rebind keyboard shortcuts in the interactive CLI. Run <C>/keybindings</C> to create or open this file with a schema reference. Ctrl+C, Ctrl+D, Ctrl+M, and Caps Lock are reserved and cannot be rebound.</>,

500 exampleIntro: <>This example binds <C>Ctrl+E</C> to open your external editor and unbinds <C>Ctrl+U</C> by setting it to <C>null</C>. The <C>context</C> field scopes bindings to a specific part of the CLI, here the main chat input.</>,500 exampleIntro: <>This example binds <C>Ctrl+E</C> to open your external editor and unbinds <C>Ctrl+S</C> by setting it to <C>null</C>. The <C>context</C> field scopes bindings to a specific part of the CLI, here the main chat input.</>,

501 example: `{501 example: `{

502 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",502 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",

503 "$docs": "https://code.claude.com/docs/en/keybindings",503 "$docs": "https://code.claude.com/docs/en/keybindings",


506 "context": "Chat",506 "context": "Chat",

507 "bindings": {507 "bindings": {

508 "ctrl+e": "chat:externalEditor",508 "ctrl+e": "chat:externalEditor",

509 "ctrl+u": null509 "ctrl+s": null

510 }510 }

511 }511 }

512 ]512 ]


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 a [Configuração rápida](/docs/pt/claude-code-on-the-web#quick-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 

costs.md +2 −2

Details

111| Sua função | O que `/usage-credits` faz |111| Sua função | O que `/usage-credits` faz |

112| :- | :- |112| :- | :- |

113| Assinante Pro ou Max | Abre [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai no navegador. Em sua seção **Usage credits** você pode ativar ou desativar créditos de uso e verificar seu saldo de crédito, gasto deste mês e seu limite de gasto mensal |113| Assinante Pro ou Max | Abre [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai no navegador. Em sua seção **Usage credits** você pode ativar ou desativar créditos de uso e verificar seu saldo de crédito, gasto deste mês e seu limite de gasto mensal |

114| Membro de Team ou Enterprise com acesso de faturamento | Abre as configurações de uso de sua organização, [**Admin settings > Usage**](https://claude.ai/admin-settings/usage), no navegador |114| Membro de Team ou Enterprise com acesso de faturamento | Abre as configurações de uso de sua organização, [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), no navegador |

115| Membro de Team ou Enterprise sem acesso de faturamento | Pede que você confirme, então envia uma solicitação aos administradores de sua organização. Antes da v2.1.211, Claude Code enviava a solicitação sem uma etapa de confirmação |115| Membro de Team ou Enterprise sem acesso de faturamento | Pede que você confirme, então envia uma solicitação aos administradores de sua organização. Antes da v2.1.211, Claude Code enviava a solicitação sem uma etapa de confirmação |

116 116 

117Para membros de Team e Enterprise sem acesso de faturamento, a confirmação aparece apenas em sessões interativas: em modo não interativo com a flag `-p` e de [Remote Control](/docs/pt/remote-control), o comando não envia solicitação e diz que você execute em uma sessão interativa.117Para membros de Team e Enterprise sem acesso de faturamento, a confirmação aparece apenas em sessões interativas: em modo não interativo com a flag `-p` e de [Remote Control](/docs/pt/remote-control), o comando não envia solicitação e diz que você execute em uma sessão interativa.


229* **"Você atingiu seu limite de sessão" ou "Você atingiu seu limite semanal"**: uma janela de uso baseada em assento em um plano de assinatura, compartilhada em todos os modelos, então o desenvolvedor não pode restaurar o acesso mudando de modelos com `/model`. A mensagem mostra quando a janela é redefinida. Após a mensagem específica do modelo "Você atingiu seu limite de Opus" ou "Você atingiu seu limite de Sonnet", mudar para um modelo fora dessa família com `/model` mantém o desenvolvedor trabalhando. Veja [erros de limite de uso](/docs/pt/errors#youve-hit-your-session-limit). O que o desenvolvedor pode fazer enquanto isso:229* **"Você atingiu seu limite de sessão" ou "Você atingiu seu limite semanal"**: uma janela de uso baseada em assento em um plano de assinatura, compartilhada em todos os modelos, então o desenvolvedor não pode restaurar o acesso mudando de modelos com `/model`. A mensagem mostra quando a janela é redefinida. Após a mensagem específica do modelo "Você atingiu seu limite de Opus" ou "Você atingiu seu limite de Sonnet", mudar para um modelo fora dessa família com `/model` mantém o desenvolvedor trabalhando. Veja [erros de limite de uso](/docs/pt/errors#youve-hit-your-session-limit). O que o desenvolvedor pode fazer enquanto isso:

230 * Execute `/usage-credits` para solicitar uso além da cota, se você tiver [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) ativados.230 * Execute `/usage-credits` para solicitar uso além da cota, se você tiver [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) ativados.

231 * No Claude Code v2.1.234 ou posterior, [aguarde e continue a tarefa interrompida automaticamente após o reset](/docs/pt/interactive-mode#wait-for-a-usage-limit-to-reset); essa seção lista quando Claude Code inicia a espera por conta própria e quando o desenvolvedor a escolhe em `/rate-limit-options`. Para controlar sua frota se Claude Code inicia essa espera por conta própria, defina [`autoContinueAtUsageLimit`](/docs/pt/settings-reference#autocontinueatusagelimit) em [configurações gerenciadas](/docs/pt/settings#settings-precedence).231 * No Claude Code v2.1.234 ou posterior, [aguarde e continue a tarefa interrompida automaticamente após o reset](/docs/pt/interactive-mode#wait-for-a-usage-limit-to-reset); essa seção lista quando Claude Code inicia a espera por conta própria e quando o desenvolvedor a escolhe em `/rate-limit-options`. Para controlar sua frota se Claude Code inicia essa espera por conta própria, defina [`autoContinueAtUsageLimit`](/docs/pt/settings-reference#autocontinueatusagelimit) em [configurações gerenciadas](/docs/pt/settings#settings-precedence).

232* **"Você atingiu seu limite de gastos individual", "limite de gastos mensal da organização", ou "orçamento compartilhado da equipe"**: a solicitação do desenvolvedor seria faturada para créditos de uso, e esses créditos atingiram um limite de gastos que você definiu. Para permitir que o desenvolvedor continue, vá para [**Configurações de Administrador > Uso**](https://claude.ai/admin-settings/usage) e aumente o limite que a mensagem nomeia. Quando a mensagem também nomeia um tempo de reset do plano, o desenvolvedor pode esperar até então. Veja [a referência de erro](/docs/pt/errors#youve-hit-your-monthly-spend-limit) para cada variante.232* **"Você atingiu seu limite de gastos individual", "limite de gastos mensal da organização", ou "orçamento compartilhado da equipe"**: a requisição do desenvolvedor seria faturada para créditos de uso, e esses créditos atingiram um limite de gastos que você definiu. Para permitir que o desenvolvedor continue, vá para [**Configurações da organização > Uso**](https://claude.ai/admin-settings/usage) e aumente o limite que a mensagem nomeia. Quando a mensagem também nomeia um tempo de reset do plano, o desenvolvedor pode, em vez disso, esperar até então. Veja [a referência de erro](/docs/pt/errors#youve-hit-your-monthly-spend-limit) para cada variante.

233* **Uma mensagem de limite de gastos de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway)**: o desenvolvedor passou um limite de gastos que você definiu em seu gateway auto-hospedado, e o gateway bloqueia suas solicitações até o período ser redefinido ou você aumentar o limite. Veja [limites de gastos do gateway](/docs/pt/claude-apps-gateway-spend-limits) para limites, cronogramas de reset e a mensagem que o desenvolvedor vê.233* **Uma mensagem de limite de gastos de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway)**: o desenvolvedor passou um limite de gastos que você definiu em seu gateway auto-hospedado, e o gateway bloqueia suas solicitações até o período ser redefinido ou você aumentar o limite. Veja [limites de gastos do gateway](/docs/pt/claude-apps-gateway-spend-limits) para limites, cronogramas de reset e a mensagem que o desenvolvedor vê.

234* **Um aviso de contexto ou auto-compact**: não é um limite de uso. A conversa cresceu perto da [janela de auto-compact](/docs/pt/model-config#set-the-auto-compact-window) da sessão, o limite onde Claude Code resume o histórico mais antigo para liberar espaço. Aponte o desenvolvedor para [reduzir uso de tokens](#reduce-token-usage).234* **Um aviso de contexto ou auto-compact**: não é um limite de uso. A conversa cresceu perto da [janela de auto-compact](/docs/pt/model-config#set-the-auto-compact-window) da sessão, o limite onde Claude Code resume o histórico mais antigo para liberar espaço. Aponte o desenvolvedor para [reduzir uso de tokens](#reduce-token-usage).

235* **Gastos inesperadamente altos em um plano de API ou provedor de nuvem**: geralmente rastreia de volta para sessões longas que nunca foram limpas ou para Opus deixado como o modelo padrão. Os hábitos de maior impacto para compartilhar são limpar entre tarefas não relacionadas e corresponder o modelo ao trabalho, ambos cobertos em [reduzir uso de tokens](#reduce-token-usage).235* **Gastos inesperadamente altos em um plano de API ou provedor de nuvem**: geralmente rastreia de volta para sessões longas que nunca foram limpas ou para Opus deixado como o modelo padrão. Os hábitos de maior impacto para compartilhar são limpar entre tarefas não relacionadas e corresponder o modelo ao trabalho, ambos cobertos em [reduzir uso de tokens](#reduce-token-usage).

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 +13 −13

Details

244 Alternar modos de visualização244 Alternar modos de visualização

245</h3>245</h3>

246 246 

247Os modos de visualização controlam quanto detalhe aparece na transcrição do chat. Alterne modos no menu suspenso **Transcript view** ao lado do botão enviar, ou pressione **Ctrl+O** no macOS ou Windows para ciclar através deles. O modo Thinking aparece no menu suspenso apenas depois que Claude produziu thinking na sessão que você está visualizando.247Os modos de visualização controlam quanto detalhe aparece na transcrição do chat. Para alternar modos de visualização, abra o menu da sessão pelo acento circunflexo ao lado do título da sessão e selecione **Transcript view**, ou pressione **Ctrl+O** no macOS ou Windows para ciclar através deles. O modo Thinking aparece no menu apenas depois que Claude produziu pensamento na sessão que você está visualizando.

248 248 

249| Modo | O que mostra |249| Modo | O que mostra |

250| - | - |250| - | - |


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


1005| `--dangerously-skip-permissions` | Modo Bypass permissions. Em planos Pro e Max, ative em Configurações → Claude Code → "Allow bypass permissions mode"; em planos Team e Enterprise, a política organizacional controla |1005| `--dangerously-skip-permissions` | Modo Bypass permissions. Em planos Pro e Max, ative em Configurações → Claude Code → "Allow bypass permissions mode"; em planos Team e Enterprise, a política organizacional controla |

1006| `--add-dir` | Adicione múltiplos repos com o botão **+** em sessões na nuvem |1006| `--add-dir` | Adicione múltiplos repos com o botão **+** em sessões na nuvem |

1007| `--allowedTools`, `--disallowedTools` | Nenhum equivalente por sessão. Regras de permissão em [arquivos de configuração](/docs/pt/settings) ainda se aplicam. |1007| `--allowedTools`, `--disallowedTools` | Nenhum equivalente por sessão. Regras de permissão em [arquivos de configuração](/docs/pt/settings) ainda se aplicam. |

1008| `--verbose` | [Modo de visualização Verbose](#switch-view-modes) no menu suspenso Transcript view |1008| `--verbose` | [Modo de visualização Verbose](#switch-view-modes) |

1009| `--print`, `--output-format` | Não disponível. Desktop é apenas interativo. |1009| `--print`, `--output-format` | Não disponível. Desktop é apenas interativo. |

1010| Variável de ambiente `ANTHROPIC_MODEL` | Menu suspenso de modelo ao lado do botão enviar |1010| Variável de ambiente `ANTHROPIC_MODEL` | Menu suspenso de modelo ao lado do botão enviar |

1011| Variável de ambiente `MAX_THINKING_TOKENS` | Defina no editor de ambiente local. Veja [configuração de ambiente](#environment-configuration). |1011| Variável de ambiente `MAX_THINKING_TOKENS` | Defina no editor de ambiente local. Veja [configuração de ambiente](#environment-configuration). |

Details

92* Salvar uma captura de tela com **Cmd+S** ou uma gravação de tela com **Cmd+R**, usando os botões de captura do painel ou os atalhos de teclado; os arquivos são salvos em sua Desktop92* Salvar uma captura de tela com **Cmd+S** ou uma gravação de tela com **Cmd+R**, usando os botões de captura do painel ou os atalhos de teclado; os arquivos são salvos em sua Desktop

93* Parar de transmitir um dispositivo sem desligá-lo clicando em **Detach simulator**, que retorna o painel ao estado **Attach simulator**93* Parar de transmitir um dispositivo sem desligá-lo clicando em **Detach simulator**, que retorna o painel ao estado **Attach simulator**

94 94 

95A linha sob o nome do dispositivo ajusta o fluxo de vídeo do simulador. Reduza **Frame rate** ou **Resolution** se o painel sobrecarregar seu Mac, alterne **Encoding** entre H.264 e JPEG, ou marque **FPS** para exibir a taxa de quadros que o painel está recebendo. Essas configurações alteram como o painel exibe o dispositivo, não como o aplicativo é executado.95Para ajustar o streaming de vídeo do simulador, abra o menu **Display** do painel. Reduza **Frame rate** ou **Resolution** se o painel sobrecarregar seu Mac. Ambas as configurações alteram como o painel exibe o dispositivo, não como o aplicativo é executado.

96 96 

97Você e Claude controlam o mesmo dispositivo, portanto seus toques alteram o estado do aplicativo que Claude vê. Para fazer Claude verificar uma tela específica, navegue até ela tocando e depois pergunte. Enquanto Claude está controlando o dispositivo, o painel mostra um crachá **Claude is using this device** acima da tela; espere tocar até que o crachá desapareça, para que o resultado reflita o aplicativo em vez de sua entrada.97Você e Claude controlam o mesmo dispositivo, portanto seus toques alteram o estado do aplicativo que Claude vê. Para fazer Claude verificar uma tela específica, navegue até ela tocando e depois pergunte. Enquanto Claude está controlando o dispositivo, o painel mostra um crachá **Claude is using this device** acima da tela; espere tocar até que o crachá desapareça, para que o resultado reflita o aplicativo em vez de sua entrada.

98 98 

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 +336 −297

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 de 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 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 como 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`


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 em vez 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 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 |

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 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 que 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 cada 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 um proxy ou gateway. Quando definido como um host que não é da própria Anthropic, o [MCP Tool Search](/docs/pt/mcp#scale-with-mcp-tool-search) é 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) é 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 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 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 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, de organização ou tenant, de roteamento ou de 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 de exibição 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 de exibição 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 de exibição 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 de exibição 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 de exibição 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 de exibição 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 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) |

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 modo de planejamento 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 de exibição 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 de exibição 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 modo de planejamento 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 de exibição 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 de exibição 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ê o 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 um 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 definido (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-o 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 [fazer login 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 Amazon Bedrock ou Amazon Bedrock Mantle. No Amazon Bedrock, isso só tem efeito quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou o descontinuado `ANTHROPIC_SMALL_FAST_MODEL` também está definido, 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 |

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 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 isso quando sua regra de federação tiver escopo para mais de um workspace, para que a troca de token 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 em 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 definido, 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` definido. Os [watchdogs de stream](/docs/pt/network-config#streaming-idle-watchdogs) são executados independentemente dele e abortam uma pausa silenciosa longa 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 um proxy. Valores acima do máximo causam overflow do 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 em primeiro plano da ferramenta 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 |

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 em primeiro plano da ferramenta Bash ou PowerShell, 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 [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-o no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorado 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 seu 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, em vez de dentro de um servidor MCP stdio que o Claude Code iniciou, use `CLAUDE_CODE_CHILD_SESSION` |

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

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. Na v2.1.198 e na 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 querem 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 do 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 estiver ativado, 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 adequada a leitores de tela: texto simples sem bordas decorativas nem 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), 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 ler 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). Sua primeira tecla pressionada 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 byte; quando definido, tem precedência sobre `CLAUDE_STREAM_IDLE_TIMEOUT_MS` para esse watchdog e deixa o watchdog em nível de evento 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 sua 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), para que você pare 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 aciona 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` [desativou 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 a 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 do início do system prompt o [bloco de atribuição](/docs/pt/llm-gateway-protocol#system-prompt-attribution-block), que carrega a versão do cliente e uma impressão digital do 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 em conexões do Microsoft Foundry, então, nessas versões, defina-o 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` |

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 é 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, quando esta variável estiver 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 o IDE](/docs/pt/vs-code). Por padrão, o Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de um 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 uma conexão direta com a API da Anthropic, requer v2.1.281 ou posterior. A seção vinculada lista quais sessões pedem ao 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 padrão de provedores de credenciais 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 via 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 |

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 final de cada turno, mesmo enquanto 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 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 observa 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 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 vincular de volta à 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` |

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 CA para conexões TLS. `bundled` é o conjunto de CAs da Mozilla fornecido 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 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, de comandos de [hook](/docs/pt/hooks) e de 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`, ela só é definida pelo próprio Claude Code quando ele inicia um subprocesso, e não por 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 ao 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 persistem. 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 em streaming. Use `API_TIMEOUT_MS` para o timeout por requisição. Para a fase de cabeçalhos de resposta de uma requisição em 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 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` |

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 limita 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 esse limite é aplicado. Ú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 gateway ou ID de modelo 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, nem 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, 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 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 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 pela [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 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 |

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 desativariam. 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 em streaming do [Amazon Bedrock](/docs/pt/amazon-bedrock) com um cabeçalho `Content-Type` ausente ou vazio como o event stream binário do Amazon Bedrock. Por padrão, o Claude Code presume que um gateway removeu o cabeçalho de uma resposta que, de resto, não foi modificada, então decodifica o corpo e o streaming continua funcionando. Defina isso 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 em 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 |

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 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) para, reinicia ou atualiza 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 |

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

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 cron ficam indisponíveis e quaisquer tarefas já agendadas deixam de disparar, 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 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 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 do corpo associados a eles e os campos beta do 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 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ê arquivos diretamente em vez de iniciar agentes Explore e Plan. Subagentes personalizados chamados `Explore` ou `Plan` não são afetados. Para remover todos os tipos de subagente integrados no Agent SDK ou no modo não interativo, use `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. 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 de 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 |

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 alvos de variáveis de shell e de parâmetros posicionais nesses scripts, e as outras verificações de caminhos críticos continuam sendo executadas. Defina-a no ambiente que inicia o Claude Code, já que o Claude Code ignora uma cópia entregue por 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 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 |

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 perder acesso ao modelo de uma sessão no meio da sessão; a requisição recusada falha imediatamente. 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, arrastes e hover 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 falhar com um erro em nível de conexão, como um reset 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 [badge 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 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 é 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_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 em streaming falhar no meio do stream. Os erros de streaming são propagados para a camada de novas tentativas. Ú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ê está digitando no terminal ou com ele em foco. Por padrão, a ferramenta ignora 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 em uma máquina. Se a variável estiver definida nesse momento, o Claude Code ignora 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 em que 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ções. Requer Claude Code v2.1.283 ou posterior |

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 |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 que a configuração [`switchModelsOnFlag`](/docs/pt/settings-reference#switchmodelsonflag) controla |

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 |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` associado a ele, 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_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) |281| `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 caminhos críticos continuam sendo executadas. Defina-a no ambiente que inicia o Claude Code, já que o Claude Code ignora uma cópia entregue por um bloco `env` de configurações. Requer Claude Code v2.1.281 ou posterior |

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á |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 ignora 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_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 |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`. 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 nesse caso |

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 |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 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, em vez disso, corrigir a janela presumida; 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 |

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 os comandos da [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) no Windows diretamente, em vez de pelo 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 |

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 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 de [`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, Agent Platform do Google Cloud, Microsoft Foundry e sessões conectadas do [gateway de apps do Claude](/docs/pt/claude-apps-gateway). Da v2.1.158 à v2.1.206, definir esta variável como `1` era necessário 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. Desativada 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 encaminhar 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` estiver definida e, caso contrário, não tem efeito. `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 das chamadas de ferramenta são transmitidas pela API enquanto 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 parecer um travamento. Ativada por padrão na API da Anthropic. No Amazon Bedrock e na Agent Platform do Google Cloud, ativada 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`. Desativada 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. Desativada 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 sua entrada de 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 enquanto sua conta está próxima 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é você 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 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) |

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 [equipes de agentes](/docs/pt/agent-teams). 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 de 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 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 de nível superior genuína 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, portanto 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, nas quais 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 de tachado para `~~text~~` nas respostas do Claude quando o seu terminal oferece suporte a isso, 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 |

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 o seu terminal oferece suporte a ela, 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. Ao contrário de `CLAUDE_CODE_NO_FLICKER`, que muda para a [renderização em tela cheia](/docs/pt/fullscreen), esta 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 ao Claude gerar [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 todos os tipos de sessão. Você pode executar `/subtask` esteja 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 pode passar a flag por conta própria. Ao contrário da flag, que sai com 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 está 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 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 |

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 o 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 em log um aviso visível com `--debug`. Antes da v2.1.219, o Claude Code saía 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 nem 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, 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` | Quantos minutos o trabalho em segundo plano pode manter uma meta ativa aguardando antes que o Claude Code [peça ao 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 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 |

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 o 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 de host usado para se conectar à extensão da 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 de extensões da 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 da IDE durante a conexão. Use quando a conexão automática não encontra sua IDE mesmo ela estando 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 gerar outro (padrão: 20). Aceita um número inteiro positivo em dígitos simples; qualquer outra coisa é ignorada, portanto a variável pode ajustar o limite, mas não 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 quando 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 resolver para um modelo conhecido, o padrão é 32000 e o limite é 128000. Aumentar este 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 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 sem supervisão 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 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 |

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 gerar seus próprios subagentes, e um subagente na terceira camada não pode gerar 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 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, portanto 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 pedindo que ele continue 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, portanto 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 o envio automático 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` | Quanto tempo, em milissegundos, o primeiro turno de uma sessão [não interativa](/docs/pt/headless) aguarda pelos 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 |

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 em processo do SDK. Requer Claude Code v2.1.187 ou posterior. Antes da v2.1.203, os servidores stdio estavam 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 começa com a troca de mensagens ativada, o Claude Code vincula o socket antes de qualquer hook ser executado. Outras sessões na máquina entregam mensagens nesse 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 |

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 publica no 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) 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 |

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 cursor do próprio terminal no ponto de inserção em vez de um bloco desenhado. O cursor respeita as configurações de piscar, 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 perguntar |

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 pare de ler, como um painel do tmux em modo de controle pausado 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 |

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 definida, `claude auth login` troca este 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 ao `/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 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 |

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 erros de diagnóstico do exportador OpenTelemetry no stderr. Por padrão, esses erros aparecem apenas 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 para atualizar cabeçalhos dinâmicos do OpenTelemetry, em milissegundos (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 o exportador OpenTelemetry concluir 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 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 dos arquivos sincronizados até que `p4 edit` os abra. Isso impede que o Claude Code contorne o rastreamento 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, isto 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` |

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 [As 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 na forma abreviada `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 de 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 desses diretórios na inicialização e usa plugins pré-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, e para respeitar, 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 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 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. 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 |

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` | Executa 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 fornecido como um 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 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` os 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 |

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) para a conversa principal: seus turnos interativos, de `-p` e do SDK, mais os auxiliares executados em linha 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 rastreamento W3C quando `ANTHROPIC_BASE_URL` apontar 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 conectado diretamente à 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 modelos em seu nome. Quando definida, o Claude Code ignora variáveis de seleção de provedor, de endpoint e de 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), seja qual for 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, Agent Platform do Google Cloud e Microsoft Foundry, para que a telemetria siga 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 em 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 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 para agentes de longa duração podem defini-la para que uma reinicialização com 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 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 |

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 ao 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 sem supervisão, 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 um proveniente 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 do 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, 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 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 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 substring, 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 |

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 eventos da roda. Defina como `3` para corresponder ao `vim` se o seu terminal enviar um evento de roda por clique sem amplificação. Ignorada no terminal da IDE JetBrains, onde 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 pelo 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 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 |

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, aumentado 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 |

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 aos hooks e ao Bash. Em `--continue` ou `--resume` sem um ID explícito, ele pode receber, em vez disso, o ID inicial da inicialização. 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 `bash` ou `zsh` funcional, o Claude Code o ignora e recorre à detecção automática. A detecção automática usa o seu `$SHELL` quando ele aponta para `bash` ou `zsh`; caso contrário, escolhe o primeiro `zsh` e depois `bash` funcional encontrado no seu `PATH` e nos 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 de [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 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 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, 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. 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) |

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 ativariam. O conjunto completo de ferramentas, hooks, 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 do lado do cliente para [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 de credenciais resolvidas a partir da cadeia de provedores de credenciais padrão 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 falha na verificação de disponibilidade do [modo rápido](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) como disponível, para redes que bloqueiam a requisição direta da verificação a `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) 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 do 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 na [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) lembram, nesta máquina, quais modelos elas constataram 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 não gravar o histórico de prompts e as 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 script |

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 a Agent Platform do Google Cloud (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 precisar legitimamente 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 [equipe de agentes](/docs/pt/agent-teams#specify-teammates-and-models) e agentes de [fluxo de trabalho](/docs/pt/workflows) que não recebem um modelo de outra forma. Aceita um alias como `haiku` ou um nome de modelo completo. 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 sem definição. 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 fluxo 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 |

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

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 dos subprocessos que o Claude Code inicia, como comandos Bash, hooks e servidores MCP stdio. A limpeza reconhece uma credencial pelo nome da variável ou pelo seu valor e mantém tokens do GitHub e configurações de proxy. Consulte [O que a limpeza do ambiente de subprocessos remove](#what-the-subprocess-environment-scrub-removes). `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 os 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 invoca essa skill. Requer autenticação do 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) em `~/.claude/skills/synced/` e as ressincronizam aproximadamente a cada 10 minutos sem esta variável, então defina-a apenas quando uma execução com `-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 com `-p` com esta variável definida. O nome da 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 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 invoca essa skill |

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 pré-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 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 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 |

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 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 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 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**, ao contrário da maioria das variáveis liga/desliga; 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 |

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 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 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 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, sozinhos 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_TRANSCRIPT_LOCAL_GC` | Defina como `1` para limitar o quanto cresce o [arquivo de transcrição](/docs/pt/sessions#where-transcripts-are-stored) de uma sessão longa de `-p` ou do Agent SDK. Após cada compactação, quando o arquivo for maior que 5 MB, o Claude Code remove o histórico anterior a essa compactação. Retomar a sessão restaura a mesma conversa, quer o arquivo tenha sido reduzido ou não. Defina-a no ambiente a partir do qual você inicia o Claude Code, já que um bloco `env` de configurações não pode ativá-la. Requer Claude Code v2.1.287 ou posterior |

411| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usar o [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) |413| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Prazo em milissegundos antes que o Claude Code cancele uma caixa de diálogo que ele encaminha a um cliente remoto, como um host do [Remote Control](/docs/pt/remote-control) ou do SDK, ou a caixa de 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 |

412| `CLAUDE_CODE_USE_BEDROCK` | Usar o [Amazon Bedrock](/docs/pt/amazon-bedrock) |414| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usar [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) |

413| `CLAUDE_CODE_USE_FOUNDRY` | Usar o [Microsoft Foundry](/docs/pt/microsoft-foundry) |415| `CLAUDE_CODE_USE_BEDROCK` | Usar [Amazon Bedrock](/docs/pt/amazon-bedrock) |

416| `CLAUDE_CODE_USE_FOUNDRY` | Usar [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 |417| `CLAUDE_CODE_USE_MANTLE` | Usar 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 |418| `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 não estiver disponível ou estiver 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) |419| `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, da 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 PowerShell nativamente em vez de roteá-los 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) |420| `CLAUDE_CODE_USE_VERTEX` | Usar a [Agent Platform do Google Cloud](/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 |421| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Defina como o número de milissegundos durante os quais [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior) mantém em cache a resposta de cada URL buscada. O padrão é `900000`, que corresponde 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 |422| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superior, em milissegundos, de quanto tempo [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior) espera o download de uma página, incluindo quaisquer redirecionamentos que ele segue. Um download que não tenha sido concluído até lá falha com um erro de prazo. O padrão é `300000`, que corresponde 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 |423| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` está definido como `1`, quanto tempo o Claude Code espera antes de cada lembrete para o Claude verificar [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 definido, 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 |424| `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 RAM. 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 |

425| `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, 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 |

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) |426| `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 |427| `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 |428| `CLAUDE_EFFORT` | Definida automaticamente em subprocessos da ferramenta Bash e em comandos de hook para 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 oferece suporte ao 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) |429| `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 API da Anthropic 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 uma paralisação ali mesmo enquanto pings de keep-alive estavam chegando. Para timeouts e como os temporizadores interagem, consulte [Streaming idle watchdogs](/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` |430| `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` |

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) |431| `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 paralisação que são executados junto com este, consulte [Streaming idle watchdogs](/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) |432| `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 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 |433| `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 |434| `CLAUDE_PID` | O Claude Code define esta variável como seu próprio ID de processo nos subprocessos que ele inicia: 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 nos 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 |435| `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 |436| `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 definir, 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) |437| `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 paralisada. 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 [Streaming idle watchdogs](/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) |438| `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 duração 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 |439| `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 |

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 |440| `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) |441| `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` |442| `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 |443| `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` |444| `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` |

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 |445| `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 de ativar/desativar; 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 |446| `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 |447| `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 com todos os nomes. O nome mais 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 |448| `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 continua 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 |449| `DISABLE_INSTALLATION_CHECKS` | Defina como `1` para desativar os avisos de instalação. Use somente ao gerenciar manualmente o local da instalação, pois isso pode mascarar problemas em 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) |450| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Defina como `1` para ocultar o comando `/install-github-app`. Já fica oculto ao usar provedores terceirizados (Amazon Bedrock, Agent Platform do Google Cloud 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) |451| `DISABLE_INTERLEAVED_THINKING` | Defina como `1` para impedir o envio do cabeçalho beta de interleaved-thinking. Útil quando seu gateway de LLM ou provedor não oferece suporte a [pensamento intercalado](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

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` |452| `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` |453| `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) |454| `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 |455| `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 |456| `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) |457| `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) |458| `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) |459| `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 de ativar/desativar; 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 [Turn telemetry off for your organization](/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 |460| `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 atualizar por conta própria |

457| `DISABLE_UPGRADE_COMMAND` | Defina como `1` para ocultar o comando `/upgrade` |461| `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 |462| `DO_NOT_TRACK` | Defina como `1` para desativar a telemetria, com o mesmo efeito de `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) |463| `ENABLE_BETA_TRACING_DETAILED` | Defina como `1`, junto com `BETA_TRACING_ENDPOINT`, para ativar o [tracing 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 |464| `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 conectados. Para desativar por projeto ou por organização, defina [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors) nas configurações |

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 |465| `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. 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 consomem [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 |466| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuada. Use `ENABLE_PROMPT_CACHING_1H` |

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` |467| `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 oferecem suporte a `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` |

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 |468| `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 de ativar/desativar; 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 terceirizado](/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 alternância 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` |469| `FORCE_AUTOUPDATE_PLUGINS` | Defina como `1` para forçar as atualizações automáticas de plugins mesmo quando o atualizador automático principal estiver 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 |470| `FORCE_HYPERLINK` | Defina como `1` para ativar hyperlinks OSC 8 clicáveis quando seu terminal oferecer suporte a eles, mas não for detectado automaticamente, ou como `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, então um valor como `false`, `no` ou `off` ativa os hyperlinks em vez de desativá-los. O [badge 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 badge 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` |471| `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 |472| `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 |473| `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 |474| `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) |475| `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 |476| `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 falhas 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 |477| `MAX_THINKING_TOKENS` | Orçamento fixo de tokens para [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 os 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 terceirizados](/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. 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` |478| `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 |479| `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 é 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 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 |480| `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 |

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 |481| `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 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 |482| `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 |483| `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 |

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

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) |485| `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 |486| `MCP_PROTOCOL_NEGOTIATION` | Somente no [runtime de cliente MCP v2](/docs/pt/mcp#mcp-client-runtimes), define se o Claude Code sonda os servidores quanto à 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 [MCP client runtimes](/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) |487| `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 |488| `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`, 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 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) |489| `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) |490| `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 |491| `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 este valor 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 |492| `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) |493| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite padrão do SDK do OpenTelemetry para o comprimento de valores 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 [Monitoring](/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) |494| `OTEL_LOG_ASSISTANT_RESPONSES` | Defina como `1` para incluir o texto da 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` 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 [Monitoring](/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) |495| `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. 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 [Monitoring](/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) |496| `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 embutidos truncados no limite de conteúdo, ou `file:<dir>` para gravar os corpos sem truncamento 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 [Monitoring](/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) |497| `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 conteúdo de ferramentas sob [suas próprias condições](/docs/pt/monitoring-usage#new-context-gates). Requer [tracing](/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 [Monitoring](/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) |498| `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 nos 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. 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 [Monitoring](/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) |499| `OTEL_LOG_USER_PROMPTS` | Defina como `1` para incluir o texto do prompt 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 [Monitoring](/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) |500| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Defina como `false` para excluir o UUID da conta dos atributos de métricas (padrão: incluído). Consulte [Monitoring](/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) |501| `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 [Monitoring](/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) |502| `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 [Repository attributes](/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) |503| `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 [Monitoring](/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) |504| `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 [Monitoring](/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) |505| `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 [Monitoring](/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 |506| `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 escala 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 |507| `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 agora lê o arquivo de saída de uma tarefa em segundo plano com `Read` |

504| `USE_BUILTIN_RIPGREP` | Defina como `0` para usar o `rg` instalado no sistema em vez do `rg` incluído com o Claude Code |508| `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 |509| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Sobrescreve a região do Claude 3.5 Haiku ao usar a Agent Platform do Google Cloud |

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

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


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

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

524 528 

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.529As 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 [Monitoring](/docs/pt/monitoring-usage) para detalhes de configuração.

526 530 

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.531Defina `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 de exportação, como `OTEL_METRIC_EXPORT_INTERVAL`, ainda se aplicam a partir das configurações de projeto e locais.

532 

533<h2 id="what-the-subprocess-environment-scrub-removes">

534 O que a limpeza do ambiente de subprocessos remove

535</h2>

536 

537Quando você define [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](#variables) como `1`, o Claude Code remove credenciais dos ambientes dos subprocessos que ele inicia, como comandos Bash, hooks e servidores MCP stdio. Isso reduz o que um ataque de injeção de prompt pode ler por meio de expansão do shell. O processo do Claude Code mantém as credenciais para suas próprias chamadas de API.

538 

539A limpeza reconhece uma credencial pelo nome da variável ou pelo formato do seu valor, portanto use-a como uma camada junto com [regras de permissão](/docs/pt/permissions) restritas, e não como o único controle.

540 

541A tabela mostra o que a limpeza faz com variáveis de exemplo:

542 

543| Variável de exemplo | O que a limpeza faz |

544| :- | :- |

545| `ANTHROPIC_API_KEY`, `AWS_SECRET_ACCESS_KEY` | Remove a variável |

546| `NPM_TOKEN`, `DB_PASSWORD` | Remove a variável, porque o nome parece uma credencial |

547| `DATABASE_URL` que contém uma senha | Remove a variável, porque o valor parece uma credencial |

548| `PIP_INDEX_URL` ou `NPM_CONFIG_REGISTRY` que contém uma senha | Mantém a URL e remove dela o nome de usuário e a senha |

549| `CLAUDE_CONFIG_DIR` | Remove a variável. Requer Claude Code v2.1.251 ou posterior |

550| `GITHUB_TOKEN`, `GH_TOKEN`, `GH_ENTERPRISE_TOKEN`, `GITHUB_ENTERPRISE_TOKEN` | Mantém a variável, para que o `gh` e os scripts que chamam a API do GitHub continuem funcionando |

551| `HTTP_PROXY`, `HTTPS_PROXY` | Mantém a variável, incluindo um [nome de usuário e senha na URL](/docs/pt/network-config#basic-authentication). O [sandbox](/docs/pt/sandboxing#network-isolation) pode definir essas variáveis por conta própria para comandos executados em sandbox |

552| `GIT_CONFIG_COUNT`, `GIT_CONFIG_KEY_<n>`, `GIT_CONFIG_VALUE_<n>` | Mantém a variável, seja qual for o seu conteúdo |

553| Um segredo cujo nome de variável e valor não parecem uma credencial | Mantém a variável |

554 

555Como a limpeza mantém o `GITHUB_TOKEN`, conceda a um job do GitHub Actions as `permissions` mais restritas de que ele precisa. Para remover um token do GitHub de comandos Bash executados em sandbox, adicione uma entrada `deny` em [`sandbox.credentials`](/docs/pt/sandboxing#protect-credentials).

556 

557Deixe a limpeza desativada se um subprocesso precisar de uma das variáveis removidas.

558 

559No Linux, a limpeza também executa subprocessos Bash em um namespace de PID isolado, para que eles não possam ler os ambientes dos processos do host por meio de `/proc`. Como efeito colateral, `ps`, `pgrep` e `kill` não conseguem ver nem enviar sinais para processos do host.

528 560 

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

530 Recursos que precisam de busca de feature-flag562 Recursos que precisam da busca de feature flags

531</h2>563</h2>

532 564 

533Claude Code ativa alguns recursos através de feature flags que busca da Anthropic. Claude Code pula essa busca nestas sessões:565O Claude Code ativa alguns recursos por meio de feature flags que ele busca na Anthropic. O Claude Code ignora essa busca nestas sessões:

534 566 

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

536* Uma sessão em um [provedor de terceiros](/docs/pt/third-party-integrations), como Amazon Bedrock, Claude Platform na AWS, Agent Platform do Google Cloud, ou Microsoft Foundry, a menos que uma plataforma host que incorpora Claude Code defina `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`568* Uma sessão em um [provedor de terceiros](/docs/pt/third-party-integrations), como Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud ou Microsoft Foundry, a menos que uma plataforma host que incorpora o Claude Code defina `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`

537* Uma sessão de [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway)569* Uma sessão do [Claude apps gateway](/docs/pt/claude-apps-gateway)

538 570 

539Com a busca desativada, você não pode:571Com a busca desativada, você não pode:

540 572 

541* Executar [`/auto-mode-setup`](/docs/pt/auto-mode-config#generate-environment-entries) para rascunhar entradas `autoMode.environment`573* Executar [`/auto-mode-setup`](/docs/pt/auto-mode-config#generate-environment-entries) para rascunhar entradas de `autoMode.environment`

542* Usar [Controle Remoto](/docs/pt/remote-control) com `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK` definido. Para `DISABLE_TELEMETRY` e `DO_NOT_TRACK`, consulte os [requisitos do Controle Remoto](/docs/pt/remote-control#requirements)574* Usar o [Remote Control](/docs/pt/remote-control) com `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ou `DISABLE_GROWTHBOOK` definidos. Para `DISABLE_TELEMETRY` e `DO_NOT_TRACK`, consulte os [requisitos do Remote Control](/docs/pt/remote-control#requirements)

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

544* Executar [`claude import` ou o comando `/import`](/docs/pt/cli-reference#cli-commands)576* Executar [`claude import` ou o comando `/import`](/docs/pt/cli-reference#cli-commands)

545* Executar [`/skill-doctor`](/docs/pt/skills#find-unused-skills) ou abrir seu relatório na aba **Stats** do `/plugin`577* Executar [`/skill-doctor`](/docs/pt/skills#find-unused-skills) ou abrir o relatório dele na aba **Stats** do `/plugin`

546* Sincronizar as [skills](/docs/pt/skills#where-synced-skills-load) e [plugins](/docs/pt/plugins/loading#synced-plugins) ativados para sua conta claude.ai em suas sessões de terminal578* Sincronizar as [skills](/docs/pt/skills#where-synced-skills-load) e os [plugins](/docs/pt/plugins/loading#synced-plugins) habilitados para sua conta do claude.ai nas suas sessões de terminal

547* Usar [a ferramenta advisor](/docs/pt/advisor#requirements)579* Usar [a ferramenta advisor](/docs/pt/advisor#requirements)

548* Ler ou responder a [comentários em um artefato](/docs/pt/artifacts#collect-comments-on-an-artifact)580* Ler ou responder a [comentários em um artefato](/docs/pt/artifacts#collect-comments-on-an-artifact)

549* Ter Claude lendo [o artefato público de outra organização](/docs/pt/artifacts#read-an-artifact-shared-with-you)581* Fazer o Claude ler [o artefato público de outra organização](/docs/pt/artifacts#read-an-artifact-shared-with-you)

550* Ter Claude Code sondar servidores de conector claude.ai ou servidores stdio para [revisão de protocolo MCP 2026-07-28](/docs/pt/mcp#mcp-client-runtimes) a menos que você defina `MCP_PROTOCOL_NEGOTIATION=auto`582* Fazer o Claude Code sondar servidores de conectores do claude.ai ou servidores stdio para a [revisão 2026-07-28 do protocolo MCP](/docs/pt/mcp#mcp-client-runtimes), a menos que você defina `MCP_PROTOCOL_NEGOTIATION=auto`

551* Obter a [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) por padrão para contas claude.ai e Console no Windows com Git Bash instalado; Claude Code roteia comandos shell através do Git Bash a menos que você defina `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. No Windows sem Git Bash, a ferramenta permanece ativada583* Obter a [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) por padrão para contas do claude.ai e do Console no Windows com o Git Bash instalado; o Claude Code encaminha os comandos de shell pelo Git Bash, a menos que você defina `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. No Windows sem o Git Bash, a ferramenta permanece ativada

552* Obter [feedback rascunhado por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior), que Claude Code ativa através de uma flag buscada584* Obter [feedback rascunhado pelo Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior), que o Claude Code ativa por meio de uma flag buscada

553* Ter Claude [tratar grandes colagens como texto colado em vez de texto digitado](/docs/pt/terminal-config#how-claude-treats-pasted-text); o conteúdo atrás de um espaço reservado `[Pasted text #N]` chega a Claude sem marcação585* Fazer o Claude [tratar colagens grandes como texto colado em vez de digitado](/docs/pt/terminal-config#how-claude-treats-pasted-text); o conteúdo por trás de um placeholder `[Pasted text #N]` chega ao Claude sem marcação

554* Ter Claude Code [excluir ferramentas MCP cujo esquema de entrada a API rejeitaria](/docs/pt/mcp#tools-with-invalid-input-schemas); ele envia o esquema mesmo assim, e uma solicitação que o inclui falha com [um erro 400 nomeando a ferramenta por sua posição](/docs/pt/errors#tool-input-schema-is-invalid)586* Fazer o Claude Code [excluir ferramentas MCP cujo esquema de entrada a API rejeitaria](/docs/pt/mcp#tools-with-invalid-input-schemas); ele envia o esquema mesmo assim, e uma requisição que o inclui falha com [um erro 400 que identifica a ferramenta pela sua posição](/docs/pt/errors#tool-input-schema-is-invalid)

555 587 

556<h3 id="first-session-after-an-install-or-upgrade">588<h3 id="first-session-after-an-install-or-upgrade">

557 Primeira sessão após uma instalação ou atualização589 Primeira sessão após uma instalação ou atualização

558</h3>590</h3>

559 591 

560Na sua primeira sessão após instalar Claude Code, ou atualizar para uma versão que adiciona um recurso, um [recurso com gate de flag](#features-that-need-feature-flag-fetching) pode estar faltando. Essa sessão também pode iniciar em um [modo de permissão](/docs/pt/permission-modes#which-mode-a-session-starts-in) diferente daquele em que suas sessões posteriores iniciam. Claude Code busca as flags durante essa sessão, então sua próxima sessão tem o recurso e o modo de permissão inicial usual.592Na sua primeira sessão após instalar o Claude Code, ou atualizar para uma versão que adiciona um recurso, um [recurso controlado por flag](#features-that-need-feature-flag-fetching) pode estar ausente. Essa sessão também pode iniciar em um [modo de permissão](/docs/pt/permission-modes#which-mode-a-session-starts-in) diferente do das suas sessões posteriores. Quando o Claude Code busca as flags durante essa sessão, ele as salva na máquina, de modo que sua próxima sessão nessa máquina tenha o recurso e o modo de permissão inicial habitual.

593 

594Após uma instalação nova, em uma sessão não interativa, como `claude -p`, o Agent SDK ou a extensão do VS Code, o Claude Code pode obter as flags antes de [escolher o modo de permissão inicial](/docs/pt/permission-modes#which-mode-a-session-starts-in), mas nem sempre espera por elas.

595 

596Em configurações como estas, as sessões após a primeira também iniciam sem flags buscadas recentemente:

597 

598* **Um ambiente limpo a cada execução**: se cada execução começa em um contêiner de CI, ou em qualquer outro ambiente sem as flags que uma sessão anterior salvou, cada execução é uma primeira sessão

599* **Um token de gateway sem chave de API**: se você se autentica com `ANTHROPIC_AUTH_TOKEN` e sem chave de API, e `ANTHROPIC_BASE_URL` aponta para um host diferente do da Anthropic, como um [gateway de LLM](/docs/pt/llm-gateway), o Claude Code não tem nenhuma credencial com a qual buscar as flags

561 600 

562Após uma instalação limpa, em uma sessão não interativa como `claude -p`, o Agent SDK, ou a extensão VS Code, Claude Code ainda pode pegar as flags antes de [escolher o modo de permissão inicial](/docs/pt/permission-modes#which-mode-a-session-starts-in).601Para escolher o modo de permissão em que as sessões nessas configurações iniciam, consulte [Iniciar em um modo de permissão diferente](/docs/pt/permission-modes#start-in-a-different-mode).

563 602 

564<h2 id="see-also">603<h2 id="see-also">

565 Veja também604 Veja também

errors.md +19 −1

Details

366| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |366| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |

367| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |367| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |

368| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |368| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |

369| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Configuration warnings](#denying-bash-also-turns-off-the-powershell-tool) |

369| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |370| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |

370| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |371| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |

371| `Stale sandbox mask files left by a killed session` | [Configuration warnings](#stale-sandbox-mask-files-left-by-a-killed-session) |372| `Stale sandbox mask files left by a killed session` | [Configuration warnings](#stale-sandbox-mask-files-left-by-a-killed-session) |


846**O que fazer:**847**O que fazer:**

847 848 

848* Em Pro e Max, aumente seu limite de gastos mensais em [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai, ou execute `/usage-credits`849* Em Pro e Max, aumente seu limite de gastos mensais em [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai, ou execute `/usage-credits`

849* Em Team e Enterprise, aumente o limite em [**Admin settings > Usage**](https://claude.ai/admin-settings/usage) se você gerencia a cobrança, ou peça a um administrador. `/usage-credits` envia essa solicitação ao seu administrador para você850* Em Team e Enterprise, aumente o limite em [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) se você gerencia o faturamento, ou peça a um administrador. `/usage-credits` envia essa solicitação ao seu administrador para você

850* Para o limite de um canal, peça a um proprietário da organização ou ao gerenciador do canal para aumentá-lo em claude.ai. Veja [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) na documentação Claude Tag851* Para o limite de um canal, peça a um proprietário da organização ou ao gerenciador do canal para aumentá-lo em claude.ai. Veja [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) na documentação Claude Tag

851* Se a mensagem nomear um horário de reset para a janela do seu plano, você pode aguardar em vez disso852* Se a mensagem nomear um horário de reset para a janela do seu plano, você pode aguardar em vez disso

852* Execute `/usage` para ver as janelas do seu plano e quando cada uma é resetada853* Execute `/usage` para ver as janelas do seu plano e quando cada uma é resetada


5638 5639 

5639Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr, então a saída lida por máquina fica limpa. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`. Antes da v2.1.246, Claude Code aceitava essas regras sem aviso.5640Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr, então a saída lida por máquina fica limpa. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`. Antes da v2.1.246, Claude Code aceitava essas regras sem aviso.

5640 5641 

5642<h3 id="denying-bash-also-turns-off-the-powershell-tool">

5643 Negar Bash também desativa a ferramenta PowerShell

5644</h3>

5645 

5646Você removeu a ferramenta Bash inteira, por exemplo com `--disallowedTools Bash` ou com uma [regra deny](/docs/pt/permissions#match-all-uses-of-a-tool) `Bash` ou `Bash(*)` simples em um de seus arquivos de configurações. No Windows com Git Bash instalado, [negar Bash também desativa a ferramenta PowerShell](/docs/pt/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool), então a sessão inicia sem nenhuma ferramenta de shell. Claude Code imprime este aviso na inicialização:

5647 

5648```text theme={null}

5649Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.

5650```

5651 

5652**O que fazer:**

5653 

5654* Para que Claude use PowerShell, defina [`CLAUDE_CODE_USE_POWERSHELL_TOOL`](/docs/pt/env-vars) como `1` em seu ambiente ou no bloco `env` de um arquivo de configurações, como [Ativar a ferramenta PowerShell](/docs/pt/tools-reference#enable-the-powershell-tool) mostra. A ferramenta PowerShell então permanece ativada junto com sua regra deny de Bash.

5655* Para bloquear comandos específicos em vez da ferramenta inteira, substitua a entrada `Bash` simples por regras com escopo como `Bash(git push *)` no mesmo arquivo de configurações ou flag. Claude mantém a ferramenta Bash, e a ferramenta PowerShell permanece desativada até que você também defina a variável ou adicione uma [regra de permissão `PowerShell`](/docs/pt/permissions#powershell) com escopo.

5656 

5657Em uma [sessão em segundo plano](/docs/pt/agent-view) ou com `--output-format json` ou `stream-json`, Claude Code escreve o aviso no log de depuração em vez de stderr. Execute com `--debug` para capturá-lo em `~/.claude/debug/<session-id>.txt`. Antes da v2.1.287, Claude Code desativava a ferramenta PowerShell da mesma forma sem imprimir um aviso.

5658 

5641<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">5659<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">

5642 crossSessionInbound deve ser um de accept, hold, refuse5660 crossSessionInbound deve ser um de accept, hold, refuse

5643</h3>5661</h3>

fast-mode.md +2 −2

Details

138* **Apenas API Anthropic ou assinatura**: o modo rápido está disponível através da API do Anthropic Console e para planos de assinatura Claude usando créditos de uso. Não está disponível no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform na AWS. As organizações do Console também devem ter [acesso ao modo rápido provisionado](#enable-fast-mode-for-your-organization).138* **Apenas API Anthropic ou assinatura**: o modo rápido está disponível através da API do Anthropic Console e para planos de assinatura Claude usando créditos de uso. Não está disponível no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform na AWS. As organizações do Console também devem ter [acesso ao modo rápido provisionado](#enable-fast-mode-for-your-organization).

139* **Créditos de uso ativados para planos de assinatura**: em um plano Pro, Max, Team ou Enterprise, sua conta deve ter [créditos de uso](/docs/pt/costs#add-usage-credits-to-your-subscription) ativados, o que permite cobrança além do uso incluído no seu plano. Até que estejam ativados, `/fast` mostra "Fast mode requires usage credits". Como você os ativa depende do seu plano:139* **Créditos de uso ativados para planos de assinatura**: em um plano Pro, Max, Team ou Enterprise, sua conta deve ter [créditos de uso](/docs/pt/costs#add-usage-credits-to-your-subscription) ativados, o que permite cobrança além do uso incluído no seu plano. Até que estejam ativados, `/fast` mostra "Fast mode requires usage credits". Como você os ativa depende do seu plano:

140 * Em Pro e Max, ative-os na seção **Usage credits** de [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai, ou execute `/usage-credits` para abrir essa página.140 * Em Pro e Max, ative-os na seção **Usage credits** de [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai, ou execute `/usage-credits` para abrir essa página.

141 * Em Team e Enterprise, um membro com acesso de cobrança os ativa para a organização em [**Admin settings > Usage**](https://claude.ai/admin-settings/usage), e um membro sem acesso executa `/usage-credits` para enviar uma solicitação aos administradores da organização.141 * Em Team e Enterprise, um membro com acesso ao faturamento os ativa para a organização em [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), e um membro sem esse acesso executa `/usage-credits` para enviar uma solicitação aos administradores da organização.

142 142 

143<Note>143<Note>

144 O uso do modo rápido é cobrado diretamente nos créditos de uso, mesmo que você tenha uso restante no seu plano.144 O uso do modo rápido é cobrado diretamente nos créditos de uso, mesmo que você tenha uso restante no seu plano.


165* **Console** (clientes de API): um administrador o ativa em [Preferências do Claude Code](https://platform.claude.com/claude-code/preferences). O modo rápido está em [visualização de pesquisa](#research-preview), portanto sua organização também deve ter acesso ao modo rápido provisionado antes que as solicitações de modo rápido sejam bem-sucedidas. Para obter acesso, entre em contato com seu gerente de conta ou junte-se à lista de espera, conforme descrito em [modo rápido na API Claude](https://platform.claude.com/docs/en/build-with-claude/fast-mode).165* **Console** (clientes de API): um administrador o ativa em [Preferências do Claude Code](https://platform.claude.com/claude-code/preferences). O modo rápido está em [visualização de pesquisa](#research-preview), portanto sua organização também deve ter acesso ao modo rápido provisionado antes que as solicitações de modo rápido sejam bem-sucedidas. Para obter acesso, entre em contato com seu gerente de conta ou junte-se à lista de espera, conforme descrito em [modo rápido na API Claude](https://platform.claude.com/docs/en/build-with-claude/fast-mode).

166 166 

167 Sem acesso provisionado, a API rejeita cada solicitação de modo rápido com um 429, e Claude Code trata cada rejeição como um [limite de taxa do modo rápido](#handle-rate-limits). Diferentemente do cooldown de um limite de taxa, as rejeições continuam até que o acesso seja provisionado.167 Sem acesso provisionado, a API rejeita cada solicitação de modo rápido com um 429, e Claude Code trata cada rejeição como um [limite de taxa do modo rápido](#handle-rate-limits). Diferentemente do cooldown de um limite de taxa, as rejeições continuam até que o acesso seja provisionado.

168* **Claude AI** (Team e Enterprise): um proprietário o ativa em [Admin Settings > Claude Code](https://claude.ai/admin-settings/claude-code)168* **Claude AI** (Team e Enterprise): um Owner o ativa em [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code)

169 169 

170Outra opção para desativar completamente o modo rápido é definir `CLAUDE_CODE_DISABLE_FAST_MODE=1`. Consulte [Variáveis de ambiente](/docs/pt/env-vars).170Outra opção para desativar completamente o modo rápido é definir `CLAUDE_CODE_DISABLE_FAST_MODE=1`. Consulte [Variáveis de ambiente](/docs/pt/env-vars).

171 171 

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.

Details

295 295 

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

297 297 

298<h3 id="when-your-organization-enforces-a-model-allowlist">

299 Quando sua organização aplica uma allowlist de modelos

300</h3>

301 

302Se você definir [`enforceAvailableModels`](/docs/pt/model-config#enforce-the-allowlist-for-the-default-model) nas configurações gerenciadas, as verificações de modelo na inicialização usam apenas modelos que sua lista `availableModels` permite. Isso requer Claude Code v2.1.287 ou posterior. Uma lista sem `enforceAvailableModels` não restringe essas verificações.

303 

304As verificações comparam cada entrada com o ID de modelo que enviariam à Plataforma de Agentes, então escreva a lista com esses IDs. Este exemplo permite Opus 4.8 e Sonnet 4.5:

305 

306```json theme={null}

307{

308 "availableModels": ["claude-opus-4-8", "claude-sonnet-4-5@20250929"],

309 "enforceAvailableModels": true

310}

311```

312 

313Para aliases, prefixos de versão e entradas `modelOverrides`, consulte [Fixar modelos para implantações de terceiros](/docs/pt/model-config#pin-models-for-third-party-deployments).

314 

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

299 Quando um modelo é desativado durante a sessão316 Quando um modelo é desativado durante a sessão

300</h3>317</h3>

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 

managed-mcp.md +61 −29

Details

282 282 

283Listas de permissão e bloqueio filtram quais servidores configurados podem ser carregados. Elas não são um registro: um servidor ainda precisa ser adicionado por um usuário, um plugin ou sua organização antes que qualquer uma das listas se aplique a ele.283Listas de permissão e bloqueio filtram quais servidores configurados podem ser carregados. Elas não são um registro: um servidor ainda precisa ser adicionado por um usuário, um plugin ou sua organização antes que qualquer uma das listas se aplique a ele.

284 284 

285Servidores que sua organização entrega através de `managedMcpServers` carregam sem uma entrada de lista de permissão, e [Como um servidor é avaliado](#how-a-server-is-evaluated) cobre servidores `managed-mcp.json`. A lista de bloqueio se aplica a todos os servidores independentemente de onde vieram, exceto entradas `type: "sdk"` em processo.285Servidores que sua organização entrega através de `managedMcpServers` carregam sem uma entrada na allowlist, e [Servidores que pulam a verificação da allowlist](#servers-that-skip-the-allowlist-check) cobre servidores `managed-mcp.json`. A denylist se aplica a todos os servidores independentemente de onde vieram, exceto entradas `type: "sdk"` em processo.

286 286 

287Para implantar servidores para usuários, use [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json) ou [`managedMcpServers`](#provide-servers-through-managed-settings). Ambas as listas também filtram servidores passados com a flag CLI [`--mcp-config`](/docs/pt/cli-reference#cli-flags), exceto entradas `type: "sdk"` em processo; `--strict-mcp-config` limita quais arquivos de configuração carregam e não contorna nenhuma das duas listas.287Para implantar servidores para usuários, use [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json) ou [`managedMcpServers`](#provide-servers-through-managed-settings). Ambas as listas também filtram servidores passados com a flag CLI [`--mcp-config`](/docs/pt/cli-reference#cli-flags), exceto entradas `type: "sdk"` em processo; `--strict-mcp-config` limita quais arquivos de configuração carregam e não contorna nenhuma das duas listas.

288 288 


308| :- | :- | :- |308| :- | :- | :- |

309| `serverUrl` | Uma URL de servidor remoto, exata ou com wildcards `*` | Servidores HTTP e SSE |309| `serverUrl` | Uma URL de servidor remoto, exata ou com wildcards `*` | Servidores HTTP e SSE |

310| `serverCommand` | O comando exato e argumentos que iniciam um servidor stdio | Servidores stdio |310| `serverCommand` | O comando exato e argumentos que iniciam um servidor stdio | Servidores stdio |

311| `serverName` | O rótulo atribuído pelo usuário. Correspondência exata apenas; wildcards não são expandidos | Qualquer tipo, mas veja o Aviso abaixo |311| `serverName` | O rótulo atribuído pelo usuário. Correspondência exata apenas; wildcards não são expandidos | Qualquer tipo, mas veja [Como entradas `serverName` correspondem](#how-servername-entries-match) |

312 312 

313Deixar `allowedMcpServers` indefinido é diferente de defini-lo como um array vazio:313Deixar `allowedMcpServers` indefinido é diferente de defini-lo como um array vazio:

314 314 

315| Configuração | Indefinido (padrão) | Array vazio `[]` | Preenchido |315| Configuração | Indefinido (padrão) | Array vazio `[]` | Preenchido |

316| :- | :- | :- | :- |316| :- | :- | :- | :- |

317| `allowedMcpServers` | Todos os servidores permitidos | Nenhum servidor permitido, exceto [aqueles que pulam a verificação de lista de permissão](#how-a-server-is-evaluated) | Apenas servidores correspondentes permitidos, exceto [aqueles que pulam a verificação de lista de permissão](#how-a-server-is-evaluated) |317| `allowedMcpServers` | Todos os servidores permitidos | Nenhum servidor permitido, exceto [aqueles que pulam a verificação da allowlist](#servers-that-skip-the-allowlist-check) | Apenas servidores correspondentes permitidos, exceto [aqueles que pulam a verificação da allowlist](#servers-that-skip-the-allowlist-check) |

318| `deniedMcpServers` | Nenhum servidor bloqueado | Nenhum servidor bloqueado | Servidores correspondentes bloqueados |318| `deniedMcpServers` | Nenhum servidor bloqueado | Nenhum servidor bloqueado | Servidores correspondentes bloqueados |

319 319 

320Veja [Entradas inválidas em configurações gerenciadas](/docs/pt/managed-settings#invalid-entries-in-managed-settings) para o que acontece quando uma entrada falha na validação do esquema.320Veja [Entradas inválidas em configurações gerenciadas](/docs/pt/managed-settings#invalid-entries-in-managed-settings) para o que acontece quando uma entrada falha na validação do esquema.

321 321 

322<h4 id="how-servername-entries-match">

323 Como entradas `serverName` correspondem

324</h4>

325 

326Uma entrada `serverName` corresponde exatamente ao rótulo atribuído pelo usuário, sem wildcards.

327 

322<Warning>328<Warning>

323 Uma entrada `serverName`, em qualquer uma das listas, não é um controle de segurança. O nome é o rótulo que um usuário atribui ao executar `claude mcp add` ou editar um arquivo de configuração, não o servidor subjacente, então um usuário pode chamar qualquer servidor de `github`. Para conectores claude.ai, o nome é o nome de exibição retornado por claude.ai, que pode mudar. Para impor quais servidores realmente executam, adicione entradas `serverCommand` ou `serverUrl`.329 Uma entrada `serverName`, em qualquer uma das listas, não é um controle de segurança. O nome é o rótulo que um usuário atribui ao executar `claude mcp add` ou editar um arquivo de configuração, não o servidor subjacente, então um usuário pode chamar qualquer servidor de `github`. Para conectores claude.ai, o nome é o nome de exibição retornado por claude.ai, que pode mudar. Para impor quais servidores realmente executam, adicione entradas `serverCommand` ou `serverUrl`.

324</Warning>330</Warning>


330 336 

331Para desativar todos os conectores claude.ai que Claude Code busca a si mesmo, veja [`disableClaudeAiConnectors`](/docs/pt/mcp#disable-claude-ai-connectors).337Para desativar todos os conectores claude.ai que Claude Code busca a si mesmo, veja [`disableClaudeAiConnectors`](/docs/pt/mcp#disable-claude-ai-connectors).

332 338 

333<h3 id="how-a-server-is-evaluated">339<h4 id="how-servercommand-entries-match">

334 Como um servidor é avaliado340 Como entradas `serverCommand` correspondem

335</h3>341</h4>

336 

337Antes de carregar um servidor, incluindo um de `managed-mcp.json`, Claude Code executa os três verificações abaixo em ordem. Ele as executa novamente quando um usuário reconecta um servidor ou ativa um desativado em `/mcp`. Servidores `type: "sdk"` em processo, que o [aplicativo que iniciou a sessão registra](/docs/pt/mcp#how-connectors-reach-claude-code), pulam todos os três.

338 

3391. **Mescle as listas.** Entradas de lista de permissão e bloqueio de todos os escopos de configurações se combinam em uma lista de permissão e uma lista de bloqueio. Quando `allowManagedMcpServersOnly` é `true`, apenas a lista de permissão gerenciada é mantida; a lista de bloqueio sempre se mescla de todos os escopos. Quando mais de uma fonte gerenciada está presente, [Chaves lidas de todas as fontes de administrador](/docs/pt/managed-settings#keys-read-from-every-admin-source) diz qual delas fornece as listas do escopo gerenciado.

3402. **Verifique a lista de bloqueio.** Um servidor que corresponde a qualquer entrada de lista de bloqueio, por URL, comando ou nome, é bloqueado. Nada substitui uma correspondência de lista de bloqueio.

3413. **Verifique a lista de permissão.** Se `allowedMcpServers` não estiver definido em nenhum lugar, todos os servidores que passaram na lista de bloqueio carregam. Se estiver definido, o que o servidor deve corresponder depende de seu tipo, mostrado na tabela abaixo.

342 

343 Três grupos de servidores pulam essa verificação:

344 342 

345 * Os próprios servidores da organização: toda entrada `managedMcpServers`, e qualquer entrada `managed-mcp.json` cujos valores não usam expansão `${VAR}`.343Uma entrada `serverCommand` contém o comando e seus argumentos como um único array, como em `{ "serverCommand": ["npx", "-y", "server"] }`. Claude Code compara esse array com o comando e os argumentos na configuração do servidor:

346 * Servidores integrados, como Claude no Chrome, o servidor `ide` que Claude Code se conecta em um IDE VS Code ou JetBrains em execução, e servidores que a própria CLI configura.

347 * Ferramentas Slack de uma sessão [Claude Tag](/docs/pt/claude-tag): os servidores que ela usa para ler a thread e postar suas respostas carregam sem uma entrada de lista de permissão.

348 344 

349 Um servidor `managed-mcp.json` que usa expansão `${VAR}` em seu comando, argumentos, `env`, URL ou cabeçalhos ainda é verificado. Assim como todos os servidores que um usuário, um plugin, ou claude.ai adiciona, e todos os servidores que um usuário passa com `--mcp-config`.345* **Comandos correspondem exatamente.** Cada argumento, em ordem. `["npx", "-y", "server"]` não corresponde a `["npx", "server"]` ou `["npx", "-y", "server", "--flag"]`.

346* **O bloco `env` não é comparado.** `["node", "server.js"]` corresponde a um servidor que executa esse comando com quaisquer valores `env`. Algumas variáveis de ambiente mudam o que `node` carrega na inicialização. Para definir os valores `env` você mesmo, defina o servidor em [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json).

350 347 

351| Tipo de servidor | Permitido quando corresponde |348<h4 id="how-serverurl-entries-match">

352| :- | :- |349 Como entradas `serverUrl` correspondem

353| Remoto (HTTP ou SSE) | Uma entrada `serverUrl`. Uma correspondência `serverName` conta apenas quando a lista de permissão não contém entradas `serverUrl` |350</h4>

354| Stdio | Uma entrada `serverCommand`. Uma correspondência `serverName` conta apenas quando a lista de permissão não contém entradas `serverCommand` |

355 351 

356Três regras de correspondência se aplicam dentro dessas verificações:352URLs suportam wildcards `*` em qualquer lugar do padrão, incluindo o esquema. A correspondência de nome de host não diferencia maiúsculas de minúsculas e ignora um ponto FQDN à direita, então `https://Mcp.Example.com/*` corresponde a `https://mcp.example.com/api`. Caminhos permanecem sensíveis a maiúsculas e minúsculas.

357 353 

358* **Comandos correspondem exatamente.** Cada argumento, em ordem. `["npx", "-y", "server"]` não corresponde a `["npx", "server"]` ou `["npx", "-y", "server", "--flag"]`.354A tabela mostra o que padrões comuns permitem:

359* **Valores `serverCommand` e `serverUrl` se expandem antes de corresponder.** Tanto a entrada de política quanto o valor configurado do servidor passam por expansão [`${VAR}` e `${VAR:-default}`](/docs/pt/mcp#environment-variable-expansion-in-mcp-json), então uma entrada escrita como `["${HOME}/bin/server"]` corresponde a uma configuração de servidor que usa a mesma referência ou o caminho expandido. No Windows, referencie uma variável de ambiente que está definida lá, como `${USERPROFILE}` em vez de `${HOME}`. Valores `serverName` correspondem literalmente e nunca se expandem. Os dois lados leem ambientes diferentes; [Como entradas de política se expandem](#how-policy-entries-expand) cobre qual, e como entradas de lista de permissão e bloqueio diferem.

360* **URLs suportam wildcards `*`** em qualquer lugar do padrão, incluindo o esquema. A correspondência de nome de host não diferencia maiúsculas de minúsculas e ignora um ponto FQDN à direita, então `https://Mcp.Example.com/*` corresponde a `https://mcp.example.com/api`. Caminhos permanecem sensíveis a maiúsculas e minúsculas.

361 355 

362| Padrão | Permite |356| Padrão | Permite |

363| :- | :- |357| :- | :- |


368| `*://mcp.example.com/*` | Qualquer esquema para um domínio específico |362| `*://mcp.example.com/*` | Qualquer esquema para um domínio específico |

369 363 

370<h4 id="how-policy-entries-expand">364<h4 id="how-policy-entries-expand">

371 Como entradas de política se expandem365 Variáveis de ambiente em entradas `serverCommand` e `serverUrl`

372</h4>366</h4>

373 367 

374O valor configurado do servidor se expande a partir do ambiente do processo ativo, como o resto de `.mcp.json`. Uma entrada de política se expande a partir de um ambiente fixado em vez disso, então uma variável definida por um projeto ou arquivo de configurações do usuário não pode mudar o que uma entrada de lista de permissão significa. Como uma entrada de política ainda depende do valor do shell de inicialização para qualquer variável que ela referencia, use URLs e comandos literais para entradas que você depende para imposição.368Valores `serverCommand` e `serverUrl` se expandem antes da correspondência. Tanto a entrada de política quanto o valor configurado do servidor passam por [expansão `${VAR}` e `${VAR:-default}`](/docs/pt/mcp#environment-variable-expansion-in-mcp-json), então uma entrada escrita como `["${HOME}/bin/server"]` corresponde a uma configuração de servidor que usa a mesma referência ou o caminho expandido. Valores `serverName` correspondem literalmente e nunca se expandem.

369 

370Os dois lados leem ambientes diferentes:

371 

372* **O valor configurado do servidor**: se expande a partir do ambiente do processo ativo, como o resto de `.mcp.json`

373* **Uma entrada de política**: se expande a partir de um ambiente fixado, então uma variável definida por um projeto ou arquivo de configurações do usuário não pode mudar o que uma entrada da allowlist significa

374 

375Como uma entrada de política ainda depende do valor do shell de inicialização para qualquer variável que ela referencia, use URLs e comandos literais para entradas das quais você depende para imposição.

376 

377No Windows, referencie uma variável de ambiente que está definida lá, como `${USERPROFILE}` em vez de `${HOME}`.

378 

379As duas listas se expandem de forma diferente:

375 380 

376| Lista de entradas | Se expande de | Expansão que mudaria o esquema, host ou escopo de caminho de uma entrada de URL |381| Lista de entradas | Se expande de | Expansão que mudaria o esquema, host ou escopo de caminho de uma entrada de URL |

377| - | - | - |382| - | - | - |

378| `allowedMcpServers` | O ambiente com o qual Claude Code iniciou, mais valores `env` de configurações gerenciadas | Claude Code ignora a entrada |383| `allowedMcpServers` | O ambiente com o qual Claude Code iniciou, mais valores `env` de configurações gerenciadas | Claude Code ignora a entrada |

379| `deniedMcpServers` | O mesmo, e uma variável sem valor de inicialização e sem `:-default` preenche a partir de arquivos de configurações fora do repositório, como configurações de usuário ou gerenciadas, que apenas ampliam o que a entrada corresponde | A entrada ainda corresponde |384| `deniedMcpServers` | O mesmo, e uma variável sem valor de inicialização e sem `:-default` preenche a partir de arquivos de configurações fora do repositório, como configurações de usuário ou gerenciadas, que apenas ampliam o que a entrada corresponde | A entrada ainda corresponde |

380 385 

381Requer Claude Code v2.1.219 ou posterior.386O ambiente fixado e as regras nesta tabela requerem Claude Code v2.1.219 ou posterior.

387 

388<h3 id="how-a-server-is-evaluated">

389 Como um servidor é avaliado

390</h3>

391 

392Antes de carregar um servidor, incluindo um de `managed-mcp.json`, Claude Code executa as três verificações abaixo em ordem. Ele as executa novamente quando um usuário reconecta um servidor ou reativa um desativado em `/mcp`. Servidores `type: "sdk"` em processo, que o [aplicativo que iniciou a sessão registra](/docs/pt/mcp#how-connectors-reach-claude-code), pulam todas as três.

393 

3941. **Mescle as listas.** Entradas de allowlist e denylist de todos os escopos de configurações se combinam em uma allowlist e uma denylist. Quando `allowManagedMcpServersOnly` é `true`, apenas a allowlist gerenciada é mantida; a denylist sempre se mescla de todos os escopos. Quando mais de uma fonte gerenciada está presente, [Chaves lidas de todas as fontes de administrador](/docs/pt/managed-settings#keys-read-from-every-admin-source) diz quais delas fornecem as listas do escopo gerenciado.

3952. **Verifique a denylist.** Um servidor que corresponde a qualquer entrada da denylist, por URL, comando ou nome, é bloqueado. Nada sobrescreve uma correspondência da denylist.

3963. **Verifique a allowlist.** [Alguns servidores pulam essa verificação](#servers-that-skip-the-allowlist-check). Se `allowedMcpServers` não estiver definido em nenhum lugar, todos os servidores que passaram pela denylist carregam. Se estiver definido, o que o servidor deve corresponder depende de seu tipo, mostrado na tabela abaixo.

397 

398| Tipo de servidor | Permitido quando corresponde |

399| :- | :- |

400| Remoto (HTTP ou SSE) | Uma entrada `serverUrl`. Uma correspondência `serverName` conta apenas quando a allowlist não contém entradas `serverUrl` |

401| Stdio | Uma entrada `serverCommand`. Uma correspondência `serverName` conta apenas quando a allowlist não contém entradas `serverCommand` |

402 

403<h4 id="servers-that-skip-the-allowlist-check">

404 Servidores que pulam a verificação da allowlist

405</h4>

406 

407Três grupos de servidores pulam a verificação da allowlist, além dos servidores `type: "sdk"` em processo que pulam [todas as três verificações](#how-a-server-is-evaluated):

408 

409* Os próprios servidores da organização: toda entrada `managedMcpServers`, e qualquer entrada `managed-mcp.json` cujos valores não usam expansão `${VAR}`.

410* Servidores integrados, como Claude no Chrome, o servidor `ide` ao qual Claude Code se conecta em um IDE VS Code ou JetBrains em execução, e servidores que a própria CLI configura.

411* Ferramentas Slack de uma sessão [Claude Tag](/docs/pt/claude-tag): os servidores que ela usa para ler a thread e postar suas respostas carregam sem uma entrada na allowlist.

412 

413Um servidor `managed-mcp.json` que usa expansão `${VAR}` em seu comando, argumentos, `env`, URL ou cabeçalhos ainda é verificado. Claude Code também verifica todos os servidores que um usuário, um plugin ou claude.ai adiciona, e todos os servidores que um usuário passa com `--mcp-config`.

382 414 

383<h3 id="example-configuration">415<h3 id="example-configuration">

384 Configuração de exemplo416 Configuração de exemplo

Details

186 186 

187As chaves entre fontes incluem:187As chaves entre fontes incluem:

188 188 

189* `sandbox.network.allowManagedDomainsOnly` e `sandbox.filesystem.allowManagedReadPathsOnly`: um `true` em qualquer fonte de administrador ativa o bloqueio. Enquanto um bloqueio está ativo, Claude Code une a lista de permissões que bloqueia, `sandbox.network.allowedDomains` junto com regras de permissão `WebFetch(domain:...)`, ou `sandbox.filesystem.allowRead`, em cada fonte de administrador. Sem o bloqueio, Claude Code trata a lista de permissões como qualquer outra chave, então sob `"first-wins"` a lista de permissões de uma fonte de administrador não selecionada é ignorada189* `sandbox.network.allowManagedDomainsOnly` e `sandbox.filesystem.allowManagedReadPathsOnly`: um `true` em qualquer fonte de administrador ativa o bloqueio. Enquanto um bloqueio está ativo, Claude Code une a allowlist que bloqueia, `sandbox.network.allowedDomains` junto com regras allow `WebFetch(domain:...)`, ou `sandbox.filesystem.allowRead`, em cada fonte de administrador. Sem o bloqueio, Claude Code trata a allowlist como qualquer outra chave, então sob `"first-wins"` a allowlist de uma fonte de administrador não selecionada é ignorada

190* `allowAllClaudeAiMcps`190* `allowAllClaudeAiMcps`

191* `allowManagedMcpServersOnly`: um `true` em qualquer fonte de administrador ativa o bloqueio de lista de permissões MCP. Enquanto o bloqueio está ativo, a lista `allowedMcpServers` gerenciada vem da fonte de administrador com classificação mais alta que define uma. Uma lista gerenciada pelo servidor substitui a lista de uma fonte mais baixa em vez de se combinar com ela.191* `allowManagedMcpServersOnly`: um `true` em qualquer fonte de administrador ativa o bloqueio da allowlist MCP. Enquanto o bloqueio está ativo, a lista `allowedMcpServers` gerenciada vem da fonte de administrador com classificação mais alta que define uma. Uma lista gerenciada pelo servidor substitui a lista de uma fonte mais baixa em vez de se combinar com ela.

192 192 

193 Se nenhuma fonte de administrador define uma lista, cada servidor que passa a lista de negação é carregado, a menos que [configurações pai](#let-an-embedding-host-add-policy) forneçam uma lista.193 Se nenhuma fonte de administrador define uma lista, cada servidor que passa pela denylist é carregado, a menos que [configurações pai](#let-an-embedding-host-add-policy) forneçam uma lista.

194 194 

195 Sem o bloqueio, Claude Code lê `allowedMcpServers` da fonte gerenciada que aplica, então sob `"first-wins"` a lista de uma fonte de administrador não selecionada é ignorada. Requer Claude Code v2.1.273 ou posterior195 Sem o bloqueio, Claude Code lê `allowedMcpServers` da fonte gerenciada que aplica, então sob `"first-wins"` a lista de uma fonte de administrador não selecionada é ignorada. Requer Claude Code v2.1.273 ou posterior

196* `deniedMcpServers` e [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors): uma entrada ou um `true` em qualquer fonte de administrador se aplica. Requer Claude Code v2.1.273 ou posterior196* `deniedMcpServers` e [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors): uma entrada ou um `true` em qualquer fonte de administrador se aplica. Requer Claude Code v2.1.273 ou posterior


218 218 

219Sob `"merge"`, Claude Code adiciona entradas de lista de uma fonte mais baixa, como regras `permissions.allow` e hooks, à política, então ative-o apenas quando cada fonte classificada abaixo da sua mais alta estiver sob controle de um administrador.219Sob `"merge"`, Claude Code adiciona entradas de lista de uma fonte mais baixa, como regras `permissions.allow` e hooks, à política, então ative-o apenas quando cada fonte classificada abaixo da sua mais alta estiver sob controle de um administrador.

220 220 

221Esta tabela mostra como Claude Code combina cada tipo de chave sob `"merge"`. A entrada [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) nomeia cada chave em três das linhas: listas de permissões de restrição, valores tomados inteiros, e chaves lidas apenas da fonte com classificação mais alta.221Esta tabela mostra como Claude Code combina cada tipo de chave sob `"merge"`. A entrada [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) nomeia cada chave em três das linhas: allowlists de restrição, valores tomados inteiros, e chaves lidas apenas da fonte com classificação mais alta.

222 222 

223| Tipo de chave | Como Claude Code a combina | Exemplos |223| Tipo de chave | Como Claude Code a combina | Exemplos |

224| :- | :- | :- |224| :- | :- | :- |

225| Listas | Combina as entradas de cada fonte | `permissions.allow`, `hooks`, `sandbox.network.allowedDomains`, `deniedMcpServers`, `deniedModels` |225| Listas | Combina as entradas de cada fonte | `permissions.allow`, `hooks`, `sandbox.network.allowedDomains`, `deniedMcpServers`, `deniedModels` |

226| Bloqueios | Aplica o valor mais restritivo que qualquer fonte define; um valor mais solto se aplica apenas da fonte com classificação mais alta | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound`, `availableModelsMatch` |226| Bloqueios | Aplica o valor mais restritivo que qualquer fonte define; um valor mais solto se aplica apenas da fonte com classificação mais alta | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound`, `availableModelsMatch` |

227| Listas de permissões de restrição | Toma a lista inteira da fonte com classificação mais alta que a define, sem adicionar entradas de fontes mais baixas | `availableModels`, `allowedMcpServers`, `strictKnownMarketplaces`, `allowedChannelPlugins`, e a cadeia `fallbackModel` |227| Allowlists de restrição | Toma a lista inteira da fonte com classificação mais alta que a define, sem adicionar entradas de fontes mais baixas | `availableModels`, `allowedMcpServers`, `strictKnownMarketplaces`, `allowedChannelPlugins`, e a cadeia `fallbackModel` |

228| Valores tomados inteiros | Toma o valor inteiro da fonte com classificação mais alta que o define, sem combinar entradas ou campos de fontes mais baixas | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |228| Valores tomados inteiros | Toma o valor inteiro da fonte com classificação mais alta que o define, sem combinar entradas ou campos de fontes mais baixas | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |

229| Servidores MCP fornecidos | Combina os nomes de servidor de cada fonte; quando duas fontes definem o mesmo nome, aplica a entrada inteira da fonte com classificação mais alta | `managedMcpServers` |229| Servidores MCP fornecidos | Combina os nomes de servidor de cada fonte; quando duas fontes definem o mesmo nome, aplica a entrada inteira da fonte com classificação mais alta | `managedMcpServers` |

230| Chaves lidas apenas da fonte com classificação mais alta | Ignora a chave em cada fonte mais baixa, mesmo quando a fonte com classificação mais alta a deixa indefinida | Auxiliares de credencial como `apiKeyHelper`, pins de login como `forceLoginOrgUUID`, `modelPicker`, `permissions.defaultMode` |230| Chaves lidas apenas da fonte com classificação mais alta | Ignora a chave em cada fonte mais baixa, mesmo quando a fonte com classificação mais alta a deixa indefinida | Auxiliares de credencial como `apiKeyHelper`, pins de login como `forceLoginOrgUUID`, `modelPicker`, `permissions.defaultMode` |


259 259 

260Para ter Claude Code mesclar configurações pai junto com uma fonte de administrador, defina [`parentSettingsBehavior`](/docs/pt/settings-reference#parentsettingsbehavior) como `"merge"` na fonte gerenciada de prioridade mais alta; Claude Code lê a chave apenas dessa fonte.260Para ter Claude Code mesclar configurações pai junto com uma fonte de administrador, defina [`parentSettingsBehavior`](/docs/pt/settings-reference#parentsettingsbehavior) como `"merge"` na fonte gerenciada de prioridade mais alta; Claude Code lê a chave apenas dessa fonte.

261 261 

262Claude Code então mantém apenas os valores do host que restringem o que Claude pode fazer, com uma lacuna a saber: a menos que você também defina os bloqueios `allowManaged*Only`, as regras de permissão de permissão do host e listas de permissões de sandbox ainda se aplicam. Veja [Restrinja configurações pai](/docs/pt/claude-apps-gateway#restrict-parent-settings) para os bloqueios.262Claude Code então mantém apenas os valores do host que restringem o que Claude pode fazer, com uma lacuna a saber: a menos que você também defina os bloqueios `allowManaged*Only`, as regras allow de permissão do host e allowlists de sandbox ainda se aplicam. Veja [Restrinja configurações pai](/docs/pt/claude-apps-gateway#restrict-parent-settings) para os bloqueios.

263 263 

264Um [`policyHelper`](/docs/pt/settings-reference#policyhelper) pode desativar a mesclagem pai independentemente dessa chave; sua entrada diz quando.264Um [`policyHelper`](/docs/pt/settings-reference#policyhelper) pode desativar a mesclagem pai independentemente dessa chave; sua entrada diz quando.

265 265 

266Claude Code também aplica essas verificações a valores fornecidos pelo pai por conta própria:266Claude Code também aplica essas verificações a valores fornecidos pelo pai por conta própria:

267 267 

268* Quando qualquer fonte de administrador define `allowManagedPermissionRulesOnly`, Claude Code descarta [regras de permissão de permissão fornecidas pelo pai](/docs/pt/claude-apps-gateway#restrict-parent-settings) e `additionalDirectories` conforme as lê, mesmo quando uma fonte de prioridade mais alta deixa a chave indefinida. O efeito da chave em suas próprias regras de permissão vem das configurações gerenciadas que Claude Code aplica, ou de configurações pai que você escolheu mesclar268* Quando qualquer fonte de administrador define `allowManagedPermissionRulesOnly`, Claude Code descarta [regras allow de permissão fornecidas pelo pai](/docs/pt/claude-apps-gateway#restrict-parent-settings) e `additionalDirectories` conforme as lê, mesmo quando uma fonte de prioridade mais alta deixa a chave indefinida. O efeito da chave em suas próprias regras de permissão vem das configurações gerenciadas que Claude Code aplica, ou de configurações pai que você escolheu mesclar

269* Claude Code impõe o valor `forceLoginOrgUUID` ou `allowedMcpServers` nas configurações gerenciadas que aplica e bloqueia um fornecido pelo pai. Fora do bloqueio de lista de permissões MCP, um valor em uma fonte de administrador mais baixa que Claude Code não aplica nem se aplica nem bloqueia o do pai.269* Claude Code impõe o valor `forceLoginOrgUUID` ou `allowedMcpServers` nas configurações gerenciadas que aplica e bloqueia um fornecido pelo pai. Fora do bloqueio da allowlist MCP, um valor em uma fonte de administrador mais baixa que Claude Code não aplica nem se aplica nem bloqueia o do pai.

270 270 

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

275* Um `blockedMarketplaces` fornecido pelo pai se aplica além de qualquer lista de bloqueio 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">

277 Mantenha o acesso à pasta Cowork quando apenas regras gerenciadas se aplicam278 Mantenha o acesso à pasta Cowork quando apenas regras gerenciadas se aplicam


279 280 

280[Cowork](https://claude.com/docs/cowork/overview) no aplicativo Claude Desktop executa suas sessões no Claude Code e concede a cada sessão acesso às suas pastas de trabalho, como a pasta que o usuário conecta, através de regras de permissão que fornece quando inicia a sessão. Quando sua política gerenciada define [`allowManagedPermissionRulesOnly`](/docs/pt/settings-reference#allowmanagedpermissionrulesonly), Claude Code mantém apenas as regras de permissão na política gerenciada: descarta regras de permissão que um host fornece como configurações pai, como `--allowedTools`, ou em um arquivo de configurações, então gravações nessas pastas perdem sua pré-aprovação. Em uma sessão Cowork que pede antes de edições, Cowork não consegue mostrar o prompt, e Claude relata cada gravação como bloqueada porque o caminho se resolve para um local protegido ou um caminho fora da pasta conectada.281[Cowork](https://claude.com/docs/cowork/overview) no aplicativo Claude Desktop executa suas sessões no Claude Code e concede a cada sessão acesso às suas pastas de trabalho, como a pasta que o usuário conecta, através de regras de permissão que fornece quando inicia a sessão. Quando sua política gerenciada define [`allowManagedPermissionRulesOnly`](/docs/pt/settings-reference#allowmanagedpermissionrulesonly), Claude Code mantém apenas as regras de permissão na política gerenciada: descarta regras de permissão que um host fornece como configurações pai, como `--allowedTools`, ou em um arquivo de configurações, então gravações nessas pastas perdem sua pré-aprovação. Em uma sessão Cowork que pede antes de edições, Cowork não consegue mostrar o prompt, e Claude relata cada gravação como bloqueada porque o caminho se resolve para um local protegido ou um caminho fora da pasta conectada.

281 282 

282Para restaurar as gravações, adicione regras de permissão para essas pastas à fonte gerenciada que Claude Code [seleciona](#precedence-within-the-managed-tier) nessas máquinas: em uma frota gerenciada por MDM, essa é a política MDM em vez de um arquivo de configurações gerenciadas separado. Este exemplo usa a forma de arquivo, e uma política MDM toma as mesmas chaves. Mantém `allowManagedPermissionRulesOnly` definido e permite edições sob uma pasta `CoworkProjects` no diretório inicial de cada usuário; substitua o caminho pelas pastas que seus usuários conectam:283Para restaurar as gravações, adicione regras de permissão para essas pastas à fonte gerenciada que Claude Code [seleciona](#precedence-within-the-managed-tier) nessas máquinas: em uma frota gerenciada por MDM, essa é a política MDM em vez de um arquivo de configurações gerenciadas separado. Este exemplo usa a forma de arquivo, e uma política MDM toma as mesmas chaves. Mantém `allowManagedPermissionRulesOnly` definido e permite edições sob uma pasta `CoworkProjects` no diretório pessoal de cada usuário; substitua o caminho pelas pastas que seus usuários conectam:

283 284 

284```json managed-settings.json theme={null}285```json managed-settings.json theme={null}

285{286{


298 O que um desenvolvedor pode mudar299 O que um desenvolvedor pode mudar

299</h3>300</h3>

300 301 

301Os próprios arquivos de configurações de um desenvolvedor, valores `--settings`, e arquivos de projeto nunca substituem um valor gerenciado; as [exceções](/docs/pt/settings#exceptions-to-managed-settings-precedence) apenas deixam um valor de nível mais baixo mais restritivo contar. Estes casos ficam fora dessa regra:302Os próprios arquivos de configurações de um desenvolvedor, valores `--settings`, e arquivos de projeto nunca sobrescrevem um valor gerenciado; as [exceções](/docs/pt/settings#exceptions-to-managed-settings-precedence) apenas deixam um valor de nível mais baixo mais restritivo contar. Estes casos ficam fora dessa regra:

302 303 

303* **O modelo para uma sessão**: um `model` gerenciado é um padrão, não um bloqueio. `--model` e `ANTHROPIC_MODEL` ainda escolhem o modelo para essa sessão, então implante [`availableModels`](/docs/pt/settings-reference#availablemodels) para restringir a escolha.304* **O modelo para uma sessão**: um `model` gerenciado é um padrão, não um bloqueio. `--model` e `ANTHROPIC_MODEL` ainda escolhem o modelo para essa sessão, então implante [`availableModels`](/docs/pt/settings-reference#availablemodels) para restringir a escolha.

305* **A janela de compactação automática para uma sessão**: um [`autoCompactWindow`](/docs/pt/settings-reference#autocompactwindow) gerenciado também é um padrão. A flag `--autocompact` e a variável `CLAUDE_CODE_AUTO_COMPACT_WINDOW` ainda definem a [janela de compactação automática](/docs/pt/model-config#set-the-auto-compact-window) para essa sessão.

304* **Direitos de administrador local**: um desenvolvedor que é um administrador na máquina pode editar a própria fonte gerenciada, é por isso que a ferramenta MDM pode reimplantar o perfil ou arquivo em um cronograma e por que o registro HKLM e o domínio de preferências gerenciadas do macOS existem.306* **Direitos de administrador local**: um desenvolvedor que é um administrador na máquina pode editar a própria fonte gerenciada, é por isso que a ferramenta MDM pode reimplantar o perfil ou arquivo em um cronograma e por que o registro HKLM e o domínio de preferências gerenciadas do macOS existem.

305* **O cache gerenciado pelo servidor**: configurações gerenciadas pelo servidor vêm dos servidores da Anthropic, e uma edição no cache local [dura apenas até a próxima busca bem-sucedida](/docs/pt/server-managed-settings#security-considerations).307* **O cache gerenciado pelo servidor**: configurações gerenciadas pelo servidor vêm dos servidores da Anthropic, e uma edição no cache local [dura apenas até a próxima busca bem-sucedida](/docs/pt/server-managed-settings#security-considerations).

306* **Outras ferramentas**: configurações gerenciadas vinculam apenas Claude Code. Um desenvolvedor que chama a API de outra ferramenta não está sob elas.308* **Outras ferramentas**: configurações gerenciadas vinculam apenas Claude Code. Um desenvolvedor que chama a API de outra ferramenta não está sob elas.


398 400 

399| Campo | Comportamento quando presente mas inválido |401| Campo | Comportamento quando presente mas inválido |

400| :- | :- |402| :- | :- |

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

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

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

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

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

406| `strictKnownMarketplaces` | Aplicado como uma lista de permissões vazia até que o valor seja corrigido, portanto nenhuma [fonte de marketplace](/docs/pt/plugins/org#restrict-what-users-can-install) é admitida. Uma entrada individual que é inválida ou não pode ser aplicada, como um regex `hostPattern` que não compila, é removida e o subconjunto válido é aplicado. |408| `strictKnownMarketplaces` | Aplicado como uma allowlist vazia até que o valor seja corrigido, portanto nenhuma [fonte de marketplace](/docs/pt/plugins/org#restrict-what-users-can-install) é admitida. Uma entrada individual que é inválida ou não pode ser aplicada, como um regex `hostPattern` que não compila, é removida e o subconjunto válido é aplicado. |

407| `availableModels` | Aplicado como uma lista de permissões vazia até ser corrigido, portanto apenas o modelo Padrão está disponível; uma entrada não-string é removida e o subconjunto válido é aplicado. |409| `availableModels` | Aplicado como uma allowlist vazia até ser corrigido, portanto apenas o modelo Padrão está disponível; uma entrada não-string é removida e o subconjunto válido é aplicado. |

408| [`availableModelsMatch`](/docs/pt/settings-reference#availablemodelsmatch) | Tratado como `exact` até que o valor seja corrigido. |410| [`availableModelsMatch`](/docs/pt/settings-reference#availablemodelsmatch) | Tratado como `exact` até que o valor seja corrigido. |

409| `forceLoginOrgUUID` | Nenhuma organização é permitida fazer login até que o valor seja corrigido. |411| `forceLoginOrgUUID` | Nenhuma organização é permitida fazer login até que o valor seja corrigido. |

410| `gatewayInternalNetworks` | Quando o valor inválido vem da fonte gerenciada mais alta na máquina, `/login` recusa cada novo [gateway de nuvem](/docs/pt/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) login na máquina até que o valor seja corrigido. |412| `gatewayInternalNetworks` | Quando o valor inválido vem da fonte gerenciada mais alta na máquina, `/login` recusa cada novo [gateway de nuvem](/docs/pt/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) login na máquina até que o valor seja corrigido. |


437* Se `failIfUnavailable` for inválido, Claude Code descarta o valor em vez de tratá-lo como `true`, portanto um valor ilegível nunca interrompe sessões de inicialização em toda sua frota.439* Se `failIfUnavailable` for inválido, Claude Code descarta o valor em vez de tratá-lo como `true`, portanto um valor ilegível nunca interrompe sessões de inicialização em toda sua frota.

438* Claude Code trata cada outro booleano inválido como o valor que mantém o sandbox mais rigoroso até você corrigi-lo. Uma chave que ativa o sandbox ou uma de suas restrições, como `enabled` ou `network.allowManagedDomainsOnly`, conta como `true`. Uma chave que o afrouxe, como `allowUnsandboxedCommands`, conta como `false`.440* Claude Code trata cada outro booleano inválido como o valor que mantém o sandbox mais rigoroso até você corrigi-lo. Uma chave que ativa o sandbox ou uma de suas restrições, como `enabled` ou `network.allowManagedDomainsOnly`, conta como `true`. Uma chave que o afrouxe, como `allowUnsandboxedCommands`, conta como `false`.

439* Em uma lista fora de `credentials`, como `excludedCommands` ou `network.allowedDomains`, Claude Code descarta uma entrada inválida e mantém o resto da lista. Uma lista que não é um array, ou que não tem entrada válida, não se aplica.441* Em uma lista fora de `credentials`, como `excludedCommands` ou `network.allowedDomains`, Claude Code descarta uma entrada inválida e mantém o resto da lista. Uma lista que não é um array, ou que não tem entrada válida, não se aplica.

440* Enquanto `network.deniedDomains` ou qualquer entrada nela for inválida, Claude Code também retém `network.allowedDomains`, portanto a lista de permissões gerenciada não concede nada até você corrigir a lista de negação.442* Enquanto `network.deniedDomains` ou qualquer entrada nela for inválida, Claude Code também retém `network.allowedDomains`, portanto a allowlist gerenciada não concede nada até você corrigir a lista de negação.

441* Enquanto `filesystem.denyRead`, `filesystem.denyWrite` ou qualquer entrada em qualquer uma delas for inválida, Claude Code também retém `filesystem.allowRead` e `filesystem.allowWrite` até você corrigir a lista de negação.443* Enquanto `filesystem.denyRead`, `filesystem.denyWrite` ou qualquer entrada em qualquer uma delas for inválida, Claude Code também retém `filesystem.allowRead` e `filesystem.allowWrite` até você corrigir a lista de negação.

442 444 

443<span id="managed-only-settings" />445<span id="managed-only-settings" />

model-config.md +2 −1

Details

285* **[Fallback automático de modelo](#automatic-model-fallback)**: um fallback cujo alvo é excluído não é executado, portanto a solicitação sinalizada termina com uma recusa285* **[Fallback automático de modelo](#automatic-model-fallback)**: um fallback cujo alvo é excluído não é executado, portanto a solicitação sinalizada termina com uma recusa

286* **[Classificador do modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode)**: o padrão Claude Sonnet 5 do classificador se aplica apenas quando a allowlist permite Sonnet 5. Quando é excluído, o classificador é executado no modelo da sessão, que a allowlist já governa, ou em um modelo Opus quando a sessão é executada em um [modelo Fable](#work-with-fable). Em provedores diferentes da API Anthropic, esse fallback Opus é executado no modelo que você definiu em `ANTHROPIC_DEFAULT_OPUS_MODEL` ou, caso contrário, no Opus 5, sem consultar a allowlist. Requer Claude Code v2.1.210 ou posterior286* **[Classificador do modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode)**: o padrão Claude Sonnet 5 do classificador se aplica apenas quando a allowlist permite Sonnet 5. Quando é excluído, o classificador é executado no modelo da sessão, que a allowlist já governa, ou em um modelo Opus quando a sessão é executada em um [modelo Fable](#work-with-fable). Em provedores diferentes da API Anthropic, esse fallback Opus é executado no modelo que você definiu em `ANTHROPIC_DEFAULT_OPUS_MODEL` ou, caso contrário, no Opus 5, sem consultar a allowlist. Requer Claude Code v2.1.210 ou posterior

287* **[Modo rápido](/docs/pt/fast-mode)**: ativar o modo rápido é recusado quando o modelo em que a sessão seria executada depois está fora da lista de permissões287* **[Modo rápido](/docs/pt/fast-mode)**: ativar o modo rápido é recusado quando o modelo em que a sessão seria executada depois está fora da lista de permissões

288* **Fallback de disponibilidade no Amazon Bedrock e no Agent Platform do Google Cloud**: quando sua conta perde acesso a um modelo no meio da sessão, a mudança para outro modelo ignora modelos excluídos. As verificações de modelo na inicialização no [Amazon Bedrock](/docs/pt/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) e no [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai#when-your-organization-enforces-a-model-allowlist) ignoram modelos excluídos apenas quando as configurações gerenciadas também definem [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model)

288 289 

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

290{291{


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

767| Alternar para a sessão atual | Pressione `Option+T` em macOS ou `Alt+T` em Windows e Linux |768| 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` |769| 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) |770| 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 771 

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

Details

358 358 

359<span id="new-context-gates" />359<span id="new-context-gates" />

360 360 

361**Atributos de conteúdo no tracing beta detalhado**

362 

361<Note>363<Note>

362 Atributos adicionais que carregam conteúdo, como `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input` e `response.model_output`, são emitidos somente quando o tracing beta detalhado está ativo. Eles não fazem parte do esquema estável de spans.364 Atributos adicionais que carregam conteúdo, como `new_context`, `system_reminders`, `system_prompt_preview`, `user_system_prompt`, `tool_input` e `response.model_output`, são emitidos somente quando o tracing beta detalhado está ativo. Eles não fazem parte do esquema estável de spans.

365</Note>

363 366 

364 A condição para `new_context` depende de qual span o carrega, e cada cópia é truncada no limite de conteúdo (60 KB por padrão). No span `claude_code.tool`, ele carrega o resultado daquela chamada de ferramenta, qualquer que seja a ferramenta, e requer `OTEL_LOG_TOOL_CONTENT=1`. No span `claude_code.interaction`, ele carrega o prompt do usuário e, no span `claude_code.llm_request`, as novas mensagens do usuário e os resultados de ferramentas daquela requisição. Ambos requerem `OTEL_LOG_USER_PROMPTS=1`.367Estes atributos aparecem nos spans abaixo, e `Condicionado por` indica a variável de que um atributo precisa além do tracing beta detalhado. Valores mais longos que o limite de conteúdo (60 KB por padrão) são truncados.

365 368 

366 `user_system_prompt` também requer `OTEL_LOG_USER_PROMPTS=1`. Ele carrega apenas o texto do system prompt que você fornece por meio da opção `systemPrompt` do SDK ou das flags `--system-prompt` e `--append-system-prompt`, truncado no limite de conteúdo (60 KB por padrão), e é emitido uma vez por sessão, e não por requisição.369| Atributo | Span | Descrição | Condicionado por |

367</Note>370| - | - | - | - |

371| `new_context` | `claude_code.interaction` | O prompt do usuário | `OTEL_LOG_USER_PROMPTS` |

372| `new_context` | `claude_code.llm_request` | As novas mensagens do usuário e os resultados de ferramentas enviados com a requisição | `OTEL_LOG_USER_PROMPTS` |

373| `system_reminders` | `claude_code.llm_request` | O texto dos [lembretes do sistema](/docs/pt/glossary#system-reminder) entre as novas mensagens da requisição | `OTEL_LOG_USER_PROMPTS` |

374| `system_prompt_preview` | `claude_code.llm_request` | Os primeiros 500 caracteres do system prompt completo enviado com a requisição | `OTEL_LOG_USER_PROMPTS` |

375| `user_system_prompt` | `claude_code.llm_request` | Apenas o texto do system prompt que você fornece por meio da opção `systemPrompt` do SDK ou das flags `--system-prompt` e `--append-system-prompt`. Emitido uma vez por sessão, e não por requisição | `OTEL_LOG_USER_PROMPTS` |

376| `response.model_output` | `claude_code.llm_request` | Texto da resposta do modelo à requisição | `OTEL_LOG_USER_PROMPTS` |

377| `new_context` | `claude_code.tool` | O resultado da chamada de ferramenta, qualquer que seja a ferramenta | `OTEL_LOG_TOOL_CONTENT` |

378| `tool_input` | `claude_code.tool` | A entrada serializada da chamada de ferramenta | `OTEL_LOG_TOOL_DETAILS` |

379 

380No tracing beta detalhado com `OTEL_LOG_USER_PROMPTS=1`, o Claude Code também emite um evento `claude_code.system_prompt` que carrega o system prompt completo, truncado no limite de conteúdo. Ele chega na primeira vez que uma sessão envia cada system prompt distinto, e novamente após a compactação.

368 381 

369<h3 id="dynamic-headers">382<h3 id="dynamic-headers">

370 Cabeçalhos dinâmicos383 Cabeçalhos dinâmicos


797* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)810* `event.sequence`: contador por processo para ordenar eventos, descrito em [Atributos de correlação de eventos](#event-correlation-attributes)

798* `prompt_length`: Comprimento do prompt811* `prompt_length`: Comprimento do prompt

799* `prompt`: Conteúdo do prompt. Redigido por padrão. Defina `OTEL_LOG_USER_PROMPTS=1` para incluí-lo812* `prompt`: Conteúdo do prompt. Redigido por padrão. Defina `OTEL_LOG_USER_PROMPTS=1` para incluí-lo

813* `prompt_text`: Mesmo valor que `prompt`, ocultado sob a mesma condição. Um backend que armazena nomes de atributos com pontos como objetos aninhados lê `prompt.id` como `id` dentro de um objeto chamado `prompt` e pode perder a string do prompt. Nesse caso, leia `prompt_text`. Requer Claude Code v2.1.287 ou posterior

800* `message.uuid`: UUID da mensagem do usuário resultante, correspondendo à entrada da transcrição persistida. Ausente em dispatches de comando, que podem produzir zero ou muitas mensagens. Requer Claude Code v2.1.214 ou posterior814* `message.uuid`: UUID da mensagem do usuário resultante, correspondendo à entrada da transcrição persistida. Ausente em dispatches de comando, que podem produzir zero ou muitas mensagens. Requer Claude Code v2.1.214 ou posterior

801* `command_name`: Nome do comando quando o prompt invoca um. Nomes de comando integrados e agrupados como `compact` ou `debug` são emitidos como estão; aliases como `reset` emitem conforme digitado em vez do nome canônico. Nomes de comando personalizados, de plugin e MCP colapsam para `custom` ou `mcp` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido815* `command_name`: Nome do comando quando o prompt invoca um. Nomes de comando integrados e agrupados como `compact` ou `debug` são emitidos como estão; aliases como `reset` emitem conforme digitado em vez do nome canônico. Nomes de comando personalizados, de plugin e MCP colapsam para `custom` ou `mcp` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido

802* `command_source`: Origem do comando quando presente: `builtin`, `custom`, ou `mcp`. Comandos fornecidos por plugin relatam como `custom`816* `command_source`: Origem do comando quando presente: `builtin`, `custom`, ou `mcp`. Comandos fornecidos por plugin relatam como `custom`


1694* A exportação OpenTelemetry para seu backend é opt-in e requer configuração explícita. Para a telemetria operacional separada da Anthropic e como desabilitá-la, consulte [Uso de dados](/docs/pt/data-usage#telemetry-services)1708* A exportação OpenTelemetry para seu backend é opt-in e requer configuração explícita. Para a telemetria operacional separada da Anthropic e como desabilitá-la, consulte [Uso de dados](/docs/pt/data-usage#telemetry-services)

1695* Conteúdos de arquivo brutos e trechos de código não são incluídos em métricas ou eventos. Os spans de rastreamento são um caminho de dados separado: veja o ponto `OTEL_LOG_TOOL_CONTENT` abaixo1709* Conteúdos de arquivo brutos e trechos de código não são incluídos em métricas ou eventos. Os spans de rastreamento são um caminho de dados separado: veja o ponto `OTEL_LOG_TOOL_CONTENT` abaixo

1696* Quando autenticado via OAuth, `user.email` é incluído em atributos de telemetria, enviado apenas para o endpoint OTel que você configura, nunca para a Anthropic. Se isso for uma preocupação para sua organização, trabalhe com seu backend de telemetria para filtrar ou reduzir este campo1710* Quando autenticado via OAuth, `user.email` é incluído em atributos de telemetria, enviado apenas para o endpoint OTel que você configura, nunca para a Anthropic. Se isso for uma preocupação para sua organização, trabalhe com seu backend de telemetria para filtrar ou reduzir este campo

1697* O conteúdo do prompt do usuário não é coletado por padrão. Apenas o comprimento do prompt é registrado. Para incluir conteúdo do prompt, defina `OTEL_LOG_USER_PROMPTS=1`. Sob rastreamento beta detalhado, esta variável alcança mais do que apenas texto de prompt: ela também controla o [atributo de span `new_context`](#new-context-gates), que carrega resultados de ferramenta no span `claude_code.llm_request`1711* O conteúdo do prompt do usuário não é coletado por padrão. Apenas o comprimento do prompt é registrado. Para incluir conteúdo do prompt, defina `OTEL_LOG_USER_PROMPTS=1`. Quando ativado:

1698* O texto de resposta do assistente não é coletado por padrão. Apenas o comprimento da resposta é registrado. Para incluir texto de resposta, defina `OTEL_LOG_ASSISTANT_RESPONSES=1`. Como todos os dados OpenTelemetry do Claude Code, o texto de resposta é enviado apenas para o endpoint OTel que você configura, nunca para a Anthropic. Quando esta variável não está definida, `OTEL_LOG_USER_PROMPTS` é usado como fallback, portanto defina `OTEL_LOG_ASSISTANT_RESPONSES=0` se você quiser conteúdo de prompt sem conteúdo de resposta1712 * Eventos `user_prompt` carregam o texto do prompt em dois atributos, `prompt` e [`prompt_text`](#user-prompt-event). Se você descartar ou mascarar o texto do prompt do evento pelo nome do atributo no seu coletor, nomeie ambos os atributos na regra

1713 

1714 Este processador `attributes` do OpenTelemetry Collector exclui ambos os atributos nos pipelines que o listam:

1715 

1716 ```yaml theme={null}

1717 processors:

1718 attributes/drop-prompt-text:

1719 actions:

1720 - key: prompt

1721 action: delete

1722 - key: prompt_text

1723 action: delete

1724 ```

1725 

1726 * Com o [rastreamento](#traces-beta) ativado, o span `claude_code.interaction` carrega o texto do prompt em seu atributo `user_prompt`

1727 

1728 * Sob rastreamento beta detalhado, os spans também carregam as novas mensagens do usuário, resultados de ferramenta e lembretes do sistema enviados com cada requisição, o texto do system prompt e a saída do modelo. [Atributos de conteúdo sob rastreamento beta detalhado](#new-context-gates) lista cada atributo. O evento `claude_code.system_prompt` carrega o system prompt completo

1729* O texto de resposta do assistente não é coletado por padrão. Apenas o comprimento da resposta é registrado. Para incluir texto de resposta, defina `OTEL_LOG_ASSISTANT_RESPONSES=1`. Como todos os dados OpenTelemetry do Claude Code, o texto de resposta é enviado apenas para o endpoint OTel que você configura, nunca para a Anthropic. Quando esta variável não está definida, `OTEL_LOG_USER_PROMPTS` é usado como fallback, portanto defina `OTEL_LOG_ASSISTANT_RESPONSES=0` se você quiser conteúdo de prompt sem conteúdo de resposta nos eventos. Sob rastreamento beta detalhado, o span `claude_code.llm_request` ainda carrega a saída do modelo em [`response.model_output`](#new-context-gates), que segue `OTEL_LOG_USER_PROMPTS` em vez desta variável

1699* Argumentos de entrada de ferramenta e parâmetros não são registrados por padrão. Para incluí-los, defina `OTEL_LOG_TOOL_DETAILS=1`. Para os servidores integrados do Claude Desktop, em sessões que o Claude Desktop possui, `tool_decision` e `tool_result` carregam o par `mcp_server_name`/`mcp_tool_name`, nomes criados pelo host em vez de conteúdo de argumentos, mesmo com a flag desativada. A exceção requer Claude Code v2.1.214 ou posterior. Estes dados são enviados apenas para o endpoint OTEL que você configura, nunca para a Anthropic. Os argumentos ainda podem conter valores sensíveis, portanto configure seu backend de telemetria para filtrar ou reduzir esses atributos conforme necessário. Quando ativado:1730* Argumentos de entrada de ferramenta e parâmetros não são registrados por padrão. Para incluí-los, defina `OTEL_LOG_TOOL_DETAILS=1`. Para os servidores integrados do Claude Desktop, em sessões que o Claude Desktop possui, `tool_decision` e `tool_result` carregam o par `mcp_server_name`/`mcp_tool_name`, nomes criados pelo host em vez de conteúdo de argumentos, mesmo com a flag desativada. A exceção requer Claude Code v2.1.214 ou posterior. Estes dados são enviados apenas para o endpoint OTEL que você configura, nunca para a Anthropic. Os argumentos ainda podem conter valores sensíveis, portanto configure seu backend de telemetria para filtrar ou reduzir esses atributos conforme necessário. Quando ativado:

1700 * Eventos `tool_result` e `tool_decision` incluem um atributo `tool_parameters` com comandos Bash, nomes de servidor MCP e ferramenta, e nomes de skill. Campos como `full_command` são emitidos sem truncamento1731 * Eventos `tool_result` e `tool_decision` incluem um atributo `tool_parameters` com comandos Bash, nomes de servidor MCP e ferramenta, e nomes de skill. Campos como `full_command` são emitidos sem truncamento

1701 * Eventos `tool_result` adicionalmente incluem um atributo `tool_input` com caminhos de arquivo, URLs, padrões de busca e outros argumentos. Valores individuais com mais de 512 caracteres são truncados e o total é limitado a \~4 K caracteres1732 * Eventos `tool_result` adicionalmente incluem um atributo `tool_input` com caminhos de arquivo, URLs, padrões de busca e outros argumentos. Valores individuais com mais de 512 caracteres são truncados e o total é limitado a \~4 K caracteres

1702 * Eventos `user_prompt` incluem o `command_name` verbatim para comandos customizados, plugin e MCP1733 * Eventos `user_prompt` incluem o `command_name` verbatim para comandos customizados, plugin e MCP

1703 * Os [contadores de custo e token](#cost-counter) e os eventos `api_request`, `api_error` e `api_refusal` carregam nomes reais de agente, skill, plugin e servidor MCP e nomes de ferramenta em seus atributos de atribuição1734 * Os [contadores de custo e token](#cost-counter) e os eventos `api_request`, `api_error` e `api_refusal` carregam nomes reais de agente, skill, plugin e servidor MCP e nomes de ferramenta em seus atributos de atribuição

1704 * Spans de rastreamento incluem o mesmo atributo `tool_input` e atributos derivados de entrada como `file_path`, com o mesmo truncamento que `tool_input`1735 * O span `claude_code.tool` carrega atributos derivados da entrada, como `file_path`. Sob rastreamento beta detalhado, ele também carrega um atributo [`tool_input`](#new-context-gates)

1705* O conteúdo de ferramenta não é registrado em spans de rastreamento por padrão. Para incluí-lo, defina `OTEL_LOG_TOOL_CONTENT=1`. O span `claude_code.tool` então carrega um [evento de span `tool.output`](#tool-output-span-event) com conteúdos de arquivo brutos, saída de comando Bash e o que ferramentas MCP, WebFetch e WebSearch retornam, truncado no limite de conteúdo (60 KB por padrão) por atributo. Resultados de ferramentas MCP, WebFetch e WebSearch requerem Claude Code v2.1.283 ou posterior. O conteúdo de ferramenta também alcança spans através de [`new_context`, cujo controle difere por span](#new-context-gates). Configure seu backend de telemetria para filtrar ou reduzir esses atributos conforme necessário1736* O conteúdo de ferramenta não é registrado em spans de rastreamento por padrão. Para incluí-lo, defina `OTEL_LOG_TOOL_CONTENT=1`. O span `claude_code.tool` então carrega um [evento de span `tool.output`](#tool-output-span-event) com conteúdos de arquivo brutos, saída de comando Bash e o que ferramentas MCP, WebFetch e WebSearch retornam, truncado no limite de conteúdo (60 KB por padrão) por atributo. Resultados de ferramentas MCP, WebFetch e WebSearch requerem Claude Code v2.1.283 ou posterior. O conteúdo de ferramenta também alcança spans através de [`new_context`, cujo controle difere por span](#new-context-gates). Configure seu backend de telemetria para filtrar ou reduzir esses atributos conforme necessário

1706* Corpos de solicitação e resposta da API Anthropic Messages brutos não são registrados por padrão. Para incluí-los, defina `OTEL_LOG_RAW_API_BODIES` em suas configurações de shell, usuário ou gerenciadas. É ignorado em [configurações de projeto e local](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Os corpos contêm o histórico de conversa completo, incluindo o prompt do sistema, cada turno anterior de usuário e assistente, e resultados de ferramenta, portanto ativar isso implica consentimento para tudo que os outros sinalizadores de conteúdo `OTEL_LOG_*` revelariam. O Claude Code sempre reduz o conteúdo de pensamento estendido do Claude desses corpos, independentemente de outras configurações. O valor que você define determina como o Claude Code entrega os corpos:1737* Corpos de solicitação e resposta da API Anthropic Messages brutos não são registrados por padrão. Para incluí-los, defina `OTEL_LOG_RAW_API_BODIES` em suas configurações de shell, usuário ou gerenciadas. É ignorado em [configurações de projeto e local](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Os corpos contêm o histórico de conversa completo, incluindo o prompt do sistema, cada turno anterior de usuário e assistente, e resultados de ferramenta, portanto ativar isso implica consentimento para tudo que os outros sinalizadores de conteúdo `OTEL_LOG_*` revelariam. O Claude Code sempre reduz o conteúdo de pensamento estendido do Claude desses corpos, independentemente de outras configurações. O valor que você define determina como o Claude Code entrega os corpos:

1707 * Com `=1`, Claude Code emite eventos de log `api_request_body` e `api_response_body` para cada chamada de API. O atributo `body` dos eventos carrega a carga útil serializada em JSON, truncada no limite de conteúdo (60 KB por padrão)1738 * Com `=1`, Claude Code emite eventos de log `api_request_body` e `api_response_body` para cada chamada de API. O atributo `body` dos eventos carrega a carga útil serializada em JSON, truncada no limite de conteúdo (60 KB por padrão)

Details

89| `claude -p` ou o [Agent SDK](/docs/pt/agent-sdk/permissions#permission-modes) | `default` em sessões que [buscam sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching). Em sessões que não buscam, como em um provedor de terceiros ou com telemetria desativada, `auto` com Claude Code v2.1.285 ou posterior e `default` em versões anteriores. Uma sessão em uma organização cuja política retém o padrão `auto` inicia em `default` em vez disso |89| `claude -p` ou o [Agent SDK](/docs/pt/agent-sdk/permissions#permission-modes) | `default` em sessões que [buscam sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching). Em sessões que não buscam, como em um provedor de terceiros ou com telemetria desativada, `auto` com Claude Code v2.1.285 ou posterior e `default` em versões anteriores. Uma sessão em uma organização cuja política retém o padrão `auto` inicia em `default` em vez disso |

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

91 91 

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

93 93 

94Quando a flag, um arquivo de configurações ou o padrão integrado seleciona `auto` mas o modo automático não está disponível para a sessão, Claude Code inicia a sessão no modo Manual em vez disso. O modo automático não está disponível quando a sessão não atende aos [requisitos de disponibilidade](#eliminate-prompts-with-auto-mode), como um arquivo de configurações desativando-o ou um modelo que não o suporta, ou quando Anthropic o desativou temporariamente no lado do servidor.94Quando a flag, um arquivo de configurações ou o padrão integrado seleciona `auto` mas o modo auto não está disponível para a sessão, Claude Code inicia a sessão no modo Manual em vez disso. O modo auto não está disponível quando a sessão não atende aos [requisitos de disponibilidade](#eliminate-prompts-with-auto-mode), como um arquivo de configurações desativando-o ou um modelo que não o suporta, ou quando Anthropic o desativou temporariamente no lado do servidor.

95 95 

96A primeira vez que o padrão integrado inicia uma de suas sessões em modo automático, Claude Code mostra um aviso que vincula a esta página:96A primeira vez que o padrão integrado inicia uma de suas sessões em modo auto, Claude Code mostra um aviso que vincula a esta página:

97 97 

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

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

100 100 

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

102 102 

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

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


111| Uma sessão que você está prestes a iniciar | Passe o modo de permissão como uma flag, por exemplo `claude --permission-mode default` |111| Uma sessão que você está prestes a iniciar | Passe o modo de permissão como uma flag, por exemplo `claude --permission-mode default` |

112| Cada sessão de terminal que você inicia nesta máquina | Defina `permissions.defaultMode` em `~/.claude/settings.json`. Para o que a extensão VS Code lê, veja [Alternar modos de permissão](#switch-permission-modes) |112| Cada sessão de terminal que você inicia nesta máquina | Defina `permissions.defaultMode` em `~/.claude/settings.json`. Para o que a extensão VS Code lê, veja [Alternar modos de permissão](#switch-permission-modes) |

113| Cada sessão de terminal que você inicia em um projeto | Defina `permissions.defaultMode` em `.claude/settings.json` do projeto. Sessões que você inicia em um terminal honram todos os valores exceto `auto` e `bypassPermissions`; sessões que a extensão VS Code inicia não leem configurações de projeto para o modo de permissão inicial |113| Cada sessão de terminal que você inicia em um projeto | Defina `permissions.defaultMode` em `.claude/settings.json` do projeto. Sessões que você inicia em um terminal honram todos os valores exceto `auto` e `bypassPermissions`; sessões que a extensão VS Code inicia não leem configurações de projeto para o modo de permissão inicial |

114| Cada sessão de terminal em sua organização | Defina `permissions.defaultMode` em [configurações gerenciadas](/docs/pt/managed-settings). Sessões de terminal iniciam nesse modo e as pessoas ainda podem alternar para modo automático; para o que a extensão VS Code lê, veja [Alternar modos de permissão](#switch-permission-modes). Para remover o modo automático para que ninguém possa selecioná-lo, defina `permissions.disableAutoMode` como `"disable"` em vez disso |114| Cada sessão de terminal em sua organização | Defina `permissions.defaultMode` em [configurações gerenciadas](/docs/pt/managed-settings). Sessões de terminal iniciam nesse modo e as pessoas ainda podem alternar para modo auto; para o que a extensão VS Code lê, veja [Alternar modos de permissão](#switch-permission-modes). Para remover o modo auto para que ninguém possa selecioná-lo, defina `permissions.disableAutoMode` como `"disable"` em vez disso |

115 115 

116Este exemplo faz cada sessão de terminal em sua máquina iniciar no modo Manual, cujo valor de configuração é `default`. Salve em `~/.claude/settings.json`:116Este exemplo faz cada sessão de terminal em sua máquina iniciar no modo Manual, cujo valor de configuração é `default`. Salve em `~/.claude/settings.json`:

117 117 


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

195 195 

196O runner também relata a aceitação à Anthropic quando se registra, imprimindo `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` na inicialização. Relatar a aceitação requer Claude Code v2.1.267 ou posterior, e versões anteriores aceitam o sinalizador sem relatá-lo ou imprimir essa linha. Cada sessão em um runner aceito usa a git gerenciada pela Anthropic ou a URL do proxy por sessão. Quando uma sessão usa a URL do proxy por sessão, o runner registra uma linha `[runner:warn]` dizendo isso.196O runner também relata a aceitação à Anthropic quando se registra, imprimindo `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` na inicialização. Relatar a aceitação requer Claude Code v2.1.267 ou posterior, e versões anteriores aceitam o sinalizador sem relatá-lo ou imprimir essa linha. Cada sessão em um runner aceito usa a git gerenciada pela Anthropic ou a URL do proxy por sessão. Quando uma sessão usa a URL do proxy por sessão, o runner registra uma linha `[runner:warn]` dizendo isso.

197 197 

198<h4 id="github-api-access-without-the-github-cli">

199 Acesso à API do GitHub sem o GitHub CLI

200</h4>

201 

202Se a imagem do seu runner não inclui o GitHub CLI, o Claude Code pode fornecer um `gh` integrado, para que o Claude ainda possa abrir pull requests, comentar e ler resultados de CI. O `gh` integrado é para runners que usam git gerenciada pela Anthropic. Ele suporta um comando, `gh api`, que chama a REST API do GitHub. Requer Claude Code v2.1.287 ou posterior na imagem do runner.

203 

204Este comando abre um pull request no lugar de `gh pr create`. O `gh` integrado preenche `{owner}` e `{repo}` para o repositório atual:

205 

206```bash theme={null}

207gh api repos/{owner}/{repo}/pulls -f title='Fix' -f head='my-branch' -f base='main'

208```

209 

210* **Credenciais**: o `gh` integrado envia suas requisições REST através da git gerenciada pela Anthropic, que fornece a credencial do GitHub do lado da Anthropic, então a imagem não precisa de nenhum token do GitHub para ele

211* **Quais sessões o recebem**: a Anthropic decide por sessão se a git gerenciada pela Anthropic atende o `gh` da sessão. Quando atende, a linha `[runner:session] governed git ACTIVE` que o runner registra para a sessão mostra `gh_path_shim=true`. Quando não atende, a sessão não tem `gh`

212* **`jq`**: instale `jq` na imagem se você quiser que `--jq` funcione

213* **[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars)**: se o ambiente da sessão a define, o Claude Code não fornece o `gh` integrado, e a sessão não tem `gh`

214 

215Quando a imagem inclui o GitHub CLI, as sessões o usam.

216 

198<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">217<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">

199 Confie em uma autoridade de certificado privada com git gerenciada pela Anthropic218 Confie em uma autoridade de certificado privada com git gerenciada pela Anthropic

200</h4>219</h4>

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

6 6 

7> Configure centralmente o Claude Code para sua organização através de configurações entregues pelo servidor, sem exigir infraestrutura de gerenciamento de dispositivos.7> Configure centralmente o Claude Code para sua organização através de configurações entregues pelo servidor, sem exigir infraestrutura de gerenciamento de dispositivos.

8 8 

9As configurações gerenciadas pelo servidor permitem que Proprietários da organização configurem centralmente o Claude Code a partir de [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) no console claude.ai. Os clientes do Claude Code buscam essas configurações automaticamente quando os usuários se autenticam com uma credencial elegível em uma plataforma onde a entrega gerenciada pelo servidor é suportada. Consulte [Disponibilidade de plataforma](#platform-availability) para as credenciais e plataformas que se qualificam.9As configurações gerenciadas pelo servidor permitem que Proprietários da organização configurem centralmente o Claude Code a partir de [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) no console claude.ai. Os clientes do Claude Code buscam essas configurações automaticamente quando os usuários se autenticam com uma credencial elegível em uma plataforma onde a entrega gerenciada pelo servidor é suportada. Consulte [Disponibilidade de plataforma](#platform-availability) para as credenciais e plataformas que se qualificam.

10 10 

11<Note>11<Note>

12 As configurações gerenciadas pelo servidor estão disponíveis para clientes do [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_teams#team-&-enterprise) e [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_enterprise).12 As configurações gerenciadas pelo servidor estão disponíveis para clientes do [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_teams#team-&-enterprise) e [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_enterprise).


41 41 

42<Steps>42<Steps>

43 <Step title="Abrir o console de administração">43 <Step title="Abrir o console de administração">

44 No console claude.ai, vá para [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code).44 No console claude.ai, vá para [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code).

45 45 

46 Se o link o redirecionar para uma página diferente de Admin Settings em vez da página Claude Code, sua conta não tem a função necessária. Funções de Admin e outras funções que não sejam Owner não podem visualizar ou editar configurações gerenciadas, portanto, peça a um Owner ou Primary Owner em sua organização para fazer a alteração. Veja [Controle de acesso](#access-control).46 Se o link o redirecionar para uma página diferente de Organization settings em vez da página Claude Code, sua conta não tem a função necessária. Funções de Admin e outras funções que não sejam Owner não podem visualizar ou editar configurações gerenciadas, portanto, peça a um Owner ou Primary Owner em sua organização para fazer a alteração. Veja [Controle de acesso](#access-control).

47 </Step>47 </Step>

48 48 

49 <Step title="Definir suas configurações">49 <Step title="Definir suas configurações">

sessions.md +1 −0

Details

292| [Nomear o diretório `<project>` você mesmo](#name-the-project-directory-yourself) | [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/pt/env-vars) | Variável de ambiente |292| [Nomear o diretório `<project>` você mesmo](#name-the-project-directory-yourself) | [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/pt/env-vars) | Variável de ambiente |

293| Alterar a retenção de 30 dias | [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) | `settings.json` |293| Alterar a retenção de 30 dias | [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) | `settings.json` |

294| Definir um limite de idade para [transcritos do Claude Desktop e Cowork](/docs/pt/claude-directory#cleaned-up-automatically) | [`desktopSessionCleanupPeriodDays`](/docs/pt/settings-reference#desktopsessioncleanupperioddays) | Configurações do usuário, configurações gerenciadas ou `--settings` |294| Definir um limite de idade para [transcritos do Claude Desktop e Cowork](/docs/pt/claude-directory#cleaned-up-automatically) | [`desktopSessionCleanupPeriodDays`](/docs/pt/settings-reference#desktopsessioncleanupperioddays) | Configurações do usuário, configurações gerenciadas ou `--settings` |

295| Limitar o tamanho que o arquivo de transcrição de uma sessão `-p` ou do Agent SDK pode atingir | [`CLAUDE_CODE_TRANSCRIPT_LOCAL_GC`](/docs/pt/env-vars) | Variável de ambiente |

295| Suprimir gravações de transcrição em todos os modos | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/pt/env-vars) | Variável de ambiente |296| Suprimir gravações de transcrição em todos os modos | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/pt/env-vars) | Variável de ambiente |

296| Suprimir gravações para uma execução não interativa | [`--no-session-persistence`](/docs/pt/cli-reference) | Sinalizador CLI com `claude -p` |297| Suprimir gravações para uma execução não interativa | [`--no-session-persistence`](/docs/pt/cli-reference) | Sinalizador CLI com `claude -p` |

297 298 

Details

990 990 

991Quando sua organização implanta qualquer configuração gerenciada, Claude Code lê essa chave apenas da fonte gerenciada e a ignora em seus outros arquivos.991Quando sua organização implanta qualquer configuração gerenciada, Claude Code lê essa chave apenas da fonte gerenciada e a ignora em seus outros arquivos.

992 992 

993Para saber como essa chave se aplica às verificações de modelo na inicialização, consulte [Amazon Bedrock](/docs/pt/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) e [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai#when-your-organization-enforces-a-model-allowlist).

994 

993* **Escopo**: [`Qualquer arquivo`](#scopes)995* **Escopo**: [`Qualquer arquivo`](#scopes)

994* **Tipo**: Boolean996* **Tipo**: Boolean

995 * `true`: quando **Padrão** resolveria para um modelo fora de `availableModels`, Claude Code o resolve para o primeiro modelo disponível na lista997 * `true`: quando **Padrão** resolveria para um modelo fora de `availableModels`, Claude Code o resolve para o primeiro modelo disponível na lista


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.3137* [`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.3138* [`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.3139* [`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.3140* [`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 3141 

3140<h3 id="filecheckpointingenabled">3142<h3 id="filecheckpointingenabled">

3141 `fileCheckpointingEnabled`3143 `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

487 487 

488Claude Code inicia PowerShell com `-ExecutionPolicy Bypass` apenas no escopo do processo, portanto scripts `.ps1` e importações de módulos funcionam em instalações padrão do Windows sem alterar a política da máquina. O bypass no escopo do processo não substitui a Group Policy `MachinePolicy` ou `UserPolicy`, portanto as políticas corporativas ainda se aplicam. Para respeitar a política de execução efetiva da máquina, defina `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1`.488Claude Code inicia PowerShell com `-ExecutionPolicy Bypass` apenas no escopo do processo, portanto scripts `.ps1` e importações de módulos funcionam em instalações padrão do Windows sem alterar a política da máquina. O bypass no escopo do processo não substitui a Group Policy `MachinePolicy` ou `UserPolicy`, portanto as políticas corporativas ainda se aplicam. Para respeitar a política de execução efetiva da máquina, defina `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1`.

489 489 

490<h3 id="bash-deny-rules-also-turn-off-the-powershell-tool">

491 Regras de negação do Bash também desativam a ferramenta PowerShell

492</h3>

493 

494No Windows com Git Bash instalado, negar o Bash também desativa a ferramenta PowerShell para a sessão. Isso se aplica a regras com escopo, como `Bash(git push *)`, bem como a um `Bash` simples, e a regras de um dos seus arquivos de configuração ou de `--disallowedTools`. Claude Code faz isso porque uma regra `Bash` não restringe a ferramenta PowerShell, que tem [suas próprias regras de permissão](/docs/pt/permissions#powershell). Com o PowerShell ativado, Claude poderia executar nele o que sua regra nega no Bash.

495 

496Para manter a ferramenta PowerShell ativada junto com uma regra de negação do Bash, faça uma destas opções:

497 

498* Defina `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` em seu ambiente ou no bloco `env` de um arquivo de configuração, conforme mostrado em [Ativar a ferramenta PowerShell](#enable-the-powershell-tool).

499* Adicione uma [regra de permissão `PowerShell`](/docs/pt/permissions#powershell) com escopo a um arquivo de configuração, como uma regra de negação `PowerShell(git push *)`.

500 

501Sem uma dessas opções, uma regra de negação do Bash com escopo deixa a ferramenta Bash disponível, e Claude Code desativa o PowerShell sem aviso. Uma regra que remove a ferramenta Bash inteira deixa Claude sem nenhuma ferramenta de shell para a sessão.

502 

490<h3 id="shell-selection-in-settings-hooks-and-skills">503<h3 id="shell-selection-in-settings-hooks-and-skills">

491 Seleção de shell em configurações, hooks e skills504 Seleção de shell em configurações, hooks e skills

492</h3>505</h3>

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 [**Organization settings > Connectors**](https://claude.ai/admin-settings/connectors). Até então, essa etapa mostra "GitHub access is required for Claude Code cloud sessions" 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 setup](/docs/pt/claude-code-on-the-web#quick-setup-for-team-and-enterprise) em [**Organization 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 setup](/docs/pt/claude-code-on-the-web#quick-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 setup](/docs/pt/claude-code-on-the-web#quick-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 setup](/docs/pt/claude-code-on-the-web#quick-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