Documentation — Spybara

agent-sdk/agent-loop.md +1 −1

Details

167 167

168### Permissões de ferramentas168### Permissões de ferramentas

169 169

170Claude determina quais ferramentas chamar com base na tarefa, mas você controla se essas chamadas podem ser executadas. Você pode aprovar automaticamente ferramentas específicas, bloquear outras completamente ou exigir aprovação para tudo. Três opções funcionam juntas para determinar o que é executado:170Claude determina quais ferramentas chamar com base na tarefa, mas você controla se essas chamadas podem ser executadas. Use estas opções para aprovar ferramentas automaticamente, bloquear ferramentas e definir o modo de permissão:

171 171

172* **`allowed_tools` / `allowedTools`** aprova automaticamente ferramentas listadas. Um agente somente leitura com `["Read", "Glob", "Grep"]` em sua lista de ferramentas permitidas executa essas ferramentas sem avisar, exceto leituras de [caminhos de rede](https://code.claude.com/docs/pt/permissions.md#network-paths). Ferramentas não listadas ainda estão disponíveis, e chamadas para elas que precisam de aprovação caem através do modo de permissão e `canUseTool`.172* **`allowed_tools` / `allowedTools`** aprova automaticamente ferramentas listadas. Um agente somente leitura com `["Read", "Glob", "Grep"]` em sua lista de ferramentas permitidas executa essas ferramentas sem avisar, exceto leituras de [caminhos de rede](https://code.claude.com/docs/pt/permissions.md#network-paths). Ferramentas não listadas ainda estão disponíveis, e chamadas para elas que precisam de aprovação caem através do modo de permissão e `canUseTool`.

173* **`disallowed_tools` / `disallowedTools`** bloqueia ferramentas listadas, independentemente de outras configurações. Veja [Permissões](https://code.claude.com/docs/pt/agent-sdk/permissions.md) para a ordem em que as regras são verificadas antes de uma ferramenta ser executada.173* **`disallowed_tools` / `disallowedTools`** bloqueia ferramentas listadas, independentemente de outras configurações. Veja [Permissões](https://code.claude.com/docs/pt/agent-sdk/permissions.md) para a ordem em que as regras são verificadas antes de uma ferramenta ser executada.

agent-sdk/cost-tracking.md +0 −2

Details

303 303

304A API relata a contagem de saída real no final da resposta, e Claude Code a adiciona à mensagem de resultado. Leia tokens de saída do `usage` do resultado, ou de `modelUsage` para uma divisão por modelo.304A API relata a contagem de saída real no final da resposta, e Claude Code a adiciona à mensagem de resultado. Leia tokens de saída do `usage` do resultado, ou de `modelUsage` para uma divisão por modelo.

305 305

306Para observar a contagem de saída de uma resposta crescer enquanto ela é transmitida, defina `includePartialMessages`, ou `include_partial_messages` em Python, e leia `usage` de cada evento de fluxo `message_delta`, digitado como [`SDKPartialAssistantMessage`](https://code.claude.com/docs/pt/agent-sdk/typescript#sdkpartialassistantmessage) em TypeScript e [`StreamEvent`](https://code.claude.com/docs/pt/agent-sdk/python#streamevent) em Python.

~~307~~

308### Rastrear custos em conversas falhadas306### Rastrear custos em conversas falhadas

309 307

310Tanto as mensagens de resultado de sucesso quanto as de erro incluem `usage` e `total_cost_usd`; em Python, ambos os campos são digitados como opcionais, portanto, verifique se não são `None` antes de lê-los.308Tanto as mensagens de resultado de sucesso quanto as de erro incluem `usage` e `total_cost_usd`; em Python, ambos os campos são digitados como opcionais, portanto, verifique se não são `None` antes de lê-los.

agent-sdk/hooks.md +1 −1

Details

228 228

229Use o padrão `matcher` para direcionar ferramentas específicas sempre que possível. Um matcher com `'Bash'` é executado apenas para comandos Bash, enquanto omitir o padrão executa seus callbacks para cada ocorrência do evento.229Use o padrão `matcher` para direcionar ferramentas específicas sempre que possível. Com um matcher `'Bash'`, seus callbacks são executados para comandos Bash. No Claude Code v2.1.314 ou posterior, eles também são executados em `PreToolUse` e `PermissionRequest` para comandos Monitor, que eles [podem negar, mas não aprovar](https://code.claude.com/docs/pt/hooks.md#match-monitor-commands). Sem matcher, eles são executados para cada ocorrência do evento.

230 230

231### Funções de callback231### Funções de callback

232 232

agent-sdk/plugins.md +4 −0

Details

70>70>

71> O caminho deve apontar para o diretório raiz do plugin: o diretório pai de `skills/`, `agents/`, `hooks/`, `commands/`, ou `.claude-plugin/`.71> O caminho deve apontar para o diretório raiz do plugin: o diretório pai de `skills/`, `agents/`, `hooks/`, `commands/`, ou `.claude-plugin/`.

72 72

73### Recarregar plugins em uma sessão em execução

75Para aplicar uma alteração às skills, comandos, agentes ou hooks de um plugin sem iniciar uma nova sessão, chame [`reloadPlugins()`](https://code.claude.com/docs/pt/agent-sdk/typescript#query-object) no objeto `Query` do SDK TypeScript. O SDK Python não expõe um método equivalente; em vez disso, envie [`/reload-plugins`](https://code.claude.com/docs/pt/plugins/cli-reference#reload-plugins) como um prompt na sessão.

73### Adicionar plugins a uma sessão em execução77### Adicionar plugins a uma sessão em execução

74 78

75No SDK TypeScript, chame [`reloadPlugins()`](https://code.claude.com/docs/pt/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) no objeto `Query` que `query()` retornou e liste o diretório do plugin na opção `addPlugins` dessa chamada. Cada entrada de `addPlugins` é um objeto `{ type: "local", path }` com um `path` absoluto. Requer o TypeScript Agent SDK v0.3.301 ou posterior.79No SDK TypeScript, chame [`reloadPlugins()`](https://code.claude.com/docs/pt/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) no objeto `Query` que `query()` retornou e liste o diretório do plugin na opção `addPlugins` dessa chamada. Cada entrada de `addPlugins` é um objeto `{ type: "local", path }` com um `path` absoluto. Requer o TypeScript Agent SDK v0.3.301 ou posterior.

agent-sdk/python.md +4 −11

Details

1387 1387

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

1389 1389

1390Como estas são classes `TypedDict`, elas são dicts simples em tempo de execução. Construa-as como literais de dict ou chame a classe como um construtor; ambos produzem um `dict`. Acesse campos com `config["budget_tokens"]`, não `config.budget_tokens`:1390Como estas são classes `TypedDict`, elas são dicts simples em tempo de execução. Construa-as como literais de dict ou chame a classe como um construtor; ambos produzem um `dict`. Acesse campos com `config["budget_tokens"]`, não `config.budget_tokens`:

1391 1391

2517 2517

2518### Exemplo de Uso de Hook2518### Exemplo de Uso de Hook

2519 2519

2520Este exemplo registra dois hooks: um que bloqueia comandos Bash perigosos como `rm -rf /`, e outro que registra todo o uso de ferramenta para auditoria. O hook de segurança funciona apenas em comandos Bash (via `matcher`), enquanto o hook de registro funciona em todas as ferramentas.2520Este exemplo registra dois hooks: um que bloqueia comandos Bash perigosos como `rm -rf /`, e outro que registra em log todo o uso de ferramentas para auditoria. Com seu [matcher `Bash`](https://code.claude.com/docs/pt/agent-sdk/hooks#matchers), o hook de segurança é executado em chamadas de ferramenta Bash. O hook de log não tem matcher, então é executado em todas as chamadas de ferramenta.

2521 2521

2522```python theme={null}2522```python theme={null}

2523import asyncio2523import asyncio

3668 3668

3669### `SandboxIgnoreViolations`3669### `SandboxIgnoreViolations`

3670 3670

3671Configuração para ignorar violações de sandbox específicas.3671Violações a deixar de fora do relatório de violações do sandbox. Cada chave corresponde a parte de um comando, ou `*` para todos os comandos, e cada valor lista textos a corresponder em uma linha de violação: `{"*": ["/etc/hosts"]}` oculta violações que mencionam `/etc/hosts`. Um acesso correspondente ainda é bloqueado. Veja [`sandbox.ignoreViolations`](https://code.claude.com/docs/pt/settings-reference#sandbox-ignoreviolations).

3672 3672

3673```python theme={null}3673```python theme={null}

3674class SandboxIgnoreViolations(TypedDict, total=False):3674SandboxIgnoreViolations = dict[str, list[str]]

3675 file: list[str]

3676 network: list[str]

3677```3675```

3678 3676

3680| :- | :- | :- | :- |

~~3683~~

3684### Fallback de Permissões para Comandos Sem Sandbox3677### Fallback de Permissões para Comandos Sem Sandbox

3685 3678

3686Quando `allowUnsandboxedCommands` está ativado, o modelo pode solicitar executar comandos fora do sandbox definindo `dangerouslyDisableSandbox: True` na entrada da ferramenta. Essas solicitações voltam para o sistema de permissões existente, significando que seu manipulador `can_use_tool` será invocado, permitindo que você implemente lógica de autorização personalizada.3679Quando `allowUnsandboxedCommands` está ativado, o modelo pode solicitar executar comandos fora do sandbox definindo `dangerouslyDisableSandbox: True` na entrada da ferramenta. Essas solicitações voltam para o sistema de permissões existente, significando que seu manipulador `can_use_tool` será invocado, permitindo que você implemente lógica de autorização personalizada.

agent-sdk/typescript.md +21 −9

Details

1931 1931

1932O mesmo par de campos aparece em [`SDKSystemMessage`](#sdksystemmessage) e em [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse), portanto você pode ler o estado do modo rápido antes do primeiro turno.1932O mesmo par de campos aparece em [`SDKSystemMessage`](#sdksystemmessage) e em [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse), portanto você pode ler o estado do modo rápido antes do primeiro turno.

1933 1933

1934O campo `origin` repassa o [`SDKMessageOrigin`](#sdkmessageorigin) da mensagem de usuário que disparou este resultado. Os resultados que carregam `origin: { kind: "task-notification" }` incluem:1934O campo `origin` contém a [`SDKMessageOrigin`](#sdkmessageorigin) que o Claude Code atribuiu à mensagem do usuário que acionou este resultado, não uma cópia do `origin` que você enviou. Resultados que carregam `origin: { kind: "task-notification" }` incluem:

1935 1935

1936* **Turnos sintéticos de acompanhamento**: quando o SDK injeta um turno sintético de acompanhamento, por exemplo, para uma tarefa em segundo plano concluída, o `SDKResultMessage` resultante carrega esse kind1936* **Turnos sintéticos de acompanhamento**: quando o SDK injeta um turno sintético de acompanhamento, por exemplo, para uma tarefa em segundo plano concluída, o `SDKResultMessage` resultante carrega esse kind

1937* **Tarefas agendadas disparadas e mensagens de outras sessões**: tarefas agendadas na nuvem cujo gatilho foi disparado e mensagens verificadas pelo servidor vindas das suas outras sessões também chegam com esse kind, cada uma com o `subkind` descrito em [Subkinds de task-notification](#task-notification-subkinds)1937* **Tarefas agendadas disparadas e mensagens de outras sessões**: tarefas agendadas na nuvem cujo gatilho foi disparado e mensagens verificadas pelo servidor vindas das suas outras sessões também chegam com esse kind, cada uma com o `subkind` descrito em [Subkinds de task-notification](#task-notification-subkinds)

1940 1940

1941Quando várias conclusões de tarefas em segundo plano são enfileiradas juntas, Claude Code pode respondê-las em um turno em vez de um turno para cada. Cada conclusão ainda produz seu próprio resultado com esta origem. Todas exceto a última das conclusões que Claude Code responde juntas produzem resultados vazios com `num_turns: 0`, em ordem, e o resultado da última carrega o turno que responde a todas elas.1941Quando várias conclusões de tarefas em segundo plano são enfileiradas juntas, Claude Code pode respondê-las em um turno em vez de um turno para cada. Cada conclusão ainda produz seu próprio resultado com esta origem. Todas exceto a última das conclusões que Claude Code responde juntas produzem resultados vazios com `num_turns: 0`, em ordem, e o resultado da última carrega o turno que responde a todas elas.

1942 1942

1943O campo está ausente para resultados emitidos antes de qualquer turno do usuário, como erros de inicialização.1943`origin` está ausente quando o Claude Code não atribuiu nenhuma, como:

1944

1945* Em um turno que você inicia com uma mensagem que não tem `origin` nem [`isSynthetic`](#sdkusermessage)

1946* Em resultados emitidos antes de qualquer turno do usuário, como erros de inicialização

1944 1947

1945Quando um hook `PreToolUse` retorna `permissionDecision: "defer"`, o resultado tem `stop_reason: "tool_deferred"` e `deferred_tool_use` carrega o `id`, `name` e `input` da ferramenta pendente. Leia este campo para exibir a requisição em sua própria interface, depois retome com o mesmo `session_id` para continuar. Consulte [Adiar uma chamada de ferramenta para depois](https://code.claude.com/docs/pt/hooks.md#defer-a-tool-call-for-later) para o ciclo completo.1948Quando um hook `PreToolUse` retorna `permissionDecision: "defer"`, o resultado tem `stop_reason: "tool_deferred"` e `deferred_tool_use` carrega o `id`, `name` e `input` da ferramenta pendente. Leia este campo para exibir a requisição em sua própria interface, depois retome com o mesmo `session_id` para continuar. Consulte [Adiar uma chamada de ferramenta para depois](https://code.claude.com/docs/pt/hooks.md#defer-a-tool-call-for-later) para o ciclo completo.

1946 1949

2435 2438

2436### `SDKMessageOrigin`2439### `SDKMessageOrigin`

2437 2440

2438Proveniência de uma mensagem com papel de usuário. Isso aparece como `origin` em [`SDKUserMessage`](#sdkusermessage) e é encaminhado para o [`SDKResultMessage`](#sdkresultmessage) correspondente para que você possa saber o que disparou um determinado turno.2441Procedência de uma mensagem com papel de usuário. Aparece como `origin` no [`SDKUserMessage`](#sdkusermessage). O [`SDKResultMessage`](#sdkresultmessage) de um turno carrega a `origin` que o Claude Code atribuiu, para que você possa saber o que acionou aquele turno.

2439 2442

2440```typescript theme={null}2443```typescript theme={null}

2441type SDKMessageOrigin =2444type SDKMessageOrigin =

2462 | { kind: "unclassified" };2465 | { kind: "unclassified" };

2463```2466```

2464 2467

2468Sua aplicação pode definir estes tipos de `origin` em uma mensagem que ela envia:

2469

2470* `{ kind: "human" }`: o que o usuário digitou

2471* `{ kind: "task-notification", subkind: "scheduled-trigger" }`: uma [execução agendada que você declara](#declare-a-scheduled-run)

2472

2473Deixe os outros tipos para o Claude Code e os servidores da Anthropic. Se você definir um desses tipos, o Claude lê a mensagem como sendo do usuário por padrão.

2474

2475Para enviar texto que o usuário não escreveu, como uma página obtida ou a saída de outro agente, envie-o como uma mensagem própria com [`isSynthetic`](#sdkusermessage) definido como `true` e `origin` não definido. Defina também [`client_composed`](#sdkusermessage) como `true`, para que texto que comece com `/` não seja executado como comando.

2476

2466| - | - |2478| - | - |

2467| `human` | Entrada direta do usuário final. Se sua aplicação encaminha o que o usuário digitou como uma mensagem de usuário, defina seu `origin` como `{ kind: "human" }` explicitamente: Claude Code trata uma mensagem de usuário sem `origin` como não atribuída, e verificações que exigem um prompt digitado por humano, como a [palavra-chave de workflow `ultracode`](https://code.claude.com/docs/pt/workflows#ask-for-a-workflow-in-your-prompt), não a aceitam. Antes de v2.1.210, Claude Code tratava um `origin` ausente em uma mensagem de usuário como entrada humana. |2479| `human` | Entrada direta do usuário final. Se a sua aplicação encaminha o que o usuário digitou como uma mensagem de usuário, defina a `origin` dela como `{ kind: "human" }`. Sem essa `origin`, o Claude ainda lê a mensagem como sendo do usuário, mas verificações que exigem um prompt digitado por um humano, como a [palavra-chave de fluxo de trabalho `ultracode`](https://code.claude.com/docs/pt/workflows#ask-for-a-workflow-in-your-prompt), não aceitam a mensagem. |

2468| `channel` | Mensagem chegando em um [canal](https://code.claude.com/docs/pt/channels.md). `server` é o nome do servidor MCP de origem. |2480| `channel` | Mensagem chegando em um [canal](https://code.claude.com/docs/pt/channels.md). `server` é o nome do servidor MCP de origem. |

2469| `peer` | Mensagem de outro agente: um [colega](https://code.claude.com/docs/pt/agent-teams.md) em processo ou um [par entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md), outra de suas sessões Claude Code. Consulte [Campos de origem de par](#peer-origin-fields) para a semântica por campo e o modelo de confiança. |2481| `peer` | Mensagem de outro agente do Claude Code: um [colega de equipe](https://code.claude.com/docs/pt/agent-teams.md) no mesmo processo ou um [par entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md), outra de suas sessões do Claude Code. O [aplicativo desktop](https://code.claude.com/docs/pt/desktop.md#work-across-sessions), que retransmite essas mensagens entre suas sessões, declara este tipo com [`fromMode`](#peer-origin-fields). Para retransmitir a saída de outro agente a partir da sua própria aplicação, defina `isSynthetic` e `client_composed` em vez disso. Consulte [Campos de origem peer](#peer-origin-fields) para a semântica de cada campo e o modelo de confiança. |

2470| `task-notification` | Turno sintético injetado para uma entrega que chega sem um novo prompt do usuário, como uma tarefa em segundo plano concluída; consulte [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) para esse braço. Um prompt que sua aplicação [declara como uma execução agendada](#declare-a-scheduled-run) carrega este tipo também. O `subkind` opcional marca o que levantou a notificação. Consulte [Subtipos de notificação de tarefa](#task-notification-subkinds). |2482| `task-notification` | Turno sintético injetado para uma entrega que chega sem um novo prompt do usuário, como uma tarefa em segundo plano concluída; consulte [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) para esse braço. Um prompt que sua aplicação [declara como uma execução agendada](#declare-a-scheduled-run) carrega este tipo também. O `subkind` opcional marca o que levantou a notificação. Consulte [Subtipos de notificação de tarefa](#task-notification-subkinds). |

2471| `coordinator` | Mensagem de um coordenador de equipe em uma [equipe de agentes](https://code.claude.com/docs/pt/agent-teams.md). |2483| `coordinator` | Mensagem de um coordenador de equipe em uma [equipe de agentes](https://code.claude.com/docs/pt/agent-teams.md). |

2472| `auto-continuation` | Turno sintético injetado quando a sessão continua sem nova entrada do usuário, como um resultado de comando que dispara um prompt de acompanhamento. |2484| `auto-continuation` | Turno sintético injetado quando a sessão continua sem nova entrada do usuário, como um resultado de comando que dispara um prompt de acompanhamento. |

2473| `unclassified` | Turno injetado cuja origem não pôde ser determinada. Requer Claude Code v2.1.223 ou posterior. Quando Claude Code recebe um [`SDKUserMessage`](#sdkusermessage) com `isSynthetic: true` e não consegue classificá-lo como nenhum outro `kind`, define este tipo quando a mensagem chega e enquadra o turno para o modelo como uma fonte que não é o usuário, em vez de tratá-lo como entrada humana. Sua aplicação não deve definir este valor. |2485| `unclassified` | Mensagem marcada como não vinda do usuário, como um [`SDKUserMessage`](#sdkusermessage) que você envia com `isSynthetic: true`. Requer o Claude Code v2.1.223 ou posterior. |

2474 2486

2475### Subtipos de notificação de tarefa2487### Subtipos de notificação de tarefa

2476 2488

2494Um origin `peer` identifica qual agente enviou a mensagem: um [colega de equipe](https://code.claude.com/docs/pt/agent-teams.md) no mesmo processo enviando para `main` com `SendMessage`, ou um [par entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md), outra de suas sessões do Claude Code. Pares entre sessões requerem Claude Code v2.1.224 ou posterior no macOS e no Linux; consulte [disponibilidade de mensagens entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md#availability) para o requisito no Windows nativo. Um par entre sessões pode ser executado na mesma máquina ou em [outra de suas máquinas](https://code.claude.com/docs/pt/cross-session-messaging.md#message-sessions-on-other-machines) quando sua mensagem chega pelo [Remote Control](https://code.claude.com/docs/pt/remote-control.md).2506Um origin `peer` identifica qual agente enviou a mensagem: um [colega de equipe](https://code.claude.com/docs/pt/agent-teams.md) no mesmo processo enviando para `main` com `SendMessage`, ou um [par entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md), outra de suas sessões do Claude Code. Pares entre sessões requerem Claude Code v2.1.224 ou posterior no macOS e no Linux; consulte [disponibilidade de mensagens entre sessões](https://code.claude.com/docs/pt/cross-session-messaging.md#availability) para o requisito no Windows nativo. Um par entre sessões pode ser executado na mesma máquina ou em [outra de suas máquinas](https://code.claude.com/docs/pt/cross-session-messaging.md#message-sessions-on-other-machines) quando sua mensagem chega pelo [Remote Control](https://code.claude.com/docs/pt/remote-control.md).

2495 2507

2496* `from`: o nome do colega, ou o endereço do remetente para um par entre sessões. Para uma [mensagem unidirecional entre máquinas](https://code.claude.com/docs/pt/cross-session-messaging.md#message-sessions-on-other-machines), o remetente não tem endereço de resposta e `from` é `"unknown"`. O valor é definido pelo remetente; `verifiedPeerPid` é a identidade verificada.2508* `from`: o nome do colega, ou o endereço do remetente para um par entre sessões. Para uma [mensagem unidirecional entre máquinas](https://code.claude.com/docs/pt/cross-session-messaging.md#message-sessions-on-other-machines), o remetente não tem endereço de resposta e `from` é `"unknown"`. O valor é definido pelo remetente; `verifiedPeerPid` é a identidade verificada.

2497* `fromMode`: a classe de permissão da sessão remetente, `bypass` ou `prompting`, declarada por um host que retransmite uma mensagem de par entre suas sessões, como o [aplicativo de desktop](https://code.claude.com/docs/pt/desktop.md#work-across-sessions). Claude Code a lê na sessão receptora quando aplica os [controles de entrada](https://code.claude.com/docs/pt/cross-session-messaging.md#control-inbound-messages). Requer Agent SDK v0.3.234 ou posterior.2509* `fromMode`: a classe de permissão da sessão remetente, `bypass` ou `prompting`. O Claude Code a lê na sessão receptora ao aplicar os [controles de entrada](https://code.claude.com/docs/pt/cross-session-messaging.md#control-inbound-messages). Requer o Agent SDK v0.3.234 ou posterior.

2498* `senderTaskId`: o ID de tarefa do colega. Ausente para um par entre sessões.2510* `senderTaskId`: o ID de tarefa do colega. Ausente para um par entre sessões.

2499* `name`: o nome de exibição do remetente, normalizado por Claude Code: ele remove pontos de código Unicode de controle, formato, substitutos e separadores de linha ou parágrafo, depois apara o resultado e o limita a 64 pontos de código com reticências. Requer Claude Code v2.1.205 ou posterior.2511* `name`: o nome de exibição do remetente, normalizado por Claude Code: ele remove pontos de código Unicode de controle, formato, substitutos e separadores de linha ou parágrafo, depois apara o resultado e o limita a 64 pontos de código com reticências. Requer Claude Code v2.1.205 ou posterior.

2500* `body`: o corpo decodificado da mensagem com o envelope peer removido, idêntico byte a byte ao que o modelo vê. Presente para uma única mensagem de colega de equipe, ausente quando várias são mescladas; para um par entre sessões, presente apenas quando o turno é exatamente um envelope peer formado pelo Claude Code. Renderize `name` e `body` em vez de analisar novamente o texto da mensagem. Antes da v2.1.299, mensagens mescladas mantinham o `body` da primeira mensagem. Requer Claude Code v2.1.205 ou posterior.2512* `body`: o corpo decodificado da mensagem com o envelope peer removido, idêntico byte a byte ao que o modelo vê. Presente para uma única mensagem de colega de equipe, ausente quando várias são mescladas; para um par entre sessões, presente apenas quando o turno é exatamente um envelope peer formado pelo Claude Code. Renderize `name` e `body` em vez de analisar novamente o texto da mensagem. Antes da v2.1.299, mensagens mescladas mantinham o `body` da primeira mensagem. Requer Claude Code v2.1.205 ou posterior.

5421 | { type: "disabled" }; // No extended thinking5433 | { type: "disabled" }; // No extended thinking

5422```5434```

5423 5435

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

5425 5437

5426### `SpawnedProcess`5438### `SpawnedProcess`

5427 5439

6042| `allowUnsandboxedCommands` | `boolean` | `true` | Permitir que o modelo solicite executar comandos fora do sandbox. Quando `true`, o modelo pode definir `dangerouslyDisableSandbox` na entrada da ferramenta, que faz fallback para o [sistema de permissões](#permissions-fallback-for-unsandboxed-commands) |6054| `allowUnsandboxedCommands` | `boolean` | `true` | Permitir que o modelo solicite executar comandos fora do sandbox. Quando `true`, o modelo pode definir `dangerouslyDisableSandbox` na entrada da ferramenta, que faz fallback para o [sistema de permissões](#permissions-fallback-for-unsandboxed-commands) |

6045| `ignoreViolations` | `Record<string, string[]>` | `undefined` | Mapa de substrings de comando, ou `*` para cada comando, para substrings do texto de violação a ignorar, como `{ "*": ['/etc/hosts'] }`; veja [`sandbox.ignoreViolations`](https://code.claude.com/docs/pt/settings-reference#sandbox-ignoreviolations) |6057| `ignoreViolations` | `Record<string, string[]>` | `undefined` | Violações a omitir do relatório de violações do sandbox. Cada chave corresponde a parte de um comando, ou `*` para todos os comandos, e cada valor lista o texto a ser correspondido em uma linha de violação: `{ "*": ['/etc/hosts'] }` oculta violações que mencionam `/etc/hosts`. Veja [`sandbox.ignoreViolations`](https://code.claude.com/docs/pt/settings-reference#sandbox-ignoreviolations) |

6047| `allowNestedUserNamespaces` | `boolean` | `false` | Permitir que comandos em sandbox no Linux e WSL2 criem user namespaces. Antes de defini-lo como `true`, leia [`sandbox.allowNestedUserNamespaces`](https://code.claude.com/docs/pt/settings-reference#sandbox-allownestedusernamespaces), que cobre as ferramentas que precisam disso e o limite de segurança que você desativa. Requer Claude Code v2.1.305 ou posterior |6059| `allowNestedUserNamespaces` | `boolean` | `false` | Permitir que comandos em sandbox no Linux e WSL2 criem user namespaces. Antes de defini-lo como `true`, leia [`sandbox.allowNestedUserNamespaces`](https://code.claude.com/docs/pt/settings-reference#sandbox-allownestedusernamespaces), que cobre as ferramentas que precisam disso e o limite de segurança que você desativa. Requer Claude Code v2.1.305 ou posterior |

6048| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | Configuração de binário ripgrep personalizado para ambientes sandbox |6060| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | Configuração de binário ripgrep personalizado para ambientes sandbox |

agent-teams.md +1 −1

Details

296>296>

297> Para que ele pergunte antes de editar, pressione Enter na linha `main` do painel de agentes e mude o líder para o modo Manual também. O líder então também pergunta, assim como qualquer outro companheiro de equipe no modo Manual.297> Para que ele pergunte antes de editar, pressione Enter na linha `main` do painel de agentes e mude o líder para o modo Manual também. O líder então também pergunta, assim como qualquer outro companheiro de equipe no modo Manual.

298 298

299Você não pode definir modos de permissão por companheiro de equipe no momento da geração. Um novo companheiro de equipe começa com o modo do líder, incluindo o modo `bypassPermissions`, que `--dangerously-skip-permissions` ativa. Se o líder estiver no [modo `dontAsk`](https://code.claude.com/docs/pt/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), o companheiro de equipe começa no [modo Manual](https://code.claude.com/docs/pt/permission-modes.md#available-modes) em vez disso.299Você não pode definir modos de permissão por companheiro de equipe no momento da geração. Um novo companheiro de equipe começa com o modo do líder, incluindo o modo `bypassPermissions`, que `--dangerously-skip-permissions` ativa. Se o líder estiver no [modo `dontAsk`](https://code.claude.com/docs/pt/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), o companheiro de equipe começa no [modo Manual](https://code.claude.com/docs/pt/permission-modes.md#available-modes) em vez disso. Para um companheiro de equipe em painel dividido de um líder no modo Manual ou `dontAsk`, isso requer Claude Code v2.1.317 ou posterior.

300 300

301Um companheiro de equipe [em processo](#choose-a-display-mode) é executado sob as regras de allow e deny ativas do líder, portanto [`--disallowedTools`](https://code.claude.com/docs/pt/cli-reference#cli-flags), `--tools` e `--allowedTools` se aplicam a ele. Para um companheiro de equipe em painel dividido, verifique cada flag:301Um companheiro de equipe [em processo](#choose-a-display-mode) é executado sob as regras de allow e deny ativas do líder, portanto [`--disallowedTools`](https://code.claude.com/docs/pt/cli-reference#cli-flags), `--tools` e `--allowedTools` se aplicam a ele. Para um companheiro de equipe em painel dividido, verifique cada flag:

302 302

artifacts.md +1 −1

Details

141 141

142* **Sessão na nuvem sem acesso à rede**: para um [ambiente na nuvem](https://code.claude.com/docs/pt/cloud-environments.md#access-levels), esse é o nível **None**. No [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode), o classificador pode aprovar em vez disso; em uma sessão do [Cowork](https://claude.com/product/cowork), a aprovação é exclusivamente sua.142* **Sessão na nuvem sem acesso à rede**: para um [ambiente na nuvem](https://code.claude.com/docs/pt/cloud-environments.md#access-levels), esse é o nível **None**. No [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode), o classificador pode aprovar em vez disso; em uma sessão do [Cowork](https://claude.com/product/cowork), a aprovação é exclusivamente sua.

143* **Artefato público de outra organização**: Claude Code pergunta a você primeiro, mesmo no modo auto. Quando Claude Code não pode perguntar a você, como no modo `bypassPermissions`, Claude não pode ler o artefato. Claude só pode ler esses artefatos enquanto a [busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching) estiver ativada.143* **Artefato público de outra organização**: Claude Code pergunta a você primeiro, mesmo no modo auto. Quando Claude Code não pode perguntar a você, como no modo `bypassPermissions`, Claude não pode ler o artefato. Claude só pode ler esses artefatos enquanto a [busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching) estiver ativada.

144* **Proprietário ou configuração de rede não confirmados**: quando Claude Code não consegue confirmar quem criou o artefato, ou não consegue confirmar a configuração de rede de uma sessão na nuvem, ele pergunta, e sua aprovação cobre apenas essa requisição.144* **Proprietário ou configuração de rede não confirmados**: quando Claude Code não consegue confirmar quem criou o artefato, ou não consegue confirmar a configuração de rede de uma sessão na nuvem, ele pergunta, e sua aprovação cobre apenas essa requisição. No [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode), o classificador pode aprovar ou bloquear a leitura em vez de perguntar a você.

145* **Modo de planejamento**: no [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode), Claude Code pergunta antes que a ferramenta Artifact leia um artefato criado por outra pessoa da sua organização.145* **Modo de planejamento**: no [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode), Claude Code pergunta antes que a ferramenta Artifact leia um artefato criado por outra pessoa da sua organização.

146 146

147Quando Claude lê o artefato com WebFetch, as próprias [regras de solicitação](https://code.claude.com/docs/pt/tools-reference.md#webfetch-tool-behavior) do WebFetch ainda se aplicam.147Quando Claude lê o artefato com WebFetch, as próprias [regras de solicitação](https://code.claude.com/docs/pt/tools-reference.md#webfetch-tool-behavior) do WebFetch ainda se aplicam.

auto-mode-classifier-billing.md +6 −1

Details

29 29

30## Tornar a sessão elegível30## Tornar a sessão elegível

31 31

32Se um gateway for a causa, peça ao administrador da sua empresa ou ao provedor do seu gateway para passar solicitações e respostas inalteradas. Isso significa encaminhar cabeçalhos de solicitação e campos de corpo conforme estão, incluindo aqueles que o gateway não reconhece, como o campo de solicitação `safeguards`, e retornar respostas e eventos de streaming sem descartar chaves como o campo `safeguard_results` ou reescrever IDs de uso de ferramentas, conforme o [guia de compatibilidade de gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#feature-pass-through) descreve. Um gateway que passa tráfego dessa forma continua funcionando com este recurso e com futuros. Novas sessões então usam as verificações do servidor novamente.32Se um gateway impede que as verificações do lado do servidor do modo auto cheguem às suas sessões e não é você quem o opera, envie os requisitos abaixo ao administrador da sua empresa ou ao provedor do seu gateway. Quando [o upstream aceita o formato que o gateway recebe](https://code.claude.com/docs/pt/llm-gateway-protocol.md#format-mismatch-with-the-upstream), o Claude Code espera que o gateway passe requisições e respostas inalteradas, conforme o [guia de compatibilidade de gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#feature-pass-through) descreve:

34* **Requisições**: para deixar as verificações passarem, o gateway encaminha tanto o cabeçalho `anthropic-beta` quanto o campo de corpo `safeguards` inalterados, porque [os dois viajam como um par](https://code.claude.com/docs/pt/llm-gateway-protocol.md#beta-header-and-body-field-pairs). No [formato InvokeModel do Amazon Bedrock](https://code.claude.com/docs/pt/llm-gateway-protocol.md#api-formats), ele encaminha o campo de corpo `anthropic_beta` no lugar do cabeçalho.

35* **Respostas**: o gateway retorna respostas e eventos de streaming sem descartar campos ou reescrever IDs de uso de ferramentas. Para deixar os resultados das verificações passarem, ele mantém o campo `safeguard_results`.

37Um gateway que passa tráfego dessa forma continua funcionando com este recurso e com futuros. Novas sessões então usam as verificações do servidor novamente.

33 38

34Se você já sabe que seu gateway não pode fornecer as verificações do servidor, diga ao Claude Code para não pedir por elas lá definindo `CLAUDE_CODE_AUTO_MODE_SERVER` para `0` antes de iniciar a sessão, em seu shell ou na [chave de configurações `env`](https://code.claude.com/docs/pt/settings-reference#env):39Se você já sabe que seu gateway não pode fornecer as verificações do servidor, diga ao Claude Code para não pedir por elas lá definindo `CLAUDE_CODE_AUTO_MODE_SERVER` para `0` antes de iniciar a sessão, em seu shell ou na [chave de configurações `env`](https://code.claude.com/docs/pt/settings-reference#env):

35 40

channels.md +1 −1

Details

355| - | - | - |355| - | - | - |

356| [Sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) | Executa tarefas em uma nova sandbox na nuvem, clonada do GitHub | Delegar trabalho assíncrono independente que você verifica depois |356| [Sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) | Executa tarefas em uma nova sandbox na nuvem, clonada do GitHub | Delegar trabalho assíncrono independente que você verifica depois |

357| [Claude no Slack](https://code.claude.com/docs/pt/slack.md) | Gera uma sessão na nuvem a partir de uma menção `@Claude` em um canal ou thread | Iniciar tarefas diretamente do contexto de conversa da equipe |357| [Claude no Slack](https://code.claude.com/docs/pt/slack.md) | Gera uma sessão na nuvem a partir de uma menção `@Claude` em um canal ou thread | Iniciar tarefas diretamente de uma conversa da equipe |

358| Servidor [MCP](https://code.claude.com/docs/pt/mcp.md) padrão | Claude o consulta durante uma tarefa; nada é enviado para a sessão | Dar ao Claude acesso sob demanda para ler ou consultar um sistema |358| Servidor [MCP](https://code.claude.com/docs/pt/mcp.md) padrão | Claude o consulta durante uma tarefa; nada é enviado para a sessão | Dar ao Claude acesso sob demanda para ler ou consultar um sistema |

359| [Remote Control](https://code.claude.com/docs/pt/remote-control.md) | Você dirige sua sessão local de claude.ai ou do aplicativo móvel Claude | Dirigir uma sessão em andamento enquanto está longe de sua mesa |359| [Remote Control](https://code.claude.com/docs/pt/remote-control.md) | Você dirige sua sessão local de claude.ai ou do aplicativo móvel Claude | Dirigir uma sessão em andamento enquanto está longe de sua mesa |

360 360

claude-apps-gateway.md +4 −6

Details

350 350

351### Entregar política para sessões Claude Desktop351### Entregar política para sessões Claude Desktop

352 352

353O Claude Desktop executa suas abas Cowork e Code, além do Chat quando você o habilita, em sessões incorporadas do Claude Code e envia as requisições de modelo delas através do gateway. Ele passa a política para cada uma dessas sessões, construída a partir da configuração que o gateway fornece a ele em `/user/bootstrap`: a allowlist de modelos, as ferramentas desabilitadas e a allowlist de egress derivadas do bloco `cli` ou `code` da política correspondente, além da [sobreposição `desktop`](https://code.claude.com/docs/pt/claude-apps-gateway-config#claude-desktop-overlay).353O Claude Desktop executa suas abas em sessões incorporadas do Claude Code e envia as requisições de modelo delas através do gateway. Ele passa a política para cada uma dessas sessões, construída a partir da configuração que o gateway fornece a ele em `/user/bootstrap`. Essa configuração contém a allowlist de modelos, as ferramentas desabilitadas e a allowlist de egress derivadas do bloco `cli` ou `code` da política correspondente, além da [sobreposição `desktop`](https://code.claude.com/docs/pt/claude-apps-gateway-config#claude-desktop-overlay).

354 354

355As outras chaves do bloco, como hooks, `env` e regras de permissão com escopo como `Bash(npm *)`, alcançam clientes que fazem login através de `/login`. Sob `code`, elas também alcançam a sessão da aba Code quando as [condições para a aba Code](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#apply-code-settings-in-the-code-tab) são atendidas. Elas não alcançam sessões Cowork ou Chat. 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).355As outras chaves do bloco, como hooks, `env` e regras de permissão com escopo como `Bash(npm *)`, alcançam clientes que fazem login através de `/login`. Sob `code`, elas também alcançam a sessão da aba Code quando as [condições para a aba Code](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#apply-code-settings-in-the-code-tab) são atendidas. Elas não alcançam sessões Cowork ou Chat. 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).

356 356

476 476

477### Conectar Claude Desktop477### Conectar Claude Desktop

478 478

479[Claude Desktop](https://code.claude.com/docs/pt/desktop.md) se conecta ao mesmo gateway através de uma chave MDM diferente: defina `bootstrapUrl` na [configuração gerenciada](https://claude.com/docs/third-party/claude-desktop/configuration) do Claude Desktop para `<listen.public_url>/user/bootstrap`, e opte pela política do usuário com uma chave `desktop`. [Sobreposição Claude Desktop](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#claude-desktop-overlay) cobre ambas as metades. Requer Claude Code v2.1.203 ou posterior no servidor do gateway.479[Claude Desktop](https://code.claude.com/docs/pt/desktop.md) se conecta ao mesmo gateway através de uma chave MDM diferente: defina `bootstrapUrl` na [configuração gerenciada](https://claude.com/docs/third-party/claude-desktop/configuration) do Claude Desktop para `<listen.public_url>/user/bootstrap`, e opte pela política do usuário com uma chave `desktop`. [Sobreposição Claude Desktop](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#claude-desktop-overlay) cobre ambas as metades. Requer Claude Code v2.1.203 ou posterior no servidor do gateway. Uma vez conectado, Claude Desktop envia requisições de modelo de cada aba habilitada através do gateway.

480 480

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

482 482

483Uma 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 disponibilizar também a aba Chat, defina `chatTabEnabled` como `true` no [bloco `desktop`](https://code.claude.com/docs/pt/claude-apps-gateway-config#claude-desktop-overlay) da política em um gateway executando Claude Code v2.1.227 ou posterior. Com Cowork ativado, Claude Desktop então mostra Chat e Cowork juntos em uma única aba.

~~484~~

485### Pipelines de CI e máquinas remotas483### Pipelines de CI e máquinas remotas

486 484

487Não há fluxo de token de serviço para pipelines não supervisionados. O sign-in do gateway sempre executa o fluxo de dispositivo do navegador, então um trabalho de CI sem um desenvolvedor para aprovar o sign-in não pode se autenticar; configure aqueles contra seu provedor diretamente. Implante `forceLoginMethod` e `forceLoginGatewayUrl` nas máquinas dos desenvolvedores e deixe-os fora dos runners de CI. Em uma máquina cujas configurações gerenciadas os definem, uma sessão que se autentica com `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` [sai na inicialização](https://code.claude.com/docs/pt/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in).485Não há fluxo de token de serviço para pipelines não supervisionados. O sign-in do gateway sempre executa o fluxo de dispositivo do navegador, então um trabalho de CI sem um desenvolvedor para aprovar o sign-in não pode se autenticar; configure aqueles contra seu provedor diretamente. Implante `forceLoginMethod` e `forceLoginGatewayUrl` nas máquinas dos desenvolvedores e deixe-os fora dos runners de CI. Em uma máquina cujas configurações gerenciadas os definem, uma sessão que se autentica com `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` [sai na inicialização](https://code.claude.com/docs/pt/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in).

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 do Amazon Bedrock usa o endpoint `bedrock-runtime` e a cadeia de credenciais padrão da AWS. O [upstream do Amazon Bedrock Mantle](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#amazon-bedrock-mantle-endpoint) requer o Claude Code v2.1.283 ou posterior no servidor do gateway, e o [upstream do Claude Platform on AWS](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#claude-platform-on-aws) requer v2.1.198 ou posterior. |521| 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 do Amazon Bedrock usa o endpoint `bedrock-runtime` e a cadeia de credenciais padrão da AWS. O [upstream do Amazon Bedrock Mantle](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#amazon-bedrock-mantle-endpoint) requer o Claude Code v2.1.283 ou posterior no servidor do gateway, e o [upstream do Claude Platform on AWS](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#claude-platform-on-aws) requer v2.1.198 ou posterior. |

524| Janela de contexto de 1M de tokens | Disponível | Os modelos Fable, Sonnet 5 e posteriores, e Opus 4.7 e posteriores são executados com a janela de 1M por padrão; consulte [Contexto estendido](https://code.claude.com/docs/pt/model-config.md#extended-context). O padrão de 1M para os modelos Fable e Opus requer o Claude Code v2.1.287 ou posterior na máquina do desenvolvedor |522| Janela de contexto de 1M de tokens | Disponível | Os modelos Fable, Sonnet 5 e posteriores, e Opus 4.7 e posteriores são executados com a janela de 1M por padrão; consulte [Contexto estendido](https://code.claude.com/docs/pt/model-config.md#extended-context). O padrão de 1M para os modelos Fable e Opus requer o Claude Code v2.1.287 ou posterior na máquina do desenvolvedor |

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

526| Claude Desktop | Disponível mediante opt-in | O gateway fornece a configuração do Claude Desktop em `/user/bootstrap` assim que uma política [faz opt-in com uma chave `desktop`](https://code.claude.com/docs/pt/claude-apps-gateway-config#claude-desktop-overlay), e o Claude Desktop envia suas requisições de modelo por meio do gateway. Para ativar o Chat, consulte [Conectar o Claude Desktop](#connect-claude-desktop). Requer o Claude Code v2.1.203 ou posterior no servidor do gateway. |524| Claude Desktop | Disponível mediante opt-in | Faça opt-in de uma política com uma [chave `desktop`](https://code.claude.com/docs/pt/claude-apps-gateway-config#claude-desktop-overlay). Requer o Claude Code v2.1.203 ou posterior no servidor do gateway. |

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

542| Helm chart | Não disponível | O gateway é executado como um Deployment padrão sem estado; consulte o [guia de implantação](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md#kubernetes) |540| Helm chart | Não disponível | O gateway é executado como um Deployment padrão sem estado; consulte o [guia de implantação](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md#kubernetes) |

543| Interface de administração | Não disponível | A configuração é o arquivo YAML; faça uma nova implantação para alterá-la |541| Interface de administração | Apenas limites de gastos | No Claude Desktop 4.23118.0 ou posterior [conectado ao gateway](#connect-claude-desktop), os membros de [`admin.admin_groups`](https://code.claude.com/docs/pt/claude-apps-gateway-config#admin) podem gerenciar limites de gastos. O restante da configuração é o arquivo YAML; faça uma nova implantação para alterá-la |

544 542

545## Próximas etapas543## Próximas etapas

546 544

claude-apps-gateway-config.md +1 −1

Details

1651| `reply_tokens` | Não | Padrão `750`. Aproximadamente quantos tokens de texto cada resposta pré-definida contém, um número inteiro de 1 a 100000. |1651| `reply_tokens` | Não | Padrão `750`. Aproximadamente quantos tokens de texto cada resposta pré-definida contém, um número inteiro de 1 a 100000. |

1652| `reply_seconds` | Não | Padrão `9.5`. Quanto tempo uma resposta transmitida leva, de 0 a 600. `0` envia a resposta inteira de uma vez. Uma resposta a uma requisição sem streaming sempre retorna de uma vez. |1652| `reply_seconds` | Não | Padrão `9.5`. Quanto tempo uma resposta transmitida leva, de 0 a 600. `0` envia a resposta inteira de uma vez. Uma resposta a uma requisição sem streaming sempre retorna de uma vez. |

1653 1653

1654Um teste de carga nesse modo abrange o gateway, o seu Postgres e tudo o que está à frente do gateway. Ele não abrange os limites, a velocidade nem o caminho de rede do provedor.1654Um teste de carga neste modo abrange o gateway, seu Postgres e tudo o que estiver na frente do gateway. Ele não abrange os limites, a velocidade e o caminho de rede do provedor, nem a espera no [limite de requisições upstream simultâneas](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md#concurrent-upstream-requests) de cada réplica. Uma réplica ainda registra em log o aviso `client requests are open` quando há mais requisições abertas do que esse limite, o ponto em que as requisições de produção começam a esperar.

1655 1655

1656Nenhuma requisição de modelo é enviada ao provedor, portanto a CPU por requisição de uma réplica é uma estimativa e aparece menor do que em produção, que também criptografa seu tráfego para o provedor. Confirme a quantidade de réplicas com um pequeno piloto contra o provedor real. Antes da v2.1.283, a estimativa aparece muito menor.1656Nenhuma requisição de modelo é enviada ao provedor, portanto a CPU por requisição de uma réplica é uma estimativa e aparece menor do que em produção, que também criptografa seu tráfego para o provedor. Confirme a quantidade de réplicas com um pequeno piloto contra o provedor real. Antes da v2.1.283, a estimativa aparece muito menor.

1657 1657

claude-apps-gateway-deploy.md +2 −0

Details

202>202>

203> Cada solicitação aberta mantém memória no processo do gateway enquanto ela flui e enquanto aguarda por um slot. Se você manter o limite em 256, a memória em uma réplica sobrecarregada ainda crescerá, porque as solicitações em espera mantêm seus corpos de solicitação. Dimensione a memória do contêiner para o número de solicitações abertas no pico e observe a memória quando você alterar o limite. Uma réplica que fica sem memória é eliminada e descarta cada fluxo que mantém.203> Cada solicitação aberta mantém memória no processo do gateway enquanto ela flui e enquanto aguarda por um slot. Se você manter o limite em 256, a memória em uma réplica sobrecarregada ainda crescerá, porque as solicitações em espera mantêm seus corpos de solicitação. Dimensione a memória do contêiner para o número de solicitações abertas no pico e observe a memória quando você alterar o limite. Uma réplica que fica sem memória é eliminada e descarta cada fluxo que mantém.

204 204

205Em um teste de carga com [`load_test_mode`](https://code.claude.com/docs/pt/claude-apps-gateway-config#load_test_mode), as solicitações não aguardam nesse limite, mas uma réplica ainda registra o aviso `client requests are open`.

206

205### Mantenha `API_TIMEOUT_MS` acima do tempo até o primeiro byte do gateway207### Mantenha `API_TIMEOUT_MS` acima do tempo até o primeiro byte do gateway

206 208

207Se você reduzir [`API_TIMEOUT_MS`](https://code.claude.com/docs/pt/network-config#streaming-idle-watchdogs) para tentar novamente mais cedo uma requisição sem resposta, mantenha-o acima do tempo que o gateway leva para enviar os primeiros bytes de uma resposta de streaming. Uma requisição que espera mais do que isso atinge o timeout, assim como cada nova tentativa que espera o mesmo tempo, até que o turno termine com `Request timed out`, a menos que o [prazo do primeiro byte](#retry-an-unanswered-request-sooner-with-the-first-byte-deadline) o encerre.209Se você reduzir [`API_TIMEOUT_MS`](https://code.claude.com/docs/pt/network-config#streaming-idle-watchdogs) para tentar novamente mais cedo uma requisição sem resposta, mantenha-o acima do tempo que o gateway leva para enviar os primeiros bytes de uma resposta de streaming. Uma requisição que espera mais do que isso atinge o timeout, assim como cada nova tentativa que espera o mesmo tempo, até que o turno termine com `Request timed out`, a menos que o [prazo do primeiro byte](#retry-an-unanswered-request-sooner-with-the-first-byte-deadline) o encerre.

claude-apps-gateway-on-aws.md +1 −0

Details

628 628

629* [Referência de configuração](https://code.claude.com/docs/pt/claude-apps-gateway-config.md): cada opção `gateway.yaml`, incluindo `managed.policies` e `telemetry`629* [Referência de configuração](https://code.claude.com/docs/pt/claude-apps-gateway-config.md): cada opção `gateway.yaml`, incluindo `managed.policies` e `telemetry`

630* [Implantação e operações](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md): configuração de IdP, verificações de saúde, rotação de segredo JWT, upgrades e o modelo de segurança630* [Implantação e operações](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md): configuração de IdP, verificações de saúde, rotação de segredo JWT, upgrades e o modelo de segurança

631* [Modo de teste de carga](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#load_test_mode): teste de carga de um gateway sem chamar um provedor de modelo

631* [Visão geral do gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway): quickstart e conexão de desenvolvedores632* [Visão geral do gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway): quickstart e conexão de desenvolvedores

632* [Amostras AWS para gateway de aplicativos Claude](https://github.com/aws-samples/anthropic-on-aws/tree/main/claude-apps-gateway): amostras de implantação mantidas pela AWS cobrindo uma variedade de ambientes de clientes633* [Amostras AWS para gateway de aplicativos Claude](https://github.com/aws-samples/anthropic-on-aws/tree/main/claude-apps-gateway): amostras de implantação mantidas pela AWS cobrindo uma variedade de ambientes de clientes

claude-apps-gateway-on-gcp.md +1 −0

Details

316 316

317* [Referência de configuração](https://code.claude.com/docs/pt/claude-apps-gateway-config.md): cada opção `gateway.yaml`, incluindo `managed.policies` e `telemetry`317* [Referência de configuração](https://code.claude.com/docs/pt/claude-apps-gateway-config.md): cada opção `gateway.yaml`, incluindo `managed.policies` e `telemetry`

318* [Implantação e operações](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md): configuração de IdP, verificações de saúde, rotação de segredo JWT, upgrades e o modelo de segurança318* [Implantação e operações](https://code.claude.com/docs/pt/claude-apps-gateway-deploy.md): configuração de IdP, verificações de saúde, rotação de segredo JWT, upgrades e o modelo de segurança

319* [Modo de teste de carga](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#load_test_mode): teste de carga de um gateway sem chamar um provedor de modelo

319* [Visão geral do gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway): quickstart e conectando desenvolvedores320* [Visão geral do gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway): quickstart e conectando desenvolvedores

claude-projects.md +6 −5

Details

95Restrinja o escopo do projeto a um fluxo de trabalho que você continuará adicionando, como tudo o que é necessário para manter uma API sob seu alvo de latência. [Quando usar um projeto](#when-to-use-a-project) tem mais exemplos. Então preencha os campos do diálogo:95Restrinja o escopo do projeto a um fluxo de trabalho que você continuará adicionando, como tudo o que é necessário para manter uma API sob seu alvo de latência. [Quando usar um projeto](#when-to-use-a-project) tem mais exemplos. Então preencha os campos do diálogo:

96 96

97* **Name**: como o projeto aparece na lista **Projects**.97* **Name**: como o projeto aparece na lista **Projects**.

98* **Goal** (opcional): uma linha do que você está tentando realizar, como "Manter latência p95 da API abaixo de 200 ms". Claude na conversa trabalha em direção a isso. Sem um objetivo, Claude trabalha a partir das tarefas que você envia, e você pode adicionar um objetivo mais tarde em **Project settings > General**.98* **What do you want to work on?** (opcional): uma linha que se torna o objetivo do projeto, como "Manter latência p95 da API abaixo de 200 ms". Claude na conversa trabalha em direção a isso. Sem um objetivo, Claude trabalha a partir das tarefas que você envia, e você pode adicionar um objetivo mais tarde em **Project settings > General**.

99* **Context** (opcional): os repositórios GitHub em que este projeto funciona, mais quaisquer arquivos, pastas ou pastas do Google Drive que as threads devem ler. Clique **Add** para cada um. Adicione os repositórios que a maioria das tarefas precisa em vez de cada um que o trabalho pode tocar; [Decidir quais repositórios adicionar](#decide-which-repositories-to-add) cobre a escolha, e você pode adicionar mais tarde em **Project settings > Environment**.99* **Context** (opcional): os repositórios GitHub em que este projeto funciona, mais quaisquer arquivos, pastas ou pastas do Google Drive que as threads devem ler. Clique **Add** para cada um. Adicione os repositórios que a maioria das tarefas precisa em vez de cada um que o trabalho pode tocar; [Decidir quais repositórios adicionar](#decide-which-repositories-to-add) cobre a escolha, e você pode adicionar mais tarde em **Project settings > Environment**.

100 100

101Regras permanentes para como as threads devem funcionar vão em [instruções do projeto](#give-a-project-standing-context), que você define após o projeto existir.101Regras permanentes para como as threads devem funcionar vão em [instruções do projeto](#give-a-project-standing-context), que você define após o projeto existir.

391| Auto-continue when usage limits reset | General | Se uma thread ou a conversa do projeto que [para em um limite de uso](#usage-limit-reached) continua por conta própria quando o limite é redefinido. Ativado por padrão. |

393 394

403 404

404O uso do projeto conta contra os mesmos [limites de plano](https://code.claude.com/docs/pt/errors.md#youve-hit-your-session-limit) que suas outras sessões Claude Code, e um projeto não pode gastar além desses limites por conta própria.405O uso do projeto conta contra os mesmos [limites de plano](https://code.claude.com/docs/pt/errors.md#youve-hit-your-session-limit) que suas outras sessões Claude Code, e um projeto não pode gastar além desses limites por conta própria.

405 406

406Uma thread que atinge o limite do seu plano aguarda e continua por conta própria quando o limite é redefinido, então o trabalho que você deixou em execução começa a usar sua próxima janela de uso sem uma mensagem sua. [Uma thread atingiu o limite de uso](#usage-limit-reached) cobre o que você vê, como pará-la e o único caso que não aguarda.407Uma thread que para no limite do seu plano aguarda e, por padrão, continua por conta própria quando o limite é redefinido. O trabalho dela então conta contra sua próxima janela de uso. Para impedir que as threads continuem, consulte [Uma thread atingiu o limite de uso](#usage-limit-reached).

407 408

408O trabalho vai além dos limites do seu plano apenas se você tiver ligado [créditos de uso](https://code.claude.com/docs/pt/costs.md#add-usage-credits-to-your-subscription) para sua conta. Uma thread não pode ligá-los para você.409O trabalho vai além dos limites do seu plano apenas se você tiver ligado [créditos de uso](https://code.claude.com/docs/pt/costs.md#add-usage-credits-to-your-subscription) para sua conta. Uma thread não pode ligá-los para você.

409 410

484 485

485### Uma thread atingiu o limite de uso486### Uma thread atingiu o limite de uso

486 487

487Quando uma thread ou a conversa do projeto atinge o limite de cinco horas ou semanal do seu plano, ela continua tentando por conta própria e continua quando o limite é redefinido. Uma thread que uma tarefa agendada iniciou não aguarda: seu turno para com um erro de limite, e você envia uma mensagem a ela após o limite ser redefinido.488Quando uma thread ou a conversa do projeto para no limite de cinco horas ou semanal do seu plano, ela aguarda e, por padrão, continua por conta própria quando o limite é redefinido.

488 489

489Enquanto aguarda, a thread mostra **Service is busy** com "Claude is still retrying and will continue automatically." Você não precisa fazer nada para o trabalho continuar. Se preferir que não use sua próxima janela de uso, clique **Stop** na thread, ou [pause o projeto](#pause-archive-or-delete-a-project) para suspender todas as threads. [Erros de limite de uso](https://code.claude.com/docs/pt/errors.md#youve-hit-your-session-limit) explicam os limites e quando eles são redefinidos.490Para impedir que uma thread ou conversa continue no horário de redefinição que sua mensagem mostra, desative **Auto-continue when usage limits reset** em [**Project settings > General**](#project-settings-reference) antes disso. A configuração vale para o projeto inteiro, não apenas para a thread que você está vendo. Para continuar com a configuração desativada, envie uma mensagem à thread ou à conversa após a redefinição. [Erros de limite de uso](https://code.claude.com/docs/pt/errors.md#youve-hit-your-session-limit) explicam os limites e quando eles são redefinidos.

490 491

491### Créditos de uso adicionais são necessários492### Créditos de uso adicionais são necessários

492 493

509| "Unable to connect to repository" com "Claude couldn't access your repository or environment" | Sua conta GitHub precisa de acesso push ao repositório, e o ambiente ainda deve existir. Verifique ambos em **Project settings > Environment**, depois tente novamente |510| "Unable to connect to repository" com "Claude couldn't access your repository or environment" | Sua conta GitHub precisa de acesso push ao repositório, e o ambiente ainda deve existir. Verifique ambos em **Project settings > Environment**, depois tente novamente |

510| "Couldn't show the setup proposal" | O app que você tem aberto é mais antigo que as **Setup recommendations** que Claude enviou. Atualize a página ou reinicie o aplicativo desktop, ou peça a Claude para propor a configuração novamente |511| "Couldn't show the setup proposal" | O app que você tem aberto é mais antigo que as **Setup recommendations** que Claude enviou. Atualize a página ou reinicie o aplicativo desktop, ou peça a Claude para propor a configuração novamente |

511| "The project's environment was removed" | Escolha um ambiente diferente em **Project settings > Environment**; a mudança se aplica a novas threads |512| "The project's environment was removed" | Escolha um ambiente diferente em **Project settings > Environment**; a mudança se aplica a novas threads |

512| "Setup script failed" | Clique **Edit setup script** no erro, corrija o script no ambiente, depois envie outra mensagem. [Setup script failed](https://code.claude.com/docs/pt/web-quickstart.md#setup-script-failed) lista causas comuns |513| "Setup script failed" | [Setup script failed](https://code.claude.com/docs/pt/web-quickstart.md#setup-script-failed) lista causas comuns. Corrija o script no ambiente, depois peça a Claude na conversa do projeto para executar a tarefa em uma nova thread, para que o script seja executado novamente |

513| "Claude ran out of context on this turn" | A thread preencheu sua janela de contexto. Se a mensagem disser que a thread continua em uma sessão fresca, ela continua por conta própria; caso contrário, peça a Claude na conversa do projeto para iniciar uma nova thread para o trabalho restante |514| "Claude ran out of context on this turn" | A thread preencheu sua janela de contexto. Se a mensagem disser que a thread continua em uma sessão fresca, ela continua por conta própria; caso contrário, peça a Claude na conversa do projeto para iniciar uma nova thread para o trabalho restante |

514| "Couldn't start in" seguido pelo nome da sua pasta | Você permitiu que uma thread fosse executada no seu computador, mas a sessão não conseguiu começar lá. Quando uma linha sob a mensagem fornece o motivo, corrija isso, depois peça a Claude para executar a tarefa novamente |515| "Couldn't start in" seguido pelo nome da sua pasta | Você permitiu que uma thread fosse executada no seu computador, mas a sessão não conseguiu começar lá. Quando uma linha sob a mensagem fornece o motivo, corrija isso, depois peça a Claude para executar a tarefa novamente |

515| "Claude is out of date on your device" | O computador que você escolheu para executar uma thread tem uma versão Claude Code mais antiga que v2.1.280. Atualize Claude Code lá, ou atualize o aplicativo desktop se isso é o que conecta a pasta, depois peça a Claude para executar a tarefa novamente |516| "Claude is out of date on your device" | O computador que você escolheu para executar uma thread tem uma versão Claude Code mais antiga que v2.1.280. Atualize Claude Code lá, ou atualize o aplicativo desktop se isso é o que conecta a pasta, depois peça a Claude para executar a tarefa novamente |

cloud-environments.md +3 −5

Details

120 120

121Selecione **Add secret**, rotulado **Add** nas configurações de administrador, e preencha o formulário. Mantenha o **Secret type** padrão, **Bearer**, para uma chave de API que viaja em um cabeçalho de requisição, e preencha estes campos:121Selecione **Add secret**, rotulado **Add** nas configurações de administrador, e preencha o formulário. Mantenha o **Secret type** padrão, **Bearer**, para uma chave de API que viaja em um cabeçalho de requisição, e preencha estes campos:

122 122

123* **Name**: um rótulo para o segredo, como `Internal billing API`

124* **Allowed websites**: os hosts da API, como `api.example.com`. Um `*.` inicial corresponde a cada subdomínio123* **Allowed websites**: os hosts da API, como `api.example.com`. Um `*.` inicial corresponde a cada subdomínio

125* **Custom headers**: uma linha para o cabeçalho que carrega a chave. A linha começa com `Authorization` como o **Name** do cabeçalho e `Bearer` como seu **Prefix**; cole a chave em si como o **Value**. Para um cabeçalho como `X-Api-Key` que usa o valor simples, altere o nome e limpe o prefixo124* **Custom headers**: uma linha para o cabeçalho que carrega a chave. A linha já tem `Authorization` como o **Header name** e `Bearer` como o **Prefix**; cole a chave em si como o **Value**. Para um cabeçalho como `X-Api-Key` que usa o valor simples, altere o nome e limpe o prefixo

126 125

127Para uma API que se autentica de outra forma, escolha um **Secret type** diferente. A lista é a mesma que [Claude Tag](https://claude.com/docs/claude-tag/overview), a integração do Slack para planos Team e Enterprise, oferece para [conexões](https://claude.com/docs/claude-tag/admins/add-connections).126Para uma API que se autentica de outra forma, escolha um **Secret type** diferente. A lista é a mesma que [Claude Tag](https://claude.com/docs/claude-tag/overview), a integração do Slack para planos Team e Enterprise, oferece para [conexões](https://claude.com/docs/claude-tag/admins/add-connections).

128 127

137Se você está em um plano Team ou Enterprise e não tem uma [função de administrador da organização](#requirements), o formulário **Add secret** aceita um segredo para um host. Selecione a [linha **Network secrets**](#add-a-credential) do seu ambiente e depois **Add secret**. Preencha estes campos e selecione o botão **Add secret** do formulário:136Se você está em um plano Team ou Enterprise e não tem uma [função de administrador da organização](#requirements), o formulário **Add secret** aceita um segredo para um host. Selecione a [linha **Network secrets**](#add-a-credential) do seu ambiente e depois **Add secret**. Preencha estes campos e selecione o botão **Add secret** do formulário:

138 137

139* **Host**: o único host que recebe o segredo, como `api.example.com`. O formulário não aceita um curinga `*.`138* **Host**: o único host que recebe o segredo, como `api.example.com`. O formulário não aceita um curinga `*.`

140* **Name**: um rótulo opcional para o segredo139* **Secret type**: **Token** para uma chave que viaja em um cabeçalho de requisição, ou **Username and password**. Para um token, cole a chave no campo **Token**. Para um cabeçalho diferente de `Authorization`, como `X-Api-Key`, altere **Header** para o nome dele

141* **Secret type**: **Token** para uma chave que viaja em um cabeçalho de requisição, ou **Username and password**. Para um token, cole a chave como o **Value**

142 140

143#### Quais requisições recebem o segredo141#### Quais requisições recebem o segredo

144 142

445 443

446Um script de configuração tem quatro restrições para trabalhar:444Um script de configuração tem quatro restrições para trabalhar:

447 445

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

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

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

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

code-review-customize.md +16 −3

Details

25 25

26## Use o REVIEW\.md para regras exclusivas de revisão26## Use o REVIEW\.md para regras exclusivas de revisão

27 27

28O `REVIEW.md` é um arquivo na raiz do seu repositório que adapta o Code Review ao seu repositório. Você também pode adicionar um `REVIEW.md` em um subdiretório para adicionar verificações para alterações sob esse caminho, além do arquivo raiz.28O `REVIEW.md` é um arquivo na raiz do seu repositório que adapta o Code Review ao seu repositório. Em um [branch protegido](#what-a-review-reads-for-each-branch-setup), você também pode adicionar um `REVIEW.md` na [maioria dos subdiretórios](#when-a-subdirectory-review-md-doesnt-apply) para adicionar verificações para alterações sob esse subdiretório, além do arquivo raiz.

29 29

30Os agentes que encontram problemas e os agentes que os verificam recebem seu conteúdo como as instruções de revisão do seu repositório, junto com as orientações de revisão padrão do Code Review. A etapa que escreve a revisão final o consulta antes de definir a severidade e escrever o resumo.30Os agentes que encontram problemas e os agentes que os verificam recebem seu conteúdo como as instruções de revisão do seu repositório, junto com as orientações de revisão padrão do Code Review. A etapa que escreve a revisão final o consulta antes de definir a severidade e escrever o resumo.

31 31

46>46>

47> O serviço Code Review e o [comando `/code-review`](https://code.claude.com/docs/pt/code-review-local) local são duas ferramentas separadas, e elas leem arquivos diferentes. O serviço lê tanto o `CLAUDE.md` quanto o `REVIEW.md`. O comando `/code-review`, que você executa dentro de uma sessão do Claude Code na sua própria máquina, lê seus arquivos `CLAUDE.md` e não o `REVIEW.md`. Coloque as orientações que você quer aplicadas nos dois lugares no `CLAUDE.md`, e reserve o `REVIEW.md` para regras específicas da revisão de pull requests.47> O serviço Code Review e o [comando `/code-review`](https://code.claude.com/docs/pt/code-review-local) local são duas ferramentas separadas, e elas leem arquivos diferentes. O serviço lê tanto o `CLAUDE.md` quanto o `REVIEW.md`. O comando `/code-review`, que você executa dentro de uma sessão do Claude Code na sua própria máquina, lê seus arquivos `CLAUDE.md` e não o `REVIEW.md`. Coloque as orientações que você quer aplicadas nos dois lugares no `CLAUDE.md`, e reserve o `REVIEW.md` para regras específicas da revisão de pull requests.

48 48

49### Quando um REVIEW\.md de subdiretório não se aplica

51O Code Review não aplica um `REVIEW.md` dentro ou abaixo de um subdiretório com um destes nomes, independentemente do que o subdiretório contenha. Um nome de subdiretório corresponde apenas por inteiro, com qualquer combinação de maiúsculas e minúsculas e em qualquer profundidade, então `Tests` corresponde e `integration-tests` não:

53* **Testes**: `test`, `tests`, `__tests__`, `testdata`, `fixtures`, `__fixtures__`, `golden`, `corpus`, `snapshots`, `__snapshots__`

54* **Exemplos**: `example`, `examples`, `sample`, `samples`, `demo`, `demos`

55* **Código gerado**: `generated`

56* **Código de terceiros**: `vendor`, `third_party`, `third-party`, `thirdparty`, `node_modules`, `bower_components`, `external`, `extern`, `deps`, `godeps`, `pods`, `carthage`, `site-packages`, `contrib`

58Coloque as verificações para esses subdiretórios no `REVIEW.md` raiz, ou no `REVIEW.md` de um subdiretório pai quando nem esse pai nem nada acima dele estiver na lista.

60Os demais arquivos `REVIEW.md` de subdiretório nos caminhos que um pull request altera compartilham um limite de 150.000 bytes, sem contar o arquivo raiz. Se a [check run](https://code.claude.com/docs/pt/code-review-pull-requests.md#check-run-output) relatar que alguns deles não couberam, encurte os arquivos para que caibam nesse limite.

49### Exemplo de REVIEW\.md62### Exemplo de REVIEW\.md

50 63

51Este `REVIEW.md` recalibra a severidade para um serviço de backend, limita os nits, ignora arquivos gerados e adiciona verificações específicas do repositório.64Este `REVIEW.md` recalibra a severidade para um serviço de backend, limita os nits, ignora arquivos gerados e adiciona verificações específicas do repositório.

217 230

219| :- | :- | :- |232| :- | :- | :- |

220| O branch padrão está protegido, e o pull request tem como alvo ele ou um branch que nenhum ruleset protege | Branch padrão | Arquivo raiz, os arquivos que ele inclui e arquivos de subdiretório |233| O branch padrão está protegido, e o pull request tem como alvo ele ou um branch que nenhum ruleset protege | Branch padrão | Arquivo raiz, os arquivos que ele inclui e a [maioria dos arquivos de subdiretório](#when-a-subdirectory-review-md-doesnt-apply) |

221| O pull request tem como alvo outro branch que um ruleset protege | Esse branch base | Arquivo raiz, os arquivos que ele inclui e arquivos de subdiretório |234| O pull request tem como alvo outro branch que um ruleset protege | Esse branch base | Arquivo raiz, os arquivos que ele inclui e a [maioria dos arquivos de subdiretório](#when-a-subdirectory-review-md-doesnt-apply) |

224 237

deep-links.md +1 −1

Details

1043. Post initial findings in #incident.1043. Post initial findings in #incident.

105```105```

106 106

107Para usar isso em seu próprio runbook, substitua `acme/web-gateway` pelo slug do repositório do seu serviço. Antes que os engenheiros cliquem na etapa 2, eles devem ter [enviado um prompt em uma sessão interativa do Claude Code](#registration-and-supported-platforms) em sua máquina e aberto o Claude Code em seu clone local.107Para usar isso em seu próprio runbook, substitua `acme/web-gateway` pelo slug do repositório do seu serviço. Antes que os engenheiros cliquem na etapa 2, a máquina deles deve ter o [handler `claude-cli://` registrado](#registration-and-supported-platforms), e eles devem ter executado `claude` em seu clone local ou worktree.

108 108

109### Abrir um link a partir do shell109### Abrir um link a partir do shell

110 110

desktop-ios-simulator.md +18 −5

Details

4 4

5# Testar aplicativos iOS no simulador5# Testar aplicativos iOS no simulador

6 6

~~7> Claude Code Desktop abre seu aplicativo no painel iOS Simulator quando Claude constrói, executa ou verifica, com um simulador separado para cada sessão.~~7> Claude Code Desktop abre seu aplicativo no painel iOS Simulator quando Claude compila, executa ou verifica o aplicativo.

8 8

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

10>10>

63 63

64Quando o aplicativo é iniciado em um simulador, o painel iOS Simulator abre ao lado da conversa. A primeira vez que Claude usa um dispositivo, o aplicativo desktop pede permissão; consulte [Conceder acesso de Claude a um dispositivo](#grant-claude-access-to-a-device). Claude instala o aplicativo, toca nele e lê a tela para verificar suas próprias alterações enquanto você assiste.64Quando o aplicativo é iniciado em um simulador, o painel iOS Simulator abre ao lado da conversa. A primeira vez que Claude usa um dispositivo, o aplicativo desktop pede permissão; consulte [Conceder acesso de Claude a um dispositivo](#grant-claude-access-to-a-device). Claude instala o aplicativo, toca nele e lê a tela para verificar suas próprias alterações enquanto você assiste.

65 65

66O painel do simulador abre sempre que Claude inicia o aplicativo em um simulador, em qualquer ponto da sessão. Quando sua solicitação é sobre ver o aplicativo, por exemplo "a nova tela parece correta?", Claude inicia um simulador antes de começar o trabalho. Depois que Claude corrige um bug ou altera uma tela, peça-lhe para verificar a alteração: reiniciar o aplicativo reabre o painel se ele não estiver aberto.66Quando sua solicitação é sobre ver o aplicativo, por exemplo "a nova tela parece correta?", Claude inicia um simulador antes de começar o trabalho. Depois que Claude corrige um bug ou altera uma tela, peça-lhe para verificar a alteração.

67 67

68O painel do simulador mostra qualquer dispositivo em que o aplicativo foi realmente iniciado. Para testar em um dispositivo específico, nomeie-o em sua solicitação, por exemplo "execute-o no simulador iPhone SE", e Claude direcionará esse dispositivo quando construir e iniciar.68O painel do simulador mostra qualquer dispositivo em que o aplicativo foi realmente iniciado. Para testar em um dispositivo específico, nomeie-o em sua solicitação, por exemplo "execute-o no simulador iPhone SE", e Claude direcionará esse dispositivo quando construir e iniciar.

69 69

86 86

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

88 88

89### Minimizar ou fechar o painel do simulador

91Você pode minimizar ou fechar o painel do simulador, e Claude ainda pode usar o dispositivo em ambos os casos.

93* Se você minimizar o painel, o dispositivo permanece visível em tamanho reduzido. Para minimizar o painel ou expandi-lo novamente, consulte [Minimizar um painel](https://code.claude.com/docs/pt/desktop.md#minimize-a-pane).

94* Se você fechar o painel em tamanho completo ou minimizado, o dispositivo permanece conectado e em execução. Para mostrar o dispositivo novamente, clique em **iOS Simulator** na barra de título da sessão.

89## Como as sessões gerenciam dispositivos96## Como as sessões gerenciam dispositivos

90 97

91Cada dispositivo pertence à sessão que o iniciou, portanto [sessões paralelas](https://code.claude.com/docs/pt/desktop.md#work-in-parallel-with-sessions) não compartilham um dispositivo: o que você vê no painel de uma sessão reflete o trabalho dessa sessão, não de outra. Alternar sessões na barra lateral alterna a visualização do simulador junto com a conversa, e alternar de volta retoma o mesmo dispositivo onde parou. Se Claude trabalha com mais de um dispositivo, cada um abre seu próprio painel, até 4 por sessão.98Se o seu prompt não nomear um simulador, Claude usa um que já esteja em execução, mesmo que outra [sessão paralela](https://code.claude.com/docs/pt/desktop.md#work-in-parallel-with-sessions) o tenha aberto. Para dar a cada sessão seu próprio simulador, nomeie um diferente no prompt de cada sessão.

92 99

93Claude Code Desktop desliga os simuladores que iniciou quando não estão mais em uso: quando você sai do aplicativo, quando você arquiva a sessão, ou 10 minutos depois que você desanexa um dispositivo de seu painel. Dispositivos que você inicia fora do Claude Code Desktop, como no aplicativo Simulator da Apple ou no Device Hub, nunca são desligados automaticamente. Para desligar o dispositivo anexado imediatamente, use o botão de desligamento no painel.100Claude Code Desktop desliga os simuladores que iniciou quando não estão mais em uso: quando você sai do aplicativo, quando você arquiva a sessão, ou 10 minutos depois que você desanexa um dispositivo de seu painel. Dispositivos que você inicia fora do Claude Code Desktop, como no aplicativo Simulator da Apple ou no Device Hub, nunca são desligados automaticamente. Para desligar o dispositivo anexado imediatamente, use o botão de desligamento no painel.

94 101

102 109

103Depois de permitir um dispositivo, as ações de Claude nele, como tocar, digitar e tirar capturas de tela, são executadas sem prompts, mas você aprova a inicialização do aplicativo conforme seu [modo de permissão](#actions-that-follow-your-permission-mode) exigir. Elas têm a mesma confiança que você clicando no painel, e elas apenas tocam o dispositivo simulado, portanto o painel não precisa das permissões de Acessibilidade e Gravação de Tela do macOS que o computer use requer.110Depois de permitir um dispositivo, as ações de Claude nele, como tocar, digitar e tirar capturas de tela, são executadas sem prompts, mas você aprova a inicialização do aplicativo conforme seu [modo de permissão](#actions-that-follow-your-permission-mode) exigir. Elas têm a mesma confiança que você clicando no painel, e elas apenas tocam o dispositivo simulado, portanto o painel não precisa das permissões de Acessibilidade e Gravação de Tela do macOS que o computer use requer.

104 111

105Se você recusar, o dispositivo ainda inicia e o painel ainda funciona para seus próprios toques; apenas o acesso de Claude permanece desativado. Para mudar de ideia depois, clique em **Let Claude use it** no painel.112Se você recusar a solicitação de Claude, o dispositivo não é anexado e o Desktop não o inicia. Para usar o dispositivo você mesmo:

113

1141. Clique em **Attach simulator** no painel.

1152. Clique em **Continue** na tela de permissão.

1163. Clique em **Cancel** na caixa de diálogo que aparece em seguida.

117

118O dispositivo é anexado e funciona para seus próprios toques, e o acesso de Claude permanece desativado. Depois disso, para dar acesso a Claude, clique em **Let Claude use it** no painel.

106 119

107### Ações que seguem seu modo de permissão120### Ações que seguem seu modo de permissão

108 121

110 123

111* Abrir uma URL no dispositivo, por exemplo para testar um deep link ou carregar uma página no Safari do dispositivo, porque uma URL pode levar dados para fora do dispositivo.124* Abrir uma URL no dispositivo, por exemplo para testar um deep link ou carregar uma página no Safari do dispositivo, porque uma URL pode levar dados para fora do dispositivo.

112* Construir o aplicativo, porque `xcodebuild` executa os scripts de construção do seu projeto em seu Mac. Verificar uma construção já em andamento não solicita.125* Construir o aplicativo, porque `xcodebuild` executa os scripts de construção do seu projeto em seu Mac. Verificar uma construção já em andamento não solicita.

113* Instalar e iniciar o aplicativo, porque Claude pode executar qualquer aplicativo que nomear, não apenas aquele que você está desenvolvendo.126* Instalar e iniciar o aplicativo, porque Claude pode executar qualquer aplicativo que ele indicar, não apenas aquele que você está desenvolvendo.

114 127

115### Desativar acesso ao simulador128### Desativar acesso ao simulador

116 129

desktop-linux.md +1 −1

Details

53gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc53gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

54```54```

55 55

56A impressão digital que gpg imprime deve ser `31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE`. Se gpg relatar que o arquivo não pode ser aberto ou não contém dados OpenPGP válidos, o download falhou ou retornou o conteúdo errado: confirme que sua rede pode alcançar `downloads.claude.ai` e execute novamente o comando de download.56A única impressão digital que gpg imprime deve ser `31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE`. Se gpg relatar que o arquivo não pode ser aberto ou não contém dados OpenPGP válidos, o download falhou ou retornou o conteúdo errado. Confirme que sua rede pode alcançar `downloads.claude.ai` e, em seguida, execute novamente o comando de download.

57 57

58Registre o repositório:58Registre o repositório:

59 59

desktop-scheduled-tasks.md +3 −3

Details

160 160

161## Permissões para tarefas agendadas161## Permissões para tarefas agendadas

162 162

163Cada tarefa tem seu próprio modo de permissão, que você define ao criar ou editar a tarefa. As regras de allow de `~/.claude/settings.json` também se aplicam a sessões de tarefas agendadas. Se uma tarefa é executada em [Modo Manual](https://code.claude.com/docs/pt/desktop.md#choose-a-permission-mode) e precisa executar uma ferramenta para a qual não tem permissão, a execução fica travada até que você a aprove. Para aprová-la, [encontre a sessão da execução](#find-a-runs-session) e responda ao prompt de permissão nela.163Cada tarefa tem seu próprio [modo de permissão](https://code.claude.com/docs/pt/desktop.md#choose-a-permission-mode), que você define ao criar ou editar a tarefa. As regras de allow de `~/.claude/settings.json` também se aplicam a sessões de tarefas agendadas. Quando uma execução fica travada em um prompt de permissão, [encontre a sessão da execução](#find-a-runs-session) e responda ao prompt nela.

164 164

165Para evitar travamentos, clique em **Run now** após criar uma tarefa, observe prompts de permissão e selecione "always allow" para cada um. Execuções futuras dessa tarefa aprovam automaticamente as mesmas ferramentas sem solicitar. Você pode revisar e revogar essas aprovações na página de detalhes da tarefa.165Para evitar travamentos, clique em **Run now** após criar uma tarefa, observe prompts de permissão e selecione "always allow" para cada um. Execuções futuras ignoram a maioria desses prompts. Você pode revisar e revogar essas aprovações na página de detalhes da tarefa. Se você selecionar "always allow" em uma edição de arquivo na pasta da tarefa, apenas essa sessão passa para **Accept edits**, então defina o modo de permissão da tarefa como **Accept edits**.

166 166

167As ferramentas MCP marcadas como [`requiresUserInteraction`](https://code.claude.com/docs/pt/mcp#require-approval-for-a-specific-tool) solicitam confirmação a cada chamada e não oferecem uma opção de sempre permitir. Execuções que chamam essas ferramentas ficam travadas cada vez.167As ferramentas MCP marcadas como [`requiresUserInteraction`](https://code.claude.com/docs/pt/mcp#require-approval-for-a-specific-tool) solicitam confirmação a cada chamada e não oferecem uma opção de sempre permitir. Execuções que chamam essas ferramentas ficam travadas cada vez.

168 168

179 179

180Você também pode listar, criar, editar e pausar tarefas pedindo ao Claude em qualquer sessão do Desktop. Por exemplo, "pause my dependency-audit task" ou "show me my scheduled tasks." Para deletar uma tarefa, use o botão **Delete** em sua página de detalhes.180Você também pode listar, criar, editar e pausar tarefas pedindo ao Claude em qualquer sessão do Desktop. Por exemplo, "pause my dependency-audit task" ou "show me my scheduled tasks." Para deletar uma tarefa, use o botão **Delete** em sua página de detalhes.

181 181

182Uma tarefa agendada também pode modificar seu próprio agendamento ou prompt dentro de uma sessão em execução usando a ferramenta MCP `update_scheduled_task`. Isso permite que uma tarefa se reagende com base no que encontra, por exemplo, reagendando uma análise de código para ser executada mais cedo quando detecta que um branch de release foi criado.182Para permitir que uma tarefa altere seu próprio agendamento ou prompt com a ferramenta MCP `update_scheduled_task`, clique em **Run now** e aprove a chamada a cada vez.

183 183

184Para editar o prompt de uma tarefa no disco, abra `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (ou em [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/pt/env-vars) se definido). O arquivo usa frontmatter YAML para `name` e `description`, com o prompt como corpo. As alterações entram em vigor na próxima execução. Schedule, pasta, modelo e estado habilitado não estão neste arquivo: altere-os através do formulário Edit ou peça ao Claude.184Para editar o prompt de uma tarefa no disco, abra `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (ou em [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/pt/env-vars) se definido). O arquivo usa frontmatter YAML para `name` e `description`, com o prompt como corpo. As alterações entram em vigor na próxima execução. Schedule, pasta, modelo e estado habilitado não estão neste arquivo: altere-os através do formulário Edit ou peça ao Claude.

185 185

env-vars.md +332 −330

Details

112 112

113## Variáveis113## Variáveis

114 114

115Variá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.115Variáveis numéricas, como timeouts, orçamentos de tokens e contagens de novas tentativas, aceitam notação científica e grafias com separadores 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.

116 116

117> [!NOTE]117> [!NOTE]

118>118>

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

120>120>

121> Algumas variáveis verificam apenas se você as definiu, de modo que qualquer valor não vazio, incluindo `0`, ativa o comportamento, e você desativa o comportamento removendo a definição da variável ou definindo-a com um valor vazio. Estas variáveis funcionam dessa forma:121> 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 assim:

122>122>

123> * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`123> * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

124> * `DISABLE_TELEMETRY`124> * `DISABLE_TELEMETRY`

130 130

131| Variável | Finalidade |131| Variável | Finalidade |

132| :- | :- |132| :- | :- |

133| `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, Ultra, 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` |133| `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, Ultra, Team ou Enterprise, mesmo que você esteja logado. No modo não interativo (`-p`), a chave é sempre usada quando presente. No modo interativo, é solicitado que você aprove a chave uma vez antes que ela sobrescreva sua assinatura. Para usar sua assinatura em vez disso, execute `unset ANTHROPIC_API_KEY` |

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

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

136| `ANTHROPIC_AWS_BASE_URL` | Sobrescreve a URL do endpoint do [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md). Use para regiões personalizadas ou ao rotear por meio de um [gateway de LLM](https://code.claude.com/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](https://code.claude.com/docs/pt/amazon-bedrock.md#3-configure-claude-code) |136| `ANTHROPIC_AWS_BASE_URL` | Sobrescreve a URL do endpoint do [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md). Use para regiões personalizadas ou ao rotear por um [gateway de LLM](https://code.claude.com/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 do Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#3-configure-claude-code) |

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

138| `ANTHROPIC_BASE_URL` | Sobrescreve o endpoint da API para rotear requisições por meio de um proxy ou gateway. Para saber o que acontece quando esse gateway rejeita o MCP Tool Search, consulte [Tool search por meio de um gateway de LLM](https://code.claude.com/docs/pt/mcp.md#tool-search-through-a-gateway). A partir da v2.1.196, o [Remote Control](https://code.claude.com/docs/pt/remote-control.md#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 |138| `ANTHROPIC_BASE_URL` | Sobrescreve o endpoint da API para rotear requisições por um proxy ou gateway. Para saber o que acontece quando esse gateway rejeita a busca de ferramentas do MCP, consulte [Busca de ferramentas por um gateway de LLM](https://code.claude.com/docs/pt/mcp.md#tool-search-through-a-gateway). A partir da v2.1.196, o [Remote Control](https://code.claude.com/docs/pt/remote-control.md#requirements) fica desativado quando isso aponta para um host diferente de `api.anthropic.com`, correspondendo ao seu comportamento no Amazon Bedrock, no Google Cloud's Agent Platform e no Microsoft Foundry |

139| `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](https://code.claude.com/docs/pt/llm-gateway). Consulte [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) |139| `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](https://code.claude.com/docs/pt/llm-gateway). Consulte [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) |

140| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sobrescreve a URL do endpoint do Amazon Bedrock Mantle. Consulte [Endpoint Mantle](https://code.claude.com/docs/pt/amazon-bedrock.md#use-the-mantle-endpoint) |140| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sobrescreve a URL do endpoint do Amazon Bedrock Mantle. Consulte [Endpoint Mantle](https://code.claude.com/docs/pt/amazon-bedrock.md#use-the-mantle-endpoint) |

141| `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 nas regiões AWS GovCloud. Requer o Claude Code v2.1.224 ou posterior. Consulte [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#cross-region-inference-profile-prefixes) |141| `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](https://code.claude.com/docs/pt/amazon-bedrock.md#cross-region-inference-profile-prefixes) |

142| `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`). Consulte [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#service-tiers) |142| `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`). Consulte [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#service-tiers) |

143| `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 isto 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`](https://code.claude.com/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 |143| `ANTHROPIC_BETAS` | Lista separada por vírgulas de valores adicionais do cabeçalho `anthropic-beta` a incluir nas requisições da API. O Claude Code já envia os cabeçalhos beta de que precisa; use isso 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`](https://code.claude.com/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 |

144| `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 o Claude Code v2.1.227 ou posterior. [Invalid request header value](https://code.claude.com/docs/pt/errors.md#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](https://code.claude.com/docs/pt/server-managed-settings.md#environment-variables-and-the-approval-dialog) quando configurações gerenciadas pelo servidor o entregam. A partir de configurações de projeto ou locais, esse valor segue as [regras sobre quando os valores de `env` se aplicam](https://code.claude.com/docs/pt/settings-reference#when-claude-code-applies-env-values) |144| `ANTHROPIC_CUSTOM_HEADERS` | Cabeçalhos personalizados a adicionar às requisições (formato `Name: Value`, separados por nova linha para vários cabeçalhos). Se um nome ou valor contiver um caractere que um cabeçalho HTTP não pode transportar, como aspas curvas ou um espaço de largura zero, a requisição falha com um erro que identifica o par pela posição. Requer Claude Code v2.1.227 ou posterior. [Invalid request header value](https://code.claude.com/docs/pt/errors.md#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](https://code.claude.com/docs/pt/server-managed-settings.md#environment-variables-and-the-approval-dialog) quando as configurações gerenciadas pelo servidor o entregam. Vindo das configurações de projeto ou locais, esse valor segue as [regras sobre quando os valores de `env` se aplicam](https://code.claude.com/docs/pt/settings-reference#when-claude-code-applies-env-values) |

145| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID do modelo a adicionar como entrada personalizada no seletor `/model`. Use isto para tornar selecionável um modelo não padrão ou específico de um gateway sem substituir os aliases integrados. Consulte [Configuração de modelos](https://code.claude.com/docs/pt/model-config.md#add-a-custom-model-option) |145| `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](https://code.claude.com/docs/pt/model-config.md#add-a-custom-model-option) |

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

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

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

149| `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](https://code.claude.com/docs/pt/model-config.md#automatic-model-fallback) em provedores de terceiros. Consulte [Configuração de modelos](https://code.claude.com/docs/pt/model-config.md#environment-variables) |149| `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](https://code.claude.com/docs/pt/model-config.md#automatic-model-fallback) em provedores terceiros. Consulte [Configuração de modelo](https://code.claude.com/docs/pt/model-config.md#environment-variables) |

150| `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 modelos](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |150| `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](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |

151| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome exibido para o modelo Fable fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado e, caso contrário, o ID fixado. Consulte [Configuração de modelos](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |151| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome de exibição 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](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |

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

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

154| `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 modelos](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |154| `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](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |

155| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome exibido para o modelo Haiku fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado e, caso contrário, o ID fixado. Consulte [Configuração de modelos](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |155| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome de exibição 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](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |

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

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

158| `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 modelos](https://code.claude.com/docs/pt/model-config.md#environment-variables) |158| `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](https://code.claude.com/docs/pt/model-config.md#environment-variables) |

159| `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 modelos](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |159| `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](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |

160| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome exibido para o modelo Opus fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado e, caso contrário, o ID fixado. Consulte [Configuração de modelos](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |160| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome de exibição 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](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |

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

162| `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 modelos](https://code.claude.com/docs/pt/model-config.md#environment-variables) |162| `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](https://code.claude.com/docs/pt/model-config.md#environment-variables) |

163| `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 modelos](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |163| `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](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome exibido para o modelo Sonnet fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado e, caso contrário, o ID fixado. Consulte [Configuração de modelos](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |164| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome de exibição 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](https://code.claude.com/docs/pt/model-config.md#customize-pinned-model-display-and-capabilities) |

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

166| `ANTHROPIC_FEDERATION_RULE_ID` | ID da regra de federação para a [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 as credenciais de federação, que têm prioridade sobre sua credencial de `/login`. Consulte [precedência de autenticação](https://code.claude.com/docs/pt/authentication.md#authentication-precedence) |166| `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](https://code.claude.com/docs/pt/authentication.md#authentication-precedence) |

167| `ANTHROPIC_FOUNDRY_API_KEY` | Chave de API para autenticação no Microsoft Foundry (consulte [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md)) |167| `ANTHROPIC_FOUNDRY_API_KEY` | Chave de API para autenticação no Microsoft Foundry (consulte [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md)) |

168| `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](https://code.claude.com/docs/pt/microsoft-foundry.md). Requer o Claude Code v2.1.203 ou posterior |168| `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](https://code.claude.com/docs/pt/microsoft-foundry.md). Requer Claude Code v2.1.203 ou posterior |

169| `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](https://code.claude.com/docs/pt/microsoft-foundry.md)) |169| `ANTHROPIC_FOUNDRY_BASE_URL` | URL base completa para o recurso do Microsoft Foundry (por exemplo, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (consulte [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md)) |

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

171| `ANTHROPIC_MODEL` | Nome da configuração de modelo a usar (consulte [Configuração de modelos](https://code.claude.com/docs/pt/model-config.md#environment-variables)) |171| `ANTHROPIC_MODEL` | Nome da configuração de modelo a usar (consulte [Configuração de modelo](https://code.claude.com/docs/pt/model-config.md#environment-variables)) |

172| `ANTHROPIC_ORGANIZATION_ID` | ID da organização para a [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](https://code.claude.com/docs/pt/authentication.md#authentication-precedence) |172| `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](https://code.claude.com/docs/pt/authentication.md#authentication-precedence) |

173| `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](https://code.claude.com/docs/pt/authentication.md#sign-in-without-an-api-key). Consulte [precedência de autenticação](https://code.claude.com/docs/pt/authentication.md#authentication-precedence) |173| `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](https://code.claude.com/docs/pt/authentication.md#sign-in-without-an-api-key). Consulte [precedência de autenticação](https://code.claude.com/docs/pt/authentication.md#authentication-precedence) |

174| `ANTHROPIC_SMALL_FAST_MODEL` | \[DESCONTINUADO] Nome do [modelo da classe Haiku para tarefas em segundo plano](https://code.claude.com/docs/pt/costs.md) |174| `ANTHROPIC_SMALL_FAST_MODEL` | \[DESCONTINUADA] Nome do [modelo da classe Haiku para tarefas em segundo plano](https://code.claude.com/docs/pt/costs.md) |

175| `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](https://code.claude.com/docs/pt/amazon-bedrock.md#4-pin-model-versions) na região da sessão |175| `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](https://code.claude.com/docs/pt/amazon-bedrock.md#4-pin-model-versions) na região da sessão |

176| `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](https://code.claude.com/docs/pt/llm-gateway). Consulte [Google Cloud's Agent Platform](https://code.claude.com/docs/pt/google-vertex-ai.md) |176| `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](https://code.claude.com/docs/pt/llm-gateway). Consulte [Google Cloud's Agent Platform](https://code.claude.com/docs/pt/google-vertex-ai.md) |

177| `ANTHROPIC_VERTEX_PROJECT_ID` | ID do projeto do GCP para o qual as requisições do Google Cloud's Agent Platform são direcionadas. Consulte [Configurar credenciais do GCP](https://code.claude.com/docs/pt/google-vertex-ai.md#3-configure-gcp-credentials) |177| `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](https://code.claude.com/docs/pt/google-vertex-ai.md#3-configure-gcp-credentials) |

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

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

180| `API_TIMEOUT_MS` | Tempo em milissegundos que cada tentativa de requisição de API tem para receber seus cabeçalhos de resposta. Não limita quanto tempo uma resposta por streaming dura depois disso. O padrão é 600000, ou 10 minutos, e o máximo é 2147483647. Quando você define um valor positivo, cada tentativa de uma [requisição sem streaming](https://code.claude.com/docs/pt/errors.md#streaming-response-ended-before-any-complete-data-was-received) precisa terminar dentro dele. Aumente-o quando as requisições atingirem o timeout em redes lentas ou ao rotear por meio de um proxy. Defina como `0` para remover esse limite, o que requer o Claude Code v2.1.305 ou posterior. Com `0`, uma tentativa sem streaming ainda atinge o timeout após 300 segundos em uma sessão local |180| `API_TIMEOUT_MS` | Tempo em milissegundos que cada tentativa de requisição à API tem para receber seus cabeçalhos de resposta. Isso não limita por quanto tempo uma resposta por streaming é executada depois disso. O padrão é 600000, ou 10 minutos, e o máximo é 2147483647. Quando você define um valor positivo, cada tentativa de uma [requisição sem streaming](https://code.claude.com/docs/pt/errors.md#streaming-response-ended-before-any-complete-data-was-received) precisa terminar dentro dele. Aumente isso quando as requisições atingirem o timeout em redes lentas ou ao rotear por um proxy. Defina como `0` para remover esse limite, o que requer Claude Code v2.1.305 ou posterior. Com `0`, uma tentativa sem streaming ainda atinge o timeout após 300 segundos em uma sessão local |

181| `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/)) |181| `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/)) |

182| `BASH_DEFAULT_TIMEOUT_MS` | Timeout padrão para um comando da ferramenta Bash ou PowerShell em primeiro plano, em milissegundos (padrão: 120000, ou 2 minutos). Um valor acima do [limite de tempo padrão para comandos em segundo plano](https://code.claude.com/docs/pt/tools-reference.md#time-limit-for-background-commands) substitui esse padrão em sessões não supervisionadas. O limite de tempo em segundo plano requer o Claude Code v2.1.285 ou posterior |182| `BASH_DEFAULT_TIMEOUT_MS` | Timeout padrão para um comando da ferramenta Bash ou PowerShell em primeiro plano, em milissegundos (padrão: 120000, ou 2 minutos). Um valor acima do [limite de tempo padrão para comandos em segundo plano](https://code.claude.com/docs/pt/tools-reference.md#time-limit-for-background-commands) substitui esse padrão em sessões não supervisionadas. O limite de tempo em segundo plano requer Claude Code v2.1.285 ou posterior |

183| `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`](https://code.claude.com/docs/pt/settings-reference#bashoutputmaxchars), o Claude Code ignora esta variável. Consulte [Limites de saída](https://code.claude.com/docs/pt/tools-reference.md#output-limits) |183| `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`](https://code.claude.com/docs/pt/settings-reference#bashoutputmaxchars), o Claude Code ignora esta variável. Consulte [Limites de saída](https://code.claude.com/docs/pt/tools-reference.md#output-limits) |

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

185| `BETA_TRACING_ENDPOINT` | Endpoint OTLP/HTTP para o [tracing beta detalhado](https://code.claude.com/docs/pt/monitoring-usage.md#traces-beta): com `ENABLE_BETA_TRACING_DETAILED=1`, logs e traces vão para ele em vez dos exportadores configurados. Defina-o no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorado em [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |185| `BETA_TRACING_ENDPOINT` | Endpoint OTLP/HTTP para [tracing beta detalhado](https://code.claude.com/docs/pt/monitoring-usage.md#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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

186| `CCR_FORCE_BUNDLE` | Defina como `1` para forçar o [`claude --cloud`](https://code.claude.com/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 |186| `CCR_FORCE_BUNDLE` | Defina como `1` para forçar o [`claude --cloud`](https://code.claude.com/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 |

187| `CLAUDECODE` | Definida como `1` em subprocessos que o Claude Code inicia (ferramentas Bash e PowerShell, sessões tmux, comandos de [hook](https://code.claude.com/docs/pt/hooks.md), comandos de [linha de status](https://code.claude.com/docs/pt/statusline.md), subprocessos de [servidor MCP](https://code.claude.com/docs/pt/mcp.md) 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 iniciado pelo Claude Code, use `CLAUDE_CODE_CHILD_SESSION` em vez disso |187| `CLAUDECODE` | Definida como `1` em subprocessos que o Claude Code inicia (ferramentas Bash e PowerShell, sessões do tmux, comandos de [hook](https://code.claude.com/docs/pt/hooks.md), comandos da [linha de status](https://code.claude.com/docs/pt/statusline.md), subprocessos de [servidor MCP](https://code.claude.com/docs/pt/mcp.md) 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` em vez disso |

188| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Defina como `1` para desativar todos os tipos de [subagente](https://code.claude.com/docs/pt/sub-agents.md) integrados, como Explore e Plan. Aplica-se apenas no modo não interativo (a flag `-p`). Útil para usuários do SDK que desejam começar do zero. Isso também remove 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`](https://code.claude.com/docs/pt/errors#subagent-type-is-required) |188| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Defina como `1` para desativar todos os tipos de [subagente](https://code.claude.com/docs/pt/sub-agents.md) 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`](https://code.claude.com/docs/pt/errors#subagent-type-is-required) |

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

190| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout de travamento em milissegundos para subagentes. Também abrange [agentes de workflow](https://code.claude.com/docs/pt/workflows.md#when-an-agent-stalls-and-restarts) no Claude Code v2.1.286 ou posterior. Padrão `600000` (10 minutos); se você aumentar `CLAUDE_STREAM_IDLE_TIMEOUT_MS` enquanto o watchdog de streaming estiver ativo, o padrão aumenta junto, conforme descrito em [Lidar com respostas de API lentas ou travadas](https://code.claude.com/docs/pt/agent-sdk/typescript.md#handle-slow-or-stalled-api-responses) |190| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout de travamento em milissegundos para subagentes. Também abrange [agentes de workflow](https://code.claude.com/docs/pt/workflows.md#when-an-agent-stalls-and-restarts) no Claude Code v2.1.286 ou posterior. Padrão `600000` (10 minutos); se você aumentar `CLAUDE_STREAM_IDLE_TIMEOUT_MS` enquanto o watchdog de stream estiver ativo, o padrão aumenta junto, como descreve [Lidar com respostas da API lentas ou travadas](https://code.claude.com/docs/pt/agent-sdk/typescript.md#handle-slow-or-stalled-api-responses) |

191| `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](https://code.claude.com/docs/pt/model-config.md#context-window-and-auto-compaction). Aplica-se tanto às conversas principais quanto aos subagentes |191| `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](https://code.claude.com/docs/pt/model-config.md#context-window-and-auto-compaction). Aplica-se tanto às conversas principais quanto aos subagentes |

192| `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, um [subagente](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) passa para segundo plano após ser executado por aproximadamente dois minutos. Se o Claude enfileirou uma chamada de ferramenta, como uma edição de arquivo, atrás do subagente, o subagente termina em primeiro plano antes que essa chamada comece. Também ativa o [envio automático para segundo plano de chamadas longas de ferramentas MCP](https://code.claude.com/docs/pt/mcp.md#automatic-backgrounding-of-long-tool-calls) no modo não interativo no Claude Code v2.1.212 ou posterior |192| `CLAUDE_AUTO_BACKGROUND_TASKS` | Defina como `1` para forçar a ativação da execução automática em segundo plano de tarefas de agente de longa duração. Quando ativada, um [subagente](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) passa para o segundo plano após ser executado por aproximadamente dois minutos. Se o Claude enfileirou uma chamada de ferramenta, como uma edição de arquivo, atrás do subagente, o subagente termina em primeiro plano antes que essa chamada comece. Também ativa a [execução automática em segundo plano de chamadas longas de ferramentas MCP](https://code.claude.com/docs/pt/mcp.md#automatic-backgrounding-of-long-tool-calls) no modo não interativo no Claude Code v2.1.212 ou posterior |

193| `CLAUDE_AX_PREPARK_MS` | No [modo de leitor de tela](https://code.claude.com/docs/pt/accessibility.md), 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`. Ignorado em [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer o Claude Code v2.1.233 ou posterior |193| `CLAUDE_AX_PREPARK_MS` | No [modo de leitor de tela](https://code.claude.com/docs/pt/accessibility.md), 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`. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.233 ou posterior |

194| `CLAUDE_AX_SCREEN_READER` | Defina como `1` para renderizar uma saída adequada a leitores de tela: texto simples sem bordas decorativas ou animações. Defina como `0` para forçar a desativação do modo de leitor de tela mesmo quando [`axScreenReader`](https://code.claude.com/docs/pt/settings-reference#axscreenreader) for `true`. A flag [`--ax-screen-reader`](https://code.claude.com/docs/pt/cli-reference#cli-flags) tem precedência. Ignorado em [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer o Claude Code v2.1.181 ou posterior |194| `CLAUDE_AX_SCREEN_READER` | Defina como `1` para renderizar uma saída compatível com 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`](https://code.claude.com/docs/pt/settings-reference#axscreenreader) for `true`. A flag [`--ax-screen-reader`](https://code.claude.com/docs/pt/cli-reference#cli-flags) tem precedência. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.181 ou posterior |

195| `CLAUDE_AX_STARTUP_QUIET_MS` | No [modo de leitor de tela](https://code.claude.com/docs/pt/accessibility.md), por quantos milissegundos o Claude Code retém a primeira renderização da interface após a linha de confirmação de inicialização. Assim, seu leitor de tela pode 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). Seu primeiro pressionamento de tecla encerra a retenção antecipadamente. Ignorado em [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer o Claude Code v2.1.217 ou posterior |195| `CLAUDE_AX_STARTUP_QUIET_MS` | No [modo de leitor de tela](https://code.claude.com/docs/pt/accessibility.md), por quantos milissegundos o Claude Code retém a primeira renderização da interface após a linha de confirmação de inicialização. Seu leitor de tela pode então 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. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.217 ou posterior |

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

197| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout em milissegundos para o watchdog de ociosidade de streaming no nível de bytes; quando definido, tem precedência sobre `CLAUDE_STREAM_IDLE_TIMEOUT_MS` para esse watchdog e deixa inalterado o watchdog no nível de eventos. O Claude Code restringe esta variável a um valor entre 10 segundos e 30 minutos. Requer o Claude Code v2.1.210 ou posterior |197| `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 |

198| `CLAUDE_CLIENT_PRESENCE_FILE` | Caminho para um arquivo que uma ferramenta externa, como um listener de bloqueio de tela, cria quando você desbloqueia a tela e exclui quando você a bloqueia. Enquanto o arquivo existir, o Claude Code omite as [notificações push móveis do Remote Control](https://code.claude.com/docs/pt/remote-control.md#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 um push, em vez de consultá-lo periodicamente. Requer o Claude Code v2.1.181 ou posterior |198| `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 pula as [notificações push móveis do Remote Control](https://code.claude.com/docs/pt/remote-control.md#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 um push, em vez de consultá-lo periodicamente. Requer Claude Code v2.1.181 ou posterior |

199| `CLAUDE_CODE_ACCESSIBILITY` | Defina como `1` para manter visível o cursor nativo do terminal 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 |199| `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 |

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

201| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Defina como `1` para redesenhar a tela inteira a cada quadro na [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), em vez de enviar atualizações incrementais. Use isto 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](https://code.claude.com/docs/pt/agent-view.md) no Windows |201| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Defina como `1` para redesenhar a tela inteira a cada quadro na [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md) 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](https://code.claude.com/docs/pt/agent-view.md) no Windows |

202| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro de [esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) em todas as requisições, mesmo quando o Claude Code não reconhece o ID do modelo como compatível com esforço. Use isto ao rotear por meio de um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) ou de um provedor de terceiros que disponibiliza modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo Claude Opus 4.1, Claude Sonnet 4.5, Claude Haiku 4.5 e modelos anteriores, continuam excluídos para que as requisições não falhem |202| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro de [esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) em cada 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 um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) ou provedor terceiro que serve modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo Claude Opus 4.1, Claude Sonnet 4.5, Claude Haiku 4.5 e modelos anteriores, continuam excluídos para que as requisições não falhem |

203| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper)) |203| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper)) |

204| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Defina como `0` para impedir que o Claude Code abra o navegador automaticamente quando um novo [artefato](https://code.claude.com/docs/pt/artifacts.md#create-an-artifact) for publicado |204| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Defina como `0` para impedir que o Claude Code abra o navegador automaticamente quando um novo [artefato](https://code.claude.com/docs/pt/artifacts.md#create-an-artifact) for publicado |

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

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

207| `CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS` | Defina como `0` para impedir que o Claude aplique pequenas alterações ao arquivo de um [artefato](https://code.claude.com/docs/pt/artifacts.md#update-an-artifact) como parte de sua publicação. O Claude então edita o arquivo com suas ferramentas de edição de arquivos e o publica como uma etapa separada. Requer o Claude Code v2.1.300 ou posterior |207| `CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS` | Defina como `0` para impedir que o Claude aplique pequenas alterações ao arquivo de um [artefato](https://code.claude.com/docs/pt/artifacts.md#update-an-artifact) como parte de sua publicação. O Claude então edita o arquivo com suas ferramentas de edição de arquivos e o publica como uma etapa separada. Requer Claude Code v2.1.300 ou posterior |

208| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Defina como `0` para omitir o [bloco de atribuição](https://code.claude.com/docs/pt/llm-gateway-protocol.md#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](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) mesmo quando você define `0`. Em [Bloco de atribuição do system prompt](https://code.claude.com/docs/pt/llm-gateway-protocol.md#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 com o Microsoft Foundry; portanto, nessas versões, defina-a como `0` quando seu gateway de LLM fizer cache com base no corpo da requisição ou encaminhar requisições a um provedor de terceiros, ou quando você se conectar diretamente ao Microsoft Foundry |208| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Defina como `0` para omitir do início do system prompt o [bloco de atribuição](https://code.claude.com/docs/pt/llm-gateway-protocol.md#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 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](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) mesmo quando você define `0`. Em [Bloco de atribuição do system prompt](https://code.claude.com/docs/pt/llm-gateway-protocol.md#system-prompt-attribution-block), verifique quais conexões e credenciais isso abrange. Antes da v2.1.181, o bloco incluía um token por requisição em URLs base personalizadas e conexões do Microsoft Foundry, 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 a um provedor terceiro, ou quando você se conectar diretamente ao Microsoft Foundry |

209| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Removida na v2.1.283. Use `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` em vez disso |209| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Removida na v2.1.283. Use `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` em vez disso |

210| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Define a janela de compactação automática, ou seja, o quanto o contexto fica cheio antes da compactação, de `100000` a `1000000` tokens. Valores com sufixo, como `200k`, requerem a v2.1.304 ou posterior. Para a precedência em relação às outras formas de definir a janela e o efeito sobre o `used_percentage` da linha de status, consulte [Definir a janela de compactação automática](https://code.claude.com/docs/pt/model-config.md#set-the-auto-compact-window) |210| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Define a janela de compactação automática, ou seja, quão cheio o contexto fica antes da compactação, de `100000` a `1000000` tokens. Valores com sufixo, como `200k`, requerem v2.1.304 ou posterior. Para a precedência sobre as outras formas de definir a janela e o efeito no `used_percentage` da linha de status, consulte [Definir a janela de compactação automática](https://code.claude.com/docs/pt/model-config.md#set-the-auto-compact-window) |

211| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sobrescreve a [conexão automática com a IDE](https://code.claude.com/docs/pt/vs-code.md). 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`](https://code.claude.com/docs/pt/settings-reference#autoconnectide) |211| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sobrescreve a [conexão automática com o IDE](https://code.claude.com/docs/pt/vs-code.md). 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`](https://code.claude.com/docs/pt/settings-reference#autoconnectide) |

212| `CLAUDE_CODE_AUTO_MODE_MODEL` | Define o modelo para as requisições do classificador que o Claude Code envia no [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode). Use um ID de modelo completo, como `claude-sonnet-4-6`. Para os casos em que o Claude Code a ignora, consulte [Escolher o modelo do classificador](https://code.claude.com/docs/pt/permission-modes.md#choose-the-classifier-model). Requer o Claude Code v2.1.302 ou posterior |212| `CLAUDE_CODE_AUTO_MODE_MODEL` | Define o modelo para as requisições do classificador que o Claude Code envia no [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode). Use um ID de modelo completo, como `claude-sonnet-4-6`. Para os casos em que o Claude Code a ignora, consulte [Escolher o modelo do classificador](https://code.claude.com/docs/pt/permission-modes.md#choose-the-classifier-model). Requer Claude Code v2.1.302 ou posterior |

213| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controla se o Claude Code pede ao servidor para [revisar as ações do modo auto](https://code.claude.com/docs/pt/permission-modes.md#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 a 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 o Claude Code v2.1.271 ou posterior |213| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controla se o Claude Code pede ao servidor para [revisar ações do modo auto](https://code.claude.com/docs/pt/permission-modes.md#server-side-classifier-review). Defina como `0` para usar as próprias requisições do 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 |

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

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

216| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Defina como `0` para fazer uma sessão não interativa reportar 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 reportando 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](https://code.claude.com/docs/pt/workflows.md), ainda estiver ativo. Isso evita 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 o Claude Code v2.1.269 ou posterior; em versões anteriores, defina `1` para manter o status de execução |216| `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 o trabalho em segundo plano ainda estiver em execução. Por padrão, a sessão continua relatando um status de execução após o final do turno enquanto trabalhos em segundo plano, como um agente em segundo plano ou uma execução de [workflow](https://code.claude.com/docs/pt/workflows.md), ainda estiverem ativos. 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 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 |

217| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Definida automaticamente em subprocessos da ferramenta Bash e de [comandos de hook](https://code.claude.com/docs/pt/hooks.md) enquanto a sessão tem uma conexão ativa de [Remote Control](https://code.claude.com/docs/pt/remote-control.md), 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 apontar de volta para a sessão que o executou. Requer o Claude Code v2.1.199 ou posterior. Em [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), leia `CLAUDE_CODE_REMOTE_SESSION_ID` em vez disso |217| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Definida automaticamente nos subprocessos da ferramenta Bash e de [comandos de hook](https://code.claude.com/docs/pt/hooks.md) enquanto a sessão tem uma conexão ativa do [Remote Control](https://code.claude.com/docs/pt/remote-control.md), 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 apontar de volta para a sessão que o executou. Requer Claude Code v2.1.199 ou posterior. Em [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), leia `CLAUDE_CODE_REMOTE_SESSION_ID` em vez disso |

218| `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](https://code.claude.com/docs/pt/terminal-config.md#fix-backspace-deleting-a-whole-word-on-windows) |218| `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 [Backspace exclui uma palavra inteira](https://code.claude.com/docs/pt/terminal-config.md#fix-backspace-deleting-a-whole-word-on-windows) |

219| `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 o Node 22.15 ou posterior para instalações via npm. Consulte [Repositório de certificados de CA](https://code.claude.com/docs/pt/network-config.md#ca-certificate-store). O padrão é `bundled,system` |219| `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](https://code.claude.com/docs/pt/network-config.md#ca-certificate-store). O padrão é `bundled,system` |

220| `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](https://code.claude.com/docs/pt/hooks.md) e de comandos de [linha de status](https://code.claude.com/docs/pt/statusline.md). Não é definida para subprocessos de [servidor MCP](https://code.claude.com/docs/pt/mcp.md) stdio, que são de longa duração e sobrevivem à sessão que os iniciou. Diferentemente de `CLAUDECODE`, esta é definida apenas pelo próprio Claude Code quando ele inicia um subprocesso, e não 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 `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 `claude -p` não interativas continuam persistindo. Defina `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` para sobrescrever essa exclusão. Requer o Claude Code v2.1.172 ou posterior |220| `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](https://code.claude.com/docs/pt/hooks.md) e de comandos da [linha de status](https://code.claude.com/docs/pt/statusline.md). Não é definida para subprocessos de [servidor MCP](https://code.claude.com/docs/pt/mcp.md) 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 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 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 |

224| `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 API por streaming. Use `API_TIMEOUT_MS` em vez disso. Para a fase de cabeçalhos de resposta de uma requisição por streaming, consulte `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |224| `CLAUDE_CODE_CONFIG_LOCK_WAIT_MS` | Milissegundos durante os quais um comando que adiciona ou remove um servidor MCP de escopo `user` ou `local`, como `claude mcp add`, continua tentando obter o lock em `~/.claude.json` antes de [falhar](https://code.claude.com/docs/pt/errors.md#mcp-server-was-not-saved-or-removed). Com ela não definida, o comando espera cerca de 10 a 20 segundos, e um valor menor não muda nada. Requer Claude Code v2.1.318 ou posterior |

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

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

226| `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 |227| `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 |

227| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Defina como `1` para desativar o suporte à [janela de contexto de 1M](https://code.claude.com/docs/pt/model-config.md#extended-context). O Claude Code remove as variantes de modelo `[1m]` do seletor de modelos e limita a uma janela de 200K os modelos que por padrão são executados com a janela de 1M. Consulte [Desativar o contexto de 1M](https://code.claude.com/docs/pt/model-config.md#turn-off-1m-context). Ú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](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |228| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Defina como `1` para desativar o suporte à [janela de contexto de 1M](https://code.claude.com/docs/pt/model-config.md#extended-context). O Claude Code remove as variantes de modelo `[1m]` do seletor de modelos e limita a uma janela de 200K os modelos que usam a janela de 1M por padrão. Consulte [Desativar o contexto de 1M](https://code.claude.com/docs/pt/model-config.md#turn-off-1m-context). Ú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](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |

228| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Defina como `1` para desativar o [raciocínio adaptativo](https://code.claude.com/docs/pt/model-config.md#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](https://code.claude.com/docs/pt/model-config.md#extended-thinking), no Sonnet 5 e posteriores, no Haiku 5.5 ou no Opus 4.7 e posteriores, que sempre usam raciocínio adaptativo |229| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Defina como `1` para desativar o [raciocínio adaptativo](https://code.claude.com/docs/pt/model-config.md#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](https://code.claude.com/docs/pt/model-config.md#extended-thinking), no Sonnet 5 e posteriores, no Haiku 5.5 ou no Opus 4.7 e posteriores, que sempre usam raciocínio adaptativo |

229| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Defina como `1` para desativar a [ferramenta advisor](https://code.claude.com/docs/pt/advisor.md). 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 |230| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Defina como `1` para desativar a [ferramenta advisor](https://code.claude.com/docs/pt/advisor.md). 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 |

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

231| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desativar a [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md) 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`](https://code.claude.com/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](https://code.claude.com/docs/pt/agent-view.md), que sempre usam a renderização em tela cheia |232| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desativar a [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md) e usar o renderizador clássico da tela principal. A conversa permanece no scrollback nativo do seu terminal, então `Cmd+f` e o modo de cópia do tmux funcionam normalmente. Tem precedência sobre `CLAUDE_CODE_NO_FLICKER` e a configuração [`tui`](https://code.claude.com/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](https://code.claude.com/docs/pt/agent-view.md), que sempre usam renderização em tela cheia |

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

233| `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 no conteúdo do arquivo. Ignorado em [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |234| `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. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

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

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

236| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para remover o parâmetro `run_in_background` das ferramentas Bash, PowerShell e de subagente e para desativar o atalho Ctrl+B e as execuções em segundo plano de [skills bifurcadas](https://code.claude.com/docs/pt/skills.md#run-skills-in-a-subagent). O Claude Code então também deixa de mover automaticamente para segundo plano subagentes, chamadas longas de ferramentas MCP e comandos de shell que atingiram o timeout. As [tarefas MCP](https://code.claude.com/docs/pt/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task) e a [ferramenta Monitor](https://code.claude.com/docs/pt/tools-reference.md#monitor-tool) continuam sendo executadas em segundo plano. Para desativar também as [sessões em segundo plano](https://code.claude.com/docs/pt/agent-view.md#turn-off-agent-view), defina `CLAUDE_CODE_DISABLE_AGENT_VIEW` como `1` |237| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para remover o parâmetro `run_in_background` das ferramentas Bash, PowerShell e de subagente e para desativar o atalho Ctrl+B e as execuções em segundo plano de [skills bifurcadas](https://code.claude.com/docs/pt/skills.md#run-skills-in-a-subagent). O Claude Code então também para de mover automaticamente para o segundo plano subagentes, chamadas longas de ferramentas MCP e comandos de shell que atingiram o timeout. [Tarefas MCP](https://code.claude.com/docs/pt/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task) e a [ferramenta Monitor](https://code.claude.com/docs/pt/tools-reference.md#monitor-tool) continuam sendo executadas em segundo plano. Para desativar também as [sessões em segundo plano](https://code.claude.com/docs/pt/agent-view.md#turn-off-agent-view), defina `CLAUDE_CODE_DISABLE_AGENT_VIEW` como `1` |

237| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Defina como `1` para impedir que o Claude Code trate uma resposta por streaming do [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) com um cabeçalho `Content-Type` ausente ou vazio como o fluxo 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 ele decodifica o corpo e o streaming continua funcionando. Defina isto apenas para um gateway que também reemite o fluxo como server-sent events; o Claude Code então lê o corpo sem cabeçalho como server-sent events. Requer o Claude Code v2.1.239 ou posterior |238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Defina como `1` para impedir que o Claude Code trate uma resposta por streaming do [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) com um cabeçalho `Content-Type` ausente ou vazio como o fluxo 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 isso apenas para um gateway que também reemite o fluxo 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 |

238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Defina como `1` para ignorar a verificação de que uma resposta por streaming do [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) tem o content-type `application/vnd.amazon.eventstream`. Sem esta variável, quando uma resposta tem um content-type diferente, o Claude Code faz a requisição falhar com um erro que indica esse tipo, o que significa que um [gateway ou proxy está transformando a resposta](https://code.claude.com/docs/pt/amazon-bedrock.md#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 o Claude Code v2.1.208 ou posterior |239| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Defina como `1` para pular a verificação de que uma resposta por streaming do [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) traz o content-type `application/vnd.amazon.eventstream`. Sem esta variável, quando uma resposta traz 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](https://code.claude.com/docs/pt/amazon-bedrock.md#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 |

239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Defina como `1` para interromper o trabalho em andamento de uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) quando o [supervisor](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process) parar, reiniciar ou atualizar o processo dessa sessão, em vez de entregá-lo ao próximo processo da sessão. Esse trabalho consiste nos comandos de shell em segundo plano em execução da sessão, além dos subagentes em segundo plano a partir da v2.1.198. Afeta apenas essa transferência: enviar uma sessão para segundo plano com `←` ou [`/background`](https://code.claude.com/docs/pt/agent-view#from-inside-a-session) continua transferindo o trabalho em segundo plano em andamento. Requer o Claude Code v2.1.196 ou posterior |240| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Defina como `1` para interromper o trabalho em andamento de uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) quando o [supervisor](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process) parar, reiniciar ou atualizar o processo dessa sessão, em vez de passá-lo para o próximo processo da sessão. Esse trabalho consiste nos comandos de shell em segundo plano em execução da sessão, além dos subagentes em segundo plano a partir da v2.1.198. Afeta apenas essa passagem: enviar uma sessão para o segundo plano com `←` ou [`/background`](https://code.claude.com/docs/pt/agent-view#from-inside-a-session) ainda transfere o trabalho em segundo plano em andamento. Requer Claude Code v2.1.196 ou posterior |

240| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Defina como `1` para impedir que o Claude Code encerre [comandos de shell em segundo plano](https://code.claude.com/docs/pt/interactive-mode.md#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 reporta pressão crítica de memória RAM e a sessão está ociosa há 30 minutos, sem turno nem subagente em execução. O Windows não tem um sinal de pressão de memória, então esta variável não tem efeito nele. Requer o Claude Code v2.1.193 ou posterior |241| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Defina como `1` para impedir que o Claude Code encerre [comandos de shell em segundo plano](https://code.claude.com/docs/pt/interactive-mode.md#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 relata 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, então esta variável não tem efeito lá. Requer Claude Code v2.1.193 ou posterior |

241| `CLAUDE_CODE_DISABLE_BG_STABLE_PATH` | No macOS com o instalador nativo, defina como `1` para executar o processo host de cada [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) a partir do binário instalado, e não de `~/.local/share/claude/ClaudeCode.app`. O macOS pode então pedir novamente permissões como [acesso a pastas](https://code.claude.com/docs/pt/agent-view.md#background-sessions-can’t-read-desktop-documents-or-downloads-on-macos), inclusive após cada atualização. Defina-a no [bloco `env`](#in-settings-files) das configurações de usuário, em um arquivo de configurações gerenciadas ou em uma política de MDM, não no seu shell. Para remover `ClaudeCode.app`, exclua-o você mesmo. Requer o Claude Code v2.1.295 ou posterior |242| `CLAUDE_CODE_DISABLE_BG_STABLE_PATH` | No macOS com o instalador nativo, defina como `1` para executar o processo host de cada [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) a partir do binário instalado, e não de `~/.local/share/claude/ClaudeCode.app`. O macOS pode então pedir novamente permissões como [acesso a pastas](https://code.claude.com/docs/pt/agent-view.md#background-sessions-can’t-read-desktop-documents-or-downloads-on-macos), inclusive após cada atualização. Defina-a no [bloco `env`](#in-settings-files) das configurações de usuário, em um arquivo de configurações gerenciadas ou em uma política de MDM, não no seu shell. Para remover o `ClaudeCode.app`, exclua-o você mesmo. Requer Claude Code v2.1.295 ou posterior |

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

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

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

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

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

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

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

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

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

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

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

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

254| `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](https://code.claude.com/docs/pt/permission-modes.md#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 fornecida por meio de um bloco `env` de configurações. Requer o Claude Code v2.1.288 ou posterior |255| `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](https://code.claude.com/docs/pt/permission-modes.md#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 meio de um bloco `env` de configurações. Requer Claude Code v2.1.288 ou posterior |

255| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Defina como `1` para impedir o remapeamento automático do Opus 4 e do Opus 4.1 para a versão atual do Opus na Anthropic API. Use quando você 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 |256| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Defina como `1` para impedir o remapeamento automático do Opus 4 e do Opus 4.1 para a versão atual do Opus na Anthropic API. Use quando você quiser intencionalmente fixar um modelo mais antigo. O remapeamento não é executado no Amazon Bedrock, no Google Cloud's Agent Platform ou no Microsoft Foundry |

256| `CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND` | Defina como `1` para que o Claude aguarde o resultado de uma [tarefa MCP](https://code.claude.com/docs/pt/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task) em uma sessão interativa. Enquanto o [envio automático para segundo plano](https://code.claude.com/docs/pt/mcp.md#automatic-backgrounding-of-long-tool-calls) estiver ativo, ele ainda move a chamada para segundo plano após dois minutos por padrão. Requer o Claude Code v2.1.304 ou posterior |257| `CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND` | Defina como `1` para que o Claude espere pelo resultado de uma [tarefa MCP](https://code.claude.com/docs/pt/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task) em uma sessão interativa. Enquanto a [execução automática em segundo plano](https://code.claude.com/docs/pt/mcp.md#automatic-backgrounding-of-long-tool-calls) estiver ativa, ela ainda move a chamada para o segundo plano após dois minutos por padrão. Requer Claude Code v2.1.304 ou posterior |

257| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Defina como `1` para impedir que o Claude Code no [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#when-a-model-is-disabled-mid-session) e no [Google Cloud's Agent Platform](https://code.claude.com/docs/pt/google-vertex-ai.md#when-a-model-is-disabled-mid-session) mude para um modelo mais antigo quando sua conta perder 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](https://code.claude.com/docs/pt/model-config.md#fallback-model-chains) que você configurar ainda faz a troca nessa recusa, e as [verificações de modelo na inicialização](https://code.claude.com/docs/pt/amazon-bedrock.md#startup-model-checks) ainda recorrem ao fallback na inicialização. Requer o Claude Code v2.1.285 ou posterior |258| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Defina como `1` para impedir que o Claude Code no [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#when-a-model-is-disabled-mid-session) e no [Google Cloud's Agent Platform](https://code.claude.com/docs/pt/google-vertex-ai.md#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 dela; em vez disso, a requisição recusada falha imediatamente. Uma [cadeia de modelos de fallback](https://code.claude.com/docs/pt/model-config.md#fallback-model-chains) que você configurar ainda troca de modelo diante dessa recusa, e as [verificações de modelo na inicialização](https://code.claude.com/docs/pt/amazon-bedrock.md#startup-model-checks) ainda recorrem ao fallback ao iniciar. Requer Claude Code v2.1.285 ou posterior |

258| `CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT` | Defina como `1` para desativar o [prompt de unidade montada](https://code.claude.com/docs/pt/permission-modes.md#the-mounted-drive-prompt) para caminhos como `/Volumes/USB`. [Defina-a no ambiente que inicia o Claude Code](#set-variables-in-your-shell), porque o Claude Code [a ignora em um bloco `env` de configurações](https://code.claude.com/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Requer o Claude Code v2.1.304 ou posterior |259| `CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT` | Defina como `1` para desativar o [prompt de unidade montada](https://code.claude.com/docs/pt/permission-modes.md#the-mounted-drive-prompt) para caminhos como `/Volumes/USB`. [Defina-a no ambiente que inicia o Claude Code](#set-variables-in-your-shell), porque o Claude Code [a ignora em um bloco `env` de configurações](https://code.claude.com/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.304 ou posterior |

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

260| `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](https://code.claude.com/docs/pt/fullscreen.md), mantendo a rolagem pela roda do mouse. Use isto quando quiser que a rolagem pela 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 o Claude Code v2.1.195 ou posterior |261| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Defina como `1` para desativar o tratamento de cliques, arrastos e hover na [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), 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 |

261| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Defina como `1` para impedir que o Claude Code releia o [certificado e a chave do cliente mTLS](https://code.claude.com/docs/pt/network-config.md#mtls-authentication) quando uma requisição de API falhar com um erro no nível da 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 o Claude Code v2.1.232 ou posterior |262| `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](https://code.claude.com/docs/pt/network-config.md#mtls-authentication) quando uma requisição da 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 |

262| `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`, [feedback redigido pelo Claude](https://code.claude.com/docs/pt/tools-reference.md#sendfeedback-tool-behavior), notas de versão, as verificações do [badge de status de PR e MR](https://code.claude.com/docs/pt/interactive-mode.md#pr-review-status) e verificações de disponibilidade, como a verificação do [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways). Também interrompe as [execuções em segundo plano de fontes `command` de plugins](https://code.claude.com/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](https://code.claude.com/docs/pt/remote-control.md#requirements) e os outros [recursos que precisam da busca de feature flags](#features-that-need-feature-flag-fetching). A instalação automática do marketplace oficial de plugins não é abrangida; desative-a com `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Não afeta a [descoberta de modelos do gateway](https://code.claude.com/docs/pt/llm-gateway-connect.md#add-gateway-models-to-the-model-picker), que tem sua própria opção de ativação |263| `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ório de erros, o comando `/feedback`, o [feedback redigido pelo Claude](https://code.claude.com/docs/pt/tools-reference.md#sendfeedback-tool-behavior), notas de versão, as verificações do [selo de status de PR e MR](https://code.claude.com/docs/pt/interactive-mode.md#pr-review-status) e verificações de disponibilidade, como a verificação do [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways). Também interrompe as [execuções em segundo plano de fontes `command` de plugins](https://code.claude.com/docs/pt/plugins/loading#when-a-command-source-re-runs), que são comandos locais e não tráfego de rede, porque 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](https://code.claude.com/docs/pt/remote-control.md#requirements) e os outros [recursos que precisam da busca de feature flags](#features-that-need-feature-flag-fetching). A instalação automática do marketplace oficial de plugins não é abrangida; desative-a com `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Não afeta a [descoberta de modelos do gateway](https://code.claude.com/docs/pt/llm-gateway-connect.md#add-gateway-models-to-the-model-picker), que tem sua própria ativação opcional |

263| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Defina como `1` para desativar o fallback sem streaming quando uma requisição por streaming falhar no meio do fluxo. Em vez disso, os erros de streaming são propagados para a camada de retry. Útil quando um proxy ou gateway faz com que o fallback produza execução duplicada de ferramentas |264| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Defina como `1` para desativar o fallback sem streaming quando uma requisição por streaming falha no meio do stream. Em vez disso, 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 |

264| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Defina como `1` para enviar a notificação na área de trabalho 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 na área de trabalho quanto o [push móvel](https://code.claude.com/docs/pt/remote-control.md#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 o Claude Code v2.1.193 ou posterior |265| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Defina como `1` para enviar a notificação de desktop da ferramenta `PushNotification` mesmo enquanto você estiver digitando no terminal ou com ele em foco. Por padrão, a ferramenta pula tanto a notificação de desktop quanto o [push móvel](https://code.claude.com/docs/pt/remote-control.md#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 |

265| `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 a omissão. Execute `claude plugin marketplace add anthropics/claude-plugins-official` para registrar o marketplace a qualquer momento |266| `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 |

266| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Defina como `1` para impedir que o Claude Code execute seus [hooks `Notification` para requisições de permissão não respondidas](https://code.claude.com/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 o Claude Code v2.1.233 ou posterior |267| `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](https://code.claude.com/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 |

267| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Defina como `1` para ignorar 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 |268| `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 |

268| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Defina como `1` para desativar a verificação da [ferramenta PowerShell](https://code.claude.com/docs/pt/tools-reference.md#powershell-tool) que nega os comandos integrados do `cmd` `rd`, `rmdir`, `del` e `erase` em um [caminho do sistema](https://code.claude.com/docs/pt/permission-modes.md#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 o Claude Code v2.1.283 ou posterior |269| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Defina como `1` para desativar a verificação da [ferramenta PowerShell](https://code.claude.com/docs/pt/tools-reference.md#powershell-tool) que nega os built-ins do `cmd` `rd`, `rmdir`, `del` e `erase` em um [caminho do sistema](https://code.claude.com/docs/pt/permission-modes.md#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 |

269| `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](https://code.claude.com/docs/pt/model-config.md#automatic-model-fallback), o comportamento controlado pela configuração [`switchModelsOnFlag`](https://code.claude.com/docs/pt/settings-reference#switchmodelsonflag) |270| `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](https://code.claude.com/docs/pt/model-config.md#automatic-model-fallback), o comportamento que a configuração [`switchModelsOnFlag`](https://code.claude.com/docs/pt/settings-reference#switchmodelsonflag) controla |

270| `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](https://code.claude.com/docs/pt/llm-gateway-protocol.md#feature-pass-through) cujo upstream os rejeita. Isso mantém ativos os outros recursos de pré-lançamento que [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) desativa. Requer o Claude Code v2.1.288 ou posterior |271| `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](https://code.claude.com/docs/pt/llm-gateway-protocol.md#feature-pass-through) cujo upstream os rejeite. Isso mantém ativos os outros recursos de pré-lançamento que [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) desativa. Requer Claude Code v2.1.288 ou posterior |

271| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Defina como `1` para desativar a verificação de [caminhos críticos](https://code.claude.com/docs/pt/permission-modes.md#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 fornecida por meio de um bloco `env` de configurações. Requer o Claude Code v2.1.281 ou posterior |272| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Defina como `1` para desativar a verificação de [caminhos críticos](https://code.claude.com/docs/pt/permission-modes.md#critical-paths) para um `rm` recursivo cujo alvo seja 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 meio de um bloco `env` de configurações. Requer Claude Code v2.1.281 ou posterior |

272| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Defina como `1` para desativar as atualizações automáticas do título do terminal com base no contexto da conversa. Isso também omite a requisição em segundo plano ao modelo pequeno/rápido que [gera um título de sessão](https://code.claude.com/docs/pt/sessions.md#name-your-sessions) e desativa os [relatórios de status para o seu terminal](https://code.claude.com/docs/pt/terminal-config.md#see-session-status-in-your-terminal) |273| `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](https://code.claude.com/docs/pt/sessions.md#name-your-sessions) e desativa os [relatórios de status para o seu terminal](https://code.claude.com/docs/pt/terminal-config.md#see-session-status-in-your-terminal) |

273| `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 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, no Haiku 5.5 ou nos modelos Fable, nos quais o pensamento não pode ser desativado. Em [provedores de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md), `MAX_THINKING_TOKENS=0` também omite o parâmetro, então as duas variáveis se comportam da mesma forma nesses provedores |274| `CLAUDE_CODE_DISABLE_THINKING` | Defina como `1` para omitir completamente o parâmetro `thinking` das requisições da 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, Sonnet 5.5, Haiku 5.5 ou nos modelos Fable, nos quais o pensamento não pode ser desativado. Em [provedores terceiros](https://code.claude.com/docs/pt/third-party-integrations.md), `MAX_THINKING_TOKENS=0` também omite o parâmetro, então as duas variáveis se comportam da mesma forma lá |

274| `CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK` | Defina como `1` para que o [`claude ultrareview`](https://code.claude.com/docs/pt/ultrareview#trust-the-folder-before-the-review-runs) não encerre com `Error: Workspace not trusted` em uma pasta na qual você não confiou quando não puder pedir que você confie nela, como em CI. Defina-a no ambiente que inicia o Claude Code, não em um bloco `env` de configurações, e apenas onde todas essas execuções começarem em uma pasta na qual você confia. Execuções que podem perguntar continuam perguntando. Requer o Claude Code v2.1.309 ou posterior |275| `CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK` | Defina como `1` para que [`claude ultrareview`](https://code.claude.com/docs/pt/ultrareview#trust-the-folder-before-the-review-runs) não encerre com `Error: Workspace not trusted` em uma pasta na qual você não confiou quando não puder pedir que você confie nela, como em CI. Defina-a no ambiente que inicia o Claude Code, não em um bloco `env` de configurações, e somente onde toda execução desse tipo começa em uma pasta em que você confia. Execuções que podem perguntar continuam perguntando. Requer Claude Code v2.1.309 ou posterior |

275| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Defina como `1` para ignorar a [compactação automática](https://code.claude.com/docs/pt/costs.md#reduce-token-usage) proativa quando o Claude Code não reconhecer o ID do modelo, como um alias de [gateway de LLM](https://code.claude.com/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](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) para saber quando cada variável se aplica. Requer o Claude Code v2.1.223 ou posterior |276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Defina como `1` para ignorar a [compactação automática](https://code.claude.com/docs/pt/costs.md#reduce-token-usage) proativa quando o Claude Code não reconhece o ID do modelo, como um alias de [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway). Sem esta variável, o Claude Code compacta na janela de contexto que ele 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](https://code.claude.com/docs/pt/model-config.md#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 |

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

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

278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Defina como `1` para iniciar comandos da [ferramenta PowerShell](https://code.claude.com/docs/pt/tools-reference.md#powershell-tool) no Windows diretamente, em vez de por meio do inicializador `cmd.exe`. Por padrão, o inicializador permite que um comando PowerShell [em execução em segundo plano](https://code.claude.com/docs/pt/tools-reference.md#background-commands) [passe para o próximo processo da sessão](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process), como quando você [coloca a sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md#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 |279| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Defina como `1` para iniciar os comandos da [ferramenta PowerShell](https://code.claude.com/docs/pt/tools-reference.md#powershell-tool) no Windows diretamente, em vez de por meio do inicializador `cmd.exe`. Por padrão, o inicializador permite que um comando do PowerShell [em execução em segundo plano](https://code.claude.com/docs/pt/tools-reference.md#background-commands) [seja transferido para o próximo processo da sessão](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process), como quando você [coloca a sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md#from-inside-a-session). Se você definir a variável, um comando do 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 |

279| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Defina como `1` para desativar [workflows](https://code.claude.com/docs/pt/workflows.md#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](https://code.claude.com/docs/pt/settings-reference#disableworkflows) |280| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Defina como `1` para desativar os [workflows](https://code.claude.com/docs/pt/workflows.md#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](https://code.claude.com/docs/pt/settings-reference#disableworkflows) |

280| `CLAUDE_CODE_EFFORT_LEVEL` | Define o nível de esforço para os modelos compatíveis. Valores: `low`, `medium`, `high`, `xhigh` ou `max`. Os níveis disponíveis dependem do modelo. Tem precedência sobre `--effort`, `/effort` e as configurações `modelSettings` e `effortLevel`. Um limite [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel) ainda se aplica. Defina como `auto` ou `unset` para que o Claude Code [não envie nenhum nível de esforço](https://code.claude.com/docs/pt/model-config.md#send-no-effort-level), de modo que a API aplique seu próprio padrão para o modelo. Consulte [Ajustar o nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) |281| `CLAUDE_CODE_DROP_UNAVAILABLE_DEFERRED_TOOL` | Defina como `1` para descartar uma [chamada de ferramenta adiada](https://code.claude.com/docs/pt/hooks.md#resume-when-a-deferred-tool-is-unavailable) cuja ferramenta não está disponível quando você retoma com `-p`. Sem esta variável, a chamada permanece pendente e um prompt que você envia não chega ao Claude. Requer Claude Code v2.1.319 ou posterior |

281| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Defina como `1` para adicionar ao fluxo de mensagens as mensagens [`session_state_changed`](https://code.claude.com/docs/pt/agent-sdk/typescript#sdksessionstatechangedmessage), que carregam o estado da sessão. Requer o [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md) ou `--print`, `--output-format stream-json` e `--verbose` |282| `CLAUDE_CODE_EFFORT_LEVEL` | Define o nível de esforço para modelos compatíveis. Valores: `low`, `medium`, `high`, `xhigh` ou `max`. Os níveis disponíveis dependem do modelo. Tem precedência sobre `--effort`, `/effort` e as configurações `modelSettings` e `effortLevel`. Um limite [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel) ainda se aplica. Defina como `auto` ou `unset` para que o Claude Code [não envie nenhum nível de esforço](https://code.claude.com/docs/pt/model-config.md#send-no-effort-level), de modo que a API aplique seu próprio padrão para o modelo. Consulte [Ajustar o nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) |

282| `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 autenticadas do [Claude apps gateway](https://code.claude.com/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](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) nesses provedores |283| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Defina como `1` para adicionar mensagens [`session_state_changed`](https://code.claude.com/docs/pt/agent-sdk/typescript#sdksessionstatechangedmessage), que carregam o estado da sessão, ao fluxo de mensagens. Requer o [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md) ou `--print`, `--output-format stream-json` e `--verbose` |

284| `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](https://code.claude.com/docs/pt/claude-apps-gateway). Da v2.1.158 até a v2.1.206, defini-la como `1` era necessário para disponibilizar o [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) nesses provedores |

283| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sobrescreve a disponibilidade do [resumo da sessão](https://code.claude.com/docs/pt/interactive-mode.md#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`](https://code.claude.com/docs/pt/settings-reference#awaysummaryenabled) for `false`. Tem precedência sobre a configuração e a opção em `/config` |285| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sobrescreve a disponibilidade do [resumo da sessão](https://code.claude.com/docs/pt/interactive-mode.md#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`](https://code.claude.com/docs/pt/settings-reference#awaysummaryenabled) for `false`. Tem precedência sobre a configuração e a opção em `/config` |

284| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Defina como `1` para atualizar o estado dos plugins nos limites de turno no [modo não interativo](https://code.claude.com/docs/pt/headless.md) 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](https://code.claude.com/docs/pt/prompt-caching.md) daquele turno |286| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Defina como `1` para atualizar o estado dos plugins nos limites de turno no [modo não interativo](https://code.claude.com/docs/pt/headless.md) 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](https://code.claude.com/docs/pt/prompt-caching.md) para aquele turno |

285| `CLAUDE_CODE_ENABLE_CFC` | Defina como `1` para iniciar uma sessão da CLI com a [integração com o Chrome](https://code.claude.com/docs/pt/chrome.md) ativada, ou `0` para iniciá-la desativada. Tem precedência sobre a configuração [`claudeInChromeDefaultEnabled`](https://code.claude.com/docs/pt/settings-reference#claudeinchromedefaultenabled). As flags `--chrome` e `--no-chrome` têm precedência sobre ambas. O Claude Code [ignora `1` nas configurações de projeto e locais](https://code.claude.com/docs/pt/chrome#project-settings-can’t-turn-on-chrome) |287| `CLAUDE_CODE_ENABLE_CFC` | Defina como `1` para iniciar uma sessão da CLI com a [integração com o Chrome](https://code.claude.com/docs/pt/chrome.md) ativada, ou `0` para iniciá-la desativada. Tem precedência sobre a configuração [`claudeInChromeDefaultEnabled`](https://code.claude.com/docs/pt/settings-reference#claudeinchromedefaultenabled). As flags `--chrome` e `--no-chrome` têm precedência sobre ambas. O Claude Code [ignora `1` nas configurações de projeto e locais](https://code.claude.com/docs/pt/chrome#project-settings-can’t-turn-on-chrome) |

286| `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](https://code.claude.com/docs/pt/monitoring-usage.md) 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 |288| `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](https://code.claude.com/docs/pt/monitoring-usage.md) 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 neste modo. Aplica-se quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` estiver 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 |

287| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controla se as entradas das chamadas de ferramenta são transmitidas da API à medida que o Claude as gera. Com isso desativado, uma entrada de ferramenta grande, como a gravação de um arquivo longo, chega apenas depois que o Claude termina de gerá-la, o que pode parecer um travamento. Ativado por padrão na API da Anthropic. No Amazon Bedrock e na Agent Platform do Google Cloud, ativado por modelo onde 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](https://code.claude.com/docs/pt/llm-gateway) |289| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controla se as entradas das chamadas de ferramenta são transmitidas da API enquanto o Claude as gera. Com isto desativado, uma entrada de ferramenta grande, como a gravação de um arquivo longo, só chega depois que o Claude termina de gerá-la, o que pode parecer um travamento. Ativado por padrão na API da Anthropic. No Amazon Bedrock e na 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](https://code.claude.com/docs/pt/llm-gateway) |

288| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Defina como `1` para preencher o seletor `/model` a partir do endpoint `/v1/models` do seu gateway quando `ANTHROPIC_BASE_URL` apontar para um gateway compatível com a Anthropic, como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque, caso contrário, gateways baseados em uma chave de API compartilhada mostrariam a todos os usuários todos os modelos que a chave pode acessar. Os modelos descobertos ainda são filtrados por uma allowlist [`availableModels`](https://code.claude.com/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](https://code.claude.com/docs/pt/managed-settings.md#delivery-mechanisms), já que a [entrega gerenciada pelo servidor não está disponível em configurações de gateway](https://code.claude.com/docs/pt/server-managed-settings.md#platform-availability) |290| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Defina como `1` para preencher o seletor de `/model` a partir do endpoint `/v1/models` do seu gateway quando `ANTHROPIC_BASE_URL` apontar para um gateway compatível com a Anthropic, como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque gateways com 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`](https://code.claude.com/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](https://code.claude.com/docs/pt/managed-settings.md#delivery-mechanisms), já que [a entrega gerenciada pelo servidor não está disponível em configurações de gateway](https://code.claude.com/docs/pt/server-managed-settings.md#platform-availability) |

289| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Removida na v2.1.142, quando o padrão do [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) passou do Opus 4.6 para o Opus 4.7 |291| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Removida na v2.1.142, quando o padrão do [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) passou do Opus 4.6 para o Opus 4.7 |

290| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Defina como `false` para desativar as sugestões de prompt, as previsões em cinza que aparecem na entrada do prompt. Tem precedência sobre a configuração [`promptSuggestionEnabled`](https://code.claude.com/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á perto ou no limite de uso](https://code.claude.com/docs/pt/interactive-mode.md#when-claude-code-skips-suggestions). Defina como `true` para impedir que essa pausa se aplique até você atingir o limite. Requer Claude Code v2.1.238 ou posterior. Consulte [Sugestões de prompt](https://code.claude.com/docs/pt/interactive-mode.md#prompt-suggestions) |292| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Defina como `false` para desativar as sugestões de prompt, as previsões esmaecidas que aparecem na entrada de prompt. Tem precedência sobre a configuração [`promptSuggestionEnabled`](https://code.claude.com/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 ou no seu limite de uso](https://code.claude.com/docs/pt/interactive-mode.md#when-claude-code-skips-suggestions). Defina como `true` para impedir que essa pausa se aplique até você atingir o limite. Requer Claude Code v2.1.238 ou posterior. Consulte [Sugestões de prompt](https://code.claude.com/docs/pt/interactive-mode.md#prompt-suggestions) |

291| `CLAUDE_CODE_ENABLE_SHARE_BUNDLE` | Defina como `1` para fazer com que [`/share`](https://code.claude.com/docs/pt/commands#all-commands) salve seu relatório e toda a transcrição da sessão em um [arquivo local em `~/.claude/feedback-bundles/`](https://code.claude.com/docs/pt/data-usage#telemetry-services) em vez de enviar o relatório à Anthropic. Se a política da sua organização desativar `/share`, você não pode reativá-lo com esta variável. Requer Claude Code v2.1.299 ou posterior |293| `CLAUDE_CODE_ENABLE_SHARE_BUNDLE` | Defina como `1` para fazer [`/share`](https://code.claude.com/docs/pt/commands#all-commands) salvar seu relatório e toda a transcrição da sessão em um [arquivo local em `~/.claude/feedback-bundles/`](https://code.claude.com/docs/pt/data-usage#telemetry-services) em vez de enviar o relatório à Anthropic. Se a política da sua organização desativar `/share`, você não pode reativá-lo com esta variável. Requer Claude Code v2.1.299 ou posterior |

292| `CLAUDE_CODE_ENABLE_TASKS` | Seleciona quais ferramentas de acompanhamento de tarefas o Claude Code fornece nas [sessões que as têm](https://code.claude.com/docs/pt/tools-reference.md#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`. Consulte [Lista de tarefas](https://code.claude.com/docs/pt/interactive-mode.md#task-list) |294| `CLAUDE_CODE_ENABLE_TASKS` | Seleciona quais ferramentas de acompanhamento de tarefas o Claude Code fornece em [sessões que as têm](https://code.claude.com/docs/pt/tools-reference.md#task-tool-availability). Por padrão, o Claude Code fornece as ferramentas Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Defina como `0` para obter a ferramenta legada `TodoWrite` em vez disso. Consulte [Lista de tarefas](https://code.claude.com/docs/pt/interactive-mode.md#task-list) |

293| `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 os 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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |295| `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 nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |

294| `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](https://code.claude.com/docs/pt/tools-reference.md#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` ainda seleciona as ferramentas Task ou `TodoWrite`. Requer Claude Code v2.1.233 ou posterior |296| `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](https://code.claude.com/docs/pt/tools-reference.md#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` ainda seleciona as ferramentas Task ou `TodoWrite`. Requer Claude Code v2.1.233 ou posterior |

295| `CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS` | Defina como `1` para [executar comandos `rm` perigosos sem prompt](https://code.claude.com/docs/pt/permission-modes#turn-off-the-critical-path-removal-prompt-in-bypasspermissions-mode) no modo `bypassPermissions`, o que remove um prompt de segurança para exclusões destrutivas. A seção vinculada lista onde ela não tem efeito. [Defina-a no ambiente que inicia o Claude Code](#set-variables-in-your-shell), porque o Claude Code [a ignora em um bloco `env` de configurações](https://code.claude.com/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.311 ou posterior |297| `CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS` | Defina como `1` para [executar comandos `rm` perigosos sem prompt](https://code.claude.com/docs/pt/permission-modes#turn-off-the-critical-path-removal-prompt-in-bypasspermissions-mode) no modo `bypassPermissions`, o que remove um prompt de segurança para exclusões destrutivas. A seção vinculada lista onde ela não tem efeito. [Defina-a no ambiente que inicia o Claude Code](#set-variables-in-your-shell), porque o Claude Code [a ignora em um bloco `env` de configurações](https://code.claude.com/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.311 ou posterior |

296| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo em milissegundos de espera após o loop de consultas ficar ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts que usam o modo SDK |298| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo em milissegundos a aguardar depois que o loop de consultas fica ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts que usam o modo SDK |

297| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Defina como `1` para ativar [equipes de agentes](https://code.claude.com/docs/pt/agent-teams.md). As equipes de agentes são experimentais e estão desativadas por padrão |299| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Defina como `1` para ativar as [equipes de agentes](https://code.claude.com/docs/pt/agent-teams.md). As equipes de agentes são experimentais e ficam desativadas por padrão |

298| `CLAUDE_CODE_EXTRA_BODY` | Objeto JSON a ser mesclado no nível superior do corpo de toda requisição à 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](https://code.claude.com/docs/pt/agent-view.md) que você despacha com `claude agents` ou `--bg`. Antes da v2.1.206, as sessões em segundo plano ignoravam um valor exportado no shell e usavam a cópia que o processo supervisor em segundo plano tivesse herdado |300| `CLAUDE_CODE_EXTRA_BODY` | Objeto JSON a ser mesclado no nível superior dos corpos das requisições ao modelo, exceto em algumas requisições fora da conversa, como verificações de `/model`. Ú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](https://code.claude.com/docs/pt/agent-view.md) 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 |

299| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sobrescreve o limite padrão de tokens para [leituras de arquivos](https://code.claude.com/docs/pt/tools-reference.md#large-files), que é de 25.000 tokens. Útil quando você precisa ler arquivos maiores por completo. Uma leitura que o Claude faz com o parâmetro `allow_large` pode ultrapassar esse limite quando a janela de contexto tem espaço |301| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sobrescreve o limite de tokens padrão para [leituras de arquivos](https://code.claude.com/docs/pt/tools-reference.md#large-files), que é de 25.000 tokens. Útil quando você precisa ler arquivos maiores por completo. Uma leitura que o Claude faz com o parâmetro `allow_large` pode ultrapassar este limite quando a janela de contexto tem espaço |

300| `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 `CLAUDE_CODE_CHILD_SESSION` herdado, por exemplo de uma sessão `screen` ou de um inicializador em segundo plano iniciado pela primeira vez 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, 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, nas quais a detecção de sessão aninhada que ela sobrescreve foi removida |302| `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 `CLAUDE_CODE_CHILD_SESSION` herdado, por exemplo de uma sessão `screen` ou de um inicializador em segundo plano iniciado pela primeira vez pela ferramenta Bash do Claude Code, faz com que uma sessão de nível superior legítima 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 v2.1.171, em que a detecção de sessão aninhada que ela sobrescreve foi removida |

301| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Defina como `1` para forçar a renderização de tachado para `~~text~~` nas respostas do Claude quando seu terminal oferece suporte, mas não é detectado automaticamente, como via SSH sem `TERM_PROGRAM` encaminhada. 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 |303| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Defina como `1` para forçar a renderização de tachado para `~~text~~` nas respostas do Claude quando seu terminal oferece suporte, mas não é detectado automaticamente, como via SSH sem `TERM_PROGRAM` encaminhado. Sem isto, terminais não detectados mostram os marcadores `~~` literais em vez de renderizar o texto como tachado. Requer Claude Code v2.1.186 ou posterior |

302| `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. Ao contrário de `CLAUDE_CODE_NO_FLICKER`, que muda para a [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), isso não altera o renderizador |304| `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. Ao contrário de `CLAUDE_CODE_NO_FLICKER`, que muda para a [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), isto não altera o renderizador |

303| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | Defina como `1` para desenhar [elementos `Image` de mods](https://code.claude.com/docs/pt/plugins/mods/reference#elements) como imagens quando seu terminal desenha imagens do protocolo gráfico kitty com placeholders Unicode e você ainda vê o texto `alt` esmaecido de uma `Image`. Consulte [quais terminais desenham uma `Image` e onde não definir esta variável](https://code.claude.com/docs/pt/plugins/mods/gallery#image-and-client) |305| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | Defina como `1` para desenhar [elementos `Image` de mods](https://code.claude.com/docs/pt/plugins/mods/reference#elements) como imagens quando seu terminal desenha imagens do protocolo gráfico kitty com placeholders Unicode e você ainda vê o texto `alt` esmaecido de uma `Image`. Consulte [quais terminais desenham uma `Image` e onde não definir esta variável](https://code.claude.com/docs/pt/plugins/mods/gallery#image-and-client) |

304| `CLAUDE_CODE_FORK_SUBAGENT` | Controla o modo fork, que está ativado por padrão e permite que o Claude inicie [forks](https://code.claude.com/docs/pt/sub-agents.md#fork-the-current-conversation) por conta própria. Enquanto o modo fork está ativado, o Claude também não pode [aguardar um subagente](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) em sessões interativas de terminal, VS Code ou desktop na sua máquina. Defina como `0` para desativar o modo fork. Para versões, consulte [Desativar o modo fork](https://code.claude.com/docs/pt/sub-agents.md#turn-fork-mode-on-or-off) |306| `CLAUDE_CODE_FORK_SUBAGENT` | Controla o modo fork, que é ativado por padrão e permite que o Claude inicie [forks](https://code.claude.com/docs/pt/sub-agents.md#fork-the-current-conversation) por conta própria. Enquanto o modo fork estiver ativado, o Claude também não pode [aguardar um subagente](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) em sessões interativas de terminal, VS Code ou desktop na sua máquina. Defina como `0` para desativar o modo fork. Para versões, consulte [Desativar o modo fork](https://code.claude.com/docs/pt/sub-agents.md#turn-fork-mode-on-or-off) |

305| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Defina como `1` para emitir blocos de texto e de pensamento de [subagentes](https://code.claude.com/docs/pt/sub-agents.md) na saída de `claude -p --output-format stream-json`, o mesmo comportamento da flag [`--forward-subagent-text`](https://code.claude.com/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 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 |307| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Defina como `1` para emitir blocos de texto e de pensamento de [subagentes](https://code.claude.com/docs/pt/sub-agents.md) na saída de `claude -p --output-format stream-json`, o mesmo comportamento da flag [`--forward-subagent-text`](https://code.claude.com/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. Ao contrário da flag, que sai com um erro fora do modo não interativo com saída stream-json, a variável é ignorada nesse caso, para que invocações aninhadas continuem funcionando quando ela é definida para todo o processo. Requer Claude Code v2.1.211 ou posterior |

306| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Defina como `1` para enviar os [cabeçalhos de dica do gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#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 |308| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Defina como `1` para enviar os [cabeçalhos de dica de gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#gateway-hint-headers), como `x-claude-code-request-class` e `x-claude-code-compaction`, em um proxy personalizado ou em um provedor de terceiros, 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 |

307| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout em milissegundos para a requisição de [descoberta de modelos do gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#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 |309| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout em milissegundos para a requisição de [descoberta de modelos do gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#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 |

308| `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 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](https://code.claude.com/docs/pt/setup.md#set-up-on-windows) |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](https://code.claude.com/docs/pt/setup.md#set-up-on-windows) |

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

310| `CLAUDE_CODE_GLOB_NO_IGNORE` | Defina como `false` para fazer a [ferramenta Glob](https://code.claude.com/docs/pt/tools-reference.md#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`](https://code.claude.com/docs/pt/settings-reference#respectgitignore) |312| `CLAUDE_CODE_GLOB_NO_IGNORE` | Defina como `false` para fazer a [ferramenta Glob](https://code.claude.com/docs/pt/tools-reference.md#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`](https://code.claude.com/docs/pt/settings-reference#respectgitignore) |

311| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout em segundos para as buscas das ferramentas [Glob](https://code.claude.com/docs/pt/tools-reference.md#glob-tool-behavior) e Grep. O padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |313| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout em segundos para pesquisas das ferramentas [Glob](https://code.claude.com/docs/pt/tools-reference.md#glob-tool-behavior) e Grep. O padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |

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

313| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Defina como `0` para desativar a compactação gzip dos corpos de requisição da Claude API, de telemetria e de publicação de [artefatos](https://code.claude.com/docs/pt/artifacts.md) enviados para `api.anthropic.com`. Por padrão, o Claude Code compacta corpos de requisição grandes em conexões diretas e ignora a compactação quando você envia requisições por meio de um proxy, configura um certificado de cliente ou define `NODE_EXTRA_CA_CERTS`. Use `0` se um [proxy com inspeção de TLS](https://code.claude.com/docs/pt/network-config.md#ca-certificate-store) que o Claude Code não consegue detectar tratar incorretamente requisições compactadas |315| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Defina como `0` para desativar a compressão gzip dos corpos das requisições da Claude API, de telemetria e de publicação de [artefatos](https://code.claude.com/docs/pt/artifacts.md) enviadas para `api.anthropic.com`. Por padrão, o Claude Code comprime corpos de requisição grandes em conexões diretas e ignora a compressão quando você envia requisições por um proxy, configura um certificado de cliente ou define `NODE_EXTRA_CA_CERTS`. Use `0` se um [proxy de inspeção TLS](https://code.claude.com/docs/pt/network-config.md#ca-certificate-store) que o Claude Code não consegue detectar lidar incorretamente com requisições comprimidas |

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

315| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sobrescreve o endereço do host usado para se conectar à extensão do IDE. Por padrão, o Claude Code detecta automaticamente o endereço correto, incluindo o roteamento de WSL para Windows |317| `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 |

316| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para impedir que `/ide` instale a extensão do IDE. Equivalente a definir [`autoInstallIdeExtension`](https://code.claude.com/docs/pt/settings-reference#autoinstallideextension) como `false` |318| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para impedir que `/ide` instale a extensão da IDE. Equivalente a definir [`autoInstallIdeExtension`](https://code.claude.com/docs/pt/settings-reference#autoinstallideextension) como `false`. Versões do Claude Code anteriores à v2.1.318 também instalam ou atualizam a extensão quando você inicia `claude` em um terminal do VS Code, Cursor ou Devin Desktop. Esta variável também impede isso |

317| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Defina como `1` para ignorar 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 apesar de ele estar em execução |319| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Defina como `1` para ignorar a validação das entradas do lockfile da IDE durante a conexão. Use quando a conexão automática não encontrar sua IDE mesmo ela estando em execução |

318| `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` | Tamanho do contexto, em tokens, a partir do qual a [compactação ociosa](https://code.claude.com/docs/pt/settings-reference.md#idlecompaction) se aplica a uma conversa (padrão: `200000`). Aceita um número inteiro positivo, e qualquer outro valor é ignorado. Valores abaixo de `100000` são elevados para `100000`, o limite mais baixo. A compactação ociosa está ativada por padrão para conversas que atendem às suas condições. Para desativá-la, defina `idleCompaction` como `false`. Requer Claude Code v2.1.290 ou posterior |320| `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` | Tamanho do contexto, em tokens, a partir do qual a [compactação por inatividade](https://code.claude.com/docs/pt/settings-reference.md#idlecompaction) se aplica a uma conversa (padrão: `200000`). Aceita um número inteiro positivo, e qualquer outro valor é ignorado. Valores abaixo de `100000` são elevados para `100000`, o limite mais baixo. A compactação por inatividade é ativada por padrão para conversas que atendem às suas condições. Para desativá-la, defina `idleCompaction` como `false`. Requer Claude Code v2.1.290 ou posterior |

319| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Quantos [subagentes](https://code.claude.com/docs/pt/sub-agents.md#concurrent-subagent-limit) podem estar em execução em uma sessão antes que a ferramenta Agent se recuse a criar outro (padrão: 20). Aceita um número inteiro positivo em dígitos simples; qualquer outro valor é ignorado, 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](https://code.claude.com/docs/pt/sub-agents.md#concurrent-subagent-limit) podem estar em execução em uma sessão antes que a ferramenta Agent se recuse a criar outro (padrão: 20). Aceita um número inteiro positivo em dígitos simples; qualquer outro valor é ignorado, de modo que 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 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](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id). Use isso ao rotear para um modelo por meio de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para o seu nome |322| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sobrescreve o tamanho da janela de contexto que o Claude Code presume 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](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id). Use isto ao rotear para um modelo via `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho embutido para o seu nome |

321| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Comprimento máximo, em caracteres, das descrições de ferramentas MCP e das instruções de servidores MCP que o Claude Code envia ao modelo. O valor que você define substitui ambos os [limites padrão](https://code.claude.com/docs/pt/mcp.md#for-mcp-server-authors): 4096, e 16384 para a descrição de uma ferramenta que o Claude carrega por meio da busca de ferramentas. Aceita um número inteiro positivo em dígitos simples. Qualquer outro valor é ignorado e os padrões se aplicam. Requer Claude Code v2.1.280 ou posterior |323| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Comprimento máximo, em caracteres, das descrições de ferramentas MCP e das instruções de servidores MCP que o Claude Code envia ao modelo. O valor que você define substitui ambos os [limites padrão](https://code.claude.com/docs/pt/mcp.md#for-mcp-server-authors): 4096, e 16384 para a descrição de uma ferramenta que o Claude carrega por meio da pesquisa de ferramentas. Aceita um número inteiro positivo em dígitos simples. Qualquer outro valor é ignorado e os padrões se aplicam. 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 associar a um modelo conhecido, o padrão é 32000 e o limite é 128000. Aumentar esse valor reduz a janela de contexto efetiva disponível antes que a [compactação automática](https://code.claude.com/docs/pt/costs.md#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. 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 o 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](https://code.claude.com/docs/pt/costs.md#reduce-token-usage) seja acionada |

323| `CLAUDE_CODE_MAX_RETRIES` | Sobrescreve o número de vezes para tentar novamente requisições à API que falharam (padrão: 10). As novas tentativas podem parar antes em erros `529` de sobrecarga. Por exemplo, com uma chave de API em um modelo Opus, elas param no terceiro `529` e mostram [Repeated 529 Overloaded errors](https://code.claude.com/docs/pt/errors.md#api-error-repeated-529-overloaded-errors). Se você definir um [modelo de fallback](https://code.claude.com/docs/pt/settings-reference.md#fallbackmodel), o Claude Code muda para esse modelo em vez de mostrar o erro. 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). As novas tentativas podem parar antes em erros `529` de sobrecarga. Por exemplo, com uma chave de API em um modelo Opus, elas param no terceiro `529` e mostram [Repeated 529 Overloaded errors](https://code.claude.com/docs/pt/errors.md#api-error-repeated-529-overloaded-errors). Se você definir um [modelo de fallback](https://code.claude.com/docs/pt/settings-reference.md#fallbackmodel), o Claude Code muda para esse modelo em vez de mostrar o erro. 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 assistidas 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](https://code.claude.com/docs/pt/sub-agents.md) que o Claude podia criar com a ferramenta Agent em uma sessão (padrão: 200); criar além do limite falhava com `Subagent spawn limit reached`. O [limite de subagentes simultâneos](https://code.claude.com/docs/pt/sub-agents.md#concurrent-subagent-limit) e o [limite de profundidade](https://code.claude.com/docs/pt/sub-agents.md#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](https://code.claude.com/docs/pt/sub-agents.md) que o Claude podia criar com a ferramenta Agent em uma sessão (padrão: 200); criar além do limite falhava com `Subagent spawn limit reached`. O [limite de subagentes simultâneos](https://code.claude.com/docs/pt/sub-agents.md#concurrent-subagent-limit) e o [limite de profundidade](https://code.claude.com/docs/pt/sub-agents.md#let-subagents-spawn-their-own-subagents) ainda se aplicam |

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

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

327| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Limite de chamadas de [WebSearch](https://code.claude.com/docs/pt/tools-reference.md#session-search-limit) (padrão: 200). Quando o Claude atinge o limite, chamadas adicionais de WebSearch retornam um aviso dizendo a ele para continuar com as informações já reunidas e mencionar isso em sua resposta. Aceita um número inteiro positivo sem limite superior. Qualquer outro valor é ignorado e o padrão se aplica, então o limite pode ser aumentado, mas não desativado. Requer Claude Code v2.1.212 ou posterior |329| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Limite de chamadas de [WebSearch](https://code.claude.com/docs/pt/tools-reference.md#session-search-limit) (padrão: 200). Quando o Claude atinge o limite, novas chamadas de WebSearch retornam um aviso dizendo para continuar com as informações já coletadas e informar isso em sua resposta. Aceita um número inteiro positivo sem limite superior. Qualquer outro valor é ignorado e o padrão se aplica, de modo que o limite pode ser aumentado, mas não desativado. Requer Claude Code v2.1.212 ou posterior |

328| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Defina como `1` para iniciar servidores MCP stdio apenas com um ambiente básico seguro mais o `env` configurado do servidor, em vez de herdar o ambiente do seu shell |330| `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 |

329| `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](https://code.claude.com/docs/pt/mcp.md#automatic-backgrounding-of-long-tool-calls) (padrão: 120000, ou 2 minutos). Defina como `0` para desativar a passagem automática para segundo plano e, em uma sessão interativa, para fazer o Claude aguardar [tarefas MCP](https://code.claude.com/docs/pt/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task). Requer Claude Code v2.1.212 ou posterior |331| `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](https://code.claude.com/docs/pt/mcp.md#automatic-backgrounding-of-long-tool-calls) (padrão: 120000, ou 2 minutos). Defina como `0` para desativar a passagem automática para segundo plano e, em uma sessão interativa, para fazer o Claude aguardar as [tarefas MCP](https://code.claude.com/docs/pt/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task). Requer Claude Code v2.1.212 ou posterior |

330| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Por quanto tempo, em milissegundos, o primeiro turno de uma sessão [não interativa](https://code.claude.com/docs/pt/headless.md) aguarda servidores MCP que ainda estão se conectando, no lugar da [espera padrão do primeiro turno](https://code.claude.com/docs/pt/agent-sdk/mcp.md#connection-timing). Em um [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#connection-timing), ela altera apenas quanto tempo a espera dura. Alguns servidores mantêm uma espera própria independentemente do valor; [Tempo de conexão](https://code.claude.com/docs/pt/agent-sdk/mcp.md#connection-timing) os lista. Defina como `0` para pular a espera para todos os outros servidores. Requer Claude Code v2.1.274 ou posterior |332| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Quanto tempo, em milissegundos, o primeiro turno de uma sessão [não interativa](https://code.claude.com/docs/pt/headless.md) aguarda por servidores MCP que ainda estão se conectando, no lugar da [espera do primeiro turno](https://code.claude.com/docs/pt/agent-sdk/mcp.md#connection-timing) padrão. Em um [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#connection-timing), ela altera apenas a duração da espera. Alguns servidores mantêm uma espera própria independentemente do valor; [Tempo de conexão](https://code.claude.com/docs/pt/agent-sdk/mcp.md#connection-timing) os lista. Defina como `0` para pular a espera de todos os outros servidores. Requer Claude Code v2.1.274 ou posterior |

331| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Timeout de ociosidade em milissegundos para chamadas de ferramenta MCP. Quando um servidor MCP stdio, HTTP, SSE, WebSocket ou [conector do claude.ai](https://code.claude.com/docs/pt/mcp.md#use-mcp-servers-from-claude-ai) não envia resposta nem notificação de progresso por esse período, 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 ociosidade. 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 ociosidade 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 eram isentos do timeout de ociosidade |333| `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](https://code.claude.com/docs/pt/mcp.md#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 eram isentos do timeout de inatividade |

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

333| `CLAUDE_CODE_MESSAGING_TOKEN` | Definida pelo Claude Code, não por você: em sessões que vinculam um [socket de caixa de entrada](https://code.claude.com/docs/pt/cross-session-messaging.md#the-sessions-inbox-socket), o Claude Code exporta este token por sessão para hooks e comandos Bash junto com `CLAUDE_CODE_MESSAGING_SOCKET`. Um script que envia ao 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 filho próprio](https://code.claude.com/docs/pt/cross-session-messaging.md#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_MESSAGING_TOKEN` | Definida pelo Claude Code, não por você: em sessões que vinculam um [socket de caixa de entrada](https://code.claude.com/docs/pt/cross-session-messaging.md#the-sessions-inbox-socket), o Claude Code exporta este token por sessão para hooks e comandos Bash junto com `CLAUDE_CODE_MESSAGING_SOCKET`. Um script que envia ao socket pode mandar `{"type":"auth","token":"<token>"}` como sua primeira linha para provar que pertence à sessão. No Windows nativo, o Claude Code exige esta linha e fecha qualquer conexão que não comece com uma linha válida. As [regras de processo filho próprio](https://code.claude.com/docs/pt/cross-session-messaging.md#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 |

334| `CLAUDE_CODE_NATIVE_CURSOR` | Defina como `1` para mostrar o cursor do próprio 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. Definir `0` equivale a deixar a variável não definida, portanto não traz de volta o bloco desenhado em uma sessão em que o cursor do próprio terminal já está ativado |336| `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. Definir `0` equivale a deixar a variável sem definição, portanto não traz de volta o bloco desenhado em uma sessão em que o cursor do próprio terminal já está ativo |

335| `CLAUDE_CODE_NEW_INIT` | Defina como `1` para fazer o `/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, o `/init` gera um CLAUDE.md automaticamente, sem perguntar |337| `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 |

336| `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 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 o stdout é um terminal. Requer Claude Code v2.1.261 ou posterior |338| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Defina como `1` para gravar a saída do terminal por um segundo descritor de arquivo não bloqueante, de modo que um terminal que para 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 |

337| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quantas vezes o Claude Code reenvia uma [requisição sem streaming](https://code.claude.com/docs/pt/errors.md#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Com `0`, a requisição falha no primeiro timeout. Consulte [Ajustar o comportamento de novas tentativas](https://code.claude.com/docs/pt/errors.md#tune-retry-behavior) para o timeout. Requer Claude Code v2.1.285 ou posterior |339| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quantas vezes o Claude Code reenvia uma [requisição sem streaming](https://code.claude.com/docs/pt/errors.md#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Com `0`, a requisição falha no primeiro timeout. Consulte [Ajustar o comportamento de novas tentativas](https://code.claude.com/docs/pt/errors.md#tune-retry-behavior) para o timeout. Requer Claude Code v2.1.285 ou posterior |

338| `CLAUDE_CODE_NO_FLICKER` | Defina como `1` para ativar a [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), 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`](https://code.claude.com/docs/pt/settings-reference#tui); você também pode alternar com `/tui fullscreen` |340| `CLAUDE_CODE_NO_FLICKER` | Defina como `1` para ativar a [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), 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`](https://code.claude.com/docs/pt/settings-reference#tui); você também pode alternar com `/tui fullscreen` |

339| `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. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |341| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token de atualização OAuth para autenticação no claude.ai. Quando definido, `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. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

340| `CLAUDE_CODE_OAUTH_SCOPES` | Escopos OAuth, separados por espaços, 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. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |342| `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. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

341| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acesso OAuth para autenticação no claude.ai. Alternativa a `/login` para o SDK e ambientes automatizados. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Tem precedência sobre credenciais armazenadas no keychain. Gere um com [`claude setup-token`](https://code.claude.com/docs/pt/authentication#generate-a-long-lived-token). A menos que você execute [`/login`](https://code.claude.com/docs/pt/authentication#authentication-precedence), o Claude Code usa o token definido durante toda a sessão. Para substituir um token expirado, gere um novo e reinicie |343| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acesso OAuth para autenticação no claude.ai. Alternativa a `/login` para SDK e ambientes automatizados. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Tem precedência sobre credenciais armazenadas no keychain. Gere um com [`claude setup-token`](https://code.claude.com/docs/pt/authentication#generate-a-long-lived-token). A menos que você execute [`/login`](https://code.claude.com/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 |

342| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Removida na v2.1.160 e agora sem efeito. Anteriormente fixava o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) 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_OPUS_4_6_FAST_MODE_OVERRIDE` | Removida na v2.1.160 e agora sem efeito. Anteriormente fixava o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) no Claude Opus 4.6 em vez do padrão atual. O Opus 4.6 não oferece mais suporte ao modo rápido |

343| `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 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](https://code.claude.com/docs/pt/monitoring-usage.md) |345| `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 somente 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](https://code.claude.com/docs/pt/monitoring-usage.md) |

344| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Defina como `1` para gravar erros de diagnóstico do exportador OpenTelemetry no stderr. Por padrão, esses erros só aparecem com `--debug`, então um exportador mal configurado, como um conflito de porta do Prometheus, falha silenciosamente. Requer Claude Code v2.1.179 ou posterior. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |346| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Defina como `1` para gravar erros de diagnóstico do exportador do OpenTelemetry em stderr. Por padrão, esses erros só aparecem com `--debug`, portanto um exportador mal configurado, como em uma colisão de porta do Prometheus, falharia silenciosamente. Requer Claude Code v2.1.179 ou posterior. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |

345| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout em milissegundos para descarregar spans pendentes do OpenTelemetry (padrão: 5000). Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |347| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout em milissegundos para descarregar spans pendentes do OpenTelemetry (padrão: 5000). Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |

346| `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](https://code.claude.com/docs/pt/monitoring-usage.md#dynamic-headers) |348| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalo para atualizar os cabeçalhos dinâmicos do OpenTelemetry em milissegundos (padrão: 1740000 / 29 minutos). Consulte [Cabeçalhos dinâmicos](https://code.claude.com/docs/pt/monitoring-usage.md#dynamic-headers) |

347| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout em milissegundos para o exportador OpenTelemetry concluir no encerramento (padrão: 2000). Aumente se métricas forem descartadas na saída. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |349| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout em milissegundos para o exportador do OpenTelemetry terminar no encerramento (padrão: 2000). Aumente se métricas forem descartadas na saída. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |

348| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | Atraso inicial em milissegundos, no lugar do padrão de 500, do backoff exponencial entre [novas tentativas automáticas](https://code.claude.com/docs/pt/errors.md#tune-retry-behavior) de uma requisição que a API rejeita com um erro `529` de sobrecarga. Aumente-o para distribuir as novas tentativas por uma janela mais longa quando a API estiver no limite da capacidade. Informe milissegundos inteiros de 500 a 32000 em dígitos simples; o Claude Code trata qualquer outro valor como não definido. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definida como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.292 ou posterior |350| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | Atraso inicial em milissegundos, no lugar do padrão de 500, do backoff exponencial entre as [novas tentativas automáticas](https://code.claude.com/docs/pt/errors.md#tune-retry-behavior) de uma requisição que a API rejeita com um erro `529` de sobrecarga. Aumente-o para distribuir as novas tentativas por uma janela mais longa quando a API estiver no limite da capacidade. Informe milissegundos inteiros de 500 a 32000 em dígitos simples; o Claude Code trata qualquer outro valor como não definido. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definida como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.292 ou posterior |

349| `CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS` | Teto em milissegundos, no lugar do padrão de 32000, do backoff exponencial entre [novas tentativas automáticas](https://code.claude.com/docs/pt/errors.md#tune-retry-behavior) de uma requisição que a API rejeita com um erro `529` de sobrecarga. Aumente-o para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite da capacidade. Informe milissegundos inteiros de 32000 a 64000 em dígitos simples; o Claude Code trata qualquer outro valor como não definido. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definida como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.296 ou posterior |351| `CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS` | Teto em milissegundos, no lugar do padrão de 32000, do backoff exponencial entre as [novas tentativas automáticas](https://code.claude.com/docs/pt/errors.md#tune-retry-behavior) de uma requisição que a API rejeita com um erro `529` de sobrecarga. Aumente-o para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite da capacidade. Informe milissegundos inteiros de 32000 a 64000 em dígitos simples; o Claude Code trata qualquer outro valor como não definido. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definida como `1`, ou quando a requisição rejeitada foi enviada no [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). Requer Claude Code v2.1.296 ou posterior |

350| `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](https://code.claude.com/docs/pt/setup.md#auto-updates) |352| `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](https://code.claude.com/docs/pt/setup.md#auto-updates) |

351| `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 controle de alterações do Perforce |353| `CLAUDE_CODE_PERFORCE_MODE` | Defina como `1` para ativar a proteção de 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 |

352| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sobrescreve o diretório raiz dos plugins. Apesar do nome, isso define o diretório pai, não o próprio cache: os marketplaces e o cache de plugins ficam em subdiretórios desse caminho. O padrão é `~/.claude/plugins` |354| `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` |

353| `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`](https://code.claude.com/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](https://code.claude.com/docs/pt/plugins/create.md#load-a-directory-or-archive-for-one-session) |355| `CLAUDE_CODE_PLUGIN_DIRS` | Diretórios de plugins a carregar para a sessão, cada um carregado da forma como uma flag [`--plugin-dir`](https://code.claude.com/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](https://code.claude.com/docs/pt/plugins/create.md#load-a-directory-or-archive-for-one-session) |

354| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | Controla se o Claude Code recarrega um [mod](https://code.claude.com/docs/pt/plugins/mods/overview.md) quando os arquivos do mod mudam. O recarregamento se aplica a um mod que você carrega de um diretório com `--plugin-dir` e está ativado por padrão em sessões interativas. Defina como `1` para ativá-lo também em sessões não interativas, ou `0` para desativá-lo em todas as sessões. Requer Claude Code v2.1.287 ou posterior. Consulte [configurações e variáveis de ambiente de mods](https://code.claude.com/docs/pt/plugins/mods/reference.md#settings-and-environment-variables) |356| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | Controla se o Claude Code recarrega um [mod](https://code.claude.com/docs/pt/plugins/mods/overview.md) quando os arquivos do mod mudam. O recarregamento se aplica a um mod que você carrega de um diretório com `--plugin-dir` e é ativado por padrão em sessões interativas. Defina como `1` para ativá-lo também em sessões não interativas, ou `0` para desativá-lo em todas as sessões. Requer Claude Code v2.1.287 ou posterior. Consulte [configurações e variáveis de ambiente de mods](https://code.claude.com/docs/pt/plugins/mods/reference.md#settings-and-environment-variables) |

355| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout em milissegundos para clonar ou atualizar um marketplace de plugins (padrão: 120000). Aumente esse valor para repositórios grandes ou conexões de rede lentas. Consulte [Git clone timed out](https://code.claude.com/docs/pt/plugins/troubleshooting.md#git-clone-timed-out-after-120s) |357| `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](https://code.claude.com/docs/pt/plugins/troubleshooting.md#git-clone-timed-out-after-120s) |

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 consegue alcançar o remoto ou se autenticar nele. Útil em ambientes offline ou isolados (airgapped), nos quais clonar novamente falharia da mesma forma. Consulte [Atualizações de marketplace falham em ambientes offline](https://code.claude.com/docs/pt/plugins/troubleshooting.md#marketplace-updates-keep-failing-offline) |358| `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](https://code.claude.com/docs/pt/plugins/troubleshooting.md#marketplace-updates-keep-failing-offline) |

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

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

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 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 |361| `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 em vez disso 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 as políticas `MachinePolicy` ou `UserPolicy` da Política de Grupo, independentemente desta configuração |

360| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Teto em milissegundos para a espera ociosa por trabalho em segundo plano, como subagentes e fluxos de trabalho, após o turno final no [modo não interativo](https://code.claude.com/docs/pt/headless.md#background-tasks-at-exit) com a flag `-p`. A espera ociosa recomeça toda vez que o Claude usa um turno para lidar com um resultado em segundo plano. Padrão: `600000`, ou 10 minutos. Quando a espera ociosa atinge o teto, o Claude Code para de aguardar as tarefas em segundo plano restantes. Um comando em segundo plano em execução que a conversa principal iniciou mantém a execução aberta além dele. Defina como `0` para aguardar indefinidamente. Requer Claude Code v2.1.182 ou posterior |362| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Teto em milissegundos para a espera ociosa por trabalho em segundo plano, como subagentes e workflows, após o turno final no [modo não interativo](https://code.claude.com/docs/pt/headless.md#background-tasks-at-exit) com a flag `-p`. A espera ociosa recomeça cada vez que o Claude faz um turno para lidar com um resultado em segundo plano. Padrão: `600000`, ou 10 minutos. Quando a espera ociosa atinge o teto, o Claude Code para de aguardar as tarefas em segundo plano restantes. Um comando em segundo plano em execução iniciado pela conversa principal mantém a execução aberta além dele. Defina como `0` para aguardar indefinidamente. Requer Claude Code v2.1.182 ou posterior |

361| `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 do [agent view](https://code.claude.com/docs/pt/agent-view.md), por meio de um inicializador corporativo informado como um prefixo argv, como `/opt/corp/launcher`. Defina-a no bloco `env` das configurações de usuário ou das [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), não como um export do shell, para que o serviço em segundo plano desanexado a herde; as configurações de projeto e locais não podem defini-la. Equivalente à [configuração `processWrapper`](https://code.claude.com/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](https://code.claude.com/docs/pt/corporate-launcher.md) 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 |363| `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](https://code.claude.com/docs/pt/agent-view.md), por meio de um inicializador corporativo informado como um prefixo argv, como `/opt/corp/launcher`. Defina-a no bloco `env` das configurações de usuário ou das [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), não como uma exportação do shell, para que o serviço em segundo plano desanexado a herde; as configurações de projeto e locais não podem defini-la. Equivalente à [configuração `processWrapper`](https://code.claude.com/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 sua configuração `claudeProcessWrapper`. Ignorada no Windows. Consulte [Executar o Claude Code por trás de um inicializador corporativo](https://code.claude.com/docs/pt/corporate-launcher.md) para o formato do valor, o que o inicializador cobre e o contrato que o inicializador deve cumprir. Requer Claude Code v2.1.208 ou posterior |

362| `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 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 o `claude`, nunca de um [bloco `env` de arquivo de configurações](#in-settings-files). Consulte [Nomear o diretório do projeto você mesmo](https://code.claude.com/docs/pt/sessions.md#name-the-project-directory-yourself). Requer Claude Code v2.1.234 ou posterior |364| `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 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](https://code.claude.com/docs/pt/sessions.md#name-the-project-directory-yourself). Requer Claude Code v2.1.234 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](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) para a conversa principal: seus turnos interativos, `-p` e do SDK, além dos auxiliares que são 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 |365| `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](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) para a conversa principal: seus turnos interativos, `-p` e do SDK, além dos auxiliares que são 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 com uma tarifa mais alta. Requer Claude Code v2.1.242 ou posterior |

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 ao modelo e a 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)](https://code.claude.com/docs/pt/monitoring-usage.md#traces-beta) |366| `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` nas requisições ao modelo e nas requisições MCP via HTTP, e a variável de ambiente `TRACEPARENT` para subprocessos de Bash, PowerShell e hooks. Por padrão, a propagação só é ativada quando há conexão direta com a API da Anthropic. Adicionada na v2.1.152. Consulte [Traces (beta)](https://code.claude.com/docs/pt/monitoring-usage.md#traces-beta) |

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](https://code.claude.com/docs/pt/managed-settings.md), 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`](https://code.claude.com/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 ignora 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](https://code.claude.com/docs/pt/data-usage.md#default-behaviors-by-api-provider) |367| `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, de modo 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](https://code.claude.com/docs/pt/managed-settings.md), seja qual for 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`](https://code.claude.com/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 normalmente aplica em provedores de terceiros, como Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud e Microsoft Foundry, de modo que a telemetria segue a desativação padrão via `DISABLE_TELEMETRY`. Consulte [Comportamentos padrão por provedor de API](https://code.claude.com/docs/pt/data-usage.md#default-behaviors-by-api-provider) |

366| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy faça 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 |368| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy faça 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 |

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

368| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definida automaticamente em [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) 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](https://code.claude.com/docs/pt/cloud-environments.md#link-output-back-to-the-session) |370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definida automaticamente em [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) 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](https://code.claude.com/docs/pt/cloud-environments.md#link-output-back-to-the-session) |

369| `CLAUDE_CODE_RESTRICTED` | Defina como `1` para iniciar a sessão no modo restrito, o mesmo que passar [`--restricted`](https://code.claude.com/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 |371| `CLAUDE_CODE_RESTRICTED` | Defina como `1` para iniciar a sessão no modo restrito, o mesmo que passar [`--restricted`](https://code.claude.com/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 |

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 recarregar](https://code.claude.com/docs/pt/vs-code.md#continue-conversations-after-a-reload) |372| `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](https://code.claude.com/docs/pt/vs-code.md#continue-conversations-after-a-reload) |

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 ignora a retomada automática de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e sua mensagem de continuação `CLAUDE_CODE_RESUME_PROMPT`, e a sessão começa ociosa para que você continue explicitamente. Não definida ou `0` não define limite, exceto que alguns turnos só são retomados em até seis horas após sua última mensagem, como um que terminou com um erro da API. 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 definir isso para que um reinício 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 do [agent view](https://code.claude.com/docs/pt/agent-view.md) que travou e que herdou sua conversa de uma sessão interativa. Requer Claude Code v2.1.211 ou posterior |373| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Idade máxima, em milissegundos, da última mensagem da transcrição para que uma sessão que terminou no meio de um turno continue automaticamente ao ser retomada. Quando a última mensagem é mais antiga que esse limite, o Claude Code pula a retomada automática de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e sua mensagem de continuação `CLAUDE_CODE_RESUME_PROMPT`, e a sessão começa ociosa para que você continue explicitamente. Sem definição ou `0` não define limite, exceto que alguns turnos só são retomados dentro de seis horas desde sua última mensagem, como um que terminou com um erro de API. 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 um reinício sobre 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](https://code.claude.com/docs/pt/agent-view.md) que falhou e que herdou sua conversa de uma sessão interativa. Requer Claude Code v2.1.211 ou posterior |

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](https://code.claude.com/docs/pt/hooks.md#defer-a-tool-call-for-later) com `-p`. O padrão é `Continue from where you left off.`. Uma string vazia usa o padrão |374| `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](https://code.claude.com/docs/pt/hooks.md#defer-a-tool-call-for-later) com `-p`. O padrão é `Continue from where you left off.`. Uma string vazia usa o padrão |

373| `CLAUDE_CODE_RESUME_SHOWS_CUT_OFF_CALLS` | Defina como `1` para manter as [chamadas de ferramenta interrompidas](https://code.claude.com/docs/pt/sessions.md#what-a-resumed-session-restores), marcadas como cortadas, em um turno que `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continua. Quando não definida, essas chamadas são descartadas antes que o turno continue. Algumas chamadas continuam sendo descartadas, como chamadas a subagentes, skills, workflows e ferramentas que aguardam uma pessoa. Para o painel de chat do VS Code, consulte [Continuar conversas após um recarregamento](https://code.claude.com/docs/pt/vs-code.md#continue-conversations-after-a-reload). Requer Claude Code v2.1.309 ou posterior |375| `CLAUDE_CODE_RESUME_SHOWS_CUT_OFF_CALLS` | Defina como `1` para manter as [chamadas de ferramenta interrompidas](https://code.claude.com/docs/pt/sessions.md#what-a-resumed-session-restores), marcadas como cortadas, em um turno que `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continua. Quando não definida, essas chamadas são descartadas antes que o turno continue. Algumas chamadas continuam descartadas, como chamadas a subagentes, skills, workflows e ferramentas que aguardam uma pessoa. Para o painel de chat do VS Code, consulte [Continuar conversas após um recarregamento](https://code.claude.com/docs/pt/vs-code.md#continue-conversations-after-a-reload). Requer Claude Code v2.1.309 ou posterior |

374| `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 um proveniente de um [limite de gastos do gateway](https://code.claude.com/docs/pt/errors.md#spend-limit-reached) que é redefinido em um cronograma. Antes da v2.1.239, o watchdog tentava novamente esses casos indefinidamente. Para requisições no modo rápido, consulte [Lidar com rate limits](https://code.claude.com/docs/pt/fast-mode.md#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 o número 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 |376| `CLAUDE_CODE_RETRY_WATCHDOG` | Defina como `1` para sessões não assistidas, 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](https://code.claude.com/docs/pt/errors.md#spend-limit-reached) que é redefinido conforme um cronograma. Antes da v2.1.239, o watchdog tentava novamente esses erros indefinidamente. Para requisições no modo rápido, consulte [Lidar com rate limits](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits). O watchdog aplica backoff de até 5 minutos entre as tentativas, ou até que o limite seja redefinido quando a resposta informa um horário de redefinição do rate limit, de modo que uma sessão que atinge um limite de uso aguarda 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 |

375| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | Tempo máximo, em milissegundos, que cada requisição à API passa aguardando erros `429` e `529` quando `CLAUDE_CODE_RETRY_WATCHDOG` está definida. Depois que esse tempo se esgota, o próximo erro desse tipo encerra a requisição. Informe um número inteiro positivo em dígitos simples, como `1800000` para 30 minutos. Quando não definida, a espera não tem limite. Requer Claude Code v2.1.295 ou posterior |377| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | Tempo máximo, em milissegundos, que cada requisição de API passa aguardando erros `429` e `529` quando `CLAUDE_CODE_RETRY_WATCHDOG` está definida. Depois que esse tempo se esgota, o próximo erro desse tipo encerra a requisição. Informe um número inteiro positivo em dígitos simples, como `1800000` para 30 minutos. Quando não definida, a espera não tem limite. Requer Claude Code v2.1.295 ou posterior |

376| `CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS` | Intervalo mínimo, em milissegundos, entre verificações de se um [limite de uso](https://code.claude.com/docs/pt/errors.md#youve-hit-your-session-limit) já foi suspenso, enquanto uma requisição aguarda a redefinição desse limite com `CLAUDE_CODE_RETRY_WATCHDOG` definida. Quando uma verificação constata que o limite foi suspenso, a requisição é enviada imediatamente. Informe um número inteiro em dígitos simples de `60000`, um minuto, a `10800000`, três horas. As verificações são feitas apenas para o limite de sessão ou semanal de uma assinatura do claude.ai enquanto os créditos de uso não estão em uso, e não enquanto `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definida. Quando esta variável não está definida ou seu valor está fora desse intervalo, nenhuma verificação é feita. Requer Claude Code v2.1.305 ou posterior |378| `CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS` | Intervalo mínimo, em milissegundos, entre verificações de se um [limite de uso](https://code.claude.com/docs/pt/errors.md#youve-hit-your-session-limit) já foi suspenso, enquanto uma requisição aguarda a redefinição desse limite com `CLAUDE_CODE_RETRY_WATCHDOG` definida. Quando uma verificação constata que o limite foi suspenso, a requisição é enviada imediatamente. Informe um número inteiro em dígitos simples de `60000`, um minuto, até `10800000`, três horas. As verificações são feitas apenas para o limite de sessão ou semanal de uma assinatura do claude.ai enquanto os créditos de uso não estão em uso, e não enquanto `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` estiver definida. Quando esta variável não está definida ou seu valor está fora desse intervalo, nenhuma verificação é feita. Requer Claude Code v2.1.305 ou posterior |

377| `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`](https://code.claude.com/docs/pt/cli-reference#cli-flags). Processos filhos iniciados diretamente herdam a variável |379| `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, workflows, 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 das 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`](https://code.claude.com/docs/pt/cli-reference#cli-flags). Processos filhos iniciados diretamente herdam a variável |

378| `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 distribuição em tempo de execução via `xargs` ou `find -exec` não é detectada; este é um controle de defesa em profundidade |380| `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, de modo que 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 |

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

380| `CLAUDE_CODE_SEND_FEEDBACK` | Defina como `0` para desativar o [feedback redigido pelo Claude](https://code.claude.com/docs/pt/tools-reference.md#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`](https://code.claude.com/docs/pt/settings-reference#feedbackdrafts), ainda se aplicam |382| `CLAUDE_CODE_SEND_FEEDBACK` | Defina como `0` para desativar o [feedback redigido pelo Claude](https://code.claude.com/docs/pt/tools-reference.md#sendfeedback-tool-behavior) em uma sessão. Defina como `1` para ativá-lo onde sua conta já tem acesso; a variável não pode conceder acesso por si só, e as outras opções que desativam o feedback, como `DISABLE_FEEDBACK_COMMAND` e o valor `off` da configuração [`feedbackDrafts`](https://code.claude.com/docs/pt/settings-reference#feedbackdrafts), ainda se aplicam |

381| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sobrescreve o orçamento de tempo, em milissegundos, para hooks [SessionEnd](https://code.claude.com/docs/pt/hooks.md#sessionend). O valor também é o timeout para 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, automaticamente elevado para o maior `timeout` por hook configurado em arquivos de configurações, até 60 segundos. Timeouts em hooks fornecidos por plugins não elevam o orçamento |383| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sobrescreve o orçamento de tempo em milissegundos para hooks [SessionEnd](https://code.claude.com/docs/pt/hooks.md#sessionend). O valor também é o timeout para cada hook que não define um `timeout` próprio. 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 nos arquivos de configurações, até 60 segundos. Timeouts em hooks fornecidos por plugins não elevam o orçamento |

382| `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](https://code.claude.com/docs/pt/hooks.md) e em subprocessos de [servidores MCP](https://code.claude.com/docs/pt/mcp.md) stdio. Para Bash, PowerShell e hooks, corresponde ao campo `session_id` na entrada JSON do hook e é atualizada no `/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 inicial de inicialização. Use para correlacionar scripts e ferramentas externas com a sessão do Claude Code que os iniciou |384| `CLAUDE_CODE_SESSION_ID` | Definida automaticamente com o ID da sessão atual em subprocessos das ferramentas Bash e PowerShell, subprocessos de [comandos de hook](https://code.claude.com/docs/pt/hooks.md) e subprocessos de [servidores MCP](https://code.claude.com/docs/pt/mcp.md) 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 de inicialização original em vez disso. Use para correlacionar scripts e ferramentas externas com a sessão do Claude Code que os iniciou |

383| `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 compatíveis. 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 |385| `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 compatíveis. Se o valor não for um caminho funcional para `bash` ou `zsh`, o Claude Code o ignora e recorre à detecção automática. A detecção automática usa seu `$SHELL` quando ele aponta para `bash` ou `zsh`; caso contrário, escolhe o primeiro `zsh` e depois `bash` funcional encontrado no seu `PATH` e nos locais de instalação padrão |

384| `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](https://code.claude.com/docs/pt/hooks.md), comandos da [linha de status](https://code.claude.com/docs/pt/statusline.md) e comandos de inicialização de [servidores MCP](https://code.claude.com/docs/pt/mcp.md) stdio. Hooks PowerShell e hooks em formato exec são executados sem o prefixo. Útil para logs ou auditoria. Definir um caminho de executável simples, como `/path/to/logger.sh`, executa cada comando como `/path/to/logger.sh '<command>'`. O wrapper recebe a linha de comando como um único argumento com 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 de shell completa que o Claude Code monta, incluindo a configuração do ambiente, não apenas o comando que o Claude executou |386| `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](https://code.claude.com/docs/pt/hooks.md), comandos de [linha de status](https://code.claude.com/docs/pt/statusline.md) e comandos de inicialização de [servidores MCP](https://code.claude.com/docs/pt/mcp.md) stdio. Hooks do PowerShell e hooks na forma exec são executados sem o prefixo. Útil para registro 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 com 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 o Claude executou |

385| `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`](https://code.claude.com/docs/pt/headless#start-faster-with-bare-mode) |387| `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` continuam sendo 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`](https://code.claude.com/docs/pt/headless#start-faster-with-bare-mode) |

386| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Escolhe entre o system prompt completo do Claude Code e um mais curto com descrições de ferramentas abreviadas. Quando não definida, Haiku 4.5, Sonnet 5, Opus 4.7 e modelos anteriores dessas famílias usam o prompt completo por padrão, e modelos mais novos usam o mais curto. Defina como `1` para usar o prompt mais curto em qualquer modelo. Defina como `0`, `false`, `no` ou `off` para usar o prompt completo em qualquer modelo, mesmo onde um experimento ou a configuração do servidor selecionaria o mais curto. Ambos os prompts mantêm o conjunto completo de ferramentas, hooks, servidores MCP e a descoberta do CLAUDE.md |388| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Escolha entre o system prompt completo do Claude Code e um mais curto, com descrições de ferramentas abreviadas. Quando não definida, Haiku 4.5, Sonnet 5, Opus 4.7 e modelos anteriores dessas famílias usam o prompt completo por padrão, e modelos mais novos usam o mais curto. Defina como `1` para usar o prompt mais curto em qualquer modelo. Defina como `0`, `false`, `no` ou `off` para usar o prompt completo em qualquer modelo, mesmo onde um experimento ou uma configuração do servidor selecionaria o mais curto. Qualquer um dos prompts mantém o conjunto completo de ferramentas, hooks, servidores MCP e a descoberta de CLAUDE.md |

387| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignora a autenticação do lado do cliente para o [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md), para gateways que assinam as requisições por conta própria |389| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Ignora a autenticação no lado do cliente para o [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md), para gateways que assinam as requisições por conta própria |

388| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Defina como `1` para desativar o cache em processo de credenciais resolvidas a partir da cadeia padrão de provedores de credenciais da AWS, para que o Claude Code resolva a cadeia em cada requisição à 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](https://code.claude.com/docs/pt/amazon-bedrock.md#credential-caching-and-resolution-timeout). Requer Claude Code v2.1.207 ou posterior |390| `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](https://code.claude.com/docs/pt/amazon-bedrock.md#credential-caching-and-resolution-timeout). Requer Claude Code v2.1.207 ou posterior |

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

390| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Defina como `1` para tratar uma verificação de disponibilidade do [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) que falhou 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" |392| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Defina como `1` para tratar uma verificação de disponibilidade do [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#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" |

391| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Defina como `1` para ignorar a verificação de disponibilidade do [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#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 |393| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Defina como `1` para ignorar a verificação de disponibilidade do [modo rápido](https://code.claude.com/docs/pt/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) no lado do cliente, para proxies que interceptam a requisição da verificação em vez de recusá-la. A API ainda rejeita requisições no modo rápido quando sua organização tem o modo rápido desativado |

392| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignora 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 |394| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Ignora 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 |

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

394| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | As [verificações de modelo na inicialização](https://code.claude.com/docs/pt/amazon-bedrock.md#startup-model-checks) no [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) e na [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md) memorizam nesta máquina quais modelos elas constataram que sua conta não pode invocar, por até um dia. Defina como `1` para desativar essa memorização. Requer Claude Code v2.1.285 ou posterior |396| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | As [verificações de modelo na inicialização](https://code.claude.com/docs/pt/amazon-bedrock.md#startup-model-checks) no [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md) e na [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md) 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 |

395| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Defina como `1` para não gravar o histórico de prompts e as transcrições de sessões 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 com scripts |397| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Defina como `1` para não gravar o histórico de prompts e as 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 |

396| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignora a autenticação do Google para a Agent Platform do Google Cloud (por exemplo, ao usar um gateway de LLM) |398| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Ignora a autenticação do Google para a Agent Platform do Google Cloud (por exemplo, ao usar um gateway de LLM) |

397| `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](https://code.claude.com/docs/pt/agent-sdk/typescript.md#startup_failure_reason) para falhas de inicialização que, de outra forma, terminariam apenas com o stderr. Requer Claude Code v2.1.274 ou posterior |399| `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](https://code.claude.com/docs/pt/agent-sdk/typescript.md#startup_failure_reason) para falhas de inicialização que, de outra forma, terminariam apenas com stderr. Requer Claude Code v2.1.274 ou posterior |

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

399| `CLAUDE_CODE_SUBAGENT_MODEL` | O modelo padrão para [subagentes](https://code.claude.com/docs/pt/sub-agents.md#choose-a-model), colegas de [equipe de agentes](https://code.claude.com/docs/pt/agent-teams.md#specify-teammates-and-models) e agentes de [workflow](https://code.claude.com/docs/pt/workflows.md) 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 o Claude passa ao criar o agente e um campo `model` na definição do agente, incluindo `inherit`. Para mudar isso, defina [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](https://code.claude.com/docs/pt/sub-agents#run-every-subagent-on-one-model). Consulte [Escolher um modelo](https://code.claude.com/docs/pt/sub-agents.md#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 |401| `CLAUDE_CODE_SUBAGENT_MODEL` | O modelo padrão para [subagentes](https://code.claude.com/docs/pt/sub-agents.md#choose-a-model), colegas de [equipe de agentes](https://code.claude.com/docs/pt/agent-teams.md#specify-teammates-and-models) e agentes de [workflow](https://code.claude.com/docs/pt/workflows.md) 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 o Claude passa quando cria o agente e um campo `model` na definição do agente, incluindo `inherit`. Para mudar isso, defina [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](https://code.claude.com/docs/pt/sub-agents#run-every-subagent-on-one-model). Consulte [Escolher um modelo](https://code.claude.com/docs/pt/sub-agents.md#choose-a-model) para a ordem completa. Defini-la como `inherit` equivale a deixá-la sem definir. Antes da v2.1.251, esta variável sobrescrevia tanto o modelo por invocação quanto o campo `model` da definição |

400| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Defina como `1` para forçar um único modelo em subagentes, colegas de equipe e agentes de workflow. [Executar todos os subagentes em um modelo](https://code.claude.com/docs/pt/sub-agents.md#run-every-subagent-on-one-model) diz qual modelo é esse. Requer Claude Code v2.1.257 ou posterior |402| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Defina como `1` para forçar um único modelo em subagentes, colegas de equipe e agentes de workflow. [Executar todos os subagentes em um modelo](https://code.claude.com/docs/pt/sub-agents.md#run-every-subagent-on-one-model) indica qual modelo é esse. Requer Claude Code v2.1.257 ou posterior |

401| `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](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) para requisições fora da conversa principal, como [subagentes](https://code.claude.com/docs/pt/sub-agents.md), 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 |403| `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](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) para requisições fora da conversa principal, como [subagentes](https://code.claude.com/docs/pt/sub-agents.md), workflows e trabalho em segundo plano. Tem precedência sobre a configuração `subagentPromptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a sobrescreve. A API cobra gravações de cache de 1 hora a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior |

402| `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). O `claude-code-action` define isso automaticamente quando `allowed_non_write_users` está configurado |404| `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 |

403| `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 |405| `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 |

404| `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é a conclusão |406| `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é a conclusão |

405| `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. Requer autenticação no claude.ai. Sessões de terminal em que você entra com sua conta do claude.ai [sincronizam essas skills](https://code.claude.com/docs/pt/skills.md#where-synced-skills-load) sem esta variável, então defina-a apenas quando uma execução com `-p` precisar das suas skills atuais na primeira consulta |407| `CLAUDE_CODE_SYNC_SKILLS` | Defina como `1` no modo não interativo com a flag `-p` para fazer o Claude Code baixar as skills habilitadas para sua conta claude.ai nessa execução e aguardar a lista delas, até `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, antes de executar a primeira consulta. Requer autenticação do claude.ai. Sessões de terminal em que você entra com sua conta claude.ai [sincronizam essas skills](https://code.claude.com/docs/pt/skills.md#where-synced-skills-load) sem esta variável, portanto defina-a apenas quando uma execução `-p` precisar das suas skills atuais na primeira consulta |

406| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout em milissegundos para a ressincronização de skills que ocorre no meio da sessão quando um aplicativo criado com o [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/typescript.md#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 |408| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout em milissegundos para a ressincronização de skills que ocorre no meio da sessão quando um aplicativo criado com o [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/typescript.md#query-object) recarrega skills (padrão: 30000). Quando excedido, o recarregamento continua com as skills que já chegaram, e os downloads restantes terminam em segundo plano |

407| `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. Em ambos os casos, os downloads terminam em segundo plano, e Claude aguarda o download de uma skill quando a invoca |409| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout em milissegundos que a primeira consulta aguarda pela 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 o Claude aguarda o download de uma skill quando a invoca |

408| `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`](https://code.claude.com/docs/pt/settings-reference#syntaxhighlightingdisabled) |410| `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`](https://code.claude.com/docs/pt/settings-reference#syntaxhighlightingdisabled) |

409| `CLAUDE_CODE_TASK_LIST_ID` | Compartilhe 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](https://code.claude.com/docs/pt/tools-reference.md#task-tool-availability). Consulte [Lista de tarefas](https://code.claude.com/docs/pt/interactive-mode.md#task-list) |411| `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](https://code.claude.com/docs/pt/tools-reference.md#task-tool-availability). Consulte [Lista de tarefas](https://code.claude.com/docs/pt/interactive-mode.md#task-list) |

410| `CLAUDE_CODE_TMPDIR` | Sobrescreve o diretório temporário usado para arquivos temporários internos. O Claude Code acrescenta `/claude-{uid}/` a esse caminho no Unix, ou `/claude/` no Windows. Padrão: `/tmp` no macOS, `os.tmpdir()` no Linux e no Windows. No macOS e no Linux, subprocessos Bash em [sandbox](https://code.claude.com/docs/pt/sandboxing.md) recebem um `$TMPDIR` curto de fallback 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 o 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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |412| `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](https://code.claude.com/docs/pt/sandboxing.md) recebem um `$TMPDIR` de fallback curto sob o padrão do sistema quando sua substituição é 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 sua substituição, ou `%TEMP%` quando você não definiu uma. Os próprios arquivos temporários do Claude Code sempre usam sua substituição. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

411| `CLAUDE_CODE_TMUX_TRUECOLOR` | Defina como qualquer valor não vazio, como `1`, para permitir saída truecolor de 24 bits dentro do tmux. **Defini-la como `0` ou `false` ainda permite truecolor**, ao contrário da maioria das variáveis 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 256 cores quando `$TMUX` está definida, porque o tmux não repassa sequências de escape truecolor a menos que esteja configurado para isso. Defina-a depois de adicionar `set -ga terminal-overrides ',*:Tc'` ao seu `~/.tmux.conf`. Consulte [Configuração do terminal](https://code.claude.com/docs/pt/terminal-config.md) para outras configurações do tmux |413| `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 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 256 cores quando `$TMUX` está definida, porque o tmux não repassa sequências de escape truecolor a menos que configurado para isso. Defina-a depois de adicionar `set -ga terminal-overrides ',*:Tc'` ao seu `~/.tmux.conf`. Consulte [Configuração do terminal](https://code.claude.com/docs/pt/terminal-config.md) para outras configurações do tmux |

412| `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](https://code.claude.com/docs/pt/tools-reference.md#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 |414| `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](https://code.claude.com/docs/pt/tools-reference.md#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 |

413| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | No Linux e no WSL, defina como um tamanho, como `4G`, para [limitar a memória que os comandos das ferramentas Bash e PowerShell podem usar](https://code.claude.com/docs/pt/tools-reference.md#memory-limit-on-linux-and-wsl), e os comandos da ferramenta Monitor na v2.1.246 ou posterior. Escreva o tamanho apenas com dígitos, 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 |415| `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](https://code.claude.com/docs/pt/tools-reference.md#memory-limit-on-linux-and-wsl), e os comandos da ferramenta Monitor na v2.1.246 ou posterior. Escreva o tamanho apenas com dígitos, 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 ativou ou desativou o limite, um valor alterado entra em vigor na próxima vez que você iniciar `claude`. Requer Claude Code v2.1.233 ou posterior |

414| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Defina como `1` para limitar o quanto cresce o [arquivo de transcrição](https://code.claude.com/docs/pt/sessions.md#where-transcripts-are-stored) de uma sessão longa com `-p` ou do Agent SDK. Após cada compactação, quando o arquivo tiver mais de 5 MB, o Claude Code remove o histórico anterior a essa compactação. Na v2.1.296 ou posterior, o arquivo permanece como está quando remover esse histórico o reduziria em menos de 10%. 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` das configurações não consegue ativá-la. Requer Claude Code v2.1.287 ou posterior |416| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Defina como `1` para limitar o quanto o [arquivo de transcrição](https://code.claude.com/docs/pt/sessions.md#where-transcripts-are-stored) de uma sessão longa `-p` ou do Agent SDK cresce. Após cada compactação, quando o arquivo tiver mais de 5 MB, o Claude Code remove o histórico anterior a essa compactação. Na v2.1.296 ou posterior, o arquivo permanece como está quando remover esse histórico o reduziria em menos de 10%. 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 consegue ativá-la. Requer Claude Code v2.1.287 ou posterior |

415| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Prazo em milissegundos antes que o Claude Code cancele uma caixa de diálogo que encaminha para um cliente remoto, como um host do [Remote Control](https://code.claude.com/docs/pt/remote-control.md) ou do SDK, ou a caixa de diálogo de aprovação de uma [mensagem entre sessões retida](https://code.claude.com/docs/pt/cross-session-messaging.md#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](https://code.claude.com/docs/pt/model-config.md#fable-and-usage-credits) no meio da sessão em uma sessão que pode estar sendo executada sem supervisão. [Controlar mensagens recebidas](https://code.claude.com/docs/pt/cross-session-messaging.md#control-inbound-messages) e [sessões não interativas](https://code.claude.com/docs/pt/cross-session-messaging.md#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`](https://code.claude.com/docs/pt/settings-reference#dialogexpiry). `0` ou um valor negativo desativa o prazo. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |417| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Prazo em milissegundos antes que o Claude Code cancele uma caixa de diálogo que ele encaminha para um cliente remoto, como um host [Remote Control](https://code.claude.com/docs/pt/remote-control.md) ou SDK, ou a caixa de diálogo de aprovação de uma [mensagem entre sessões retida](https://code.claude.com/docs/pt/cross-session-messaging.md#control-inbound-messages); prompts de permissão e perguntas `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](https://code.claude.com/docs/pt/model-config.md#fable-and-usage-credits) no meio da sessão em uma sessão que possa estar sendo executada sem supervisão. [Controlar mensagens recebidas](https://code.claude.com/docs/pt/cross-session-messaging.md#control-inbound-messages) e [sessões não interativas](https://code.claude.com/docs/pt/cross-session-messaging.md#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`](https://code.claude.com/docs/pt/settings-reference#dialogexpiry). `0` ou um valor negativo desativa o prazo. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

416| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usar o [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md) |418| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usar [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md) |

419| `CLAUDE_CODE_USE_MANTLE` | Usar o [endpoint Mantle](https://code.claude.com/docs/pt/amazon-bedrock.md#use-the-mantle-endpoint) do Amazon Bedrock |421| `CLAUDE_CODE_USE_MANTLE` | Usar o [endpoint Mantle](https://code.claude.com/docs/pt/amazon-bedrock.md#use-the-mantle-endpoint) do Amazon Bedrock |

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

422| `CLAUDE_CODE_WARN_DISK_FREE_GIB` | Defina como um número inteiro de GiB, como `10`, para que o Claude Code avise Claude quando o espaço livre no sistema de arquivos do diretório de trabalho ficar abaixo dessa quantidade. O aviso é um lembrete do sistema informando quanto espaço está livre. O lembrete fica desativado quando a variável não está definida, é `0` ou não contém apenas dígitos. Defina-a no ambiente que inicia o Claude Code, já que o Claude Code ignora uma cópia fornecida por meio de um bloco `env` das configurações. Requer Claude Code v2.1.304 ou posterior |424| `CLAUDE_CODE_WARN_DISK_FREE_GIB` | Defina com um número inteiro de GiB, como `10`, para que o Claude Code avise o Claude quando o espaço livre no sistema de arquivos do diretório de trabalho cair abaixo dessa quantidade. O aviso é um lembrete do sistema informando quanto está livre. O lembrete fica desativado quando a variável não está definida, é `0` ou não contém apenas dígitos. 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.304 ou posterior |

423| `CLAUDE_CODE_WARN_MEMORY_FREE_GIB` | No Linux e no WSL, defina como um número inteiro de GiB, como `4`, para que o Claude Code avise Claude quando a memória do sistema disponível ficar abaixo dessa quantidade. O aviso é um lembrete do sistema informando quanto está disponível. O lembrete fica desativado quando a variável não está definida, é `0` ou não contém apenas dígitos. Defina-a no ambiente que inicia o Claude Code, já que o Claude Code ignora uma cópia fornecida por meio de um bloco `env` das configurações. Requer Claude Code v2.1.304 ou posterior |425| `CLAUDE_CODE_WARN_MEMORY_FREE_GIB` | No Linux e no WSL, defina com um número inteiro de GiB, como `4`, para que o Claude Code avise o Claude quando a memória RAM disponível cair abaixo dessa quantidade. O aviso é um lembrete do sistema informando quanto está disponível. O lembrete fica desativado quando a variável não está definida, é `0` ou não contém apenas dígitos. 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.304 ou posterior |

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

425| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superior em milissegundos para quanto tempo o [WebFetch](https://code.claude.com/docs/pt/tools-reference.md#webfetch-tool-behavior) aguarda o download de uma página, incluindo os 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`, ou seja, cinco minutos. Defina como `0` para remover o limite. Aceita apenas dígitos; um decimal ou qualquer outra grafia mantém o padrão. Requer Claude Code v2.1.268 ou posterior |427| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superior em milissegundos de quanto tempo o [WebFetch](https://code.claude.com/docs/pt/tools-reference.md#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; um decimal ou qualquer outra grafia mantém o padrão. Requer Claude Code v2.1.268 ou posterior |

426| `CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR` | Taxa com que o [limite de WebSearch](https://code.claude.com/docs/pt/tools-reference.md#session-search-limit) de uma sessão é reabastecido, em chamadas por hora. O padrão é `100` em uma sessão interativa no terminal. Em uma sessão [não interativa](https://code.claude.com/docs/pt/headless.md), o padrão é `0`, o que desativa o reabastecimento. Aceita apenas dígitos; qualquer outra grafia é lida como não definida. Requer Claude Code v2.1.290 ou posterior |428| `CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR` | Taxa na qual o [limite de WebSearch](https://code.claude.com/docs/pt/tools-reference.md#session-search-limit) de uma sessão é reabastecido, em chamadas por hora. O padrão é `100` em uma sessão de terminal interativa. Em uma sessão [não interativa](https://code.claude.com/docs/pt/headless.md), o padrão é `0`, o que desativa o reabastecimento. Aceita apenas dígitos; qualquer outra grafia é lida como não definida. Requer Claude Code v2.1.290 ou posterior |

427| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` está definida como `1`, quanto tempo o Claude Code aguarda antes de cada lembrete para que Claude verifique os [subagentes em segundo plano](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) que ainda estão em execução. Aceita uma ou mais esperas separadas por vírgulas, 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; qualquer outro valor ou grafia é lido como não definido. Quando não definida, não há lembretes. Requer Claude Code v2.1.283 ou posterior |429| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` está definida como `1`, quanto tempo o Claude Code aguarda antes de cada lembrete ao Claude para verificar [subagentes em segundo plano](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) que ainda estão em execução. Aceita uma ou mais esperas separadas por vírgulas 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; qualquer outro valor ou grafia é lido como não definido. Quando não definida, não há lembretes. Requer Claude Code v2.1.283 ou posterior |

428| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Quantos agentes uma única execução de [workflow](https://code.claude.com/docs/pt/workflows.md) executa ao mesmo tempo, de `1` a `256`. Por padrão, uma execução executa até 16 agentes ao mesmo tempo, menos quando o Claude Code tem menos CPUs disponíveis; chamadas `agent()` enfileiradas aguardam um slot livre. A transcrição de cada agente em execução permanece na memória do Claude Code, portanto valores mais altos aumentam o uso de memória. Aceita apenas dígitos; valores fora do intervalo e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior |430| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Quantos agentes uma única execução de [workflow](https://code.claude.com/docs/pt/workflows.md) 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 uma vaga livre. A transcrição de cada agente em execução permanece na memória do Claude Code, portanto valores mais altos aumentam o uso de memória. Aceita apenas dígitos; valores fora do intervalo e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior |

429| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superior em milissegundos para quanto tempo um agente de [workflow](https://code.claude.com/docs/pt/workflows.md) aguarda o início da primeira resposta de um agente irmão com o mesmo prefixo 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](https://code.claude.com/docs/pt/workflows.md#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á definida, os agentes nunca aguardam. Requer Claude Code v2.1.229 ou posterior |431| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superior em milissegundos de quanto tempo um agente de [workflow](https://code.claude.com/docs/pt/workflows.md) aguarda o início da primeira resposta de um agente irmão com o mesmo prefixo 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](https://code.claude.com/docs/pt/workflows.md#prompt-caching-in-a-fan-out), o Claude Code retém todos os agentes, exceto o primeiro, por até esse tempo para que os demais leiam o prefixo em cache em vez de cada um processá-lo sem cache. Padrão `5000`. Defina como `0` para desativar a espera. Quando `DISABLE_PROMPT_CACHING` está definida, os agentes nunca aguardam. Requer Claude Code v2.1.229 ou posterior |

430| `CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG` | Defina como `1` para mostrar, acima do prompt, uma linha para cada uma das últimas três verificações que o [mod You should know](https://code.claude.com/docs/pt/interactive-mode.md#you-should-know-suggestions) fez nesta sessão. Use-a para confirmar que o mod está verificando quando nenhuma nota aparece. Requer Claude Code v2.1.287 ou posterior |432| `CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG` | Defina como `1` para mostrar, acima do prompt, uma linha para cada uma das três últimas verificações que o [mod You should know](https://code.claude.com/docs/pt/interactive-mode.md#you-should-know-suggestions) fez nesta sessão. Use-a para confirmar que o mod está verificando quando nenhuma nota aparece. Requer Claude Code v2.1.287 ou posterior |

431| `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 sob esse caminho. Para credenciais, consulte [onde o Claude Code armazena credenciais](https://code.claude.com/docs/pt/authentication.md#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. Em um arquivo de configurações, escreva o [caminho absoluto](#in-settings-files). Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |433| `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 sob este caminho. Para credenciais, consulte [onde o Claude Code armazena credenciais](https://code.claude.com/docs/pt/authentication.md#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. Em um arquivo de configurações, escreva o [caminho absoluto](#in-settings-files). Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

432| `CLAUDE_EFFORT` | Definida automaticamente em subprocessos da ferramenta Bash e em comandos de hook com o valor da configuração de [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) quando o subprocesso é iniciado: `low`, `medium`, `high`, `xhigh` ou `max`. Corresponde ao campo `effort.level` passado aos [hooks](https://code.claude.com/docs/pt/hooks.md). Definida somente quando o modelo atual oferece suporte ao parâmetro effort |434| `CLAUDE_EFFORT` | Definida automaticamente em subprocessos da ferramenta Bash e em comandos de hook com a configuração de [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) no momento em que o subprocesso inicia: `low`, `medium`, `high`, `xhigh` ou `max`. Corresponde ao campo `effort.level` passado aos [hooks](https://code.claude.com/docs/pt/hooks.md). Definida apenas quando o modelo atual oferece suporte ao parâmetro effort |

433| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Defina como `1` para forçar a ativação do watchdog de inatividade de streaming em nível de bytes, ou como `0` para forçar sua desativação. `0` também desativa o [prazo do primeiro byte](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) nas conexões em que esse prazo é aplicado. Quando não definida, o watchdog fica ativado por padrão para conexões diretas com a API da Anthropic e com o [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md), e para respostas por streaming em conexões de [gateway](https://code.claude.com/docs/pt/gateways.md) 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 eventos podia relatar uma parada ali mesmo enquanto pings de keep-alive estavam chegando. Para timeouts e como os temporizadores interagem, consulte [Watchdogs de inatividade de streaming](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) |435| `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](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) nas conexões em que esse prazo é aplicado. Quando não definida, o watchdog fica ativado por padrão para conexões diretas com a API da Anthropic e com o [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md), e para respostas de streaming em conexões de [gateway](https://code.claude.com/docs/pt/gateways.md) 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, de modo que 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](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) |

434| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Defina como `1` para ativar o watchdog de inatividade de streaming em nível de bytes nas respostas `vnd.amazon.eventstream` do Amazon Bedrock, o que também ativa o [prazo do primeiro byte](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) nas requisições de streaming do Bedrock. Desativado por padrão. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |436| `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](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) nas requisições de streaming do Bedrock. Desativado por padrão. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

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

436| `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 os exports do arquivo fiquem visíveis para o comando. Use-a para manter a ativação de virtualenv ou conda entre comandos. Comandos PowerShell também recebem suas variáveis, na v2.1.296 ou posterior, nas condições descritas em [Variáveis persistidas em comandos PowerShell](https://code.claude.com/docs/pt/hooks.md#persisted-variables-in-powershell-commands). Também preenchida dinamicamente pelos hooks [SessionStart](https://code.claude.com/docs/pt/hooks.md#persist-environment-variables), [Setup](https://code.claude.com/docs/pt/hooks.md#setup), [CwdChanged](https://code.claude.com/docs/pt/hooks.md#cwdchanged) e [FileChanged](https://code.claude.com/docs/pt/hooks.md#filechanged) |438| `CLAUDE_ENV_FILE` | Caminho para um script de shell cujo conteúdo o Claude Code executa antes de cada comando Bash no mesmo processo de shell, de modo que as exportações no arquivo ficam visíveis para o comando. Use para manter a ativação de virtualenv ou conda entre comandos. Comandos PowerShell também recebem suas variáveis, na v2.1.296 ou posterior, nas condições descritas em [Variáveis persistidas em comandos PowerShell](https://code.claude.com/docs/pt/hooks.md#persisted-variables-in-powershell-commands). Também preenchido dinamicamente pelos hooks [SessionStart](https://code.claude.com/docs/pt/hooks.md#persist-environment-variables), [Setup](https://code.claude.com/docs/pt/hooks.md#setup), [CwdChanged](https://code.claude.com/docs/pt/hooks.md#cwdchanged) e [FileChanged](https://code.claude.com/docs/pt/hooks.md#filechanged) |

437| `CLAUDE_JOB_DIR` | Definida pelo Claude Code em cada [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) como o diretório `~/.claude/jobs/<id>` dessa sessão. Os comandos de shell executados pela sessão a herdam. Grave arquivos temporários de trabalho em [`$CLAUDE_JOB_DIR/tmp`](https://code.claude.com/docs/pt/agent-view#where-state-is-stored). As chamadas `Write` e `Edit` de Claude nesse local não pedem permissão, e o diretório é removido quando a sessão é excluída |439| `CLAUDE_JOB_DIR` | Definida pelo Claude Code em cada [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) 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`](https://code.claude.com/docs/pt/agent-view#where-state-is-stored). As chamadas `Write` e `Edit` do Claude nesse local não pedem permissão, e o diretório é removido quando a sessão é excluída |

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

439| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefixo para nomes de sessão do [Remote Control](https://code.claude.com/docs/pt/remote-control.md) 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 |441| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefixo para nomes de sessão do [Remote Control](https://code.claude.com/docs/pt/remote-control.md) gerados automaticamente quando nenhum nome explícito é fornecido. O padrão é o nome de host 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 |

440| `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](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) é aplicado. 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](https://code.claude.com/docs/pt/errors.md#no-response-from-api). Requer Claude Code v2.1.242 ou posterior |442| `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](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) é aplicado. 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 isto sem definir, consulte [Sem resposta da API](https://code.claude.com/docs/pt/errors.md#no-response-from-api). Requer Claude Code v2.1.242 ou posterior |

441| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout em milissegundos antes que os watchdogs de inatividade de streaming em nível de eventos e de bytes fechem uma conexão parada. 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 o buffering de proxies, e o watchdog em nível de bytes 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 bytes. Para os padrões de cada watchdog quando não definida, consulte [Watchdogs de inatividade de streaming](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) |443| `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 silenciosamente ajustados 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 sem definição de cada watchdog, consulte [Watchdogs de inatividade de streaming](https://code.claude.com/docs/pt/network-config.md#streaming-idle-watchdogs) |

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

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

444| `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 |446| `DISABLE_AUTOUPDATER` | Defina como `1` para desativar atualizações automáticas em segundo plano. O `claude update` manual continua funcionando. Use `DISABLE_UPDATES` para bloquear ambos |

445| `DISABLE_AUTO_COMPACT` | Defina como `1` para desativar a compactação automática ao se aproximar do limite de contexto, junto com a [compactação por inatividade](https://code.claude.com/docs/pt/settings-reference.md#idlecompaction). O comando manual `/compact` continua disponível. Use quando quiser controle explícito sobre quando a compactação ocorre. Sobrescreve a configuração [`autoCompactEnabled`](https://code.claude.com/docs/pt/settings-reference#autocompactenabled) |447| `DISABLE_AUTO_COMPACT` | Defina como `1` para desativar a compactação automática ao se aproximar do limite de contexto, junto com a [compactação por inatividade](https://code.claude.com/docs/pt/settings-reference.md#idlecompaction). O comando manual `/compact` continua disponível. Use quando quiser controle explícito sobre quando a compactação ocorre. Sobrescreve a configuração [`autoCompactEnabled`](https://code.claude.com/docs/pt/settings-reference#autocompactenabled) |

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

448| `DISABLE_DOCTOR_COMMAND` | Defina como `1` para ocultar a skill de verificação de configuração [`/doctor`](https://code.claude.com/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 de tela de diagnóstico `/doctor` |450| `DISABLE_DOCTOR_COMMAND` | Defina como `1` para ocultar a skill de verificação de configuração [`/doctor`](https://code.claude.com/docs/pt/commands#all-commands) e seu alias `/checkup`. Útil em 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` |

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

450| `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 |452| `DISABLE_EXTRA_USAGE_COMMAND` | Defina como `1` para ocultar o comando `/usage-credits` que permite aos usuários comprar uso adicional além dos rate limits |

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

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

453| `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 em instalações padrão |455| `DISABLE_INSTALLATION_CHECKS` | Defina como `1` para desativar avisos de instalação. Use apenas ao gerenciar manualmente o local de instalação, pois isso pode mascarar problemas com instalações padrão |

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

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

456| `DISABLE_LOGIN_COMMAND` | Defina como `1` para ocultar o comando `/login`. Útil quando a autenticação é feita externamente por meio de chaves de API ou `apiKeyHelper` |458| `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` |

458| `DISABLE_PROMPT_CACHING` | Defina como `1` para desativar o [cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#disable-prompt-caching) para todos os modelos (tem precedência sobre as configurações por modelo) |460| `DISABLE_PROMPT_CACHING` | Defina como `1` para desativar o [cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#disable-prompt-caching) para todos os modelos (tem precedência sobre as configurações por modelo) |

460| `DISABLE_PROMPT_CACHING_HAIKU` | Defina como `1` para desativar o cache de prompt para o [modelo Haiku padrão](https://code.claude.com/docs/pt/prompt-caching.md#disable-prompt-caching), onde quer que ele seja executado |462| `DISABLE_PROMPT_CACHING_HAIKU` | Defina como `1` para desativar o cache de prompt para o [modelo Haiku padrão](https://code.claude.com/docs/pt/prompt-caching.md#disable-prompt-caching), onde quer que ele seja executado |

461| `DISABLE_PROMPT_CACHING_OPUS` | Defina como `1` para desativar o cache de prompt para o [modelo Opus padrão](https://code.claude.com/docs/pt/prompt-caching.md#disable-prompt-caching) |463| `DISABLE_PROMPT_CACHING_OPUS` | Defina como `1` para desativar o cache de prompt para o [modelo Opus padrão](https://code.claude.com/docs/pt/prompt-caching.md#disable-prompt-caching) |

462| `DISABLE_PROMPT_CACHING_SONNET` | Defina como `1` para desativar o cache de prompt para o [modelo Sonnet padrão](https://code.claude.com/docs/pt/prompt-caching.md#disable-prompt-caching) |464| `DISABLE_PROMPT_CACHING_SONNET` | Defina como `1` para desativar o cache de prompt para o [modelo Sonnet padrão](https://code.claude.com/docs/pt/prompt-caching.md#disable-prompt-caching) |

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

464| `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 |466| `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 |

466| `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, portanto `0` mantém a telemetria ativada, e a respeita como a convenção entre ferramentas reconhecida por muitas CLIs de desenvolvimento |468| `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, portanto `0` mantém a telemetria ativada, e a respeita como a convenção entre ferramentas reconhecida por muitas CLIs de desenvolvedores |

467| `ENABLE_BETA_TRACING_DETAILED` | Defina como `1`, e defina `BETA_TRACING_ENDPOINT` como o endpoint do seu coletor OTLP/HTTP, para ativar o [tracing beta detalhado](https://code.claude.com/docs/pt/monitoring-usage.md#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 a 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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |469| `ENABLE_BETA_TRACING_DETAILED` | Defina como `1`, e defina `BETA_TRACING_ENDPOINT` como o endpoint do seu coletor OTLP/HTTP, para ativar o [rastreamento beta detalhado](https://code.claude.com/docs/pt/monitoring-usage.md#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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

468| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para impedir que o Claude Code busque os [servidores MCP do claude.ai](https://code.claude.com/docs/pt/mcp.md#use-mcp-servers-from-claude-ai). Ativada por padrão para usuários conectados. Para desativar por projeto ou por organização, defina [`disableClaudeAiConnectors`](https://code.claude.com/docs/pt/settings-reference#disableclaudeaiconnectors) nas configurações |470| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para impedir que o Claude Code busque [servidores MCP do claude.ai](https://code.claude.com/docs/pt/mcp.md#use-mcp-servers-from-claude-ai). Habilitada por padrão para usuários conectados. Para desativar por projeto ou por organização, defina [`disableClaudeAiConnectors`](https://code.claude.com/docs/pt/settings-reference#disableclaudeaiconnectors) nas configurações |

469| `ENABLE_PROMPT_CACHING_1H` | Defina como `1` para solicitar um [TTL de cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) de 1 hora em vez do padrão de 5 minutos. Destinada a usuários de chave de API, do [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), do [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md), do [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md) e do [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md). Para usuários de assinatura dentro do uso incluído, o Claude Code solicita o TTL de 1 hora automaticamente na [conversa principal](https://code.claude.com/docs/pt/prompt-caching.md#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 separadamente para a conversa principal e para as requisições fora dela, use `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que têm precedência sobre esta variável |471| `ENABLE_PROMPT_CACHING_1H` | Defina como `1` para solicitar um [TTL de cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) de 1 hora em vez dos 5 minutos padrão. Destinada a usuários de chave de API, [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/pt/google-vertex-ai.md), [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md) e [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md). Para usuários de assinatura dentro do uso incluído, o Claude Code solicita o TTL de 1 hora automaticamente na [conversa principal](https://code.claude.com/docs/pt/prompt-caching.md#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 separadamente para a conversa principal e para requisições fora dela, use `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que têm precedência sobre esta variável |

470| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuada. Use `ENABLE_PROMPT_CACHING_1H` em vez dela. Não tem efeito em sessões do [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway), mesmo quando o gateway roteia para o Amazon Bedrock |472| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuada. Use `ENABLE_PROMPT_CACHING_1H` em vez disso. Não tem efeito em sessões do [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway), mesmo quando o gateway roteia para o Amazon Bedrock |

471| `ENABLE_TOOL_SEARCH` | Controla o [MCP Tool Search](https://code.claude.com/docs/pt/mcp.md#scale-with-mcp-tool-search). Não definida ou `true` adia as ferramentas MCP, exceto nos [casos que mantêm a busca de ferramentas desativada](https://code.claude.com/docs/pt/mcp.md#configure-tool-search). `auto` ativa a busca de ferramentas quando as definições atingem 10% da janela de contexto. `auto:N` define um limite personalizado, como `auto:5` para 5%. `false` carrega todas as ferramentas antecipadamente. Se um gateway rejeitar a busca de ferramentas, consulte [Busca de ferramentas por meio de um gateway de LLM](https://code.claude.com/docs/pt/mcp.md#tool-search-through-a-gateway) |473| `ENABLE_TOOL_SEARCH` | Controla o [MCP Tool Search](https://code.claude.com/docs/pt/mcp.md#scale-with-mcp-tool-search). Sem definição ou `true` adia as ferramentas MCP, exceto nos [casos que mantêm a busca de ferramentas desativada](https://code.claude.com/docs/pt/mcp.md#configure-tool-search). `auto` ativa a busca de ferramentas quando as definições atingem 10% da janela de contexto. `auto:N` define um limite personalizado, como `auto:5` para 5%. `false` carrega todas as ferramentas antecipadamente. Se um gateway rejeitar a busca de ferramentas, consulte [Busca de ferramentas através de um gateway de LLM](https://code.claude.com/docs/pt/mcp.md#tool-search-through-a-gateway) |

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

473| `FORCE_HYPERLINK` | Defina como `1` para ativar hyperlinks OSC 8 clicáveis quando seu terminal oferece suporte a eles, mas não é detectado automaticamente. Quando não definida, o Claude Code ativa a maioria dos hyperlinks apenas quando detecta suporte no terminal. O [badge de PR ou merge request](https://code.claude.com/docs/pt/interactive-mode.md#pr-review-status) no rodapé e as URLs longas de login são links de qualquer forma. Defina `0`, `false`, `no` ou `off` para renderizar todos eles como texto simples. Antes da v2.1.314, `false`, `no` e `off` ativavam os hyperlinks |475| `FORCE_HYPERLINK` | Defina como `1` para ativar hiperlinks OSC 8 clicáveis quando seu terminal oferece suporte a eles, mas não é detectado automaticamente. Quando não definida, o Claude Code ativa a maioria dos hiperlinks apenas quando detecta suporte do terminal. O [selo de PR ou merge request](https://code.claude.com/docs/pt/interactive-mode.md#pr-review-status) no rodapé e as URLs longas de login são links de qualquer forma. Defina `0`, `false`, `no` ou `off` para renderizar todos eles como texto simples. Antes da v2.1.314, `false`, `no` e `off` ativavam os hiperlinks |

474| `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` |476| `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` |

477| `IS_DEMO` | Defina como 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 transmitir ou gravar uma sessão |479| `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 a integração inicial. **Defini-la como `0` ou `false` ainda ativa o modo de demonstração**, diferentemente da maioria das variáveis liga/desliga; remova a definição da variável para desativá-lo. Útil ao transmitir ou gravar uma sessão |

478| `MAX_MCP_OUTPUT_TOKENS` | Número máximo de tokens permitidos nas respostas de ferramentas MCP (padrão: 25000). O Claude Code exibe um aviso quando a saída excede 10.000 tokens. Ferramentas que declaram [`anthropic/maxResultSizeChars`](https://code.claude.com/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 continua sujeito a esta variável. Um resultado de texto bem-sucedido com mais de 50.000 caracteres de uma ferramenta sem essa anotação é [salvo em um arquivo](https://code.claude.com/docs/pt/mcp.md#mcp-output-limits-and-warnings) independentemente desta variável |480| `MAX_MCP_OUTPUT_TOKENS` | Número máximo de tokens permitidos em respostas de ferramentas MCP (padrão: 25000). O Claude Code exibe um aviso quando a saída excede 10.000 tokens. Ferramentas que declaram [`anthropic/maxResultSizeChars`](https://code.claude.com/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 continua sujeito a esta variável. Um resultado de texto bem-sucedido com mais de 50.000 caracteres de uma ferramenta sem essa anotação é [salvo em um arquivo](https://code.claude.com/docs/pt/mcp.md#mcp-output-limits-and-warnings) independentemente desta variável |

479| `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`](https://code.claude.com/docs/pt/cli-reference#cli-flags) no modo não interativo com a flag `-p`; após esse número de tentativas malsucedidas sem saída válida, a execução falha. O mesmo limite se aplica quando a saída estruturada de um subagente de [workflow](https://code.claude.com/docs/pt/workflows.md) falha na validação. O padrão é 5, uma primeira tentativa mais quatro novas tentativas |481| `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`](https://code.claude.com/docs/pt/cli-reference#cli-flags) no modo não interativo com a flag `-p`; após essa quantidade de tentativas malsucedidas sem saída válida, a execução falha. O mesmo limite se aplica quando a saída estruturada de um subagente de [workflow](https://code.claude.com/docs/pt/workflows.md) falha na validação. O padrão é 5, uma primeira tentativa mais quatro novas tentativas |

480| `MAX_THINKING_TOKENS` | Orçamento fixo de tokens para o [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). O Claude Code o limita a um token abaixo do máximo de tokens de saída da requisição e nunca abaixo de 1.024. Consulte `CLAUDE_CODE_MAX_OUTPUT_TOKENS` para saber como esse limite é definido. Quando não definida e o pensamento está ativado, os modelos com [raciocínio adaptativo](https://code.claude.com/docs/pt/model-config.md#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, no Haiku 5.5 e nos modelos Fable, que não podem ter o pensamento desativado. Em [provedores de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md), `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](https://code.claude.com/docs/pt/errors.md#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 |482| `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](https://code.claude.com/docs/pt/model-config.md#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, Sonnet 5.5, Haiku 5.5 e nos modelos Fable, que não podem ter o pensamento desativado. Em [provedores de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md), `0` omite o parâmetro `thinking`. Com o pensamento desativado na API da Anthropic, o Claude Code envia effort `high` em vez de um nível mais alto para modelos que ele sabe que [não aceitam essa combinação](https://code.claude.com/docs/pt/errors.md#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 de raciocínio adaptativo, exceto quando `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` desativa o raciocínio adaptativo |

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

482| `MCP_CONNECTION_NONBLOCKING` | Controla se a inicialização aguarda a conexão dos servidores MCP 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 aguardar a conexão dos servidores antes da primeira consulta. Servidores configurados com [`alwaysLoad: true`](https://code.claude.com/docs/pt/mcp#exempt-a-server-from-deferral) ainda fazem a inicialização aguardar de qualquer forma, exceto quando servidos a partir do [cache de descoberta](https://code.claude.com/docs/pt/mcp.md#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 aguarda os servidores ainda pendentes antes do primeiro turno, independentemente desta variável. Quando você passa [`--mcp-config`](https://code.claude.com/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 |484| `MCP_CONNECTION_NONBLOCKING` | Controla se a inicialização aguarda a conexão dos servidores MCP 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 aguardar a conexão dos servidores antes da primeira consulta. Servidores configurados com [`alwaysLoad: true`](https://code.claude.com/docs/pt/mcp#exempt-a-server-from-deferral) ainda fazem a inicialização aguardar de qualquer forma, exceto quando servidos a partir do [cache de descoberta](https://code.claude.com/docs/pt/mcp.md#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 aguarda os servidores ainda pendentes antes do primeiro turno, independentemente desta variável. Quando você passa [`--mcp-config`](https://code.claude.com/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 |

483| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo a inicialização bloqueante do MCP aguarda, em milissegundos, o 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`](https://code.claude.com/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 |485| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo a inicialização bloqueante do MCP aguarda, 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`](https://code.claude.com/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 |

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

485| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Idade máxima, em segundos, de uma entrada do [cache de descoberta](https://code.claude.com/docs/pt/mcp.md#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 |487| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Idade máxima, em segundos, de uma entrada do [cache de descoberta](https://code.claude.com/docs/pt/mcp.md#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 |

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

487| `MCP_DISCOVERY_CACHE_TTL_S` | Segundos durante os quais o Claude Code usa uma entrada do [cache de descoberta](https://code.claude.com/docs/pt/mcp.md#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 é 4 horas por padrão. Antes da v2.1.238, o Claude Code não limitava o valor |489| `MCP_DISCOVERY_CACHE_TTL_S` | Segundos durante os quais o Claude Code usa uma entrada do [cache de descoberta](https://code.claude.com/docs/pt/mcp.md#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 é 4 horas por padrão. Antes da v2.1.238, o Claude Code não limitava o valor |

488| `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](https://code.claude.com/docs/pt/mcp.md#use-pre-configured-oauth-credentials) |490| `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](https://code.claude.com/docs/pt/mcp.md#use-pre-configured-oauth-credentials) |

489| `MCP_PROTOCOL_NEGOTIATION` | Apenas no [runtime de cliente MCP v2](https://code.claude.com/docs/pt/mcp.md#mcp-client-runtimes), controla se o Claude Code sonda os servidores em busca da revisão 2026-07-28 do protocolo MCP. Defina `legacy` para pular a sondagem, de modo que todos os servidores se conectem com o handshake anterior a essa revisão. Defina `auto` para sondar os tipos de servidor que oferecem suporte à sondagem: servidores HTTP e stdio, conectores do claude.ai e os conectores de sessões na nuvem e do Remote Control. Com a variável não definida, o Claude Code sonda esses mesmos tipos por padrão; consulte [Runtimes de cliente MCP](https://code.claude.com/docs/pt/mcp.md#mcp-client-runtimes). Qualquer outro valor é ignorado com um aviso no log de depuração. Requer Claude Code v2.1.221 ou posterior |491| `MCP_PROTOCOL_NEGOTIATION` | Somente no [runtime de cliente MCP v2](https://code.claude.com/docs/pt/mcp.md#mcp-client-runtimes), controla se o Claude Code sonda os servidores quanto à revisão 2026-07-28 do protocolo MCP. Defina `legacy` para manter todos os servidores no handshake anterior, ou `auto` para sondar os tipos de servidor que oferecem suporte a ela. Sem definição, o Claude Code os sonda, mas pode [pular alguns servidores](https://code.claude.com/docs/pt/mcp.md#mcp-client-runtimes). Qualquer outro valor é ignorado com um aviso no log de depuração. Requer Claude Code v2.1.221 ou posterior |

490| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP remotos (HTTP/SSE) a serem conectados em paralelo durante a inicialização (padrão: 20) |492| `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) |

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

492| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP locais (stdio) a serem conectados em paralelo durante a inicialização (padrão: 3) |494| `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) |

494| `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 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 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 disso; 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 |496| `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 isto 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 aborta 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 |

496| `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 entre este valor 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](https://code.claude.com/docs/pt/monitoring-usage.md#common-configuration-variables) |498| `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](https://code.claude.com/docs/pt/monitoring-usage.md#common-configuration-variables) |

497| `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` 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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.193 ou posterior. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md#assistant-response-event) |499| `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 ocultas 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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Requer Claude Code v2.1.193 ou posterior. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md#assistant-response-event) |

498| `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 [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md#managed-settings-resolved-event) |500| `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 [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md#managed-settings-resolved-event) |

499| `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 os corpos não truncados em disco e emitir um caminho `body_ref` em seu lugar. `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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md#api-request-body-event) |501| `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 no 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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md#api-request-body-event) |

500| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir o conteúdo das ferramentas no evento de span `tool.output` do OpenTelemetry. Os atributos de span carregam o conteúdo das ferramentas sob [seus próprios controles](https://code.claude.com/docs/pt/monitoring-usage.md#new-context-gates). Requer [tracing](https://code.claude.com/docs/pt/monitoring-usage.md#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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env), exceto pelos valores de desativação descritos nessa seção. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md#tool-output-span-event) |502| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir o conteúdo das ferramentas no evento de span `tool.output` do OpenTelemetry. Os atributos de span carregam o conteúdo das ferramentas sob [seus próprios controles](https://code.claude.com/docs/pt/monitoring-usage.md#new-context-gates). Requer [rastreamento](https://code.claude.com/docs/pt/monitoring-usage.md#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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md#tool-output-span-event) |

501| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada das ferramentas; nomes de servidores MCP; nomes de fluxos de trabalho 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](https://code.claude.com/docs/pt/monitoring-usage.md#cost-counter); e outros detalhes das ferramentas nas 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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env), exceto pelos valores de desativação descritos nessa seção. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |503| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada das 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](https://code.claude.com/docs/pt/monitoring-usage.md#cost-counter); e outros detalhes das 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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |

502| `OTEL_LOG_USER_PROMPTS` | Defina como `1` para incluir o texto dos prompts do usuário nos 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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env), exceto pelos valores de desativação descritos nessa seção. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |504| `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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env), exceto pelos valores de desativação que essa seção descreve. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |

503| `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](https://code.claude.com/docs/pt/monitoring-usage.md) |505| `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](https://code.claude.com/docs/pt/monitoring-usage.md) |

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

505| `OTEL_METRICS_INCLUDE_REPOSITORY` | Defina como `true` para marcar as 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](https://code.claude.com/docs/pt/monitoring-usage.md#repository-attributes) |507| `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](https://code.claude.com/docs/pt/monitoring-usage.md#repository-attributes) |

506| `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 das métricas. Defina como `false` para excluí-las (padrão: incluídas). Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md#multi-team-organization-support) |508| `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](https://code.claude.com/docs/pt/monitoring-usage.md#multi-team-organization-support) |

507| `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](https://code.claude.com/docs/pt/monitoring-usage.md) |509| `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](https://code.claude.com/docs/pt/monitoring-usage.md) |

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

509| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sobrescreve o orçamento de caracteres para os metadados de skills mostrados à [ferramenta Skill](https://code.claude.com/docs/pt/skills.md#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 |511| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sobrescreve o orçamento de caracteres para os metadados de skills mostrados à [ferramenta Skill](https://code.claude.com/docs/pt/skills.md#control-who-invokes-a-skill). O orçamento se ajusta dinamicamente a 1% da janela de contexto, com um fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores |

510| `TASK_MAX_OUTPUT_LENGTH` | Removida na v2.1.277 e agora sem efeito, junto com a ferramenta `TaskOutput` cujo tamanho ela definia. Anteriormente definia o número máximo de caracteres da saída de uma [tarefa em segundo plano](https://code.claude.com/docs/pt/tools-reference.md#background-commands) que a ferramenta `TaskOutput` mantinha. Claude agora lê o arquivo de saída de uma tarefa em segundo plano com `Read` |512| `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](https://code.claude.com/docs/pt/tools-reference.md#background-commands) que a ferramenta `TaskOutput` mantinha. Agora o Claude lê o arquivo de saída de uma tarefa em segundo plano com `Read` |

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

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

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

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

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

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

531| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Sobrescreve a região do Claude Haiku 5.5 ao usar o Agent Platform do Google Cloud. Adicionada na v2.1.293 |533| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Sobrescreve a região do Claude Haiku 5.5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.293 |

~~532~~ 534

533As 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](https://code.claude.com/docs/pt/monitoring-usage.md) para detalhes de configuração.535As 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 compatíveis. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) para detalhes de configuração.

~~534~~ 536

535Defina `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](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env), exceto pelos valores de desativação descritos nessa seção. `OTEL_RESOURCE_ATTRIBUTES` e as variáveis de intervalo de exportação, timeout e compressão, como `OTEL_METRIC_EXPORT_INTERVAL`, continuam se aplicando a partir das configurações de projeto e locais.537Defina `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](https://code.claude.com/docs/pt/settings-reference.md#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.

536 538

537## O que a limpeza do ambiente de subprocessos remove539## O que a limpeza do ambiente de subprocessos remove

538 540

errors.md +25 −15

Details

61| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |61| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |

62| `Invalid API key` | [Authentication](#invalid-api-key) |62| `Invalid API key` | [Authentication](#invalid-api-key) |

63| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |63| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |

~~64| `Claude Code didn't send your claude.ai login, because the API key helper your administrator set isn't in effect` | [Autenticação](#claude-code-didnt-send-your-claude-ai-login) |~~64| `Your organization's settings need an update` | [Autenticação](#claude-code-didnt-send-your-claude-ai-login) |

65| `Couldn't load your organization's settings. Check your connection` | [Autenticação](#claude-code-didnt-send-your-claude-ai-login) |

66| `Restart Claude Code to finish signing in` | [Autenticação](#claude-code-didnt-send-your-claude-ai-login) |

65| `Invalid auth token · Fix external auth token` | [Authentication](#invalid-request-header-value) |67| `Invalid auth token · Fix external auth token` | [Authentication](#invalid-request-header-value) |

66| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [Authentication](#invalid-request-header-value) |68| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [Authentication](#invalid-request-header-value) |

67| `Invalid request header from the environment · Fix the environment variable` | [Authentication](#invalid-request-header-value) |69| `Invalid request header from the environment · Fix the environment variable` | [Authentication](#invalid-request-header-value) |

1117 1119

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

1119 1121

1120Envie esta mensagem completa ao seu administrador. Ela lista as alterações que ele pode fazer. A mensagem significa que o Claude Code recusou seu prompt. Enquanto você usar seu login claude.ai, o Claude Code continuará recusando prompts, inclusive após uma reinicialização:1122Estas mensagens significam que o Claude Code recusou sua requisição e não enviou seu login claude.ai:

1121 1123

1122```text theme={null}1124```text theme={null}

1123Claude Code didn't send your claude.ai login, because the API key helper your administrator set isn't in effect. Your organization's managed settings may be overriding it. Ask your administrator to keep the key helper and its API address in effect, to name Anthropic's API address in those managed settings, or to remove the key helper. Run /status to see your setting sources.1125Your organization's settings need an update. Ask your administrator to fix the API key helper configuration.

1126Couldn't load your organization's settings. Check your connection, then restart Claude Code.

1127Restart Claude Code to finish signing in.

1124```1128```

1125 1129

1126**O que fazer:**1130**O que fazer:**

1127 1131

1128* Para informar ao seu administrador quais fontes gerenciadas sua máquina tem, execute `/status` no prompt do Claude Code e copie a [linha `Setting sources`](https://code.claude.com/docs/pt/managed-settings#read-the-source-in-/status). Se uma linha `Skipped sources` aparecer, copie-a também1132* `Your organization's settings need an update`: peça ao seu administrador que corrija a configuração do API key helper

1129* Se você administra as configurações, consulte [por que o key helper da máquina não está em vigor](https://code.claude.com/docs/pt/server-managed-settings.md#machine-apikeyhelper-not-in-effect)1133 * Para informar ao seu administrador quais fontes gerenciadas sua máquina tem, execute `/status` no prompt do Claude Code e copie a [linha `Setting sources`](https://code.claude.com/docs/pt/managed-settings#read-the-source-in-/status). Se aparecer uma linha `Skipped sources`, copie-a também

1134 * Se você administra as configurações e o helper está no arquivo de configurações gerenciadas de uma máquina ou em uma política MDM, consulte [Quando o `apiKeyHelper` de uma máquina não está em vigor](https://code.claude.com/docs/pt/server-managed-settings#machine-apikeyhelper-not-in-effect)

1135* `Couldn't load your organization's settings`: verifique sua conexão e reinicie o Claude Code. Se a mensagem voltar após uma reinicialização, informe seu administrador

1136* `Restart Claude Code to finish signing in`: reinicie o Claude Code

1137

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

1130 1139

1131### Invalid request header value1140### Invalid request header value

1132 1141

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

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

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

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

3426 3435

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

3428 3437

3554 3563

3555### O servidor MCP não foi salvo ou removido3564### O servidor MCP não foi salvo ou removido

3556 3565

3557Você executou `claude mcp add`, `claude mcp add-json` ou `claude mcp remove` para um servidor no [escopo](https://code.claude.com/docs/pt/mcp.md#mcp-installation-scopes) `user` ou `local`. Ambos os escopos são armazenados em `~/.claude.json`, e a alteração não está nesse arquivo quando o Claude Code o lê de volta após a gravação. O comando sai com este erro em vez de sua linha de sucesso.3566Este erro significa que um comando como `claude mcp add` ou `claude mcp remove` não conseguiu gravar sua alteração em `~/.claude.json`. Outros processos do Claude Code podem ter mantido o arquivo bloqueado, ou o arquivo pode ser somente leitura ou estar protegido por um sandbox.

3558 3567

3559```text theme={null}3568```text theme={null}

3560MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.3569MCP server "example" was not saved to /home/user/.claude.json. If other Claude Code processes use that file, they may have kept it locked: add the server again, with CLAUDE_CODE_CONFIG_LOCK_WAIT_MS=60000 set to wait up to a minute. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox first.

3561```3570```

3562 3571

3563Após uma remoção, a mensagem diz `was not removed from` e termina com `then remove the server again`. Para um servidor de escopo `local`, o caminho é seguido pelo diretório do projeto ao qual a entrada pertence, como `(local scope for /path/to/project)`.3572Depois de uma remoção, a mensagem diz `was not removed from` no lugar de `was not saved to`, e `remove the server again` no lugar de `add the server again`. Para um servidor de escopo `local`, o caminho é seguido pelo diretório do projeto ao qual a entrada pertence, como `(local scope for /path/to/project)`.

~~3564~~

3565Antes da v2.1.283, `claude mcp add`, `claude mcp add-json` e `claude mcp remove` relatavam sucesso mesmo quando a alteração não chegava ao arquivo.

3566 3573

3567**O que fazer:**3574**O que fazer:**

3568 3575

3569* Torne gravável o arquivo que a mensagem nomeia, ou execute o comando fora do sandbox, e então execute o mesmo comando de adição ou remoção novamente.3576* **Outros processos do Claude Code estão em execução**: o comando espera cerca de 10 a 20 segundos pelo bloqueio do arquivo e então desiste sem gravar. Execute o mesmo comando novamente com [`CLAUDE_CODE_CONFIG_LOCK_WAIT_MS`](https://code.claude.com/docs/pt/env-vars#variables) definida para uma espera mais longa em milissegundos, como `60000`.

3577* **O arquivo é somente leitura ou está protegido por sandbox**: torne gravável o arquivo citado na mensagem e execute o mesmo comando de adição ou remoção novamente, ou execute esse comando fora do sandbox.

3578

3579Antes da v2.1.283, `claude mcp add`, `claude mcp add-json` e `claude mcp remove` informavam sucesso mesmo quando a alteração não chegava ao arquivo. Antes da v2.1.318, a mensagem não mencionava o bloqueio, e o Claude Code não lia [`CLAUDE_CODE_CONFIG_LOCK_WAIT_MS`](https://code.claude.com/docs/pt/env-vars#variables).

3570 3580

3571### O servidor MCP pode não ter sido salvo ou removido3581### O servidor MCP pode não ter sido salvo ou removido

3572 3582

3573Você executou `claude mcp add`, `claude mcp add-json` ou `claude mcp remove` para um servidor no [escopo](https://code.claude.com/docs/pt/mcp.md#mcp-installation-scopes) `user` ou `local`, e o Claude Code não conseguiu ler `~/.claude.json` de volta para confirmar a alteração. A alteração pode ou não estar no disco. O texto entre parênteses é o erro dessa leitura.3583Você executou `claude mcp add`, `claude mcp add-json` ou `claude mcp remove` para um servidor no [escopo](https://code.claude.com/docs/pt/mcp.md#mcp-installation-scopes) `user` ou `local`, e o Claude Code não conseguiu ler `~/.claude.json` de volta para confirmar a alteração. A alteração pode ou não estar no disco. Os parênteses após `to confirm the change` informam o motivo.

3574 3584

3575```text theme={null}3585```text theme={null}

3576MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.3586MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.

3577```3587```

3578 3588

3579Após uma remoção, a mensagem diz `may not have been removed` e termina com `then remove the server again if it is still listed`.3589Depois de uma remoção, a mensagem diz `may not have been removed` e termina com `then remove the server again if it is still listed`. Se o motivo for `the file was not found`, o servidor ainda pode estar configurado.

3580 3590

3581Antes da v2.1.283, os comandos relatavam sucesso mesmo quando a alteração não podia ser confirmada.3591Antes da v2.1.283, os comandos relatavam sucesso mesmo quando a alteração não podia ser confirmada.

3582 3592

3868 3878

3869* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar seu branch base explicitamente, como no exemplo acima3879* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar seu branch base explicitamente, como no exemplo acima

3870* **Você passou um branch base que já estava no seu clone**: a dica diz ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3880* **Você passou um branch base que já estava no seu clone**: a dica diz ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3871* **Você passou um branch base que não estava no seu clone**: o Claude Code o buscou da origin antes de comparar. A dica diz ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando o Claude Code não consegue determinar se seu clone é shallow, ele sugere `git fetch --unshallow origin` em vez disso. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para todo branch base buscado, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.3881* **Você passou um branch base que não estava no seu clone**: o Claude Code o buscou do origin antes de comparar. A dica diz ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando o Claude Code não consegue determinar se o seu clone é raso, ele sugere `git fetch --unshallow origin` em vez disso. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para todo branch base buscado, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.

3872 3882

3873**O que fazer:**3883**O que fazer:**

3874 3884

fast-mode.md +5 −5

Details

35Na CLI, alterne o modo rápido de uma destas formas:35Na CLI, alterne o modo rápido de uma destas formas:

36 36

37* Execute `/fast`, pressione Space para alternar ativado ou desativado, depois pressione Enter para confirmar37* Execute `/fast`, pressione Space para alternar ativado ou desativado, depois pressione Enter para confirmar

~~38* Defina `"fastMode": true` no seu [arquivo de configurações do usuário](https://code.claude.com/docs/pt/settings.md)~~38* Em um modelo que suporta modo rápido, defina `"fastMode": true` no seu [arquivo de configurações do usuário](https://code.claude.com/docs/pt/settings.md). Se você defini-lo em qualquer outro modelo, você permanece nesse modelo com o modo rápido desativado.

39 39

40Por padrão, o modo rápido que você ativa em uma sessão interativa persiste entre sessões. Você pode configurar o modo rápido para ser redefinido a cada sessão. Consulte [require per-session opt-in](#require-per-session-opt-in) para obter detalhes.40Por padrão, o modo rápido que você ativa em uma sessão interativa persiste entre sessões em um modelo suportado. Você pode configurar o modo rápido para ser redefinido a cada sessão. Consulte [require per-session opt-in](#require-per-session-opt-in) para obter detalhes.

41 41

42Fora de uma [sessão em nuvem](#use-fast-mode-in-cloud-sessions), no [modo não interativo](https://code.claude.com/docs/pt/headless.md) com a flag `-p`, `/fast` funciona apenas em uma sessão iniciada com modo rápido em seu valor [`--settings`](https://code.claude.com/docs/pt/cli-reference#cli-flags), por exemplo `claude -p --settings '{"fastMode": true}'`; a alternância então se aplica apenas a essa sessão e não é salva como seu padrão. O formulário `-p` requer Claude Code v2.1.205 ou posterior. Em qualquer outro lugar no modo não interativo, o comando relata que o modo rápido não está disponível.42Fora de uma [sessão em nuvem](#use-fast-mode-in-cloud-sessions), no [modo não interativo](https://code.claude.com/docs/pt/headless.md) com a flag `-p`, `/fast` funciona apenas em uma sessão iniciada com modo rápido em seu valor [`--settings`](https://code.claude.com/docs/pt/cli-reference#cli-flags), por exemplo `claude -p --settings '{"fastMode": true}'`; a alternância então se aplica apenas a essa sessão e não é salva como seu padrão. O formulário `-p` requer Claude Code v2.1.205 ou posterior. Em qualquer outro lugar no modo não interativo, o comando relata que o modo rápido não está disponível.

43 43

45 45

46Para melhor eficiência de custo, ative o modo rápido no início de uma sessão em vez de alternar no meio da conversa. Consulte [understand the cost tradeoff](#understand-the-cost-tradeoff) para obter detalhes.46Para melhor eficiência de custo, ative o modo rápido no início de uma sessão em vez de alternar no meio da conversa. Consulte [understand the cost tradeoff](#understand-the-cost-tradeoff) para obter detalhes.

47 47

~~48Quando você ativa o modo rápido:~~48Quando você ativa o modo rápido com `/fast`:

49 49

50* Se seu modelo atual não suportar modo rápido, Claude Code alterna para Opus50* Se seu modelo atual não suportar modo rápido, Claude Code alterna para Opus

51* Você verá uma mensagem de confirmação: "Fast mode ON"51* Você verá uma mensagem de confirmação: "Fast mode ON"

196 196

197### Exigir opt-in por sessão197### Exigir opt-in por sessão

198 198

199Por padrão, o modo rápido que um usuário ativa em uma sessão interativa persiste entre sessões. Para alterar isso, defina `fastModePerSessionOptIn` como `true` em qualquer [arquivo de configurações](https://code.claude.com/docs/pt/settings.md#where-settings-live), o que faz com que cada sessão comece com o modo rápido desativado e exija que os usuários o ativem explicitamente com `/fast`. Os proprietários em planos [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) ou [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) podem implantá-lo em toda a organização através de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md).199Por padrão, o modo rápido que um usuário ativa em uma sessão interativa persiste entre sessões em um modelo compatível. Para alterar isso, defina `fastModePerSessionOptIn` como `true` em qualquer [arquivo de configurações](https://code.claude.com/docs/pt/settings.md#where-settings-live), o que faz com que cada sessão comece com o modo rápido desativado e exija que os usuários o ativem explicitamente com `/fast`. Os proprietários em planos [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) ou [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) podem implantá-lo em toda a organização através de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md).

200 200

201```json theme={null}201```json theme={null}

202{202{

221 221

222Se você ficar sem créditos de uso no meio de uma sessão, Claude Code tenta novamente cada solicitação de modo rápido rejeitada com velocidade e preços padrão, para que você continue trabalhando, e não há cooldown. Como você vê a rejeição depende do tipo de sessão:222Se você ficar sem créditos de uso no meio de uma sessão, Claude Code tenta novamente cada solicitação de modo rápido rejeitada com velocidade e preços padrão, para que você continue trabalhando, e não há cooldown. Como você vê a rejeição depende do tipo de sessão:

223 223

224* Em uma sessão interativa, Claude Code mostra uma notificação "Fast mode disabled · usage credits exhausted" e desativa o modo rápido para o resto da sessão. Sua preferência de modo rápido salva não muda; execute `/fast` para ativar o modo rápido novamente.224* Em uma sessão interativa, Claude Code mostra uma notificação "Fast mode disabled · Out of usage credits" e desativa o modo rápido. Sua preferência de modo rápido salva não muda; execute `/fast` para ativar o modo rápido novamente.

225* Em [modo não-interativo](https://code.claude.com/docs/pt/headless.md) com `--output-format stream-json`, e através do Agent SDK, Claude Code emite o mesmo texto no fluxo de mensagens como uma mensagem `system` com subtipo `notification`, uma vez por turno enquanto você estiver sem créditos de uso. O modo rápido permanece ativado. Requer Claude Code v2.1.221 ou posterior.225* Em [modo não-interativo](https://code.claude.com/docs/pt/headless.md) com `--output-format stream-json`, e através do Agent SDK, Claude Code emite o mesmo texto no fluxo de mensagens como uma mensagem `system` com subtipo `notification`, uma vez por turno enquanto você estiver sem créditos de uso. O modo rápido permanece ativado. Requer Claude Code v2.1.221 ou posterior.

226 226

227## Research preview227## Research preview

hooks.md +63 −21

Details

70 70

71> [tab] macOS/Linux71> [tab] macOS/Linux

72>72>

73> O `matcher` se restringe a chamadas de ferramenta Bash e a condição `if` se restringe ainda mais a subcomandos Bash correspondendo a `rm *`, então `block-rm.sh` apenas é gerado quando ambos os filtros correspondem:73> O `matcher` se restringe a chamadas de ferramenta Bash e a [comandos Monitor](#match-monitor-commands), e a condição `if` se restringe ainda mais a subcomandos Bash correspondendo a `rm *`, então `block-rm.sh` apenas é gerado quando ambos os filtros correspondem:

74>74>

75> ```json theme={null}75> ```json theme={null}

76> {76> {

116 116

117> [tab] Windows (PowerShell)117> [tab] Windows (PowerShell)

118>118>

119> O matcher `Bash|PowerShell` cobre a [ferramenta PowerShell](#powershell) bem como Bash. Uma única regra `if` corresponde apenas às chamadas de uma ferramenta, então cada ferramenta obtém seu próprio manipulador: o primeiro se restringe a subcomandos Bash correspondendo a `rm *`, o segundo a comandos PowerShell correspondendo a `Remove-Item *`. Ambos executam o mesmo script através de `powershell.exe`:119> O matcher `Bash|PowerShell` cobre a [ferramenta PowerShell](#powershell) bem como Bash. Uma única regra `if` nomeia apenas uma ferramenta, então cada ferramenta obtém seu próprio manipulador: o primeiro se restringe a subcomandos Bash correspondendo a `rm *`, o segundo a comandos PowerShell correspondendo a `Remove-Item *`. Ambos executam o mesmo script através de `powershell.exe`:

120>120>

121> ```json theme={null}121> ```json theme={null}

122> {122> {

225Hooks são definidos em arquivos de configurações JSON. A configuração tem três níveis de aninhamento:225Hooks são definidos em arquivos de configurações JSON. A configuração tem três níveis de aninhamento:

226 226

2271. Escolha um [evento de hook](#hook-events) para responder, como `PreToolUse` ou `Stop`2271. Escolha um [evento de hook](#hook-events) para responder, como `PreToolUse` ou `Stop`

2282. Adicione um [grupo de matcher](#matcher-patterns) para filtrar quando dispara, como "apenas para a ferramenta Bash"2282. Adicione um [grupo de matcher](#matcher-patterns) para filtrar quando ele é acionado, como "para a ferramenta Bash"

2293. Defina um ou mais [manipuladores de hook](#hook-handler-fields) para executar quando correspondido2293. Defina um ou mais [manipuladores de hook](#hook-handler-fields) para executar quando correspondido

230 230

231Consulte [Como um hook é resolvido](#how-a-hook-resolves) acima para um passo a passo completo com um exemplo anotado.231Consulte [Como um hook é resolvido](#how-a-hook-resolves) acima para um passo a passo completo com um exemplo anotado.

278| :- | :- | :- |278| :- | :- | :- |

280| Apenas letras, dígitos, `_`, `-`, espaços, `,` e `\|` | String exata ou lista de strings exatas separadas por `\|` ou `,` com espaço em branco opcional ao redor | `Bash` corresponde apenas à ferramenta Bash; `Edit\|Write` e `Edit, Write` cada um corresponde a qualquer ferramenta exatamente; `code-reviewer` corresponde apenas a esse tipo de agente |280| Apenas letras, dígitos, `_`, `-`, espaços, `,` e `\|` | String exata ou lista de strings exatas separadas por `\|` ou `,` com espaço em branco opcional ao redor | `Bash` corresponde à ferramenta Bash e, em `PreToolUse` e `PermissionRequest`, também a [comandos Monitor](#match-monitor-commands); `Edit\|Write` e `Edit, Write` cada um corresponde a qualquer ferramenta exatamente; `code-reviewer` corresponde apenas a esse tipo de agente |

281| Contém qualquer outro caractere | Expressão regular JavaScript, não ancorada | `^Notebook` corresponde a qualquer ferramenta cujo nome começa com `Notebook`; `mcp__memory__.*` corresponde a cada ferramenta do servidor `memory` |281| Contém qualquer outro caractere | Expressão regular JavaScript, não ancorada | `^Notebook` corresponde a qualquer ferramenta cujo nome começa com `Notebook`; `mcp__memory__.*` corresponde a cada ferramenta do servidor `memory` |

282 282

283Um matcher no caminho de expressão regular é testado com `RegExp.prototype.test` do JavaScript, que sucede em uma correspondência em qualquer lugar no valor. `Edit.*` corresponde tanto a `Edit` quanto a `NotebookEdit`; envolva o padrão em `^` e `$`, como em `^Edit$`, quando você precisa de uma correspondência de string inteira.283Um matcher no caminho de expressão regular é testado com `RegExp.prototype.test` do JavaScript, que sucede em uma correspondência em qualquer lugar no valor. `Edit.*` corresponde tanto a `Edit` quanto a `NotebookEdit`; envolva o padrão em `^` e `$`, como em `^Edit$`, quando você precisa de uma correspondência de string inteira.

297| `Notification` | tipo de notificação | `permission_prompt`, `idle_prompt`, `auth_success`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled`, `plugin_notification` |297| `Notification` | tipo de notificação | `permission_prompt`, `idle_prompt`, `auth_success`, `auth_storage_failure`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled`, `plugin_notification` |

300| `PreModelSwitch`, `PostModelSwitch` | nome canônico do modelo para o qual a sessão muda, conforme descrito em [PreModelSwitch](#premodelswitch) | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |300| `PreModelSwitch`, `PostModelSwitch` | nome canônico do modelo para o qual a sessão muda, conforme descrito em [PreModelSwitch](#premodelswitch) | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |

385}385}

386```386```

387 387

388#### Corresponder comandos Monitor

389

390Um hook [`PreToolUse`](#pretooluse) ou [`PermissionRequest`](#permissionrequest) com um matcher `Bash` também executa em comandos shell que Claude inicia com a [ferramenta Monitor](https://code.claude.com/docs/pt/tools-reference.md#monitor-tool), mas seu `allow` e seu [`updatedInput`](#pretooluse-decision-control) não têm efeito sobre eles. Requer Claude Code v2.1.314 ou posterior. Matchers como `Bash|PowerShell`, `^Bash$` e `Bash.*` também são matchers `Bash`. Um hook com um matcher `Bash` não executa para um [WebSocket watch](https://code.claude.com/docs/pt/tools-reference.md#websocket-source), e um hook `PostToolUse` com esse matcher não executa para Monitor.

391

392Um hook que executa para um comando Monitor pode negá-lo ou fazer com que Claude Code pergunte a você sobre ele. Para permitir ou reescrever o comando, troque o matcher `Bash` por um que inclua Monitor:

393

394* **Matcher que inclui Monitor**: com um matcher como `Bash|Monitor` ou `.*`, ou sem matcher, o hook recebe a própria entrada da chamada Monitor, e `allow` e `updatedInput` se aplicam. Em [`if`](#common-fields), nomeie Monitor, como em `Monitor(tail *)`, que corresponde pelas [regras que `Bash(tail *)` segue](#bash-if-matching). Se o seu `if` nomear Bash, o hook ainda recebe a entrada da chamada Monitor, mas `allow` e `updatedInput` não têm efeito

395* **Matcher `Bash`**: o hook recebe uma chamada Bash. Em `if`, nomeie Bash, como em `Bash(tail *)`. O hook não executa se o seu `if` nomear Monitor

396

388### Campos do manipulador de hook397### Campos do manipulador de hook

389 398

390Cada objeto no array `hooks` interno é um manipulador de hook: o comando shell, endpoint HTTP, ferramenta MCP, prompt LLM ou agente que executa quando o matcher corresponde. Existem cinco tipos:399Cada objeto no array `hooks` interno é um manipulador de hook: o comando shell, endpoint HTTP, ferramenta MCP, prompt LLM ou agente que executa quando o matcher corresponde. Existem cinco tipos:

811* **Duas ou mais linhas que cada uma analisa como JSON por conta própria, a primeira começando com `{` e a última terminando com `}`**: texto simples quando nenhuma linha é um objeto de saída JSON que define um campo. Quando uma linha é, a saída é uma falha de análise, portanto imprima esse objeto sem mais nada em stdout.820* **Duas ou mais linhas que cada uma analisa como JSON por conta própria, a primeira começando com `{` e a última terminando com `}`**: texto simples quando nenhuma linha é um objeto de saída JSON que define um campo. Quando uma linha é, a saída é uma falha de análise, portanto imprima esse objeto sem mais nada em stdout.

812* **Qualquer outra coisa que começa com `{` e termina com `}` mas não é JSON válido**: uma falha de análise.821* **Qualquer outra coisa que começa com `{` e termina com `}` mas não é JSON válido**: uma falha de análise.

813 822

814Para a maioria dos eventos, Claude Code escreve stdout no log de debug e não o mostra na transcrição. As exceções são `UserPromptSubmit`, `UserPromptExpansion`, `SessionStart` e `PostModelSwitch`, onde Claude Code adiciona stdout em texto simples como contexto que Claude pode ver e agir. Nesses eventos, Claude Code não adiciona stdout que não conseguiu analisar.823Para a maioria dos eventos, Claude Code escreve stdout no log de debug e não o mostra na transcrição. Nestes eventos, seu stdout chega ao Claude ou ao resumo de compactação:

824

825* **`UserPromptSubmit`, `UserPromptExpansion`, `SessionStart` e `PostModelSwitch`**: Claude Code adiciona stdout em texto simples como contexto que Claude pode ver e agir. Ele não adiciona stdout que não conseguiu analisar.

826* **`PreCompact`**: seu stdout se torna [instruções para o resumo de compactação](#precompact-output)

815 827

816Claude nunca vê stderr de um hook que sai com 0. Para lê-lo você mesmo em eventos como `PreToolUse`, ative [debug logging](#debug-hooks). Para exibir um aviso para Claude de um hook `PostToolUse` ou `PostToolUseFailure`, saia com 2 em vez disso para que [Claude veja o stderr](#exit-code-2-behavior-per-event) mesmo que a ferramenta já tenha executado.828Claude nunca vê stderr de um hook que sai com 0. Para lê-lo você mesmo em eventos como `PreToolUse`, ative [debug logging](#debug-hooks). Para exibir um aviso para Claude de um hook `PostToolUse` ou `PostToolUseFailure`, saia com 2 em vez disso para que [Claude veja o stderr](#exit-code-2-behavior-per-event) mesmo que a ferramenta já tenha executado.

817 829

1050As strings de saída de hook `additionalContext`, `systemMessage` e `initialUserMessage`, e seu stdout simples, são limitadas a 10.000 caracteres:1062As strings de saída de hook `additionalContext`, `systemMessage` e `initialUserMessage`, e seu stdout simples, são limitadas a 10.000 caracteres:

1051 1063

1052* **Escopo**: Claude Code mede cada string por conta própria, mesmo quando vários hooks executam para o mesmo evento. Para saída JSON, cada campo é medido separadamente; stdout simples é medido como um todo.1064* **Escopo**: Claude Code mede cada string por conta própria, mesmo quando vários hooks executam para o mesmo evento. Para saída JSON, cada campo é medido separadamente; stdout simples é medido como um todo.

1053* **Acima do limite**: Claude Code salva a saída em um arquivo no diretório de sessão e a substitui pelo caminho do arquivo e uma visualização de até os primeiros 2.000 caracteres. Um resultado Bash grande válido é tratado da mesma forma, descrito em [Limites de saída](https://code.claude.com/docs/pt/tools-reference.md#output-limits). Diferentemente desse teto Bash, este limite não tem configuração ou variável de ambiente para aumentá-lo.1065* **Acima do limite**: exceto para o [stdout de PreCompact](#precompact-output), Claude Code salva a saída em um arquivo no diretório de sessão. Ele substitui a saída pelo caminho do arquivo e uma visualização de até os primeiros 2.000 caracteres. Um resultado Bash grande válido é tratado da mesma forma, descrito em [Limites de saída](https://code.claude.com/docs/pt/tools-reference.md#output-limits). Diferentemente desse teto Bash, este limite não tem configuração ou variável de ambiente para aumentá-lo.

1054* **Lendo o arquivo**: Claude Code não pede a Claude para ler o arquivo, portanto mantenha qualquer coisa que Claude sempre deva ver dentro do limite.1066* **Lendo o arquivo**: Claude Code não pede a Claude para ler o arquivo, portanto mantenha qualquer coisa que Claude sempre deva ver dentro do limite.

1055 1067

1056O objeto JSON suporta três tipos de campos:1068O objeto JSON suporta três tipos de campos:

1954 1966

1955#### Controle de decisão do PreToolUse1967#### Controle de decisão do PreToolUse

1956 1968

1957Os hooks `PreToolUse` podem controlar se uma chamada de ferramenta prossegue. Diferentemente de outros hooks que usam um campo `decision` de nível superior, o PreToolUse retorna sua decisão dentro de um objeto `hookSpecificOutput`. Isso lhe dá um controle mais rico: quatro resultados (allow, deny, ask ou defer), além da capacidade de modificar a entrada da ferramenta antes da execução.1969Os hooks `PreToolUse` podem controlar se uma chamada de ferramenta prossegue. Ao contrário de outros hooks que usam um campo `decision` de nível superior, o PreToolUse retorna sua decisão dentro de um objeto `hookSpecificOutput`. Isso lhe dá um controle mais rico: quatro resultados (allow, deny, ask ou defer), além da capacidade de modificar a entrada da ferramenta antes da execução. Para permitir ou reescrever um comando Monitor, consulte [Corresponder a comandos Monitor](#match-monitor-commands).

1958 1970

1959| Campo | Descrição |1971| Campo | Descrição |

1960| :- | :- |1972| :- | :- |

2051 2063

2052#### Adiar uma chamada de ferramenta para mais tarde2064#### Adiar uma chamada de ferramenta para mais tarde

2053 2065

2054`"defer"` destina-se a integrações que executam `claude -p` como subprocesso e leem sua saída JSON, como um aplicativo do Agent SDK ou uma interface personalizada construída sobre o Claude Code. Ele permite que esse processo chamador pause o Claude em uma chamada de ferramenta, colete a entrada por meio de sua própria interface e retome de onde parou. O Claude Code respeita esse valor somente no [modo não interativo](https://code.claude.com/docs/pt/headless.md) com a flag `-p`. Em sessões interativas, ele registra um aviso e ignora o resultado do hook.2066`"defer"` é para integrações que executam `claude -p` como um subprocesso e leem sua saída JSON, como um aplicativo do Agent SDK ou uma UI personalizada construída sobre o Claude Code. Ele permite que esse processo chamador pause o Claude em uma chamada de ferramenta, colete entrada por meio de sua própria interface e retome de onde parou.

2067

2068O Claude Code respeita `"defer"` apenas no [modo não interativo](https://code.claude.com/docs/pt/headless.md) com a flag `-p`, e apenas quando o Claude faz uma única chamada de ferramenta no turno:

2069

2070* **Em sessões interativas**: ele registra um aviso no log e ignora o resultado do hook

2071* **Várias chamadas de ferramenta de uma vez**: `"defer"` é ignorado com um aviso e a ferramenta prossegue pelo fluxo normal de permissão

2055 2072

2056A ferramenta `AskUserQuestion` é o caso típico: o Claude quer perguntar algo ao usuário, mas não há terminal para responder. Uma execução `-p` oferece `AskUserQuestion` somente quando tem um [host de permissão](https://code.claude.com/docs/pt/headless.md#turn-off-permission-prompts-in-unattended-runs), como uma ferramenta MCP que você passa com `--permission-prompt-tool`, portanto inicie a execução com um. O ciclo funciona assim:2073A ferramenta `AskUserQuestion` é o caso típico: o Claude quer perguntar algo ao usuário, mas não há terminal para responder. Uma execução `-p` oferece `AskUserQuestion` somente quando tem um [host de permissão](https://code.claude.com/docs/pt/headless.md#turn-off-permission-prompts-in-unattended-runs), como uma ferramenta MCP que você passa com `--permission-prompt-tool`, portanto inicie a execução com um. O ciclo funciona assim:

2057 2074

20614. O processo chamador executa `claude -p --resume <session-id>` com o mesmo host de permissão. A mesma chamada de ferramenta dispara o `PreToolUse` novamente.20784. O processo chamador executa `claude -p --resume <session-id>` com o mesmo host de permissão. A mesma chamada de ferramenta dispara o `PreToolUse` novamente.

20625. O hook retorna `permissionDecision: "allow"` com a resposta em `updatedInput`. A ferramenta é executada e o Claude continua.20795. O hook retorna `permissionDecision: "allow"` com a resposta em `updatedInput`. A ferramenta é executada e o Claude continua.

2063 2080

2064O campo `deferred_tool_use` carrega o `id`, o `name` e o `input` da ferramenta. O `input` são os parâmetros que o Claude gerou para a chamada de ferramenta, capturados antes da execução:2081O campo `deferred_tool_use` contém o `id`, o `name` e o `input` da ferramenta:

2065 2082

2066```json theme={null}2083```json theme={null}

2067{2084{

2077}2094}

2078```2095```

2079 2096

2080Não há timeout nem limite de novas tentativas. A sessão permanece no disco até que você a retome, sujeita à varredura de retenção de [`cleanupPeriodDays`](https://code.claude.com/docs/pt/settings-reference#cleanupperioddays), que exclui arquivos de sessão após 30 dias por padrão, seguindo as [regras da varredura de retenção](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically).2097Não há timeout nem limite de novas tentativas. A sessão permanece no disco até que a [limpeza por retenção](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically) de [`cleanupPeriodDays`](https://code.claude.com/docs/pt/settings-reference#cleanupperioddays) a exclua, após 30 dias por padrão.

~~2081~~

2082Se a ferramenta adiada não estiver mais disponível quando você retomar, o primeiro resultado da retomada tem `stop_reason: "tool_deferred_unavailable"` e `is_error: true`, e o hook não é disparado. Isso acontece quando um servidor MCP que fornecia a ferramenta não está conectado na sessão retomada. O payload `deferred_tool_use` ainda é incluído para que você possa identificar qual ferramenta ficou ausente.

~~2083~~

2084* **Se você não enviou nenhum prompt, com a retomada ou depois dela**, a chamada continua pendente. Retome novamente com a ferramenta disponível e ela será executada primeiro.

2085* **Se você enviou um prompt, com a retomada ou depois dela**, o Claude Code o responde sem o resultado da ferramenta e descarta a chamada adiada. Envie um novo prompt quando a ferramenta estiver disponível, se ainda precisar que ela seja chamada.

2086 2098

2087Se a resposta que você está aguardando não estiver pronta quando você retomar sem um prompt, o hook pode retornar `"defer"` novamente. Se você enviou um prompt e o hook adia novamente, o Claude Code trata o prompt da mesma forma: responde sem o resultado da ferramenta e descarta a chamada. Retome sem um prompt até que o hook retorne `"allow"` ou `"deny"`, que é como o processo chamador encerra o ciclo.2099Se a resposta não estiver pronta quando você retomar, o hook pode retornar `"defer"` novamente. Se você enviou um prompt com essa retomada, o Claude o responde sem o resultado da ferramenta e não executa a chamada. Retome sem um prompt até que o hook retorne `"allow"` ou `"deny"`.

~~2088~~

2089`"defer"` só funciona quando o Claude faz uma única chamada de ferramenta no turno. Se o Claude fizer várias chamadas de ferramenta ao mesmo tempo, `"defer"` é ignorado com um aviso e a ferramenta prossegue pelo fluxo normal de permissão. A restrição existe porque a retomada só pode executar novamente uma ferramenta: não há como adiar uma chamada de um lote sem deixar as outras sem resolução.

2090 2100

2091> [!NOTE]2101> [!NOTE]

2092>2102>

2093> Para retomar uma sessão adiada no modo de planejamento, passe [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags) junto com `--resume` para que o Claude Code possa apresentar o plano para aprovação. Para as demais condições, consulte [Retomar no modo de planejamento com `-p`](https://code.claude.com/docs/pt/sessions#resume-in-plan-mode-with-p). Requer o Claude Code v2.1.246 ou posterior.2103> Para retomar uma sessão adiada no modo de planejamento, passe [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags) junto com `--resume` para que o Claude Code possa apresentar o plano para aprovação. Para as demais condições, consulte [Retomar no modo de planejamento com `-p`](https://code.claude.com/docs/pt/sessions#resume-in-plan-mode-with-p). Requer o Claude Code v2.1.246 ou posterior.

2094>2104>

2095> Quando você retoma com `-p`, o Claude Code não restaura nenhum outro modo de permissão armazenado. Ele inicia a execução no modo de permissão em que uma nova execução `claude -p` começaria, portanto passe `--permission-mode` ou `--dangerously-skip-permissions` novamente se a sessão adiada usava um deles. Quando você retoma com `claude --resume <session-id>` sem `-p`, o Claude Code restaura o modo de permissão armazenado, com as exceções listadas em [modo de permissão na retomada](https://code.claude.com/docs/pt/sessions.md#permission-mode-on-resume).2105> Quando você retoma com `-p`, o Claude Code não restaura nenhum outro modo de permissão armazenado. Ele inicia a execução no modo de permissão em que uma nova execução `claude -p` iniciaria, então passe `--permission-mode` ou `--dangerously-skip-permissions` novamente se a sessão adiada usava um deles.

2106

2107##### Retomar quando uma ferramenta adiada não está disponível

2108

2109Um resultado com `stop_reason: "tool_deferred_unavailable"` significa que a ferramenta de uma chamada adiada não está disponível na sessão retomada, por exemplo porque seu servidor MCP não está conectado. Seu hook `PreToolUse` não é disparado, e o campo `deferred_tool_use` do resultado nomeia a ferramenta.

2110

2111Enquanto a chamada estiver pendente, qualquer prompt que você enviar não chega ao Claude e a execução termina com código 1. O campo `result` começa com `<tool> isn't available, so its deferred call didn't run.` Execute a chamada ou descarte-a para que ela não seja executada:

2112

2113* **Para executar a chamada**: torne a ferramenta disponível e retome novamente.

2114* **Para descartar a chamada**: retome com um prompt e com [`CLAUDE_CODE_DROP_UNAVAILABLE_DEFERRED_TOOL`](https://code.claude.com/docs/pt/env-vars#variables) definida como `1`. O Claude recebe um erro como resultado da chamada e responde ao seu prompt. Quando você retomar depois, nenhuma chamada estará pendente.

2115

2116Quando você descarta a chamada, a execução grava o resultado `tool_deferred_unavailable` com um campo `result` vazio e, em seguida, a resposta do Claude em um segundo resultado. Ela termina com código 0, a menos que essa resposta seja um erro. Se você definir a variável e não enviar nenhum prompt, a execução ainda descarta a chamada e termina com código 1.

2117

2118Antes da v2.1.319, o Claude Code respondia a um prompt sem o resultado da ferramenta e descartava a chamada. Nessas versões, envie um novo prompt assim que a ferramenta estiver disponível.

2096 2119

2097### PermissionRequest2120### PermissionRequest

2098 2121

2150 2173

2174Para permitir ou reescrever um comando Monitor, consulte [Corresponder comandos Monitor](#match-monitor-commands).

2175

2151Um hook que sai com código 2 sem um objeto `decision` deixa o fluxo de permissão inalterado, e seu stderr é descartado. Para conceder ou negar a requisição, retorne o objeto `decision`.2176Um hook que sai com código 2 sem um objeto `decision` deixa o fluxo de permissão inalterado, e seu stderr é descartado. Para conceder ou negar a requisição, retorne o objeto `decision`.

2152 2177

2153```json theme={null}2178```json theme={null}

2205* Para executar um hook depois que qualquer ferramenta for concluída com sucesso, omita o `matcher` ou defina-o como `"*"`. Seu hook pode então descobrir por conta própria o que mudou, por exemplo executando `git status --porcelain`, que também lista arquivos não rastreados que `git diff` não mostra. Para chamadas de ferramenta que falham, adicione o mesmo hook em [PostToolUseFailure](#posttoolusefailure).2230* Para executar um hook depois que qualquer ferramenta for concluída com sucesso, omita o `matcher` ou defina-o como `"*"`. Seu hook pode então descobrir por conta própria o que mudou, por exemplo executando `git status --porcelain`, que também lista arquivos não rastreados que `git diff` não mostra. Para chamadas de ferramenta que falham, adicione o mesmo hook em [PostToolUseFailure](#posttoolusefailure).

2206* Para executar um hook quando um arquivo específico muda no disco, independentemente de quem o gravou, use [FileChanged](#filechanged). O Claude Code não executa um hook `PostToolUse` com matcher `Edit|Write` quando um comando `Bash` ou um processo fora do Claude Code reescreve o mesmo arquivo.2231* Para executar um hook quando um arquivo específico muda no disco, independentemente de quem o gravou, use [FileChanged](#filechanged). O Claude Code não executa um hook `PostToolUse` com matcher `Edit|Write` quando um comando `Bash` ou um processo fora do Claude Code reescreve o mesmo arquivo.

2207 2232

2233#### PostToolUse após uma interrupção

2234

2235Se um hook `PostToolUse` parar antes do tempo depois que você envia uma mensagem ou interrompe durante uma chamada de ferramenta, verifique se você pressionou `Ctrl+Enter`, `Enter` ou `Esc`:

2236

2237* **`Ctrl+Enter`**: se pressioná-lo [encerra o turno](https://code.claude.com/docs/pt/interactive-mode.md#when-claude-code-sends-what-you-queued) enquanto uma ferramenta está em execução e a ferramenta termina, seus hooks `PostToolUse` são executados sobre o resultado dela e têm 10 segundos para terminar. A tecla age como `Esc` se você enfileirou um comando `!` antes das suas mensagens ou se as tarefas em segundo plano estão desativadas, por exemplo com [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/pt/env-vars#variables).

2238* **`Enter`**: uma mensagem que você enfileira com `Enter` não interrompe o turno, então os hooks mantêm seu `timeout` habitual.

2239* **`Esc`**: você cancela os hooks imediatamente, então envie a mensagem com `Enter` ou `Ctrl+Enter` quando os hooks precisarem ser executados.

2240

2241Quando os 10 segundos acabam, o Claude Code encerra um hook de comando que ainda esteja em execução, seja qual for seu [`timeout`](#common-fields). Para permitir que um hook de comando mais longo termine, execute-o com [`async: true`](#run-hooks-in-the-background), o que significa que o hook não pode bloquear nem reescrever o resultado.

2242

2243Antes da v2.1.319, os hooks não eram iniciados depois que você interrompia o turno com uma mensagem, e um hook em execução era interrompido.

2244

2208#### Entrada do PostToolUse2245#### Entrada do PostToolUse

2209 2246

2210Os hooks `PostToolUse` são disparados depois que uma ferramenta já foi executada com sucesso. A entrada inclui tanto `tool_input`, os argumentos enviados à ferramenta, quanto `tool_response`, o resultado que ela retornou. O esquema exato de ambos depende da ferramenta. Os caminhos em `tool_input` de ferramentas de arquivo chegam no mesmo formato que no [PreToolUse](#pretooluse-input): sempre absolutos, com os separadores nativos da plataforma, ou seja, barras invertidas no Windows. Para uma ferramenta MCP, a entrada também traz o objeto [`mcp_server`](#pretooluse-input).2247Os hooks `PostToolUse` são disparados depois que uma ferramenta já foi executada com sucesso. A entrada inclui tanto `tool_input`, os argumentos enviados à ferramenta, quanto `tool_response`, o resultado que ela retornou. O esquema exato de ambos depende da ferramenta. Os caminhos em `tool_input` de ferramentas de arquivo chegam no mesmo formato que no [PreToolUse](#pretooluse-input): sempre absolutos, com os separadores nativos da plataforma, ou seja, barras invertidas no Windows. Para uma ferramenta MCP, a entrada também traz o objeto [`mcp_server`](#pretooluse-input).

2479| `permission_prompt` | O Claude precisa que você aprove um uso de ferramenta ou a [requisição de rede](https://code.claude.com/docs/pt/sandboxing.md#network-isolation) de um comando em sandbox, e o prompt está aguardando há cerca de seis segundos |2516| `permission_prompt` | O Claude precisa que você aprove um uso de ferramenta ou a [requisição de rede](https://code.claude.com/docs/pt/sandboxing.md#network-isolation) de um comando em sandbox, e o prompt está aguardando há cerca de seis segundos |

2519| `auth_storage_failure` | Seu login é concluído, mas o Claude Code não consegue salvar as novas credenciais em seu [armazenamento de credenciais](https://code.claude.com/docs/pt/authentication.md#credential-management). É disparado no lugar de `auth_success` |

2482| `elicitation_dialog` | Um servidor MCP abre um formulário de elicitação e você não digitou nada por cerca de seis segundos |2520| `elicitation_dialog` | Um servidor MCP abre um formulário de elicitação e você não digitou nada por cerca de seis segundos |

2483| `elicitation_url_dialog` | Um servidor MCP pede que você abra uma URL no navegador e você não digitou nada por cerca de seis segundos |2521| `elicitation_url_dialog` | Um servidor MCP pede que você abra uma URL no navegador e você não digitou nada por cerca de seis segundos |

2490| `quota_auto_resume_disabled` | O Claude Code encerra a espera por um limite de uso do claude.ai sem continuar sua tarefa: [`autoContinueAtUsageLimit`](https://code.claude.com/docs/pt/settings-reference#autocontinueatusagelimit) foi desativado ou a redefinição passou para mais de 24 horas de distância durante uma espera que o Claude Code iniciou por conta própria, a tarefa continuada continuou atingindo o limite, ou a continuação foi bloqueada antes de chegar ao modelo. Não é disparado quando você pressiona `Esc` ou `Ctrl+C`, ou escolhe **Don't continue automatically** |2528| `quota_auto_resume_disabled` | O Claude Code encerra a espera por um limite de uso do claude.ai sem continuar sua tarefa: [`autoContinueAtUsageLimit`](https://code.claude.com/docs/pt/settings-reference#autocontinueatusagelimit) foi desativado ou a redefinição passou para mais de 24 horas de distância durante uma espera que o Claude Code iniciou por conta própria, a tarefa continuada continuou atingindo o limite, ou a continuação foi bloqueada antes de chegar ao modelo. Não é disparado quando você pressiona `Esc` ou `Ctrl+C`, ou escolhe **Don't continue automatically** |

2491| `plugin_notification` | Um [mod](https://code.claude.com/docs/pt/plugins/mods/api.md#show-something-without-starting-a-turn) gera uma notificação com `$.ui.notify`. O `title` do hook é o nome do mod, a menos que o mod tenha definido um |2529| `plugin_notification` | Um [mod](https://code.claude.com/docs/pt/plugins/mods/api.md#show-something-without-starting-a-turn) gera uma notificação com `$.ui.notify`. O `title` do hook é o nome do mod, a menos que o mod tenha definido um |

2492 2530

2493Os tipos `quota_auto_resume_fired`, `quota_auto_resume_stale` e `quota_auto_resume_disabled` requerem Claude Code v2.1.234 ou posterior.2531Os tipos `quota_auto_resume_fired`, `quota_auto_resume_stale` e `quota_auto_resume_disabled` requerem Claude Code v2.1.234 ou posterior. O tipo `auth_storage_failure` requer v2.1.288 ou posterior.

2494 2532

2495Em sessões de terminal, `permission_prompt` para a requisição de rede de um comando em sandbox requer Claude Code v2.1.246 ou posterior.2533Em sessões de terminal, `permission_prompt` para a requisição de rede de um comando em sandbox requer Claude Code v2.1.246 ou posterior.

2496 2534

3326}3364}

3327```3365```

3328 3366

3367#### Saída do PreCompact

3368

3369Quando um hook PreCompact termina com 0 e não bloqueia, o Claude Code usa seu stdout como instruções para o resumo da compactação. Mantenha esse stdout abaixo de 10.000 caracteres por hook. O Claude Code corta saídas mais longas no limite e acrescenta um marcador.

3370

3329### PostCompact3371### PostCompact

3330 3372

3331É executado depois que o Claude Code conclui uma operação de compactação. Use este evento para reagir ao novo estado compactado, por exemplo para registrar em log o resumo gerado ou atualizar um estado externo. O Claude Code descarta os campos `systemMessage` e `continue` de um hook PostCompact.3373É executado depois que o Claude Code conclui uma operação de compactação. Use este evento para reagir ao novo estado compactado, por exemplo para registrar em log o resumo gerado ou atualizar um estado externo. O Claude Code descarta os campos `systemMessage` e `continue` de um hook PostCompact.

hooks-guide.md +4 −3

Details

177> >177> >

178> > Se você executar Claude Code dentro do WSL, `powershell.exe` deve estar disponível no seu `PATH` através da interoperabilidade do Windows.178> > Se você executar Claude Code dentro do WSL, `powershell.exe` deve estar disponível no seu `PATH` através da interoperabilidade do Windows.

179 179

180O `matcher` vazio dispara em todos os tipos de notificação. Para disparar apenas em eventos específicos, defina-o como um destes valores:180O `matcher` vazio dispara em todos os tipos de notificação. Para disparar apenas em eventos específicos, defina-o como um tipo de notificação, como um destes:

181 181

182| Matcher | Dispara quando |182| Matcher | Dispara quando |

183| :- | :- |183| :- | :- |

184| `permission_prompt` | Claude precisa que você aprove um uso de ferramenta ou uma [solicitação de rede](https://code.claude.com/docs/pt/sandboxing.md#network-isolation) de comando sandboxed, e o prompt aguardou cerca de seis segundos |184| `permission_prompt` | Claude precisa que você aprove um uso de ferramenta ou uma [solicitação de rede](https://code.claude.com/docs/pt/sandboxing.md#network-isolation) de comando sandboxed, e o prompt aguardou cerca de seis segundos |

187| `auth_storage_failure` | Seu login é concluído, mas Claude Code não consegue salvar as novas credenciais em seu [armazenamento de credenciais](https://code.claude.com/docs/pt/authentication.md#credential-management). Dispara no lugar de `auth_success` |

188| `elicitation_url_dialog` | Um servidor MCP pede que você abra uma URL do navegador e você não digitou por cerca de seis segundos |189| `elicitation_url_dialog` | Um servidor MCP pede que você abra uma URL do navegador e você não digitou por cerca de seis segundos |

189| `elicitation_complete` | Um servidor MCP relata que uma [elicitação em modo URL](https://code.claude.com/docs/pt/hooks.md#elicitation-input) está completa |190| `elicitation_complete` | Um servidor MCP relata que uma [elicitação em modo URL](https://code.claude.com/docs/pt/hooks.md#elicitation-input) está completa |

197 198

198Claude Code cronometra `permission_prompt` de forma diferente em um terminal e no Claude Desktop, na extensão VS Code e em outros hosts que respondem a solicitações de permissão através do Agent SDK. Consulte [quando cada tipo de notificação dispara](https://code.claude.com/docs/pt/hooks.md#notification) para ambos os tempos.199Claude Code cronometra `permission_prompt` de forma diferente em um terminal e no Claude Desktop, na extensão VS Code e em outros hosts que respondem a solicitações de permissão através do Agent SDK. Consulte [quando cada tipo de notificação dispara](https://code.claude.com/docs/pt/hooks.md#notification) para ambos os tempos.

199 200

200Os matchers `quota_auto_resume_fired`, `quota_auto_resume_stale` e `quota_auto_resume_disabled` exigem Claude Code v2.1.234 ou posterior.201Os matchers `quota_auto_resume_fired`, `quota_auto_resume_stale` e `quota_auto_resume_disabled` exigem Claude Code v2.1.234 ou posterior. O matcher `auth_storage_failure` exige v2.1.288 ou posterior.

201 202

202Em sessões de terminal, `permission_prompt` para uma solicitação de rede de comando sandboxed exige Claude Code v2.1.246 ou posterior.203Em sessões de terminal, `permission_prompt` para uma solicitação de rede de comando sandboxed exige Claude Code v2.1.246 ou posterior.

203 204

691| `Notification` | tipo de notificação | `permission_prompt`, `idle_prompt`, `auth_success`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled`, `plugin_notification` |692| `Notification` | tipo de notificação | `permission_prompt`, `idle_prompt`, `auth_success`, `auth_storage_failure`, `elicitation_dialog`, `elicitation_url_dialog`, `elicitation_complete`, `elicitation_response`, `agent_needs_input`, `agent_completed`, `quota_auto_resume_fired`, `quota_auto_resume_stale`, `quota_auto_resume_disabled`, `plugin_notification` |

694| `PreModelSwitch`, `PostModelSwitch` | nome canônico do modelo para o qual a sessão muda, conforme descrito em [PreModelSwitch](https://code.claude.com/docs/pt/hooks.md#premodelswitch) | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |695| `PreModelSwitch`, `PostModelSwitch` | nome canônico do modelo para o qual a sessão muda, conforme descrito em [PreModelSwitch](https://code.claude.com/docs/pt/hooks.md#premodelswitch) | `claude-opus-5`, `claude-opus-4-6\|claude-opus-5`, `.*opus.*` |

mcp.md +13 −3

Details

252 252

253Os status nesta lista relatam uma decisão de configuração em vez de uma tentativa de conexão, portanto Claude Code os imprime sem se conectar ao servidor:253Os status nesta lista relatam uma decisão de configuração em vez de uma tentativa de conexão, portanto Claude Code os imprime sem se conectar ao servidor:

254 254

255* ``⏸ Pending approval (run `claude` to approve)``: um servidor com escopo de projeto do `.mcp.json` que você ainda não aprovou. O Claude Code o mostra tanto em `claude mcp list` quanto em `claude mcp get <name>`. Execute `claude` interativamente para revisá-lo e aprová-lo.255* ``⏸ Pending approval (run `claude` to approve)``: um servidor com escopo de projeto de `.mcp.json` que você ainda não aprovou. O Claude Code o mostra tanto em `claude mcp list` quanto em `claude mcp get <name>`. Execute `claude` interativamente para revisá-lo e aprová-lo.

256* `✘ Rejected (see disabledMcpjsonServers in settings)`: um servidor `.mcp.json` que uma entrada [`disabledMcpjsonServers`](https://code.claude.com/docs/pt/settings-reference#disabledmcpjsonservers) rejeita. Claude Code o mostra apenas em `claude mcp get <name>`.256* `✘ Rejected (see disabledMcpjsonServers in settings)`: um servidor `.mcp.json` que uma entrada [`disabledMcpjsonServers`](https://code.claude.com/docs/pt/settings-reference#disabledmcpjsonservers) rejeita. Claude Code o mostra apenas em `claude mcp get <name>`.

257* `⊘ Disabled for this project (re-enable via /mcp)`: um servidor que a lista [`disabledMcpServers`](#disable-a-server-without-removing-it) do projeto nomeia. Claude Code o mostra em `claude mcp list` e `claude mcp get <name>`. Ative o servidor novamente no painel `/mcp`.257* `⊘ Disabled for this project (re-enable via /mcp)`: um servidor que a lista [`disabledMcpServers`](#disable-a-server-without-removing-it) do projeto nomeia. Claude Code o mostra em `claude mcp list` e `claude mcp get <name>`. Ative o servidor novamente no painel `/mcp`.

258* `✘ Blocked by enterprise managed policy`: um servidor que uma das políticas da sua organização recusa. O Claude Code o mostra tanto em `claude mcp list` quanto em `claude mcp get <name>`. Um servidor bloqueado por uma allowlist, uma denylist ou outra restrição na [configuração MCP gerenciada](https://code.claude.com/docs/pt/managed-mcp.md#how-restrictions-appear-to-users) fica oculto em ambos os comandos em vez de ser mostrado com esse status. Pergunte ao seu administrador qual política bloqueia o servidor.258* `✘ Blocked by enterprise managed policy`: um servidor que uma das políticas da sua organização recusa. O Claude Code o mostra tanto em `claude mcp list` quanto em `claude mcp get <name>`. Um servidor bloqueado por uma allowlist, uma denylist ou outra restrição na [configuração MCP gerenciada](https://code.claude.com/docs/pt/managed-mcp.md#how-restrictions-appear-to-users) fica oculto em ambos os comandos em vez de ser mostrado com esse status. Pergunte ao seu administrador qual política bloqueia o servidor.

306 306

307O painel `/mcp` mostra a contagem de ferramentas ao lado de cada servidor conectado e sinaliza servidores que anunciam a capacidade de ferramentas mas não expõem ferramentas.307O painel `/mcp` mostra a contagem de ferramentas ao lado de cada servidor conectado e sinaliza servidores que anunciam a capacidade de ferramentas mas não expõem ferramentas.

308 308

309##### Contagens de ferramentas em uma sessão na nuvem

310

311Em uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), uma contagem como `3 of 13 tools available` significa que o Claude não pode usar as outras 10. Verifique estas causas, entre outras:

312

313* **Uma regra de negação no `.claude/settings.json` do seu repositório nomeia a ferramenta ou todo o seu servidor**: remova a [regra](https://code.claude.com/docs/pt/permissions.md#mcp), se [sua sessão lê esse arquivo](https://code.claude.com/docs/pt/settings.md#settings-in-cloud-sessions)

314* **O nome completo da ferramenta tem mais de 128 caracteres**: siga [as etapas para um nome longo demais](https://code.claude.com/docs/pt/errors.md#mcp-tool-name-over-128-characters)

315* **O servidor lista a ferramenta para sua própria interface e não para o Claude**: se você mantém o servidor, adicione `model` ao `_meta.ui.visibility` da ferramenta para dar a ferramenta ao Claude. Caso contrário, não há nada a corrigir.

316

317##### Ferramentas de um servidor que ainda está se conectando

318

309Se sua solicitação precisa de ferramentas de um servidor que ainda está se conectando em segundo plano, Claude aguarda esse servidor antes de continuar. Como a espera acontece depende de sua configuração:319Se sua solicitação precisa de ferramentas de um servidor que ainda está se conectando em segundo plano, Claude aguarda esse servidor antes de continuar. Como a espera acontece depende de sua configuração:

310 320

311* **Com [busca de ferramentas](#scale-with-mcp-tool-search), o padrão**: a espera acontece dentro da chamada `ToolSearch`.321* **Com [busca de ferramentas](#scale-with-mcp-tool-search), o padrão**: a espera acontece dentro da chamada `ToolSearch`.

349* Falha em um [login OAuth MCP](#authenticate-with-remote-mcp-servers) cuja resposta de autorização nomeia um emissor inesperado.359* Falha em um [login OAuth MCP](#authenticate-with-remote-mcp-servers) cuja resposta de autorização nomeia um emissor inesperado.

350* Envia [credenciais OAuth MCP](#authenticate-with-remote-mcp-servers) apenas para um endpoint de token servido sobre HTTPS ou em `localhost`, `127.0.0.1`, ou `::1`. O login falha para um servidor cujo endpoint de token é `http://` simples em qualquer outro lugar, como um dispositivo em sua rede local. Veja [Refusing to send credentials to non-https token endpoint](https://code.claude.com/docs/pt/errors.md#refusing-to-send-credentials-to-non-https-token-endpoint).360* Envia [credenciais OAuth MCP](#authenticate-with-remote-mcp-servers) apenas para um endpoint de token servido sobre HTTPS ou em `localhost`, `127.0.0.1`, ou `::1`. O login falha para um servidor cujo endpoint de token é `http://` simples em qualquer outro lugar, como um dispositivo em sua rede local. Veja [Refusing to send credentials to non-https token endpoint](https://code.claude.com/docs/pt/errors.md#refusing-to-send-credentials-to-non-https-token-endpoint).

351 361

352Anthropic pode manter um servidor específico no protocolo anterior, ou fora desse stream, com um sinalizador de recurso que Claude Code busca.362A Anthropic pode manter um servidor específico no protocolo anterior, ou fora desse stream, com uma feature flag que o Claude Code busca. Para escolher o runtime você mesmo, defina [`MCP_SDK_GENERATION`](https://code.claude.com/docs/pt/env-vars) como `v1` ou `v2`.

353 363

354Para escolher o tempo de execução você mesmo, defina [`MCP_SDK_GENERATION`](https://code.claude.com/docs/pt/env-vars) como `v1` ou `v2`. Para decidir se Claude Code pergunta, defina [`MCP_PROTOCOL_NEGOTIATION`](https://code.claude.com/docs/pt/env-vars) como `auto` ou `legacy`.364Para decidir se o Claude Code pergunta aos servidores sobre a revisão mais recente, defina [`MCP_PROTOCOL_NEGOTIATION`](https://code.claude.com/docs/pt/env-vars) como `auto` ou `legacy`. Com essa variável não definida, o Claude Code pode deixar de perguntar a um servidor stdio por 7 dias, por exemplo depois que o servidor sai quando perguntado. Para que um servidor atualizado seja perguntado mais cedo, defina `auto`.

355 365

356### Atualizações dinâmicas de ferramentas366### Atualizações dinâmicas de ferramentas

357 367

mobile.md +1 −1

Details

66 66

67### Obtenha notificações push67### Obtenha notificações push

68 68

69Quando Remote Control está ativo, Claude pode enviar notificações push para seu telefone, normalmente quando uma tarefa de longa duração termina ou quando precisa de uma decisão sua. Você também pode solicitar uma em seu prompt, como `notify me when the tests finish`. Consulte [notificações push móveis](https://code.claude.com/docs/pt/remote-control.md#mobile-push-notifications) para os dois toggles `/config` e solução de problemas de entrega.69Quando Remote Control está ativo, Claude pode enviar notificações push para seu telefone quando uma tarefa de longa duração termina ou quando precisa de uma decisão sua. Você também pode solicitar uma em seu prompt, como `notify me when the tests finish`. Consulte [notificações push móveis](https://code.claude.com/docs/pt/remote-control.md#mobile-push-notifications) para os dois toggles `/config` e solução de problemas de entrega.

70 70

71Dispatch envia sua própria notificação quando uma sessão Code que ele gerou termina ou precisa de sua aprovação, descrito em [sessões do Dispatch](https://code.claude.com/docs/pt/desktop.md#sessions-from-dispatch).71Dispatch envia sua própria notificação quando uma sessão Code que ele gerou termina ou precisa de sua aprovação, descrito em [sessões do Dispatch](https://code.claude.com/docs/pt/desktop.md#sessions-from-dispatch).

72 72

model-config.md +10 −1

Details

566* Se ambos os modelos sinalizarem a mesma requisição, você pode editar o prompt e tentar novamente ou iniciar uma nova sessão.566* Se ambos os modelos sinalizarem a mesma requisição, você pode editar o prompt e tentar novamente ou iniciar uma nova sessão.

567* Em [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) no aplicativo móvel, edição e nova tentativa não são suportadas. Alterne modelos ou continue a sessão de um navegador de desktop ou do aplicativo de desktop.567* Em [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) no aplicativo móvel, edição e nova tentativa não são suportadas. Alterne modelos ou continue a sessão de um navegador de desktop ou do aplicativo de desktop.

568* Em [modo não interativo](https://code.claude.com/docs/pt/cli-reference.md#cli-flags) e integrações SDK que não podem mostrar o prompt, uma requisição sinalizada termina o turno com uma recusa.568* Em [modo não interativo](https://code.claude.com/docs/pt/cli-reference.md#cli-flags) e integrações SDK que não podem mostrar o prompt, uma requisição sinalizada termina o turno com uma recusa.

569* Em um [subagente](https://code.claude.com/docs/pt/sub-agents.md), Claude Code não mostra o prompt, e uma requisição sinalizada que alternaria modelos é executada novamente no modelo de fallback.569* Em um subagente que Claude inicia com a [ferramenta Agent](https://code.claude.com/docs/pt/tools-reference.md#agent-tool-behavior), Claude Code não pausa para perguntar, e o subagente falha em vez de alternar modelos. Consulte [Subagentes alternam ou falham sem perguntar](#subagents-switch-or-fail-without-asking).

570* Quando o destino de fallback é bloqueado por [`availableModels`](#restrict-model-selection), Claude Code não mostra o prompt. A requisição sinalizada termina com a recusa, o mesmo que fallback automático quando o destino é bloqueado.570* Quando o destino de fallback é bloqueado por [`availableModels`](#restrict-model-selection), Claude Code não mostra o prompt. A requisição sinalizada termina com a recusa, o mesmo que fallback automático quando o destino é bloqueado.

571 571

572#### Subagentes alternam ou falham sem perguntar

573

574Em um [subagente](https://code.claude.com/docs/pt/sub-agents.md) integrado ou personalizado que Claude inicia com a [ferramenta Agent](https://code.claude.com/docs/pt/tools-reference.md#agent-tool-behavior), Claude Code não [pausa para perguntar](#ask-before-switching) em uma requisição sinalizada. Se um modelo de fallback estiver disponível, a requisição é executada novamente nele ou o subagente falha, de acordo com sua escolha em **Switch models when a message is flagged** em `/config`:

575

576* **Switch automatically**, ou nenhuma escolha ainda: a requisição é executada novamente no modelo de fallback, e o modelo da sua sessão permanece inalterado

577* **Ask each time**: o subagente falha com [`Agent terminated early due to an API error`](https://code.claude.com/docs/pt/errors#agent-terminated-early-due-to-an-api-error) e a mensagem de recusa. Claude recebe esse erro e decide o que fazer com a tarefa inacabada. Para permitir que subagentes alternem modelos, escolha **Switch automatically**. Sua conversa principal então também alterna sem perguntar.

578

579Quando nenhum modelo de fallback está disponível, o subagente falha da mesma forma com qualquer uma das escolhas. Antes da v2.1.318, a requisição sinalizada de um subagente era executada novamente em um modelo de fallback disponível, qualquer que fosse sua escolha.

580

572#### Ativar fallback no Bedrock, Agent Platform e Foundry581#### Ativar fallback no Bedrock, Agent Platform e Foundry

573 582

574No [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/pt/google-vertex-ai.md) e [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md), IDs de modelo são específicos do provedor, portanto o fallback automático opera apenas quando Claude Code pode identificar cada modelo envolvido:583No [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/pt/google-vertex-ai.md) e [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md), IDs de modelo são específicos do provedor, portanto o fallback automático opera apenas quando Claude Code pode identificar cada modelo envolvido:

network-config.md +7 −0

Details

89export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem89export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

90```90```

91 91

92Se você vir algum destes avisos, o Claude Code não conseguiu carregar o arquivo `NODE_EXTRA_CA_CERTS` por completo, e conexões que precisam de um certificado ignorado por ele podem falhar:

94* `Claude Code used only the certificates that it could read in full from the NODE_EXTRA_CA_CERTS file`

95* `Claude Code ignored all of the NODE_EXTRA_CA_CERTS file: it holds no certificate that Claude Code can read`

97O texto completo de cada aviso explica como corrigir o arquivo. Um certificado ignorado que também esteja no [repositório de certificados CA](#ca-certificate-store) continua funcionando.

92## Autenticação mTLS99## Autenticação mTLS

93 100

94Para ambientes corporativos que exigem autenticação por certificado de cliente:101Para ambientes corporativos que exigem autenticação por certificado de cliente:

permission-modes.md +4 −6

Details

154 154

155### Modos de permissão com a configuração HIPAA155### Modos de permissão com a configuração HIPAA

156 156

157Em uma organização com a [configuração HIPAA](https://code.claude.com/docs/pt/hipaa-setup.md) aplicada, o padrão integrado `auto` não se aplica. Uma sessão de terminal ou do VS Code inicia no modo Manual quando nada mais escolhe seu modo de permissão inicial. Uma sessão de terminal também mostra `Auto mode isn't the default for your organization · Shift+Tab to switch`, e a extensão VS Code não mostra nenhum aviso. [Verifique como os desenvolvedores fazem login e se conectam](https://code.claude.com/docs/pt/hipaa-setup.md#check-how-developers-sign-in-and-connect) lista as sessões às quais isso se aplica.157Em uma organização com a [configuração HIPAA](https://code.claude.com/docs/pt/hipaa-setup.md) aplicada, o [padrão integrado `auto`](#which-mode-a-session-starts-in) não se aplica. Uma sessão de terminal ou do VS Code inicia no modo Manual quando nada mais escolhe seu modo de permissão inicial. Uma sessão de terminal também mostra `Auto mode isn't the default for your organization · Shift+Tab to switch`, e a extensão VS Code não mostra nenhum aviso. [Verifique como os desenvolvedores fazem login e se conectam](https://code.claude.com/docs/pt/hipaa-setup.md#check-how-developers-sign-in-and-connect) lista as sessões às quais isso se aplica.

158 158

159O modo auto e `bypassPermissions` continuam disponíveis:159O modo auto e `bypassPermissions` continuam disponíveis:

160 160

163* **Remover o modo auto**: defina [`permissions.disableAutoMode`](https://code.claude.com/docs/pt/settings-reference#disableautomode) como `"disable"` em configurações gerenciadas163* **Remover o modo auto**: defina [`permissions.disableAutoMode`](https://code.claude.com/docs/pt/settings-reference#disableautomode) como `"disable"` em configurações gerenciadas

164* **Bloquear `bypassPermissions`**: defina [`permissions.disableBypassPermissionsMode`](https://code.claude.com/docs/pt/settings-reference#permissions-disablebypasspermissionsmode) como `"disable"` em configurações gerenciadas164* **Bloquear `bypassPermissions`**: defina [`permissions.disableBypassPermissionsMode`](https://code.claude.com/docs/pt/settings-reference#permissions-disablebypasspermissionsmode) como `"disable"` em configurações gerenciadas

165 165

166Requer Claude Code v2.1.285 ou posterior, a [versão mínima para a configuração HIPAA](https://code.claude.com/docs/pt/hipaa-setup.md#update-claude-code-and-claude-desktop).

~~167~~

168## Alternar modos de permissão166## Alternar modos de permissão

169 167

170Cada interface tem seu próprio controle para alternar modos de permissão durante uma sessão e sua própria forma de escolher o modo de permissão que novas sessões iniciam. Selecione sua interface para ver seus controles.168Cada interface tem seu próprio controle para alternar modos de permissão durante uma sessão e sua própria forma de escolher o modo de permissão que novas sessões iniciam. Selecione sua interface para ver seus controles.

253>251>

254> Em [claude.ai/code](https://claude.ai/code), use o dropdown de modo na linha abaixo da caixa de prompt. No aplicativo móvel, toque no botão **+** na caixa de prompt e depois em **Permission**. Sessões na nuvem e sessões de Remote Control oferecem modos de permissão diferentes:252> Em [claude.ai/code](https://claude.ai/code), use o dropdown de modo na linha abaixo da caixa de prompt. No aplicativo móvel, toque no botão **+** na caixa de prompt e depois em **Permission**. Sessões na nuvem e sessões de Remote Control oferecem modos de permissão diferentes:

255>253>

256> * **[Sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md)**: Accept edits, Plan e Auto. Accept edits corresponde ao modo `default`: sessões na nuvem pré-aprovam edições de arquivo independentemente do modo, então o dropdown mostra Accept edits em vez de Manual. Sessões na nuvem ainda honram `defaultMode: "acceptEdits"` de configurações. O modo Auto aparece apenas quando sua organização o permite e o modelo selecionado o suporta. Bypass permissions não está disponível.254> * **[Sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md)**: Accept edits, Plan e Auto. Accept edits corresponde ao modo `default`: sessões na nuvem pré-aprovam edições de arquivo independentemente do modo, então o dropdown mostra Accept edits em vez de Manual. Sessões na nuvem ainda honram `defaultMode: "acceptEdits"` de configurações. O modo Auto aparece a menos que sua organização o desative e, no claude.ai/code, fica esmaecido se o modelo selecionado não [o suportar](#eliminate-prompts-with-auto-mode). Bypass permissions não está disponível.

257> * **[Sessões de Remote Control](https://code.claude.com/docs/pt/remote-control.md)** em sua máquina local: Manual, Accept edits, Plan e Auto para uma sessão que você mesmo iniciou, e você não pode selecionar Bypass permissions do aplicativo. Para usar Auto, a sessão precisa atender aos [requisitos de disponibilidade](#eliminate-prompts-with-auto-mode) do modo auto. Para um thread de projeto executado em seu computador, veja [Execute um thread em seu próprio computador](https://code.claude.com/docs/pt/claude-projects.md#run-a-thread-on-your-own-computer).255> * **[Sessões de Remote Control](https://code.claude.com/docs/pt/remote-control.md)** em sua máquina local: Manual, Accept edits, Plan e Auto para uma sessão que você mesmo iniciou, e você não pode selecionar Bypass permissions do aplicativo. Para usar Auto, a sessão precisa atender aos [requisitos de disponibilidade](#eliminate-prompts-with-auto-mode) do modo auto. Para um thread de projeto executado em seu computador, veja [Execute um thread em seu próprio computador](https://code.claude.com/docs/pt/claude-projects.md#run-a-thread-on-your-own-computer).

258> * Exceto por Bypass permissions, o dropdown mostra o modo de permissão em que a sessão local está, incluindo um definido do terminal. Ele atualiza quando o modo de permissão muda no aplicativo ou no terminal.256> * Exceto por Bypass permissions, o dropdown mostra o modo de permissão em que a sessão local está, incluindo um definido do terminal. Ele atualiza quando o modo de permissão muda no aplicativo ou no terminal.

259> * Sessões hospedadas pelo [aplicativo de desktop](https://code.claude.com/docs/pt/desktop.md) ou pela [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) relatam mudanças de modo de permissão ao claude.ai conforme acontecem, da mesma forma que sessões hospedadas em um terminal.257> * Sessões hospedadas pelo [aplicativo de desktop](https://code.claude.com/docs/pt/desktop.md) ou pela [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) relatam mudanças de modo de permissão ao claude.ai conforme acontecem, da mesma forma que sessões hospedadas em um terminal.

433claude --permission-mode auto --debug-file classifier-debug.log431claude --permission-mode auto --debug-file classifier-debug.log

434```432```

435 433

436Peça a Claude para executar um comando de shell que não seja somente leitura e, em seguida, pesquise no log por `classifier_request_started`:434Para dar ao classificador um comando para revisar, peça a Claude para executar `curl https://example.com` e, em seguida, pesquise no log por `classifier_request_started`:

437 435

438* **Seu modelo após `model=`**: a variável entrou em vigor436* **Seu modelo após `model=`**: a variável entrou em vigor

439* **Um modelo diferente após `model=`**: pesquise no log por `ignoring CLAUDE_CODE_AUTO_MODE_MODEL`, que dá o motivo e qualquer etapa a seguir437* **Um modelo diferente após `model=`**: pesquise no log por `ignoring CLAUDE_CODE_AUTO_MODE_MODEL`, que dá o motivo e qualquer etapa a seguir

440* **Nenhuma linha assim**: leia `Auto mode server` em `/status` no prompt de Claude Code:438* **Nenhuma linha assim**: leia `Auto mode server` em `/status` no prompt de Claude Code:

441 * **`Enabled`**: o [servidor](#server-side-classifier-review) está configurado para revisar as chamadas desta sessão.439 * **`Enabled`**: o [servidor](#server-side-classifier-review) está configurado para revisar as chamadas desta sessão.

442 * **`Disabled`**: certifique-se de que o [modo de permissão](#switch-permission-modes) é auto e, em seguida, peça a Claude para executar outro comando que não seja somente leitura.440 * **`Disabled`**: esta verificação ainda não testou o seu modelo. Certifique-se de que o [modo de permissão](#switch-permission-modes) é auto e de que nenhuma [regra de permissão](https://code.claude.com/docs/pt/permissions.md#manage-permissions) corresponde a `curl` e, em seguida, execute a verificação novamente com o [sandbox](https://code.claude.com/docs/pt/sandboxing.md) desativado.

443 441

444### O que o classificador bloqueia por padrão442### O que o classificador bloqueia por padrão

445 443

permissions.md +7 −4

Details

338 338

339#### O que as regras `Read` e `Edit` cobrem339#### O que as regras `Read` e `Edit` cobrem

340 340

341As regras `Edit` se aplicam a todas as ferramentas integradas que editam arquivos. Claude faz uma tentativa de melhor esforço para aplicar regras `Read` a todas as ferramentas integradas que leem arquivos como Grep e Glob, a menções `@file` em seus prompts, e à seleção e contexto de arquivo aberto que um [IDE](https://code.claude.com/docs/pt/vs-code.md#the-built-in-ide-mcp-server) conectado compartilha com Claude.341As regras `Edit` se aplicam a todas as ferramentas integradas que editam arquivos. Claude faz uma tentativa de melhor esforço para aplicar regras deny `Read(path)` a todas as ferramentas integradas que leem arquivos como Grep e Glob. Ele faz a mesma tentativa de aplicar regras deny `Read(path)` a menções `@file` em seus prompts e à seleção e contexto de arquivo aberto que um [IDE](https://code.claude.com/docs/pt/vs-code.md#the-built-in-ide-mcp-server) conectado compartilha com Claude.

342 342

343Uma regra deny `Read(path)` também se aplica a caminhos de imagem que você cola em um prompt e a diretórios que você menciona com @:343Uma regra deny `Read(path)` também se aplica a caminhos de imagem que você cola em um prompt e a diretórios que você menciona com @:

344 344

353>353>

354> As regras deny de Read e Edit se aplicam às ferramentas de arquivo integradas do Claude, aos comandos de arquivo que Claude Code reconhece em Bash, como `cat`, `head`, `tail`, `sed` e `tee`, e aos alvos de [redirecionamentos](#redirections) Bash como `> file` e `< file`. Elas não se aplicam a um comando que lê arquivos sem nomeá-los, como `grep -r pattern .` executado a partir do diretório que contém o arquivo, ou a subprocessos arbitrários que leem ou escrevem arquivos indiretamente, como um script Python ou Node que abre arquivos por conta própria. Para imposição em nível de SO que bloqueia todos os processos de acessar um caminho, [ative o sandbox](https://code.claude.com/docs/pt/sandboxing.md).354> As regras deny de Read e Edit se aplicam às ferramentas de arquivo integradas do Claude, aos comandos de arquivo que Claude Code reconhece em Bash, como `cat`, `head`, `tail`, `sed` e `tee`, e aos alvos de [redirecionamentos](#redirections) Bash como `> file` e `< file`. Elas não se aplicam a um comando que lê arquivos sem nomeá-los, como `grep -r pattern .` executado a partir do diretório que contém o arquivo, ou a subprocessos arbitrários que leem ou escrevem arquivos indiretamente, como um script Python ou Node que abre arquivos por conta própria. Para imposição em nível de SO que bloqueia todos os processos de acessar um caminho, [ative o sandbox](https://code.claude.com/docs/pt/sandboxing.md).

355 355

356#### Regras `Write(path)`, `NotebookEdit(path)` e `Glob(path)` nunca correspondem356#### Regras `Write(path)`, `Glob(path)` e `Grep(path)` não correspondem

357 357

358Claude Code verifica permissões de arquivo apenas contra regras `Edit(path)` e `Read(path)`. Se você escrever uma regra de caminho para `Write`, `NotebookEdit`, `Glob` ou a ferramenta legada `MultiEdit`, Claude Code aceita a regra mas nunca corresponde uma leitura ou edição a ela.358Claude Code verifica permissões de arquivo contra regras `Edit(path)` e `Read(path)`. Ele aceita uma regra com um caminho diferente de `*` para uma das ferramentas abaixo, mas não corresponde uma leitura, pesquisa ou edição a ela. Uma regra deny `Grep(docs/**)` não impede Grep de pesquisar `docs`. Escreva a regra `Edit` ou `Read` no lugar dela:

359 359

360Use `Edit(docs/**)` no lugar de `Write(docs/**)`, `NotebookEdit(docs/**)` ou `MultiEdit(docs/**)`, e `Read(docs/**)` no lugar de `Glob(docs/**)`. Para corresponder a cada uso da ferramenta Write, NotebookEdit ou Glob independentemente do caminho, escreva apenas o nome da ferramenta.360* **`Write`, `NotebookEdit` ou a legada `MultiEdit`**: use `Edit(docs/**)` no lugar de `Write(docs/**)`.

361* **`Glob` ou `Grep`**: use `Read(docs/**)` no lugar de `Grep(docs/**)`. Como uma regra ask, `Read(docs/**)` solicita quando Claude chama Grep ou Glob em um caminho correspondente, mas não quando uma pesquisa de um diretório de trabalho acima dele retorna arquivos correspondentes.

362

363Para corresponder a cada uso de uma dessas ferramentas independentemente do caminho, [escreva apenas o nome da ferramenta](#match-all-uses-of-a-tool).

361 364

362#### Como os padrões de caminho correspondem365#### Como os padrões de caminho correspondem

363 366

plugins/cli-reference.md +11 −1

Details

608 608

609#### Validar um diretório609#### Validar um diretório

610 610

611O `<path>` é um arquivo de manifesto ou um diretório. Dado um diretório, Claude Code escolhe o que validar pelo que encontra lá:611O `<path>` é um [arquivo de manifesto](#validate-a-manifest-file) ou um diretório. Dado um diretório, Claude Code escolhe o que validar pelo que encontra lá:

612 612

613* `.claude-plugin/marketplace.json`, quando existe613* `.claude-plugin/marketplace.json`, quando existe

614* Caso contrário `.claude-plugin/plugin.json`614* Caso contrário `.claude-plugin/plugin.json`

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

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

633 633

634#### Validar um arquivo de manifesto

635

636Quando o arquivo não se chama `plugin.json` ou `marketplace.json` e não está em um diretório `.claude-plugin`, Claude Code decide o que ele é por seus campos. Ele valida o arquivo como um marketplace nestes casos e, caso contrário, como um manifesto de plugin:

637

638* `plugins` é um array

639* `plugins` e `owner` estão ambos presentes

640* O arquivo tem um campo que apenas `marketplace.json` define, como `owner`, e nenhum que apenas `plugin.json` define, como `author`

641

642Para escolher as verificações você mesmo, nomeie o arquivo `plugin.json` ou `marketplace.json`. Claude Code valida qualquer outro arquivo em um diretório `.claude-plugin` como um manifesto de plugin.

643

634#### Saída e códigos de saída644#### Saída e códigos de saída

635 645

636Claude Code imprime o arquivo que validou, quaisquer erros e avisos com seus caminhos, e uma linha de veredicto. O código de saída segue o veredicto:646Claude Code imprime o arquivo que validou, quaisquer erros e avisos com seus caminhos, e uma linha de veredicto. O código de saída segue o veredicto:

plugins/marketplace-reference.md +1 −1

Details

455 455

456## Validation messages456## Validation messages

457 457

458`claude plugin validate <path>` leva a raiz do marketplace ou o próprio arquivo marketplace. Ele imprime erros e avisos. Para códigos de saída e `--strict`, veja [plugin validate](https://code.claude.com/docs/pt/plugins/cli-reference.md#plugin-validate).458`claude plugin validate <path>` leva a raiz do marketplace ou o próprio arquivo marketplace. Para que esse arquivo seja [validado como um marketplace](https://code.claude.com/docs/pt/plugins/cli-reference.md#validate-a-manifest-file) em vez de um manifesto de plugin, nomeie-o como `marketplace.json`. Para códigos de saída e `--strict`, veja [plugin validate](https://code.claude.com/docs/pt/plugins/cli-reference.md#plugin-validate).

459 459

460Uma mensagem nomeia uma entrada de plugin por seu índice, escrito como `plugins.1.source` ou `plugins[1].source`.460Uma mensagem nomeia uma entrada de plugin por seu índice, escrito como `plugins.1.source` ou `plugins[1].source`.

461 461

prompt-caching.md +1 −1

Details

103O [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) e a velocidade padrão mantêm caches separados, então depois que você ativa ou desativa o modo rápido, a próxima requisição não pode usar o que a outra velocidade armazenou em cache. Na primeira vez que você ativa o modo rápido em uma conversa, a próxima requisição lê toda a conversa até então sem cache, com as [tarifas do modo rápido](https://code.claude.com/docs/pt/fast-mode.md#understand-the-cost-tradeoff). Para manter esse custo baixo, ative-o no início de uma sessão.103O [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) e a velocidade padrão mantêm caches separados, então depois que você ativa ou desativa o modo rápido, a próxima requisição não pode usar o que a outra velocidade armazenou em cache. Na primeira vez que você ativa o modo rápido em uma conversa, a próxima requisição lê toda a conversa até então sem cache, com as [tarifas do modo rápido](https://code.claude.com/docs/pt/fast-mode.md#understand-the-cost-tradeoff). Para manter esse custo baixo, ative-o no início de uma sessão.

104 104

105* Se você ativá-lo enquanto Claude está trabalhando, esse turno termina na velocidade padrão, e você paga por qualquer leitura sem cache na primeira requisição do seu próximo turno.105* Se você ativá-lo enquanto Claude está trabalhando, esse turno termina na velocidade padrão, e você paga por qualquer leitura sem cache na primeira requisição do seu próximo turno.

106* Se seu modelo atual não suportar o modo rápido, habilitar o modo rápido também [muda você para o Opus](https://code.claude.com/docs/pt/fast-mode.md#toggle-fast-mode). Essa [mudança de modelo](#switching-models) inicia um cache novo por conta própria a partir da próxima requisição no turno em execução.106* Se seu modelo atual não suportar o modo rápido, executar `/fast` também [muda você para o Opus](https://code.claude.com/docs/pt/fast-mode.md#toggle-fast-mode). Essa [mudança de modelo](#switching-models) inicia um cache novo por conta própria a partir da próxima requisição no turno em execução.

107 107

108Cada alternância posterior lê sem cache tudo o que a velocidade para a qual você muda não tem em cache. Mudanças de velocidade que Claude Code faz por conta própria, como o [fallback para a velocidade padrão](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits) após um rate limit e o retorno ao modo rápido depois, também contam como alternâncias.108Cada alternância posterior lê sem cache tudo o que a velocidade para a qual você muda não tem em cache. Mudanças de velocidade que Claude Code faz por conta própria, como o [fallback para a velocidade padrão](https://code.claude.com/docs/pt/fast-mode.md#handle-rate-limits) após um rate limit e o retorno ao modo rápido depois, também contam como alternâncias.

109 109

remote-control.md +3 −1

Details

147* **This session was ended or archived from another device or app**: execute `/remote-control` apenas se você quiser a sessão de volta. Claude Code reabre uma sessão arquivada.147* **This session was ended or archived from another device or app**: execute `/remote-control` apenas se você quiser a sessão de volta. Claude Code reabre uma sessão arquivada.

148* **The server no longer reports this session**: ela pode ter sido excluída de outro dispositivo ou aplicativo.148* **The server no longer reports this session**: ela pode ter sido excluída de outro dispositivo ou aplicativo.

149 149

150Se `/remote-control` abrir um diálogo que diz `Remote Control isn't connected.`, siga a etapa que o diálogo indica, como executar `/login` ou selecionar **Continue** e tentar novamente.

151

150### Conectar de outro dispositivo152### Conectar de outro dispositivo

151 153

152Depois que uma sessão de Remote Control está ativa, você tem algumas maneiras de conectar de outro dispositivo:154Depois que uma sessão de Remote Control está ativa, você tem algumas maneiras de conectar de outro dispositivo:

318 320

319Quando o Remote Control está ativo, Claude pode enviar notificações push para seu telefone.321Quando o Remote Control está ativo, Claude pode enviar notificações push para seu telefone.

320 322

321Claude decide quando fazer push. Normalmente envia uma quando uma tarefa de longa duração termina ou quando precisa de uma decisão sua para continuar. Você também pode solicitar um push em seu prompt, por exemplo `notify me when the tests finish`. Além dos dois toggles on/off abaixo, não há configuração por evento.323Um push pode chegar quando uma tarefa de longa duração termina ou quando Claude precisa de uma decisão sua. Você também pode solicitar um push em seu prompt, por exemplo `notify me when the tests finish`. Além dos dois toggles on/off abaixo, não há configuração por evento.

322 324

323Para configurar notificações push móveis:325Para configurar notificações push móveis:

324 326

sandbox-environments.md +8 −3

Details

25| [Dev container](#dev-containers) | Ambiente de desenvolvimento completo | Sim | Médio |25| [Dev container](#dev-containers) | Ambiente de desenvolvimento completo | Sim | Médio |

26| [Custom container](#custom-container) | Ambiente de desenvolvimento completo | Sim | Médio a alto |26| [Custom container](#custom-container) | Ambiente de desenvolvimento completo | Sim | Médio a alto |

27| [Virtual machine](#virtual-machine) | Sistema operacional completo | Não | Alto |27| [Virtual machine](#virtual-machine) | Sistema operacional completo | Não | Alto |

~~28| [Cloud sessions](#cloud-sessions) | Full operating system, hosted by Anthropic | No | None; requires a Claude subscription, and a connected GitHub account unless you launch with `claude --cloud` |~~28| [Sessões na nuvem](#cloud-sessions) | Sistema operacional completo, hospedado pela Anthropic | Não | Nenhum; requer uma assinatura do Claude e uma conta do GitHub conectada para clonar um repositório do GitHub |

29 29

30A [sandboxed Bash tool](https://code.claude.com/docs/pt/sandboxing.md) é integrada ao Claude Code e restringe apenas comandos Bash. As ferramentas de arquivo integradas, servidores MCP e hooks ainda são executados diretamente no seu host. Todas as outras abordagens na tabela colocam todo o processo do Claude Code dentro do limite de isolamento, portanto ferramentas de arquivo, servidores MCP e hooks também são restritos.30A [sandboxed Bash tool](https://code.claude.com/docs/pt/sandboxing.md) é integrada ao Claude Code e restringe apenas comandos Bash. As ferramentas de arquivo integradas, servidores MCP e hooks ainda são executados diretamente no seu host. Todas as outras abordagens na tabela colocam todo o processo do Claude Code dentro do limite de isolamento, portanto ferramentas de arquivo, servidores MCP e hooks também são restritos.

31 31

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

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

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

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

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

51| Trabalhar em um host Windows nativo | Um container ou VM, ou executar o sandbox Bash dentro do WSL2 |51| Trabalhar em um host Windows nativo | Um container ou VM, ou executar o sandbox Bash dentro do WSL2 |

52 52

165 165

166Uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) é executada em uma máquina virtual isolada e gerenciada pela Anthropic. Um proxy de rede impõe uma lista de permissões padrão, e um proxy separado mantém seu token GitHub fora do sandbox enquanto emite credenciais com escopo para acesso ao repositório dentro dele. As sessões que sua organização roteia para um [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments) são executadas na infraestrutura que você provisiona, onde isolamento, controle de saída e credenciais git são responsabilidade da sua implantação.166Uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) é executada em uma máquina virtual isolada e gerenciada pela Anthropic. Um proxy de rede impõe uma lista de permissões padrão, e um proxy separado mantém seu token GitHub fora do sandbox enquanto emite credenciais com escopo para acesso ao repositório dentro dele. As sessões que sua organização roteia para um [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments) são executadas na infraestrutura que você provisiona, onde isolamento, controle de saída e credenciais git são responsabilidade da sua implantação.

167 167

168Use esta abordagem quando você quer isolamento completo de VM sem provisionar infraestrutura você mesmo, ou quando você está delegando tarefas de um dispositivo que não tem um ambiente de desenvolvimento local. Requer uma assinatura Claude. A menos que você inicie a partir da CLI, você também precisa de uma conta GitHub conectada para que o sandbox possa clonar seu repositório. Quando você inicia a partir da CLI com `--cloud`, Claude Code pode [agrupar e fazer upload do seu repositório local](https://code.claude.com/docs/pt/claude-code-on-the-web.md#send-local-repositories-without-github) em vez disso. Consulte [Usar Claude Code na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) para disponibilidade de plano e opções de autenticação GitHub.168Use esta abordagem quando você quer isolamento completo de VM sem provisionar infraestrutura você mesmo, ou quando você está delegando tarefas de um dispositivo que não tem um ambiente de desenvolvimento local. Requer:

169

170* **Assinatura**: uma assinatura Claude

171* **GitHub**: uma conta GitHub conectada para trabalhar em um repositório GitHub. Quando você inicia a partir da CLI com `--cloud`, você não precisa de uma se Claude Code [agrupar e fizer upload do seu repositório local](https://code.claude.com/docs/pt/claude-code-on-the-web.md#send-local-repositories-without-github)

172

173Consulte [Usar Claude Code na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) para disponibilidade de plano e opções de autenticação GitHub.

169 174

170## Enforce isolation across an organization175## Enforce isolation across an organization

171 176

self-hosted-environments-configuration.md +12 −3

Details

46| `CLAUDE_CODE_REMOTE_SLACK_CHANNEL_ID` | Para uma sessão do Claude Tag, o ID do canal do Slack ou da mensagem direta que a sessão atende ou em que sua thread está, como `C0123ABCDE`. Um timestamp do Slack identifica uma mensagem dentro de um único canal, então registre este ID junto com `CLAUDE_CODE_REMOTE_SLACK_THREAD_TS`. Não definido para outras sessões, e pode não estar definido também para uma sessão do Claude Tag. |46| `CLAUDE_CODE_REMOTE_SLACK_CHANNEL_ID` | Para uma sessão do Claude Tag, o ID do canal do Slack ou da mensagem direta que a sessão atende ou em que sua thread está, como `C0123ABCDE`. Um timestamp do Slack identifica uma mensagem dentro de um único canal, então registre este ID junto com `CLAUDE_CODE_REMOTE_SLACK_THREAD_TS`. Não definido para outras sessões, e pode não estar definido também para uma sessão do Claude Tag. |

47| `CLAUDE_SESSION_INGRESS_TOKEN_FILE` | Caminho absoluto para um arquivo por sessão contendo o JWT da sessão atual, mantido atualizado em atualizações de token. Subprocessos shell o leem para seu cabeçalho `Authorization` ao baixar anexos que o usuário adicionou à sessão. `exec` preserva a variável automaticamente; um wrapper que reconstrói o ambiente do filho deve levar a variável, ou downloads de anexos param silenciosamente de funcionar. |47| `CLAUDE_SESSION_INGRESS_TOKEN_FILE` | Caminho absoluto para um arquivo por sessão contendo o JWT da sessão atual, mantido atualizado em atualizações de token. Subprocessos shell o leem para seu cabeçalho `Authorization` ao baixar anexos que o usuário adicionou à sessão. `exec` preserva a variável automaticamente; um wrapper que reconstrói o ambiente do filho deve levar a variável, ou downloads de anexos param silenciosamente de funcionar. |

48| `CLAUDE_CONFIG_DIR` | Diretório de configuração Claude por sessão, escrito no início da sessão a partir do snapshot da configuração do host do runner que o runner captura na inicialização; consulte [Permissions and tool approval](#permissions-and-tool-approval). Escritas aqui são isoladas para esta sessão. O diretório fica sob `<base-dir>/_sessions/` após o término da sessão, a menos que você inicie o runner com [`--remove-session-state`](https://code.claude.com/docs/pt/self-hosted-environments-reference#runner-cli-flags); consulte [Reuse a pre-warmed checkout](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout). |48| `CLAUDE_CONFIG_DIR` | Diretório de configuração Claude por sessão, escrito no início da sessão a partir do snapshot da configuração do host do runner que o runner captura na inicialização; consulte [Permissions and tool approval](#permissions-and-tool-approval). Escritas aqui são isoladas para esta sessão. O diretório fica sob `<base-dir>/_sessions/` após o término da sessão, a menos que você inicie o runner com [`--remove-session-state`](https://code.claude.com/docs/pt/self-hosted-environments-reference#runner-cli-flags); consulte [Reuse a pre-warmed checkout](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout). |

49| `CLAUDE_CODE_REMOTE_MCP_CONFIG` | Caminho para um arquivo em `CLAUDE_CONFIG_DIR` contendo as definições de servidores MCP que o plano de controle da Anthropic entregou para esta sessão. Se seu wrapper reconstrói o ambiente do filho, leve esta variável junto. Sem ela, quando o plano de controle atualiza os servidores entregues, o filho encerra qualquer servidor stdio, HTTP ou SSE que seu wrapper adiciona com [`--mcp-config`](https://code.claude.com/docs/pt/cli-reference#cli-flags) que não esteja na atualização. Requer Claude Code v2.1.299 ou posterior. |49| `CLAUDE_CODE_REMOTE_MCP_CONFIG` | Caminho para um arquivo em `CLAUDE_CONFIG_DIR` contendo os servidores MCP entregues pelo plano de controle. Se seu wrapper reconstrói o ambiente do filho, leve esta variável, [`CLAUDE_CODE_REMOTE`](https://code.claude.com/docs/pt/env-vars#variables) e `CLAUDE_CODE_ENVIRONMENT_KIND` junto sem alterações; o runner define as três. Se `CLAUDE_CODE_REMOTE` chegar, mas esta variável ou `CLAUDE_CODE_ENVIRONMENT_KIND` não, o filho encerra os servidores stdio, HTTP e SSE que seu wrapper adiciona com [`--mcp-config`](https://code.claude.com/docs/pt/cli-reference#cli-flags) e que uma atualização dos servidores entregues omite. Requer Claude Code v2.1.299 ou posterior. |

50| `ANTHROPIC_BASE_URL` | A URL base da API que o filho usará, entregue pelo plano de controle por sessão e normalmente `https://api.anthropic.com`. Não a sobrescreva: a credencial de inferência da sessão é um token OAuth emitido pela Anthropic que outros provedores não aceitam. |50| `ANTHROPIC_BASE_URL` | A URL base da API que o filho usará, entregue pelo plano de controle por sessão e normalmente `https://api.anthropic.com`. Não a sobrescreva: a credencial de inferência da sessão é um token OAuth emitido pela Anthropic que outros provedores não aceitam. |

51| `CLAUDE_CODE_OAUTH_TOKEN` | O token de acesso OAuth de curta duração que o filho usa para inferência de modelo, com uma vida útil de cerca de 30 minutos. O runner o re-emite antes da expiração e entrega a rotação pela stdin do filho, então um wrapper que não [mantém stdin anexado](#keep-stdin-and-file-descriptor-3-attached) vê apenas o valor inicial. Não confie na allowlist de IP da sua organização para limitar o uso deste token: trate-o como uma credencial de portador que permanece utilizável por aproximadamente 30 minutos se vazar, e não o registre em log, não o escreva em disco nem o encaminhe para fora do contêiner da sessão. |51| `CLAUDE_CODE_OAUTH_TOKEN` | O token de acesso OAuth de curta duração que o filho usa para inferência de modelo, com uma vida útil de cerca de 30 minutos. O runner o re-emite antes da expiração e entrega a rotação pela stdin do filho, então um wrapper que não [mantém stdin anexado](#keep-stdin-and-file-descriptor-3-attached) vê apenas o valor inicial. Não confie na allowlist de IP da sua organização para limitar o uso deste token: trate-o como uma credencial de portador que permanece utilizável por aproximadamente 30 minutos se vazar, e não o registre em log, não o escreva em disco nem o encaminhe para fora do contêiner da sessão. |

52| `CLAUDE_RUNNER_ALIVE_EVERY_MS` | O runner define com que frequência, em milissegundos, o filho informa que está ativo quando um [turno começa antes de o filho inicializar](https://code.claude.com/docs/pt/self-hosted-environments-reference.md#session-startup-timeout). Se seu wrapper reconstrói o ambiente do filho, leve esta variável junto, ou o runner pode liberar a sessão durante esse turno e registrar em log `no child output for <n> — releasing`. Requer v2.1.309 ou posterior no runner e no filho. |52| `CLAUDE_RUNNER_ALIVE_EVERY_MS` | O runner define com que frequência, em milissegundos, o filho informa que está ativo quando um [turno começa antes de o filho inicializar](https://code.claude.com/docs/pt/self-hosted-environments-reference.md#session-startup-timeout). Se seu wrapper reconstrói o ambiente do filho, leve esta variável junto, ou o runner pode liberar a sessão durante esse turno e registrar em log `no child output for <n> — releasing`. Requer v2.1.309 ou posterior no runner e no filho. |

329| `CLAUDE_RUNNER_REPO_SOURCES` | Array JSON de `{url, revision}` para todas as fontes git da sessão, para hooks que roteiam em um repositório secundário. Vazio quando não há fontes. |329| `CLAUDE_RUNNER_REPO_SOURCES` | Array JSON de `{url, revision}` para todas as fontes git da sessão, para hooks que roteiam em um repositório secundário. Vazio quando não há fontes. |

330| `CLAUDE_RUNNER_CORRELATION_ID` | O ID de correlação fornecido na criação da sessão, ecoado de volta para que o hook possa mapear esta ordem de trabalho para a solicitação que criou a sessão. Vazio quando a sessão não tem nenhum. |330| `CLAUDE_RUNNER_CORRELATION_ID` | O ID de correlação fornecido na criação da sessão, ecoado de volta para que o hook possa mapear esta ordem de trabalho para a solicitação que criou a sessão. Vazio quando a sessão não tem nenhum. |

331| `CLAUDE_RUNNER_CLIENT_PLATFORM` | A superfície do cliente que criou a sessão, como `web_claude_ai`, `desktop_app`, `ios` ou `scheduled_trigger`, para análise de adoção. Não definido quando a sessão não tem superfície registrada ou reconhecida, e para solicitações de pré-aquecimento; verifique-o com `[ -n "${CLAUDE_RUNNER_CLIENT_PLATFORM:-}" ]`, que permanece seguro sob `set -u`. |331| `CLAUDE_RUNNER_CLIENT_PLATFORM` | A superfície do cliente que criou a sessão, como `web_claude_ai`, `desktop_app`, `ios` ou `scheduled_trigger`, para análise de adoção. Não definido quando a sessão não tem superfície registrada ou reconhecida, e para solicitações de pré-aquecimento; verifique-o com `[ -n "${CLAUDE_RUNNER_CLIENT_PLATFORM:-}" ]`, que permanece seguro sob `set -u`. |

332| `CLAUDE_RUNNER_SPAWN_REASON` | [Por que a Anthropic enviou esta solicitação de spawn](#find-out-why-a-spawn-request-was-sent), como `runner_lost` ou `resumed`. Não definido quando a solicitação não carrega um motivo bem formado, então leia-o como `"${CLAUDE_RUNNER_SPAWN_REASON:-}"`. Requer Claude Code v2.1.318 ou posterior no orquestrador |

332 333

333O runner gerado se registra com a ordem de trabalho no lugar do segredo do ambiente:334O runner gerado se registra com a ordem de trabalho no lugar do segredo do ambiente:

334 335

828 829

829Uma sessão auto-hospedada não tem terminal anexado, então um prompt de permissão não respondido paralisa a volta até o usuário responder na UI. O plano de controle da Anthropic envia a lista de ferramentas de cada sessão e regras de permissão com a carga de trabalho; a configuração padrão pré-aprova chamadas de ferramentas rotineiras, incluindo `Bash`, e sessões na nuvem [pré-aprovam edições de arquivo independentemente do modo](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes). Uma chamada que nada pré-aprova solicita através da UI da sessão.830Uma sessão auto-hospedada não tem terminal anexado, então um prompt de permissão não respondido paralisa a volta até o usuário responder na UI. O plano de controle da Anthropic envia a lista de ferramentas de cada sessão e regras de permissão com a carga de trabalho; a configuração padrão pré-aprova chamadas de ferramentas rotineiras, incluindo `Bash`, e sessões na nuvem [pré-aprovam edições de arquivo independentemente do modo](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes). Uma chamada que nada pré-aprova solicita através da UI da sessão.

830 831

832### Pin a permission mode from your wrapper

833

831> [!NOTE]834> [!NOTE]

832>835>

833> Apenas fixe auto mode em um ambiente cujos contêineres de sessão são executados com [default-deny network egress](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#default-deny-egress) e o resto da [seção de hardening](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#harden-your-deployment) em vigor. Chamadas de ferramentas rotineiras, incluindo solicitações de rede `Bash`, são executadas sem um humano no loop tanto no conjunto de ferramentas pré-aprovadas padrão quanto em auto mode, então o limite de rede é o que limita para onde essas chamadas podem alcançar.836> Apenas fixe auto mode em um ambiente cujos contêineres de sessão são executados com [default-deny network egress](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#default-deny-egress) e o resto da [seção de hardening](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#harden-your-deployment) em vigor. Chamadas de ferramentas rotineiras, incluindo solicitações de rede `Bash`, são executadas sem um humano no loop tanto no conjunto de ferramentas pré-aprovadas padrão quanto em auto mode, então o limite de rede é o que limita para onde essas chamadas podem alcançar.

834 837

835Para manter prompts ao mínimo independentemente do que o plano de controle envia, fixe [auto mode](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) de seu script wrapper ou hook [`command`](#command). Auto mode permite que sessões sejam executadas sem prompts de permissão rotineiros: um modelo classificador separado revisa ações antes de serem executadas e bloqueia as que rejeita, e regras de ask explícitas ainda forçam um prompt; a página de modos de permissão cobre o que o classificador verifica. O runner anexa flags computadas pelo servidor antes de invocar o wrapper, e para flags de valor único como `--permission-mode` o parser honra a última ocorrência, então uma flag que você anexa após `"$@"` substitui o valor enviado pelo servidor:838Para iniciar sessões no [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) até que o claude.ai/code ou outro cliente defina um modo de permissão para elas, fixe-o a partir do seu script wrapper ou [hook `command`](#command). O runner invoca o wrapper com suas próprias flags como argumentos, e o Claude Code aplica o último `--permission-mode` na linha de comando, então anexe o seu após `"$@"`:

836 839

837```bash theme={null}840```bash theme={null}

838#!/bin/bash841#!/bin/bash

839exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --permission-mode auto842exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --permission-mode auto

840```843```

841 844

842Para pré-aprovar ferramentas específicas em vez disso, anexe `--allowed-tools` com suas regras, por exemplo `--allowed-tools "Bash(bazel *) Bash(yarn *) mcp__internal__*"`. Flags de lista como `--allowed-tools` e `--disallowed-tools` acumulam em ocorrências em vez de substituir, então suas regras se aplicam em cima de quaisquer regras que o plano de controle envia. Para estreitar, anexe `--disallowed-tools`, que nega ferramentas mesmo se outra regra as permite.845Depois que um cliente define um modo, o modo que você anexou deixa de se aplicar, mesmo após a sessão reiniciar no runner. O claude.ai/code, por exemplo, define um com a primeira mensagem da sessão quando seu menu suspenso de modo mostra Auto, ou quando alguém escolheu um modo ali.

846

847No modo auto, um modelo classificador separado revisa as ações antes de serem executadas e bloqueia as que rejeita. Uma regra ask explícita ainda força um prompt. Uma chamada que uma [regra deny](https://code.claude.com/docs/pt/permissions.md#manage-permissions) bloqueia permanece bloqueada em todos os modos.

848

849### Pre-approve specific tools

850

851Para pré-aprovar ferramentas específicas, anexe `--allowed-tools` com suas regras após `"$@"` no seu script wrapper, por exemplo `--allowed-tools "Bash(bazel *) Bash(yarn *) mcp__internal__*"`. Flags de lista como `--allowed-tools` e `--disallowed-tools` se acumulam entre ocorrências em vez de substituir, então suas regras se aplicam em cima de quaisquer regras que o plano de controle envia. Para restringir, anexe `--disallowed-tools`, que nega ferramentas mesmo se outra regra as permitir.

843 852

844### How each session's config is assembled853### How each session's config is assembled

845 854

server-managed-settings.md +1 −0

Details

195* Um valor em cache de [`prependPlugins`](https://code.claude.com/docs/pt/settings-reference#prependplugins), [`appendPlugins`](https://code.claude.com/docs/pt/settings-reference#appendplugins) ou [`enabledPlugins`](https://code.claude.com/docs/pt/settings-reference#enabledplugins) não pode remover a guarda integrada, alterar sua posição ou desativá-la até que a busca da sessão confirme o payload195* Um valor em cache de [`prependPlugins`](https://code.claude.com/docs/pt/settings-reference#prependplugins), [`appendPlugins`](https://code.claude.com/docs/pt/settings-reference#appendplugins) ou [`enabledPlugins`](https://code.claude.com/docs/pt/settings-reference#enabledplugins) não pode remover a guarda integrada, alterar sua posição ou desativá-la até que a busca da sessão confirme o payload

196* Em uma máquina onde uma [fonte gerenciada pelo endpoint](https://code.claude.com/docs/pt/managed-settings.md#choose-a-delivery-mechanism) lista ou ativa plugins próprios, um plugin que apenas uma lista em cache ativa conta como [do usuário](https://code.claude.com/docs/pt/plugins/mods/admin.md#install-your-organizations-mods), e não da sua organização, até que a busca confirme o payload196* Em uma máquina onde uma [fonte gerenciada pelo endpoint](https://code.claude.com/docs/pt/managed-settings.md#choose-a-delivery-mechanism) lista ou ativa plugins próprios, um plugin que apenas uma lista em cache ativa conta como [do usuário](https://code.claude.com/docs/pt/plugins/mods/admin.md#install-your-organizations-mods), e não da sua organização, até que a busca confirme o payload

197* O Claude Code busca configurações atualizadas em segundo plano197* O Claude Code busca configurações atualizadas em segundo plano

198* Se o provedor de uma sessão não estiver na lista [`allowedProviders`](https://code.claude.com/docs/pt/settings-reference#allowedproviders) em cache, o Claude Code pode aguardar essa busca e verificar novamente antes de recusar. Se a busca falhar, a sessão é recusada

198* As configurações em cache persistem através de falhas de rede. Se a busca de inicialização falhar, o Claude Code avisa em sessões interativas e na aba Code que a política em cache está em vigor199* As configurações em cache persistem através de falhas de rede. Se a busca de inicialização falhar, o Claude Code avisa em sessões interativas e na aba Code que a política em cache está em vigor

199* Até que uma busca seja bem-sucedida, os valores retidos na inicialização permanecem retidos200* Até que uma busca seja bem-sucedida, os valores retidos na inicialização permanecem retidos

200 201

settings-reference.md +16 −13

Details

111| [`footerLinksRegexes`](#footerlinksregexes) | Transforme IDs de issue ou review na saída em [links clicáveis](https://code.claude.com/docs/pt/statusline.md#clickable-links) abaixo da caixa de entrada | Interface e terminal | User or managed |111| [`footerLinksRegexes`](#footerlinksregexes) | Transforme IDs de issue ou review na saída em [links clicáveis](https://code.claude.com/docs/pt/statusline.md#clickable-links) abaixo da caixa de entrada | Interface e terminal | User or managed |

112| [`forceLoginGatewayUrl`](#forcelogingatewayurl) | Defina a [URL do gateway](https://code.claude.com/docs/pt/claude-apps-gateway#set-the-gateway-url) à qual a tela de login se conecta | Autenticação e provedores | User or managed |112| [`forceLoginGatewayUrl`](#forcelogingatewayurl) | Defina a [URL do gateway](https://code.claude.com/docs/pt/claude-apps-gateway#set-the-gateway-url) à qual a tela de login se conecta | Autenticação e provedores | User or managed |

113| [`forceLoginMethod`](#forceloginmethod) | [Restrinja o login](https://code.claude.com/docs/pt/authentication.md#restrict-login-to-your-organization) a claude.ai, Claude Console, ou um [gateway de nuvem](https://code.claude.com/docs/pt/claude-apps-gateway) | Autenticação e provedores | Any file |113| [`forceLoginMethod`](#forceloginmethod) | [Restrinja o login](https://code.claude.com/docs/pt/authentication.md#restrict-login-to-your-organization) a claude.ai, Claude Console, ou um [gateway de nuvem](https://code.claude.com/docs/pt/claude-apps-gateway) | Autenticação e provedores | Any file |

114| [`forceLoginOrgUUID`](#forceloginorguuid) | [Fixe os logins claude.ai à sua organização](https://code.claude.com/docs/pt/authentication.md#restrict-login-to-your-organization); apenas uma fonte gerenciada a impõe | Autenticação e provedores | Any file |114| [`forceLoginOrgUUID`](#forceloginorguuid) | [Fixe os logins claude.ai à sua organização](https://code.claude.com/docs/pt/authentication.md#restrict-login-to-your-organization); apenas as configurações gerenciadas a impõem | Autenticação e provedores | Any file |

115| [`forceRemoteSettingsRefresh`](#forceremotesettingsrefresh) | Bloqueie a inicialização até que as [configurações gerenciadas por servidor](https://code.claude.com/docs/pt/server-managed-settings.md) sejam buscadas recentemente | Configurações empresariais e gerenciadas | Managed |115| [`forceRemoteSettingsRefresh`](#forceremotesettingsrefresh) | Bloqueie a inicialização até que as [configurações gerenciadas por servidor](https://code.claude.com/docs/pt/server-managed-settings.md) sejam buscadas recentemente | Configurações empresariais e gerenciadas | Managed |

116| [`gatewayInternalNetworks`](#gatewayinternalnetworks) | Permita que `/login` alcance um [gateway de nuvem](https://code.claude.com/docs/pt/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) no espaço IPv4 público que sua organização usa internamente | Autenticação e provedores | Managed |116| [`gatewayInternalNetworks`](#gatewayinternalnetworks) | Permita que `/login` alcance um [gateway de nuvem](https://code.claude.com/docs/pt/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) no espaço IPv4 público que sua organização usa internamente | Autenticação e provedores | Managed |

117| [`gcpAuthRefresh`](#gcpauthrefresh) | Atualize as [credenciais do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md#advanced-credential-configuration) com seu próprio comando | Autenticação e provedores | Any file |117| [`gcpAuthRefresh`](#gcpauthrefresh) | Atualize as [credenciais do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md#advanced-credential-configuration) com seu próprio comando | Autenticação e provedores | Any file |

446 446

447### `fastMode`447### `fastMode`

448 448

449Ative o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) em sessões onde ele está disponível, para trabalho interativo como iteração rápida ou depuração ao vivo, em que você quer velocidade a um custo maior por token. Normalmente, você não edita esta chave manualmente: executar `/fast` grava `fastMode: true` em `~/.claude/settings.json`, e executá-lo novamente para desativar o modo rápido remove a chave. O modo rápido funciona apenas no Opus 5.5, Opus 5 e Opus 4.8: ativá-lo a partir de outro modelo muda você para o Opus, e mudar para um modelo não suportado o desativa. Consulte [Trocar de modelo com o modo rápido ativado](https://code.claude.com/docs/pt/fast-mode.md#switch-models-while-fast-mode-is-on).449Ative o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) em sessões onde ele está disponível, para trabalho interativo como iteração rápida ou depuração ao vivo, em que você quer velocidade a um custo maior por token. Normalmente, você não edita esta chave manualmente. Executar `/fast` grava `fastMode: true` em `~/.claude/settings.json`, e executá-lo novamente para desativar o modo rápido remove a chave.

450

451Apenas o Opus 5.5, o Opus 5 e o Opus 4.8 suportam o modo rápido. Executar `/fast` a partir de outro modelo muda você para o Opus, e mudar para um modelo não suportado desativa o modo rápido. Consulte [Trocar de modelo com o modo rápido ativado](https://code.claude.com/docs/pt/fast-mode.md#switch-models-while-fast-mode-is-on).

450 452

451* **Escopo**: [`Any file`](#scopes)453* **Escopo**: [`Any file`](#scopes)

452* **Tipo**: Boolean454* **Tipo**: Boolean

463 465

464### `fastModePerSessionOptIn`466### `fastModePerSessionOptIn`

465 467

466Normalmente, executar `/fast` salva [`fastMode`](#fastmode) nas configurações de usuário da pessoa, então o modo rápido fica ativado no início de todas as sessões seguintes. Defina esta chave como `true` para impedir isso: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, e cada pessoa precisa executar `/fast` em cada sessão em que quiser usá-lo. O Claude Code mantém a chave `fastMode` no arquivo, então desativar esta chave restaura o comportamento anterior.468Normalmente, executar `/fast` salva [`fastMode`](#fastmode) nas configurações de usuário da pessoa, então novas sessões em um modelo suportado começam com o modo rápido ativado. Defina esta chave como `true` para impedir isso: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, e cada pessoa precisa executar `/fast` em cada sessão em que quiser usá-lo. O Claude Code mantém a chave `fastMode` no arquivo, então desativar esta chave restaura o comportamento anterior.

467 469

468Owners em planos Team ou Enterprise podem implantá-la em toda a organização por meio de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Quando as configurações gerenciadas definem a chave, `/fast on` é recusado fora de sessões interativas no terminal e informa que sua organização desativou o modo rápido. Isso abrange o [modo não interativo](https://code.claude.com/docs/pt/headless.md), a [extensão do VS Code](https://code.claude.com/docs/pt/vs-code.md) e as [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md).470Owners em planos Team ou Enterprise podem implantá-la em toda a organização por meio de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Quando as configurações gerenciadas definem a chave, `/fast on` é recusado fora de sessões interativas no terminal e informa que sua organização desativou o modo rápido. Isso abrange o [modo não interativo](https://code.claude.com/docs/pt/headless.md), a [extensão do VS Code](https://code.claude.com/docs/pt/vs-code.md) e as [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md).

469 471

470* **Escopo**: [`Any file`](#scopes)472* **Escopo**: [`Any file`](#scopes)

471* **Tipo**: Boolean473* **Tipo**: Boolean

472 * `true`: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, então cada pessoa executa `/fast` em cada sessão em que quiser usá-lo; um `fastMode: true` passado com `--settings` ainda vale para aquela sessão, a menos que as configurações gerenciadas definam esta chave474 * `true`: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, então cada pessoa executa `/fast` em cada sessão em que quiser usá-lo; um `fastMode: true` passado com `--settings` ainda vale para aquela sessão, a menos que as configurações gerenciadas definam esta chave

473 * `false`: um `fastMode: true` salvo ativa o modo rápido no início de todas as sessões seguintes475 * `false`: um `fastMode: true` salvo ativa o modo rápido no início de cada nova sessão em um modelo suportado

474* **Padrão**: `false`476* **Padrão**: `false`

475 477

476```json settings.json theme={null}478```json settings.json theme={null}

4827 4829

4828### `agentPushNotifEnabled`4830### `agentPushNotifEnabled`

4829 4831

4830Permita que o Claude envie uma notificação por push para seu telefone quando decidir que vale a pena enviar uma, por exemplo, quando uma tarefa longa termina. O Claude pode enviar uma enquanto o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) está conectado. Aparece em `/config` como **Push quando Claude decidir**. Quando você a altera lá, o Claude Code também salva o valor em sua conta.4832Permita que o Claude envie uma notificação por push para seu telefone quando decidir que vale a pena enviar uma, por exemplo, quando uma tarefa longa termina. Em uma sessão local, o Claude pode enviar uma enquanto o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) está conectado. Aparece em `/config` como **Push quando Claude decidir**. Quando você a altera lá, o Claude Code também salva o valor em sua conta.

4831 4833

4832* **Escopo**: [`Qualquer arquivo`](#scopes). O Claude Code também lê um valor deixado em `~/.claude.json` por versões antigas.4834* **Escopo**: [`Qualquer arquivo`](#scopes). O Claude Code também lê um valor deixado em `~/.claude.json` por versões antigas.

4833* **Tipo**: Boolean4835* **Tipo**: Boolean

4964 4966

4965### `inputNeededNotifEnabled`4967### `inputNeededNotifEnabled`

4966 4968

4967Receba uma notificação por push em seu telefone quando um prompt de permissão ou pergunta estiver aguardando sua entrada. O Claude Code envia essas apenas enquanto o [Controle Remoto](https://code.claude.com/docs/pt/remote-control.md) está conectado. Aparece em `/config` como **Push quando ações forem necessárias**.4969Receba uma notificação por push em seu telefone quando um prompt de permissão ou pergunta estiver aguardando sua entrada. Em uma sessão local, o Claude Code envia essas apenas enquanto o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) está conectado. Aparece em `/config` como **Push quando ações forem necessárias**.

4968 4970

4969* **Escopo**: [`Qualquer arquivo`](#scopes). O Claude Code também lê um valor deixado em `~/.claude.json` por versões antigas.4971* **Escopo**: [`Qualquer arquivo`](#scopes). O Claude Code também lê um valor deixado em `~/.claude.json` por versões antigas.

4970* **Tipo**: Boolean4972* **Tipo**: Boolean

4971 * `true`: você recebe uma notificação por push em seu telefone quando um prompt de permissão ou pergunta está aguardando, enquanto o Controle Remoto está conectado

4972 * `false`: Claude Code não envia essas notificações

4973* **Padrão**: `false`4973* **Padrão**: `false`

4974 4974

4975```json settings.json theme={null}4975```json settings.json theme={null}

4986 4986

4987* **Escopo**: [`Qualquer arquivo`](#scopes). O Claude Code também lê um valor deixado em `~/.claude.json` por versões antigas.4987* **Escopo**: [`Qualquer arquivo`](#scopes). O Claude Code também lê um valor deixado em `~/.claude.json` por versões antigas.

4988* **Tipo**: string, uma de:4988* **Tipo**: string, uma de:

4989 * `"auto"`: Claude Code envia uma notificação de desktop no iTerm2, Ghostty e Kitty, toca a campainha no Terminal.app apenas quando sua campainha audível está desativada, e não faz nada em outro lugar4989 * `"auto"`: Claude Code envia uma notificação de desktop quando detecta o iTerm2, o Ghostty ou o Kitty, toca a campainha no Terminal.app apenas quando sua campainha audível está desativada, e não faz nada em outro lugar

4990 * `"terminal_bell"`: Claude Code toca o caractere de campainha em qualquer terminal4990 * `"terminal_bell"`: Claude Code toca o caractere de campainha em qualquer terminal

4991 * `"iterm2"`: Claude Code envia uma notificação de desktop do iTerm24991 * `"iterm2"`: Claude Code envia uma notificação de desktop do iTerm2

4992 * `"iterm2_with_bell"`: Claude Code envia uma notificação de desktop do iTerm2 e toca a campainha4992 * `"iterm2_with_bell"`: Claude Code envia uma notificação de desktop do iTerm2 e toca a campainha

5001}5001}

5002```5002```

5003 5003

5004Com `"auto"`, o Claude Code envia uma notificação de desktop no iTerm2, Ghostty e Kitty. No Terminal.app, ele toca o caractere de campainha apenas quando você desativou a campainha audível do Terminal, e em outros terminais não faz nada. Defina `"terminal_bell"` para tocar o caractere de campainha em qualquer terminal. Veja [Obter uma campainha de terminal ou notificação](https://code.claude.com/docs/pt/terminal-config.md#get-a-terminal-bell-or-notification).5004Com `"auto"`, o Claude Code envia uma notificação de desktop quando detecta o iTerm2, o Ghostty ou o Kitty. No Terminal.app, ele toca o caractere de campainha apenas quando você desativou a campainha audível do Terminal, e em outros terminais não faz nada. Defina `"terminal_bell"` para tocar o caractere de campainha em qualquer terminal. Veja [Obter uma campainha de terminal ou notificação](https://code.claude.com/docs/pt/terminal-config.md#get-a-terminal-bell-or-notification).

5005 5005

5006### `remote.defaultEnvironmentId`5006### `remote.defaultEnvironmentId`

5007 5007

5176 5176

5177* Após o tempo de vida do cache, cinco minutos por padrão ou o intervalo que você define com [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](https://code.claude.com/docs/pt/env-vars).5177* Após o tempo de vida do cache, cinco minutos por padrão ou o intervalo que você define com [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](https://code.claude.com/docs/pt/env-vars).

5178* Quando uma requisição para a API Anthropic, diretamente ou através de um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway), falha com `401` ou `403`.5178* Quando uma requisição para a API Anthropic, diretamente ou através de um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway), falha com `401` ou `403`.

5179* Quando uma requisição através de um gateway de LLM falha com `401`, mas não com `403`, e você define [`CLAUDE_CODE_SKIP_VERTEX_AUTH`](https://code.claude.com/docs/pt/env-vars) para a Plataforma de Agente do Google Cloud, `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` para Claude Platform on AWS, ou `CLAUDE_CODE_SKIP_MANTLE_AUTH` para Amazon Bedrock Mantle. Requer Claude Code v2.1.318 ou posterior.

5179* Antes de enviar uma requisição para a API Anthropic, diretamente ou através de um gateway de LLM, quando a saída em cache é um JWT que expirou após o auxiliar produzi-lo. Requer Claude Code v2.1.246 ou posterior.5180* Antes de enviar uma requisição para a API Anthropic, diretamente ou através de um gateway de LLM, quando a saída em cache é um JWT que expirou após o auxiliar produzi-lo. Requer Claude Code v2.1.246 ou posterior.

5180 5181

5181Os dois últimos casos se aplicam apenas quando a saída do auxiliar é a credencial que Claude Code envia e `ANTHROPIC_AUTH_TOKEN` não está definido.5182Os três últimos casos se aplicam apenas quando a saída do auxiliar é a credencial que Claude Code envia e `ANTHROPIC_AUTH_TOKEN` não está definido.

5182 5183

5183Em sessões interativas, quando o comando vem das configurações do projeto ou local, Claude Code não o executa até que você aceite o prompt de confiança do workspace. Veja [Gerenciamento de credenciais](https://code.claude.com/docs/pt/authentication.md#credential-management).5184Em sessões interativas, quando o comando vem das configurações do projeto ou local, Claude Code não o executa até que você aceite o prompt de confiança do workspace. Veja [Gerenciamento de credenciais](https://code.claude.com/docs/pt/authentication.md#credential-management).

5184 5185

5261 5262

5262De uma fonte gerenciada, exija que logins de contas claude.ai pertençam a uma organização Anthropic, fornecida como um único UUID, ou a qualquer uma de várias organizações, fornecidas como um array. De qualquer arquivo de configurações, Claude Code também usa um único UUID para pré-selecionar essa organização durante um login claude.ai ou Claude Console, e não pré-seleciona nada para um array. Se você definir a chave em qualquer arquivo de configurações, Claude Code também para de oferecer o [login Console sem chave](https://code.claude.com/docs/pt/authentication.md#sign-in-without-an-api-key) nas sessões às quais esse arquivo se aplica e cria uma chave de API.5263De uma fonte gerenciada, exija que logins de contas claude.ai pertençam a uma organização Anthropic, fornecida como um único UUID, ou a qualquer uma de várias organizações, fornecidas como um array. De qualquer arquivo de configurações, Claude Code também usa um único UUID para pré-selecionar essa organização durante um login claude.ai ou Claude Console, e não pré-seleciona nada para um array. Se você definir a chave em qualquer arquivo de configurações, Claude Code também para de oferecer o [login Console sem chave](https://code.claude.com/docs/pt/authentication.md#sign-in-without-an-api-key) nas sessões às quais esse arquivo se aplica e cria uma chave de API.

5263 5264

5264* **Escopo**: [`Qualquer arquivo`](#scopes). Apenas uma fonte gerenciada aplica a restrição; um único UUID em qualquer outro arquivo de configurações pré-seleciona a organização durante o login sem restringi-la.5265* **Escopo**: [`Qualquer arquivo`](#scopes). Em um arquivo de configurações que não é uma fonte gerenciada, Claude Code não verifica a qual organização um login pertence, e um único UUID pré-seleciona a organização durante o login.

5265* **Tipo**: string, um UUID, ou array de strings, vários UUIDs5266* **Tipo**: string, um UUID, ou array de strings, vários UUIDs

5266* **Padrão**: não definido, portanto qualquer organização pode fazer login5267* **Padrão**: não definido, portanto qualquer organização pode fazer login

5267 5268

5827 5828

5828### `autoInstallIdeExtension`5829### `autoInstallIdeExtension`

5829 5830

5830Permita que [`/ide`](https://code.claude.com/docs/pt/commands) instale a extensão Claude Code IDE em um VS Code, Cursor ou Devin Desktop em execução quando você executa o comando a partir de um terminal externo. Claude Code não instala a extensão quando você o inicia. Aparece em `/config` como **Auto-instalar extensão IDE** quando você executa Claude Code dentro de um terminal VS Code ou JetBrains.5831Permita que [`/ide`](https://code.claude.com/docs/pt/commands) instale a extensão Claude Code IDE em um VS Code, Cursor ou Devin Desktop em execução quando você executa o comando a partir de um terminal externo. Claude Code não instala nem atualiza a extensão quando você inicia `claude`. Antes da v2.1.318, Claude Code instala ou atualiza a extensão quando você inicia `claude` no terminal de um desses editores, a menos que essa chave seja `false`.

5832

5833Aparece em `/config` como **Auto-instalar extensão IDE** quando você executa Claude Code dentro de um terminal VS Code ou JetBrains.

5831 5834

5832* **Escopo**: [`Global config`](#scopes)5835* **Escopo**: [`Global config`](#scopes)

5833* **Tipo**: Booleano5836* **Tipo**: Booleano

setup.md +4 −4

Details

389> gpg --show-keys /etc/apt/keyrings/claude-code.asc389> gpg --show-keys /etc/apt/keyrings/claude-code.asc

390> ```390> ```

391>391>

392> A impressão digital que gpg imprime deve ser `31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE`. Se gpg relatar que o arquivo não pode ser aberto ou não contém dados OpenPGP válidos, o download falhou ou retornou o conteúdo errado: confirme que sua rede pode alcançar `downloads.claude.ai`, depois execute novamente o comando de download.392> A única impressão digital que gpg imprime deve ser `31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE`. Se gpg relatar que o arquivo não pode ser aberto ou não contém dados OpenPGP válidos, o download falhou ou retornou o conteúdo errado. Confirme que sua rede pode alcançar `downloads.claude.ai`, depois execute novamente o comando de download.

393>393>

394> Registre o repositório no canal `stable` e instale:394> Registre o repositório no canal `stable` e instale:

395>395>

536Verifique a assinatura destacada contra o manifesto.536Verifique a assinatura destacada contra o manifesto.

537 537

538```bash theme={null}538```bash theme={null}

539gpg --verify manifest.json.sig manifest.json539gpg --with-fingerprint --verify manifest.json.sig manifest.json

540```540```

541 541

542Um resultado válido relata `Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>"`.542Um resultado válido relata `Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>"`. Com as configurações padrão, `gpg` também imprime `WARNING: This key is not certified with a trusted signature!` para uma chave recém-importada. Isso é esperado. A linha `Good signature` confirma que a verificação criptográfica passou.

543 543

544`gpg` também imprime `WARNING: This key is not certified with a trusted signature!` para qualquer chave recém-importada. Isso é esperado. A linha `Good signature` confirma que a verificação criptográfica passou. A comparação de impressão digital na Etapa 1 confirma que a chave em si é autêntica.544Para verificar se a chave da Anthropic assinou o manifesto, compare a linha `Primary key fingerprint` no final da saída com a impressão digital que esta página lista na Etapa 1. Se elas corresponderem e a saída não mostrar `BAD signature`, continue para a Etapa 4. Caso contrário, não use este manifesto.

545 545

546**4. Verificar o binário contra o manifesto**546**4. Verificar o binário contra o manifesto**

547 547

slack.md +7 −10

Details

20 20

21## Casos de uso21## Casos de uso

22 22

~~23* **Investigação e correção de bugs**: Peça ao Claude para investigar e corrigir bugs assim que forem relatados nos canais do Slack.~~23* **Investigação e correção de bugs**: Descreva um bug e peça ao Claude para investigá-lo e corrigi-lo.

~~24* **Revisões rápidas de código e modificações**: Faça com que Claude implemente pequenos recursos ou refatore código com base no feedback da equipe.~~24* **Revisões rápidas de código e modificações**: Faça com que Claude implemente pequenos recursos ou refatore código.

25* **Depuração colaborativa**: Quando discussões em equipe fornecem contexto crucial (por exemplo, reproduções de erros ou relatórios de usuários), Claude pode usar essas informações para informar sua abordagem de depuração.

26* **Execução de tarefas paralelas**: Inicie tarefas de codificação no Slack enquanto continua outro trabalho, recebendo notificações quando concluído.25* **Execução de tarefas paralelas**: Inicie tarefas de codificação no Slack enquanto continua outro trabalho, recebendo notificações quando concluído.

27 26

28## Pré-requisitos27## Pré-requisitos

91 90

92### Coleta de contexto91### Coleta de contexto

93 92

~~94**De threads**: Quando você @menciona Claude em uma thread, ele coleta contexto de todas as mensagens nessa thread para entender a conversa completa.~~93* **De threads**: quando você @menciona Claude pela primeira vez em uma thread, ele coleta contexto das suas mensagens e das dele próprio nessa thread.

94* **De canais**: quando você @menciona Claude diretamente em um canal, ele analisa suas mensagens recentes e as dele próprio nesse canal, além do nome, do tópico e da descrição do canal.

95 95

~~96**De canais**: Quando mencionado diretamente em um canal, Claude analisa mensagens recentes do canal para contexto relevante.~~96Este contexto ajuda Claude a entender o problema, selecionar o repositório apropriado e informar sua abordagem para a tarefa. Para passar ao Claude algo que um colega escreveu, como um relatório de erro, cole o texto na mensagem em que você @menciona Claude.

~~98Este contexto ajuda Claude a entender o problema, selecionar o repositório apropriado e informar sua abordagem para a tarefa.~~

99 97

100> [!WARNING]98> [!WARNING]

101>99>

160### Escrevendo solicitações eficazes158### Escrevendo solicitações eficazes

161 159

162* **Seja específico**: Inclua nomes de arquivos, nomes de funções ou mensagens de erro quando relevante.160* **Seja específico**: Inclua nomes de arquivos, nomes de funções ou mensagens de erro quando relevante.

163* **Forneça contexto**: Mencione o repositório ou projeto se não estiver claro na conversa.161* **Forneça contexto**: Mencione o repositório ou projeto.

164* **Defina o sucesso**: Explique como "feito" se parece. Claude deve escrever testes? Atualizar documentação? Criar um PR?162* **Defina o sucesso**: Explique como "feito" se parece. Claude deve escrever testes? Atualizar documentação? Criar um PR?

165* **Use threads**: Responda em threads ao discutir bugs ou recursos para que Claude possa reunir o contexto completo.

166 163

167### Quando usar Slack vs. web164### Quando usar Slack vs. web

168 165

169**Use Slack quando**: O contexto já existe em uma discussão do Slack, você quer iniciar uma tarefa de forma assíncrona ou está colaborando com colegas de equipe que precisam de visibilidade.166**Use Slack quando**: Você quer iniciar uma tarefa de forma assíncrona ou está colaborando com colegas de equipe que precisam de visibilidade.

170 167

171**Use a web diretamente quando**: Você precisa fazer upload de arquivos, quer interação em tempo real durante o desenvolvimento ou está trabalhando em tarefas mais longas e complexas.168**Use a web diretamente quando**: Você precisa fazer upload de arquivos, quer interação em tempo real durante o desenvolvimento ou está trabalhando em tarefas mais longas e complexas.

172 169

terminal-config.md +4 −4

Details

74 74

75Por padrão, Claude Code envia uma notificação de desktop em alguns terminais e, em outros, um caractere de sinal sonoro ou nada:75Por padrão, Claude Code envia uma notificação de desktop em alguns terminais e, em outros, um caractere de sinal sonoro ou nada:

76 76

~~77* **Ghostty, Kitty e iTerm2**: uma notificação de desktop, que o iTerm2 exibe somente depois que você ativa as configurações de alerta dele.~~77* **Ghostty, Kitty e iTerm2, quando Claude Code os detecta**: uma notificação de desktop, que o iTerm2 exibe somente depois que você ativa as configurações de alerta dele.

78* **Apple Terminal**: nenhum som; um caractere de sinal sonoro silencioso quando Claude Code encontra "Audible bell" desativado no perfil da janela do Terminal em primeiro plano, caso contrário, nada. Esse caractere de sinal sonoro aparece como um piscar da janela, ou um salto no Dock enquanto o Terminal está em segundo plano, se a opção "Visual bell" ou de salto no Dock desse perfil estiver ativada.78* **Apple Terminal**: nenhum som; um caractere de sinal sonoro silencioso quando Claude Code encontra "Audible bell" desativado no perfil da janela do Terminal em primeiro plano, caso contrário, nada. Esse caractere de sinal sonoro aparece como um piscar da janela, ou um salto no Dock enquanto o Terminal está em segundo plano, se a opção "Visual bell" ou de salto no Dock desse perfil estiver ativada.

79* **Outros terminais**: nada.79* **Outros terminais**: nada.

80 80

86}86}

87```87```

88 88

89A notificação de desktop chega à sua máquina local via SSH, portanto uma sessão remota ainda pode alertá-lo. Ghostty e Kitty a encaminham para seu centro de notificações do SO sem configuração adicional. iTerm2 requer que você ative o encaminhamento:89Via SSH a partir de um terminal executado fora do tmux, defina [`preferredNotifChannel`](https://code.claude.com/docs/pt/settings-reference#preferrednotifchannel) como o valor do seu terminal local, `"iterm2"`, `"kitty"` ou `"ghostty"`, na máquina que executa Claude Code. A notificação de desktop então chega à sua máquina local. Ghostty e Kitty a encaminham para seu centro de notificações do SO sem configuração adicional. iTerm2 requer que você ative o encaminhamento:

90 90

91**1. Abra as configurações de notificação do iTerm2**91**1. Abra as configurações de notificação do iTerm2**

92 92

131 131

132## Configurar tmux132## Configurar tmux

133 133

134Quando Claude Code é executado dentro do tmux, por padrão Shift+Enter envia em vez de inserir uma nova linha, e notificações de desktop e a [barra de progresso](https://code.claude.com/docs/pt/settings-reference.md#terminalprogressbarenabled) nunca chegam ao terminal externo. Adicione estas linhas a `~/.tmux.conf`, depois execute `tmux source-file ~/.tmux.conf` para aplicá-las ao servidor em execução:134Quando Claude Code é executado dentro do tmux, por padrão Shift+Enter envia em vez de inserir uma nova linha, e notificações de desktop não chegam ao terminal externo. Adicione estas linhas a `~/.tmux.conf`, depois execute `tmux source-file ~/.tmux.conf` para aplicá-las ao servidor em execução:

135 135

136```bash ~/.tmux.conf theme={null}136```bash ~/.tmux.conf theme={null}

137set -g allow-passthrough on137set -g allow-passthrough on

140set -as terminal-features 'xterm*:extkeys'140set -as terminal-features 'xterm*:extkeys'

141```141```

142 142

143A linha `allow-passthrough` permite que notificações e atualizações de progresso cheguem ao terminal externo em vez de serem engolidas pelo tmux. As linhas `extended-keys` permitem que o tmux distinga Shift+Enter de Enter simples para que o atalho de nova linha funcione.143Para enviar notificações de um painel visível ao terminal externo, mantenha a linha `allow-passthrough` e defina [`preferredNotifChannel`](https://code.claude.com/docs/pt/settings-reference#preferrednotifchannel) como `"iterm2"`, `"kitty"` ou `"ghostty"`. Com este exemplo, um painel em uma janela que você não está visualizando não envia nenhuma. As linhas `extended-keys` permitem que o tmux distinga Shift+Enter de Enter simples para que o atalho de nova linha funcione.

144 144

145Um [`Image` de um mod](https://code.claude.com/docs/pt/plugins/mods/reference#elements) precisa das linhas `allow-passthrough` e `focus-events`, junto com os outros [requisitos para desenhar dentro do tmux](https://code.claude.com/docs/pt/plugins/mods/gallery.md#draw-an-image-inside-tmux). Depois de adicionar as linhas, desanexe-se também do tmux, anexe-se novamente e reinicie o Claude Code.145Um [`Image` de um mod](https://code.claude.com/docs/pt/plugins/mods/reference#elements) precisa das linhas `allow-passthrough` e `focus-events`, junto com os outros [requisitos para desenhar dentro do tmux](https://code.claude.com/docs/pt/plugins/mods/gallery.md#draw-an-image-inside-tmux). Depois de adicionar as linhas, desanexe-se também do tmux, anexe-se novamente e reinicie o Claude Code.

146 146

tools-reference.md +1 −1

Details

39| `Monitor` | Executa um comando em segundo plano e alimenta cada linha de saída de volta para Claude, para que ele possa reagir a entradas de log, mudanças de arquivo ou status consultado no meio da conversa. Também pode abrir um WebSocket e tratar cada mensagem recebida como um evento. Veja [Ferramenta Monitor](#monitor-tool) | Sim |39| `Monitor` | Executa um comando em segundo plano e alimenta cada linha de saída de volta para Claude, para que ele possa reagir a entradas de log, mudanças de arquivo ou status consultado no meio da conversa. Também pode abrir um WebSocket e tratar cada mensagem recebida como um evento. Veja [Ferramenta Monitor](#monitor-tool) | Sim |

40| `NotebookEdit` | Modifica células de notebook Jupyter. Veja [Comportamento da ferramenta NotebookEdit](#notebookedit-tool-behavior) | Sim |40| `NotebookEdit` | Modifica células de notebook Jupyter. Veja [Comportamento da ferramenta NotebookEdit](#notebookedit-tool-behavior) | Sim |

41| `PowerShell` | Executa comandos PowerShell nativamente. Veja [Ferramenta PowerShell](#powershell-tool) para disponibilidade | Sim |41| `PowerShell` | Executa comandos PowerShell nativamente. Veja [Ferramenta PowerShell](#powershell-tool) para disponibilidade | Sim |

42| `PushNotification` | Envia uma notificação de desktop e um push de telefone quando o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) está conectado, para que uma tarefa de longa duração ou [tarefa agendada com escopo de sessão](https://code.claude.com/docs/pt/scheduled-tasks.md) possa alcançá-lo quando você se afastar. A entrega de push é executada através de infraestrutura hospedada pela Anthropic, que não é acessível do Amazon Bedrock, Claude Platform na AWS, Agent Platform do Google Cloud ou Microsoft Foundry | Não |42| `PushNotification` | Envia uma notificação de desktop a partir de uma sessão local e um push de telefone com o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) ou em uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md). A entrega de push é executada através de infraestrutura hospedada pela Anthropic, que não é acessível do Amazon Bedrock, Claude Platform na AWS, Agent Platform do Google Cloud ou Microsoft Foundry | Não |

43| `Read` | Lê o conteúdo de arquivos. Veja [Comportamento da ferramenta Read](#read-tool-behavior) | Não |43| `Read` | Lê o conteúdo de arquivos. Veja [Comportamento da ferramenta Read](#read-tool-behavior) | Não |

44| `ReadMcpResourceTool` | Lê um recurso MCP específico por URI | Não |44| `ReadMcpResourceTool` | Lê um recurso MCP específico por URI | Não |

45| `RemoteTrigger` | Cria, atualiza, executa e lista [tarefas agendadas na nuvem](https://code.claude.com/docs/pt/routines.md), anteriormente chamadas de rotinas, no claude.ai. Respalda o comando `/schedule`. A [referência de entrada `RemoteTrigger`](https://code.claude.com/docs/pt/agent-sdk/typescript#remotetrigger) documenta cada ação e as políticas organizacionais que removem a ferramenta. Tarefas agendadas na nuvem ficam no claude.ai e requerem um plano Pro, Max, Ultra, Team ou Enterprise. Portanto, esta ferramenta não é acessível do Amazon Bedrock, Claude Platform na AWS, Agent Platform do Google Cloud ou Microsoft Foundry | Não |45| `RemoteTrigger` | Cria, atualiza, executa e lista [tarefas agendadas na nuvem](https://code.claude.com/docs/pt/routines.md), anteriormente chamadas de rotinas, no claude.ai. Respalda o comando `/schedule`. A [referência de entrada `RemoteTrigger`](https://code.claude.com/docs/pt/agent-sdk/typescript#remotetrigger) documenta cada ação e as políticas organizacionais que removem a ferramenta. Tarefas agendadas na nuvem ficam no claude.ai e requerem um plano Pro, Max, Ultra, Team ou Enterprise. Portanto, esta ferramenta não é acessível do Amazon Bedrock, Claude Platform na AWS, Agent Platform do Google Cloud ou Microsoft Foundry | Não |

vs-code.md +12 −3

Details

818 818

819### Executar a CLI no VS Code819### Executar a CLI no VS Code

820 820

821Para usar a CLI sem sair do VS Code, pressione `` Ctrl+` `` no Windows/Linux ou `` Cmd+` `` no Mac para abrir o terminal integrado e, em seguida, execute `claude`. Iniciar `claude` não instala a extensão. Sem ela, `/ide` no terminal integrado informa "No available IDEs detected" e `/status` mostra o IDE como "Not connected".821Para usar a CLI sem sair do VS Code, pressione `` Ctrl+` `` no Windows/Linux ou `` Cmd+` `` no Mac para abrir o terminal integrado e, em seguida, execute `claude`.

822 822

823Para obter recursos como visualização de diff e compartilhamento de diagnósticos, conecte a CLI à extensão a partir do terminal integrado ou de um terminal externo:823Para obter recursos como visualização de diff e compartilhamento de diagnósticos, conecte a CLI à extensão a partir do terminal integrado ou de um terminal externo:

824 824

825* **Terminal integrado**: [instale a extensão](#install-the-extension) e, em seguida, inicie `claude`. A CLI se conecta automaticamente.825* **Terminal integrado**: [instale a extensão](#install-the-extension) e, em seguida, inicie `claude`. A CLI se conecta automaticamente. O Claude Code v2.1.318 ou posterior não instala a extensão para você, portanto, até que você a instale, `/ide` informa "No available IDEs detected" e `/status` mostra o IDE como "Not connected".

826* **Terminal externo**: execute `/ide` dentro do Claude Code para conectá-lo ao VS Code. Se o VS Code estiver em execução sem a extensão, `/ide` a instala, a menos que você tenha desativado [`autoInstallIdeExtension`](https://code.claude.com/docs/pt/settings-reference#autoinstallideextension).826* **Terminal externo**: execute `/ide` dentro do Claude Code para conectá-lo ao VS Code. Se o VS Code estiver em execução sem a extensão, `/ide` a instala, a menos que você tenha desativado [`autoInstallIdeExtension`](https://code.claude.com/docs/pt/settings-reference#autoinstallideextension).

827 827

828Instalar a extensão não coloca `claude` no PATH do seu shell. A extensão inclui uma cópia privada da CLI para o seu painel de chat, mas digitar `claude` em um terminal requer a [instalação independente da CLI](https://code.claude.com/docs/pt/setup.md). Execute a instalação uma vez e os comandos desta página, incluindo `claude mcp add` e `claude --resume`, funcionarão em qualquer terminal. Se `claude` ainda não for encontrado após a instalação, [verifique seu PATH](https://code.claude.com/docs/pt/troubleshoot-install.md#verify-your-path).828Instalar a extensão não coloca `claude` no PATH do seu shell. A extensão inclui uma cópia privada da CLI para o seu painel de chat, mas digitar `claude` em um terminal requer a [instalação independente da CLI](https://code.claude.com/docs/pt/setup.md). Execute a instalação uma vez e os comandos desta página, incluindo `claude mcp add` e `claude --resume`, funcionarão em qualquer terminal. Se `claude` ainda não for encontrado após a instalação, [verifique seu PATH](https://code.claude.com/docs/pt/troubleshoot-install.md#verify-your-path).

10912. Pesquise por "Claude Code"10912. Pesquise por "Claude Code"

10923. Clique em **Uninstall**10923. Clique em **Uninstall**

1093 1093

1094A extensão permanece desinstalada quando você inicia `claude`. Se você executar `/ide` a partir de um terminal externo enquanto o VS Code estiver em execução, o Claude Code a reinstala. Para impedir isso, defina [`autoInstallIdeExtension`](https://code.claude.com/docs/pt/settings-reference#autoinstallideextension) como `false` em `~/.claude.json` ou desative **Auto-install IDE extension** em `/config` no terminal integrado. Você também pode definir a variável de ambiente [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](https://code.claude.com/docs/pt/env-vars) como `1`.1094Se você fizer qualquer uma destas ações após desinstalar, a extensão volta:

1095

1096* Executar `/ide` a partir de um terminal externo enquanto o VS Code estiver em execução

1097* Iniciar `claude` no terminal integrado em uma versão do Claude Code anterior à v2.1.318

1098

1099Para impedir que a extensão volte, faça uma destas ações e, em seguida, desinstale-a novamente se ela já tiver voltado:

1100

1101* Defina [`autoInstallIdeExtension`](https://code.claude.com/docs/pt/settings-reference#autoinstallideextension) como `false` em `~/.claude.json`

1102* Defina [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](https://code.claude.com/docs/pt/env-vars#variables) como `1` em `env` em um [arquivo de configurações](https://code.claude.com/docs/pt/env-vars.md#in-settings-files)

1103* No terminal integrado, desative **Auto-install IDE extension** em `/config`

1095 1104

1096Para também remover os dados da extensão e redefinir todas as configurações, exclua o diretório de armazenamento da extensão para sua plataforma.1105Para também remover os dados da extensão e redefinir todas as configurações, exclua o diretório de armazenamento da extensão para sua plataforma.

1097 1106

web-quickstart.md +8 −6

Details

12 12

13Uma sessão na nuvem executa Claude Code em infraestrutura de nuvem em vez de sua máquina, gerenciada pela Anthropic por padrão. Este guia de início rápido inicia uma a partir de [claude.ai/code](https://claude.ai/code) no seu navegador. Você também pode iniciar uma a partir do aplicativo móvel Claude, do aplicativo Desktop ou do seu terminal com `claude --cloud`.13Uma sessão na nuvem executa Claude Code em infraestrutura de nuvem em vez de sua máquina, gerenciada pela Anthropic por padrão. Este guia de início rápido inicia uma a partir de [claude.ai/code](https://claude.ai/code) no seu navegador. Você também pode iniciar uma a partir do aplicativo móvel Claude, do aplicativo Desktop ou do seu terminal com `claude --cloud`.

14 14

15Você precisará de um repositório GitHub para [começar](#connect-github). Claude o clona em uma máquina virtual isolada, faz alterações e envia um branch para você revisar. As sessões persistem entre dispositivos, portanto uma tarefa que você inicia no seu laptop está pronta para revisar no seu telefone mais tarde. Cada sessão conta para os limites de uso do seu plano junto com o restante do seu uso do Claude e do Claude Code, e não há cobrança separada pela VM na nuvem.15Claude clona o [repositório GitHub](#connect-github) que você seleciona em uma máquina virtual isolada, faz alterações e envia um branch para você revisar. As sessões persistem entre dispositivos, portanto uma tarefa que você inicia no seu laptop está pronta para revisar no seu telefone mais tarde. Cada sessão conta para os limites de uso do seu plano junto com o restante do seu uso do Claude e do Claude Code, e não há cobrança separada pela VM na nuvem.

16 16

17As sessões na nuvem funcionam bem para:17As sessões na nuvem funcionam bem para:

18 18

44| **Você inicia a partir de** | claude.ai/code, o aplicativo móvel Claude, o aplicativo Desktop com **Cloud** selecionado, ou `claude --cloud` | Seu terminal, seu IDE, ou o aplicativo Desktop com **Local** selecionado | Seu terminal, a extensão VS Code, ou o aplicativo Desktop |44| **Você inicia a partir de** | claude.ai/code, o aplicativo móvel Claude, o aplicativo Desktop com **Cloud** selecionado, ou `claude --cloud` | Seu terminal, seu IDE, ou o aplicativo Desktop com **Local** selecionado | Seu terminal, a extensão VS Code, ou o aplicativo Desktop |

46| **Usa sua configuração local** | Não, apenas repositório | Sim | Sim |46| **Usa sua configuração local** | Não, apenas repositório | Sim | Sim |

~~47| **Requer GitHub** | Sim, ou [agrupe um repositório local](https://code.claude.com/docs/pt/claude-code-on-the-web.md#send-local-repositories-without-github) via `--cloud` | Não | Não |~~47| **Requer GitHub** | Sim, para um repositório GitHub, a menos que `--cloud` [agrupe seu repositório local](https://code.claude.com/docs/pt/claude-code-on-the-web.md#send-local-repositories-without-github) | Não | Não |

48| **Continua funcionando se você desconectar** | Sim | Não | Enquanto a sessão permanecer aberta em sua máquina |48| **Continua funcionando se você desconectar** | Sim | Não | Enquanto a sessão permanecer aberta em sua máquina |

49| **[Modos de permissão](https://code.claude.com/docs/pt/permission-modes.md)** | Aceitar edições, Plan, Auto | Todos os modos no terminal; consulte [Alternar modos de permissão](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes) para o IDE e aplicativo Desktop | Manual, Aceitar edições, Plan ou Auto a partir de claude.ai e do aplicativo móvel |49| **[Modos de permissão](https://code.claude.com/docs/pt/permission-modes.md)** | Aceitar edições, Plan, Auto | Todos os modos no terminal; consulte [Alternar modos de permissão](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes) para o IDE e aplicativo Desktop | Manual, Aceitar edições, Plan ou Auto a partir de claude.ai e do aplicativo móvel |

138 138

139O [controle de modo de permissão](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes) mostra o modo de permissão em que a sessão será executada:139O [controle de modo de permissão](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes) mostra o modo de permissão em que a sessão será executada:

140 140

141* **Auto**: um classificador revisa as ações de Claude em vez de pedir a você. Aparece quando sua organização permite modo auto e o modelo selecionado o suporta141* **Auto**: um classificador revisa as ações de Claude em vez de pedir a você. Aparece a menos que sua organização desative o [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode). Em claude.ai/code, se estiver esmaecido, selecione um modelo que suporte o modo auto

142* **Aceitar edições**: Claude faz alterações e envia uma branch sem parar para aprovação142* **Aceitar edições**: Claude faz alterações e envia uma branch sem parar para aprovação

143* **Plan**: Claude propõe uma abordagem e aguarda sua aprovação antes de editar arquivos143* **Plan**: Claude propõe uma abordagem e aguarda sua aprovação antes de editar arquivos

144 144

209 209

210### A página mostra apenas um botão de login do GitHub210### A página mostra apenas um botão de login do GitHub

211 211

212As sessões em nuvem requerem uma conta GitHub conectada. Conecte através do fluxo do navegador acima, ou execute `/web-setup` do seu terminal se você usar o GitHub CLI. Se você preferir não conectar GitHub, consulte [Remote Control](https://code.claude.com/docs/pt/remote-control.md) para executar Claude Code em sua própria máquina e monitorá-lo do seu navegador ou telefone.212Para trabalhar em um repositório GitHub em uma sessão na nuvem, [conecte sua conta GitHub](#connect-github), ou execute `/web-setup` do seu terminal se você usar o GitHub CLI. Se você preferir não conectar GitHub de forma alguma, consulte [Remote Control](https://code.claude.com/docs/pt/remote-control.md) para executar Claude Code em sua própria máquina e monitorá-lo do seu navegador ou telefone.

213 213

214### "Claude Code não está disponível em sua conta"214### "Claude Code não está disponível em sua conta"

215 215

242 242

243### Script de configuração falhou243### Script de configuração falhou

244 244

245O script de configuração saiu com um status diferente de zero, o que bloqueia o início da sessão. Causas comuns:245O [script de configuração](https://code.claude.com/docs/pt/cloud-environments.md#setup-scripts) saiu com um status diferente de zero, então a sessão não conseguiu iniciar ou iniciou sem aquilo que o script não conseguiu instalar. Se a sessão iniciou, você pode continuar trabalhando nela.

246

247Causas comuns:

246 248

247* Uma instalação de pacote falhou porque o registro não está no seu [nível de acesso à rede](https://code.claude.com/docs/pt/cloud-environments.md#access-levels). `Trusted` cobre a maioria dos gerenciadores de pacotes; `None` bloqueia todos eles.249* Uma instalação de pacote falhou porque o registro não está no seu [nível de acesso à rede](https://code.claude.com/docs/pt/cloud-environments.md#access-levels). `Trusted` cobre a maioria dos gerenciadores de pacotes; `None` bloqueia todos eles.

248* O script faz referência a um arquivo ou caminho que não existe em um clone recente.250* O script faz referência a um arquivo ou caminho que não existe em um clone recente.

249* Um comando que funciona localmente precisa de uma invocação diferente no Ubuntu.251* Um comando que funciona localmente precisa de uma invocação diferente no Ubuntu.

250 252

251Para depurar, adicione `set -x` no topo do script para ver qual comando falhou. Para comandos não críticos, anexe `|| true` para que não bloqueiem o início da sessão.253Para depurar, adicione `set -x` no topo do script para ver qual comando falhou. Para comandos não críticos, anexe `|| true` para que não façam o script falhar. Depois de corrigir a causa, inicie uma nova sessão para que o script seja executado novamente. Se o que falhou ao iniciar foi uma execução de uma [tarefa agendada na nuvem](https://code.claude.com/docs/pt/routines.md), clique em **Run now** na página de detalhes da tarefa em vez de iniciar uma nova sessão.

252 254

253### Novas sessões travam ou expiram durante a configuração255### Novas sessões travam ou expiram durante a configuração

254 256

Documentation 2026-11-05 23:03 UTC to 2026-11-06 23:01 UTC